Initial integration configuration (Should know)
These are the minimal steps you'll need to perform in order to complete the initial configuration of Team Foundation Server and Project Server. You may need more steps depending on specific site requirements. Please complete them in the order listed for predictable results.
Getting ready
In order to run the TfsAdmin
command-line tool indicated in some of these steps, you will need to run it in an elevated command prompt (right-click on the command prompt in the Start menu and select Run as administrator).
How to do it...
We'll lay the steps out here by subject to make it easy to follow and refer back to later.
Integration
You'll also need to change the directory to C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE
, or add it to your path. Open the Command Prompt console from the Start menu. Using the following steps you can perform integration:
Register an instance of PWA. Each instance must be registered.
Tool used:
TfsAdmin
Open the Command Prompt console from the Start menu.
Run the following command:
TfsAdmin ProjectServer /RegisterPWA /pwa:<pwaUrl> /tfs:<tfsUrl>
Replace the
<>
brackets with the URL, as shown in the following code:TfsAdmin ProjectServer /RegisterPWA /pwa:http://tfspsdemo/PWA /tfs:http://tfspsdemo:8080/tfs/
Map the PWA instance with a team project collection.
Tool used:
TfsAdmin
Open the command prompt from the Start menu.
Run the following command (without the <> brackets):
TfsAdmin ProjectServer /MapPWAtoCollection /pwa:<pwaUrl> /collection:<tpcUrl>
Replace the
<>
brackets with the URL, as shown in the following code:TfsAdmin ProjectServer /MapPWAToCollection /pwa:http://tfspsdemo/PWA /collection:http://tfspsdemo:8080/tfs/DefaultCollection
Note
Map each instance of PWA that supports an enterprise project plan.
Upload default field mappings.
Tool used:
TfsAdmin
Open the command prompt from the Start menu.
Run the following command (without the <> brackets):
TfsAdmin ProjectServer /UploadFieldMappings /collection:<tpcUrl> /useDefaultFieldMappings
Replace the
<>
brackets with the URL, as shown in the following code:TfsAdmin ProjectServer /UploadFieldMappings /collection:http://tfspsdemo:8080/tfs/DefaultCollection /useDefaultFieldMappings
Note
We must define the field mappings for each project collection that we have mapped to an instance of PWA. You can use the default field mappings to begin with and customize if you need to (many organizations use this right out of the box).
Associate an enterprise project plan with a team project.
Tool used:
TfsAdmin
Open Command Prompt from the Start menu.
Run the following command (without the
<>
brackets):TfsAdmin ProjectServer /MapPlanToTeamProject /collection:tpcUrl /enterpriseproject:<ProjectServerPlanName> /teamproject:<TfsProjectName> /workitemtypes:<ListOfTypes>
Replace the
<>
brackets with the URL, as shown in the following code:TfsAdmin ProjectServer /MapPlanToTeamProject /collection:http://tfspsdemo:8080/tfs/DefaultCollection/ enterpriseproject:MyEnterpriseProject /teamproject:MyTfsTeamProject /workitemtypes:"User Story,Task"
Note
Do not include a space after the comma for the
workitemtypes
parameter. If you mapped a plan while it was open, re-open it to register the changes. Look for the Publish to Team Project and Work Item Type columns to indicate that the mapping has been completed.The
/nofixedwork
flag is optional. Use this only if you want the Project Server tasks that are mapped to the work items in Team Foundation Server to not be assigned to the Fixed Work task type.Add team members to the enterprise resource pool.
Tool used:
Project Web App
On each task that is published to the team project, you need to assign a valid member of the team project as a resource. You also need to identify any team member who submits work items that are synchronized with Project Server. To identify valid contributors, you must add team members from the enterprise resource pool to the resources for the enterprise project plan.
Note
Please refer to the detailed instructions at the location Add Team Foundation members to the Team Members group in the recipe Managing Project Server. Also, please refer to details on this function at http://office.microsoft.com/en-us/project-help/add-resources-to-the-enterprise-resource-pool-HA010377760.aspx.
Verify the synchronization.
The last step in setting up the initial integration is to verify the synchronization. Please refer to Verifying Synchronization in the recipe Managing Project Server.