Manage the Association of Enterprise Projects to Team Projects

  • Article

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 Visual Studio Team Foundation Server 2012 and Microsoft Project Server. For more information, see Configure 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 Assign 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

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

    cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

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

  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 Team Foundation Server.

Back to top

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.

    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

  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.

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

    Enterprise projectEnterpriseProjectNamewas successfully unmapped from team projectTeamProjectName.

Back to top

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.

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 Assign Permissions to Support Integration of Project Server and Team Foundation Server.

Back to top

See Also

Tasks

Configure the Integration of Team Foundation Server and Project Server

Reference

Manage Mappings Between an Enterprise Project and a Team Project

Concepts

Administrate the Integration of Team Foundation Server and Project Server