BuildForge puede trabajar con Rational ClearQuest para actualizar registros de compilación.
Build Forge tiene dos integraciones con ClearQuest:
- Creación automática de registros de compilación o actualización basada en estados de trabajo.
Esta posibilidad se activa automáticamente cuando las variables de entorno necesarias se establecen
en el entorno del proyecto.
- Adaptadores de ClearQuest
Estas prestaciones son completamente independientes entre sí. Concretamente,
el adaptador está asociado a un entorno creado para él. Las variables de dicho entorno son independientes
de las variables establecidas para activar registros de compilación automáticos.
Configuración de generación automática de registros de compilación
El sistema puede crear automáticamente registros de compilación en su base de datos IBM Rational® ClearQuest®,
con enlaces a los datos de registro. Además, cuando un trabajo termina con éxito, el sistema puede
actualizar la base de datos ClearQuest, registrando que el trabajo ha sido completado, la hora de finalización
y un resumen de los pasos que se lograron concluir.
Esta prestación requiere
Rational ClearQuest versión 7.0 o posterior.
Cuando configure un proyecto para que actualice una base de datos ClearQuest, el sistema crea o actualiza registros de compilación según se indica a continuación:
- Inicio de trabajo
- Cuando el sistema lanza un trabajo, el sistema crea un registro de compilación ClearQuest. El registro de compilación se encuentra en el estado Sometido e incluye el URL de registro del trabajo,
la hora de inicio, el nombre de release y el ID así como una entrada de registro indicando "Compilación XYZ iniciada". Si un adaptador de control de origen cancela el trabajo (por ejemplo, porque no
se encuentran cambios de origen), no se crea ningún registro de compilación ClearQuest.
Nota: Si un proyecto encadena a
otro proyecto, el nuevo proyecto obtiene su propio y único ID de compilación ClearQuest.
- Éxito/anomalía del trabajo
- Cuando un trabajo concluye con éxito o falla, el sistema cambia el estado de compilación dentro de
ClearQuest a Completado o Anómalo, establece la hora de finalización de la compilación y almacena un resumen
de los pasos del trabajo en el registro de compilación de ClearQuest. El resumen incluye el nombre,
estado del resultado y servidor por cada paso.
- Reinicio del trabajo
- Cuando se reinicia un trabajo, el sistema cambia el estado de compilación dentro de
ClearQuest a Sometido y crea una entrada de registro de compilación de ClearQuest indicando “Compilación XYZ
reiniciada.”
La configuración automática de registros de compilación se realiza
mediante variables de entorno especiales. Para enlazar un proyecto a una base de datos ClearQuest, asegúrese de que las siguientes
variables se han incluido en el entorno del proyecto.
Nota: Estas variables deben estar presentes en el entorno de proyecto.
Añadirlos a un paso no es suficiente. Sin embargo, puede utilizar una variable que
esté establecida en el tipo Incluir que incluya estas variables
mediante otro entorno. Además, puesto que el valor CQ_RELEASE_NAME es el único que probablemente variará
por proyecto, puede que desee crear un entorno que contenga otras variables y, a continuación,
utilizar una variable del tipo Incluir para incluir dicho entorno en el entorno del proyecto,
donde podrá especificar también
CQ_RELEASE_NAME como una variable de entorno específica del proyecto.
Para activar las actualizaciones automáticas de registros de compilación desde
trabajos de Build Forge, se deben establecer las variables de entorno siguientes para el
proyecto. No funcionan a nivel de paso.
Variable
|
Descripción
|
CQ_DBNAME
|
Necesario. Nombre de la base de datos ClearQuest que quiere actualizar.
|
CQ_DBSET
|
El valor establecido de la base de datos ClearQuest. No es obligatoria. El valorpredeterminado es en blanco.
|
CQ_INTERACTION
|
Si su entorno de proyecto tiene las variables correctas de entorno definidas para
habilitar la creación de un registro de compilación ClearQuest y no
quiere crear un registro de compilación, establezca esta variable en OFF para inhabilitar
la creación de registros de compilación.
Para habilitar la creación de registros de compilación,
establezca esta variable de entorno en ON.
Nota: Si está utilizando uno de los adaptadores de ClearQuest,
establezca esta variable de entorno en OFF. El adaptador interactúa con los registros de compilación directamente.
|
CQ_PASSWORD
|
Necesario. Contraseña para utilizar cuando se inicia sesión en la base de datos ClearQuest. No requerido; valor predeterminado en blanco.
|
CQ_RELEASE_NAME
|
Necesario. El nombre del release dentro de la base de datos ClearQuest
que quiere actualizar.
|
CQ_USER
|
Necesario. Nombre de usuario que utilizar al iniciar la sesión en la base de datos
ClearQuest.
|
Requisitos de configuración adicionales para los adaptadores de ClearQuest
Las
plantillas de ejemplo de adaptadores de ClearQuest proporcionan métodos de explorar ClearCase y
actualizar los registros de compilación de ClearQuest. Esto se enlaza normalmente con
el éxito o anomalía de las ejecuciones de compilación de Build Forge. Para requisitos generales,
consulte Requisitos de los adaptadores. Además es
necesario realizar la configuración siguiente.
- Acceda a ClearCase para explorar el origen. Durante una ejecución
de trabajo, el adaptador ejecuta mandatos de cleartool a través de un
agente y el cliente de ClearCase. El adaptador ejecuta mandatos mediante
la API de Perl de ClearQuest (cqperl).
- Acceda a ClearQuest para actualizar los registros de complilación. Durante
la ejecución del trabajo, el adaptador ejecuta scripts de cqperl directamente en
el host de la consola. Los interpreta el programa de utilidad Cqperl y se ejecutan
a través del cliente de ClearQuest; ambos están instalados en el host de la consola.
Haga lo siguiente:
- Instale un agente de Build Forge en un host que pueda conectarse al servidor ClearCase.
- Instale el cliente completo de ClearCase en el host del agente.
- Configure el entorno para el agente de forma que se puedan ejecutar mandatos a través del cliente ClearCase.
- Instale el cliente completo ClearQuest en el host de la consola de Build Forge.
- Añada el directorio de cqperl (la API de Perl de ClearQuest) a la vía de acceso del sistema.
- Defina una conexión que el cliente de ClearQuest del host de Build Forge
pueda utilizar para acceder a la base de datos de ClearQuest. Lleve a cabo estas
acciones en el host del cliente de ClearQuest.
- Utilice el mandato cqreg para añadir el conjunto de la base de datos (cqreg add_dbset).
- Utilice la herramienta de mantenimiento de ClearQuest para definir una conexión a la base de datos
de ClearQuest.
- Determine cómo implementar y cómo y cuándo iniciar las vistas de ClearCase necesarias.

