Managing the Association of Enterprise Projects to Team Projects

Article
08/13/2012

To support synchronization of data between an enterprise project plan and a team project, you must map the plan to the team project. You can map multiple plans to the same team project. To map enterprise projects, you must have registered and mapped the instance of Project Web Access or Project Web App (PWA) that is associated with the enterprise project to a team project collection.

Before you can map an enterprise project plan to a team project, you must have configured the integration of the two server products. For more information, see Configuring the Integration of Team Foundation Server and Project Server. After you have performed the initial configuration, you can map and unmap plans to team projects as needed.

In this topic

Retrieve the Instances of PWA That Are Registered
Retrieve the Project Collections That are Mapped to Instances of PWA
Associate an Enterprise Project Plan with a Team Project
Remove the Association Between an Enterprise Project Plan and a Team Project
Add Resources in Team Foundation Server to the Resource Pool for Project Server

Required Permissions

To perform these procedures, you must have the Administer Project Server integration permission for a team project collection, or you must belong to the Team Foundation Administrators group. Also, the service account for Visual Studio Team Foundation Server must have administrative permissions to the instances of PWA that will participate in data synchronization. For more information, see Assigning Permissions to Support Integration of Project Server and Team Foundation Server.

Retrieve the Instances of PWA That Are Registered

By using the following command, you can list the instances of PWA that have been registered with an application-tier server and are available to be mapped to a team project collection.

To list registered instances of PWA

On a computer where Team Explorer and Service Pack 1 for Visual Studio 2010 are installed, open a Command Prompt window, and change to the directory that contains the TFSAdmin tool.

By default, the tool is located in Drive:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE. For 64-bit machines, the tool is in Drive:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE.
Type the following command, and then press ENTER.
```
TfsAdmin ProjectServer /GetRegisteredPWA /tfs:tfsUrl
```
Replace tfsUrl with the uniform resource locator (URL) of the application-tier server.

The following message appears:

The following PWA instances are registered: pwaUrl.

For more information, see Registering an Instance of PWA to Team Foundation Server.

Retrieve the Project Collections That Are Mapped to an Instance of PWA

By using the following command, you can determine which collections are mapped to an instance of PWA and available to participate in data synchronization. You can associate an enterprise project plan only with a team project that is hosted on a collection that has been mapped to the instance of PWA that supports your plan.

To list the mapped collections

At a command prompt, type the following command, and then press ENTER:
```
TfsAdmin ProjectServer /GetMappedCollections /tfs:tfsUrl
```
Replace tfsUrl with the URL of the application-tier server.

The following message appears:

The following collections are mapped: tpcUrl to Project Web Access pwaUrl.

Back to top

Associate an Enterprise Project Plan with a Team Project

You can map an enterprise project plan to a team project that contains data that you want to synchronize. As the following illustration shows, you can associate multiple enterprise projects with the same team project.

Associate enterprise projects with a team project

To map an enterprise project plan to a team project

At a command prompt, type the following command, and then press ENTER:
```
TfsAdmin ProjectServer /MapPlanToTeamProject /collection:tpcUrl /enterpriseProject:EnterpriseProjectName /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes /nofixedwork /projectFieldForWorkItemType:ProjectFieldName
```
Replace tpcUrl with the URL of the team project collection, EnterpriseProjectName with the name of the enterprise project plan, and TeamProjectName with the name of the team project. Replace ListOfWorkItemTypes with the names of the types of work items that you want to participate in data synchronization. Specify /noFixedWork if you want to prevent fixed-task-type assignments. You can also specify the /projectFieldForWorkItemType argument and the name of a field in Project to store the type of work item.

The following messages appear:

Mapping enterprise project EnterpriseProjectName to team project TeamProjectName.

You have successfully mapped enterprise project EnterpriseProjectName to team project TeamProjectName.
Repeat step 1 for each enterprise project plan that you want to associate with a team project.

Back to top

Remove the Association Between an Enterprise Project Plan and a Team Project

Before you can remove the association between an enterprise project plan and a team project, you must first delete all tasks that are linked to work items in the mapped team project.

To unmap an enterprise project plan from a team project

At a command prompt, type the following command, and then press ENTER.
```
TfsAdmin ProjectServer /UnmapPlanFromTeamProject/collection:tpcUrl /enterpriseProject:EnterpriseProjectName /teamProject:TeamProjectName
```
Replace tpcUrl with the URL of the team project collection, EnterpriseProjectName with the name of the enterprise project plan, and TeamProjectName with the name of the team project.

The following messages appear:

Unmapping enterprise project EnterpriseProjectName from team project TeamProjectName.

Enterprise project EnterpriseProjectName was successfully unmapped from team project TeamProjectName.

Add Resources in Team Foundation Server to the Resource Pool for Project Server

To assign users in Team Foundation as resources in Project, you must add them to the enterprise resource pool and to the resource pool for the enterprise project plan. To make this process easier, you can configure PWA to automatically synchronize the security groups with groups of the same name in Active Directory. Also, you can synchronize users and resources in Project Server with users in Active Directory across multiple domains and forests.

Important

Each time that you add team members to the resources for a project plan, you must publish the project plan so that the synchronization engine will register the changes.

For information about how to add users to the enterprise resource pool, see the following pages on the Microsoft website:

In addition, you must grant users in Team Foundation access to log on to Project Server. For more information, see Assigning Permissions to Support Integration of Project Server and Team Foundation Server.

Change History

Date	History	Reason
September 2011	Clarified the need to publish the project plan after you add team members to the resources for the project plan.	Information enhancement.

September 2011

Clarified the need to publish the project plan after you add team members to the resources for the project plan.

Information enhancement.