Compartir a través de

Tutorial: Migración de elementos de trabajo de ClearQuest a Team Foundation

  • Artículo

Actualización: noviembre 2007

Este tutorial describe el proceso para mover elementos de trabajo de ClearQuest a Seguimiento de elementos de trabajo de Team Foundation. Team Foundation incluye una utilidad de conversión, CQConverter.exe, que puede utilizar para realizar esta migración.

En este tutorial, llevará a cabo las tareas siguientes:

  • Configurar el proceso de migración   Edite los archivos de configuración para el proceso de migración.

  • Analizar la base de datos ClearQuest   Ejecute el convertidor de ClearQuest para analizar la base de datos ClearQuest actual. El análisis da como resultado un informe y un conjunto de archivos que describen los tipos de elementos de trabajo presentes en ClearQuest.

  • Definir la asignación de la migración   Edite los archivos XML generados durante el análisis de la base de datos ClearQuest para personalizar el proceso de migración.

  • Migrar la base de datos ClearQuest a Seguimiento de elementos de trabajo de Team Foundation   Utilice los archivos de configuración y de asignación generados durante el análisis de la base de datos para migrar los datos.

  • Revisar el informe de migración   Detecte la causa de los errores y advertencias que aparecen durante la migración, y revise el estado de ésta.

Requisitos previos

Para completar este tutorial, debe tener instalado el siguiente software en el equipo en el que va a ejecutar CQConverter.exe:

  • Team Explorer

  • El cliente independiente de ClearQuest Versión 2003.06.00

    Nota:

    Es posible que las versiones 2002.05.20 y 2003.05.00 también funcionen, pero no se han probado.

También debe hacer una lista de las asignaciones de los nombres de usuario de ClearQuest a los nombres de dominio de Windows utilizados por Seguimiento de elementos de trabajo de Team Foundation. Asegúrese de que incluye nombres de usuario que no se utilicen.

La siguiente información y conocimientos le resultarán de utilidad:

  • Conocimientos básicos de XML.

  • Una lista de las asignaciones de los campos de los elementos de trabajo de ClearQuest a Seguimiento de elementos de trabajo de Team Foundation. Incluya la información sobre las transformaciones necesarias. Por ejemplo, podría asignar un campo de cadena de ClearQuest a un campo de entero en Seguimiento de elementos de trabajo de Team Foundation.

Permisos necesarios

Para realizar este tutorial, debe ser miembro del grupo de seguridad Cuentas de servicio. Además, debe ser miembro del grupo de seguridad Readers o tener el valor del permiso Ver los elementos de trabajo de este nodo establecido en Permitir. Para obtener más información, vea Permisos de Team Foundation Server. Además, debe tener el permiso de superusuario para la base de datos de ClearQuest. Para obtener más información, consulte el Manual del administrador de ClearQuest.

Tareas previas a la migración

Antes de iniciar la migración, debe realizar las tareas siguientes:

  • Programar la hora de bloqueo de la base de datos ClearQuest   Lo más recomendable es que bloquee la base de datos para impedir que los usuarios creen nuevos elementos de trabajo durante el proceso de migración. El convertidor ClearQuest no detecta los cambios de los elementos de trabajo durante la conversión. Para obtener información sobre cómo bloquear la base de datos ClearQuest, consulte la documentación de ClearQuest.

  • Crear proyectos de equipo de Visual Studio Issue Tracking    Cree proyectos de equipo y decida los elementos de trabajo que deben incluirse en cada uno de ellos. Para obtener más información sobre cómo crear proyectos de equipo de Seguimiento de elementos de trabajo de Team Foundation, vea Tutorial: Crear un nuevo proyecto de equipo.

  • Agregar la cuenta de usuario que está utilizando para ejecutar el convertidor en el grupo Cuentas de servicio   CQConverter necesita permisos de cuenta de servicio para poder ejecutarse. Agregue la cuenta de usuario que va a ejecutar el convertidor al grupo Cuentas de servicio del servidor Team Foundation Server mediante la utilidad TFSSecurity. Para obtener más información, vea Comandos de la utilidad TFSSecurity de la línea de comandos.

