placement-rule

Remark

<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> elements are specified by the rule. If so, 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 <match-attr> criteria are 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 are specified by the rule. If so, 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.

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

Allowed Content

Attributes

Content Rule

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

Parent Elements