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 Variable Selector.

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 NetIQ eDirectory Administration Guide.

Read Attribute

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:

Example

Query
Editor