Manage the association of enterprise projects to team projects

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.

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 TFS resources to the resource pool for Project Server

Requirements

Before you can map an enterprise project plan to a team project, you must have configured the integration of Visual Studio Team Foundation Server and Microsoft Project Server. After you have performed the initial configuration, you can map and unmap plans to team projects as needed.

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 Assign permissions to support TFS-Project Server integration.

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

1. Open a Command Prompt window where either Visual Studio or Team Explorer is installed and enter:

   cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
   

   On a 32-bit edition of Windows, replace %programfiles(x86)% with %programfiles.

2. Type the following command, and then choose the ENTER key.

   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 Register an instance of PWA to TFS.

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 choose the ENTER key:

  TfsAdmin ProjectServer /GetMappedCollections /tfs:tfsUrl
  

  Replace tfsUrl with the URL of the application-tier server.

  The following message appears:

  The following collections are mapped:tpcUrlto Project Web AccesspwaUrl.

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.

To map an enterprise project plan to a team project

1. At a command prompt, type the following command, and then choose the ENTER key

   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 EnterpriseProjectNameto team projectTeamProjectName.

   You have successfully mapped enterprise projectEnterpriseProjectNameto team projectTeamProjectName.

2. Repeat step 1 for each enterprise project plan that you want to associate with a team project.

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 projectEnterpriseProjectNamefrom team projectTeamProjectName.

  Enterprise projectEnterpriseProjectNamewas successfully unmapped from team projectTeamProjectName.

Add TFS resources 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.

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

• Add resources to the enterprise resource pool

• Manage Enterprise Resource Pool synchronization with Active Directory in Project Server 2010

In addition, you must grant users in Team Foundation access to log on to Project Server. For more information, see Assign permissions to support TFS-Project Server integration.

See Also

Tasks

ConfigureTFS-Project Server integration

Reference

Manage mappings between an enterprise project and a team project

Concepts

Administrate the integration of Team Foundation Server and Project Server