Importación de un lote de registros de ClearQuest

El ClearQuest Connector incluye una herramienta de importación que permite crear los elementos correspondientes en un Jazz para un lote de registros de ClearQuest.
Por qué y cuándo se efectúa esta tarea
Por ejemplo, puede utilizar la herramienta de importación para crear elementos de trabajo de Rational Team Concert que se correspondan con un lote de defectos en una base de datos de usuarios de ClearQuest. Los nuevos elementos de trabajo se sincronizarán con los defectos. Los cambios que se realicen en un elemento de trabajo se propagarán al defecto correspondiente y los que se realicen en un defecto se propagarán al elemento de trabajo correspondiente.

La herramienta de importación utiliza los parámetros establecidos en el archivo cqconnector.properties. El asistente de Configuración de ClearQuest Connector actualiza el archivo cqconnector.properties basándose en las elecciones que se han realizado. También puede editar el archivo cqconnector.properties directamente para establecer los parámetros. Consulte el apartado Modificación de los parámetros de servicio de Connector para obtener una descripción de los diferentes parámetros. Ejecute la herramienta de importación varias veces, una vez por cada tipo de registro. Este método le permitirá comprobar que la sincronización de un tipo de registro se ha realizado satisfactoriamente antes de continuar con el siguiente tipo de registro.

Algunos tipos de registro pueden depender de otros. Deberá ejecutar primero la herramienta de importación en los tipos de registro de los que dependan otros. Por ejemplo, en el esquema DefectTrackingInterop de muestra, la sincronización del tipo de registro Defecto depende de la sincronización satisfactoria de los tipos de registro de proyecto y de usuario. Por lo tanto, utilice la herramienta de importación con los tipos de registro de usuario y de proyecto primero. Después de comprobar que la sincronización de esos tipos de registro se ha realizado satisfactoriamente, ejecute la herramienta de importación con el tipo de registro Defecto.

La sintaxis de la herramienta de importación es la siguiente:

synctool recordType=record-type-name jazzServer=url projectArea=project-area-name 

Para importar registros:

  1. Navegue hasta el directorio install-directory\gateway.
  2. Ejecute el mandato synctool. La herramienta de importación busca la carpeta de consultas a la que el parámetro cq.queryTreeRoot asigna un nombre en el archivo cqconnector.properties. Si encuentra una consulta en la carpeta de área de proyecto especificada, utiliza esa consulta para seleccionar los registros que se importarán. Si no existe ninguna consulta, la herramienta de importación seleccionará todos los registros de ese tipo. Si cuenta con un número muy grande de registros de ese tipo para importar, plantéese ejecutar la herramienta de importación varias veces, cambiando la consulta en cada ocasión, para que cada invocación seleccione un subconjunto del número total. Por ejemplo, es posible que desee ajustar la consulta para seleccionar registros en función de la fecha de creación. Asegúrese también de definir las consultas para que seleccionen únicamente los registros con los que tiene previsto trabajar en Rational Team Concert. Por lo general, no necesitará incluir registros con un estado cerrado.

    Cada vez que añada o elimine una consulta, o añada una regla de sincronización, deberá detener y reiniciar la pasarela ClearQuest para que el ClearQuest Connector utilice los nuevos criterios de sincronización.

    Ejemplo, en Windows®:

    synctool recordType="users" jazzServer="https://cqconnector:cqconnector@localhost:9443/jazz" projectArea="Reporting"

    En Linux®, utilice el mandato ./synctool para iniciar la línea de mandatos.

  3. Abra el cliente Rational Team Concert y compruebe que la herramienta de importación haya creado registros de usuario para los registros de ClearQuestseleccionados por la consulta. En la vista Artefactos de equipo, expanda la carpeta Mis áreas de equipo. Efectúe una doble pulsación en el área de equipo para abrirla. En el área Miembros pulse Añadir para añadir los nuevos usuarios al área de equipo. Para asignar roles a los usuarios, seleccione cada usuario en la tabla Miembros y pulse Roles de proceso.
  4. Ejecute el mandato synctool especificando un tipo de registro diferente. Por ejemplo, el tipo de registro Proyecto.
  5. En el cliente Rational Team Concert, compruebe que la herramienta de importación ha creado los elementos de categoría correspondientes para los registros de proyecto de ClearQuest seleccionados por la consulta. En la vista Artefactos de equipo, pulse con el botón derecho del ratón sobre el área de proyecto y seleccione Abrir. En el editor Área de proyecto, pulse sobre la pestaña Categorías de elemento de trabajo. Seleccione la categoría que se corresponda con el registro de proyecto de ClearQuest. Seleccione el área de equipo que desee asociar con la categoría. Pulse Asociar. Repita este paso para cada categoría que la herramienta de importación haya creado para hacerla corresponder con los registros de proyecto de ClearQuest. Pulse Guardar para guardar el cambio del área de proyecto. Una vez asociada una categoría con un área de equipo, los elementos de trabajo con esa propiedad de categoría se asociarán con el equipo adecuado.
  6. Ejecute el mandato synctool especificando un tipo de registro diferente. Por ejemplo, el tipo de registro Defecto.
  7. En el cliente Rational Team Concert, compruebe que la herramienta de importación ha creado los elementos de trabajo correspondientes para los defectos ClearQuest seleccionados por la consulta.
Resultados
Si la herramienta de importación selecciona un registro que se encuentra actualmente sincronizado con un área de proyecto diferente en el mismo servidor Jazz Team Server,desconectará ese registro de esa área de proyecto para poder sincronizarlo con el área de proyecto que se haya especificado en la línea de mandatos.

Comentarios

¿Le ha servido de ayuda? Puede incluir sus comentarios en Jazz.net (registro obligatorio): Comentarios en el foro o envíe un error