Mapping record types to work item types

The sample mapping file that the Rational® ClearQuest® Import Wizard generates is based on the ClearQuest Defect record type as defined in the DefectTracking schema. You can edit the mapping file to specify other ClearQuest record types.

Before you begin

You must include the ClearQuest record_type field in the query that you specify in the ClearQuest Import Wizard.


  1. Open the mapping file in an XML editor.
  2. Find the work item type IDs.
    1. Start the IBM® Engineering Workflow Management (EWM) client for Eclipse IDE.
    2. In the Team Artifacts view, open the project area.
    3. Click the Process Configuration tab.
    4. Select Project Configuration > Configuration Data > Work Items > Types and Attributes.
    5. In the Work Item Types pane, select a work item type. Note the work item type ID in the ID field. For example:
      Screen capture of Types and Attributes page. In the Work Item Types pane, the Story type is selected. The ID field shows
  3. In the section of the mapping file that maps the ClearQuest record type field to the work item type attribute, use the sourceID parameter to specify the ClearQuest record type, and use the targetID parameter to specify the corresponding work item type ID. For example:
    <attribute sourceId="record_type" targetId="">            
              <value sourceId="Defect" targetId="defect"/>
              <value sourceId="Story" targetId=""/>   
              <value sourceId="Plan_Item" targetId=""/>   

What to do next

Continue customizing the mapping file as necessary. See Customizing the mapping file.

video icon Video channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community forums library

support icon Support

IBM Support Community
Deployment wiki