Rocío Navarro Lacoba

2

ÍNDICE Este manual contiene información para administrar un sistema JIRA. Está extraído del siguiente enlace: http://www.atlassian.com/software/jira/docs/v3.13/administration.html

• Introducción………………………………………………………..………….3 • Presencia (logo, colores, formatos de tiempo)…………………………..….3-5 • E-mail (notificaciones, configuración, destinatarios,

formato)……..………………………………………………………………5-7 • Usuarios (vista de usuarios, añadir usuarios, asignación a grupos y proyectos,

cambio de nombre o e-mail, cambio de contraseña, añadir propiedad, eliminación)…………………………………………………………..……7-13

• Seguridad (configuración dentro y fuera)...................................................13-14 • Proyectos………………………………………………………………….14-16 • Campos y pantallas……………………………………………………….17-19 • Workflows (creación, edición de workflows activos e inactivos, pasos y

transiciones, validadores, post-funciones, XML, copias entre sistemas )..20-40 • Importación desde otros sistemas………………………..……………….40-42 • Proyectos individuales…………………………………………………....42-45 • Integración con un sistema de control de revisión…………………….… 46-52 • Configuración de opciones…………………………………………….…52-58 • Administración de servidor…………………………………………….…….59 • Más documentación para personalizar JIRA………………………….….60-61

3

Introducción: Jira está basado en Java EE, que funciona en varios bancos de datos y sistemas operativos. La herramienta dispone también de paneles de control adaptables, filtros de búsqueda, estadísticas, RSS y función de correo electrónico. La flexible arquitectura de Jira permite al usuario crear ampliaciones específicas que pueden incluirse en la librería de extensión de Jira. PERSONALIZAR LA PRESENCIA EN JIRA: 1º Entrar en Jira con perfil de administrador, el permiso de administrador permite personalizar el programa. 2º Clica en “Administración” al lado de “Incidencias” o bien en “Administración”, al lado de “Tareas”.

3º En el panel de la izquierda, debajo del título 'Global Settings', clica en 'Look and Feel.'.

4º Aparecerá la pantalla para configurar la presencia del programa.

5º Para editar la configuración, tienes que clicar en “Editar configuración”. Para volver a la configuración por defecto del JIRA, clica en el botón de 'Reset Default'.

4

6º LISTA DE OPCIONES PARA CONFIGURACIÓN DISPONIBLES:

Logo

Opción Características

URL

Esta URL señala la ruta absoluta o relativa de la imagen que puedes querer mostrar en lo alto de la página. Si la URL empieza con 'http://' or 'https://' entonces la URL es tratada como una URL absoluta. De otro modo, sera tratada como URL relativa.

Vista previa

Cuando se selecciona una imagen, saldrá una vista previa.

Anchura del logo

La anchura de la imagen, normalmente en pixels. Puedes usar cualquier anchura que sea válida en una imagen. Por ejemplo, 100px o 80%.

Altura del logo

La altura de la imagen, normalmente en pixels. Puedes usar cualquier anchura que sea válida en una imagen. Por ejemplo, 100px o 80%.

Colores

Los colores que elijas para cada una de las secciones pueden ser cualquiera siempre que sean válidos. Para elegir un color puedes usar el selector de colores o especificarlo por tu cuenta, por ejemplo '#FFFFFF', 'red'.

Para volver al esquema de color original sólo tienes que limpiar los valores que has puesto.

Opción Características

Top Bar Colour El color del fondo de la barra superior.

Top Text Colour El color del texto que se sitúa dentro de la barra superior (como tu nombre de usuario).

Menu Bar Colour El color de fondo de la barra que contiene los enlaces a 'HOME' y 'BROWSE PROJECT'.

Menu Bar Text Colour

El color del texto de los enlaces en la barra del menú (como 'HOME').

Menu Bar Higlight Colour

El color de la barra del menú cuando está seleccionado o cuando el ratón se sitúa sobre él.

Menu Bar Text Highlight Colour

El color del texto de la barra del menú cuando está seleccionado o cuando el ratón se sitúa encima de él.

Link Colour El color del texto de los enlaces.

Link Active Colour El color del texto de los enlaces cuando está seleccionado.

Heading Colour El color del encabezamiento del texto (como 'Logo').

5

Formatos de tiempo

Todos los formatos de tiempo en JIRA son configurables. Se utlizan los formatos por defecto.

Puedes editar esos valores por defecto clicando en "Editar configuración" en el link de la parte de abajo. Por ejemplo, podrías querer cambiar el formato día/mes/año para mostrar primero el mes. Simplemente pones MM/dd/aa al lado del campo de formato día/mes/año, y previsualiza clicando en el botón de actualizar.

La página de vista previa debería mostrar el tiempo actual en el nuevo formato.

Perspectiva general de E-mail

JIRA puede enviar notificaciones por e-mail a usuarios cuando ocurra un evento significativo.

Habilitar notificaciones por e-mail

1º Configurar un Servidor de correo SMTP.

6

2º Configurar un esquema de notificación y asociarlo con los proyectos apropiados. La dirección de e-mail desde la cual son enviadas las notificaciones puede ser también configurada para cada proyecto.

Deshabilitar notificaciones por e-mail

Para deshabilitar notificaciones por e-mail para un proyecto, puedes quitar el esquema de notificación desde el proyecto editando el proyecto y seleccionando ‘Ninguno’ como esquema de notificación de proyectos. Como alternativa, puedes editar el esquema de notificación para que no se envíen e-mails.

Configurar una dirección e-mail de proyectos

Es posible configurar una dirección de e-mail para proyectos que envíe las notificaciones. Para configurar el envío de e-mails para un proyecto, todas las notificaciones serán enviadas desde su dirección. Esta configuración es específica para el proyecto seleccionado y no afectará a la configuración de los demás proyectos. La dirección que envía las notificaciones es la dirección por defecto especificada en la configuración del servidor de correo SMTP y esto se aplicará a todos los proyectos. La dirección de e-mail que envía dichas notificaciones puede ser configurada como sigue: 1º Desde la vista de Administración, selecciona “Proyectos” para ver todos los proyectos. Selecciona el proyecto que va a ser configurado. 2º Selecciona “Editar configuración” desde la “Configuración del e-mail” y entra en la lista de detalles del proyecto. 3º Introduce una dirección de correo válida en el campo de envío y clica “Confirmar” para completar el proceso. Esta dirección de e-mail será ahora usada como la dirección que envía todas las notificaciones para este proyecto. 4º Podemos volver a utilizar la dirección e-mail por defecto clicando en el botón de “Reiniciar”. Nota No podemos hacer uso de esta opción a menos que hayamos configurado previamente un servidor de correo SMTP.

Destinatarios de e-mail

Para cada notificación de eventos, JIRA sólo enviará la primera dirección que encuentre destinada a un destinatario. Por tanto, en el caso de que un usuario sea incluido en dos o más listas de destinatarios para una notificación de evento, el usuario sólo recibirá la primera notificación de e-mail que encuentre. JIRA registrará el hecho de que este usuario estaba en múltiples listas de destinatarios.

Formato de e-mails

Cada usuario de JIRA puede especificar en sus Preferencias de perfil si quiere enviar e-mails en formato texto o en formato html. Los administradores de JIRA pueden

7

especificar un formato de e-mail por defecto bajo 'User Defaults' en el menú de Administración. Desde JIRA 3.6.1, el formato de e-mail en html fue mejorado para adaptar las palabras internacionales en la sección 'Detalles de incidencia'. Sin embargo, debido a las herramientas de seguridad de internet, las cuales impiden la descarga de imágenes, el e-mail html podría no estar formado correctamente. Por ejemplo, la columna de resumen a la izquierda podría aparecer demasiado grande. Es posible corregir el formato aceptando la descarga de esas imágenes. En algunos clientes de e-mail es posible hacer esto de 2 maneras diferentes:

1. Para cada e-mail:

a. Mozilla Thunderbird – clicando en el botón de “Mostrar imágenes” encima del e-mail.

b. Microsoft Outlook 2003 – clicando en"Clica aquí para descargar las fotos. Para ayudar a

proteger tu privacidad, Outlook impide la descarga automática de algunas imágenes en este

mensaje”.

c. Microsoft Outlook 2000 – No tiene esta opción, siempre descarga las imágenes

d. Microsoft Outlook Express 6 – clicando en el mensaje que está sobre el e-mail "Algunas

imágenes han sido bloqueadas para ayudar a prevenir el envío de información de tu ordenador.

Clica aquí para descargar las imágenes”.

2. Configurar el cliente e-mail:

a. Mozilla Thunderbird 1.5 – Ve a Herramientas -> Opciones -> Privacidad -> General y

asegúrate de que la opción "Permitir imágenes remotas si el remitente está en mi…:" está

marcada y observa qué libreta de direcciones está seleccionada. Luego vuelve al e-mail enviado

de JIRA, haz click con el botón derecho del ratón en la dirección e-mail del emisor y elige la

opción de "Añadir a la libreta de direcciones…." , añade este contacto a la misma libreta de

direcciones tal como seleccionaste en opciones de privacidad.

b. Microsoft Outlook 2003 and Outlook Express 6 – Ve a Panel de control -> Opciones de

internet. En la pestaña de seguridad, añade la URL de base para los sitios de confianza.

Usuarios

Ver a los usuarios

Para ver una lista de los usuarios de JIRA:

1. Entra como usuario con el perfil de Administrador de JIRA.

2. Accede a la página de administración clicando o en el enlace de Administración o en el icono de

Administración en el tablero de mandos:

8

3. Selecciona User Browser (Mostrar usuario) de la sección del menú de administración de Usuarios,

Grupos y Roles. Esto mostrará la pantalla de User Browser:

4. Para restringir la lista de usuarios mostrada en el User Browser, usa el Filtro en la parte superior de dicha

página. Especificar (parte de) los emails y/o grupos de usuarios, después clica en el botón de Filtro, esto

reducirá la lista para estos únicos usuarios que se ajustan a esos criterios.

Añadir un usuario

1. Abrir el User Browser tal y como se ha indicado anteriormente y clica en el enlace de Añadir Usuario.

2. Esto mostrará el formulario de Crear Nuevo Usuario. Introduce el nombre de usuario (observa que el

nombre de usuario del usuario no puede ser cambiado una vez que el usuario es creado), contraseña, nombre

completo e e-mail; y (opcionalmente) clica en el botón de enviar al usuario un e-mail que contiene sus detalles

de cuenta. Finalmente, clica en el botón de Crear.

Nota

Los usuarios puedes también ser creados mediante:

- Inscripción — ver "Enabling Public Signup" en el siguiente enlace:

http://www.atlassian.com/software/jira/docs/v3.13/public_signup.html

- Email — por ejemplo, puedes utilizar el CreateIssueHandler para tener un usuario basado en la dirección de e-

mail del remitente. Ver el siguiente enlace: http://www.atlassian.com/software/jira/docs/v3.13/services.html

Nota

Si tienes una licencia limitada de usuario (por ejemplo una licencia personal) y has alcanzado tu límite de usuario,

después los usuarios añadidos no tendrán permiso para entrar en JIRA.

Asignación de un usuario a un grupo

9

Cuando se crea un usuario, será añadido a los grupos que pueden añadir nuevos usuarios automáticamente a ellos.

Para cambiar la pertenencia a un grupo de usuarios:

1. Localiza al usuario en el User Browser (ver 'Vista de usuarios' encima) y clica en Grupos en la columna de

operaciones.

2. Esto mostrará dos listas; la de la izquierda muestra todos los grupos disponibles, y el de la derecha muestra

todos los grupos que pertenecen al usuario actual. Usa los botones de entrar(join) y salir(leave) para añadir al

usuario o para quitarlo del grupo seleccionado.

Nota

Si tienes una licencia de usuario limitada (por ejemplo, licencia personal) y has alcanzado tu límite de usuario, en

adelante no podrás asignar a más usuarios a grupos con permisos de acceso (i.e. permisos de usuarios del JIRA) sin la

primera reducción del número de usuarios sin permisos de acceso.

Para saber más sobre los permisos de usuario ir al siguiente enlace:

http://www.atlassian.com/software/jira/docs/v3.13/global_permissions.html

Asignar un usuario a un proyecto

Asignar un usuario a un proyecto habilita a un usuario a posibilitar una función particular en un proyecto particular.

Para ver la pertenencia a un proyecto de usuarios, localiza al usuario en el User Browser (ver 'Vista de usuarios'

encima) y clica en el enlace de Project Roles (Roles de proyecto) en la columna de Operaciones. Esto mostrará una

tabla que indica todos los proyectos y roles de proyectos que existen en JIRA, y la pertenencia a un rol de proyecto

actual de usuarios para cada proyecto.

Cambiar el nombre de usuario o una dirección e-mail

1. Entra en User Browser y clica en Editar en la columna de operaciones.

