Analizar una base de datos ClearQuest

Actualización: noviembre 2007

En la fase de análisis, el convertidor lee el esquema de la base de datos ClearQuest y genera archivos que representan ese esquema en formato Team Foundation. El convertidor utiliza la consulta de ClearQuest para determinar el tipo de entidad base de ClearQuest; una consulta en ClearQuest está basada en un tipo de entidad. El convertidor también busca los tipos de entidad asociados al tipo de entidad base. Las entidades asociadas de la entidad base son aquéllas a las que la entidad base hace referencia. Esto significa que las entidades están presentes en el tipo de entidad base como una referencia o una lista de referencias. Esta lista de entidades a las que se hace referencia excluye lo siguiente:

• Tipos de entidad a los que se puede hacer referencia como duplicado de.

• Entidad de usuario Los usuarios se migran de acuerdo con el tratamiento de usuarios en Team Foundation. Team Foundation no trata los usuarios como una entidad.

• Entidad de datos adjuntos  Los datos adjuntos se migran de acuerdo con el tratamiento principal de los datos adjuntos en Team Foundation. Team Foundation no trata los datos adjuntos como una entidad.

• Historial  El historial se migra según el tratamiento principal del historial de Team Foundation. Team Foundation no trata el historial como una entidad.

• Grupos   El convertidor no migra los grupos de ClearQuest. Los grupos se tratan de manera diferente en Team Foundation.

• Ratl_replicas  Esta entidad no tiene ningún concepto equivalente en Team Foundation.

Fase de análisis

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

CQConverter /c:analyze /m:CqConverterConfig.xml

Nota:

Para analizar su base de datos ClearQuest, es preciso que la Id. de usuario especificada en el archivo CqConverterConfig.xml tenga permisos de superusuario. Para obtener más información, consulte la Guía del administrador de ClearQuest. Además, deberá ser un miembro del grupo Cuentas de servicio en el Team Foundation Serverespecificado. Para obtener más información, vea Permisos de Team Foundation Server.

El convertidor de ClearQuest puede tardar varios minutos en ejecutarse. Al final de la fase de análisis se generan varios archivos.

Archivo de configuración de la conversión

Tiene que especificar las entradas para el convertidor en un archivo de configuración. Para obtener más información, vea Archivo de configuración del convertidor de elementos de trabajo.

Archivos de resultados

La fase de análisis genera varios archivos de resultados. Los archivos se guardan en la carpeta especificada en el elemento <Outputdirectory> en el archivo de configuración de migración. Si no se especifica ningún directorio, el convertidor crea una carpeta que tiene el mismo nombre que el tipo de entidad base de ClearQuest. Si la carpeta ya existe, el contenido de esa carpeta se sobrescribe con los nuevos archivos xml generados.

Al final de la fase de análisis, se crean los archivos siguientes:

• Archivos xml de definición de tipos de elemento de trabajo   Estos archivos representan los tipos de elemento de trabajo en formato Team Foundation y se utilizan para crear tipos de elementos de trabajo en Team Foundation. Se genera un archivo para la entidad primaria y para cada entidad a la que se hace referencia. Estos archivos se denominan <TipoDeEntidad>.xml. Por ejemplo, un tipo de elemento de trabajo de defecto genera el archivo Defecto.xml.

• Archivos xml de asignación de campos   Estos archivos especifican cómo se asignan los campos de los tipos de registros de ClearQuest a los tipos de elementos de trabajo de Team Foundation y definen cualquier transformación de datos que se aplicará durante la migración de los datos. Estos archivos tienen una relación uno a uno con los archivos de tipo de elemento de trabajo. Cada archivo de asignación de campos especifica la asignación para el tipo de elemento de trabajo correspondiente. Estos archivos se denominan <NombreDeEntidad>FieldMap.xml. Por ejemplo, el tipo de elemento de trabajo de defecto genera el archivo DefectoFieldMap.xml.

• Archivo xml de asignación de usuarios   Este archivo se denomina UserMap.xml. Especifica cómo se asignan los usuarios de ClearQuest a los usuarios de Team Foundation. Este archivo puede ser necesario porque ClearQuest tiene una base de datos de usuarios independiente y los nombres de usuario de ClearQuest podrían no ser iguales que los de las cuentas de usuario de Windows. Team Foundation requiere cuentas de usuario de Windows.