Limitaciones del convertidor

Antes de iniciar la migración, debe revisar las limitaciones del convertidor ClearQuest y tener en cuenta cómo afectan a los usuarios de su organización. Para obtener más información, vea Utilidad de la línea de comandos CQConverter para la migración de bases de datos de ClearQuest.

Definiciones

En este tutorial se utilizan los siguientes términos:

  • Tipo de elemento de trabajo   Los tipos de elementos de trabajo son los bloques de creación de un sistema de seguimiento de elementos de trabajo. Ejemplos de tipos de elementos de trabajo son los errores, los requisitos y las tareas.

  • Entidad   La unidad de datos básica de ClearQuest. Por ejemplo, un defecto se podría vincular a un cliente y pertenecer a un proyecto determinado. El defecto, el cliente y el proyecto son entidades.

  • Campo   Los elementos de trabajo contienen campos que, a su vez, contienen información sobre el elemento de trabajo. Por ejemplo, un elemento de trabajo de defecto podría tener campos como "abierto por", "estado", "resolución", "historial", "vínculos" y "datos adjuntos".

  • Estados   La posición en el proceso en la que podría encontrarse un elemento de trabajo. Por ejemplo, un error podría estar Abierto, Asignado, Resuelto o Pospuesto.

  • Comportamiento de los campos (Reglas de campos)   Especifica el comportamiento de los campos en diferentes estados. Por ejemplo, el campo Corregido en podría ser un campo no modificable al crear un nuevo error, pero cuando éste adoptara el estado Resuelto, el campo Corregido en podría requerir un valor.

Configurar el proceso de migración

Durante este paso, modificará los archivos de configuración del convertidor de ClearQuest para que le sirvan de guía en el proceso de migración.

Archivo de configuración

El archivo de configuración es un archivo XML que proporciona la configuración para el convertidor de ClearQuest. La configuración se especifica en las secciones siguientes del archivo XML:

<ClearQuest>

La sección ClearQuest contiene información sobre la base de datos ClearQuest que desea migrar.

  • ConnectionName   El nombre de la conexión de ClearQuest.

  • UserDatabase   El nombre de la base de datos de usuario de ClearQuest.

  • QueryName   El nombre de una consulta guardada en ClearQuest.

  • UserID   Id. de usuario de ClearQuest. El identificador de usuario especificado debe tener el permiso Super User para la base de datos de ClearQuest.

<VSTS>

La sección VSTS contiene información sobre Seguimiento de elementos de trabajo de Team Foundation y el proyecto de equipo al que va a realizar la migración.

  • URI  Nombre descriptivo del servidor Team Foundation Server o la dirección URI completa. Por ejemplo, "MyAtServer," o "http://MyAtServer:8080."

  • ProjectName  Nombre del proyecto de equipo de Seguimiento de elementos de trabajo de Team Foundation.

Otros opciones de configuración

Las demás secciones del archivo XML le permiten configurar lo siguiente:

  • ExitOnError   Esta sección acepta un valor de true o false. Especifique True si desea detener el convertidor de ClearQuest cuando se produzcan errores en la migración de ciertos elementos de trabajo.

    Nota:

    Este valor sólo se aplica a los errores que no son graves. En los errores graves, como el que se produce cuando el convertidor de ClearQuest no se puede conectar con ClearQuest, el convertidor siempre finalizará su ejecución, aunque este valor sea False.

  • OutputDirectory   Especifique el directorio en el que desea guardar los archivos generados. Si no especifica un directorio de resultados, el convertidor crea un directorio con nombre de la entidad base para generar los archivos de salida. Si el directorio ya existe, el convertidor reemplaza los archivos almacenados en él.

Crear el archivo de configuración

El archivo de configuración se puede crear en cualquier editor de texto, como el Bloc de notas.