2. Esto muestra un formulario donde puedes cambiar el nombre completo del usuario o e-mail.. Clica

actualizar para confirmar el cambio.

Cambiar la contraseña de usuario

1. Localiza al usuario en User Browser y clica en su nombre de usuario.

2. Esto muestra los detalles del usuario, debajo de varios enlaces. Clica en el enlace de Set Password

(Establecer o asignar contraseña).

3. Esto muestra la pantalla de Set Password (Establecer o asignar contraseña). Introduce y confirma la

nueva contraseña, luego clica en el botón de actualizar.

10

Por ejemplo, esta captura de pantalla muestra que, para el proyecto ABC:

• Mary es miembro del rol de administradores.

• Mary no es miembro del rol de desarrolladores.

• Mary es indirectamente un miembro del rol de usuarios, siendo un miembro del grupo de usuarios de JIRA.

(También observa que, para el proyecto DEF, Mary es a la vez un miembro directo e indirecto del rol de usuarios).

Clica en el botón de Editar roles de proyecto. Las casillas estarán disponibles para que puedas marcar (para añadir el

usuario a un rol de proyecto) o desmarcar (para quitar al usuario de un rol de proyecto).

Añadir una propiedad a un usuario

Una propiedad es una pieza extra de información que puedes almacenar de un usuario. Una propiedad contiene una

clave a tu elección (por ejemplo, ‘Número de teléfono’, 'Localización') más un valor correspondiente (por ejemplo

'96 356 45 89’, ‘Nivel tres’).

Para crear una nueva propiedad para un usuario:

1. Localizar al usuario en el User Browser (Vista de usuarios) y clica en su nombre de usuario.

2. Esto muestra los detalles del usuario, debajo de varios enlaces. Clica en Editar propiedades.

11

3. Esto muestra la pantalla de editar propiedades del usuario, mostrando algunas propiedades creadas

previamente:

4. Introduce la nueva clave y su valor, luego clica en añadir.

Borrar un usuario

Nota

Más que borrar a un usuario, es más recomendable desactivar su cuenta quitándolo de todos los grupos. Esto impide

que la cuenta del usuario sea usada. Es también importante reasignar algunas incidencias de ese usuario, pero no hay

necesidad de modificar el 'Reporter' (Informe) como se describe abajo.

Para borrar a un usuario:

12

1. Localiza al usuario en el User Browser y clica en el enlace de Borrar en la columna de operaciones.

2. La pantalla de confirmación que sigue resumirá cualquier participación de ese usuario en el sistema

mostrando las incidencias actuales asignadas y notificadas por ese usuario, etc. Estas conexiones entre el usuario

y otras partes del sistema (por ejemplo, tener incidencias asignadas al usuario) podrían impedir la eliminación de

ese usuario.

Tan pronto como reasignemos incidencias, podrás necesitar bulk-edit, las incidencias creadas por el usuario y

cambiar el 'Informador' (reporter). Necesitarás el permiso de 'Modify Reporter' para hacer esto.

Para saber más sobre Bulk-edit ir al siguiente enlace:

http://www.atlassian.com/software/jira/docs/v3.13/bulkoperations.html

Para saber más sobre el permiso de modificación, ve al siguiente enlace:

http://www.atlassian.com/software/jira/docs/v3.13/permissions.html

3. Si no hay incidencias asignadas o notificadas por el usuario, aparecerá un botón de borrar en la pantalla de

confirmación; clica ahí para proceder con el borrado.

Nota

Ten en cuenta que los filtros y lo paneles de control de un usuario serán borrados cuando el usuario sea borrado,

aunque los filtros o paneles de control sean mostrados con otros usuarios.

Nota

Si estás usando External User Management, no serás capaz de crear, editar o borrar usuarios desde JIRA; pero puedes

asignar usuarios a roles de proyecto, y crear/editar/borrar propiedades de usuario.

13

Perspectiva general de seguridad

Cuando configuramos la seguridad para JIRA, hay dos áreas:

• Seguridad dentro del propio JIRA. • Seguridad en el entorno externo.

Configurando la seguridad dentro de JIRA

JIRA tiene un sistema flexible de seguridad que permite que puedas configurar quién puede acceder al programa y qué pueden hacer y ver dentro de él.

Hay cinco tipos de seguridad dentro de JIRA:

1. Permisos globales — estos se aplican a JIRA en su totalidad (por ejemplo, quién puede entrar).

2. Permisos de proyecto — organizados en esquemas de permisos, estos se aplican a proyectos en su totalidad. (por ejemplo, quién puede ver los temas de proyectos (Ver permisos), crearlos, editarlos y asignarlos)

3. Niveles de seguridad temáticos (Sólo en la edición Enterprise) — organizados en esquemas de seguridad, estos permiten que la visibilidad de incidencias individuales sea ajustada, dentro de los límites de los permisos de los proyectos.

4. (Visibilidad de los comentarios) Comment visibility — permite que la viibilidad de comentarios individuales (dentro de una incidencia) sea restringida.

5. Visibilidad de las anotaciones de las incidencias (visibilidad del Work-log) — permite que la visibilidad de entradas individuales de work-log (dentro de una incidencia) sea restringida.

Para saber más sobre la visibilidad de los comentarios, ir a:

http://www.atlassian.com/software/jira/docs/v3.13/commentissue.html

Configurar la seguridad en el entorno externo

Si tu instancia de JIRA contiene información delicada, probablemente querrás configurar la seguridad. Cuestiones importantes:

• Bases de datos: o Si estás usando una base de datos externa recomendada por los sistemas

de producción, tú restringirías el acceso a la base de datos que usara tu instancia del JIRA.

o Si estás usando la base de datos HSQL embebida que se asocia a JIRA Standalone, restringirías el acceso al directorio en el que instalaste JIRA.

• Sistema de archivos — restringirías el acceso a los siguientes directorios (pero ten en cuenta que el usuario que está activo en tu instancia de JIRA también requerirá acceso completo a estos directorios):

o Index directory (Directorio índice) o Attachments directory (Directorio de anexos)

14

• SSL — Si estás ejecutando tu instancia de JIRA sobre internet, puedes querer usarlo con SSL.

Definir un proyecto

Para configurar un proyecto en JIRA:

1. Entra como usuario con permisos globales con perfil de administrador. 2. Ve a la página de administración clicando en el enlace de Administración en la

barra superior o en el título de Administración del panel de controles.

3. Selecciona un proyecto existente o clica en Añadir proyecto para añadir un proyecto.

Aquí tenemos el proyecto una vez creado:

Para configurar un proyecto:

• Key(clave) – una clave única para este proyecto (por ejemplo, WEB), que especifica las primeras letras de las claves de una incidencia del proyecto (por ejemplo, 'WEB-100'). Recomendamos que definas una clave que describa el

15

proyecto y sea fácil de escribir. Ten en cuenta que la clave se muestra a los usuarios que no tienen permiso para ver el proyecto y no se puede cambiar una vez que el proyecto exista.

• URL – Una URL opcional asociada a este proyecto, por ejemplo la documentación del proyecto

• (Equipo del proyecto) Project Team: o Project Lead (líder del proyecto) - el usuario cumple el rol de líder del

proyecto. Usado como el 'Asignador por defecto', y potencialmente en otro lugar en JIRA (por ejemplo, en esquemas de permisos, esquemas de notificación, esquemas de temas de seguridad y workflows).

o Default Assignee (Asignador por defecto) – el usuario a quien se le asignan inicialmente las incidencias en este proyecto cuando son creadas. Puede ser o el 'Líder del proyecto' , o, si (Permitir incidencias no asignadas) Permitir incidencias sin asignar es colocado a 'On' en configuraciones generales en JIRA, 'Sin asignar'. Nota: en JIRA Enterprise hay también asignadores de componentes por defecto (default component assignees). Para más información, ir al siguiente enlace: http://www.atlassian.com/software/jira/docs/v3.13/component_management.html#Selecting+a+Default+Assignee

o Project Roles – los miembros son usuarios/grupos que hacen funciones determinadas para este proyecto. Los roles de proyecto (Project roles) son usados con esquemas de permisos, esquemas de notificación, esquemas de temas de seguridad y workflows.

Para más información, ir al siguiente enlace: http://www.atlassian.com/software/jira/docs/v3.13/project_role_management.html

• (esquema de tipos de incidencias) Issue Type Scheme (sólo Enterprise y Professional) – el esquema del proyecto determina los tipos de incidencias (issue types) que se aplican a este proyecto. Para saber más sobre los tipos de incidencias, ir a: http://www.atlassian.com/software/jira/docs/v3.13/manageIssueTypes.html

• Esquema de notificación – el esquema de notificación del proyecto determina quién recibe las notificaciones de e-mail de los cambios a realizar en este proyecto.

• Esquema de permisos – el esquema de permisos del proyecto determina quién tiene permiso para ver o cambiar incidencias en este proyecto.

• Esquema de seguridad de incidencia (sólo Enterprise) – el esquema de seguridad del proyecto determina qué niveles de visibilidad puede haber.

• Esquema del campo de configuración (sólo Enterprise) – el esquema del campo de configuración determina qué configuración de campo se aplica a los tipos de incidencias en este proyecto. (Una configuración de campo determina la visibilidad global de los campos, el formato (wiki/rich-text or plain) y la existencia de varias pantallas). Para saber más sobre el texto, ir a: http://www.atlassian.com/software/jira/docs/v3.13/renderers_overview.html

• Esquema de pantalla (sólo Profesional) – el esquema de pantalla del proyecto determina qué pantallas son visualizadas para diferentes operaciones (ver, editar, crear); o:

16

• (Esquema de pantalla de tipos de incidencias) Issue Type Screen Scheme (sólo Enterprise)- el esquema de pantalla de los tipos de incidencias (issue type screen scheme) determina qué pantallas son visualizadas para diferentes tipos de operaciones (ver, editar, crear). Para saber más sobre los esquemas de pantalla, ir a: http://www.atlassian.com/software/jira/docs/v3.13/issuetype_screenschemes.html

• Esquema de workflow (sólo Enterprise) – el esquema de workflow determina qué volúmenes de trabajo (tipos de transiciones de estado) se aplican para diversos tipos en este proyecto.

• Módulos CVS - configura CVS integration para este proyecto. Ir a: http://www.atlassian.com/software/jira/docs/v3.13/cvs_integration.html

• Configuración del correo – especifica la dirección del remitente para los e-mails enviados desde este proyecto. Sólo disponible si un servidor de correo SMTP ha sido configurado en JIRA.

• Categoría del proyecto (sólo Enterprise) – una categoría lógica para agrupar este proyecto. Útil para administrar muchos proyectos relacionados. Se pueden crear nuevas categorías por medio del enlace 'Categorías de proyecto' en el menú de Administración.

Asimismo:

• Componentes – grupos lógicos a los cuales pueden pertenecer estos tipos de proyectos.

• Versiones – las versiones definidas en el proyecto.

Una nota sobre los administradores del proyecto

Un administrador de proyectos de JIRA es alguien que tiene permisos para un proyecto específico, pero no necesariamente los permisos globales de administrador de JIRA.

Un administrador de proyectos puede:

• Editar el nombre del proyecto. • Editar la descripción del proyecto. • Editar la URL. • Editar el proyecto principal. • Editar la pertenencia a un rol de proyecto. • Definir versiones de proyecto.

*Sólo en la edición Enterprise. En las ediciones Profesional y Standard, sólo un administrador global puede editar una pertenencia a un rol de proyecto.

Recursos adicionales

• Añadir un tutorial de proyecto.

17

Configurar campos y pantallas: Visión general

Para ayudarte a adaptar JIRA a tus necesidades, puedes manipular la disposición y funcionamiento de los diferentes campos (resumen, descripción, etc.).

Puedes:

• Cambiar la descripción de un campo. • Poner un campo como invisible o visible. • Poner un campo como obligatorio u opcional. • Añadir tus propios valores para ‘prioridad’, ‘resolución’, ‘estado’ y ‘'Tipo de

incidencia' • Crear nuevos campos a medida. • Habilitar texto enriquecido para algunos campos. • Posición de los campos en la pantalla. • Elegir la pantalla que sería mostrada para cada tipo de operación (crear tipo,

editar tipo) o transición de workflow (resolver tipo, cerrar tipo).

Conceptos

Conceptos clave del JIRA:

• Configuración de campo — un conjunto de definiciones para todos los campos, composición: cada descripción del campo; si cada campo es visible o no; si cada campo es obligatorio u opcional; y qué tipo de presentación se usa para cada campo de texto.

• Pantalla — define qué campos están presentes en una pantalla y su orden. (Comprueba que un campo invisible puede estar presente en una pantalla, pero aún será invisible)

• Esquema de pantalla — asocia diferentes pantallas con diferentes tipos de operaciones (por ejemplo 'Crear Incidencia', 'Editar incidencia', 'Ver incidencia') y proyectos (sólo en edición Profesional).

