How to: Specify the Field Value Mapping

The ClearQuest converter uses the field mapping files to map fields in each ClearQuest entity to an equivalent Team Foundation work item tracking work item field. The converter creates a field mapping file for each ClearQuest entity during analysis.

To edit the field mapping file

1. Open one of the field mapping files. For example, open DefectFieldMap.xml. A sample is provided.

   <FieldMap from="Criticality" to="Severity">
     <ValueMaps>
           <ValueMap from="1-Critical" to = "1"/>
           <ValueMap from="2-Major" to = "2"/>
     </ValueMaps>
   </FieldMap>
   

2. Review the field mapping lines (starting with ValueMap), and ensure that the field indicated after "from" is mapped to the correct field after "to." You can add more field mappings by adding more ValueMap lines. The values should be in the list of the allowed values if this has been specified in the schema file, in this case, defect.xml.

   Note

   If you change the field mappings, ensure that you make corresponding changes in the work item type files. For example, if you change a field name in field mapping file, you must ensure that the field is present in the work item type file.

3. Open the other field mapping files and edit them as appropriate.

See Also

Tasks

Walkthrough: Migrating ClearQuest Work Items to Team Foundation

Concepts

Work Items and Work Item Types Overview

Reference

Field Map File Schema

Other Resources

Work Item Type Definition Schema