Active Roles 7.5.3 - Synchronization Service Administration Guide

• About mapping objects
• Steps to map objects
• Steps to unmap objects

Object mapping allows you to establish one-to-one relationships between objects in two connected data systems. By using object mapping, you can determine what objects will participate in data synchronization operations you run between these two data systems.

Synchronization Service maps objects automatically when running the creating steps of a sync workflow. In this case, one-to-one relationship is automatically established between source objects and their counterparts created in the target connected system during the creation operation. In some cases, however, you may need to manually map objects. For example, you should configure object mapping before running a sync workflow that includes updating or deprovisioning steps. By doing so, you provide Synchronization Service with the information on which objects need to be updated or deprovisioned in the target data system.

To map objects, you can use mapping pairs and mapping rules. A mapping pair allows you to establish a relationship between a certain object type in one connected system and its counterpart in the other connected system. A mapping rule allows you to define the scope of conditions where the objects belonging to the object types specified in a particular mapping pair will be mapped. For a mapping pair you can create multiple mapping rules, each defining a specific mapping condition. In order your mapping rules take effect, you need to run them. After you run a mapping rule, Synchronization Service reads data in the connected data systems for which the rule is configured, and then maps the objects that meet the conditions specified in the mapping rule.

The following example shows how a mapping rule works:

Figure 9: Object mapping

In this example, one-to-one relationship is established between the user object John Malcolm in Connected System 1 and the user object John Doe in Connected System 2: the first names of these user objects match, and thus the condition specified in the mapping rule is met. Now, if you configure a sync workflow for these systems and populate it with synchronization steps, identity information will be synchronized between these two user objects, since they are mapped. The direction of synchronization depends on which of these two connected data systems acts as the synchronization source and which is the target.

The next sections cover the following:

• Steps to map objects
• Steps to unmap objects

You can map objects in two data systems to which Synchronization Service is connected. To map objects in two connected data systems, complete the following steps:

• Step 1: Create mapping pairs
• Step 2: Create mapping rules
• Step 3 (optional): Change scope for mapping rules
• Step 4: Run map operation

In this step, you create mapping pairs that specify the types of objects you want to map in two connected systems. You can create as many mapping pairs as necessary.

To create a mapping pair

1. In the Synchronization Service Administration Console, open the Mapping tab.
2. Click the name of the connection for which you want to map objects.
3. Click Add mapping pair.
4. On the Specify source page, next to Connected system object type, click Select, and then select the type of object you want to map.
5. Click Next.
6. On the Specify target page, do the following:
   1. Next to Target connected system, click Specify, and then specify the other connected system where you want to map objects.
   2. Next to Connected system object type, click Select, and then select the type of object you want to map.
7. Click Finish to create the mapping pair.

   Repeat the above steps to create mapping pairs for as many object types as necessary.