Customizing the migration of Rational TestManager artifacts

If the default mapping of Rational® TestManager artifacts to Rational Quality Manager record fields is insufficient, you can modify the mapping to suit your needs.

The default mapping of Rational TestManager tests artifacts to Rational Quality Manager record fields is controlled via XML schema files named (RQMMigration_<artifact Type>.xml). There is one file for each artifact type, for example, RQMmigration_TestPlan.xml for test plan migration.

To add a new mapping, duplicate an existing mapping file and update as appropriate.

After adjusting the field mapping, rerun the migration wizard to use the updated mapping file.

The default mapping for a test plan is shown below.

<?xml version="1.0" encoding="utf-8"?>
<testplan xmlns="http://jazz.net/xmlns/alm/qm/v0.1/"
 xmlns:jzalm="http://jazz.net/xmlns/alm/v0.1/"
 xmlns:dc="http://purl.org/dc/elements/1.1/"
 xmlns:rtm="http://schema.ibm.com/rational/tm/v7.0.2/">

 <dc:identifier><![CDATA[UID]]&gt;</dc:identifier>
 <dc:title><![CDATA[Name]]&gt;</dc:title>
 <dc:description><![CDATA[Description]]&gt;</dc:description>
 <dc:creator><![CDATA[CreatedBy]]&gt;</dc:creator>
 <jzalm:owner><![CDATA[Owner]]&gt;</jzalm:owner>
 <jzalm:state>Completed</jzalm:state>

 <rtm:Custom1  extensionDisplayName="Custom 1">
  <![CDATA[Custom1]]&gt;
 </rtm:Custom1>
 <rtm:Custom2  extensionDisplayName="Custom 2">
  <![CDATA[Custom2]]&gt;
 </rtm:Custom2>
 <rtm:Custom3 extensionDisplayName="Custom 3">
  <![CDATA[Custom3]]&gt;
 </rtm:Custom3>
</testplan>

For example, dc:description is a target property of a Quality Manager test plan and it maps to the Description property of a TestManager testplan as shown below:

<dc:description><![CDATA[Description]]&gt;/dc:description>

Any Data node such as ><![CDATA[***]]&gt; represents a placeholder for replacing an actual value from a TestManager test artifact. Generally, *** represents the name of a property of an artifact in TestManager.

Any invalid property name causes a blank value to be migrated.

If you want to set the test plan description in Quality Manager to be the testplan owner in TestManager, change the example above as follows:

<dc:description><![CDATA[Owner]]&gt;</dc:description>

If you want to set a fixed value for a specific property in Quality Manager, specify the data node as a simple text node as shown below:

<dc:description>My Description</dc:description>
You can also use the configuration.ini file to customize the names of the new category types for the migrated test case and test case log folder structures:
# Configuration file for RTM Migration
[CategoryType]
# This section include mapping of category type name
# Predefined category type for test cases are "RTM_TestCases" (for root/ parent test case folder),
# "RTM_Level_1" (for 1st child) , "RTM_Level_2" (for 2nd child) and so on
# To change the category type name, change the value in right hand side


RTM_TestCases = RTM_TestCases
RTM_Level_1 = RTM_Level_1
RTM_Level_2 = RTM_Level_2
RTM_Level_3 = RTM_Level_3
RTM_Level_4 = RTM_Level_4
RTM_Level_5 = RTM_Level_5
RTM_Level_6 = RTM_Level_6

# Predefined category type for execution result are "BuildFolder" and "LogFolder"
BuildFolder = BuildFolder 
LogFolder = LogFolder


Have a problem or a question? Post it in the Jazz.net forum.