Sincronizar los requisitos entre Rational Team Concert y Rational RequisitePro

Utilizar Jazz Connector para iniciar las la planificación de su proyecto desde sus requisitos

En este artículo se describe a un conector Jazz que sincroniza los requisitos para trabajar los ítems en IBM® Rational Team Concert® de tal modo que usted pueda iniciar su planificaciín basada en sus requisitos. Aprenderá como instalar el conector, a ponerlo en marcha y hacer que funcione en su entorno.

Steve Arnold, Senior Technical Consultant, IBM

Steve es senior technical consultant en IBM Rational del Reino Unido, en donde se desempeña desde el año 2000. Su principales áreas de especialización son diseño UML y Model-Driven Architecture (MDA) [Arquitectura dirigida por modelos], además se interesa profundamente en Eclipse y extensibilidad de productos.


Nivel de autor profesional en developerWorks

18-02-2011

Lo que hace el conector

Hay tres cosas que usted puede y debe hacer con sus requisitos: utilizarlos para impulsar el diseño y el desarrollo, para impulsar las pruebas y para impulsar sus planes. El siguiente diagrama muestra como los roles del administrador del proyecto, el arquitecto y el de los accesorios de prueba conducen a utilizar los requisitos para acelerar sus tareas.

Figura 1. Usos de los requisitos
Bases de los formularios Reqspara para PMs, arquitectos y para los accesorios de prueba.

En este artículo se describe el conector IBM® Rational® Jazz™ que copia los requisitos de IBM® Rational® RequisitePro® para planificar los ítems en IBM® Rational Team Concert®. Los requisitos pueden entonces ser asignados a las iteraciones y descompuestos en tareas para que el equipo de desarrollo lo implemente. Este enfoque asegura que la planificación sea administrada al nivel de los requisitos y que el proceso de la implementación de los mismos ( por lo general las historias o el uso de los escenarios) puedan se medidos y administrados.

El código acá hace uso de la arquitectura del conector Jazz, que otorga ciertos beneficios. En primer lugar proporciona un marco de correlaciones amplio, por lo tanto los campos en Rational RequisitePro pueden ser fácilmente correlacionados a los campos en Rational Team Concert. El marco, también proporciona los mecanismos de una sincronización sólida para asegurar que los cambios pasen con éxito entre los dos sistemas y también para resolver los conflictos en el caso de que se produjeran.

¿Qué hay de nuevo en la versión 2?

El principal cambio fue rescribir el conector para hacer uso de RequisitePro REST APIs. Esto requiere que RequisiteWeb sea instalado y a su vez proporciona beneficios importantes Permite que el conector se despliegue en los servidores de Jazz de Windows® no-Microsoft® y también simplifica enormemente el proceso de la instalación.

El conector también brinda los mecanismos para seleccionar que requisitos deben ser sincronizados. Usted puede elegir sincronizar todos lo requisitos de nivel superior de un tipo determinado, o puede elegir una vista para sincronizar. También es posible configurar las sincronizaciones múltiples, de tal modo que si usted desea sincronizar diferentes tipos de requisitos, entonces usted simplemente deberá configurar y ejecutar algunas sincronizaciones.


Eliminar versiones anteriores

Es aconsejable desinstalar las versiones previas del conector. Siga estos pasos para desinstalar la versión anterior del conector: en el sistema de archivo, elimine la carpeta del sitio actualizado del conector:

  1. En el sistema de archivos, elimine la carpeta del sitio actualizado del conector RequisitePro desde el directorio del servidor, y elimine el archivo reqproconnector.ini desde Jazz Server InstallDir/jazz/server/conf/Jazz/provision_profiles.
  2. Inicie el servidor RTC, a continuación vaya a https://localhost:9443/jazz/admin/cmd/requestReset, y reinicie el servidor.-
  3. Detenga el servidor, reinícielo para que actualice los plug-ins, y luego deténgalo nuevamente para que esté listo para instalar el nuevo conector.

El conector anterior ahora está desinstalado.


Instalar el servidor

Instalar el servidor es un proceso simple. Al descomprimir el archivo ReqProCon_server.zip que está incluido en este artículo (ver la sección Downloads), busque la carpeta llamada com.ibm.uk.reqproconnector.repositorymanager.updatesite y un archivo llamado reqproconnector.ini. Siga estos pasos para instalar el servidor del conector:

  1. Copie la carpeta com.ibm.uk.reqproconnector.repositorymanager.updatesitea su JazzInstallDir/Jazz/server.
  2. Copie el archivo reqproconnector.ini a JazzInstallDir/server/conf/jazz/provision_profiles.

Su sistema de archivos debe verse como el de la Figura 2.

Figura 2. Sistema del archivo del servidor
Sistema el archivo Jazz que muestra plugin instalado
  1. Ahora reinicie el servidor Jazz para cargar los cambios.

Establezca y configure las normas del servidor y de la sincronización

