web
You’re offline. This is a read only version of the page.
close
Skip to main content
Community site session details

Community site session details

Session Id :
Customer experience | Sales, Customer Insights,...
Unanswered

Unable to migrate users when transfering data using the Configuration Migration Tool (A user map is required to proceed)

(0) ShareShare
ReportReport
Posted on by 38

I am trying to transfer the members of teams (teammembership) using the Configuration Migration Tool. The teammembership table is an n:n relationship between users (systemusers) and Teams (team). Because users have different IDs in each environment (systemuserid) I look them up by user name (domainname)

pastedimage1664306669011v2.png

My schema is as follows:

pastedimage1664306589438v1.png

When I export and then import, I receive the warning "User Map required" and the error "A user map is required to proceed." No additional information is in the error log.

pastedimage1664308983691v1.png

The documentation states in step 6 that on import, the tool will detect that users are being imported and prompt for a user mapping file. This never happens.

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.

pastedimage1664306949951v4.png

Tom4U answers his own question in another post that he had to include the User relationships fieldsecurity and syncattributemappingprofile and then validate the schema to get the user mapping prompt to show up on import. This did not help me, nor did including all of the fields for the user table.

What magic trick is required to have the user mapping prompt show up on import?

I have the same question (0)
  • Jim Daly Profile Picture
    on at
    RE: Unable to migrate users when transfering data using the Configuration Migration Tool (A user map is required to proceed)

    Your link to the documentation is old.

    This is the current doc: learn.microsoft.com/.../import-configuration-data

    Step 6 seems the same in both.

    But please make sure you are not following the instructions in the old doc to download the SDK package. Make sure you are getting the latest version from NuGet as described in the newer doc.

  • Tim Partridge2 Profile Picture
    38 on at
    RE: Unable to migrate users when transfering data using the Configuration Migration Tool (A user map is required to proceed)

    Thanks for the correct link. I updated my post with it. I also re-downloaded the SDK and tried again but got the same result. Powershell shows Microsoft.CrmSdk.XrmTooling.ConfigurationMigration.Wpf 9.1.0.80 installed successfully and the properties > details tab of the DataMigrationUtility.exe file shows Product version as 4.0.0.80+ga9ede91

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

Responsible AI policies

As AI tools become more common, we’re introducing a Responsible AI Use…

Abhilash Warrier – Community Spotlight

We are honored to recognize Abhilash Warrier as our Community Spotlight honoree for…

Leaderboard > Customer experience | Sales, Customer Insights, CRM

#1
Rishabh Kanaskar Profile Picture

Rishabh Kanaskar 235

#2
MVP-Daniyal Khaleel Profile Picture

MVP-Daniyal Khaleel 177

#3
Tom_Gioielli Profile Picture

Tom_Gioielli 156 Super User 2025 Season 2

Last 30 days Overall leaderboard

Product updates

Dynamics 365 release plans