Personnalisation de la migration d'artefacts Rational ClearQuest Test Manager

Si le mappage par défaut des zones d'enregistrement Rational ClearQuest Test Manager aux zones d'enregistrement Rational Quality Manager est insuffisant, vous pouvez le modifier et l'adapter à vos besoins.

Fichier de mappages de migration - migration.cfg

Le mappage des artefacts de test est contrôlé par un fichier XML nommé migration.cfg. Dans Rational ClearQuest 7.0.1, ce fichier est généralement installé dans le dossier suivant :

CQInstallDir.Rational\ClearQuest\rcp_configuration_701\eclipse\plugins
\com.ibm.rational.clearquest.testmanagement.rqmexport_datestamp\data

Dans Rational ClearQuest 7.1 et les versions ultérieures, ce fichier est généralement installé dans le répertoire de l'utilisateur :

RépUtilisateur\.Rational\ClearQuest\rcp_configuration_71\eclipse\plugins
\com.ibm.rational.clearquest.testmanagement.rqmexport_datestamp\data

Par exemple, sur un ordinateur fonctionnant sous Windows XP et exécutant Rational ClearQuest 7.1, l'emplacement peut être le suivant :

C:\Documents and Settings\nom\.Rational\ClearQuest\rcp_configuration_71\eclipse\plugins
\com.ibm.rational.clearquest.testmanagement.rqmexport_2.0.0.v20091119_1542\data

Dans le fichier migration.cfg, les mappages d'un artefact sont entourés de balises <field _mapping>. Les mappages individuels de chaque zone d'artefact sont quant à eux entourés de balises <mapping>. Par exemple, les deux lignes de code XML ci-après indiquent que l'artefact TMTestCase de Rational ClearQuest Test Manager doit être mappé à l'artefact TestCase de Rational Quality Manager et que la zone Headline de TMTestCase doit être mappée à la zone title de TestCase.

<field_mapping type="TMTestCase" target="TestCase" task="Test Cases">
<mapping from="Headline" to="dc:title"/> 

Pour mettre à jour un mappage de zone, modifiez le mappage existant en redéfinissant la valeur des attributs from ou to. Pour ajouter un mappage, dupliquez un mappage existant et modifiez-le selon vos besoins. Une fois le mappage de zone modifié, réexécutez l'assistant de migration afin de prendre en compte les modifications.

Le code ci-dessous illustre les mappages par défaut d'un scénario de test dans le fichier migration.cfg.
<?xml version="1.0" encoding="UTF-8"?>

<config>

<!-- TEST CASE -->

<field_mapping type="TMTestCase" target="TestCase" task="Test Cases">
<mapping from="Headline" to="dc:title"/> 
<mapping from="Description" to="dc:description"/>
<mapping from="owner.login_name" to="jzalm:owner"/>
<mapping from="State" to="jzalm:state"/>
<mapping from="Notes_Log" to="myns:com.ibm.rqm.planning.editor.section.testCaseNotes extensionDisplayName=&quot;Notes&quot;" pre="true"/>
<mapping from="LegacyAcceptanceCriteria" to="myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria extensionDisplayName=&quot;Acceptance Criteria&quot;" pre="true"/>
<mapping from="LegacyPreConditions" to="myns:com.ibm.rqm.planning.editor.section.testCasePreCondition extensionDisplayName=&quot;Precondition&quot;" pre="true"/>
<mapping from="LegacyPostConditions" to="myns:com.ibm.rqm.planning.editor.section.testCasePostCondition extensionDisplayName=&quot;Postcondition&quot;" pre="true"/>
<mapping from="LegacyCustom1" to="myns:LegacyCustomField" pre="true"/>
<mapping from="LegacyInputs" to="myns:LegacyInputData" pre="true"/>
<mapping from="LegacyPassPoints" to="myns:LegacyPassPoints" pre="true"/>
<mapping from="LegacyFailPoints" to="myns:LegacyFailPoints" pre="true"/>
<mapping from="LegacyDesign" to="myns:LegacyDesign" pre="true"/>
<mapping from="History" to="myns:History" pre="true"/>
<mapping from="DefaultScript" to="testscript" scripttype="DefaultScriptType"/>
<mapping from="ExternalMotivators" to="attachment" file="true"/>
<mapping from="LegacyTotalPoints" to="weight"/>
<mapping from="ConfiguredTestCases.Script" to="testscript" scripttype="ConfiguredTestCases.TestType"/>

<!-- Les "propriétés" TM RAProject et Requirements_List sont des espaces réservés et ne peuvent pas être renommées-->
<!-- <mapping from="RAProject" to="RAProject"/> -->
<mapping from="Requirements_List" to="requirement"/>
<mapping from="Notes_Log" to="myns:com.ibm.rqm.planning.editor.section.testCaseNotes extensionDisplayName=&quot;Notes&quot;" pre="true"/>
<mapping from="custom2" to="LegacyCustom2"/>
<mapping from="custom3" to="LegacyCustom3"/>
</field_mapping>

