Mapping attributes

Within the mapping file, customize the attribute mapping section to map the fields of the IBM® Rational® ClearQuest® record type to the corresponding fields of the IBM Engineering Workflow Management (EWM) work item type.

Before you begin

You must generate the sample mapping file from the ClearQuest Import Wizard by specifying a query that selects the ClearQuest records for which you want to create work items.

About this task

You can map the following work item attributes:
  • com.ibm.team.workitem.attribute.category
  • com.ibm.team.workitem.attribute.creationdate
  • com.ibm.team.workitem.attribute.creator
  • com.ibm.team.workitem.attribute.description
  • com.ibm.team.workitem.attribute.owner
  • com.ibm.team.workitem.attribute.priority
  • com.ibm.team.workitem.attribute.resolution
  • com.ibm.team.workitem.attribute.resolutiondate
  • com.ibm.team.workitem.attribute.severity
  • com.ibm.team.workitem.attribute.state
  • com.ibm.team.workitem.attribute.summary
  • com.ibm.team.workitem.attribute.target
  • com.ibm.team.workitem.attribute.tags
  • com.ibm.team.workitem.attribute.workitemtype
  • com.ibm.team.workitem.attribute.version
  • com.ibm.team.workitem.rcp.core.blocks
  • com.ibm.team.workitem.rcp.core.dependson
  • com.ibm.team.workitem.rcp.core.duplicates
  • com.ibm.team.workitem.rcp.core.is_dup_of
  • com.ibm.team.workitem.rcp.core.parent
  • com.ibm.team.workitem.rcp.core.children
  • com.ibm.team.workitem.rcp.core.related

For fields that contain time values, the ClearQuest Import Wizard supports both the 24-hour format (HH:mm) and am/pm (HH:mm a) format. For example, both 13:36 and 1:36 pm are acceptable. The table below lists the supported date formats.

Table 1. Date formats supported by ClearQuest Import Wizard
Date format Example
M/dd/yyyy 9/13/2009
M/dd/yy 9/13/09
MMM d, yyyy Sep 13, 2009
MMMM d, yyyy September 13, 2009
dd MMMM yyyy 13 September 2009
dd-MMM-yy 13-Sep-09
yyyy-M-dd 2009-09-13
dd/mm/yyyy 13/09/2009
dd.mm.yyyy 13.09.2009

Procedure

  1. Open the sample mapping file in an XML editor.
  2. Edit the attribute mapping section so that the fields of the ClearQuest record type map to the appropriate fields of the work item type. Use sourceID to identify the ClearQuest field. Use targetID to identify the work item field (attribute ID). For example:
    <attribute sourceId="Priority" targetId="com.ibm.team.workitem.attribute.priority" />

What to do next

For work item attributes that belong to an attribute type, you must specify the attribute type. See Specifying attribute types.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki