Set up project mappings for the Quality Center - TeamForge tracker connector

For your source and target systems, map attributes such as project names, and system and repository IDs.

Project mappings are stored in the SYNCHRONIZATION_STATUS table in the central database. To set up your source and target repositories, you add a row to this table for each direction of synchronization. In earlier versions of the connector, it was recommended that you use a graphical database editing tool or manually append the appropriate INSERT statements to the CCFDB.script file in the <CCF_HOME>\production\centralCCFDatabase folder. You can now set this up using the CCF user interface.

Note: When you create a project mapping, synchronization of artifacts is paused by default. When you finish configuring the connector, you will need to resume synchronization.
  1. In the CCF Explorer, right-click Project Mappings for your landscape and select New > Project Mapping .

    Project mapping screen
  2. In the New Project Mapping window, select the mapping direction. For the Quality Center - TeamForge tracker bidirectional scenario, select Create mappings for both directions.
  3. Specify how potential conflicts should be resolved. You can choose to:
    • Replace the target artifact's values with the source artifact's changes
    • Discard the changes in the source artifact and not update the target artifact
    • Quarantine the conflicting artifact in the hospital
    • Overwrite the target artifact (in Quality Center), ignoring locks.
      Note: This option is available only if the target system is Quality Center. For more information on this feature, see this FAQ topic.
    Tip: If you select Overwrite target artifact for one direction, we suggest you select Do not update target artifact for the other, so that one system will prevail in case of a conflict. However, even if you choose Overwrite target artifact for both directions, it’s extremely unlikely that the connector would pick up changes in both systems at the same instant resulting in a conflict.
  4. Click Next.

    Project mapping screen
  5. Select the components you want to map in Quality Center and TeamForge. The possible mappings are:
    • Quality Center defects to TeamForge Tracker artifacts
    • Quality Center requirements to TeamForge Tracker artifacts
    • Quality Center requirements to TeamForge planning folder artifacts
      Note: You need TeamForge 5.3 or later for the planning folders feature. While it is possible to map Quality Center "folder like" requirement types to TeamForge tracker artifacts, mapping the requirement hierarchy to TeamForge planning folders is a better option. For more information on planning folders and the advantages they offer, click here. You should map only Quality Center requirement types that don't mainly act as "folders" in Quality Center to TeamForge trackers.
  6. Specify the Quality Center domain and project names.
  7. If you chose to map Quality Center requirements, browse to or enter a Requirement type.
  8. Specify a TeamForge component ID.
    • If you chose to map Quality Center requirements to a TeamForge planning folder, browse to a TeamForge project or enter its ID.
    • If you chose to map Quality Center requirements to a TeamForge tracker, browse to the tracker or enter its ID.

    If your integration involves Project Tracker, you will need to specify the CollabNet Enterprise Edition project name and Project Tracker artifact type.

  9. Click Finish.
The system fills in the rest of the values for each mapping.
Tip: When you select a project mapping in the CCF Explorer, its Window > Show View > Properties window displays the values for all fields in the corresponding SYNCHRONIZATION_STATUS table row.