Creación de reglas de sincronización

Necesita crear reglas de sincronización para los tipos de registro de ClearQuest que tenga previsto correlacionar con elementos de Rational Team Concert.
Antes de empezar

Puede utilizar el asistente Configuración de ClearQuest Connector para crear reglas de sincronización o plantillas de reglas de sincronización. Sin embargo, después de utilizar el asistente para generar reglas de sincronización, seguirá siendo necesario revisar y modificar las reglas antes de que estén preparadas para utilizarse. Este tema describe cómo crear y modificar reglas utilizando el editor de Regla de sincronización en el cliente Eclipse de Rational Team Concert.

Para poder crear, modificar y suprimir reglas de sincronización debe tener asignada una licencia de acceso de cliente de desarrollador o de ClearQuest Connector. Además, el área de proyecto debe estar configurada para conceder permisos a su rol de usuario. Para establecer permisos, abra el área de proyecto, pulse sobre la pestaña Configuración de proceso; pulse Configuración de proyecto > Permisos; seleccione un rol y Conectores de elementos en la lista Acciones permitidas.

Asegúrese de iniciar la pasarela ClearQuest antes de crear una regla de sincronización; de lo contrario, las listas del editor de Regla de sincronización no se rellenarán con los campos de los tipos de registro de ClearQuest.

Por qué y cuándo se efectúa esta tarea
Consulte el apartado Planificación de reglas de sincronización para obtener más detalles acerca de la creación de una hoja de trabajo de planificación antes de crear reglas de sincronización. Además de los temas de esta sección, consulte https://jazz.net/wiki/bin/view/Main/WritingSyncRules para ver ejemplos de correlación de tipos de campo de registro de ClearQuest con propiedades de elementos de Rational Team Concert.

