This action causes a query to be performed in the destination data store, and an appropriate destination DN, or an appropriate destination association, to be added to the current operation.
The following is an example of the Argument Builder used to provide the match attributes:
Scope of the operation. Select entry, subordinates, or subtree.
DN of the location to search using the selected scope.
Provide the attributes which must match to consider the search successful.
A DN argument is required when scope="entry", and is optional otherwise. At least one match attribute is required when scope= "subtree" or scope="subordinates".
Note that since it is undefined what a query does with the search attribute when scope="entry", it is also undefined what Find Matching Object will do.
The query generated has a scope attribute based on the selected scope, a destination DN attribute set to the content of the Enter DN field, if specified. It also has a class name attribute and search class based on the class name of the current object.
If the destination data store is the application, then an association will be added to the current operation for each successful match that is returned. No query will be performed if the current operation already has a non-empty association, thus allowing multiple find matching object actions to be strung together in the same rule.
If the destination data store is eDirectory, then the destination DN attribute for the current operation is set. No query is performed if the current operation already has a non-empty destination DN attribute, thus allowing multiple find matching object actions to be strung together in the same rule. If only a single result is returned and it is not already associated, then the destination DN of the current operation is set to the source DN of the matching object. If only a single result is returned and it is already associated, then the destination DN of the current operation is set to the single character . If multiple results are returned then the destination DN of the current operation is set to the single character � .