Guía de aprendizaje: Exploración del proyecto de ejemplo JUnit del Rational Team Concert

Esta breve guía acompaña al proyecto de ejemplo JUnit del Rational Team Concert. Le proporciona una visión general muy completa para que pueda empezar a explorar por su cuenta.
El proyecto JUnit está basado en un proyecto de software realista, cuyo objetivo es lanzar la versión 4.4 de JUnit. El equipo utiliza el Rational Team Concert para planear, rastrear, colaborar y entregar el release. Al crear el proyecto de ejemplo JUnit en el Jazz Team Server, verá los artefactos existentes como si el equipo ya hubiera comenzado a trabajar.

Objetivos de aprendizaje

Esta guía debería proporcionarle las nociones suficientes para permitirle comenzar a experimentar y profundizar en sus conocimientos, pero no le guiará paso a paso a lo largo del proyecto.

    1. Creación del proyecto de ejemplo JUnit
    2. Licencias de acceso de cliente y usuarios del Área de proyecto de JUnit
    3. Iteraciones y trabajo planificado del proyecto JUnit
    4. Código fuente del proyecto JUnit
    5. Construcciones del proyecto JUnit
    6. Informes de proyecto de JUnit (sólo en la edición Standard)
    7. Exploración del proyecto JUnit en la interfaz web

Tiempo necesario

20 minutos

1. Creación del proyecto de ejemplo JUnit

Para crear el proyecto de ejemplo JUnit en el Jazz Team Server, debe contar con los permisos de administrador de Jazz y con una Licencia de acceso de cliente de desarrollador.
Abra el asistente de configuración del proyecto de ejemplo de Team Concert: Pulse Archivo > Nuevo > Ejemplo y siga las solicitudes para instalar el proyecto de ejemplo de Team Concert

2. Licencias de acceso de cliente y usuarios del Área de proyecto de JUnit

El proyecto de ejemplo JUnit incluye a ocho usuarios. Puede iniciar sesión en el proyecto JUnit como cualquiera de los miembros del equipo para tener distintas perspectivas de los roles y tareas. Sin embargo, para examinar el proyecto JUnit como uno de estos usuarios, hay que asignar al usuario una Licencia de acceso de cliente de desarrollador. El número de licencias que puede asignar a este proyecto de ejemplo está limitado por el número de licencias disponibles en su servidor.
Por qué y cuándo se efectúa esta tarea
Consejo: La contraseña inicial de cada usuario coincide con su ID de usuario. Así, por ejemplo, la contraseña de Bill es "bill". Si pretende examinar exhaustivamente un servidor de prueba, quizá prefiera cambiar la contraseña inicial.
Tabla 1. Usuarios del Área de proyecto de JUnit
Usuario ID de usuario / contraseña Rol/Descripción
Bill Cassavelli bill / bill Jefe de equipo de JUnit. Bill es el líder del equipo JUnit. Ha creado los planes de repetición y es el dueño de varios elementos de trabajo de alto nivel del release.
Construcción construcción / construcción Usuario especial para ejecutar las construcciones.
Freddy Freund freddy / freddy  
Jason Mitchell jason / jason Miembro de equipo de JUnit. Jason tiene asignados varios elementos de trabajo.
Jennifer Ginness jennifer / jennifer  
Markus Kent markus / markus Miembro de equipo de JUnit. Markus tiene asignados varios elementos de trabajo.
Marlene Stamp marlene / marlene  
Rick Yuen rick / rick  
Más información acerca de las Licencias de acceso de cliente
Gracias a las Licencias de acceso de cliente se controla qué usuarios tienen acceso a determinadas características del Jazz Team Server. El número de Licencias de acceso de cliente disponibles depende de la edición del Rational Team Concert que se use. En general, un usuario con Licencia de acceso de cliente de desarrollador goza de autoridad para crear artefactos, mientras que un usuario con Licencia de acceso de cliente de colaborador puede crear elementos de trabajo, pero sólo puede visualizar la mayoría del resto de artefactos.

Para más información, vea Ediciones y licencias del Rational Team Concert 1.0.1 y Gestión de las Licencias de acceso de cliente.

Para asignar licencias a los usuarios:

  1. Acceda al área de proyecto de JUnit como usuario con privilegios de administrador (ADMIN/ADMIN en una instalación de servidor nuevo).
  2. En la vista Organización de equipo (Ventana > Mostrar vista > Organización de equipo), pulse con el botón derecho sobre Markus Kent y, a continuación, en Abrir.
  3. En el Editor de usuarios bajo las Licencias de acceso de cliente, seleccione Rational Team Concert - Desarrollador y pulse Guardar.

    Esta imagen muestra cómo se definen Licencias de acceso de cliente en el Editor de usuarios

Resultados

La vista Organización de equipo muestra únicamente a los usuarios que forman parte del equipo de JUnit. Para asignar una Licencia de acceso de cliente a otros usuarios, emplee la interfaz web del Jazz Team Server (pulse en Admin > Usuario Gestión). Esta interfaz recoge una lista de todos los usuarios del servidor:

Sección Gestión de usuarios de la interfaz web del Jazz Team Server

Consejo:

Para iniciar sesión con un nombre de usuario diferente, modifique las propiedades de la conexión de su repositorio y escriba un ID de usuario distinto:

Modificación de las propiedades de la conexión para iniciar sesión con otro nombre de usuario

3. Iteraciones y trabajo planificado del proyecto JUnit

El proyecto JUnit está utilizando un enfoque ágil e interactivo para completar la versión 4.4 de JUnit. El equipo sigue el proceso Eclipse Way y ha definido varias iteraciones. Para cada iteración, el equipo ha creado un documento del plan y ha definido los elementos de trabajo de dicha repetición.
  1. Para consultar las Iteraciones de proceso, sólo tiene que abrir el proyecto JUnit en el Editor de áreas de proyecto:

    Iteraciones de proceso de JUnit

  2. Para visualizar un plan de iteración, ábralo desde la vista Artefactos de equipo:

    Nodo de planes en la vista Artefactos de equipo con los planes de JUnit

  3. Consulte el plan de iteración de JUnit 4.4M2. En la pestaña Elementos planificados, puede ver todos los elementos planificados para esa iteración.

    Consejo: En el Editor de planes, puede modificar de forma rápida ciertos atributos de los elementos de trabajo usando los menús desplegables:

    Modificación de la prioridad de un elemento de trabajo desde el Editor de planes

  4. Para acceder a los detalles de un elementos de trabajo, pulse dos veces sobre el elemento en la página Elementos planificados. El elemento se abrirá en el Editor de elementos de trabajo, donde podrá realizar los cambios que se le permita según su rol y la configuración del proceso.

    Así, por ejemplo, si ha iniciado sesión como el miembro de equipo de JUnit Markus Kent, puede probar a usar la sección Discusión para añadir un comentario al elemento trabajo:

    Sección Discusión del Editor de elementos de trabajo

4. Código fuente del proyecto JUnit

El código de JUnit se encuentra bajo control de origen en el repositorio del Jazz Team Server. Markus y otros miembros del equipo (a quienes usted asignó Licencias de acceso de cliente de desarrollador), pueden implementar cambios en la corriente.
Por qué y cuándo se efectúa esta tarea

En la vista Artefactos de equipo, puede verse que el proyecto JUnit incluye una única corriente de control de origen denominada JUnit, propiedad del Equipo JUnit. Dicha corriente está formada por un único componente, denominado asimismo JUnit. En la siguiente captura de pantalla, el componente JUnit se encuentra en la línea base.

Corrientes, componentes y un espacio de trabajo de repositorio cargado de JUnit en la vista Artefactos de equipo

En la captura de pantalla anterior puede verse, además, que el usuario actual ha cargado un espacio de trabajo de repositorio llamado JUnit. Puede buscar y cargar los espacios de trabajo de repositorio de otros usuarios o bien crear el suyo propio.

Al cargar un espacio de trabajo de repositorio, los proyectos que forman parte de los componentes cargados están disponibles en su entorno de desarrollo para que pueda trabajar en ellos. En el componente JUnit hay tres proyectos:

Los proyectos de código fuente de JUnit cargados y visibles en el Explorador de paquetes
Más información acerca del Jazz Source Control
Tras una primera exploración, quizá quiera aprender más sobre algunos de los conceptos y tareas del JazzSource Control.

Lea la sección Visión general del Jazz Source Control para aprender más acerca de las corrientes, componentes y espacios de trabajo de repositorio, entre otros conceptos.

Pruebe a realizar algún cambio en el archivo Java y enviarlo a la vista Cambios pendientes. Se recomienda asociar dicho cambio al elemento de trabajo relacionado.
Entrega de un conjunto de cambios a la vista Cambios pendientes

5. Construcciones del proyecto JUnit

El proyecto JUnit incluye una definición de construcción y un motor de construcción. Para explorar y experimentar con las construcciones de JUnit, antes debe configurar e iniciar un motor de construcción usando para ello un juego de herramientas de construcción instalado por separado.
Antes de empezar
  • Para poder ejecutar un motor de construcción, antes debe instalar el Rational Team Concert Build System Toolkit. Este juego de herramientas puede instalarse desde el Launchpad o bien descargarse desde jazz.net. Al instalarlo, se crea una carpeta llamada installdir/buildsystem.
  • En este ejemplo de JUnit, se debe asignar al ID de usuario "build" una Licencia de acceso de cliente del Build System.
Por qué y cuándo se efectúa esta tarea
Para iniciar el motor de construcción del proyecto JUnit:
  1. Desde una línea de mandatos, navegue hasta installdir/buildsystem/buildengine/eclipse, donde se encuentra el directorio de instalación installdir.
  2. Escriba el siguiente mandato: 
    jbe -repository https://localhost:9443/jazz -userId build -pass build
