Import configuration data


Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online


The content in this topic that applies to online versions of Dynamics 365 is for versions prior to Dynamics 365 (online), version 9.0. For the latest documentation, see Import configuration data.

After exporting your configuration data from the source Dynamics 365 instance, you are now ready to import it to the target Dynamics 365 instance.

Before you begin

Download the Microsoft Dynamics CRM SDK package. Then extract the contents of the package on your computer. The Configuration Migration tool is available under the SDK\Tools\ConfgurationMigration folder in the extracted Dynamics 365 SDK package. You do not need to install the Configuration Migration tool. Run the tool by double-clicking the DataMigrationUtility.exe file in the SDK\Tools\ConfgurationMigration folder.

Import configuration data

  1. Start the Configuration Migration tool.

  2. On the main screen, click Import data, and click Continue.

  3. On the Login screen, provide authentication details to connect to your Dynamics 365 instance from where you want to import data. If you have multiple organizations on the Dynamics 365 server, and want to select the organization where to import the configuration data, select the Always display list of available orgs check box. Click Login.

  4. If you have multiple organizations, and you selected the Always display list of available orgs check box, the next screen lets you choose the organization that you want to connect to. Select a Dynamics 365 organization to connect to.

  5. Provide the data file. (.zip) to be imported. Browse to the data file, and select it. Click Import Data.

  6. This step is applicable only if the data that you are importing contains the user information of the source system. Enter mapping user information on the target system. You can either map all of them to the user who is running the import process or map to individual users by using a user map file (.xml). If you choose the latter, you will have to either specify an existing user map file or the tool can generate it for you. If you generate a new file, fill in the mapping user name in the New parameter for every user on the source server. Select the user map file in the tool when you are done, and click OK.

    Import file users to Dynamics 365 Mapper

    The next screen displays the import status of your records. The data import is done in multiple passes to first import the foundation data while queuing up the dependent data, and then import the dependent data in the subsequent passes to handle any data dependencies or linkages. This ensures clean and consistent data import.

  7. Click Finish to close the tool.

See Also

Manage configuration data

© 2017 Microsoft. All rights reserved. Copyright