Para crear el archivo de configuración

  1. Reúna la siguiente información:

    • El nombre de conexión de ClearQuest.

    • El nombre de la base de datos ClearQuest.

    • El identificador de usuario y la contraseña del administrador de ClearQuest. Asegúrese de que este usuario tiene permisos para enviar problemas en ClearQuest.

    • El nombre del servidor Seguimiento de elementos de trabajo de Team Foundation.

    • El nombre del proyecto de equipo de Seguimiento de elementos de trabajo de Team Foundation (el proyecto de equipo al que desea migrar los elementos de trabajo).

  2. Cree una consulta en Clearquest para seleccionar los elementos de trabajo que desea migrar a Seguimiento de elementos de trabajo de Team Foundation y guárdela. Guarde la consulta con cualquier nombre, por ejemplo TransitionQuery.

  3. Elija un directorio para almacenar los archivos producidos durante la fase de análisis.

  4. Copie el siguiente archivo de configuración XML en un editor de texto.

    <?xml version="1.0" encoding="utf-8"?>
<WorkItemConverter>
  <Source id="ClearQuest">
    <ClearQuest>
      <ConnectionName>CQRep</ConnectionName> 
      <UserDatabase>TEST</UserDatabase> 
      <QueryName>Public Queries/All Defects</QueryName> 
      <UserID>admin</UserID>
    </ClearQuest>
  </Source>
  <VSTS>
    <URI>AdventureWorksServer</URI>
    <ProjectName>AdventureWorksProject</ProjectName> 
  </VSTS>
  <ExitOnError>true</ExitOnError>
  <OutputDirectory>DefectSchema</OutputDirectory>
</WorkItemConverter>

  5. Cambie el archivo para especificar la configuración con la información reunida en los pasos anteriores. Por ejemplo, bajo < QueryName >, especifique el nombre de la consulta como TransitionQuery e incluya la ruta de acceso de la consulta. Vea la sección "Archivo de configuración" en este mismo tema para obtener información sobre el contenido que debe tener cada sección.

    Nota:

    La contraseña no se introduce en el archivo, la herramienta de conversión de ClearQuest la solicitará posteriormente en el proceso de migración.

  6. Guarde el archivo.

    Por ejemplo, puede guardar el archivo como CqConverterConfig.xml.

Analizar la base de datos ClearQuest

Durante el análisis de la base de datos ClearQuest, la herramienta de conversión de ClearQuest a Team Foundation analiza la base de datos ClearQuest y crea los siguientes archivos XML:

  • Un archivo de definición de tipo de elemento de trabajo (WITD) de Seguimiento de elementos de trabajo de Team Foundation para cada tipo de entidad de ClearQuest que contiene los estados, las transiciones de los estados, los campos, los tipos de campos y el comportamiento de los campos, como obligatorio u opcional.

  • Un archivo de asignación de campos predeterminado que asigna los campos y los valores de ClearQuest a los campos y los valores de Seguimiento de elementos de trabajo de Team Foundation.

  • Un archivo de asignación de usuarios que asigna los usuarios de ClearQuest a los usuarios de Windows. Este archivo se aplica a todo el sistema.

  • Un archivo de asignación de esquemas que contiene referencias a los demás archivos XML, como el archivo SchemaMap, que contiene nombres de entidades, y el archivo de asignación de campos, que tiene la ruta de acceso de los nombres de archivo de WorkItem y de los archivos de fieldMap generados.

  • Un archivo de informe y de advertencias (CQAnalysisReport.xml).

