06. Transformation Tool

You can use the Transformation Tool to change your domain or users’ email address format between your UEM source server and your UEM target server.

ATTENTION:

• You must save the new settings before you send your first invitations. The users’ email address will then be transformed during the migration process and will be adapted to the format/domain of your configuration to match the username for the target system.
• You cannot save the Transformation settings if the project is already complete (100%).

You can access the Transformation Tool via the button ‘Transformation’ which can be found at the migration project dashboard of each migration project:

NOTE:

• The Transformation Tool is case sensitive.
• The EBF Onboarder will send the invitations and reminders to both email addresses by default (source and target email address). You can change the settings if you want to avoid duplicates and if the email should be sent to only the source email address or to the target email address. You can do this by using the check boxes at the bottom of the box. Here you can choose between ‘Source’, ‘Target’ and ‘Both’:
  

06.1 Domain change between source and target UEM system

You can use the Transformation Tool to change the domain between your UEM source server and your UEM target server, e.g.:

To change the domain or extension, click on ‚<>‘ and change ('{mail}').replace('acme.org','acme.com') to ('{mail}').replace('mycompany.com','new-company.org') and click on ‚Save‘:

06.2. Email format change between source and target UEM system

You can use the Transformation Tool to change your users’ email address format and/or domain between your UEM source server and your UEM target server, e.g:

For the format change, you need to prepare a list which contains each user’s source email address and each user’s target email address, one user per line:

Source_Email_Address_User1,Target_Email_Address_User1
Source_Email_Address_User2,Target_Email_Address_User 2
Source_Email_Address_User3,Target_Email_Address_User 3

NOTE:

• Separate the email addresses by a comma, with no blank after the comma.
• The use of a semicolon as separation character is supported as well. But you can only use one or the other (comma or semi-colon) in the list.
• Don’t enter a blank at the end of the line or within the line.

Clear the current content of the editor, paste the list directly into the Transformation Tool and click on ‘Save’:

The Transformation Tool will automatically create the rules for your changes. If you open the Transformation Tool again, you will see the script which looks like this:
('{mail}').replace('Source_Email_Address_User1','Target_Email_Address_User1')
.replace('Source_Email_Address_User2','Target_Email_Address_User2')


06.3. Additional parameters

There are two other additional parameters available:

• userid: Clear the current content and enter userid (only once) and press ‘Save’. The EBF Onboarder searches the source system for the userid field of each user of the migration project and will use this value as the email address for the target system.
  
• customattribute1-5 (for VMware Workspace ONE only): In order to make a connection between the source email address and the target email address, you have to add the new email address in the customattribute1 field in VMware Workspace ONE. The EBF Onboarder can use this value if you enter customattribute1 in the Transformation Tool and press ‘Save’.