Para poder crear reglas de sincronización, deberá analizar antes el tipo o tipos de registro
de ClearQuest que desea sincronizar con los elementos de trabajo de Rational Team Concert
y crear un plan para correlacionar los campos de los tipos de registro con las propiedades de
los elementos de trabajo.
Por qué y cuándo se efectúa esta tarea
En un plano ideal, la persona que planifique y cree las reglas de sincronización debería ser
la misma que ha creado o se encarga del mantenimiento del esquema de ClearQuest.
También es necesario tener conocimientos básicos de Jazz y estar familiarizado con las áreas de proyecto y los elementos de trabajo.
No resulta práctico correlacionar cada tipo de registro con un tipo de elemento de
trabajo. Los dos tipos deben ser similares en cuanto a finalidad, campos obligatorios y
modelo de transición de estados. Revise todos los tipos de registro definidos en el esquema para la
base de datos de usuarios que desee conectar con un área de proyecto de Jazz e identifique qué tipos de registro resultan idóneos para la sincronización.
Puede
utilizar el asistente Configuración de ClearQuest Connector
para crear versiones iniciales de reglas de sincronización,
pero necesita editar esas reglas para especificar detalles
de correlación adicionales. Como mínimo, debe editar las reglas de sincronización
para especificar cómo establecer la propiedad Categoría de los elementos de trabajo.
A medida que avance a través de
los distintos pasos relacionados con la planificación que se mencionan más abajo, registre la información
acerca del tipo de registro en la hoja de trabajo adjunta. Cree una hoja de trabajo por cada tipo de registro que tenga previsto
sincronizar. Utilice la hoja de trabajo cuando empiece a
crear o editar reglas de sincronización.
Si utiliza el asistente Configuración de ClearQuest Connector para crear
versiones iniciales de reglas de sincronización, abra esas reglas de sincronización
en el editor de reglas de sincronización; compare los detalles de correlación con los
requisitos de la hoja de trabajo de planificación e identifique los vacíos.
Para planificar las reglas de sincronización:
- Utilizando el tipo de elemento de trabajo Historia de Rational Team Concert
desarrolle el caso de uso que describa la forma en que el equipo tiene previsto
trabajar en Rational Team Concert.
El tipo de elemento Historia debe indicar el proceso (como Scrum) y los flujos de trabajo
que el equipo tiene la intención de utilizar.
- En función del tipo de elemento Historia, identifique qué tipo o tipos de registro de ClearQuest sincronizará con qué tipos de elemento de trabajo. Si ninguno de los elementos de trabajo de Rational Team Concert
predefinidos presenta coincidencias con un tipo de registro de ClearQuest
con el que desee realizar la sincronización, puede crear un tipo de elemento de trabajo que se corresponda con ese tipo de registro.
- Se puede correlacionar un tipo de registro ClearQuest con varios tipos de elemento de trabajo.
Por ejemplo, el tipo de registro puede ser general, como Petición de cambio, e incluir
un campo que lo califique como Error o Requisito de release. Si se encuentra en este caso,
indique el nombre del campo de ClearQuest que utilizará para calificar
el tipo de registro y enumere los valores de campo y sus correspondientes
tipos de elemento de trabajo.
- Defina el sentido de la sincronización entre el tipo de registro
y el tipo de elemento de trabajo. Si tiene previsto importar un conjunto de registros desde una base de datos de usuarios de ClearQuest a un Jazz,
y tiene su equipo de trabajo únicamente en Rational Team Concert,
el sentido de la sincronización será solo Dentro. Si tiene previsto trabajar tanto en
Rational Team Concert como en Rational ClearQuest,
la sincronización será Dentro y Fuera.
- Identifique el conjunto de campos obligatorios del tipo de registro de ClearQuest y el tipo de elemento de trabajo correspondiente. Si utiliza el proceso Scrum, los tipos de
elemento de trabajo Defecto y Tarea requerirán entradas únicamente en los campos
Resumen y Archivado en relación a (Categoría). En la página Visión general del editor
Elemento de trabajo, los campos obligatorios están identificados por un asterisco.
Para
ver los campos obligatorios del tipo de registro de ClearQuest, abra el
esquema en ClearQuest Designer.
Pulse . En el asistente
Abrir esquema, seleccione el esquema del tipo de registro que desee sincronizar.
En el panel de navegación, expanda la carpeta Tipos de registro,
la carpeta de tipos de registro específicos y, a continuación, la carpeta Estados y acciones.
Efectúe una doble pulsación en Comportamientos. La matriz Comportamientos identifica los
campos necesarios como Obligatorio.
- Para cada uno de los campos necesarios de ClearQuest, identifique un campo
de tipo de elemento de trabajo con el que pueda correlacionar el campo de ClearQuest. De forma similar, para cada campo de tipo de elemento de trabajo necesario, identifique
un campo de ClearQuest correspondiente.
Al seleccionar un campo de correlación adecuado, tenga en cuenta el significado del campo
y el tipo. Para ver los tipos de campo de los tipos de registro ClearQuest, abra el esquema del tipo de registro en ClearQuest Designer. En el panel de
navegación, expanda la carpeta Tipos de registro, la carpeta de
tipos de registro específicos y, a continuación, efectúe una doble pulsación en Campos para
abrir la matriz Campos.
Para ver tipos de campo en Rational Team Concert,
inicie una sesión en el
cliente Rational Team Concert.
En la vista Artefactos de equipo, efectúe una doble pulsación en el área de proyecto
para abrirla en el editor Área de proyecto. Pulse sobre la pestaña Configuración de proceso.
Expanda Configuración de proyecto, a continuación, Datos de
configuración y, por último, Elementos de trabajo. Pulse Presentaciones
de editor. Seleccione la presentación de editor del tipo de elemento
de trabajo que se va a sincronizar. En el área Presentación de editor,
expanda las pestañas y las secciones para ver la lista de presentaciones (campos). El tipo
aparece entre paréntesis después de cada nombre de campo.
- Si el tipo de elemento de trabajo no tiene los campos adecuados para correlacionarlo
con algunos de los campos de tipo de registro de ClearQuest necesarios, cree nuevos campos en el tipo de elemento de trabajo. En la página Configuración de proyecto,
expanda Configuración de proyecto, a continuación, Datos de
configuración y, por último, Elementos de trabajo. Pulse Tipos.
Seleccione la categoría del tipo de elemento de trabajo. En el área Atributos personalizados,
pulse Añadir. Escriba un nombre para el campo y seleccione
un tipo que sea compatible con el tipo de campo de ClearQuest correspondiente. Pulse Aceptar.
Pulse Guardar para guardar los cambios del tipo de elemento de trabajo.
- Si el tipo de registro no tiene los campos adecuados para correlacionarlo con
algunos de los campos de tipo de elemento de trabajo necesarios, cree nuevos campos en el tipo
de registro añadiendo filas en la matriz Campos.
- Durante la sincronización entrante, es necesario establecer la propiedad de categoría
de un elemento de trabajo porque éste se encuentra asociado con un espacio de trabajo en
función de su categoría. Puede proporcionar información acerca de las categorías en Rational Team Concert de varias formas:
- Conecte un registro de ClearQuest sin estado con una categoría.
- Correlacione uno o varios campos con valor de serie de registros de ClearQuest con una categoría
- Correlacione un valor externo vacío con una valor de categoría fija.
- Correlacione, pero no conecte, uno o varios registros de ClearQuest con una categoría
Consulte el apartado Edición de reglas de sincronización para especificar categorías para
obtener detalles acerca de estos métodos y seleccione uno para utilizarlo.
- Identifique cualquier campo de registro de ClearQuest no necesario que desee sincronizar con los campos de elemento de trabajo. Identifique los campos de elemento de trabajo
correspondientes. Si resulta necesario, cree campos en el tipo de elemento de trabajo añadiendo atributos
personalizados.
- Identifique cualquier campo de registro de ClearQuest que desee mostrar en el elemento de trabajo, pero no sincronizar con un campo de elemento de trabajo.
- ¿Alguno de los campos que desea sincronizar tiene listas de elecciones de
valores, como un campo Prioridad o Gravedad? Para estos tipos de campo, identifique
la correlación de valores desde el campo de registro de ClearQuest al campo de
elemento de trabajo. Si no existe ninguna correlación uno a uno de todos los valores, designe una como
valor predeterminado.
- ¿Alguno de los campos que desea sincronizar requiere un tratamiento especial
al transformar sus valores para que éstos puedan enviarse a sus campos
de elemento de trabajo correspondientes o a los campos de registro de ClearQuest?
ClearQuest Connector ofrece
los siguientes transformadores de valores.
Tabla 1. Transformadores de ClearQuest Connector| Nombre de transformador |
Descripción |
| Conexión de campo a transformador de atributos personalizados |
Correlaciona el valor de un atributo personalizado de un elemento de trabajo
con un campo de un registro de ClearQuest
al que hace referencia un campo de otro registro. |
| Transformador de detalles de colaborador |
Actualmente no se utiliza con el ClearQuest Connector. |
| Visualización de campos de registro referenciado en transformador
de atributos personalizados |
Correlaciona los contenidos de un registro referenciado de ClearQuest
con un atributo personalizado de elemento de trabajo para que los contenidos puedan mostrarse en el
editor de elementos de trabajo. |
| Transformador de área de proyecto |
Actualmente no se utiliza con el ClearQuest Connector. |
| Transformador de días/indicador de fecha y hora |
Convierte una serie que identifica el número de días en un
registro de ClearQuest
en el número de milisegundos, que es el que el indicador de fecha y hora utiliza para determinar
el tiempo. |
| Transformador de acciones de elemento de trabajo |
Calcula la acción que es necesario llevar a cabo al realizar una transición
de un estado a otro durante la sincronización entrante. Esto resulta necesario si la definición de flujo de elementos de trabajo de Rational Team Concert contiene
transiciones ambiguas de estados donde hay más de una acción posible
al realizar una transición entre dos estados. A diferencia de los tipos de registro de Rational ClearQuest, los tipos de elemento de trabajo de Rational Team Concert permiten
más de una acción al realizar una transición de un estado a otro. Si no utiliza el Transformador de acciones de elemento de trabajo para sincronizar elementos que
contengan varias acciones para transiciones de estado, las operaciones de sincronización
que sigan a una transición de estado generarán un error indicando que no se puede realizar la transición
del estado del registro de ClearQuest.
|
| Transformador de anexos de elemento de trabajo |
Convierte un anexo de Rational Team Concert
en un anexo de registro de ClearQuest. |
| Transformador de categorías de elementos de trabajo |
Mantiene la estructura jerárquica de las categorías de Rational Team Concert correlacionadas con los registros de ClearQuest cuando el valor
es una vía de acceso. |
| Transformador de comentarios de elemento de trabajo |
Convierte un comentario de Rational Team Concert en una nota de registro de ClearQuest. Debe utilizar
el paquete estándar de Notes que se proporciona con
Rational ClearQuest. |
| Transformador de códigos de elemento de trabajo |
Transforma los códigos de un elemento de trabajo en palabras clave de un registro de ClearQuest. |
Identifique los campos que requieren transformación y enumere los
transformadores necesarios.
- Si el tipo de registro incluye anexos, puede crear una regla de sincronización
para que cuando se sincronice un registro de ClearQuest con un elemento de trabajo, se sincronicen también todos los anexos del registro y el elemento de trabajo. Indique si
tiene previsto sincronizar anexos.
- Identifique todos los campos de registro de ClearQuest que tenga previsto sincronizar que sean campos de tipo de referencia. Deberá crear reglas de sincronización para los
tipos de registro a los que hacen referencia estos campos.
- ¿Alguno de los campos de registro de ClearQuest que tiene previsto sincronizar tienen ganchos que establezcan dependencias con otros campos? Por ejemplo, un gancho
asociado con un campo podría utilizar el valor que especifique un usuario en ese campo
para determinar cómo establecer el valor de otro campo. En este escenario,
debe identificar el orden en el que deberán ejecutarse los ganchos para asegurarse
de que se establecen los valores correctos en los
campos de registro de ClearQuest.
El archivo cqconnector.properties
incluye un parámetro, cq.orderedProperties.tipo-registro, que puede utilizarse
para especificar el orden en el que deben establecerse los valores de campo de registro de ClearQuest. Todos los campos que no especifique con cq.orderedProperties.record-type se
procesarán después de los campos especificados.
Otra forma de especificar el orden es
utilizar la propiedad Campos dependientes de web de los campos
de definición de formulario en ClearQuest Designer. Si especifica la propiedad
Campos dependientes de web y el parámetro cq.orderedProperties, el ClearQuest Connector utilizará
el orden especificado con el parámetro cq.orderedProperties.