Personalizzazione della migrazione di risorse utente di test di Rational ClearQuest Test Manager

Se l'associazione predefinita dei campi di record di Rational ClearQuest Test Manager ai campi dei record di Rational Quality Manager non è sufficiente, è possibile modificare l'associazione in modo che risponda alle proprie necessità.

File di associazioni di migrazione - migration.cfg

L'associazione di risorse utente di test è controllata mediante un file XML denominato migration.cfg. Su Rational ClearQuest 7.0.1, questo file è di norma installato nel seguente percorso di directory:

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

Su Rational ClearQuest 7.1 e successive, questo file è di norma installato nella directory home dell'utente:

UserHome\.Rational\ClearQuest\rcp_configuration_71\eclipse\plugins
\com.ibm.rational.clearquest.testmanagement.rqmexport_datestamp\data

Ad esempio, su un computer con in esecuzione Windows XP con Rational ClearQuest 7.1, il percorso potrebbe essere il seguente:

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

Nel file migration.cfg, le associazioni per una determinata risorsa utente sono contenute nelle tag <field _mapping> mentre le singole associazioni per ogni campo all'interno della risorsa utente sono definite nelle tag <mapping>. Ad esempio, le seguenti due righe di codice XML indicano che la risorsa utente TMTestCase in Rational ClearQuest Test Manager verrà associata alla risorsa utente TestCase in Rational Quality Manager e che il campo Headline all'interno di TMTestCase verrà associato al campo title all'interno di TestCase.

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

Per aggiornare un'associazione dei campi, modificare l'associazione esistente con l'impostazione appropriata dell'attributo from o to. Per aggiungere una nuova associazione, duplicare un'associazione esistente e aggiornarla di conseguenza. Dopo aver regolato l'associazione del campo, eseguire di nuovo la procedura guidata di migrazione per utilizzare il file aggiornato.

Di seguito sono riportate le associazioni predefinite per uno scenario di test nel file 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"/>

<!-- 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=&quot;Notes&quot;" pre="true"/>
<mapping from="custom2" to="LegacyCustom2"/>
<mapping from="custom3" to="LegacyCustom3"/>
</field_mapping>

La seguente tabella descrive alcune direttive aggiuntive che possono essere incluse all'interno di un'associazione.

Tabella 1.
Direttiva Descrizione
pre="true" Pre-formattato. Sistema i dati in modo che non verranno riformattati.
file=”true” Specifica che il campo fa riferimento a un file esterno in Rational ClearQuest Test Manager.
scripttype Utilizzato solo per gli script associati.

Esempio 1 - Associazione di un campo definito dall'utente

Questo esempio mostra il caso più semplice in cui un campo definito dall'utente in Rational ClearQuest Test Manager è associato a un campo esistente in Rational Quality Manager.

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

In questo esempio, il campo definito dall'utente InternalName è associato al campo title in Rational Quality Manager.

Esempio 2 - Riferimento a un campo da una risorsa utente di riferimento

Questo esempio mostra il modo in cui un campo in una risorsa utente di riferimento è associato a un campo in Rational Quality Manager.

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

In questo esempio, il campo Headine nella risorsa utente ParentPlan è associato al campo description in Rational Quality Manager.

Esempio 3 - Associazione di un campo definito dall'utente a una sezione definita dall'utente

Questo esempio mostra il modo in cui un campo definito dall'utente in Rational ClearQuest Test Manager è associato a una sezione definita dall'utente in Rational Quality Manager.

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

In questo esempio, l'associazione fa ancora riferimento al campo InternalName personalizzato in Rational ClearQuest Test Manager, ma questo è associato a una sezione definita dall'utente in Rational Quality Manager, detta InternalName.

Il nome della sezione definita dall'utente in Rational Quality Manager può essere un qualsiasi nome senza spazi e deve avere myns: come prefisso.

L'ultima parte dell'esempio, extensionDisplayName=&quot;Internal Name&quot;", specifica il modo in cui il nome della sezione apparirà in Rational Quality Manager.

Qui il nome della sezione definita dall'utente, InternalName, verrà visualizzata come Nome interno. Nome interno deve essere racchiuso tra virgolette ma poiché deve essere incluso in un file XML, le virgolette devono essere sostituite con la versione escape delle virgolette, ovvero &quot;.

Esempio 4 - Sostituzione dei valori in Rational ClearQuest Test Manager

Questo esempio mostra come i valori in Rational ClearQuest Test Manager vengono sostituiti con i valori in 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>

In questo esempio, il tag enumerato inizia con la parola chiave enum_mapping, e l'attributo name specifica il campo in Rational ClearQuest Test Manager i cui valori devono essere sostituiti. Nella prima riga, l'attributo pass deve essere sostituito con com.ibm.rqm.execution.common.state.passed in Rational Quality Manager. D'altra parte, se si desiderava associare tutti i risultati di test senza risultati ad un errore in Rational Quality Manager, si sarebbe potuto modificare tale riga in <mapping from="inconclusive" to="com.ibm.rqm.execution.common.state.failed"/>.

Esempio 5 - Definizione di categorie nel file migration.cfg

È possibile associare i campi e i relativi valori in Rational ClearQuest Test Manage alle categorie e ai valori in Rational Quality Manager. Se la categoria non esiste, verrà creata.

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

In questo esempio, il campo Stato e i suoi valori verranno associati alla categoria denominata Test. I valori nel campo Stato verranno quindi migrati.



Si ha un problema o si desidera fare una domanda? Inserire un post nel forum Jazz.net.