Set up project mappings

Synchronizing a TeamForge project to a ScrumWorks Pro product involves the following project mappings:

1. In the CCF Explorer, right-click your TF-SWP landscape and select Map Projects.... A Map TeamForge and ScrumWorks Projects dialog opens, presenting a progression of specification screens.
   
   
   
2. In the ScrumWorks Product screen, select the name of the ScrumWorks Product to be mapped. To add existing users of the selected ScrumWorks product to TeamForge, check the box for Create ScrumWorks product users in TeamForge. Click Next.
   
   
   

   Click Next.

3. In the TeamForge Project screen, select the name of the TeamForge project to be mapped to the ScrumWorks product specified in the prior step. To create a new project, check the box for “Create new project”. When this option is selected, the box to the right populates with the name of the ScrumWorks product specified in the prior step, but may be overwritten if desired. Click Next.
   
   
   
4. In the TeamForge Trackers screen, select the TeamForge Trackers to be mapped to ScrumWorks Product Backlog Items and Tasks.

   By default, ScrumWorks Product Backlog Items and Tasks map to Trackers using the same terms in TeamForge, but these terms may be overwritten if desired.

   Under the section named "Tracker to be mapped to ScrumWorks Task", note the checkbox for Map ScrumWorks Pro Point Person to TeamForge Assigned To User.

   1. Leave the option for Map ScrumWorks Pro Point Person to TeamForge Assigned To User unchecked. Doing so will map the Point Person for Tasks in ScrumWorks Pro to the "Point Person" text field in TeamForge. This is the safest setting and is recommended for all but the most expert users who have prepared their integrations to expressly avoid the pitfalls described below.
   2. 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 selected to be mapped in step 2 above 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.
   Note: This can be changed in the GUI by selecting the Set task point person mapping option... in the context menu for any mapping or project.

   Click Next.

   
   
   
5. In the Mappings Preview screen, the project mappings are summarized and the conflict resolution method for each is displayed. The default conflict resolution settings are recommended.

   The conflict resolution method for each project mapping may be individually selected. A description field is provided for the TeamForge project being mapped or created.

   
   
   
6. Click Finish.

The mappings specified are created and appear in the CCF Explorer view in the Project Mappings folder.