#Create Migration Mappings

After creating a project, create migration mappings to define the source and destination objects.

You have two ways to create mappings for a project.

• You can create mappings directly after creating the project using any of the following methods.

  • Add from scanned objects

  • Import mappings

• You can also click Projects in the left pane to access the Projects page, and click the project name of the project for which you want to create mappings.

  On the Project mappings page, you can directly click Create mapping to add mappings from scanned objects or import mappings only.

Add mappings:

To manually add mappings, refer to the following steps:

1. Click Add from scanned objects on the Add/Import mapping page. The Add from scanned objects panel appears. Make sure you have scanned source objects on the source agent.

   

2. Select the mode to add mappings:

   • Tree mode – The users, groups, and contacts in the source Active Directory will be automatically loaded based on OUs. Select a node or expand a node and select a sub node to add mappings for the selected objects.

   • Search mode – Select a type from the drop-down list, enter the keywords of the object, and press Enter on the keyboard. The search results will be displayed. Select desired objects and click Add to add mappings for the selected objects.

     

3. Complete the following configurations for each mapping if required:

   • Destination object (optional) – Enter the destination migrated user/group/contact. If not configured, Fly will automatically create an object in the destination using the same name as the source.

   • Destination display name (optional)– Enter the display name of the destination migrated user/group/contact. If not configured, Fly will automatically create an object in the destination using the same display name as the source.

   • Destination OU – Enter the OU of the destination migrated user/group/contact.

   NOTE

   Illegal characters (/[]: |=,+*?<>@") in the specified destination object name will be automatically replaced with underscores (_) by Fly, following the Active Directory naming standards. If a destination object is specified in a mapping, Fly uses it to generate the destination user's UPN, overriding the automated UPN from your policy.

4. Click Save after you finish adding mappings to the project.

5. If there are mappings that already exist in another project, the Alert panel will appear. You can select to remove duplicate mappings from the current project, or move duplicate mappings found in other projects to the current project. Then, click Save to save the updates.

Import mappings:

To import mappings in bulk by importing a configured Excel file, refer to the following steps:

1. Click Import on the Add/Import mapping page.

2. In the Import panel, you can download the template for mapping examples and configure mappings directly in the file; or you can click Export on the Add/Import mapping page to export a mapping file and modify it.

3. Configure the information of each mapping in one row, and save the file. You can refer to the table below for how to configure the mappings.

   NOTE

   Illegal characters (/[]: |=,+*?<>@") in the specified destination object name will be automatically replaced with underscores (_) by Fly, following the Active Directory naming standards. If a destination object is specified in a mapping, Fly uses it to generate the destination user's UPN, overriding the automated UPN from your policy.

   

Column	Value
Source object	The sAMAccountName of the source user/group.The cn of the source contact.
Source display name	The display name of the source user/group/contact.
Source OU	The OU of the source user/group/contact.
Destination object (optional)	The destination migrated user/group/contact.
Destiantion display name (optional)	The display name of the destination migrated user/group/contact.
Destination OU	The OU of the destination migrated user/group/contact.
Object type	UserGroupContact

4. After the configurations, import the mapping file by dragging the file or browsing the file from the local location. Click Save to save the mapping file to the project.

5. Click Save after you finish adding mappings to the project.

#Other Actions

You can also perform the following actions to manage migration mappings in the project.

• Refresh stage status – Click Refresh to retrieve the stage’s latest status of the mappings.

• Export scanned objects – Click Export scanned objects to download the scan results, which include contacts, groups, and users from the source Active Directory.

• Edit Mapping – Select a mapping, click the More button, and click Edit mapping to update the mapping.

  NOTE

  You can only edit new mappings.

• Move mappings – To move mappings from the current project to a different project, select the mappings, click the More button, and click Move mapping. Select a project and click Move in the Move mapping panel. You can enter the keyword of a project in the Search project text box and click the magnifier button to search the project.

• Delete mappings – To delete mappings that are not needed, select the mappings, click the More button, and click Delete mapping.

Generate migration report – When the migration jobs are finished, you can select one or multiple mappings and click Generate report to access the Generate error report panel. Then, select a report file type to be generated and click Generate to generate migration reports to the download location of your browser.

• Categorize with color – You can categorize your mappings with a desired color. What the applied color represents is left up entirely to your organization.

  • You can hover your mouse over a mapping and click the apply color button. Select a color in the Select a color window to apply to the mapping.

    

    The apply color button.

  • You can also select one or multiple mappings, click the More button, and click Categorize with color. In the Select a color window, select a color and click Apply.

• Export mapping – To export mappings in a project to an Excel file, select desired mappings, click the More button, and click Export mapping.

• Manage columns – Click Column to select the columns you want to display on the page, and click Apply to apply the display conditions. The Source column cannot be deselected.

• Filter mappings – Click Filter to filter mappings by desired conditions.

• Create personal view – This allows you to create a personal view for the configuration of filters or displayed columns for convenience. Click the System view drop-down list behind Filter, and click Save as. In the Save as window, enter a name for your view. To make this view available only to you, enable the Make this a private view button to save it as a private view. To make it available to all accounts of your AOS tenant, leave the Make this a private view button disabled to save it as a public view.

• After creation, either a private or public view can be set as default, renamed, or deleted. A private view can also be made public.

• Search mappings – Search mappings by entering the keyword of the source/destination in the search box.