FUNCTION xpxFindStringPatternInModel(modelId                                                                 : GENERIC;
                                     options                                                                 : INTEGER;
                                     maxHitsOfOneStringPattern                                               : INTEGER;
                                     includeOrExcludeInstanceTypeFilter                                      : SET OF GENERIC;
                                     VAR index                                                               : INTEGER;
                                     VAR anyMatchingInstances                                                : BOOLEAN;
                                     stringPattern1: STRING; VAR matchingInstances1, VAR matchingAttributes1 : LIST OF GENERIC;
                                     stringPattern2: STRING; VAR matchingInstances2, VAR matchingAttributes2 : LIST OF GENERIC; 
                                     stringPattern3: STRING; VAR matchingInstances3, VAR matchingAttributes3 : LIST OF GENERIC;
                                     stringPattern4: STRING; VAR matchingInstances4, VAR matchingAttributes4 : LIST OF GENERIC;
                                     stringPattern5: STRING; VAR matchingInstances5, VAR matchingAttributes5 : LIST OF GENERIC)
                                     status                                                                  : INTEGER;

Function to search all STRING data types in model for one or more specified string patterns. This function have variable number of arguments. The legal number of arguments are 9,12,15,18 or 21 arguments.

Arguments

Type	Name	Comment
GENERIC	modelId	The actual model to be search. This model must be open.
INTEGER	options	Optional argument. The default option value is "xpxCASE_SENSITIVE", i.e., all existing string roles will be search for matching the given string pattern by invoking xpfLike() with the option xpxCASE_SENSITIVE set.
INTEGER	maxHitsOfOneStringPattern	Optional argument. The default value is INDETERMINATE (?), i.e., all specified string roles will be searched before the search operation is terminated. When specified, this argument specifies the maximum hits before the search operation is terminated. The meaning of "maximum hits before the search operation is terminated" may have different interpretation according to the actual given "options" value (xpxSTOP_ON_FIRST_MATCH, xpxSTOP_ONE_ONE_REACHED_MAX_MATCH, xpxSTOP_ON_ALL_REACHED_MAX_MATCH)
SET OF GENERIC	includeOrExcludeInstanceTypeFilter	Optional argument. The default value is INDETERMINATE (?). When specified, this argument should be a set of entity names and/or full qualified roles, i.e., a SET OF STRING aggregate. An entity name element repesents all roles of the specified enity, i.e., all roles of the specified instance type. A fully qualified role has the format: "entityName.attributeName". When the option xpxINCLUDE_FILTER is set, only the roles specified in the "includeOrExcludeFilter" will be search. When the option xpxEXCLUDE_FILTER is set, all possible roles except those specified in the "includeOrExcludeFilter" will be searched. This argument have no effect when neither the xpxINCLUDE_FILTER nor the xpxEXCLUDE_FILTER options are set.
INTEGER	VAR index	Optional argument. Default value is index = 1, i.e., start searching on the first possible string value. When specified, it defines the index of the first string value to be searched. The index of the "last search string value + 1" is returned when the xpxFindStringPatternInModel() operation is terminated. This functionality enables the possibility to perform a search in an iterative way, i.e., the xpxFindStringPatternInModel() function can be called in a loop using the returned "index" value from one invocation as the input "index" value in the next invocation.
BOOLEAN	VAR anyMatchingInstances	Optional argument. Default value is INDETERMINATE (?). When specified this argument will be set to TRUE when at least one hit is found in the search, else "anyMatchingInstances" will be set to FALSE
STRING	stringPattern1 ... stringPattern5	This argument can be specified in 4 different ways: As a "string pattern" used in the xpfLike() operation that implements the actual search operation As an EDMexpressX logical expression (string) that is used in the actual search operation As an integer expressionId that identifies an EDMexpressX logical expression that is previously decoded by a xpfDecodeLogicalExpression() in the same EDMvmSession. As the actual string to search for when the option xpxEXACT_EQUALS is specified. The options xpxEXACT_EQUALS and xpxEXPRESSION_CONDITION are valid for all specified "stringPattern" arguments. Hence a mix of 1 and/or 2+3 and/or 4 is invalid. Only a mix of 2 and 3 are legal in one invocation of the xpxFindStringPatternInModel() function. One xpxFindStringPatternInModel() operation can maximum search for 5 string patterns
LIST OF GENERIC	VAR matchingInstances1.. matchingInstances5	This argument receives a LIST OF GENERIC with one instanceId for each hits, i.e., the number of elements in this list will be equal to the number of hits for the related "stringPattern" argument. The same instanceId may occur several times in the actual "matchingInstances" list as there may be more than one matching role in an instance.
LIST OF GENERIC	VAR matchingAttributes1.. matchingAttributes5	This argument receives a LIST OF GENERIC with one attributeId (attributeId is a role) for each hits, i.e., the number of elements in this list will be equal to the number of hits for the related "stringPattern" argument. The same attributeId may occur several times in the actual "matchingAttributes" list as there may be more instances that matches the search in the same role. A pair of elements with the same index in the "matchingInstances" and "matchingAttributes" lists uniquely identifies the matching string value (instanceId.attributeId). When the attributeId is an aggregate, the actual aggregate element index can be found by searching the aggregate. The function xpfAggrLike() is suitable for this operation.

Return Value

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'US:_r_XPX_Return_Value'.

Options

	Option	Comment
1	XPXSEARCH_TABLE_INSTANCES	Search all columns of all persistent EDMtableInstances. NOTE: option not yet implemented!
2	XPXSEARCH_USER_DEFINED_ENTITIES	Search all userDefinedEntity instances. NOTE: option not yet implemented!
3	XPXCASE_INSENSITIVE	Use case insensitive string comparison in the actual xpfLike() function that implements the actual search operation.
4	XPXCASE_SENSITIVE	Use case sensitive string comparison in the actual xpfLike() function that implements the actual search operation.
5	XPXINCLUDE_FILTER	The filter specified in the "includeOrExcludeFilter" argument is an "include filter". This option has no effect when no "includeOrExcludeFilter" is specified.
6	XPXEXCLUDE_FILTER	The filter specified in the "includeOrExcludeFilter" argument is an "exclude filter". This option has no effect when no "includeOrExcludeFilter" is specified.
7	xpxEXPRESSION_CONDITION	The specified "stringPatternOrCondition" arguments is specified as an textual EDMexpressX logical expression or an integer expressionId that has been compiled by the xpfDecodeLogicalExpression() or the xpxDecodeLogicalExpression() earlier in the actual EDMvmSession.
8	xpxEXCLUDE_AGGR_ROLES	No aggregate attributes (roles) will be searched.
9	xpxEXCLUDE_SIMPLE_ATTR_ROLES	No simple attributes (roles) will be searched. NOTE: option not yet implemented!
10	xpxEXACT_EQUALS	Search for equalness only, i.e., search for strings that are identical to the specified "stringPattern".
11	xpxSTOP_ON_FIRST_MATCH	The search operation will stop on the first found match.
12	xpxSTOP_ONE_ONE_REACHED_MAX_MATCH	The search will stop when the number of hits for at least one search condition is reached the max hits specified in the "maxHitsOfOneStringPattern" argument. This option has no effect when the "maxHitsOfOneStringPattern" argument is not specified.
13	xpxSTOP_ON_ALL_REACHED_MAX_MATCH	The search will stop when the number of hits for all given search condition have eached the max hits specified in the "maxHitsOfOneStringPattern" argument. This option has no effect when the "maxHitsOfOneStringPattern" argument is not specified.

Example

<Missing Example>

Arguments

Return Value

Options

Example

See also

Filter by label

Browser not supported