Find
Find(CX_xxxxx)
parameters: Identifier of a class
Stack | Position | Description |
---|---|---|
Stack(In) | Top | Query string |
Top 1 | Parameter 1 | |
. . . | . . . | |
Top-n | Parameter n | |
Stack(Out) | Collection of the found objects |
All objects of the Root EP Collection, which fulfil the condition formulated in the query string, are provided in a temporary collection. The settings made with SetLayer and SetDomain(READ) together with the class specified as a parameter determine which collection is searched.
Find(STACK)
Stack | Position | Description |
---|---|---|
Stack(In) | Top | Identifier of a class |
Top 1 | Query string | |
top 2 | Parameter 1 | |
. . . | . . . | |
Top-n | Parameter n | |
Stack(Out) | Collection of the found objects |
As above, but the class is on the stack.
Find(CX_xxxxx, access expression)
parameters: class identifier, an access expressionreferring to a collection
Stack | Position | Description |
---|---|---|
Stack(In) | Top | one object |
Top 1 | Query string | |
top 2 | Parameter 1 | |
. . . | . . . | |
Top-n | Parameter n | |
Stack(Out) | Collection of the found objects |
This form is used to search in a collection that is embedded as a data member in an object. From the initial object on the stack top, the collection can be accessed via the access expression specified in the second parameter.
The result collection is transient and therefore only valid within the current transaction. With SaveCollection, however, you can make it persistent so that the result of the query can also be used in subsequent transactions.
Find(STACK, access expression)
Parameter: an access expressionreferring to a collection
Stack | Position | Description |
---|---|---|
Stack(In) | Top | Identifier of a class |
Top 1 | one object | |
top 2 | Query string | |
top 3 | Parameter 1 | |
. . . | . . . | |
Top-n | Parameter n | |
Stack(Out) | Collection of the found objects |
As above, but the class is on the stack.
Find(CX_xxxxx, this)
parameters: Identifier of a class
Stack | Position | Description |
---|---|---|
Stack(In) | Top | a collection |
Top 1 | Query string | |
top 2 | Parameter 1 | |
. . . | . . . | |
Top-n | Parameter n | |
Stack(Out) | Collection of the found objects |
With this shape, you search in a collection that is on the stack. Please note that the class name is only given pro forma. It has no influence on the search result.
If you want to search for a specific class, this must be specified in the query string with "classID=CX_XXXXXXXX".
Example for the use of Find.