No es necesario instalar el agente. El adaptador ClearQuest
se comunica directamente con ClearQuest por medio del cliente, usando la API de Perl de ClearQuest.
Importante: el adaptador de ClearQuest se puede invocar sólo con un mandato de punto en un paso. No es un
adaptador de origen, por lo que no se puede utilizar un enlace de adaptador.
Ejemplos de plantilla de adaptador de ClearQuest
Se proporcionan los ejemplos de plantilla de
adaptador siguientes:
- ClearQuestBaseClearCaseByDate
- Consulta en una vista ClearCase si ha habido cambios entre dos fechas. Las fechas predeterminadas son la indicación de fecha actual y la indicación de fecha de la ejecución de adaptador previa.
- Por cada archivo cambiado, busca un atributo de hiperenlace de CrmRequest
que identifique un ID de cambio de ClearQuest. Intenta resolver el cambio de ID
añadiendo información del trabajo con el fin de resolver el registro defectuoso en ClearQuest,
siempre que el estado de ClearQuest lo permita resolver.
- Por cada archivo cambiado, registra la siguiente información en el informe BOM:
el nombre del archivo, ID de defecto,
estado de defecto y cualquier error de ClearQuest.
Variables definidas en la plantilla de adaptador:
- CurDate
- LAST_RUN
- VIEW
- VOB_PATH
- CQ_USER
- CQ_PASSWORD
- BFSERVER
- UNIXCLIENT
- _CHAR_NATIVE
- ClearQuestClearCaseByActivity
- Encuentra los registros defectuosos de ClearQuest asociados con una lista de actividades de
ClearCase.
- Por cada registro defectuoso encontrado, añade información del trabajo para
resolver el registro defectuoso dentro de ClearQuest, siempre que el estado de ClearQuest lo permita resolver.
- Registra la siguiente información en el informe BOM:
archivos asociados con los ID de actividad de ClearCase y el estado defectuoso de ClearQuest.
Variables definidas en la plantilla de adaptador:
- CurDate
- VIEW
- VOB_PATH
- ACTIVITIES
- CQ_USER
- CQ_PASSWORD
- PROJECT_VOB
- BFSERVER
- UNIXCLIENT
- _CHAR_NATIVE
- ClearQuestUCMClearCaseByDate
- Consulta en una vista ClearCase si ha habido cambios entre dos fechas. Las fechas predeterminadas son la indicación de fecha actual y la indicación de fecha de la ejecución de adaptador previa. Utiliza la Gestión unificada de cambios (UCM) de Rational para producir estos resultados.
- Por cada archivo cambiado, registra la siguiente información en el informe BOM:
el nombre del archivo, ID de defecto,
estado de defecto y cualquier error de ClearQuest.
Variables definidas en la plantilla de adaptador:
- CurDate
- LAST_RUN
- VIEW
- VOB_PATH
- CQ_USER
- CQ_PASSWORD
- BFSERVER
- UNIXCLIENT
- _CHAR_NATIVE
Variables de adaptador de ClearQuest
Esta tabla es una referencia para las listas de variables
para las plantillas de adaptador.
Tabla 1. Variables de entorno requeridas para
la integración de Rational ClearQuest Variable
|
Descripción
|
ACTIVITIES |
Para el adaptador ClearQuestClearCaseByActivity, un conjunto de ID de actividad delimitados según el espacio.Ejemplo: SAMPL0001@\ProjectVob |
BFSERVER |
Establezca esta variable en el nombre del host para la consola de Build Forge. |
CQ_PASSWORD
|
Necesario. Contraseña para utilizar cuando se inicia sesión en la base de datos ClearQuest. No requerido; valor predeterminado en blanco.
|
CQ_USER
|
Necesario. Nombre de usuario que utilizar al iniciar la sesión en la base de datos
ClearQuest.
|
CurDate |
Pone la fecha actual al adaptador. Utiliza un mandato .date
para generar la fecha. No cambie este valor. |
LAST_RUN |
Para los adaptadores ByDate, el sistema utiliza este valor para determinar si se han producido cambios; el valor es la fecha de la última ejecución con éxito.
Puede manipular este valor al probar el adaptador para forzarlo a que se ejecute tomando como referencia una fecha que sabe que es anterior a algunos cambios. Si el adaptador permite que a ejecución
continúe, actualiza automáticamente este valor a la fecha actual. El valor predeterminado es 1-Enero-05.00:00:00. |
UNIXCLIENT |
Se utiliza para establecer la información específica de plataforma. Establecer en 0 si
el cliente se ejectua en Windows. Establecer en 1 si el cliente se ejecuta en UNIX o Linux. |
VIEW |
Defina esta variable con el nombre de la vista ClearCase que quiere utilizar con el adaptador. |
VOB_PATH |
Defina este valor con el nombre del componente
VOB, y opcionalmente, sus subdirectorios. Usar una lista separada por comas para varios nombres. |
_CHAR_NATIVE |
Se utiliza internamente, y siempre se establece en 1. |
Reinicio de trabajos integrados con ClearQuest
Una vez se ha completado un trabajo integrado con ClearQuest, normalmente no es posible reiniciarlo en Rational Build Forge.
Como método alternativo simple, puede iniciar el trabajo como un nuevo trabajo.
Para poder habilitar el reinicio, debe editar el esquema de ClearQuest con la herramienta ClearQuest Designer.
El flujo de trabajo para los registros de Build se debe modificar para permitir un estado de transición entre Completado y Enviado.