Die Zuordnung von Testartefakten wird mithilfe einer XML-Datei mit dem Namen migration.cfg gesteuert. In Rational ClearQuest 7.0.1 wird diese Datei in der Regel im folgenden Verzeichnispfad installiert:
CQ-Installationsverzeichnis.Rational\ClearQuest\rcp_configuration_701\eclipse\plugins
\com.ibm.rational.clearquest.testmanagement.rqmexport_Datumsmarke\data
In Rational ClearQuest 7.1 und neueren Versionen wird diese Datei in der Regel im Ausgangsverzeichnis des Benutzers installiert:
Benutzerausgangsverzeichnis\.Rational\ClearQuest\rcp_configuration_71\eclipse\plugins
\com.ibm.rational.clearquest.testmanagement.rqmexport_Datumsmarke\data
Bei einem Computer, auf dem Windows XP mit Rational ClearQuest 7.1 ausgeführt wird, könnte der Pfad wie folgt lauten:
C:\Dokumente und Einstellungen\meinName\.Rational\ClearQuest\rcp_configuration_71\eclipse\plugins
\com.ibm.rational.clearquest.testmanagement.rqmexport_2.0.0.v20091119_1542\data
In der Datei migration.cfg sind die Zuordnungen für ein bestimmtes Artefakt innerhalb der <field_mapping>-Tags enthalten, während die einzelnen Zuordnungen für jedes Feld innerhalb des Artefakts in den <mapping>-Tags definiert sind. Die beiden folgenden XML-Codezeilen geben z. B. an, dass das Artefakt TMTestCase in Rational ClearQuest Test Manager dem Artefakt TestCase in Rational Quality Manager und das Feld Headline innerhalb von TMTestCase dem Feld title innerhalb von TestCase zugeordnet wird.
<field_mapping type="TMTestCase" target="TestCase" task="Test Cases">
<mapping from="Headline" to="dc:title"/>
Zum Aktualisieren einer Feldzuordnung ändern Sie die bestehende Zuordnung mithilfe der entsprechenden Einstellung für das Attribut from oder to. Zum Hinzufügen einer neuen Zuordnung duplizieren Sie eine vorhandene Zuordnung und aktualisieren diese entsprechend. Nachdem Sie die Feldzuordnung angepasst haben, führen Sie den Migrationsassistenten erneut aus, damit die aktualisierte Zuordnungsdatei verwendet wird.
Die Standardzuordnungen für einen Testfall in der Datei migration.cfg sind nachfolgend aufgeführt.<?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="Notes"" pre="true"/>
<mapping from="LegacyAcceptanceCriteria" to="myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria extensionDisplayName="Acceptance Criteria"" pre="true"/>
<mapping from="LegacyPreConditions" to="myns:com.ibm.rqm.planning.editor.section.testCasePreCondition extensionDisplayName="Precondition"" pre="true"/>
<mapping from="LegacyPostConditions" to="myns:com.ibm.rqm.planning.editor.section.testCasePostCondition extensionDisplayName="Postcondition"" 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"/>
<!-- TM "properties" RAProject and Requirements_List are placeholders and can not be renamed -->
<!-- <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="Notes"" pre="true"/>
<mapping from="custom2" to="LegacyCustom2"/>
<mapping from="custom3" to="LegacyCustom3"/>
</field_mapping>
In der folgenden Tabelle sind einige zusätzliche Anweisungen beschrieben, die in eine Zuordnung aufgenommen werden können.
| Anweisung | Beschreibung |
|---|---|
| pre="true" | Vorformatiert. Bricht die Daten um, sodass sie nicht neu formatiert werden. |
| file=”true” | Gibt an, dass das Feld auf eine externe Datei in Rational ClearQuest Test Manager verweist. |
| scripttype | Wird nur für zugeordnete Scripts verwendet. |
Dieses Beispiel zeigt den einfachen Fall, in dem ein benutzerdefiniertes Feld in Rational ClearQuest Test Manager einem bestehenden Feld in Rational Quality Manager zugeordnet wird.
<mapping from="InternalName" to="dc:title"/>
In diesem Beispiel wird ein benutzerdefiniertes Feld mit dem Namen InternalName dem Feld title in Rational Quality Manager zugeordnet.
Dieses Beispiel zeigt, wie ein Feld in einem referenzierten Artefakt einem Feld in Rational Quality Manager zugeordnet wird.
<mapping from="ParentPlan.Headline" to="dc:description"/>
In diesem Beispiel wird das Feld Headline im Artefakt ParentPlan dem Feld description in Rational Quality Manager zugeordnet.
Dieses Beispiel zeigt, wie ein benutzerdefiniertes Feld in Rational ClearQuest Test Manager einem benutzerdefinierten Abschnitt in Rational Quality Manager zugeordnet wird.
<mapping from="InternalName" to="myns:InternalName extensionDisplayName="Internal Name"">
In diesem Beispiel verweist die Zuordnung immer noch auf das benutzerdefinierte Feld InternalName in Rational ClearQuest Test Manager, doch wird es jetzt einem benutzerdefinierten Abschnitt in Rational Quality Manager zugeordnet, der ebenfalls den Namen InternalName aufweist.
Bei dem Namen des benutzerdefinierten Abschnitts in Rational Quality Manager kann es sich um jeden beliebigen Namen ohne Leerzeichen handeln und ihm muss die Zeichenfolge myns: vorangestellt sein.
Der letzte Teil in diesem Beispiel (extensionDisplayName="Internal Name"") gibt an, wie der Abschnittsname in Rational Quality Manager angezeigt wird.
In diesem Fall wird der Name des benutzerdefinierten Abschnitts InternalName in der Form Internal Name angezeigt. Internal Name muss in Anführungszeichen gesetzt werden, doch da er in eine XML-Datei eingefügt werden soll, müssen die Anführungszeichen durch die entsprechenden Escape-Zeichen ersetzt werden, also ".
Dieses Beispiel zeigt, wie Werte in Rational ClearQuest Test Manager durch Werte in Rational Quality Manager ersetzt werden.
<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>
In diesem Beispiel beginnt das aufgezählte Tag mit dem Schlüsselwort enum_mapping. Das Attribut name gibt das Feld in Rational ClearQuest Test Manager an, dessen Werte ersetzt werden. In der ersten Zeile wird das Attribut pass durch com.ibm.rqm.execution.common.state.passed in Rational Quality Manager ersetzt. Wenn Sie jedoch alle Testergebisse ohne Ergebnis anzeigen möchten, die in Rational Quality Manager Fehlern zugeordnet sind, ändern Sie diese Zeile in <mapping from="inconclusive" to="com.ibm.rqm.execution.common.state.failed"/>.
Sie können Felder und die zugehörigen Werte in Rational ClearQuest Test Manager Kategorien und Werten in Rational Quality Manager zuordnen. Wenn die Kategorie nicht vorhanden ist, wird sie erstellt.
<attribute from="State" to="category term="Test" " value="value"/>
In diesem Beispiel werden das Feld State und die zugehörigen Werte einer Kategorie namens Test zugeordnet. Die Werte im Feld State werden ebenfalls migriert.