Ahora que los componentes del servidor están instalados, usted necesita hacer dos cosas. En primer lugar necesita configurar los tipos de ítems de trabajo a los que se van a sincronizar. En segundo lugar usted necesita establecer una norma de sincronización.

Configurar el ítem del tipo de trabajo para estar listo para la sincronización

Para que la sincronización funcione, es necesario almacenar la clave de los requisitos en el ítem de trabajo. Por lo tanto usted necesita crear un nuevo campo sobre el ítem de trabajo para almacenar el valor.

  1. Haga un clic derecho sobre el área del proyecto, y elija Open.
  2. Haga clic en la etiqueta Process Configurationy luego vaya a Project Configuration > ConfigurationData > Work Items > Types and Attributes.
  3. En el menú desplegable, seleccione el tipo con el que desea trabajar para sincronizar los requisitos , y luego agregue un atributo personalizado con un nombre clave, la clave de la ID, y el tipo de Small String.
  4. Guardar los cambios.
Figura 3. Ejemplo de una historia personalizada, incluyendo el campo clave
Historia de un ítem de trabajo personalizado con un campo clave

Establezca una norma de sincronización

Ahora necesita configurar la norma de la sincronización, que es una correlación de los campos RequisitePro a los campos de los ítems de trabajo.

  1. En primer lugar, seleccionar la conexión en la vista Team Artifacts Haga un clic derecho y elija Administer > Synchronization Rules.
Figura 4. Opción de menú para administrar las norma de la sincronización
Dos menues desplegables con selecciones destacadas

