This documentation is archived and is not being maintained.

Map Project Server Components to Team Foundation Components

Before you can synchronize data between Visual Studio Team Foundation Server 2012 and Microsoft Project Server, you must first configure several points of integration between the two server products. You define each point of integration by defining the association or mappings between server products, project plans, and team projects. Each association that you define adds software logic and processes to support the data synchronization between the two servers.

You can register multiple instances of Project Web Access or Project Web App (PWA) to Team Foundation Server, and you can map multiple team project collections to an instance of PWA.

In this topic


For an end-to-end overview of how to integrate these products, see Configure the Integration of Team Foundation Server and Project Server.

In addition to the mappings that this topic describes, you can also define how fields and types of work items participate in data synchronization. You define how fields are mapped for a collection and which types of work items can be synchronized for a team project. You map only fields in Team Foundation to fields in Project Server whose data you want to synchronize, and you map types of work items that you want to synchronize with tasks in a project plan. For more information, see Customize the Field Mapping Between Project Server and Team Foundation Server and Specify the Work Item Types That Can Be Synchronized.

You can register multiple instances of PWA to a single deployment of Team Foundation Server. The most common configuration will be the mapping of a single PWA to a single deployment of Team Foundation Server. However, if your Project Server deployment consists of multiple instances of PWA that must connect to Team Foundation Server, you can register each instance, as the following illustration shows:

Register PWAs to Team Foundation Server

Before you register an instance, you must install the required software on each application-tier server that hosts Project Server and each application-tier server for Team Foundation that will participate in data synchronization. For more information, see System and Setup Requirements to Support Integration of Team Foundation Server and Project Server.

When you register an instance, Team Foundation Server is updated with the information about the instance. In addition, the instance is updated with the custom fields and lookup tables that integration requires.

Back to top

For each instance of PWA that you have registered, you can map a team project collection that is defined on the application-tier server with which it is registered. You can map multiple collections to a single instance of PWA as the following illustration shows. However, you cannot map a collection to more than one instance of PWA.

Map PWAs to Team Project Collection

When you map a collection to an instance, information is added to Team Foundation Server about the instance, global fields, rules, and processes that are used by the synchronization engine for that collection.

Back to top

After you have mapped the collection to an instance of PWA and added field mappings to the collection, you can map an enterprise project plan to a team project. Before you can map a project plan, you must first publish the plan to Project Server. As the following illustration shows, you can map multiple enterprise projects to the same team project.

Associate enterprise projects with a team project

The Project Server tab and fields are added to the work item form for those types of work items that you have specified to participate in synchronization. For more information, see Project Server Fields Added to Support Data Synchronization.

Back to top