The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Change How Fields are Mapped to Microsoft Project

If you want to change the publishing behavior for Office Project, you must change the Office Project mapping file. By modifying the mapping file, you can specify which fields in Team Foundation are mapped to by Office Project fields. You can also control publishing behavior through the PublishOnly attribute, and designate special fields such as the context field.

A mapping file is associated with one team project. You can change the mapping file at any point in time on a team project. The mapping file a team project starts with is determined by the mapping file from the process template that was used to create the team project.


When you modify the mapping file for a team project, you are modifying the Office Project field maps for all team members on that team project.

Required Permissions

To perform these procedures, you must be a member of the Project Administrators group or have your Edit project-level information and View Project-level information permissions set to Allow. Additionally, you must have permissions to create the mapping file in the local path that you specify. For more information, see Team Foundation Server Permissions.

To change how work item fields are mapped to Office Project

  1. Download the mapping file from the team project that you want to modify. For more information, see Download or Upload a Microsoft Project Field Mapping File.

  2. Open the mapping file that you downloaded (for example, C:\MappingFile.xml) in an XML editor.

  3. Add new mappings or edit existing mappings in the following format:

    <Mapping WorkItemTrackingFieldReferenceName="fieldname" 
       ProjectName="user friendly name"

    For example:

    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Common.Priority"
       ProjectName="Work Item Priority" />


    Microsoft.VSTS.Common.Priority is an existing field in the Microsoft Solutions Framework (MSF) for Agile Software Development process.

    pjTaskText19 is a custom text field in Office Project.


    For a full list of all the Office Project field values for the ProjectField attribute, see Field Mappings in Microsoft Project.

  4. (Optionally) Indicate if the field is to be published but not refreshed. Add the PublishOnly attribute to the mapping section for that field and set the attribute to true. This attribute can be used to allow for team members to see a field value but not be able to change it in Team Foundation.

  5. Designate which Office Project field is the synchronization field by using the following syntax:

    <SyncField ProjectField="" />

    The following example shows how to specify pjTaskText25 as the synchronization field:

    <SyncField ProjectField="pjTaskText25" />
  6. Save the mapping file.

  7. Upload the mapping file to the team project that you want to modify. For more information, see Download or Upload a Microsoft Project Field Mapping File.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

© 2015 Microsoft