Ahora crear una conexión externa para representar el proyecto RequisitePro:

  1. En la vista Synchronization Rules haga un clic derecho en External Repository ConnectionsSynchronization, y elija New > External Repository Connection.
  2. Especifique el nombre de la conexión, la conexión RequisitePro REST (por ejemplo: http://reqwebhostname/ReqWeb/Servlet/project/projectname), las credenciales login, y el área del proyecto del objetivo.

    Note: Existe una limitación que pide que el nombre del proyecto en el catálogo RequisiteWeb no debe contener espacios.

La pantalla se debe ver como en la Figura 5.

Figura 5. Ventana External Repository Connection
Propidades del cuadro de diálogos

Ahora usted necesita configurar la correlación entre RequisitePro y Rational Team Concert.

  1. En la vista Synchronization Rule, Haga un clic derecho en el área del proyecto y elija New > Synchronization Rule. Siga estos pasos para establecer la norma:
  2. Especifique el nombre de la norma.
  3. En la parte superior derecha de la pantalla, especifique el tipo de ítem del trabajo, el almacén externo que usted creó antes, el administrador externo (RequisiteWeb 7.1) y el tipo de requisito al que usted desea sincronizarse.
  4. Luego especifique la correlación. Al menos usted debe especificar:
    • FiledAgainst:Equipo
    • Clave: clave (asegúrese de marcar la clave como un identificador externo)
    • Tipo: RtcType
    • Resumen: Nombre
  5. Observe que la propiedad FiledAgainst necesita utilizar CategoryTransformer, por lo tanto desactive No Transformation (sólo copie) y elija CategoryTransformer en el menú desplegable.
  6. Si usted ha enumerado los campos, a continuación correlacione los dos campos juntos, desactive el cuadro de la caja No Transformation (Just Copy) y agregue la correlación de la enumeración en el cuadro Value Mapping.

Cuando termine, la norma de la sincronización deberá ser parecida a la de la Figura 6.

Figura 6. Una norma de sincronización simple
Muestra las selecciones de la correlación de Tipo, Propiedad, y Valor

Usted necesita configurar los permisos para el client de la sincronización (ver también Figura 7). El client requiere Sincronizar con los permisos de los objetos externos Usted puede agregar al usuario que estará ejecutando la sincronización al proyecto o modificar la sincronización del proyecto de tal modo que todos los usuarios tengan este permiso.

  1. Para hacer esto, abra el área del proyecto, haga clic en la etiqueta Process Configuration y vaya a Team Configuration > Permissions.
  2. Luego en el panel principal, seleccione Item Connector > Sincronícelo con los objetos externos, y asegúrese que el usuario seleccionad o cualquier otro tenga la autorización para realizar esto.
Figura 7. Proyectar los permisos para sincronizarlos con los objetos externos
Seleccionar el área rodeada con un círculo debajo del ítem Connections

Instalar client

  1. Para instalar client, descargue y descomprima el archivo ReqProCon_client.zip desde la sección Downloads de este artículo.
  2. Editar el archivo start_reqpro_connector.bat, y actualizar la variable del entorno al directorio Jazz client jre bin y ext del directorio.

    Nota:
    Este debe ser JRE (Java™ Runtime Environment) suministrdo con Jazz client.

  3. A continuación usted deberá download the client Java Archive (JAR) files desde Jazz.net, y guardarlo en una carpeta llamada jpjc en el mismo directorio del cliente.
  4. Ahora actualice el archivo batch nuevamente, y establezca la variable JAVA_CLIENT_JARS para indicar que directorio contiene todo sobre Java™ Archivar los archivos (JAR).

Ejecutar la sincronización

Para ejecutar la sincronización, usted necesita modificar primero el archivoreqproconnector.propertiescon sus configuraciones. Podrá configurar como seleccionar los requisitos, ya sea por uno u otro tipo de requisito a la vista. En el archivo suministrado, se realiza la configuración para seleccionar las vistas, con las opciones para seleccionar el tipo de requisito indicado.

  1. Ayuda a crear un usuario separado para utilizar con el conector. El usuario debe tener los privilegios de Jazz Admin y tener un desarrollador, una estructura, y un conector IBM® Rational® ClearCase® o una licencia client para el conector IBM® Rational® ClearQuest®
  2. Luego, a partir de una línea de comando, ejecute el archivostart_reqpro_conector.bat . Esto lo conectará a RequisitePro y sincronizará los requisitos con Jazz Team Server.
  3. Después de haber verificado que el conector ha funcionado y copiado los requisitos a Jazz Team Server, haga que este archivo se ejecute a intervalos frecuentes seleccionando Control Panel > Scheduled Tasks > Add Scheduled Task, y programando el archivo para que se ejecute cada 15 minutos.
  4. La sincronización inversa es manejada en forma automática por Jazz Team Server. Sin embargo, para forzar la sincronización, seleccione la norma en la vista Synchronization Rule, Haga un clic derecho, y elija Synchronize Out.

Recomendaciones:
Si los cambios de los requisitos no fluyen correctamente entre los sistemas, esto sucede probablemente porque los requisitos han sido modificados en ambos sistemas en el mismo período de la sincronización. En este caso, los requisitos que fallen aparecerán como no sincronizados, y usted podrá decidir que cambio aceptar. Para poder ver los requisitos desincronizados, haga clic en la norma SynchronizationVea y elija Show Unsynchronized.

Figura 8. La opción del menú Show Unsynchronized
Opción seleccionada en el menú desplegable

Ahora debe estar trabajando la sincronización en ambas direcciones entre los requisitos de Rational RequisitePro y los ítems de trabajo de Rational Team Concert.


Limitaciones

El conector tiene las siguientes limitaciones:

  • Los campos de enumeración de selección múltiple Rational RequisitePro nos son soportados en la correlación.
  • El nombre del proyecto al haber sido registrado con RequisiteWeb no deberá contener espacios. Esto se puedo evitar agregando un segundo ingreso al catálogo RequisiteWeb para ser usado por el conector

resumen

Usted podrá utilizar Rational RequisitePro to Rational Team Concert Connector para sincronizar los requisitos con los ítems de la planificación de alto nivel. Esto significa que la planificación del proyecto posee una fuerte rastreabilidad de los requisitos acordados que deberían conducir al envío de proyectos mejorados y a mejorar las necesidades de los clientes asegurando que los requisitos establecidos sean planificados, evaluados, y enviados. Esta versión del conector has sido rediseñada para utilizar RequisitePro REST APIs, lo que significa que se puede utilizar en otros servidores que no sean servidores Microsoft Windows.


Descargas

DescripciónNombretamaño
Client filesReqProCon_client.zip228KB
Server filesReqProCon_server.zip68KB
Connector filesreqproconnector_v2_16Jun_src.zip722KB

Recursos

Aprender

Obtener los productos y tecnologías

Comentar

Comentarios

developerWorks: Ingrese

Los campos obligatorios están marcados con un asterisco (*).


¿Necesita un IBM ID?
¿Olvidó su IBM ID?


¿Olvidó su Password?
Cambie su Password

Al hacer clic en Enviar, usted está de acuerdo con los términos y condiciones de developerWorks.

 


La primera vez que inicie sesión en developerWorks, se creará un perfil para usted. La información en su propio perfil (nombre, país/región y nombre de la empresa) se muestra al público y acompañará a cualquier contenido que publique, a menos que opte por la opción de ocultar el nombre de su empresa. Puede actualizar su cuenta de IBM en cualquier momento.

Toda la información enviada es segura.

Elija su nombre para mostrar



La primera vez que inicia sesión en developerWorks se crea un perfil para usted, teniendo que elegir un nombre para mostrar en el mismo. Este nombre acompañará el contenido que usted publique en developerWorks.

Por favor elija un nombre de 3 - 31 caracteres. Su nombre de usuario debe ser único en la comunidad developerWorks y debe ser distinto a su dirección de email por motivos de privacidad.

Los campos obligatorios están marcados con un asterisco (*).

(Por favor elija un nombre de 3 - 31 caracteres.)

Al hacer clic en Enviar, usted está de acuerdo con los términos y condiciones de developerWorks.

 


Toda la información enviada es segura.


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=90
Zone=Rational
ArticleID=627772
ArticleTitle=Sincronizar los requisitos entre Rational Team Concert y Rational RequisitePro
publish-date=02182011