Para crear una regla de sincronización:

  1. Inicie una sesión en el cliente Rational Team Concert.
  2. En la vista Artefactos de equipo, pulse con el botón derecho del ratón sobre la conexión al repositorio y seleccione Administrar > Reglas de sincronización. En la vista Reglas de sincronización, pulse con el botón derecho del ratón sobre el área de proyecto y seleccione Nueva > Regla de sincronización. Para editar una regla de sincronización existente, expanda el nodo de área de proyecto para ver las reglas de sincronización. Efectúe una doble pulsación en una regla para abrirla en el editor de Regla de sincronización.
  3. En el editor de Regla de sincronización, escriba un nombre exclusivo para la regla en la propiedad Nombre. El uso de un convenio de denominación similar al de la asignación de nombres a paquetes de Java™ es la única forma de garantizar que se asignarán nombres exclusivos. Por ejemplo: com.sapphire.clearquest.SchemaName.RecordType, donde SchemaName es el nombre del esquema de ClearQuest y RecordType es el nombre del tipo de registro en ese esquema que desea sincronizar.
  4. En la sección Correlación de tipos, seleccione el tipo de elemento que desea sincronizar con el tipo de registro de ClearQuest. La propiedad Gestor de elementos se establece como el gestor encargado de crear y sincronizar el tipo de elemento seleccionado. En el campo Repositorio externo, seleccione la conexión a repositorio externo que se utilizará al procesar esta regla de sincronización. Seleccione Gestor ClearQuest (registros de no usuario) como Gestor externo para todos los tipos de registro, excepto el de usuarios. Para el tipo de registro de usuarios, seleccione Gestor ClearQuest (registros de usuario). Nota: dado que los elementos de usuario de Rational Team Concert no pertenecen a un área de proyecto, solo podrá tener una regla de sincronización para el tipo de registro de usuarios por Jazz Team Server. En el campo Tipo externo, seleccione el tipo de registro de ClearQuest que desee sincronizar con el elemento de Rational Team Concert.

    Cuando se crea un elemento de trabajo, el campo Tipo es obligatorio. Las reglas de sincronización que cree para correlacionar tipos de registro con elementos de trabajo deben indicar cómo establecer el valor del campo Tipo del elemento de trabajo. Para obtener más detalles, consulte el apartado Correlación de tipos de registro con tipos de elemento de trabajo.

  5. En la sección Áreas de equipo habilitadas, seleccione y deseleccione áreas de equipo para limitar el ámbito de la regla de sincronización. De forma predeterminada, todos los elementos de Rational Team Concert asociados con un área de proyecto que tenga reglas de sincronización son candidatos a la sincronización saliente. Es posible que desee crear registros de ClearQuest solo para elementos asociados con determinadas áreas de equipo. Si se selecciona un espacio de trabajo padre, también se seleccionarán todas sus áreas de equipo hijas. Puede seleccionar un área de equipo hija sin seleccionar su área de equipo padre.
  6. Utilice el campo Recuento de número máximo de ciclos para especificar el número de ciclos de sincronización que el ClearQuest Connector debería intentar antes de que falle la operación de sincronización. Al escribir una regla de sincronización para un tipo de registro con estado, seleccione Sincronizar todos los estados de elemento. Para los tipos de registro sin estado, no seleccione Sincronizar todos los estados de elemento .
  7. En la sección Correlaciones de propiedad especifique qué propiedades de elemento de trabajo se correlacionan con qué campos de tipo de registro de ClearQuest. Pulse Añadir para crear una correlación. Seleccione una propiedad de elemento y una propiedad externa correspondiente (campo de tipo de registro de ClearQuest). Para correlacionar una relación de elementos de trabajo, seleccione una de las siguientes propiedades de elemento: Relacionados, Bloques, DependeDe, Padre o Hijos. A continuación, seleccione la propiedad externa que hace referencia al registro de ClearQuest relacionado. En lugar de añadir correlaciones una a una, puede pulsar el botón Inicializar para crear un conjunto inicial de correlaciones en función de los nombres de propiedad coincidentes, o parcialmente coincidentes. A continuación, puede avanzar por la lista y eliminar o editar las correlaciones según resulte necesario.

    La sección Detalles de correlación muestra los detalles de la correlación seleccionada en la tabla Correlaciones de propiedad. Para borrar una entrada en el campo Propiedad de elemento o Propiedad externa, seleccione Ninguna en Propiedad de elemento o en Propiedad externa. Utilice el campo Sincronización para especificar el sentido de la sincronización. La opción Dentro/fuera habilita la sincronización bidireccional. La opción Dentro habilita la sincronización solo desde la base de datos de usuarios de ClearQuest a los elementos de Rational Team Concert. La opción Fuera habilita la sincronización solo desde los elementos de Rational Team Concert con la base de datos de usuarios de ClearQuest. La opción Identificador de elemento se selecciona cuando la propiedad se utiliza como la clave de búsqueda para correlacionar un elemento con un registro de ClearQuest. La opción Identificador externo se selecciona cuando el campo de ClearQuest se utiliza como clave de búsqueda para correlacionar un registro de ClearQuest con un elemento de Rational Team Concert. Por lo general, no tendrá que establecer los valores de los campos Identificador de artículo ni de Identificador externo. Suponiendo que la pasarela ClearQuest esté en ejecución, el editor de Regla de sincronización establece valores para estos campos cuando es necesario.

    De forma predeterminada, cuando se sincronizan los cambios en los registros de ClearQuest con los elementos de Rational Team Concert, la operación de actualización se ejecuta utilizando la cuenta de usuario de Jazz que la pasarela ClearQuest utiliza para iniciar una sesión en el Jazz. El campo Modificador externo permite configurar la regla de sincronización para que los cambios se registren en el contexto del usuario que los realiza. Para obtener más detalles, consulte el apartado Configuración de reglas de sincronización para usuarios externos.

    Si un valor de propiedad es una referencia a otro objeto que tenga una regla de sincronización definida, seleccione esa regla de sincronización en la lista Regla de sincronización de referencia. Por ejemplo, si el tipo de registro Defecto de ClearQuest contiene un campo con una referencia al tipo de registro de usuarios, seleccione la regla de sincronización para el tipo de registro de usuarios. Durante la sincronización, se procesa esa regla de sincronización y se establece una referencia desde el elemento de Rational Team Concert al usuario de Jazz. Si una propiedad representa una referencia a otro elemento de trabajo, resultará indiferente la regla de sincronización de elementos de trabajo que especifique como regla de sincronización de referencia. La operación de sincronización utiliza la regla de sincronización correcta cuando determina el tipo de objeto referenciado. Por ejemplo, supongamos que los tipos de elemento de trabajo Defecto y Mejora contienen la propiedad DuplicadoDe, la cual es una referencia a otro elemento de trabajo. La correlación de propiedades para DuplicadoDe en la regla de sincronización Defecto especifica esta regla como la regla de sincronización de referencia. De manera similar, la correlación de propiedades para DuplicadoDe en la regla de sincronización Mejora especifica esta regla como la regla de sincronización de referencia. Si la operación de sincronización determina que un defecto se marque como duplicado de una mejora, utilizará la regla de sincronización Mejora.

    Utilice la sección Transformador de valores para especificar cualquier tratamiento especial que resulte necesario para transformar los datos que se propagan entre el elemento de Rational Team Concert y el campo de registro de ClearQuest . Mantenga seleccionada la casilla Ninguna transformación si no necesita transformar datos; en caso contrario, deselecciónela para activar el resto de los campos. ClearQuest Connector ofrece los siguientes transformadores de valores. Puede añadir transformadores si crea extensiones de plug-ins.

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

    Algunos transformadores de valores pueden requerir propiedades adicionales para poder transformar los datos. Si resulta necesario, seleccione Establecer otras propiedades de entrada necesarias para el transformador y seleccione las propiedades en el recuadro de diálogo Propiedades obligatorias.

    Utilice la sección Correlaciones de valores para especificar valores para correlacionar desde elementos a registros. Pulse Añadir. Escriba un valor de elemento y el valor de campo de registro de ClearQuest correspondiente. Si no existe ninguna correlación uno a uno de todos los valores, designe una como valor predeterminado. Por ejemplo, el campo Prioridad de ClearQuest podría tener cuatro valores (1, 2, 3, y 4) y el campo Prioridad de Team Concert podría tener tres (Alta, Media y Baja). Si correlaciona Alta con los valores 1 y 2, seleccione 1 o 2 como el valor externo de Predeterminado. Para especificar el valor vacío en un campo de registro de ClearQuest deje el valor en blanco. En lugar de añadir correlaciones de valores una a una, puede pulsar el botón Inicializar para crear un conjunto inicial de correlaciones en función de los nombres de valor coincidentes, o parcialmente coincidentes. A continuación, puede avanzar por la lista y eliminar o editar las correlaciones de valores según resulte necesario.

    Rational ClearQuest y Rational Team Concert permiten identificar registros duplicados y elementos, respectivamente. Para sincronizar duplicados, correlacione la propiedad de elemento DuplicadoDe con la propiedad externa original. En el campo Regla de sincronización de referencia, seleccione la regla de sincronización utilizada para elementos de trabajo.

  8. Pulse Guardar para guardar el trabajo.
Qué hacer a continuación

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


Comentarios

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