Planificación de reglas de sincronización

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:

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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 Inicio > Todos los programas > IBM Rational > IBM Rational ClearQuest > ClearQuest Designer. 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.

  6. 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.

  7. 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.
  8. 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.
  9. 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.

  10. 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.
  11. 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.
  12. ¿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.
  13. ¿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.

  14. 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.
  15. 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.
  16. ¿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.


Comentarios

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