Para analizar la base de datos ClearQuest

  1. En el símbolo del sistema de Visual Studio 2008, ejecute el siguiente comando:

    CQConverter.exe /c:analyze /m:CqConverterConfig.xml

    El convertidor de ClearQuest tardará unos minutos en finalizar.

    Nota   Para obtener más información sobre los comandos del convertidor de ClearQuest, vea Utilidad de la línea de comandos CQConverter para la migración de bases de datos de ClearQuest.

  2. En el directorio de resultados especificado en el archivo de configuración, busque los siguientes archivos XML. Estos archivos se usarán más adelante en el proceso de migración:

    • Un archivo WITD para cada tipo de entidad de ClearQuest, denominado EntityName.xml. Por ejemplo, un archivo para la entidad Defect de ClearQuest se denominaría Defect.xml.

    • Un archivo de asignación de campos para cada tipo de entidad de ClearQuest. Estos archivos especifican cómo se asignarán los campos de cada entidad de ClearQuest y sus valores a los campos correspondientes en los tipos de elementos de trabajo de Seguimiento de elementos de trabajo de Team Foundation. Por ejemplo, un archivo para la entidad Defect de ClearQuest se denominaría DefectFieldMap.xml.

    • Un archivo usermap. Un archivo que especifica cómo se van a asignar los usuarios de ClearQuest a los usuarios de Seguimiento de elementos de trabajo de Team Foundation.

    • Un archivo schemamap.xml. Un archivo que describe las asignaciones de esquemas y de campos.

  3. En el directorio en el que ha ejecutado el convertidor, busque el archivo CQAnalysisReport.xml para comprobar si existen advertencias y errores antes de la migración.

Definir la asignación de la migración

El análisis genera un conjunto de archivos que capturan la información de la base de datos ClearQuest. Es posible que tenga que modificar alguno de dichos archivos para poder migrar la base de datos de la manera deseada. Como mínimo, deberá cambiar el archivo de asignación de usuarios y el archivo de definición de tipo de elemento de trabajo.

Para obtener más información sobre cómo modificar el archivo de definición para un tipo de elemento de trabajo, vea Tutorial: Realizar personalizaciones básicas en un tipo de elemento de trabajo.

Editar el archivo de asignación de esquemas

Para cambiar el archivo schemamap.xml

  1. Abra el archivo Schemamap.xml.

    A continuación se proporciona un ejemplo de este archivo.

    <Mappings>
  <SchemaMaps>
    <SchemaMap SourceEntity="Defect" TargetWIT="Defect"
      WITDFile="Defect.xml" FieldMapFile="DefectFieldMap.xml"/> 
    <SchemaMap SourceEntity="Customer" TargetWIT="Customer"
      WITDFile="Customer.xml" FieldMapFile="CustomerFieldMap.xml"/> 
  </SchemaMaps>
  <UserMap File="UserMap.xml" /> 
</Mappings>

  2. Cambie las secciones apropiadas de este archivo.

    • SourceEntity   Asegúrese de que esta sección contiene la entidad correcta de ClearQuest.

    • TargetWIT   Asegúrese de que esta sección señala al tipo de elemento de trabajo correcto que se debe crear en Seguimiento de elementos de trabajo de Team Foundation.

    • WITDFile   Esta sección especifica el archivo XML de definición de tipo de elemento de trabajo (WITD).

    • FieldMapFile   Esta sección especifica el archivo XML de asignación de campos.

    • UserMap   Esta sección especifica el archivo XML de asignación de usuarios.

Editar el archivo de asignación de usuarios

El convertidor de ClearQuest utiliza el archivo de asignación de usuarios para asignar los identificadores de usuario de la base de datos ClearQuest a sus equivalentes en Seguimiento de elementos de trabajo de Team Foundation. Esto ayuda a conservar el historial de los elementos de trabajo convirtiendo los valores de los campos de identificadores de usuario en valores válidos en Seguimiento de elementos de trabajo de Team Foundation. Seguimiento de elementos de trabajo de Team Foundation utiliza los identificadores de usuario del dominio de Windows.

El convertidor de ClearQuest genera una versión predeterminada de este archivo durante la fase de análisis. Asegúrese de que dicho archivo es correcto antes de continuar con la conversión, ya que el convertidor lo comprueba y dará un error si existe algún problema.