Le tableau ci-dessous décrit certaines informations supplémentaires susceptibles d'être incluses aux mappages.

Tableau 1.
Information Description
pre="true" Pré-formatage. Entoure les données de manière à empêcher tout reformatage.
file=”true” Indique que la zone fait référence à un fichier externe de Rational ClearQuest Test Manager.
scripttype Utilisé uniquement pour les scripts associés.

Exemple 1 - Mappage d'une zone définie par l'utilisateur

Cet exemple illustre le cas le plus simple où une zone Rational ClearQuest Test Manager définie par l'utilisateur est mappée à une zone existante de Rational Quality Manager.

<mapping from="InternalName" to="dc:title"/>

Dans cet exemple, la zone définie par l'utilisateur InternalName est mappée à la zone title de Rational Quality Manager.

Exemple 2 - Référence à une zone à partir d'un artefact référencé

Cet exemple illustre la manière dont une zone d'un artefact référencé est mappée à une zone Rational Quality Manager.

<mapping from="ParentPlan.Headline" to="dc:description"/>

Dans cet exemple, la zone Headine de l'artefact ParentPlan est mappée à la zone description de Rational Quality Manager.

Exemple 3 - Mappage d'une zone définie par l'utilisateur à une section définie par l'utilisateur

Cet exemple illustre la manière dont une zone Rational ClearQuest Test Manager définie par l'utilisateur est mappée à une zone définie par l'utilisateur dans Rational Quality Manager.

<mapping from="InternalName" to="myns:InternalName extensionDisplayName=&quot;Internal Name&quot;">

Dans cet exemple, la référence à la zone personnalisée InternalName de Rational ClearQuest Test Manager est conservée, mais le mappage renvoie à une section définie par l'utilisateur dans Rational Quality Manager, également appelée InternalName.

Le choix du nom de la section définie par l'utilisateur dans Rational Quality Manager est libre dans la mesure où il ne contient pas d'espace et où il est précédé par myns:.

La dernière partie de cet exemple (extensionDisplayName=&quot;Internal Name&quot;") indique la manière dont s'affiche le nom de section dans Rational Quality Manager.

En l'occurrence, le nom de section définie par l'utilisateur, InternalName, s'affichera sous la forme Internal Name. Internal Name doit être placé entre guillemets. Toutefois, le code étant rédigé dans un fichier XML, les guillemets doivent être remplacés par la séquence d'échappement &quot;.

Exemple 4 - Remplacement des valeurs dans Rational ClearQuest Test Manager

Cet exemple illustre le remplacement des valeurs Rational ClearQuest Test Manager par des valeurs Rational Quality Manager.

<enum_mapping name="jzalm:state">
<mapping from="pass" to="com.ibm.rqm.execution.common.state.passed"/>
<mapping from="fail" to="com.ibm.rqm.execution.common.state.failed"/>
<mapping from="inconclusive" to="com.ibm.rqm.execution.common.state.inconclusive"/>
<mapping from="error" to="com.ibm.rqm.execution.common.state.inconclusive"/>
<mapping from="Draft" to="com.ibm.rqm.planning.common.new"/>
<mapping from="Approved" to="com.ibm.rqm.planning.common.approved"/>
<mapping from="ForReview" to="com.ibm.rqm.planning.common.underreview"/>
<mapping from="Blocked" to="com.ibm.rqm.planning.common.new"/>
<mapping from="Implemented" to="com.ibm.rqm.planning.common.new"/>
</enum_mapping>

Dans cet exemple, la balise d'énumération débute par le mot clé enum_mapping et l'attribut name spécifie la zone Rational ClearQuest Test Manager dont les valeurs doivent être remplacées. A la première ligne, l'attribut pass doit être remplacé par com.ibm.rqm.execution.common.state.passed dans Rational Quality Manager. En revanche pour mapper tous les résultats de test ayant échoué aux échecs dans Rational Quality Manager, vous devez redéfinir cette ligne sur <mapping from="inconclusive" to="com.ibm.rqm.execution.common.state.failed"/>.

Exemple 5 - Définitions de catégories dans le fichier migration.cfg

vous pouvez mapper les zones et les valeurs correspondantes dans Rational ClearQuest Test Manager vers des catégories et des valeurs de Rational Quality Manager. Si la catégorie n'existe pas, elle est créée automatiquement.

<attribute from="State" to="category term=&quot;Test&quot; " value="value"/>          

Dans cet exemple, la zone State et les valeurs correspondantes seront mappées à une catégorie nommée Test. Les valeurs de la zone State sont également migrées.



Vous avez un problème ou une question ? Parlez-en sur le forum Jazz.net.