Multi-project Synchronization

Some TFS projects are used to run more than one actual project.  Teams often use areas or iterations to separate the work for each project.  TeamPulse can synchronize one large TFS project into multiple smaller TeamPulse projects as described below.

The following steps will walk through an example of synchronizing a TFS project with two sub-projects to two different TeamPulse projects.

 

Background

A TFS project named JP-Agile contains two sub projects named Sub-project 1 and Sub-project 2.  These projects are represented by the area paths JP-Agile\Sub-project 1 and JP-Agile\Sub-project 2 respectively.

 

JP-Agile project areasenlarge screenshot

 

Two queries have been created in TFS to return the work items for each project.  They are Team Queries\Sync\Sub-project 1 and Team Queries\Sync\Sub-project 2.  These queries will be used to determine which work items will be synced to which TeamPulse project.

 

Sub-project 1 TFS queryenlarge screenshot     Sub-project 2 TFS queryenlarge screenshot

 

 

 
It is important that the work items returned by each query don’t overlap.  If they do, there is a higher chance that you will run into sync errors or conflicts because the same item will be getting modified in many places.

 

 

Steps

  1. In TeamPulse, create a new project named Sub-project 1.
    • Since the TFS project JP-Agile was created with the MSF for Agile Software Development TFS process template, choose the Agile TeamPulse project template.
  2. Click Create your project now to create the project.
  3. Using the ribbon, go to Project > TFS Sync Information.
  4. Connect the TeamPulse project to the JP-Agile TFS project.
  5. Edit the synchronization mappings and use the TFS query Team Queries\Sync\Sub-project 1 to restrict the work item being synced to this TeamPulse project.
  6. Click Save to complete the configuration for Sub-project 1.
  7. In TeamPulse, create a new project named Sub-project 2, once again choosing the Agile project template.
  8. Using the ribbon, go to Project > TFS Sync Information.
  9. Connect the project to the JP-Agile project.
    • When a TFS project is already connected to a TeamPulse project, a folder icon is displayed beside it.  Hover over it to see the projects it is currently syncing with.
      Multi-project sync folder iconenlarge screenshot
  10. Select the JP-Agile project and click Connect To Server.
  11. When prompted, click Yes to confirm that you want to connect to this project.
  12. Edit the synchronization mappings and use the TFS query Team Queries\Sync\Sub-project 2.
  13. Click Save to complete the configuration for Sub-project 2.
  14. This completes the configuration.  In each project, click the Synchronize Now button to begin synchronizing work items.