Find

Find

Find(CX_xxxxx)

parameters: Identifier of a class

Stack

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

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

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

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

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.