-engineId junit -sleeptime 5
    Una vez haya ejecutado el motor correctamente con el juego de herramientas de construcción, ya está listo para recibir solicitudes. Sólo es compatible con aquellas definiciones de construcción definidas para ejecutarse en este motor de compilación en concreto.

    Ventana de mandatos con un motor de construcción ejecutándose y listo para recibir solicitudes

  3. Solicitud de una construcción junit :

    Solicitud de una construcción

  4. Cuando se haya completado la construcción, abra los resultados de la misma desde la vista Construcciones . Pulse en las pestañas Resumen, Construcción, y JUnit en el resultado de la construcción para comprobar qué tipo de información se recoge en ellas.
Qué hacer a continuación
Consejo: Intente programar la construcción junit para que se ejecute automáticamente cada 30 minutos. Para ello, edite la pestaña Planificación en la definición de la construcción (pulse con el botón derecho sobre la construcción junit en la vista Artefactos de equipo y seguidamente pulse en Abrir definición de construcción).

Más información acerca de las construcciones en equipo
Lea la sección Construcciones con Jazz de la Ayuda para conocer más en profundidad el Team Build y cómo gestionar y administrar construcciones. También puede empezar a conocer las tareas Ant de construcción que puede usar al escribir sus propios scripts de construcción.

6. Informes de proyecto de JUnit (sólo en la edición Standard)

Si pretende explorar en profundidad el proyecto JUnit, puede usar los informes para hacer un seguimiento del progreso y supervisar las áreas de proyecto y equipos de JUnit. Sin embargo, dado que los informes requieren datos agregados e históricos, el proyecto JUnit no cuenta con datos iniciales para crear los informes de construcción.
Por qué y cuándo se efectúa esta tarea
Los informes utilizan un depósito de datos que, generalmente, realiza instantáneas diarias de los datos del repositorio. Estas instantáneas proporcionan los puntos de datos históricos necesarios para elaborar los informes. Si desea visualizar informes de JUnit, debe iniciar una o varias instantáneas espaciadas en el tiempo. Así, por ejemplo, podría hacer una instantánea ahora, a continuación enviar algunos cambios de código, ejecutar varias construcciones o abrir algún elemento de trabajo y, tras ello, hacer otra instantánea.

Para iniciar una instantánea de los datos manualmente:

  1. Asegúrese de que Markus Kent cuenta con permisos de administrador de JazzDW y, después, inicie una sesión en la interfaz web del Rational Team Concert como Markus.
    Nota: Si usted otorgó a Markus Kent el permiso de administrador de Jazz, este usuario puede asignase a sí mismo el permiso de administrador de JazzDW. De lo contrario, deberá iniciar una sesión con su propio ID de usuario para asignar el permiso de administrador de JazzDW a Markus.
  2. Vaya a la página Informes y pulse en Administrar depósito de datos.
  3. Pulse en Actualizar todos los datos de instantáneas.
Resultados
Una vez que tenga varias instantáneas que representen diversos punto en el tiempo, comenzará a ver más valores en los informes que los visualizados en el proyecto JUnit.
Qué hacer a continuación
Puede abrir los informes desde dos ubicaciones:
  • La página Informes de la interfaz web:

    La página Informes de la interfaz web

  • el nodo Informes bajo el proyecto JUnit en la vista Artefactos de equipo:

    Informes abiertos desde la vista Artefactos de equipo

Más información acerca de cómo crear y visualizar informes
Lea la sección Seguimiento de los datos mediante informes de la Ayuda para aprender más acerca de las características de la elaboración de informes.

7. Exploración del proyecto JUnit en la interfaz web

La mayor parte de esta guía le ha llevado a través del cliente rico. La interfaz web de Rational Team Concert le ofrece un entorno rico el el que puede satisfacer muchos de los objetivos de colaboración con su equipo.
Por qué y cuándo se efectúa esta tarea

El proyecto JUnit en la interfaz web

Para explorar el área de proyecto de JUnit en la interfaz web:
  1. Abra la interfaz web en un navegador. En caso de ejecutarla de forma local, el URL predeterminado es:

    https://localhost:9443/jazz/web/projects/JUnit%20Project

  2. Eche un vistazo a la interfaz web. Por ejemplo:
    • Encuentre y cree elementos de trabajo en la página Elementos de trabajo
    • Examine el código fuente en el repositorio de la página Control de origen
    • Revise los planes de proyecto en la página Planes de repetición
    • Trabaje con paneles de instrumentos personales y de equipo en la página Paneles de instrumentos (sólo en la edición Standard)
    • Consulte el estado y el progreso del proyecto en la página Informes (sólo en la edición Standard)

Resumen

Esta mini-guía le ha enseñado los conceptos básicos del proyecto de ejemplo JUnit. El proyecto JUnit es una excelente forma de explorar y aprender a usar el Rational Team Concert para colaborar con un equipo en un proyecto de desarrollo de software.
Recuerde: Cuando haya terminado de trabajar con el proyecto de ejemplo JUnit, retire las Licencias de acceso de cliente a los usuarios ficticios del ejemplo. De esta forma, las licencias quedan libres para ser asignadas a usuarios reales.
Para más información, vea las siguientes secciones de iniciación:
Comentarios