• Archivo xml de asignación del esquema   Este archivo se denomina SchemaMap.xml. Contiene los nombres de todos los archivos descritos anteriormente y especifica asignaciones adicionales entre los tipos de elemento de trabajo y los archivos asociados.

• Archivo xml del informe de análisis   Este archivo se denomina CQAnalysisReport.xml. Se genera una carpeta asociada a este archivo denominada _AnalysisReport_Files, que contiene imágenes y una hoja de estilo que muestra este archivo correctamente en un explorador.

• Archivo de registro denominado CQConverter.log

  Nota:
  Independientemente del número de campos de un elemento de trabajo concreto seleccionado en una consulta, el convertidor selecciona todos los campos presentes en un tipo de elemento de trabajo para su análisis. Los archivos de resultados contienen referencias para todos los campos.

Archivo de definición de tipo de elemento de trabajo

Los archivos de definición de tipo de elemento de trabajo (WITD) capturan el esquema de un tipo de elemento de trabajo en formato Team Foundation. Puede utilizar un archivo WITD para crear un nuevo tipo de elemento de trabajo en Team Foundation. Un archivo WITD especifica los campos de un tipo de elemento de trabajo, estados y transiciones de estado, reglas y la interfaz de usuario para mostrar el elemento de trabajo. Para obtener más información sobre los archivos de definición de tipo de elemento de trabajo, vea Personalizar tipos de elemento de trabajo.

Las secciones siguientes detallan cómo se generan estos tipos de elemento de trabajo.

Asignaciones de tipo de campo

El convertidor asigna los tipos de campo de ClearQuest a los tipos de campo adecuados de Team Foundation. La tabla siguiente especifica cómo se asignan los campos.

Tipo de campo de ClearQuest	Tipo de campo de Team Foundation
ATTACHMENT_LIST	No es aplicable Esta clase de campo se migra a Team Foundation como datos adjuntos, no como un campo.
DATE_TIME	DateTime
INT	Integer
MULTILINE_STRING	Texto sin formato
REFERENCE	No es aplicable Esta clase de campo se migra a Team Foundation como vínculos, no como un campo.
REFERENCE_LIST	No es aplicable Esta clase de campo se migra a Team Foundation como vínculos, no como un campo.
SHORT STRING	String
DBID	No se migra. Esta clase de campo se reserva para los campos de sistema en ClearQuest y no se requiere en los elementos de trabajo migrados.
Id.	String. Esta clase de campo se migra a Team Foundation como un campo vsts sourceid.
JOURNAL	No es aplicable Esta clase de campo se reserva para los campos de sistema en ClearQuest y se migra a Team Foundation como historial.
Estado	String. Esta clase de campo se reserva para los campos de sistema en ClearQuest y se migra a Team Foundation como campo State del sistema.

Asignaciones de campos

Cada tipo de elemento de trabajo de ClearQuest utiliza los campos de sistema, al igual que hay campos de sistema en los tipos de elemento de trabajo de Team Foundation. El convertidor asigna los campos de sistema de ClearQuest a los campos de sistema en Team Foundation según corresponda. Además de los campos de sistema hay también campos que se encuentran normalmente en los tipos de elemento de trabajo de ClearQuest. El convertidor los asigna a los campos de Team Foundation según corresponda.

La tabla siguiente especifica cómo el convertidor asigna los campos de sistema.

Campo de sistema de ClearQuest	Requisitos del sistema para Team Foundation
Id.	vsts sourceid
Estado	Estado

La tabla siguiente especifica cómo el convertidor asigna los campos comunes.

Campo de ClearQuest	Requisitos del sistema para Team Foundation
Headline	Title
Descripción	Descripción
Submitter	Created By
Submit_Date	Created Date
Owner	Assigned To
User_name (Historial)	Changed By
action_timestamp (Historial)	Changed Date

Controlar el comportamiento de los campos

Puede especificar el comportamiento de los campos en ClearQuest. También puede especificar un comportamiento distinto para los campos con estados diferentes de un elemento de trabajo. El convertidor tiene limitaciones a la hora de migrar el comportamiento en los elementos de trabajo de ClearQuest. Por ejemplo, el convertidor migra el comportamiento de campo especificado sólo en el estado inicial, es decir, el estado de un elemento de trabajo recientemente creado.

