TFSFieldMapping

Use the TFSFieldMapping utility to change or customize the project mapping XML file after creating a team project. For example, you can create new work item types or modify existing ones to have new attributes.

The TFSFieldMapping command-line utility is located in <drive>:\Program Files\Visual Studio 9.0\Common7\IDE on Team Explorer client computer.

Note

Even if you are logged on with administrative credentials, 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 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 and Team Foundation Server Default Groups, Permissions, and Roles.

TFSFieldMapping upload | download serverurl projectname filepath 

Parameters

Argument

Description

serverurl

URL of the server.

projectname

Name of the team project. If the name contains spaces, enclose the name in quotes.

Filepath

Name and file path of the mapping file.

Command

Description

Upload | download

Download or upload the field mapping file.

Remarks

The steps involved in customizing the field mapping file are:

  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 How to: 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 http://TeamFoundationServer AdventureWorks C:\MappingFile.xml 

In the above code:

  • http://TeamFoundationServer is the URL of the server.

  • AdventureWorks is the name of the team project.

  • C:\MappingFile.xml is the name and location of the field mapping file.

See Also

Tasks

How to: Change How Fields are Mapped to Microsoft Project

Reference

Field Mappings in Microsoft Project

Other Resources

Managing Permissions

Using Team Foundation Server Command-Line Tools