• (óolo edición Enterprise) Esquemas de pantalla de tipos de incidencias, esquemas de pantalla asociados con tipos diferentes y proyectos.

• (sólo edición Enterprise) Esquema de configuración de campos Field Configuration Scheme — associates Field Configurations with tipos de incidencias y proyectos. Para saber más sobre los esquemas de configuración de campos, ir a: http://www.atlassian.com/software/jira/docs/v3.13/issuefield_configuration_schemes.html

• (Sólo ediciones Professional y Enterprise) Esquemas de tipos de incidencias asociadas con proyectos.

Edición: Configuración básica

En la edición Standard, tienes una configuración de campos y un esquema de pantalla globales. No se aplica ningún cambio que hagas en la configuración de campos a todos los proyectos.

18

Edición profesional: Pantallas por proyecto

La edición profesional proporciona múltiples esquemas de pantalla. Cada proyecto tiene un esquema de pantalla. Cada esquema de pantalla puede tener diferentes pantallas asociadas con diferentes tipos de operaciones. Por ejemplo, puedes tener diferentes pantallas ‘Editar’ de un proyecto a otro. Una vez que has creado los esquemas de pantalla, puedes reutilizar el mismo esquema para múltiples proyectos.

Observa que, en la edición profesional, ningún cambio que hagas en la configuración de campos, pantallas o esquema de pantalla se aplica a todos los proyectos.

Edición Enterprise: Pantallas y configuración de campos por proyecto y tipo de incidencia

JIRA añade más flexibilidad en la edición Enterprise al proveer de diferentes pantallas y configuraciones de campo por tipo de incidencia.

Cada proyecto tiene un esquema de pantalla por tipo de incidencia. Estos esquemas te permiten asociar esquemas de pantalla con tipos de incidencias. Esto te permite especificar diferentes pantallas para la misma operación (por ejemplo, 'Crear Incidencia') en el mismo proyecto por incidencias de diferentes tipos. Por ejemplo, podrías usar una pantalla cuando crees una incidencia de tipo 'Bug', y una pantalla diferente cuando crees una incidencia de tipo 'Task' (tarea).

Además, cada proyecto tiene un esquema de configuración de campo. Los esquemas de configuración de campo te permiten asociar configuraciones de campo con tipos de incidencias. Esto te permite especificar un funcionamiento de campo diferente para el mismo campo en el mismo proyecto para incidencias de diferentes tipos.

19

Volumen de trabajo de JIRA (Workflow)

El workflow de JIRA es el conjunto de pasos y transiciones que una incidencia lleva a cabo durante su ciclo de vida.

Todas las ediciones de JIRA son lanzados con un workflow por defecto. El workflow por defecto no puede ser editado, pero en las ediciones de JIRA Enterprise y Profesional puedes personalizar el ciclo de vida creando volúmenes de trabajo adicionales:

• JIRA Enterprise soporta workflow activos múltiples. Cada workflow puede ser asociado a proyectos particulares y (opcionalmente) a tipos de incidencias.

• JIRA Profesional soporta sólo un volumen de trabajo activo. Esto es, en JIRA Profesional no se puede definir ningún número de workflow, pero todas las incidencias en el sistema deben usar sólo uno de los workflow definidos en algún momento.

Crear un workflow

\ Entra en JIRA con el perfil de administrador.

\ Ve a la página de administración clicando en el enlace de administración en la barra superior o en el título del icono de administración en el panel de controles (tablero de mandos).

\ A mano izquierda en el panel de navegación, bajo 'Global Settings', clica en el enlace de workflow. \ Aparecerá la página de Ver workflow, listando todos los workflow que están definidos actualmente en tu sistema JIRA:

20

Nota Esta captura de pantalla muestra cómo la página aparece en la edición Enterprise de JIRA. La edición Profesional no soporta los esquemas de workflow y podría no tener, por lo tanto, la columna de esquemas. \ Para crear un workflow, o:

• Crear un workflow en blanco usando el formulario Añadir Nuevo workflow debajo de la página:

1. En el campo ‘nombre’, escribe un nombre (normalmente 2-3 palabras) para identificar tu nuevo workflow.

2. (Opcional) En el campo ‘descripción, escribe una descripción detallada de tu nuevo workflow.

3. Clica en el botón de añadir.

Tu nuevo workflow constará de un paso, llamado ‘abrir’, que tiene una transición entrante llamada ‘crear’.

• Copiar un workflow existente (esto es útil si quieres tener un workflow similar a lo que tú necesitas) clicando en el enlace siguiente de ‘copiar’ en un workflow existente:

1. En el campo ‘nombre’, escribe un nombre (normalmente 2-3 palabras) para identificar tu nuevo workflow.

2. (Opcional) En el campo ‘descripción, escribe una descripción detallada de tu nuevo workflow.

3. Clica en el botón de copiar.

Tu nuevo workflow constará de los mismos pasos y transiciones como el workflow que copiaste.

Nota:

21

Si estás copiando el workflow por defecto de JIRA y deseas renombrar las transiciones, necesitarás borrar el 'jira.i18n.title' y las propiedades de todas las transiciones del 'jira.i18n.description'. Si no, los nombres por defecto permanecerán.

\ Una vez has creado tu nuevo workflow podrías querer personalizarlo añadiendo o editando pasos y transiciones — especialmente si has creado un volumen de trabajo en blanco. \ Cuando hayas acabado de personalizar tu nuevo workflow, para saber cómo usarlo ir a Activating Workflow en el siguiente enlace: http://www.atlassian.com/software/jira/docs/v3.13/activating_workflow.html

Editar un workflow

El proceso para editar un workflow difiere dependiendo de si estás editando un workflow inactivo o un workflow activo. Las restricciones son reemplazadas por las modificaciones que puedes hacer en un workflow activo, debido al impacto que los cambios tendrán en los proyectos y/o tipos de incidencias en que el workflow es aplicado.

Editar un workflow inactivo

Editar un workflow significa que vas a modificar los pasos y transiciones que constituyen un workflow.

Editar un workflow activo

Un workflow activo puede ser editado de manera similar a como se edita un workflow inactivo. Podrás hacer cambios rápidos en una versión de prueba en el workflow con el beneficio de poder hacer validaciones en tiempo real. Una vez que publicas tus cambios, también tienes la opción de guardar tu viejo workflow como una copia de seguridad inactiva. Sin embargo, ten en cuenta las siguientes limitaciones que se aplicarán con la edición de un workflow inactivo:

• Los pasos de un workflow existente no pueden ser borrados. • El estado asociado a cada paso existente no puede ser editado. • Los identificadores de pasos existentes no pueden ser cambiados.

Si deseas hacer alguna de las modificaciones anteriores, necesitarás copiar el workflow, modificar la copia y activarla. Observa que este método será significativamente más lento, particularmente para largas instancias de JIRA.

Para editar un workflow activo:

1. Entra con perfil de administrador en el JIRA. 2. Ve a la página de administración clicando en el enlace de administración en la

barra superior o en el icono de administración en el panel de mandos:

22

3. A mano izquierda en el panel de navegación, debajo de 'Global Settings', clica en el link de workflow.

4. Aparecerá la página de ver workflow mostrado bajo 'Crear un workflow'’. Clica en el link de Pasos siguiente al workflow que desees editar.

5. La página de los pasos del workflow aparecerá. Clica en crear una versión de workflow en la información del mensaje que aparecerá arriba en la pantalla.

6. La página de Pasos de workflow se volverá a cargar, como se muestra abajo. Ahora podrás editar una versión del workflow. Cualquier cambio que hagas en esta versión no afectará al workflow activo hasta que publiques tu versión..

7. Cuando has completado tus cambios, clica en el enlace de publica esta versión en el mensaje informativo que aparece en la parte de arriba de la pantalla.

8. Aparecerá una pantalla de confirmación:

23

Selecciona si deseas guardar el workflow original como una copia inactiva. Si eliges conservar el workflow original, introduce un nombre para la copia inactiva. Clica en publicar para publicar tu versión.

Sobre los pasos y transiciones

Un workflow contiene pasos y transiciones:

• Un paso representa un escenario en un workflow para una incidencia. Una incidencia puede existir en sólo un paso en un punto determinado en el tiempo. Cada paso de workflow corresponde a (y es frecuentemente llamado) un estado 'enlazado'. Cuando una incidencia se traslada a un paso determinado, su campo de 'Status' (estado) se actualiza al valor de estado enlazado (linked).

Cuando definimos un paso, puedes opcionalmente especificar propiedades — éstas te permiten hacer una incidencia no editable mientras esté en un paso.

• Una transición es un enlace entre dos pasos. Una transición permite a una incidencia moverse de un paso a otro. Para que una incidencia sea capaz de progresar de un paso determinado a otro, debe existir un enlace entre estos dos pasos. Observa que una transición es un enlace de sentido único, así que si una incidencia necesita volver y así sucesivamente entre dos pasos, se necesitan crear dos transiciones.

Las transiciones del workflow disponibles para una incidencia son listadas en la página de 'Ver incidencia' de la incidencia. Un usuario puede ejecutar una transición (por ejemplo, mover la incidencia a través del workflow) clicando en uno de los enlaces disponibles.:

Cuando se define una transición, puedes opcionalmente especificar:

o Una pantalla para ser visualizada por el usuario — esto es útil si necesitas que el usuario escriba mensajes antes de completar la transición.

o Condiciones — éstas controlan quién puede ejecutar una transición (por ejemplo, quién puede ver el enlace de transición en la página de 'Ver incidencia').

o Validadores — estos comprueban que ningún mensaje del usuario sea válido antes de ejecutar la transición.

24

o Funciones Post — éstas llevan a cabo acciones particulares después de que se haya completado la transición:

� Asigna la incidencia a un usuario determinado. � Envía una notificación por e-mail. � Actualiza un campo en la incidencia.

