Deprecated as of Identity Manager 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> 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.
See <placement-rules>.
( match-class * , match-path * , match-attr * , placement )