Reformatting Display Name Values in your Destination or Source2017-05-22 16:15:46
With multiple directories in your environment, you may run into situations where the Display Name format is different between directories (i.e., one directory uses a format of ‘First Last’ while another directory uses a format of ‘Last, First’). Or you may have a single directory in which the Display Name of all objects is inconsistent.
Syncing between two directories:
In a typical connection between two directories you may wish to reformat the Display Name that appears in your synced Destination contacts. To do this, select the desired Reformat Display Name Option (on the Display Name tab). When the Sync runs, your synced Destination contacts will have their Display Names reformatted to match the selected format.
Normalizing the Display Name on a single Source directory:
You may have a single LDAP directory in which the Display Name of objects are inconsistent (i.e., some are ‘First Last’ while others are ‘Last, First’). In this case, you may wish to normalize the attribute data so all Display Names appear in the same format.
Note: Be very careful with this type of connection. Your Source and Destination of this connection are the same, so you are overwriting your primary directory. If you do not configure this properly, there is no undo function. It is highly recommended you run a Simulation only (with the Sync disabled) with a Log File level 3-Detailed (on the General tab) and then review the Simulation log’s Dest Entry’s to determine if your results are as desired before running an actual Sync to update your Display names.
To do this, you configure the Sync/Join Mode to Join. The unique element of this connection is that the Source and Destination directories specified will be the same.
- Create a connection as usual. On the Source and Destination tabs, specify the exact same IP/login info to identify the directory where you want to normalize display names.
- On the Source tab, select the desired Object Types you’d like to pull.
- On the Display name tab, select the desired Reformat option.
- Select a Parse option of YES or NO. If you specify Parse=YES, UnitySync will break the original Display Name attribute into its component parts (First, Initials, Last) and use those values to rebuild the Display Name into the desired format. If you specify Parse=NO, UnitySync will use the actual First Name, Initials, and Last Name attributes to build the new display name.
- On the Destination tab, you must enable the Join mode to utilize Join with Existing Objects functionality. To do this, you must specify Join queries that are used to control the Join function. What attributes you chose depends on what Object Types you selected on the Source tab. If you are only using Object Type of Users, a good attribute to use for your queries is userprincipalname. For example:
- On the Destination tab, specify a single value in the ‘Modify Attributes’ parameter box. In Active Directory (AD) the attribute to specify is displayname. This setting is very important because you only want to modify the displayname attribute with this Sync run.
You may also choose to create a Custom Object Map file and remove ALL mapping lines except DN and displayname. The custom map is not required as long as you specify the Modify Attribute, but it does offer further security against accidently modifying other attributes when this sync is run.
- On the Destination tab, leave the Object Creation parameters blank.
- Click Apply.
It is strongly recommended you disable Synchronization and enable Simulation as well as a Log File level of 3-Detailed. Run a Simulation first and review the Dest Entry in the Sim log to confirm results before running a real Sync.