Add a repository mapping

You configure a repository mapping to specify how the connector synchronizes TeamForge with the other participant in the integration. For this connector, you map TeamForge projects with ScrumWorks Pro products.

1. To add a repository mapping, right-click the ScrumWorks Pro connector site and select Map Projects.

   The mapping wizard is launched. The wizard lets you select the ScrumWorks Pro and TeamForge projects you want to synchronize and will setup the necessary TeamForge trackers for you.

2. In the ScrumWorks Product dialog, select the name of the ScrumWorks product to be mapped. To add existing users of the selected ScrumWorks product to TeamForge, select the Create ScrumWorks product users in TeamForge option. Click Next.
   
3. In the TeamForge Project dialog, select the TeamForge project to be mapped to the ScrumWorks product. Click Next.
   
4. In the TeamForge PBI Tracker dialog, select the TeamForge tracker to be mapped to ScrumWorks Product Backlog Items. By default, ScrumWorks Product Backlog Items map to a tracker using the same term in TeamForge, but it is possible to overwrite it.
   
   Click Next.
5. In the TeamForge Tasks Tracker screen, select the TeamForge tracker to be mapped to ScrumWorks Tasks. By default, ScrumWorks Tasks map to a tracker using the same term in TeamForge, but it is possible to overwrite it.
   • We recommend that you leave the option Map ScrumWorks Pro Point Person to TeamForge Assigned To User unchecked. This will map the Point Person for Tasks in ScrumWorks Pro to the "Point Person" text field in TeamForge. This is the safest setting for all but the most expert users who have prepared their integrations to expressly avoid the pitfalls described below.
   • Because the "Point person" field in ScrumWorks uses only ScrumWorks system usernames, whereas the "Assigned To" field in TeamForge uses only TeamForge system usernames, this setting will only work if your TeamForge and ScrumWorks user accounts for the project/product in question are exactly the same, character-for-character.
     CAUTION:

     Select this option only if you are absolutely certain that all user accounts are identical between TeamForge and ScrumWorks, and moreover, that no artifacts being synchronized are assigned to users other than those whose account usernames are identical in both programs. Neglecting to ensure these conditions will result in inconsistent synchronization failures whose cause may be difficult to trace.

     CAUTION:

     If the ScrumWorks Product you selected earlier in this task was the "Sample Product", DO NOT select the checkbox here for Map ScrumWorks Pro Point Person to TeamForge Assigned To User. The Sample Product contains historical Tasks assigned to users that are no longer in the system, and their absence in TeamForge will result in the failed synchronization warned of above.

   Click Next.

   
6. In the Conflict Resolution screen, the default settings are recommended -- however, you may individually select the conflict resolution method for each project mapping
   
7. Click Finish.

The specified mappings are created and appear in the Site Explorer. Here's an example: