8.13 Matching - By Attribute Value

This rule matches for objects by specific attribute values. Implement the rule on the Matching policy in the driver. You can implement the rule on either the Subscriber or the Publisher channel or on both channels.

There are two steps involved in using the predefined rules; creating a policy in the Matching policy set and importing the predefined rule. If you already have a Matching policy that you would like to add this rule to, skip to Importing the Predefined Rule.

8.13.1 Creating a Policy

  1. From the Outline view or the Policy Flow view, select the Publisher or Subscriber channel.

  2. Select the Matching policy set in the Policy Set view, then click Create or add a new policy to the Policy Set icon Create or Add a New Policy icon to create a new policy.

  3. Click Create a new policy, then click Next.

  4. Name the policy.

  5. Use the default location or browse and select another location to place the policy in the driver.

    Create Policy Wizard

  6. Select Open Editor after creating policy, then click Next.

  7. Select DirXML Script for the type of policy, then click Finish.

  8. A file conflict window appears with the message “Before editing this item you need to save. Do you wish to save the editor’s changes and continue?” Click Yes. The Policy Builder is launched and the new Matching policy is saved.

  9. Continue with Importing the Predefined Rule.

8.13.2 Importing the Predefined Rule

  1. Right-click in the Policy Builder, then click New > Predefined Rule > Insert Predefined Rule Before or Insert Predefined Rule After.

  2. Select Matching - by attribute value, then click OK.

  3. Expand the predefined rule.

    Matching - by attribute value

  4. Edit the action by double-clicking the Actions tab.

  5. Delete [Enter base DN to start search] from the Specify DN field.

  6. Click the Edit the arguments icon Edit Arguments icon to launch the Argument Builder.

  7. Select Text in the noun list.

  8. Double-click Text to add it to the argument.

  9. In the editor, click the browse button, browse to and select the container where you want the search to start, then click OK.

  10. Click Finish.

  11. In the Specify Match Attributes field, click the Edit the match attributes icon Edit Arguments icon to launch the Match Attribute Builder.

  12. Click the browse button and select the attributes you want to match. You can select one or more attributes to match against, then click OK.

  13. Click Finish.

  14. Save the rule by clicking File > Save.

8.13.3 How the Rule Works

This rule matches for User objects by attributes. When a User object is synchronized, the driver uses the rule to check and see if the specified attributes exist. If the attributes do not exist, a new User object is created.