placement-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 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.
match-path
Match a path.
match-attr
Match an attribute.
placement
Object placement specifier.

2. Attributes

AttributeValue(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.

Top Elements || All Elements || Tree


NDS DTD