TFSFieldMapping
Use the TFSFieldMapping utility to change or customize the project mapping XML file after you create a team project. For example, you can create work item types or modify existing ones to have new attributes. For information about the project mapping XML file, see The Microsoft Project Field Mapping File.
The TFSFieldMapping command-line utility is located in Drive:\Program Files\Visual Studio 10.0\Common7\IDE on a Team Explorer client computer.
Note
Even if you are logged on with administrative permissions, you must open an elevated Command Prompt to perform this function on a server that is running Windows Server 2008. To open an elevated Command Prompt, click Start, right-click Command Prompt, and then click Run as Administrator. For more information, see the Microsoft Web site.
Required Permissions
To use the TFSFieldMapping command, you must be a member of the Team Foundation Administrators or the Project Administrators security group. For more information, see Team Foundation Server Permissions.
TFSFieldMapping upload | download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile
Parameters
Argument |
Description |
|---|---|
/collection:CollectionURL |
Specifies the URI of the team project collection in the following format: http://ServerName:Port/VirtualDirectoryName/CollectionName If you do not specify a virtual directory is used, you must use the following format: http://ServerName:Port/CollectionName If you have previously connected to the server, you can specify the friendly name for the server instead of the URI. |
/teamproject:ProjectName |
Specfies the name of the team project whose mapping parameters you want to modify. If the name contains spaces, enclose it in quotation marks. |
/mappingfile:MappingFile |
Specifies the name and file path of the mapping file. |
Command |
Description |
|---|---|
upload | download |
Specifies whether to download or upload the field mapping file. |
Remarks
Follow these steps to customize the field mapping file:
Download the field mapping file by using the TFSFieldMapping command-line utility.
Edit the field mapping file by modifying existing fields, or by adding custom fields and attributes. For more information, see Change How Fields are Mapped to Microsoft Project
Upload the field mapping file by using the TFSFieldMapping command-line utility.
Example
The following command instructs the TFSFieldMapping utility to download the mapping file, MappingFile.xml that is located on drive C. The location of your mapping file can differ.
>TFSFieldMapping download /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /teamproject:AdventureWorks /mappingfile:C:\MappingFile.xml
In the previous example, the following values apply:
URI for the team project collection: http://AdventureWorksServer:8080/AWTeam/Collection1
Project name: AdventureWorks
Mapping file name and path: C;\MappingFile.xml
See Also
Tasks
Set Administrator Permissions for Team Project Collections
Change How Fields are Mapped to Microsoft Project
Reference
Field Mappings in Microsoft Project
Concepts
The Microsoft Project Field Mapping File
Customizing Microsoft Project Field Mappings