This function provides even more powerful way of collecting elements within
the DSM (Data Source Model) as compared to the findElementsByLPath()
function.
Now, instead of a single Location Path, the search of elements is specified using an array of Location Rules, which comprise a whole bunch of Location Paths, whose processing may be automatically repeated during a single call.
See "What are Location Rules?" section below for more information.
Parameters:
element
The initial context element against which the Location Rules are interpreted.If this parameter is not specified, the generator context element is used by default, which is the same as the call:
contextElement.findElementsByLRules(...)
See Also:
GOMContext.contextElement
locationRules
Specifies the array of Location Rules to be interpreted.Each Location Rule is represented by an object created using
LocationRule()
function. See description of that function for more detail.Note: You can use the Location Rule Builder (found at the left panel's tree) to quickly construct Location Rules needed for this parameter.
elementTypeSpec
Specify the list of target Element Types (see "Specifying Matching Element Types" below).When this parameter is specified, only those initially found elements will be included in the result enumeration, which comply with at least one of the specified target Element Types.
filterQuery
Specify an additional condition on the returned elements.This should be a boolean subquery created with
BooleanQuery()
function. The subquery will be processed against each initially selected element. It must returntrue
if the element should be included in the result enumeration andfalse
otherwise. The tested element is passed as the generator context element.
Returns:
The enumeration of GOMElement
instances representing the found elements.
See Also:
LocationRule(), BooleanQuery(), findElementByLRules(), countElementsByLRules(),
checkElementsByLRules(), findElementsByLPath(), getValuesByLPath()
${include ../../../refs/lrules.htm}
${include ../../../refs/matching_ets_spec.htm}