Personalización de la migración de artefactos 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 artefactos de prueba se controla por medio de un archivo XML denominado migration.cfg. En Rational ClearQuest 7.0.1, este archivo normalmente se instala en la siguiente vía de acceso de directorio:

DirInstalaciónCQ.Rational\ClearQuest\rcp_configuration_701\eclipse\plugins
\com.ibm.rational.clearquest.testmanagement.rqmexport_indicación_fecha_y_hora\data

En Rational ClearQuest 7.1 y posteriores, este archivo normalmente se instala en el directorio inicial del usuario:

DirInicialUsuario\.Rational\ClearQuest\rcp_configuration_71\eclipse\plugins
\com.ibm.rational.clearquest.testmanagement.rqmexport_indicación_fecha_y_hora\data

Por ejemplo, en un sistema que ejecute Windows XP con Rational ClearQuest 7.1, la ubicación podría ser la siguiente:

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

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 campos, vuelva a ejecutar el asistente de migración para utilizar el archivo de correlaciones 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;.

Ejemplo 4 - Sustitución de valores en Rational ClearQuest Test Manager

Este ejemplo muestra cómo los valores de Rational ClearQuest Test Manager se sustituyen por valores de 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>

En este ejemplo, el código numerado empieza por la palabra clave enum_mapping y el atributo name especifica el campo en Rational ClearQuest Test Manager cuyos valores se van a sustituir. En la primera fila, el atributo pass se sustituirá por com.ibm.rqm.execution.common.state.passed en Rational Quality Manager. Por otro lado, si quisiera que todos los resultados de pruebas no concluyentes se correlacionaran con anomalías en Rational Quality Manager, cambiaría esa fila a <mapping from="inconclusive" to="com.ibm.rqm.execution.common.state.failed"/>.

Ejemplo 5 - Definición de categorías en el archivo migration.cfg

Puede correlacionar campos y sus valores de Rational ClearQuest Test Manager con categorías y valores de Rational Quality Manager. Si la categoría no existe, se creará.

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

En este ejemplo, el campo State y sus valores se correlacionarán con una categoría denominada Test. Los valores del campo State se migrarán también.



¿Tiene alguna duda o problema? Publíquelo en el Foro de Jazz.net.