Mapping state and resolution values

Each Rational® ClearQuest® record type and Jazz work item type has a workflow, which consists of state and resolution values. In the mapping file, you must map the state and resolution values between the ClearQuest record type and the corresponding work item type.


  1. Open the mapping file in an XML editor.
  2. Find the workflow name for the work item type:
    1. Open 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. The workflow name is in the Workflow field.
      Screen capture of Story work item type page with User StoryWorkflow shown in Workflow field.
  3. Find the state IDs for the states defined in the workflow:
    1. Click the Process Configuration Source tab.
    2. Search for the workflow name that you found in Step 2.
    3. Find the state names and note the corresponding state IDs.
  4. In the state attribute mapping section of the mapping file, use the sourceID parameter to specify the ClearQuest record type state. Use the targetID parameter to specify the corresponding work item type state. For historical reasons, state IDs of the form snumber, such as s1, and resolution IDs of the form rnumber must be added to the mapping file without their respective s and r prefixes. For example:
    <attribute sourceId="State" targetId="">
            <value sourceId="Submitted" targetId=""/>
            <value sourceId="Opened" targetId="2"/>
            <value sourceId="Resolved" targetId=""/>    
  5. Repeat the above steps to specify the resolution value mappings.

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