placement-rule

Specifies the criteria for generating a distinguished name for a new entry.

Description

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

  1. If the rule contains any <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 any <match-attr> elements, the add operation must contain an attribute value for each of the attributes specified in the <match-attr> elements.
  3. If the rule contains a <match-path> element, the src-dn of the add operation must match one of the subtrees specified by the <match-path> element.

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 uses the <placement> element to generate a value for the dest-dn attribute for the add operation. If no suitable rule is found, the dest-dn attribute of the add operation is left blank.

Definition

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

Attributes

description
Provides a description of this placement rule for display by ConsoleOne.

Elements

match-attr
Specifies attribute values the entry must match to use this placement rule.
match-class
Specifies the base class the entry must match to use this placement rule.
match-path
Specifies the root container the entry's dn must match to use this placement rule.
placement
Specifies where the entry is placed when it matches all the placement criteria.

Parent