Para cambiar el archivo de asignación de usuarios

  1. Abra el archivo usermap.xml. A continuación tiene un ejemplo de dicho archivo:

    <UserMappings">
  <UserMap From="admin" To="admin" />
  <UserMap From="user" To="user" />
  <UserMap From="QE" To="QE" />
  <UserMap From="lead" To="lead" /> 
  <UserMap From="engineer" To="engineer" />
</UserMappings>

  2. Examine las asignaciones de usuarios y realice las correcciones, adiciones o eliminaciones necesarias. A la derecha de la palabra "To" debe especificarse un usuario de Team Foundation Server existente.

  3. En Seguimiento de elementos de trabajo de Team Foundation, agregue todos los usuarios especificados en el archivo de asignación de usuarios. Para obtener más información sobre la adición de usuarios, vea Cómo: Agregar usuarios a un grupo de proyecto de equipo.

    Nota:

    Si desea que algún usuario de ClearQuest se asigne tal como está a Team Foundation Server durante la migración, puede eliminar las filas del archivo de asignación de usuarios correspondientes a dicho usuario. Si no desea que se realice la asignación de usuarios, elimine todas las filas correspondientes a la asignación de usuarios de la sección <UserMap>. Únicamente debería eliminar las entradas individuales de la sección <UserMap>; no elimine la sección ni ninguna otra parte del archivo.
    Precaución:

    Si los usuarios no se asignan a usuarios válidos de Team Foundation Server durante la migración, tendrá que corregir los campos de usuarios de los elementos de trabajo cuando comience a trabajar con ellos. El convertidor se ejecuta sin validar los valores de los campos, pero tan pronto como comience a modificar los elementos de trabajo, se le pedirá que especifique usuarios válidos para los campos de usuarios.

Editar el archivo de asignación de campos

El convertidor de ClearQuest utiliza los archivos de asignación de campos para asignar los campos de cada entidad de ClearQuest a los campos de los elementos de trabajo equivalentes en Seguimiento de elementos de trabajo de Team Foundation.

Para cambiar el campo de asignación de usuarios

  1. Abra uno de los archivos de asignación de campos. Por ejemplo, abra DefectFieldMap.xml. A continuación tiene un ejemplo de dicho archivo:

    <FieldMap from="Criticality" to="Severity">
  <ValueMaps>
        <ValueMap from="1-Critical" to = "1"/>
        <ValueMap from="2-Major" to = "2"/>
  </ValueMaps>
</FieldMap>

  2. Revise las líneas de asignación de campos (las que comienzan por ValueMap) y asegúrese de que el campo indicado después de "from" se asigna al campo correcto después de "to". Puede agregar más asignaciones de campos; para ello, agregue más líneas ValueMap. Los valores deberían estar en la lista de valores permitidos si se ha especificado ésta en el archivo de esquema, en este caso defect.xml.

    Nota:

    Si modifica las asignaciones de los campos, asegúrese de que se asignan los campos obligatorios del formulario de elemento de trabajo

  3. Abra los demás archivos de asignación de campos y edítelos como corresponda.

Establecer una definición de tipos de elementos de trabajo

Después de la fase de análisis, el convertidor genera definiciones de tipos de elementos de trabajo (WITD) para cada tipo de registro de ClearQuest. Por ejemplo, un archivo para el tipo de registro Defect de ClearQuest se denomina Defect.xml. El convertidor genera un formulario de elemento de trabajo predeterminado como parte de la generación de esquemas durante la fase de análisis. Sin embargo, este formulario contiene el formato básico y casi siempre deberá modificarlo para obtener el diseño del elemento de trabajo que desea. Para obtener información sobre cómo cambiar el archivo de definición de un tipo de elemento de trabajo, vea Tutorial: Realizar personalizaciones básicas en un tipo de elemento de trabajo y Tutorial: Realizar personalizaciones avanzadas en un tipo de elemento de trabajo.

Migrar los elementos de trabajo de ClearQuest