El comportamiento definido para los diferentes estados no se analiza ni se genera en la fase de análisis. Sin embargo, Team Foundation admite la especificación de estos comportamientos, que se pueden agregar manualmente a los tipos de elemento de trabajo después de la fase de análisis. Para obtener más información sobre cómo personalizar el comportamiento de los tipos de elementos de trabajo en Team Foundation, vea Definir el flujo de trabajo de elemento de trabajo.

El comportamiento del elemento de trabajo se migra como se especifica en la tabla siguiente.

Comportamiento	Descripción
Mandatory	Este comportamiento se migra a Team Foundation. Mandatory se especifica en Team Foundation aplicando el elemento <REQUIRED> a la definición del tipo de elemento de trabajo.
Optional	Este comportamiento se migra a Team Foundation. Optional es el comportamiento predeterminado de un campo en Team Foundation, por lo que no se necesita ningún elemento adicional en la definición del tipo de elemento de trabajo.
Sólo lectura	Este comportamiento no se migra.
Use_hook	Este comportamiento no se migra.

Campos agregados por el convertidor tipos de elemento de trabajo

El convertidor genera los campos siguientes en cada tipo de elemento de trabajo, además de los campos presentes en sus tipos de elementos de trabajo de ClearQuest.

Campos necesarios para la operación de conversión

No quite estos campos. Quitar estos campos de los tipos de elemento de trabajo hace que se produzcan errores en la migración. Puede quitarlos de la interfaz de usuario del elemento de trabajo (formulario) si no desea que se muestren. Recomendamos que mantenga estos campos como de sólo lectura para evitar que los usuarios los editen. Los campos son los siguientes:

• Campo para el id. de ClearQuest de un elemento de trabajo migrado.

  <FIELD name="vsts sourceid" refname="Microsoft.TeamFoundation.Converters.vsts_sourceid" type="String"/>
  

• Campo para la base de datos ClearQuest de donde proviene un elemento de trabajo migrado.

  <FIELD name="vsts sourcedb" refname="Microsoft.TeamFoundation.Converters.vsts_sourcedb" type="String"/>
  

• Campo utilizado para el seguimiento del estado de migración de un elemento de trabajo determinado.

  <FIELD name="Migration Status" refname="Microsoft.TeamFoundation.Converters.Migration_Status" type="String"/>
  

• Campos de sistema en Team Foundation. Cuando los campos de sistema en Team Foundation se asignan a los campos de sistema en ClearQuest, se genera el archivo xml de asignación adecuado. Algunos campos de sistema de Team Foundation no se asignan a los campos de sistema en ClearQuest y generan campos adicionales en cada tipo de elemento de trabajo. Estos campos se identifican con un comentario similar al archivo xml siguiente:

  <!--State is a core field in Team Foundation Work Item Tracking and we recommend that you use this field because it best suits the purpose-->
  

Control de los campos de lista

Los campos de ClearQuest pueden tener un conjunto de valores válidos o sugeridos definidos para ellos. Cuando el convertidor lee los campos y sus tipos, también recopila si el campo es un tipo de campo de lista. Si el campo es un tipo de campo de lista, el convertidor también recopila los valores de lista válidos o sugeridos. Esta información se captura en los archivos de definición de tipo de elemento de trabajo en la sección de campo correspondiente. Busque los elementos <AllowedValues> o <SugggestedValues>.

Control de estados y transiciones de estado

Las definiciones del tipo de entidad basadas en el estado del esquema de ClearQuest admiten lo siguiente:

• Un conjunto de estados.

• Transiciones entre los estados denominadas acciones.

• Comportamiento del campo asociado a los estados.

El convertidor captura los estados y acciones de ClearQuest como estados y transiciones de estado en las definiciones de tipo de elemento de trabajo de Team Foundation.

Control del formulario de elemento de trabajo

El convertidor no migra la información acerca del formulario de la base de datos ClearQuest a Team Foundation. El convertidor genera un formulario de elemento de trabajo predeterminado como parte del esquema generado durante la fase de análisis; sin embargo, este formulario predeterminado no tiene ninguna semejanza con el formulario original de ClearQuest. El formulario predeterminado contiene el formato mínimo y casi siempre exige que la edición sea un diseño del elemento de trabajo más utilizable. Para obtener información sobre cómo editar los formularios de elemento de trabajo, vea Definir el formulario del elemento de trabajo.

Controles del formulario