En el diagrama del workflow por defecto (diagram of the default workflow), las cinco casillas representan pasos o estados ('abierto', 'en progreso’, 'cerrado', etc) y las flechas representan las transiciones. Para saber más sobre el diagrama del workflow por defecto, ir a: http://www.atlassian.com/software/jira/docs/v3.13/default_workflow.html

Una nota sobre incidencias 'abiertas' y 'cerradas'

Dentro de JIRA (en el portal 'Asignado a mí' y otros portales), una incidencia se abre o se cierra según el valor de su campo ’'Resolución' — no su campo 'Estado'.

• Una incidencia se abre si no se ha indicado su campo 'Resolución'. • Una incidencia se cierra si su campo 'Resolución' tiene un valor ('fijo', 'no se

puede reproducir').

Esto es verdad a pesar del valor actual del campo de estado de la incidencia ('abierto', 'en progreso', etc.).

Así que si necesitas tu workflow para forzar que una incidencia sea abierta o cerrada, necesitarás poner el campo de resolución de la incidencia durante una transición. Hay dos maneras de hacer esto:

• Pon automáticamente el campo de resolución mediante post funciones. Para saber más sobre las post funciones, ir a: http://www.atlassian.com/software/jira/docs/v3.13/workflow.html#postfunctions

• Obligar al usuario a elegir una resolución mediante una pantalla.

Añadir un paso

Para añadir un nuevo paso a un workflow:

1. Entra con perfil de administrador en JIRA. 2. Ve a la página de administración clicando en el enlace de 'Administración' en la

barra de arriba o en el icono de Administración en el panel de controles:

3. A mano izquierda en el panel de navegación, debajo de 'Global Settings', clica en el enlace de workflow.

4. La página de Ver workflows será mostrada, así como el mostrado encima de Creando un workflow. Clica en el enlace de Pasos, próximo al workflow en el que desees añadir un paso.

25

5. Se abrirá la página de 'Pasos de Workflow' , mostrando los pasos que tiene dicho workflow, y cada estado asociado con el paso y transiciones:

El formulario de Añadir nuevo paso aparece debajo de la lista de pasos. (Nota: este formulario sólo será mostrado si el workflow está inactivo o estás editando un workflow activo).

6. En el campo Nombre de paso, escribe un nombre corto del paso. (Nota: a menudo es útil usar el nombre del estado correspondiente.)

7. En el campo de 'Linked Status', selecciona el estado correspondiente a este paso. Observa que cada estado puede sólo corresponderse con un paso en cada workflow, así que si todos los estados están ya enlazados a los pasos en este workflow, podrás necesitar definir un nuevo estado.

8. Clica en el botón de añadir. La página de los pasos de workflow ahora mostrará tu nuevo paso en la lista.

9. Si deseas ver los detalles de Nuevo paso, clica en el nombre del paso. La página de 'Ver pasos de workflow' aparecerá, mostrando los pasos:

o Estado enlazado ('abierto' en la captura de pantalla de abajo). o Transiciones entrantes (Incoming Transitions) — que son transiciones

de las cuales que tienen un paso de destino. � Para permitir que las incidencias se modifiquen en este paso debe

haber al menos una transición entrante. o Transiciones salientes (Outgoing Transitions) — que son transiciones

que tienen un paso de origen.

26

� Para permitir que las incidencias se modifiquen en este paso, debe haber al menos una transición saliente.

Desde esta página puedes:

o Editar el nombre del paso o Estado enlazado (Linked Status), clicando en el enlace Editar.

o Ver y editar las propiedades del paso. o Ver y editar alguna de las transiciones entrantes o salientes, clicando en

el nombre de una transición. o Añadir una transición saliente al paso. o Borrar una transición saliente.

Usar propiedades de los pasos

Puedes usar las propiedades de los pasos para prevenir incidencias desde que son editadas cuando están en pasos de workflows determinados. Por ejemplo, en el workflow por defecto de JIRA, las incidencias con el estado de cerrado no se pueden editar, incluso por usuarios que tienen permiso de edición de incidencias. Observa que las incidencias no pueden ser editadas ni actualizadas usando Bulk Edit.

Para parar las incidencias que son editables en un paso particular, pon la propiedad de 'jira.issue.editable' del paso a falso como sigue:

1. Entrar con perfil de administrador en JIRA. 2. Ve a la página de administración clicando en el enlace de administración en la

barra superior o en el icono de administración en el panel de controles:

3. A mano izquierda en el panel de navegación, debajo de 'Global Settings', clica en el enlace de 'Workflows'.

4. La página de 'Ver Workflows' se mostrará como se muestra abajo en 'Creando

un workflow'. Clica en el enlace de 'Pasos' próximo al workflow cuyo paso deseas hacer no editable.

27

5. La página de 'Pasos de Workflow' se mostrará, mostrando los pasos que se ejecutan en el workflow.

6. Clica en el enlace de 'Ver propiedades' que se corresponde con el paso relevante.

7. La página de 'Ver las propiedades de los pasos del workflow' será mostrada, mostrando las propiedades existentes del paso (si hay). El formulario de añadir nueva propiedad aparece debajo de la lista de pasos. (Nota: este formulario sólo será mostrado si el workflow es inactivo o estás editando un wokflow activo.)

8. En el campo de 'Clave de la propiedad', escribe: jira.issue.editable. 9. En el campo de ‘Valor de la propiedad’, escribe: falso. 10. Clica en el botón Añadir.

Borrar un paso

Nota: un paso sólo puede ser borrado si no tiene transiciones entrantes.

Para borrar un paso de un workflow:

1. Entrar con perfil de administrador en JIRA. 2. Ve a la página de administración clicando en el enlace de administración en la

barra superior o en el icono de administración en el panel de controles:

3. A mano izquierda en el panel de navegación, debajo de 'Global Settings', clica en el enlace de 'Workflows'.

4. La página de 'Ver Workflows' se mostrará como se muestra abajo en 'Creando

un workflow'. Clica en el enlace de 'Pasos' próximo al workflow cuyo paso deseas borrar.

5. La página de 'Pasos de Workflow' se mostrará. 6. Clica en el enlace de borrar que corresponda a un paso relevante. (Nota: este

enlace será mostrado si el paso no tiene transiciones entrantes. Un paso de un workflow no puede ser borrado si es el destino de una transición)

Añadir una transición

Para añadir una nueva transición a un workflow:

1. Entrar con perfil de administrador en JIRA. 2. Ve a la página de administración clicando en el enlace de administración en la

barra superior o en el icono de administración en el panel de controles:

28

3. A mano izquierda en el panel de navegación, debajo de 'Global Settings', clica en el enlace de 'Workflows'.

4. Se mostrará la página de Ver workflow debajo de Creando un workflow. Clica en el enlace de Pasos próximo en el workflow al que desees añadir una transición.

5. La página de Pasos de Workflow se mostrará, mostrando los pasos que forman el workflow, y el estado enlazado de cada paso y transiciones salientes:

6. Identificar el paso del cual se originará tu nueva transición y clica en añadir transición próxima al paso. La página de 'Añadir transición al workflow' aparecerá:

29

7. En el campo 'Nombre de transición', escribe un nombre corto para la transición. (Nota: este nombre se mostrará a los usuarios como enlace de transición en la lista de Acciones disponibles en el workflow en la página de Ver incidencia.)

8. (Opcional) En el campo descripción, escribe una corta descripción del propósito de la transición.

9. En el campo 'Paso de destino', elige el paso cuyas incidencias cambiarán cuando la transición sea ejecutada.

10. En el campo 'Ver transición' , elige o: o 'Sin vista para la transición' — elige esto si no necesitas obligar a que el

usuario entre antes de que la transición sea ejecutada (por ejemplo, la transición ocurrirá instantáneamente cuando el usuario cliquee en el enlace de transición).

o El nombre de una pantalla que será mostrado a los usuarios, solicitando la entrada antes de que la transición sea ejecutada. Puedes elegir una de las pantallas por defecto de JIRA (nota: muchas de estas son usadas en el workflow por defecto y son denominados por sus transiciones, por ejemplo 'Empezar progreso' y 'Resolver incidencia'), o alguna otra pantalla que hayas creado. Si no hay pantallas existentes, podrías querer crear una nueva pantalla. Para saber cómo crear una nueva pantalla, ir a: http://www.atlassian.com/software/jira/docs/v3.13/fieldscreens.html

Usar una pantalla

Puedes usar una pantalla para reunir las entradas de un usuario antes de que una transición determinada sea ejecutada.

Ejemplo: usar una pantalla para poner el campo de resolución

Para un paso determinado en un workflow, podrías necesitar crear una transición que cambiará la incidencia a un estado cerrado (e.g. 'cerrada', 'resuelta', etc) — ver 'open' and 'closed' issues en el siguiente enlace: http://www.atlassian.com/software/jira/docs/v3.13/workflow.html#workflow_resolutions. Como parte de esta transición, podrías necesitar al usuario para colocar el campo de resolución. Para hacer esto:

1. Crear una pantalla, por ejemplo, llamada 'Pantalla de incidencia resuelta', que contiene el campo de resolución (y otros campos que quieras mostrar).

2. Crear/editar tu transición, y elegir 'Pantalla de incidencia resuelta' en el campo de Ver transición:

30

Añadir una condición

Las condiciones controlan quien puede ejecutar una transición, y bajo qué circunstancias. Si una condición falla, el usuario no verá el enlace de transición en la página de Ver incidencia.

JIRA viene con las siguientes condiciones incorporadas, los cuales están disponibles para añadir transiciones:

Condición Explicación

Condiciones del asignador

Sólo permitir que el asignador actual de la incidencia ejecute la transición.

Condiciones del informador

Sólo permite al informador de la incidencia ejecutar la transición.

Condiciones del permiso

Sólo permitir a los usuarios con un permiso asignado ejecutar la transición.

Condición de bloqueo de subtarea

Bloquea la transición de la incidencia según el estado de la subtarea. Para saber más sobre las subtareas, ir a: http://www.atlassian.com/software/jira/docs/v3.13/subtasks_creating.html

El usuario que está en un grupo

Sólo permitir a los usuarios de un grupo determinado ejecutar la transición.

El usuario que está dentro de un grupo con un campo determinado

Sólo los usuarios en un campo (de tipo grupo) pueden ejecutar una transición.

Usuarios de un rol proyecto

Sólo permitir a los usuarios en un rol de proyecto dado ejecutar una transición.

31

(Puedes también crear tus propias condiciones mediante el plugin system). Para saber más sobre el sistema plugin, ir a: http://www.atlassian.com/software/jira/docs/v3.13/subtasks_creating.html

Para añadir una condición a una transición:

1. Entra con perfil de administrador en JIRA. 2. Ve a la página de administración clicando en el enlace de administración o en el

icono de de administración de la barra superior en el tablero de mandos:

3. A mano izquierda en el panel de navegación, debajo de 'Global Settings', clica en el link de 'Workflows'.

4. La página de 'Ver Workflows' aparecerá debajo de Creando un workflow. Clica en 'Pasos' próximo al workflow al cual desearías añadir una condición.

5. Aparecerá la página de 'Pasos de Workflow', mostrando los pasos que hacen el workflow, y cada paso de estado enlazado y transiciones salientes.

6. Clica en el nombre de la transición a la cual deseas añadir una condición. Aparecerá la página de 'Ver transición de workflow’:

7. Clica en la pestaña de 'Condiciones'. Aparecerá una lista de las condiciones asociadas a las transiciones.

8. Clica en Añadir. Aparecerá una lista de todas las condiciones disponibles. 9. Selecciona una condición de la lista y clica en añadir. 10. Si la condición requiere uno o más parámetros de configuración (ejemplo, el

nombre de un grupo o rol de proyecto), aparecerá la página de añadir parámetros a una condición. Introduce tus criterios y clica en añadir.

11. Aparecerá la pestaña de Condiciones, mostrando tu nueva condición debajo de la lista de condiciones.

Nota: desde aquí puedes:

o Clicar en el enlace de editar próximo al nombre de la condición para editar sus parámetros de configuración (si hay alguno).

32

o Clicar en el link de borrar próximo al nombre de la condición para quitar la condición

o Combinar tus condiciones en 'AND'/'OR' grupos.

Combinar las condiciones con los grupos

Puedes montar condiciones complejas combinando condiciones individuales juntas para formar grupos de condiciones, usando un AND o un OR. Por ejemplo, se puede construir el siguiente grupo de condiciones:

• Sólo el que tiene la incidencia asignada puede ejecutar esta transición • AND • Sólo los usuarios del grupo de usuarios del JIRA puede ejecutar esta transición.

La condición pasará si el usuario es el que gestiona la incidencia y el usuario está en el grupo de usuarios del JIRA.

Los grupos con múltiples condiciones pueden ser combinados para construir incluso las más complejas condiciones. Cada par de grupos de condiciones puede ser combinado usando un booleano AND u OR. Dependiendo de la estructura de la condición global y sus grupos, la condición pasará una vez que uno o todos los grupos de condiciones han sido satisfechos, por ejemplo:

Añadir un validador

Los validadores comprueban que alguna entrada de usuario sea válida antes de ejecutar la transición. Por ejemplo, un validador puede ser usado para asegurar que el comentario introducido por un usuario en la pantalla de transición cumple unos ciertos criterios. Si un validador falla, las post funciones de la transición no serán ejecutadas y la incidencia no progresará al paso de destino de la transición.

JIRA envía con un número de validadores por defecto, que están disponibles para añadir tus transiciones. Puedes también crear tus propios validadores mediante el sistema plugin.

Nota ¿Cuál es la diferencia entre condiciones y validadores? Las condiciones se usan para determinar si una transición puede ser ejecutada. Las condiciones no pueden validarse

33

dentro de unos parámetros que son proporcionados por el usuario en la pantalla de transición, si la condición falla al usuario no le está permitido empezar la ejecución de la transición y así no verá la pantalla de transición. Los validadores tienen acceso a la entrada que ha sido acumulado desde el usuario mediante la pantalla de transición, y de este modo pueden validar esa entrada.

Para añadir un validador a una transición:

1. Entra con perfil de administrador en JIRA. 2. Ve a la página de administración clicando en el enlace de administración en la

barra superior o en el título del icono de administración en el tablero de controles:

3. A mano izquierda en el panel de navegación, debajo de 'Global Settings', clica en el enlace de 'Workflows'.

4. Se mostrará la página de 'Ver Workflows' debajo de 'Crear un workflow' . Clica en el enlace de Pasos próximo al workflow al cual desees añadir una condición.

5. Se mostrará la página de Pasos de workflow, mostrando los pasos que componen el workflow, y el estado enlazado de cada paso y transiciones salientes.

6. Clica en el nombre de la transición en la cual desees añadir un validador. Se mostrará la página de Ver transición de workflow.

7. Clica en la pestaña de validadores. 8. Clica en el enlace de añadir. Una lista de validadores disponibles se mostrará. 9. Selecciona un validador de la lista y clica en el botón de añadir. 10. Si el validador requiere uno o más parámetros de configuración (por ejemplo. el

nombre de un grupo o rol de proyecto), la página de añadir parámetros a un validador se mostrará. Introduce tus criterios y clica en el botón de añadir.

11. La pestaña de validadores se mostrará, mostrando tu Nuevo validador debajo de la lista de validadores.

Nota: desde aquí puedes:

o Clica en el enlace de editar próximo al nombre del validador para editar sus parámetros de configuración (si los hay).

o Clica en el enlace de borrar próximo al nombre del validador para eliminar el validador.

Añadir una post función

Las post funciones llevan a cabo algunos procesos inmediatamente después de que una transición sea ejecutada (de ahí el nombre post función), como actualizando los campos de una incidencia, generando cambios en una incidencia, añadiendo un comentario a una incidencia, generando un evento (por ejemplo. una notificación por e-mail).

34

El workflow por defecto incluye un número de transiciones por defecto. Además, JIRA lleva a cabo las siguientes post funciones esenciales, que son automáticamente añadidas a cada transición creada de nuevo:

Post funciones esenciales

Poner el estado de una incidencia a estado enlazado del paso del workflow de destino.

Añadir un comentario a una incidencia si es introducido durante una transición.

Actualizar la historia de cambios para una incidencia y almacenar la incidencia en la base de datos.

Reindexar una incidencia para guardar índices en sincronización con la base de datos.

Lanzar un evento que puede ser procesado por los que visualizan las incidencias.

Las post funciones esenciales no pueden ser borradas, o reordenadas. Sin embargo, puedes insertar otras post funciones entre ellas.

JIRA incorpora cuatro post funciones que puedes opcionalmente añadir a tus transiciones:

Post funciones opcionales

Explicación

Asignar a un usuario actual

Asigna la incidencia al usuario que está ejecutando la transición. (Nota: Estas post funciones serán ignoradas a menos que el usuario tenga el permiso de 'Assignable User'. Podrías querer usar una condición para asegurarte de que la entrada al sistema del usuario tenga este permiso antes de ejecutar la transición)

Asignar al desarrollador

Asigna la incidencia al componente principal (si existe) o al líder del proyecto.

Asignar al creador de la incidencia

Asigna la incidencia al usuario que creó la incidencia.

Campo de actualización de la incidencia

Actualiza uno de los campos de incidencia a un valor dado. Los campos actualizables son:

• 'Asignación' • 'Descripción' • 'Entorno' • 'Prioridad' • 'Resolución' • 'Resumen' • 'Estimación original' • 'Tiempo estimado'

Observa que esta post función no puede actualizar campos a medida.

(Puedes también crear tus propias post funciones mediante el sistema plugin.

35

Observa que cuatro post funciones opcionales deben estar posicionadas antes de la post function de actualizar historial de cambios para una incidencia y almacenar la incidencia en la base de datos, excepto cuando son usadas en la transición de Crear.

Nota Una nota en lo que concierne a la transición crear: A veces es útil hacer procesos particulares (por ejemplo, poner un campo particular) cuando se crea primero una incidencia. Puedes hacer esto para añadir post funciones a la transición inicial del workflow, que es ejecutado donde un usuario crea una incidencia, y pone la incidencia creada nuevamente en el paso inicial del workflow. El paso inicial es simplemente el primer paso en un workflow; cada workflow tiene uno, y sólo uno, paso inicial (llamado abrir por defecto, por ejemplo si creaste un workflow en blanco o copiaste el workflow por defecto). La transición inicial (llamada crear por defecto) es la primera transición entrante del paso inicial. Cuando añadas una de las post funciones a la transición crear del workflow (por ejemplo, podrías usar la transición de actualizar el campo de la incidencia para poner el campo de un determinado usuario cuando se crea una incidencia), observa que necesitas ponerlo antes de la post función Crear la incidencia desde cero por defecto de la de transición de crear. Caso especial: Si necesitas poner el campo de resolución cuando crees una incidencia, pon la post función de 'Actualizar campo de incidencia' después de la post función por defecto de 'Crear la incidencia desde cero', y usa la post función 'Almacenar incidencia' después de eso. Observa que el uso de la post función 'Almacenar incidencia’ (que está disponible sólo para la transición de crear) debería ser guardado como mínimo, no genera historial de cambios y no sirve para conservar los campos que tengan una relación de uno a muchos con la incidencia (por ejemplo, 'Versión' o 'Componente').

Para añadir una post función a una transición:

1. Entra con perfil de administrador en JIRA. 2. Ve a la página de administración clicando en el enlace de administración o en el

icono de administración del panel de controles:

3. A mano izquierda en el panel de navegación, debajo de 'Global Settings', clica en el enlace de 'Workflows'.

4. Se mostrará la página de Ver workflows debajo de Crear un workflow. Clica en el enlace de pasos próximo al workflow en el cual desees añadir una condición.

5. Saldrá la página de 'Pasos de Workflow' , mostrando los pasos que componen el workflow, y el estado enlazado de cada paso y transiciones salientes.

6. Clica en el nombre de la transición en la cual desees añadir una post función. Se mostrará la página de Ver transición de workflow.

7. Clica en la pestaña de Post funciones. Se mostrará una lista de post funciones existentes de la transición. Por ejemplo, el workflow por defecto tiene las siguientes post funciones para la transición Empezar progreso:

36

8. Clica en el enlace de añadir. Se mostrará una lista de post funciones disponibles. 9. Si la post function require uno o más parámetros de configuración (como el

nombre de un evento), saldrá la página de Añadir parámetros a una post función. Introduce la información apropiada y clica en el botón de añadir.

10. The 'Post Functions' tab will be displayed, showing your new post function at the bottom of the list of post functions.

Nota: desde aquí puedes:

o Clica en el enlace de añadir próximo al nombre de la post función para editar sus parámetros de configuración (si los hay).

o Clica en el enlace de borrar próximo al nombre de la post función para eliminar la post función.

o Clica en el enlace de 'Subir' para cambiar la post función más alta de la lista (i.e. será ejecutada antes).

o Clica en el enlace de Bajar para cambiar la post función más baja de la lista (i.e. será ejecutada después).

Usar una post función para poner un campo

Puedes usar una post función de tipo 'Actualizar campo de la incidencia' para colocar el valor de un campo de incidencia después de que una transición determinada sea ejecutada.

Ejemplo: usar una post función para colocar el campo de resolución

Para un paso particular en un workflow, podrías necesitar crear una transición para cambiar la incidencia a un estado cerrado (por ejemplo, cerrada, resuelta, etc.). Como parte de esta transición, podrías querer poner automáticamente el campo de resolución. Para hacer esto:

1. Crea/edita tu transición. En el campo de Ver transición, o selecciona “sin vista para la transición” o eliges una pantalla que no contenga el campo de resolución (e.g. la pantalla de 'Añadir comentario y asignación').

37

2. Añade una nueva post función de tipo 'actualizar campo de incidencia'. Selecciona 'Resolución' de la lista de selección 'Campo de la incidencia' y selecciona una resolución apropiada de la lista de selección 'Valor del campo'.

3. Una vez completada, la lista de transición de post funciones aparecerá como sigue:

Para crear una transición que elimine el campo de resolución, sigue los mismos pasos pero selecciona ninguno en la lista de selección 'Valor de campo' cuando se añada la post función. La lista de post funciones para esta transición incluirá la siguiente declaración:

La resolución de la incidencia será borrada.

Cada vez que una de estas transiciones sea ejecutada, la resolución de la incidencia es automáticamente colocada o no como especificado en estas post funciones.

Usar una post función para enviar una notificación

Puedes usar una post función de tipo 'Lanzar un evento que puede ser procesado por los que asignan la incidencia' a lanzar el evento genérico. El evento genérico es un evento de JIRA incorporado cuyo propósito es permitirte enviar notificaciones por e-mail después de que una transición sea ejecutada.

Alternativamente, puedes lanzar un evento que has creado específicamente para esta transición. Ir al siguiente enlace: http://www.atlassian.com/software/jira/docs/v3.13/events.html#addcustomevent

Cuando una transición es llevada a cabo, JIRA:

• Buscará el esquema de notificación asociado con el proyecto de la incidencia, e identificará a los usuarios asociados con el evento lanzado;

• Enviará una notificación por e-mail a cada usuario.

38

(Nota que el evento lanzado es también propagado a todos los que gestionan incidencias que estén registrados)

Ejemplo: usar una post función para lanzar el evento genérico

Puedes usar el evento genérico para enviar notificaciones por e-mail. Para hacer esto:

1. Crea/edita tu transición. 2. Ve a la pestaña de Post funciones de la transición y edita la post función de

'Lanzar un evento que puede ser procesado por los que gestionan la incidencia. 3. En la página de 'Añadir parámetros a la post función', selecciona evento

genérico de la lista de eventos.

Trabajar con propiedades de transición

Las propiedades son pares de valores clave que pueden ser usados para personalizar transiciones. Por ejemplo, las propiedades de la transición ayudan a extender el workflow por defecto para permitir traducciones de idioma.

Para ver las propiedades de una transición:

1. Entra con perfil de administrador en JIRA 2. Ve a la página de administración clicando en el enlace de administración o en el

icono de administración en el panel de controles:

3. A mano izquierda en el panel de navegación, debajo de 'Global Settings', clica en el enlace de 'Workflows'.

4. Se mostrará la página de 'Ver Workflows' debajo de Crear un workflow. Clica en el enlace de Pasos próximo al workflow en el cual quieras añadir una condición.

5. Se mostrará la página de Pasos de workflow, mostrando los pasos de los que se compone el workflow, y el estado enlazado de cada paso y transiciones salientes.

6. Clica en el nombre de la transición en la cual desees ver las propiedades. Se mostrará la página de Ver transición de workflow.

7. Clica en el enlace de Ver propiedades de esta transición. La página de Ver transición de workflow saldrá y saldrá una lista de todas las propiedades que actualmente forman la transición. Puedes también añadir y borrar propiedades para esta transición en esta página.

Usar transiciones comunes

Una transición común es una transición que es definida sólo una vez en el workflow, pero puede ser usado más de una vez. Esto es, una transición común puede tener más de un paso originándose. La ventaja de las transiciones comunes es que si una transición necesita ser actualizada, la actualización sólo tiene que ser hecha en un único lugar.

39

Puedes editar transiciones comunes en JIRA, pero no pueden ser creadas por el método descrito en Añadiendo una transición. En cambio, para crear transiciones comunes, puedes elegir entre estas dos opciones:

• Copia el workflow por defecto — el workflow por defecto contiene transiciones comunes. Aunque tú no puedes editar el volumen de trabajo por defecto, puedes copiarlo y después editar sus pasos y transiciones para adaptar tus requisitos.

• Crear tu workflow en XML.

Usar XML para crear un workflow

JIRA usa OSWorkflow, un motor de volumen de trabajo flexible y personalizable. El editor de carga de trabajo de JIRA genera unos ficheros de definición OSWorkflow XML que son almacenados en la base de datos de JIRA. Si necesitas alguna característica de OSWorkflow que no está disponible en el editor de workflow de JIRA (como las transiciones comunes), puedes definir el workflow en XML y luego importarlo dentro de JIRA como se describe abajo.

Para saber más sobre OSWorkflow, ir a: http://wiki.opensymphony.com/display/WF/Documentation

Una vez que el workflow XML ha sido importado, el editor de workflow de JIRA debería ser capaz de mostrar la mayoría de definiciones OSWorkflow incluso si no soporta la creación o la edición de ellos. Por ejemplo, los resultados condicionales de las transiciones del workflow son mostradas en la pestaña de otros en la página de 'Ver transición de Workflow'. La pestaña de otros sólo es visible si una transición tiene elementos que el editor no soporta directamente.

Para importar un workflow XML dentro de JIRA:

1. Entra con perfil de administrador en JIRA 2. Ve a la página de administración clicando en el enlace de administración o en el

icono de administración en el panel de controles:

3. A mano izquierda en el panel de navegación, debajo de 'Global Settings', clica en el enlace de 'Workflows'.

4. Se mostrará la página de Ver Workflows. Localiza el formulario de añadir un Nuevo workflow en la parte de abajo de la página.

5. Clica en el enlace de importar un workflow de xml. La página de importar workflow aparecerá.

6. En el campo Nombre, escribe un nombre (normalmente 2-3 palabras) para identificar tu nuevo workflow.

7. (Opcional) En el campo Descripción, escribe una descripción detallada de tu nuevo workflow.

8. O bien:

40

o En el campo de Definición de workflow (XML), pega los contenidos del archivo xml de workflow; o bien

o En el campo Archivo, escribe la ruta completa al fichero (observa que la ruta debe ser local, i.e. necesitarás primero copiar el fichero a tu servidor de JIRA).

9. Clica en el botón de importar.

Copiar un workflow entre sistemas

A veces es útil crear un workflow en un sistema de prueba y luego copiarlo dentro de un sistema de producción. Para hacer esto:

1. En el sistema de prueba, exporta el workflow a XML clicando en el enlace de xml próximo workflow en la lista mostrada en la página de ver workflow, y guarda la salida dentro de un fichero.

2. En el sistema de producción, importa el fichero clicando en el enlace ‘Importar un workflow desde XML'.

Aviso Cuando se importa un workflow en XML dentro de JIRA: Las definiciones de workflow en XML de JIRA contienen referencias a los meta atributos de JIRA. Por ejemplo, el identificador del estado enlazado de JIRA de cada paso de workflow se almacena como un meta atributo 'jira.status.id' en la definición del paso. Por lo tanto, cuando se crean manualmente workflows en XML, asegúrate de que todas las entidades externas y referenciadas existan antes de que importes el workflow dentro de JIRA. Aviso Cuando se copia un workflow entre sistemas: Los validadores y post funciones pueden tener parámetros que podrían ser válidos en un sistema y no en otro. Por ejemplo, diferentes sistemas contienen conjuntos de valores para el campo de resolución (desde que es posible definir tus propios valores). Esto podría ser un problema si la incidencia de 'campo de actualización de incidencia' es usada para colocar el campo de resolución a un valor que existe en un sistema pero no en otro.

Migración de otros rastreadores de incidencias Cuando se migra desde otros rastreadores de incidencias, podrías desear guardar tus datos. Dependiendo de qué rastreador de incidencia estés utilizando, se recomienda usar uno de los métodos listados más abajo para importar datos en JIRA:

Cualquier método que uses, necesitarás reindexar JIRA después de que hayas hecho la importación.

Si tienes una licencia de usuario limitado (por ejemplo, licencia personal), cualquier usuario que importes, tu límite de usuarios será creado en JIRA sin permiso de acceso a JIRA. No podrás seleccionar a quiénes de tus usuarios se les asignan permisos de acceso bajo límite de usuario, cuando personalices la importación. Sin embargo, puedes cambiar esto después de que los usuarios hayan sido importados, editando permisos de usuario.

41

1. Importadores incorporados

Los importadores son: Importing Data from Bugzilla, Importing Data From Mantis y Importing Data From FogBugz. Se recomienda usar el importador incorporado, si estás migrando de uno de los sistemas de gestión de incidencias.

Para saber más, ir a los siguientes enlaces:

http://confluence.atlassian.com/display/JIRA/Importing+Data+from+Bugzilla

http://confluence.atlassian.com/display/JIRA/Importing+Data+From+Mantis

http://confluence.atlassian.com/display/JIRA/Importing+Data+From+Mantis

2. CSV Importer

Si estás migrando desde un sistema cuyo JIRA no tiene un importador incorporado, podrás importar tus datos mediante JIRA en lugar de en formato CSV. Tu sistema debe ser capaz de exportar tus datos en un fichero CSV (valores separados por comas). Puedes luego importar el fichero CSV dentro de JIRA usando el importador CSV de JIRA. Se pueden también importar los comentarios.

3. Third-party scripts

Un número de scripts third-party están disponibles en Internet que soportan la importación de datos dentro de JIRA. Estos pueden ser una mejor opción para importar datos usando el importador de CSV. Third-party scripts están actualmente disponibles para la siguiente importación de procesos:

• Importar datos de Trac dentro de JIRA • Migrando Trac a JIRA

Ten en cuenta que los scripts third-party no son soportados por Atlassian.

4. Encajar script

Otra manera es escribir un script Jelly que importará tus datos. JIRA ejecuta algunos Jelly tags que hacen operaciones como crear incidencias fácilmente en JIRA.

Para saber más sobre los Jelly tags, ir a: http://confluence.atlassian.com/display/JIRA/Jelly+Tags

5. Servicios RPC

JIRA lleva a cabo con un RPC plugin el cual habilita el acceso remoto limitado a JIRA. Está disponible a través de SOAP e interfaces XML-RPC. Recomendamos usar la interfaz SOAP cuando sea posible porque esto es más completo y será nuestro foco

42

primario en el futuro. Esta página proporciona un punto de arranque para todos tus procedimientos remotos que necesites.

Puedes encontrar las últimas noticias en el plugin RPC en el espacio de extensiones de JIRA. El origen completo del plugin está disponible y eres libre de modificar y ampliar el origen.

6. Tu propio método

Es posible usar cualquier herramienta con la que te sientas cómodo, para importar los datos directamente dentro de la base de datos de JIRA. El esquema de la base de datos de JIRA es descrito en formato XML en la web WEB-INF/classes/entitydefs/entitymodel.xml archivo bajo la aplicación web de JIRA. Cuando uses este método, mantén la integridad de la base de datos.

Moviendo o archivando los proyectos individuales

En algún momento, los requisitos de tu organización pueden cambiar. Esto puede conllevar las siguientes necesidades:

1. Archivar un proyecto completado u obsoleto. 2. Partir una instancia grande de JIRA dentro de varias instancias de JIRA, con

proyectos particulares en cada uno. 3. Restaurar un proyecto único desde un fichero de copia de seguridad dentro de

una instancia de JIRA 4. Restaurar una instancia entera de JIRA, desde una copia de seguridad dentro de

una instancia nueva y vacía de JIRA

Integrando JIRA con CVS y ViewCVS

La integración CVS de JIRA muestra la información relativa a CVS. Cuando un mensaje CVS menciona una incidencia, JIRA lo recoge y muestra el registro en una pestaña en la incidencia mencionada.

Las características de la integración CVS de JIRA:

• Habilidad para interactuar con un registro de servidor CVS directamente por acceso por vía local, protocolos de servidor o externos (ssh), o para analizar un fichero de registro CVS por un proceso externo.

• Acceso a la información de la versión de control en JIRA, que puede ser fácilmente controlada usando permisos flexibles. Si estás ejecutando una instancia pública de JIRA, y no quieres que el resto de personas vea la información de la versión de control, JIRA puede ser configurado para restringir el acceso a esa información para los usuarios elegidos.

• ViewCVS o FishEye son soportados fuera de la caja; y la subversión está disponible como un plugin (pasar extensiones a JIRA).

Para saber más sobre ViewCVS, ir a: http://www.viewvc.org/

43

Para saber más sobre FishEye, ir a: http://www.atlassian.com/software/fisheye/

• Si se configura la integración CVS, los ficheros y revisiones en JIRA son enlazados a páginas relevantes. Por ejemplo, la siguiente captura de pantalla muestra un proyecto de JIRA:

Tal como ViewCVS está configurado, JIRA ha puesto dentro la información dentro de los enlaces deViewCVS. Clicando en el nombre del fichero, nos lleva a la página de resumen en el fichero de ViewCVS.

• Cada proyecto en JIRA puede ser asociado con un módulo CVS. En JIRA Standard, un proyecto puede ser asociado con un único módulo. En las ediciones profesional e Enterprise del JIRA, un proyecto puede tener múltiples módulos.

Hay tres pasos para configurar la integración de CVS en JIRA:

1. Crear un módulo CVS 2. Asociar proyectos a módulos CVS 3. Dar permisos para ver la información CVS

Cómo trabaja la integración CVS de JIRA

JIRA recupera la información CVS para una incidencia analizando la salida del comando 'cvs rlog' (o cvs log) de cada módulo asociado y escaneándolo por la clave de la incidencia. Si la clave de la incidencia está en el mensaje, éste se mostrará en la pestaña de Control de versión para la incidencia.

Si tienes permiso en JIRA para realizar la sincronización automáticamente con el repositorio CVS, JIRA periódicamente ejecutará el comando 'cvs rlog' para el módulo y almacenará los resultados en un fichero cuya ruta es especificada por el atributo del módulo Log File Path. El fichero es después analizado.

Nota Incluso si estás usando el acceso al repositorio local, JIRA obtendrá el log CVS para el módulo y después será analizado. JIRA no accede al repositorio CVS directamente.

Si has elegido actualizar el log manualmente, JIRA sólo actualizará periódicamente el archivo CVS especificado por el atributo Log File Path del módulo.

44

Tal como JIRA actualiza el log del módulo CVS y guarda información relevante en memoria, la memoria requerida para JIRA se relaciona con el tamaño del módulo CVS.

Observa que:

• Actualmente, JIRA es capaz de recuperar el log CVS mediante acceso local, el protocolo pserver o ssh (método ext). Si tu CVS no es compatible con estos métodos puedes deshabilitar automáticamente el log de recuperación.

• Si quieres que JIRA automáticamente se sincronice con tu repositorio de CVS, la comunicación entre JIRA y el servidor CVS podrá ser de ancho de banda de intensidad equitativa de tal manera que JIRA periódicamente recuperará el log de los datos del módulo CVS del repositorio CVS. Si esto está causando problemas, considera el ajuste de frecuencias o la deshabilitación de la recuperación del log CVS.

• JIRA carga y analiza la salida del comando 'cvs log' para cada módulo CVS y guarda la información relevante en memoria. Además, los requisitos de memoria del JIRA dependen del número de la información relevante encontrada en el módulo CVS. La información relevante es información CVS que tiene como mínimo una clave potencial de JIRA en sus mensajes.

• Sólo los mensajes que contienen una posible incidencia del JIRA son enlazados a una incidencia.

• El sistema de codificación de JIRA se usa cuando analizamos los logs CVS, así que necesita ajustarse al log CVS. El sistema que codifica puede verse en Admin -> System -> System Info.

Crear módulos CVS en JIRA

Un modulo CVS se refiere a un directorio a nivel superior en un repositorio CVS. Para crear un módulo CVS:

1. Crea o decide qué directorio existente será usado para almacenar ficheros log de módulos CVS (El fichero con la salida del comando 'cvs log'). JIRA debe tener acceso de lectura y escritura al directorio. El acceso de escritura es requerido incluso si decides actualizar manualmente el log CVS, ya que JIRA necesita usar este directorio para crear un fichero cerrado con el fin de sincronizar el acceso al log del módulo CVS.

2. Entra con perfil de administrador en JIRA. 3. Ve a la página de administración clicando en el enlace de administración en la

barra superior o en el icono de administración en el panel de controles:

4. A mano izquierda en el panel, expande el submenú titulado 'Global Settings' si no está abierto todavía. Clica en el enlace 'Módulos CVS'. Esto debería llevarte a la página de 'Módulos CVS'.

5. Clica en 'Añadir Nuevo modulo CVS'. 6. Esto te llevará a la página de 'Añadir modulo CVS'.

45

Moviendo o archivando los proyectos individuales

En algún momento, las características de tu organización pueden cambiar. Esto puede llevar a necesitar:

5. Archivar un proyecto completado u obsoleto. 6. Partir una instancia grande de JIRA dentro de varias instancias de JIRA, con

proyectos particulares en cada uno. 7. Restaurar un proyecto único desde un fichero de copia de seguridad dentro de

una instancia de JIRA 8. Restaurar una instancia entera de JIRA, desde una copia de seguridad dentro de

una instancia nueva y vacía de JIRA.

46

Integrando JIRA con CVS y ViewCVS

La integración CVS de JIRA muestra la información CVS para una incidencia. Cuando un mensaje CVS menciona una incidencia, JIRA recoge esto y muestra el registro en una pestaña en la incidencia mencionada.

Las características de la integración CVS de JIRA:

• La habilidad para interactuar con un registro de servidor CVS directamente por acceso por vía local, protocolos de servidor o externos (ssh), o para analizar un fichero de registro CVS por un proceso externo.

• El acceso a la información de la versión de control en JIRA puede ser fácilmente controlada usando permisos flexibles. Si estás ejecutando una instancia pública de JIRA, y no quieres que el resto del mundo vea la información de la versión de control, JIRA puede ser configurado para restringir el acceso a esa información para los usuarios elegidos.

• ViewCVS o FishEye son compatibles fuera; y la subversión está disponible como un plugin (ver extensiones de JIRA).

• Si se configura la integración CVS, los ficheros y revisiones en JIRA son enlazados a páginas relevantes. Por ejemplo, la siguiente captura de pantalla muestra un proyecto de JIRA:

Tal como está ViewCVS configurado, JIRA ha puesto la información mostrada dentro de los enlaces deViewCVS. Clicando en el nombre del fichero que cogerá el usuario a la página de resumen en el fichero de ViewCVS. Clicando en la revisión mostrará al usuario la página que muestra los contenidos del fichero acerca de cómo fue todo en esa revisión.

• Cada proyecto en JIRA puede ser asociado con un modulo CVS. En JIRA Standard, un proyecto puede ser asociado con sólo un módulo. En las ediciones profesional e Enterprise del JIRA, un proyecto puede tener múltiples módulos.

Hay tres pasos en la configuración de la integración de CVS en JIRA:

4. Crear un módulo CVS. 5. Asociar proyectos con módulos CVS. 6. Dar permisos para ver la información CVS.

47

Cómo trabaja la integración CVS de JIRA

JIRA recupera la información CVS para una incidencia analizando la salida del comando 'cvs rlog' (o cvs log) de cada módulo asociado y escaneándolo por la clave de la incidencia. Si la clave de la incidencia está en el mensaje, éste se mostrará en la pestaña de Control de versión para la incidencia.

Si tienes permiso en JIRA para una sincronización automática con el repositorio CVS, JIRA periódicamente ejecutará el commando 'cvs rlog' para el módulo y almacenará los resultados en un fichero cuya ruta es especificada por el atributo del módulo Log File

Path. El fichero después es analizado.

Nota Incluso si estás usando el acceso al repositorio local, JIRA obtendrá el log CVS para el módulo y entonces analizarlo. JIRA no accede al repositorio CVS directamente.

Si decides actualizar el log manualmente, JIRA sólo actualizará periódicamente el archivo CVS especificado por el atributo Log Filr Path del módulo.

Como JIRA actualiza el log del modulo CVS y guarda información relevante en memoria, la memoria requerida para JIRA depende del tamaño del módulo CVS.

Ten en cuenta:

• Actualmente, JIRA es capaz de recuperar el log CVS por medio de acceso local, el protocolo pserver o ssh (método ext). Si tu CVS no es alcanzable por estos métodos puedes deshabilitar automáticamente el log de recuperación.

• Si quisieras que JIRA automáticamente se sincronice con tu repositorio de CVS, la comunicación entre JIRA y el servidor CVS podrá ser de ancho de banda de intensidad equitativa de manera que JIRA periódicamente recuperará el log de los datos del módulo CVS del repositorio CVS. Si esto está causando problemas, considera el ajuste de frecuencias o la deshabilitación de la recuperación del log CVS.

• JIRA carga y analiza la salida del comando 'cvs log' para cada módulo CVS y guarda la información relevante en memoria. Además, los requisitos de memoria del JIRA dependen del número de mensajes relevantes encontrados en el módulo CVS. Esos mensajes son CVS que tienen al menos una clave potencial de JIRA.

• Sólo los mensajes que contienen una posible incidencia del JIRA son enlazados a una incidencia.

• El sistema de codificación de JIRA es usado cuando analizamos los logs CVS, así que necesita ajustarse al log CVS. El sistema que codifica puede verse en Admin -> System -> System Info.

Crear módulos CVS en JIRA

Un módulo CVS se refiere a un directorio a nivel superior en un repositorio CVS. Para crear un módulo CVS:

7. Crea o decide qué directorio existente será usado para almacenar ficheros log de módulos CVS (El fichero con la salida del comando 'cvs log'). JIRA debe tener

48

acceso de lectura y escritura al directorio. Se requiere acceso de escritura incluso si decides actualizar manualmente el log CVS, ya que JIRA necesita usar este directorio para crear un fichero cerrado con el fin de sincronizar el acceso al log del módulo CVS.

8. Entra con perfil de administrador en JIRA. 9. Ve a la página de administración clicando en el enlace de administración o en el

icono de administración en el panel de controles:

10. A mano izquierda en el panel, expande el submenú titulado 'Global Settings' si no está abierto todavía. Clica en el enlace de 'Módulos CVS'. Esto debería llevarte a la página de 'Módulo CVS’.

11. Clica en el enlace de 'Añadir Nuevo módulo CVS' en esta página. 12. Esto te llevará a la página de 'Añadir módulo CVS'.

49

Cumpliméntalo como sigue:

1. En Nombre pon un nombre descriptivo y corto, posiblemente enseguida aparecerá el nombre del módulo CVS tal y como aparece en tu repositorio CVS.

2. (Opcional) En el campo Descripción pon una frase corta que describa este módulo CVS.

3. Especifica un CVS Root, que será usado para recuperar el log del módulo CVS o fue usado para recuperar el log. Se necesita el CVS Root mientras se recupera el log de datos y también es necesario incluso si eliges recuperar manualmente el log CVS. Ponle en detalles 'full'. Por ejemplo:

� /some/local/path (para acceso en repositorio local) � :pserver:username@hostname:port/some/path (por acceso

pserver) � :ext:username@hostname:/some/path (por acceso ssh)

Si JIRA encuentra problemas para entender tu local CVS Root (e.g. en sistemas Windows), precede la ruta con :local: Por ejemplo, :local:d:\some\path.

4. Para el Nombre del módulo especifica el nombre del módulo tal y como se llamaba en el repositorio CVS. Esto será necesario normalmente en el directorio de nivel superior (eg. myproject), pero puede también incluir subdirectorios (myproject/subproject/src/java).

Esta información se requiere para recuperar el log CVS y también para analizarlo, así no necesitarás proporcionar el nombre CVS del modulo incluso si decides recuperar el log CVS manualmente.

5. Para el fichero de recuperación decide si te gustaría que JIRA automáticamente se sincronizara con el repositorio CVS. Si eliges 'Automáticamente recuperar el log CVS', JIRA periódicamente recuperará el log CVS para el módulo y luego lo analizará para obtener información relevante. Si eliges 'Me gustaría actualizar el log por mí mismo', JIRA no recuperará el log, pero periódicamente lo actualizará. Si eliges esta opción, necesitarás actualizar el log CVS por otros medios (e.g. manualmente o usando un script programado) para guardar la información CVS en el JIRA actual.

6. Para la ruta del fichero log, especifica la ruta entera para el fichero que contendrá el log de datos CVS. Este fichero debería estar situado en un directorio mencionado en el paso 1. Si desearas que JIRA periódicamente actualizara los contenidos del log, este fichero no necesita existir en este momento, ya que JIRA automáticamente lo creará. Si eliges actualizar el fichero manualmente, asegúrate de que el fichero log ya exista en la ruta especificada y es legible por JIRA.

7. Para CVS Timeout, especifica cuántos segundos lleva la operación CVS para expirar (e.g. rlog).

8. La contraseña necesita ser proporcionada sólo si tú le dejas a JIRA automáticamente recuperar el log CVS del módulo. Especifica la

50

contraseña que se necesita para recuperar el log usando el método especificado en el CVS Root. Si no se requiere contraseña, deja el campo vacío.

9. (Opcional) Para Base URL en la sección de 'Ver detalles de CVS', introduce la URL entera (i.e. incluye 'http://' or 'https://' al principio) en el sitio ViewCVS del módulo CVS. La URL necesita situar al root del módulo en el ViewCVS.

Nota

Si estás integrando con FishEye, necesitas personalizar algunos pasos especiales. FishEye puede resolver todas las URLs que espera ViewCVS. Sólo necesitas introducir la URL entera a tu instalación de FishEye y el repositorio específico que deseas visualizar. Esta es la misma URL que conseguirías si fueras a examinar el proyecto sin FishEye.

10. (Opcional) Para el parámetro Root en la sección 'Ver detalles CVS', introduce el nombre del Project Root que es usado en ViewCVS para navegar en el módulo CVS. Este parámetro se requiere sólo si ViewCVS ha sido montado para trabajar con múltiples módulos CVS, y este módulo no es el módulo por defecto del ViewCVS server. El valor que debería ser reemplazado en este campo es el mismo que el valor del parámetro URL root que aparece en cada URL de ViewCVS (e.g. cuando se visualiza un fichero). Si la URL que aparece en tu navegador a la hora de ver un fichero de este módulo CVS en ViewCVS no tiene el parámetro root, deja este campo en blanco.

11. Clica en el botón de añadir. 12. Esto debería devolverte a la página de 'Módulos CVS', donde puedes ver

el nuevo módulo CVS. Puedes editar y borrar este modulo aquí.

Nota Si JIRA tiene problemas para entender tu local CVS Root (e.g. en sistemas Windows), antepón a la ruta :local: Por ejemplo, :local:d:\some\path

Asociar el proyecto o proyectos con CVS Modules

1. Entra con perfil de administrador en JIRA. 2. Ve a la página de administración clicando en el enlace de administración en la

barra superior o en el icono de administración en el panel de controles:

3. A mano izquierda en el panel, clica en el enlace de proyectos. 4. Esto te llevará a la página de proyectos. Te saldrá una lista de todos los

proyectos existentes. Selecciona un proyecto, el cual quieres asociar a un modulo CVS.

5. Se mostrará una página de resumen de proyectos. Después de 'Módulos CVS' clica en el enlace de Módulo Celect'. Esto mostrará la página de 'Seleccionar

51

módulos en version de control', donde tú puedes asociar el proyecto con un módulo CVS (o con múltiples módulos CVS, en JIRA Profesional y edición Enterprise).

6. Selecciona el modulo o módulos apropiados y clica en el botón de seleccionar.

Configurar permisos

El permiso de ver la versión de control es necesario para los usuarios/grupos/roles que podrán ver información CVS. Nota: por defecto este permiso se da al grupo de desarrolladores de JIRA.

Deshabilitar ficheros log CVS de recuperación

Para deshabilitar automáticamente log CVS de recuperación por un módulo CVS elige la opción 'me gustaría actualizar el log por mí mismo' para el atributo 'Log Retrieval' del módulo.

Si has desactivado automáticamente el log CVS de recuperación para el módulo CVS, JIRA sólo recuperará el log CVS periódicamente. Por tanto, para la nueva información relevante que aparecerá en JIRA, el log necesitará ser actualizado por otros medios. Esto puede hacerse manualmente o se puede usar un script programado.

Nota Antes de actualizar el log CVS del módulo, revisa la existencia de un fichero cerrado con el nombre 'cvslog.write.lock' en el mismo directorio que el fichero log CVS. Si el fichero cerrado existe, espera hasta que sea eliminado antes de actualizar el log. Cuando se realice la actualización del log CVS para un modulo, crea un fichero cerrado con el nombre cvslog.write.lock en el mismo directorio que el fichero log CVS para asegurarte de que JIRA no empieza a analizar el log mientras aún esté siendo actualizado. No olvides eliminar el fichero cerrado después de que la actualización se haya completado.

Ajustar la frecuencia del Módulo de actualización

Para minimizar el tráfico de red entre JIRA y el servidor CVS, JIRA actualiza y reanaliza la información de los módulos CVS asociados sólo una vez durante el período de tiempo especificado. Por defecto, este período de tiempo es 1 hora, pero puede ser ajustado si es necesario.

Cuando el primer modulo CVS sea creado en JIRA, empezará un servicio en segundo plano automáticamente. El servicio se llama 'Servicio de actualización VCS'. Para cambiar la frecuencia de la actualización de los módulos, sigue estos pasos:

1. Entra con perfil de administrador en JIRA. 2. Ve a la página de administración clicando en el enlace de administración de la

barra superior o clicando en el icono de administración en el panel de controles:

52

3. Abre la pestaña de Sistema a mano izquierda en el menú, si no está ya abierto. 4. Selecciona Servicios desde la pestaña de Sistema. Se mostrará una página con

los servicios que están configurados. Si, al menos un modulo CVS ha sido configurado, se mostrará el servicio de actualización de VCS en la lista.

5. Clica en el enlace de Editar en la columna que está más a la derecha del Servicio de actualización VCS. Esto mostrará una página donde puedes poner el intervalo del servicio.

6. Cambia el valor como sea preciso. Recuerda que el intervalo es especificado en minutos.

7. Clica en el botón de actualizar para que los cambios se hagan efectivos.

Recuerda:

• Los módulos CVS son actualizados uno después de otro cada cierto período de tiempo. Esto es, no es posible especificar un intervalo de actualización diferente para cada módulo CVS.

• Si estás usando los log automáticos de recuperación para tus módulos CVS y colocas el intervalo a un valor muy bajo, el consumo de ancho de banda entre JIRA y el servidor CVS podría ser más alto.

• Si el intervalo está puesto con un valor muy largo, los nuevos mensajes CVS no aparecerán en JIRA durante algún tiempo.

Alias CVS

JIRA no soporta actualmente alias CVS. Si tienes alias CVS que hagan referencia a más de un módulo, crea cada modulo CVS en JIRA y luego asocia cada módulo con el proyecto de JIRA relevante (asumiendo que estás utilizando la edición profesional o enterprise de JIRA, la edición Standard sólo soporta un módulo CVS por proyecto). La herramienta requerida para añadir un módulo de alias CVS en JIRA es JRA-4586. Si quieres saber más de dicha herramienta, ve a: http://jira.atlassian.com/browse/JRA-4586

Configurar JIRA

JIRA tiene un número de opciones de configuración que permiten que el sistema sea personalizado.

Para configurar JIRA:

1. Entra con perfil de administrador en JIRA 2. Ve a la página de administración clicando en el enlace de administración en la

barra superior o en el icono de administración en el panel de controles:

53

3. En el panel a mano izquierda, debajo de Global Settings, clica en Configuración general.

4. Aparecerá la pantalla siguiente. Clica en editar configuración para editar las tres secciones.

54

55

Opciones

Opción Descripción

Título Es el título que se mostrará en la página de acceso a JIRA y en el dashboard. Te ayuda a identificar tu instalación y sus objetivos.

Modo

JIRA puede funcionar de dos maneras:

Público Cualquiera puede anotarse y crear incidencias.

Privado

Útil para sistemas de gestión de incidencias internos donde no quieres que entren usuarios públicos. El ingreso está desactivado; sólo los administradores pueden crear nuevos usuarios.

Por defecto: Público

CAPTCHA en ingreso

Si estás ejecutando JIRA en modo público, es altamente recomendable que habilites Captcha. Si quieres saber más sobre Capucha, ve a: http://www.atlassian.com/software/jira/docs/v3.13/public_signup.html

Por defecto: ON

URL de base

Esta es la URL de base de la instalación de JIRA.

Se usa en notificaciones salientes de e-mail para construir enlaces válidos a incidencias de JIRA.

E-mail desde la cabecera

Especifica el From: formato de cabecera en e-mails de notificación. Por defecto, está de la forma siguiente "John Doe (JIRA) <jira@company.com>". Las variables disponibles son $'{fullname'}, $'{email'} y $'{email.hostname'}.

