Returns all elements that are associated with at least one of the given keys in the element map with the specified identifier and satisfy the filter condition (if specified).
Parameters:
elementMapId
The element map identifierNote: When the element map with such an identifier does not exist, the generator shows the error message.
keys
The array containing the hash keys
filterQuery
This parameter allows you to specify an additional condition on the elements included in the result enumeration.When specified, this should be a boolean subquery created with
BooleanQuery()
function. The subquery will be processed against each initially selected element and should returntrue
if the element must be included in the result enumeration andfalse
otherwise. The tested element is passed as the generator context element.
Returns:
The enumeration of the result elements.The order in which the elements appear in the enumeration is this:
- The first follow the elements associated with the
keys[0]
. These elements will be ordered the same as they have been put intitally in the map by that key.- Then follow the elements associated with the
keys[1]
, also ordered the same as they have been put in the map.- This is repeated for all other keys successively.
If an element is associated with more than one keys, it will appear only once for the first of those keys.
Note that two different
GOMElement
instances represent the same DSM elements when theirGOMElement.id
identifiers are equal.If there are no elements associated with the keys, the returned enumeration is empty.
See Also:
prepareElementMap(), countElementsByKeys(), BooleanQuery()