Personalización de la migración de activos de prueba de Rational ClearQuest Test Manager

Si la correlación predeterminada de los campos de registro de Rational ClearQuest Test Manager con los campos de registro de Rational Quality Manager es insuficiente, puede modificar la correlación para que se ajuste a sus necesidades.

El archivo de correlaciones de migración - migration.cfg

La correlación de los activos de prueba está controlada por medio de un archivo XML denominado migration.cfg. Podrá encontrar este archivo en la siguiente ubicación:

<install directory>\eclipse\plugins\com.ibm.rational.clearquest.testmanagement.rqmexport\data\RQMExport

En el archivo migration.cfg, las correlaciones para un artefacto en particular están dentro de los códigos <field _mapping>, mientras que las correlaciones individuales para cada campo dentro del artefacto están definidas en los códigos <mapping>. Por ejemplo, las siguientes dos líneas de código XML indican que el artefacto TMTestCase en Rational ClearQuest Test Manager será correlacionado con el artefacto TestCase en Rational Quality Manager, y que el campo Headline dentro de TMTestCase será correlacionado con campotitle dentro de TestCase.

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

Para actualizar una correlación de campo, modifique la correlación existente con el valor de atributo adecuado from o to. Para añadir una nueva correlación, debe duplicar una correlación existente y actualizarla como corresponda. Después de ajustar la correlación de campo, vuelva a ejecutar el asistente de migración para utilizar el archivo de correlación actualizado.

Las correlaciones predeterminadas para un caso de prueba en el archivo migration.cfg se muestran a continuación.
<?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 tabla siguiente describe algunas directivas adicionales que se pueden incluir en una correlación.

Tabla 1.
Directiva Descripción
pre="true" Pre-formateado. Ajusta los datos de modo que no se vuelvan a formatear.
file=”true” Especifica que el campo se refiera a un archivo externo en Rational ClearQuest Test Manager.
scripttype Sólo se usa para scripts asociados.

Ejemplo 1 - Correlacionar un campo definido por el usuario

Este ejemplo muestra el caso simple donde un campo de definido por el usuario en Rational ClearQuest Test Manager se correlaciona con un campo existente en Rational Quality Manager.

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

En este ejemplo, un campo definido por el usuario denominado InternalName se correlaciona con el campo title en Rational Quality Manager.

Ejemplo 2 - Hacer referencia a un campo de un artefacto referenciado

Este ejemplo muestra cómo un campo en un artefacto referenciado se correlaciona con un campo en Rational Quality Manager.

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

En este ejemplo, el campo Headine en el artefacto ParentPlan está correlacionado con el campo description en Rational Quality Manager.

Ejemplo 3 - Correlacionar un campo definido por el usuario con una sección definida por el usuario

Este ejemplo muestra cómo un campo definido por el usuario en Rational ClearQuest Test Manager se correlaciona con una sección definida por el usuario en Rational Quality Manager.

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

En este ejemplo, la correlación todavía hace referencia al campo personalizado InternalName en Rational ClearQuest Test Manager, pero ahora se correlaciona con una sección definida por el usuario en Rational Quality Manager, también denominada InternalName.

El nombre de la sección definida por el usuario en Rational Quality Manager puede ser cualquier nombre sin espacios y se le debe anteponer myns:.

La última parte de este ejemplo - extensionDisplayName=&quot;Internal Name&quot;" - especifica cómo la sección del nombre aparecerá en Rational Quality Manager.

Aquí, el nombre de la sección definida por el usuario, InternalName, se visualizará como Internal Name. Internal Name debe estar encerrado entre comillas, pero dado que se debe incluir en un archivo XML, las comillas se deben reemplazar con su versión escapada, es decir, &quot;.


Comentarios