How to: Edit the User Map File
The ClearQuest converter uses the user mapping file to map user IDs in the ClearQuest database to an equivalent Team Foundation work item tracking user ID. Because Team Foundation Server uses Windows user accounts to identify users, all ClearQuest user IDs must be mapped to appropriate Windows user accounts for migration to work correctly.
A default version of the user map file is generated by the ClearQuest converter during the analysis phase. Make sure that this file is accurate before you continue with the conversion, because the converter first checks this file and will fail if there are problems.
Required Permissions
To perform these procedures, you must be a member of the Project Administrators group or have the View project-level information and Edit project-level information permissions set to Allow. For more information, see Team Foundation Server Permissions.
To change the user mapping file
Open the usermap.xml file. A sample is provided here:
<UserMappings> <UserMap From="admin" To="domain\AdminAccount" /> <UserMap From="user" To="domain\UserAccount" /> <UserMap From="QE" To="domain\QEAccount" /> <UserMap From="lead" To="domain\LeadAccount" /> <UserMap From="engineer" To="domain\Engineer" /> </UserMappings>Examine the user mappings and correct, add, and delete as required. The "to" side of the user mapping must be a valid Windows user account.
Note
If the user account is intended to view or modify data in the migrated work items, that user account must also be a member of the Team Foundation Valid Users group on the Team Foundation Server.
In Team Foundation work item tracking, add all the users specified in the user mapping file. For more information about how to add users, see Managing Users and Groups.
See Also
Tasks
Walkthrough: Migrating ClearQuest Work Items to Team Foundation