Para migrar los elementos de trabajo

  1. En el símbolo del sistema de Visual Studio 2008, ejecute el siguiente comando:

    CQConverter.exe /c:migrate /m:CqConverterConfig.xml /s:rutaAcceso\Schemamap.xml

    Donde ruta es la ruta de acceso al archivo de asignaciones del esquema. El archivo de asignaciones del esquema se genera durante la fase de análisis en el directorio de salida especificado.

    Nota:

    El convertidor de ClearQuest puede tardar varias horas en finalizar su ejecución en el caso de bases de datos de gran tamaño.
    Nota:

    Para obtener más información sobre los comandos del convertidor de ClearQuest, vea Migrar desde ClearQuest.

  2. Una vez haya finalizado la migración, revise el informe de migración para ver el estado de ésta y otros posibles problemas, como defectos que no se migran debido a incoherencias en la asignación de campos.

    El informe de migración se denomina CQMigrationReport.xml y se crea en la carpeta desde la que se ha ejecutado el convertidor de ClearQuest.

    Nota:

    Dado que el convertidor convierte todos los elementos de trabajo incluidos en la consulta especificada, además de todos los vinculados desde esos elementos de trabajo, el número real de elementos de trabajo migrados puede ser distinto del de la consulta.

  3. Si no se han migrado todos los elementos de trabajo, puede ejecutar la conversión de nuevo después de resolver los problemas indicados en el informe de migración.

Si desea migrar más elementos de trabajo desde ClearQuest a Seguimiento de elementos de trabajo de Team Foundation, puede ejecutar de nuevo el proceso de migración.

Para ejecutar de nuevo la migración en la misma base de datos ClearQuest

  1. Corrija los problemas indicados en el informe de migración para la migración anterior.

  2. Cree una consulta en ClearQuest que devuelva los elementos de trabajo deseados, o ejecute la misma consulta si desea migrar los elementos de trabajo que no se migraron la primera vez.

  3. Modifique la sección <QueryName> del archivo de configuración para especificar el nombre de la nueva consulta.

  4. Abra el símbolo del sistema de Visual Studio 2008 y escriba el comando para la migración:

    CQConverter.exe /c:migrate /m:CqConverterConfig.xml /s:rutaAcceso\Schemamap.xml

    El convertidor de ClearQuest puede tardar varias horas en finalizar su ejecución en el caso de bases de datos de gran tamaño.

    Nota:

    Para obtener más información sobre los comandos del convertidor de ClearQuest, vea Migrar desde ClearQuest.

  5. Cuando finalice la migración, revise el informe de migración para comprobar el estado de ésta. El informe de migración se denomina CQMigrationReport.xml y se crea en la carpeta desde la que se ha ejecutado el convertidor de ClearQuest.

Comprobar la migración de los elementos de trabajo

Una vez realizada la migración, puede examinar algunos de los elementos de trabajo migrados para comprobar que la información se ha migrado correctamente.

Para comprobar los elementos de trabajo migrados

  1. Abra un elemento de trabajo migrado en Seguimiento de elementos de trabajo de Team Foundation.

  2. Utilice el número del campo de identificador de ClearQuest para comparar el elemento de trabajo de Seguimiento de elementos de trabajo de Team Foundation con el error de ClearQuest que tiene el mismo identificador.

Para buscar el elemento de trabajo de Team Foundation correspondiente a un elemento de trabajo de ClearQuest determinado

  1. Cree una consulta de elementos de trabajo con la siguiente cláusula de consulta:

    Y/O

    Campo

    Operador

    Valor

     

    VSTS SourceID

    =

    Id. de elemento de trabajo de ClearQuest

    El campo VSTS SourceID corresponde a la etiqueta del campo de identificador de ClearQuest que aparece en el formulario de elemento de trabajo.

    Para obtener más información sobre cómo crear consultas de elementos de trabajo, vea Cómo: Agregar nuevas consultas de elementos de trabajo.

  2. Ejecute la consulta.

Vea también

Tareas

Tutorial: Seguimiento de elementos de trabajo

Otros recursos

Tutoriales para la migración