matching-rule

Specifies the criteria for finding a matching entry in the destination.

Description

The DirXML engine uses the following algorithm to determine if the add operation can use a particular matching rule.

  1. If the rule contains <match-class> elements, the class-name attribute in the add operation must match one of the class-names specified in the <match-class> elements.
  2. If the rule contains <match-attr> elements, the add operation must contain an attribute value for each of the attributes specified in the <match-attr> elements.

If a rule cannot be used, it is skipped, and the DirXML engine moves to the next rule.

Once a suitable rule is found, the DirXML engine queries the destination for entries that have the attributes specified by the <match-attr> elements in the matching rule and by the <add-attr> elements in the add operation. If the rule contains a <match-path> element, the DirXML engine uses that value to set the dest-dn attribute in the <query> element (this attribute specifies the starting point for the search).

The destination returns <instance> elements for each entry that matches.

Definition

  <!ELEMENT matching-rule (match-class*,
                           match-path?,
                           match-attr*)>
  <!ATTLIST matching-rule 
            description   CDATA   #IMPLIED>

Attributes

description
Provides a description of the rule for display in the ConsoleOne snapin.

Elements

match-attr
Specifies an attribute value that the entry must match.
match-class
Specifies the base class the entry must match before the rule can be used.
match-path
Specifies the root container of the directory that the entry must match.

Parent