Introducción

Corto mensaje introductorio que aparece en el dashboard.

Es posible incluir HTML, pero asegúrate de que todas las etiquetas están correctamente cerradas y que el HTML está bien formado.

Internacionalización

Opción Descripción

Codificación de caracteres

Es la codificación de caracteres para introducir y ver la información dentro de JIRA. Para la mayoría de idiomas del oeste, el UTF-8 está disponible.

Si cambias esta opción, asegúrate de que también cambias la codificación de tu base de datos.

Indexar el idioma

JIRA usa Lucene. Si quieres saber más sobre Lucene, ve a: http://lucene.apache.org/java/docs/

56

Esta opción debería estar en el idioma en el que ha sido introducida la información dentro de JIRA. Es necesario reindexar JIRA si se cambia este valor.

Lenguajes instalados

Esta sección lista todos los packs de idiomas disponibles dentro de JIRA, aunque se pueden instalar otros idiomas adicionales. Para instalar idiomas adicionales, ve a: http://www.atlassian.com/software/jira/docs/v3.13/i18n.html

Idioma por defecto

Idioma usado en la interfaz de JIRA (es el que está seleccionado por defecto en la lista mostrada en Lenguajes instalados).

Opciones

Opción Descripción

Permitir a los usuarios indicar la preferencia de las incidencias

