Cómo: Generar el archivo de configuración del convertidor

Actualización: noviembre 2007

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

<ClearQuest>

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

• ConnectionName   Nombre de conexión de ClearQuest.

• UserDatabase   Nombre de la base de datos de ClearQuest.

• QueryName   Nombre de la 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 de Team Foundation Server o identificador uniforme de recursos (URI) completo en forma de http://MiServidor:MiPuerto.

  Si utiliza nombres descriptivos, asegúrese de que ha agregado el servidor de Team Foundation Server a través de Team Explorer antes de ejecutar el convertidor.

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

Otras opciones de configuración

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

• ExitOnError   Esta sección acepta un valor de True o False. Seleccione True para salir de los errores. Un valor de True significa que si surgen errores en la migración de algunos elementos de trabajo, el convertidor de ClearQuest se detiene.

  Nota:
  Esta configuración sólo se aplica a los errores no graves. Para errores graves como, por ejemplo, que el convertidor de ClearQuest no puede conectar con ClearQuest, el convertidor se cierra siempre incluso si este valor se establece como False.

• OutputDirectory   Especifica el directorio donde desea ubicar los archivos migrados. Si no especifica un directorio de resultados, el convertidor crea un directorio con un nombre de la entidad base para generar los archivos de salida. Si ya existe el directorio, el convertidor sobrescribe los archivos de ese directorio.

Permisos necesarios

Para realizar este procedimiento, debe tener los permisos Usuario activo y Administrador de la carpeta pública para la base de datos de ClearQuest. Para obtener más información, consulte el Manual del administrador de ClearQuest.

Para crear el archivo de configuración

1. Reúna la información siguiente:

   • Nombre de la conexión de ClearQuest.

   • Nombre de la base de datos de ClearQuest.

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

   • Nombre del servidor de Team Foundation.

   • 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 guarde la consulta. Guarde la consulta con cualquier nombre, por ejemplo TransitionQuery.

3. Seleccione un directorio para almacenar los archivos que se generan 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>JoseLugo</URI>
       <ProjectName>JoseLugoProjectX</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, en <QueryName>, especifique el nombre de la consulta como TransitionQuery, incluida la ruta de acceso de la consulta. Vea la sección "Archivo de configuración" en este tema para obtener información sobre el contenido que debe tener cada sección.

   Nota:
   La contraseña no se escribe en el archivo, la herramienta de conversión de ClearQuest la solicita después en el proceso de migración.

6. Guarde el archivo, por ejemplo, como CqConverterConfig.xml.

Nota:
Guarde el archivo utilizando la codificación UTF-8. Por ejemplo, si guarda el archivo mediante el Bloc de notas, seleccione UTF-8 en el cuadro Codificación del cuadro de diálogo Guardar como.

Vea también

Otros recursos

Esquema de definición del tipo de elemento de trabajo