Link Mappings

Overview

During a synchronization, once a connection between a source entity and a target entity have been found by the join rules or a new target entity has been created by provisioning, mapping rules are used to control which source entity data are added to the new or updated in the existing target entity.

Like a join rule, a mapping rule defines a source entity field and a target entity field. Unlike a join rule, however, mapping rules also include a direction, either Adapter to Locker (incoming), Locker to Adapter (outgoing), or  Bidirectional (both), which control when the mapping rule should be applied. Please note that joined fields are not mapped by default - you must manually add mapping rules between join fields as well if you want changes to these fields to be synchronized (including on newly provisioned entities).

In the screenshot below, for an incoming sync (from the HR System Adapter to the Employee locker) where an adapter entity is created, when provisioned the new target entity will be populated with all source target entity values with the exception of hrEmail.

If another links synchronization updates a locker entity's terminated and email fields, running a outgoing sync (from the Employee locker to the HR System Adapter) will update the adapter fields hrEmail value with the new locker entity's email field, but will not update the hrTerminated field as rule for that field is configured to only apply to incoming synchronizations.

Configuration

To add a mapping rule, click the Update Mappings button, click the Edit button and set the desired mappings, and then press the commit button.

Finally, press the Continue with Mapping button to save the mapping configuration.