Controla si ese permiso está habilitado en JIRA. Ese permiso permite a los usuarios indicar una preferencia para las incidencias que a ellos les gustaría completar o resolver.

Por defecto a ON

Permitir a los usuarios ver incidencias

Controla si ese permiso está habilitado en JIRA. Los usuarios pueden ver las incidencias en las que están interesados. Los usuarios que ven una incidencia serán avisados de todos los cambios en ello.

Por defecto a ON

Permitir incidencias sin asignar

Cuando está habilitado, JIRA permitirá que las incidencias sean asignadas o no.

Cuando está deshabilitado, las incidencias deben estar siempre asignadas a alguien – por defecto, el que asigna sera el líder del proyecto.

Por defecto a OFF.

Administración de los usuarios externos

Cuando está habilitado, JIRA assume que vas a administrar a los usuarios desde fuera de JIRA, por ejemplo usando Crowd). Esto significa que no serás capaz de crear, editar o borrar usuarios/grupos desde dentro de JIRA; pero puedes aún asignar usuarios/grupos a los roles de proyecto y crear/editar/borrar propiedades de usuario.

Adicionalmente, JIRA no mostrará opciones para usuarios para cambiar su contraseña o editar su perfil.

Nota: LDAP integration está actualmente limitada a administración externa de contraseñas, así que esta opción debería estar a OFF cuando se utilice LDAP. Para saber más sobre la integración con LDAP, ve a: http://www.atlassian.com/software/jira/docs/v3.13/ldap.html

