Deprecated as of Identity Manager 2.0. Use DirXMLScript <rule> and <do-find-matching-object> instead.
<matching-rule> is used to specify the criteria for finding a matching object for automatic association of a new object as a result of an <add> event.
When a <matching-rule> is evaluated, it first checks whether or not this is a suitable rule for the <add> event in question. It does this by checking if any <match-class> elements are specified by the rule. If so then the rule is only suitable if the class name on the event matches the class name on one of the <match-class> elements. It then checks if any <modify-attr> criteria are specified by the rule. If so, the rule is only suitable if the <add> contains an attribute value for each attribute specified by a <match-attr>. If a rule is determined to not be suitable, it is skipped.
When a suitable rule is found, a <query> is generated based on the criteria specified by the rule (<match-attr and <match-path>), and the class name and attribute values specified by the <add>. This query is sent to the destination (eDirectory or driver). Any <instance> elements returned are considered matches.
See <matching-rules>.
( match-class * , match-path ? , match-attr * )