Puede colocar varios controles en un formulario de elemento de trabajo en ClearQuest, así como en Team Foundation. Team Foundation admite un conjunto predefinido de controles que puede utilizar. Algunos controles disponibles en ClearQuest no están disponibles en Team Foundation. Aunque se conserva la máxima cantidad de datos durante la migración, la diferencia en los controles disponibles afecta a la presentación de los datos en el formulario en Team Foundation. Los controles siguientes no se admiten en Team Foundation.

• Controles ActiveX

• Control Calendar

• Control Check-Box

• Control Combo-Box

• Control Duplicate Base

• Control Duplicate Dependents

• Control Parent/Child

• Control Picture

• Control Push Button

• Control List Box

• Control List view

• Control Option Button

• Control Static Text Box

Como parte del plan de migración, debe evaluar el efecto que la ausencia de estos controles podría tener en los usuarios.

Archivos de asignación de campos

El archivo de asignación de campos especifica cómo se asignan los campos y los valores.

Asignación de campos

Los archivos de asignación de campos especifican cómo se asignan los campos de ClearQuest a los campos de Team Foundation. La mayoría de los campos en ClearQuest, excepto los campos comunes y de sistema, se asignan uno a uno en Team Foundation. Debe mantener estos archivos de asignación de campos en sincronización con cualquier cambio realizado en los campos en los archivos de definición del tipo de elemento de trabajo. Por ejemplo, si cambia el nombre de un campo en el archivo de definición del tipo de elemento de trabajo, debe cambiar el archivo de asignación para especificar la misma asignación. Igualmente, si elimina algunos campos del archivo de definición del tipo de elemento de trabajo, debe eliminar esos campos del archivo de asignación de campos correspondiente.

Asignación de valores

Los archivos de asignación de campos también especifican cómo se transformarán los datos de los campos durante la migración. De forma predeterminada, no se genera ninguna asignación de valor. Puede especificar las asignaciones de valor si desea transformar los datos durante la migración. Estas transformaciones se especifican mediante asignaciones de valor para indicar que un valor como "Pri1" se debe asignar a "1".

El archivo de asignación de campos es un archivo XML. El ejemplo siguiente muestra cómo asignar campos y valores:

<?xml version="1.0"?>

<FieldMaps xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <!-- Title is a core field in Team Foundation Work Item Tracking and we recommend that you use this field because it best suits the purpose-->

  <FieldMap from="Headline" to="Title" />

  <FieldMap from="Submitter" to="Submitter">

    <ValueMaps refer="UserMap" />

  </FieldMap>

  <!-- Created Date is a core field in Team Foundation Work Item Tracking and we recommend that you use this field because it best suits the purpose-->

  <FieldMap from="Submit_Date" to="Created Date" />

  <!-- Assigned To is a core field in Team Foundation Work Item Tracking and we recommend that you use this field because it best suits the purpose-->

  <FieldMap from="Owner" to="Assigned To">

    <ValueMaps refer="UserMap" />

  </FieldMap>

</FieldMaps>

Para obtener más información sobre las asignaciones de campos, vea Esquema de archivo de asignaciones de campo.

Asignar a campos de ruta de acceso del área y ruta de acceso de iteración

El seguimiento de elementos de trabajo de Team Foundation organiza los elementos de trabajo en una jerarquía de áreas estructurales e iteraciones. Para obtener más información, vea Cómo: Modificar las áreas de un proyecto de equipo y Cómo: Modificar las iteraciones de un proyecto de equipo.

Las rutas de acceso se utilizan para ayudar a agrupar estructuralmente los elementos de trabajo de forma que representen los diversos componentes, proyectos o aplicaciones en los que su equipo trabaja. Las iteraciones se utilizan para ayudar a agrupar los elementos de trabajo según los eventos principales, como hitos y fases del proyecto. Los campos de sistema Area Path e Iteration Path definen esta información en Team Foundation. Como ClearQuest no tiene un concepto similar, el convertidor proporciona un valor predeterminado para estos campos; el comportamiento predeterminado es que todos los elementos de trabajo pasen a la raíz de la ruta de acceso del área o la ruta de acceso de la iteración.