Por defecto a OFF.

57

Administración externa de contraseñas

Cuando está habilitado, JIRA asumirá que estás administrando contraseñas desde fuera de JIRA. JIRA no mostrará las opciones para los usuarios para cambiar su contraseña, o mostrar el enlace de ‘¿No recuerda su contraseña?’en la pantalla de acceso.

Nota: Con el proveedor LDAP por defecto, esta opción debería estar habilitada, y como las cuentas no están creadas todavía en LDAP, esta opción sólo esconde los caracteres de la contraseña dentro de JIRA.

Por defecto a OFF.

Confirmación de cierre de sesión

Controla si quieres obtener confirmación del usuario cuando cierre la sesión.

cookie significa obligar la confirmación si el usuario estaba automáticamente logueado (mediante una cookie).

Por defecto a NUNCA.

Usar compresión GZip

Controla si quieres comprimir las páginas web que JIRA envía al navegador. Es recomendable que esté a ON, a menos que estés usando mod_proxy.

Por defecto a OFF

Permitir acceso remoto API

Controla si quieres permitir acceso a clientes remotos (vía XML-RPC o SOAP).

Por defecto a OFF

Visibilidad del e-mail del usuario

Controla la manera en que las direcciones de e-mail se muestran en la página de perfil.

Público — las direcciones de e-mail están visibles para todos.

