Customizing the migration of Rational TestManager assets

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

The default mapping of Rational TestManager tests assets to Rational Quality Manager record fields is controlled via XML schema files named (RQMMigration_<asset Type>.xml). There is one file for each asset 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 utilize 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 asset. Generally, *** represents the name of a property of an asset 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>

Feedback