# placement-rule

Deprecated as of DirXML 2.0 - use DirXMLScript <rule>.

<placement-rule> is used to specify the criteria for generating a distinguished name for an object that is about to be created.

When a <placement-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 all the attribute values required by the <match-attr>. It then checks if any <match-path> criteria is specified by the rule. If so then the src-dn of the <add> must be in at least one of the subtrees specified by a <match-path>. If a rule is determined to not be suitable it is skipped.

Once a suitable rule is found, the <placement> is evaluated to generate a value for the dest-dn attribute on the <add>.

If no suitable rule is found the dest-dn is left blank and processing of the <add> continues.

Example

See <placement-rules>

## 1. Allowed Content

> match-class
>   Match a class-name. Deprecated as of DirXML 2.0.
> match-path
>   Match a path. Deprecated as of DirXML 2.0.
> match-attr
>   Match an attribute. Deprecated as of DirXML 2.0.
> placement
>   Object placement specifier. Deprecated as of DirXML 2.0.

## 2. Attributes

> Attribute | Value(s) | Default Value
> --- | --- | ---
> description | CDATA Description of this rule, primarily for use in ConsoleOne. | #IMPLIED

## 3. Content Rule

> ( match-class * , match-path * , match-attr * , placement )

## 4. Parent Elements

> placement-rules
>   Top level element for object placement rules. Deprecated as of DirXML 2.0.

Top Elements || All Elements || Tree