Escondido — las direcciones son invisibles a todos.

Enmascarado — las direcciones están enmascaradas (ejemplo, 'user@example.com' se muestra como 'user at example dot com').

Sólo para los usuarios logueados — sólo los usuarios logueados en JIRA pueden ver las direcciones

Por defecto a Público

Visibilidad de los comentarios

Determina lo que contendrá la lista que se presenta a los usuarios que especifican la visibilidad de los comentarios y del worklog.

Grupos y roles de proyectos — la lista contendrá grupos y roles de proyecto.

58

Sólo roles de proyecto — la lista sólo contendrá roles de proyecto.

Por defecto a sólo roles de proyecto

Excluir la cabecera del e-mail 'Precedence: bulk'

Controla si queremos impedir la cabecera Precedence: Bulk en los e-mails de notificación en JIRA. Esta opción sólo debería ser habilitada cuando las notificaciones vayan a una lista de e-mails con e-mails devueltos 'bulk'. En circunstancias normales, esta cabecera impide los acuses de recibo.

Por defecto a OFF

Autocompletar selector de incidencias

Autocompleta claves de incidencias en el popup de selector de incidencias. Poner a OFF si los navegadores de los usuarios son incompatibles con AJAX.

Por defecto a ON

Autocompletar selector de usuarios

Proporciona la autocompletación de los nombres de usuario en el popup de selector de usuarios. Ponlo a OFF si tienes un número muy grande de usuarios, o si los navegadores de los usuarios son incompatibles con AJAX.

Nota: Si 'Visibilidad del e-mail de usuario' está a HIDDEN, las direcciones de e-mail no serán buscadas o mostradas en los resultados.

Por defecto a ON si tienes menos de 5.000 usuarios (u OFF si tienes más de 5.000 usuarios).

Opciones de seguridad

Las opciones son:

• Forzar la descarga de todos los ataques. Esta es la opción más segura, pero es menos conveniente para los usuarios.

• Forzar la descarga de ataques de alto riesgo. Los ataques HTML son mostrados online.

• Permitir la visibilidad de los ataques. Selecciona esta opción si eres experto en riesgos de seguridad. Para saber más sobre este tema, ve a: http://confluence.atlassian.com/display/JIRA/JIRA+Security+Advisory+2008-08-26#JIRASecurityAdvisory2008-08-26-XSSvulnerabilityinservingHTMLattachmentswiththetext%2FhtmlMIMEtype

Por defecto: Forzar la descarga de ataques de alto riesgo.

59

Indexar las búsquedas

Con el fin de proveer una búsqueda rápida, JIRA crea un índice del texto introducido dentro de los campos de la incidencia. Este índice es almacenado en un fichero del sistema, y actualizado en cualquier sitio donde el texto sea añadido o modificado. A veces es necesario volver a generar este índice manualmente, por ejemplo si las incidencias han sido introducidas manualmente en la base de datos, o el índice se ha perdido o dañado.

Indexar la Administración

1. Entra con perfil de administrador en JIRA. 2. Ve a la página de administración clicando en el enlace de administración en la

barra superior o en el icono de administración en el panel de controles:

3. Debajo del submenu Sistema a la izquierda, clica en el enlace de indexar. 4. Esta página te permite hacer:

o Reindexar tus datos o Optimizar tu índice o Mueve tu índice a otro directorio*. Observa que tu directorio índice

debería ser un disco local y rápido de la máquina en la cual esté instalada tu instancia de JIRA. Observa también que tu directorio índice debería tener la seguridad apropiada, como se describe en Security Overview en el siguiente enlace: http://www.atlassian.com/software/jira/docs/v3.13/security.html

*Observa que sólo las personas que entren como administradores en JIRA pueden mover el índice.

Nota JIRA limpiará cualquier índice allí donde quieras reindexar los datos, y reindexará todos los datos actuales desde cero. Esto podría llevar unos pocos minutos, dependiendo de cuántas incidencias tengas, y los usuarios no serán capaces de acceder a JIRA durante este tiempo.

Ampliar JIRA

JIRA es muy flexible, y tiene un número de puntos de extensión donde los datos de JIRA pueden ser cuestionados o su funcionalidad extendida. Puedes también descargar el JIRA Plugin Development Kit, que contiene todo el código fuente para siete plugins de trabajo, las plantillas para crear tus propios plugins, plantillas de proyectos para crear tus propios plugins, toda la documentación API y todas las dependencias de las librerías.

60

Tipos de campos

JIRA viene con varios tipos de campos definidos. Los nuevos tipos pueden ser escritos y puestos en JIRA.

Formatos del usuario

JIRA viene con algunas opciones para cambiar la vista de las herramientas del sistema. Los formatos de usuarios son una herramienta que puede ser personalizada mediante plugins. Puedes escribir tus propios plugins de formato de usuario para cambiar la vista de los detalles del usuario en JIRA

Portales Se pueden crear nuevos portales escribiendo una clase en Java, una plantilla en XML, empaquetada como un plugin de JIRA

Informes JIRA viene con varios informes incorporados. Usando el plugin system, se pueden escribir nuevos informes, ofreciendo nuevas maneras de ver y resumir datos de JIRA.

Funciones del workflow y condiciones

El workflow de las incidencias de JIRA (estados y transiciones de estado una incidencia puede ser personalizado a través de la interfaz web. El motor de la carga de trabajo (OSWorkflow) proporciona herramientas donde puedes poner tu propio patrón de acciones:

• Ejecutar arbitrariamente Java cuando ocurra una cierta transición, mediante post funciones.

• Limitar la visibilidad de transiciones para ciertos usuarios, mediante condiciones. Para saber más sobre las condiciones, ve a: http://www.atlassian.com/software/jira/docs/v3.13/workflow.html#conditions

• Validar entrada de pantallas de transición mediante validadores. Para saber más sobre validadores, ve a: http://www.atlassian.com/software/jira/docs/v3.13/workflow.html#validators

Ver la guía en el siguiente enlace: http://confluence.atlassian.com/pages/viewpage.action?pageId=11764 para saber cómo escribir tus propias post funciones de workflow, condiciones y validadores. Una vez escritas, éstas pueden ser empaquetadas como plugins que pueden reutilizarse.

Incidencia y pestañas de proyecto

Cuando vemos una incidencia, alguna información de incidencia (comentarios, historial de cambios) se muestra en pestañas:

Asimismo, la página de mostrar proyecto contiene paneles de pestañas mostrando información del proyecto:

Cuando escribas un plugin, puedes añadir una nueva incidencia o paneles de pestañas al proyecto de JIRA. Para la instancia, podrías desear mostrar los datos del proyecto o incidencia recogidos desde un origen externo.

Listeners (Los asignados)

JIRA tiene un subsistema de eventos completos que tienen un subsistema completo de eventos y lanza eventos donde haya un cambio. Por ejemplo, un evento de incidencia creada es lanzado donde una incidencia sea creada.

Un listener es una clase que implementa una interfaz JiraListener y es

61

llamado allí donde haya eventos en JIRA. Usando estos eventos, puedes luego personalizar cualquier acción que desees. Por ejemplo, el e-mail enviado por JIRA es enviado por el MailListener.

Esto es útil cuando quieres influir en los sistemas externos de los eventos que ocurren dentro de JIRA – normalmente usados para poner los datos dentro o fuera de los sistemas.

Para más información, lee: http://www.atlassian.com/software/jira/docs/v3.13/listeners.html.

Servicios

Los servicios son clases que implementan la interfaz JiraService. Después de instalar, especificas un período de actualización y JIRA llamará al run() method de tu servicio periódicamente.

Una muestra de servicio es proporcionado por el POPCommentService. Este servicio revisa un particular buzón de correo POP y si encuentra mensajes, intenta extraer una clave de incidencia del asunto. Si el asunto contiene una clave, el cuerpo del mensaje se añade como un comentario al mensaje.

Los servicios son útiles cuando quieres introducir periódicamente datos desde sistemas de fuera.

SOAP e interfaces XML-RPC remotas

JIRA tiene SOAP y una interfaz XML-RPC. Esto permite que puedas conducir JIRA desde sistemas externos. Por ejemplo, puedes tener un programa en Java, script en Perl o clientes C# e incidencias en JIRA. Ver el siguiente enlace para saber más: http://confluence.atlassian.com/display/JIRA/JIRA+RPC+Services Para montar clientes RPC, puedes ver los tutoriales siguientes: http://confluence.atlassian.com/display/JIRA/Creating+a+SOAP+Client y http://confluence.atlassian.com/pages/viewpage.action?pageId=9623

Java JIRA tiene un conjunto completo de Java APIs que pueden ser usados para actualizar información con JIRA.