Share via


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:

  1. Download the field mapping file by using the TFSFieldMapping command-line utility.

  2. 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

  3. 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

Other Resources

Quick Tips and Operational Differences when Tracking Tasks Using Microsoft Project and Team Foundation

Using Team Foundation Server Command-Line Tools