matching-rule

Deprecated as of DirXML 2.0 - use DirXMLScript <rule> and <do-find-matching-object>.

<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> 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>. It then checks if any <match-attr> criteria is 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.

Once 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.

Example

See <matching-rules>