Set up project mappings

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 bidirectional scenario example, select Create mappings for both directions.
  3. 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 folder feature.
    If your integration involves Project Tracker, you can map Quality Center defects to Project Tracker artifacts.
  4. 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
  5. Click Next.

    Project mapping screen
  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.