Novell Designer for Identity Manager 3.5, Manual, Page: 339 / 510

Noun Tokens 339
no
vd
ocx
(e
n)
13
Ma
y 20
09
Query
Queries the source or destination data store and returns the resulting instances.
Fields
Datastore
Specify the data store to query.
Scope
Select the scope of the query. The options are entry, subordinates, or subtree.
Max Result Count
Specify the maximum number of results returned from the query.
Class Name
Specify the class name in the query. If a class name is not specified, all classes are searched.
Supports variable expansion. For more information, see
Section 3.6, “Variable Selector,” on
page 35 .
Select Object
Specify the base of the query. It can be the DN or an association. If neither is selected, the query
starts at the root of the datastore.
Match Attributes
Select the attributes to search for.
IMPORTANT: To improve performance when using the query noun, create an index for the
attributes that you are going to use when querying the Identity Vault. For more information
about indexes, see the
Novell eDirectory 8.8 Administration Guide (http://www.novell.com/
documentation/edir88/edir88/index.html?page=/documentation/edir88/edir88/data/
a5tuuu5.html)
.
Strings
Specify the set of attributes to return. If nothing is specified, no attributes are read. Use an
asterisk to read all attributes.
Remarks
The Query token returns a
node set
containing the instance elements found as a result of the query.
To effectively use the results of a Query token it must be used in a context that is expecting a
node
set
. For example, you could assign the result to a variable of type
node set
, or iterate through the
result using a
for each
loop.
Treating the
node set
as if it were a
string
seldom provides anything useful. Extracting useful
information from the
node set
or its constituent instance elements requires the use of an XPath
expression and knowledge of the structure of an instance element. For additional information, see
the following:
Š
“ instance ” in the Identity Manager 3.6 DTD Reference .