Aunque ClearQuest no proporciona la ruta de acceso del área y la ruta de acceso de la iteración, es posible que los conceptos se estén utilizando de alguna otra manera. Por ejemplo, puede haber un campo en sus tipos de elemento de trabajo que denote el proyecto determinado al que un elemento de trabajo pertenece. Esto corresponde aproximadamente al concepto de ruta de acceso del área. De forma similar, puede tener otro campo denominado 'Fix By' que denota el hito por el que desea corregir un elemento de trabajo determinado. Considere la asignación de estos campos a la ruta de acceso del área de trabajo y la ruta de acceso de la iteración a fin de que el elemento de trabajo aparezca en estos nodos diferentes, en lugar de que aparezcan todos en un mismo nodo raíz. Las asignaciones se especifican en los archivos de asignación de campos del tipo de elemento de trabajo como se explicó anteriormente.

El ejemplo de archivo XML siguiente muestra cómo asignar un campo ClearQuest denominado Tree Path (Ruta de acceso del árbol) con valores posibles de Area1 y Area2.

<FieldMap from="Tree Path" to="Area Path" exclude="false">

<ValueMaps>

  <ValueMap from="Area1" to="Area1" />

  <ValueMap from="Area2" to="Area2" />

</ValueMaps>

</FieldMap>

El ejemplo de archivo XML siguiente muestra cómo asignar un campo ClearQuest denominado Fix By con valores posibles de Alpha y Beta.

<FieldMap from="Fix By" to="Iteration Path" exclude="false">

<ValueMaps>

  <ValueMap from= "Alpha" to="Alpha"/>

  <ValueMap from= "Beta" to="Beta"/>

</ValueMaps>

</FieldMap>

Archivo de asignación de usuarios

El archivo de asignación de usuarios especifica cómo se asignan los usuarios entre ClearQuest y Team Foundation. Para obtener más información, vea Esquema de archivo de asignaciones de usuarios.

Archivo de asignaciones del esquema

El archivo de asignaciones del esquema especifica el tipo de elemento de trabajo de origen, tipo de elemento de trabajo de destino, archivo de definición del elemento de trabajo y archivo de asignación de campos. Para obtener más información, vea Cómo: Editar el archivo de asignaciones del esquema.

Archivo de informe de análisis

Un archivo de informe de análisis se genera al final de la migración. El informe de migración se denomina CQAnalysisReport.xml y se genera en la carpeta donde se ejecutó CQConverter. Una carpeta asociada denominada _MigrationReport_Files contiene los archivos de imagen y una hoja de estilos para mostrar el informe en un explorador. Al final del análisis, debe abrir este archivo para ver cualquier error o advertencia que se haya encontrado durante la fase de análisis. El informe de análisis muestra lo siguiente:

• **Resumen   **Información de resumen sobre la ejecución del análisis.

• **Errores   **Cualquier error encontrado durante la ejecución del análisis. Debe tomar las medidas correctas para cualquier error mostrado.

• **Advertencias   **Cualquier advertencia encontrada durante la ejecución del análisis. Las advertencias requieren su atención, pero no son necesariamente algo que se deba corregir.

• Resultado   Esta sección muestra los archivos de resultados que se generaron.

Archivo de registro

El convertidor genera un archivo de registro denominado CQConverter.log. Este archivo se utiliza para depurar y normalmente no es necesario examinarlo. El archivo de registro se crea en la carpeta donde se ejecutó CQConverter. Contiene los mensajes de seguimiento y puede ser útil para depurar los problemas encontrados durante la ejecución del convertidor.

El nivel de seguimiento se controla estableciendo el valor del atributo MinLevelForAllSource en el archivo CQConverter.exe.config. El archivo CQConverter.exe.config se encuentra en la misma carpeta que CQConverter.exe. Puede establecer un valor entre 1, que es la menor cantidad de seguimiento, y 4, que es la mayor cantidad de seguimiento.

Nota:
Tenga en cuenta que el rendimiento del convertidor es más lento en los niveles de seguimiento mayores y el archivo de registro puede llegar a ser muy grande.

Archivo de errores

El convertidor también genera un archivo que contiene todos los errores encontrados durante su ejecución. El archivo se denomina ConverterErrors.txt y se genera en la misma carpeta donde se ejecutó CQConverter.

Vea también

Tareas

Cómo: Editar el archivo de asignaciones del esquema

Conceptos

Archivo de configuración del convertidor de elementos de trabajo

Referencia

Esquema de archivo de asignaciones de usuarios

Otros recursos

Personalizar tipos de elemento de trabajo

Definir el flujo de trabajo de elemento de trabajo

Definir el formulario del elemento de trabajo