Jira User Guide 1.01

Enrico M.
Crisostomo
Atlassian JIRA
The Definitive Guide
Volumen i
Gua del usuario
Casos de uso y ejemplos
Volumen i:
Gua del usuario
Volumen ii:
Instalacin
Gua del administrador
Atlassian JIRA, The Definitive Guide, Volumen i.

2012 Versin 1.01.
Este libro est protegido por la licencia Creative Commons AttributionNon

commercialNoDerivs 3.0 Unported (CC BYNCND 3.0) cuyo trminos pueden consultarse en [3].
Bajo los trminos de esta licencia al usuario se garantiza el derecho de:
(i) Compartir este libro, copiando, distribuyendo y transmitiendo esta obra.
Bajo esta condiciones el usuario:
(i) Debe atribuir el trabajo al autor de esta obra en las formas especificadas
por el autor o quin licencia esta obra (pero no en ninguna forma que
sugiera que stos aprueban al usuario o al uso que ste hace de la obra.
(ii) No puede utilizar la obra por fines comerciales.
(iii) No puede alterar, transformar esta obra o construir sobre esa trabajos
derivados.
Se entiende que:
(i) Cualquiera de las condiciones mencionadas pueden derogarse en el caso el
usuario obtenga el permiso del titular del copyright.
(ii) Cuando la obra, o parte de la misma, est en el dominio pblico [4] bajo
las leyes aplicables, dicho status no ser afectado por los trminos de esta
licencia.
De ninguna forma esta licencia afectar a los siguientes derechos:
(i) Derechos de uso justo [5] u otras excepciones o limitaciones a las leyes sobre
el copyright.
(ii) Los derechos morales del autor [6].
(iii) Los derechos que otros sujetos puedan tener sobre la obra misma o en su
utilizacin, tales como la publicidad [7] o el derecho a la privacidad.
Para cualquier utilizacin o distribucin de la obra, es obligatorio aclarar los
trminos de licencia de la obra. La mejor manera de hacerlo es hacer una citacin
a [2] o, incluso, replicar el contenido de esta pgina.
JIRA, GreenHopper, Confluence, FishEye, Crucible, Bamboo y Crowd son marcas
registradas de Atlassian.
Atlassian JIRA
The Definitive Guide
ndice general
ndice general
ndice de figuras
xv
ndice de tablas
xxiii
Prefacio
Relacin con la documentacin oficial de
A quin est dirigido cada volumen . . .
Nomenclatura . . . . . . . . . . . . . . .
Convenios tipogrficos . . . . . . . . . .
El formato de este libro . . . . . . . . .
Sugerencias . . . . . . . . . . . . . . . .
JIRA
. . . .
. . . .
. . . .
. . . .
. . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Prefacio a la gua del usuario

1 Introduccin
1.1 Interfaz grfica . . . . . . . . . .
1.2 Los cuadros de mandos . . . . .
1.3 JIRA es OpenSocial . . . . . . .
1.4 Flexibilidad . . . . . . . . . . . .
1.5 Seguridad . . . . . . . . . . . . .
1.6 Facilidad de gestin . . . . . . .
1.7 Elegir una licencia . . . . . . . .
1.7.1 Licencias comerciales . . .
1.7.2 Licencia gratuita . . . . .
1.7.3 Contactar con un Experto
xxvii
xxvii
xxviii
xxx
xxx
xxxi
xxxi
xxxiii
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
3
3
5
5
6
6
7
8
8
9
9
v
ndice general
vi
2 Conceptos bsicos
2.1 Proyectos . . . . . . . . . . . . . . . . . . . . . . . . .
2.1.1 Componentes . . . . . . . . . . . . . . . . . . .
2.1.2 Versiones . . . . . . . . . . . . . . . . . . . . .
2.2 Incidencias . . . . . . . . . . . . . . . . . . . . . . . .
2.2.1 Tipo de incidencia . . . . . . . . . . . . . . . .
2.2.2 Campos . . . . . . . . . . . . . . . . . . . . . .
2.2.3 Prioridad . . . . . . . . . . . . . . . . . . . . .
2.2.4 Estado . . . . . . . . . . . . . . . . . . . . . . .
2.2.5 Resolucin . . . . . . . . . . . . . . . . . . . .
2.3 Flujos de trabajo . . . . . . . . . . . . . . . . . . . . .
2.4 Organizacin de los conceptos . . . . . . . . . . . . . .
2.5 Esquemas . . . . . . . . . . . . . . . . . . . . . . . . .
2.5.1 Desacoplamiento de proyectos y reutilizacin de
esquemas . . . . . . . . . . . . . . . . . . . . .
2.5.2 Tipos de incidencias disponibles . . . . . . . .
2.5.3 Configuracin de campos . . . . . . . . . . . .
2.5.4 Configuracin de pantallas . . . . . . . . . . . .
2.5.5 Flujos de trabajos disponibles . . . . . . . . . .
2.5.6 Notificaciones . . . . . . . . . . . . . . . . . . .
2.5.7 Polticas de seguridad . . . . . . . . . . . . . .
2.5.8 Niveles de seguridad de las incidencias . . . . .
11
12
12
14
16
18
19
21
22
23
24
26
28
3 Primeros pasos
3.1 Login: acceder a JIRA . . . . . . . . . . . .
3.2 Cuadro de mando . . . . . . . . . . . . . . .
3.3 Barra de las herramientas . . . . . . . . . .
3.3.1 Men Dashboards . . . . . . . . . .
3.3.2 Men Projects . . . . . . . . . . . .
3.3.3 Men Issues . . . . . . . . . . . . . .
3.3.4 Menu Administration . . . . . . . .
3.3.5 Menu del usuario . . . . . . . . . . .
3.4 Atajos de teclado . . . . . . . . . . . . . . .
3.4.1 Tecla modificadora . . . . . . . . . .
3.4.2 Atajos globales . . . . . . . . . . . .
3.4.3 Atajos de las ventanas de incidencias
3.4.4 Atajos en los formularios . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
39
39
40
41
42
43
43
44
45
45
45
47
47
47
4 Explorar un proyecto
4.1 Estructura . . . . . . . . . . . . . . . . . . . . . . . . .
4.1.1 Acceso rpido a la creacin de incidencias . . .
51
51
53
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
30
30
30
31
32
32
35
36
ndice general
4.1.2 Acceso a informacin adicional . .
Summary . . . . . . . . . . . . . . . . . .
4.2.1 Activity Stream . . . . . . . . . . .
4.3 Issues . . . . . . . . . . . . . . . . . . . .
4.4 Road Map . . . . . . . . . . . . . . . . . .
4.5 Change Log . . . . . . . . . . . . . . . . .
4.6 Popular Issues . . . . . . . . . . . . . . .
4.7 Versions . . . . . . . . . . . . . . . . . . .
4.7.1 Builds de la versin . . . . . . . .
4.8 Components . . . . . . . . . . . . . . . . .
4.9 Labels . . . . . . . . . . . . . . . . . . . .
4.10 Builds de Bamboo . . . . . . . . . . . . .
4.11 Fisheye changesets: cambios en las fuentes
4.2
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
55
56
58
58
58
60
61
61
63
65
67
68
69
5 Manejo de incidencias
71
5.1 Creacin de una incidencia . . . . . . . . . . . . . . . 73
5.1.1 Citacin de otros usuarios y envo de mail . . . 77
5.2 Ventana de detalle de incidencia . . . . . . . . . . . . 78
5.3 Operaciones disponibles . . . . . . . . . . . . . . . . . 79
5.4 Compartir una incidencia por correo electrnico . . . . 81
5.4.1 Citar un usuario . . . . . . . . . . . . . . . . . 81
5.4.2 Compartir una incidencia . . . . . . . . . . . . 81
5.5 Adjuntar ficheros o capturas de pantallas a una incidencia 82
5.6 Gestionar los ficheros adjuntos . . . . . . . . . . . . . 85
5.6.1 Ordenar los ficheros adjuntos . . . . . . . . . . 86
5.6.2 Acceder al contenido de adjuntos de tipo ZIP . 86
5.6.3 Eliminar ficheros adjuntos . . . . . . . . . . . . 87
5.6.4 Bajar todos los adjuntos en un archivo ZIP . . 87
5.6.5 Adjuntar una captura de pantalla . . . . . . . . 88
5.7 Comentarios . . . . . . . . . . . . . . . . . . . . . . . . 90
5.7.1 Modificar un comentario . . . . . . . . . . . . . 91
5.7.2 Eliminar un comentario . . . . . . . . . . . . . 92
5.7.3 Crear un enlace a un comentario . . . . . . . . 92
5.8 Campos de texto formateado . . . . . . . . . . . . . . 92
5.8.1 Macros . . . . . . . . . . . . . . . . . . . . . . 93
5.8.2 Sintaxis de las macros . . . . . . . . . . . . . . 94
5.8.3 Macro code . . . . . . . . . . . . . . . . . . . . 94
5.9 Sub-tareas . . . . . . . . . . . . . . . . . . . . . . . . . 95
5.9.1 Crear sub-tareas . . . . . . . . . . . . . . . . . 96
5.9.2 Gestin de sub-tareas . . . . . . . . . . . . . . 98
5.9.3 Convertir una incidencia en sub-tarea . . . . . 100
vii
ndice general
5.9.4 Convertir una sub-tarea en incidencia . . . . .
5.10 Duplicar una incidencia . . . . . . . . . . . . . . . . .
5.10.1 Crear un enlace a una incidencia duplicada . .
5.10.2 Prefijo del ttulo de las incidencias duplicadas .
5.10.3 Duplicacin de incidencias y sub-tareas . . . .
5.11 Enlaces entre incidencias . . . . . . . . . . . . . . . . .
5.11.1 Gestionar los enlaces entre incidencias . . . . .
5.12 Planificar las incidencias . . . . . . . . . . . . . . . . .
5.12.1 Filtrar incidencias utilizando la fecha de resolucin . . . . . . . . . . . . . . . . . . . . . . .
5.13 Proteger una incidencia . . . . . . . . . . . . . . . . .
5.13.1 Caso de uso: segmentacin de usuarios . . . . .
5.13.2 Caso de uso: proteger informacin confidencial
5.13.3 Proteger una incidencia . . . . . . . . . . . . .
5.14 Poner etiquetas a una incidencias . . . . . . . . . . . .
5.14.1 Eliminar una etiqueta . . . . . . . . . . . . . .
5.15 Trabajar sobre una incidencia . . . . . . . . . . . . . .
5.15.1 Hacer una estimacin del trabajo requerido . .
5.15.2 Registrar trabajo sobre una incidencia . . . . .
5.15.3 Registrar trabajo durante una transicin de estado en el flujo de trabajo . . . . . . . . . . . .
5.15.4 Crear un enlace a un registro de trabajo . . . .
5.15.5 Modificar un registro de trabajo . . . . . . . .
5.15.6 Eliminar un registro de trabajo . . . . . . . . .
5.16 Mover una incidencia . . . . . . . . . . . . . . . . . . .
5.17 Modificar mltiples incidencias a la vez . . . . . . . .
5.17.1 Inhabilitar las notificaciones durante una operacin masiva . . . . . . . . . . . . . . . . . . .
5.17.2 Efectuar una operacin masiva . . . . . . . . .
5.17.3 Operacin masiva de eliminacin . . . . . . . .
5.17.4 Operacin masiva de migracin . . . . . . . . .
5.17.5 Operacin masiva de modificacin . . . . . . .
5.18 Registro histrico de cambios de una incidencia . . . .
5.19 Integracin de JIRA con otras aplicaciones . . . . . .
5.19.1 Crear enlaces a incidencias en otras instancias
de JIRA . . . . . . . . . . . . . . . . . . . . . .
5.19.2 Enlaces a pginas de Confluence . . . . . . . .
5.19.3 Enlaces a pginas web . . . . . . . . . . . . . .
5.19.4 Revisiones de Crucible . . . . . . . . . . . . . .
5.19.5 Changesets de FishEye . . . . . . . . . . . . . .
5.19.6 Builds de Bamboo . . . . . . . . . . . . . . . .
viii
101
102
103
104
104
104
108
109
109
113
113
115
115
117
119
120
122
123
125
127
127
128
129
132
134
134
136
137
140
144
147
147
149
150
150
151
153
ndice general
5.20 Observar y votar una incidencia . . . . . . . . . . . . . 153
6 Buscar y filtrar incidencias
6.1 Bsquedas simples . . . . . . . . . . . . . . . . . . . .
6.1.1 Panel principal de bsqueda . . . . . . . . . . .
6.1.2 Panel de bsqueda por componentes y versiones
6.1.3 Panel de bsqueda por atributos de incidencia
6.1.4 Panel de bsqueda por fechas . . . . . . . . . .
6.1.5 Panel de bsqueda por porcentaje de trabajo
realizado . . . . . . . . . . . . . . . . . . . . .
6.1.6 Panel de bsqueda por campos personalizados
6.1.7 Modificar manualmente una query simple . . .
6.2 El navegador de incidencias . . . . . . . . . . . . . . .
6.2.1 Crear un enlace permanente a una bsqueda .
6.2.2 Herramientas en el navegador de incidencias . .
6.2.3 Ordenar los resultados . . . . . . . . . . . . . .
6.2.4 Visualizar las incidencia . . . . . . . . . . . . .
6.3 Configurar el navegador de incidencias . . . . . . . . .
6.3.1 Configurar las columnas visualizadas . . . . . .
6.3.2 Configurar el nmero de lneas visualizadas . .
6.4 Bsquedas de texto . . . . . . . . . . . . . . . . . . . .
6.4.1 Estructuras de las consultas . . . . . . . . . . .
6.4.2 Bsquedas aproximadas . . . . . . . . . . . . .
6.4.3 Bsquedas fuzzy . . . . . . . . . . . . . . . . .
6.4.4 Bsquedas por proximidad . . . . . . . . . . .
6.4.5 Bsqueda por importancia . . . . . . . . . . . .
6.4.6 Operadores . . . . . . . . . . . . . . . . . . . .
6.5 Bsquedas rpidas . . . . . . . . . . . . . . . . . . . .
6.5.1 Navegar a una incidencia . . . . . . . . . . . .
6.5.2 Incidencias asignadas a uno mismo . . . . . . .
6.5.3 Incidencias por reporter . . . . . . . . . . . . .
6.5.4 Incidencias en un proyecto . . . . . . . . . . . .
6.5.5 Incidencias atrasadas . . . . . . . . . . . . . . .
6.5.6 Incidencias por fecha . . . . . . . . . . . . . . .
6.5.7 Incidencias por estado . . . . . . . . . . . . . .
6.5.8 Incidencias por resolucin . . . . . . . . . . . .
6.5.9 Incidencias por prioridad . . . . . . . . . . . .
6.5.10 Incidencias por tipo . . . . . . . . . . . . . . .
6.5.11 Incidencias por versin . . . . . . . . . . . . . .
6.5.12 Incidencias por versin de resolucin . . . . . .
6.5.13 Incidencias por componente . . . . . . . . . . .
157
158
159
161
163
164
167
167
168
172
172
173
173
177
177
178
180
181
182
184
184
184
185
185
187
188
188
189
189
189
189
190
190
190
190
191
191
191
ix
ndice general
6.5.14 Integracin con navegadores . . . . . . . . . . . 191
7 Bsquedas avanzadas
7.1 Estructura de una query JQL . . . . . . .
7.2 Caracteres reservados . . . . . . . . . . .
7.3 Palabras reservadas . . . . . . . . . . . . .
7.4 Campos . . . . . . . . . . . . . . . . . . .
7.5 Palabras claves . . . . . . . . . . . . . . .
7.5.1 Palabra clave and . . . . . . . . . .
7.5.2 Palabra clave or . . . . . . . . . .
7.5.3 Palabra clave not . . . . . . . . . .
7.5.4 Palabra clave empty . . . . . . . .
7.5.5 Palabra clave null . . . . . . . . .
7.5.6 Palabra clave order by . . . . . .
7.6 Operadores . . . . . . . . . . . . . . . . .
7.6.1 Operador equals . . . . . . . . . .
7.6.2 Operador not equals . . . . . . .
7.6.3 Operador greater than . . . . . .
7.6.4 Operador greater than equals .
7.6.5 Operador less than . . . . . . . .
7.6.6 Operador less than equals . . .
7.6.7 Operador in . . . . . . . . . . . .
7.6.8 Operador not in . . . . . . . . . .
7.6.9 Operador contains . . . . . . . .
7.6.10 Operador does not contain . . .
7.6.11 Operador is . . . . . . . . . . . .
7.6.12 Operador is not . . . . . . . . . .
7.7 rden de evaluacin . . . . . . . . . . . .
7.8 Auto-finalizacin de las consultas . . . . .
7.9 Modificar una bsqueda avanzada con la
bsqueda simple . . . . . . . . . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
interfaz de
. . . . . . .
8 Grabar una bsqueda en un filtro

8.1 Organizacin de los filtros . . . . . . . .
8.2 Creacin de un filtro . . . . . . . . . . .
8.3 Sumario de un filtro . . . . . . . . . . .
8.4 Gestin de filtros . . . . . . . . . . . . .
8.5 Eliminar un filtro de la lista de favoritos
8.6 Aadir un filtro a la lista de favoritos .
8.7 Modificacin de los atributos de un filtro
8.8 Compartir un filtro con otros usuarios .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
195
196
197
197
197
198
199
199
200
200
201
201
201
202
202
203
204
204
205
205
206
206
207
208
208
208
209
214
217
218
219
222
223
225
225
226
227
ndice general
8.9
8.10
8.11
8.12
Buscar un filtro . . . . . . . . . . . . . . . . . . . . . . 230

Copiar un filtro existente . . . . . . . . . . . . . . . . 232
Modificacin de un filtro . . . . . . . . . . . . . . . . . 233
Configurar el orden de columnas de un filtro . . . . . . 235
8.12.1 Modificar la configuracin de columnas de un
filtro . . . . . . . . . . . . . . . . . . . . . . . . 237
8.12.2 Eliminar la configuracin de columnas de un filtro238
8.13 Utilizar la configuracin de columnas por defecto . . . 239
8.14 Configuracin de columnas y exportacin de datos . . 240
9 Explotar los resultados de bsqueda
9.1 Suscribirse a un filtro . . . . . . . . . . . . . . . . . . .
9.1.1 Periodicidad . . . . . . . . . . . . . . . . . . .
9.1.2 Cualquier valor . . . . . . . . . . . . . . . . . .
9.1.3 Listas de valores . . . . . . . . . . . . . . . . .
9.1.4 Intervalo de valores . . . . . . . . . . . . . . . .
9.1.5 Incremento de un valor . . . . . . . . . . . . .
9.1.6 ltimo valor . . . . . . . . . . . . . . . . . . .
9.1.7 Ocurrencias . . . . . . . . . . . . . . . . . . . .
9.2 Recibir resultados de bsqueda en un feed RSS . . . .
9.2.1 Autenticar el usuario de un feed RSS . . . . . .
9.3 Recibir resultados de bsqueda en XML . . . . . . . .
9.3.1 Seleccin de campos devueltos en el documento
9.4 Exportar resultados de bsqueda a Microsoft Word . .
9.5 Exportar resultados de bsqueda a Microsoft Excel . .
9.6 Visualizar los resultados en un grfico . . . . . . . . .
9.6.1 Visualizar los resultados de bsqueda en el cuadro de mandos . . . . . . . . . . . . . . . . . .
241
241
243
248
248
249
250
250
251
252
253
254
255
255
256
257
10 Generar reportes
10.1 Workload pie chart . . . .
10.2 User workload . . . . . . .
10.3 Version workload . . . . .
10.4 Time tracking . . . . . . .
10.5 Single level group by . . .
10.6 Created vs. resolved issues
10.7 Resolution time . . . . . .
10.8 Pie chart . . . . . . . . .
10.9 Average age . . . . . . . .
10.10Recently created issues . .
10.11Time Since Issues Report
265
267
270
271
273
276
277
281
283
287
288
290
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
258
xi
ndice general
10.12Cach de los navegadores . . . . . . . . . . . . . . . . 294
11 Gestionar los cuadros de mandos
11.1 Contenedores de gadgets OpenSocial . . . . . . .
11.2 Gestin de los cuadros de mandos . . . . . . . . .
11.2.1 Gestin de cuadros de mandos favoritos .
11.2.2 Ordenar los cuadros de mandos favoritos .
11.2.3 Creacin de un cuadro de mandos . . . .
11.2.4 Copiar un cuadro de mandos . . . . . . .
11.2.5 Modificar un cuadro de mandos . . . . . .
11.2.6 Eliminar un cuadro de mandos . . . . . .
11.3 Bsqueda de cuadro de mandos . . . . . . . . . .
.
.
.
.
.
.
.
.
.
295
296
298
299
300
300
303
303
304
305
12 Personalizar el cuadro de mandos

12.1 Operaciones sobre un cuadro de mandos . . . . . . . .
12.2 Seleccin de la distribucin de un cuadro de mandos .
12.3 Aadir gadgets al cuadro de mandos . . . . . . . . . .
12.4 Operaciones sobre un gadget en un cuadro de mandos
12.5 Mover un gadget en un cuadro de mandos . . . . . . .
12.6 Eliminar un gadget de un cuadro de mandos . . . . . .
12.7 Gadgets disponibles . . . . . . . . . . . . . . . . . . .
12.8 Activity stream gadget . . . . . . . . . . . . . . . . . .
12.9 Administration gadget . . . . . . . . . . . . . . . . . .
12.10Assigned to me gadget . . . . . . . . . . . . . . . . . .
12.11Average age chart gadget . . . . . . . . . . . . . . . .
309
309
309
311
313
314
315
315
317
318
320
321
13 Gestionar el perfil del usuario

13.1 Modificar los detalles del usuario . . . . . . . . . . . .
13.1.1 Modificar el avatar del usuario . . . . . . . . .
13.1.2 Modificar la contrasea . . . . . . . . . . . . .
13.2 Modificar las preferencias del usuario . . . . . . . . . .
13.2.1 Cambiar las columnas del navegador de incidencias . . . . . . . . . . . . . . . . . . . . . .
325
327
327
328
330
A Documento XML de bsqueda
335
B Campos y funciones JQL

B.1 Campos . . . . . . . . . . . . . . . . . . . . .
B.1.1 Nombres o identificadores? . . . . . .
B.1.2 Tipos de campos JQL . . . . . . . . .
B.1.3 Operadores soportados por los campos
xii
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
330
341
341
341
342
343
ndice general
B.1.4 Campos de tipo versin . . . . . . . . . . . .
B.1.5 Campos de tipo usuario . . . . . . . . . . . .
B.1.6 Campos de tipo categora . . . . . . . . . . .
B.1.7 Campos de tipo texto . . . . . . . . . . . . .
B.1.8 Campos de tipo componente . . . . . . . . .
B.1.9 Campos de tipo fecha . . . . . . . . . . . . .
B.1.10 Campos de tipo filtro . . . . . . . . . . . . .
B.1.11 Campos de tipo incidencia . . . . . . . . . . .
B.1.12 Campos de tipo nivel de seguridad . . . . . .
B.1.13 Campos de tipo duracin . . . . . . . . . . .
B.1.14 Campos de tipo prioridad . . . . . . . . . . .
B.1.15 Campos de tipo proyecto . . . . . . . . . . .
B.1.16 Campos de tipo resolucin . . . . . . . . . . .
B.1.17 Campos de tipo estado . . . . . . . . . . . . .
B.1.18 Campos de tipo tipo de incidencia . . . . . .
B.1.19 Campos de tipo nmero . . . . . . . . . . . .
B.2 Funciones . . . . . . . . . . . . . . . . . . . . . . . .
B.2.1 Funcin cascadeOption . . . . . . . . . . . .
B.2.2 Funcin componentsLeadByUser . . . . . . .
B.2.3 Funcin currentLogin . . . . . . . . . . . . .
B.2.4 Funcin currentUser . . . . . . . . . . . . .
B.2.5 Funcin issueHistory . . . . . . . . . . . . .
B.2.6 Funcin lastLogin . . . . . . . . . . . . . . .
B.2.7 Funcin linkedIssues . . . . . . . . . . . . .
B.2.8 Funcin membersOf . . . . . . . . . . . . . . .
B.2.9 Funcin now . . . . . . . . . . . . . . . . . . .
B.2.10 Funcin projectsLeadByUser . . . . . . . .
B.2.11 Funcin projectsWhereUserHasPermission
B.2.12 Funcin projectsWhereUserHasRole . . . .
B.2.13 Funcin releasedVersions . . . . . . . . . .
B.2.14 Funcin standardIssueTypes . . . . . . . .
B.2.15 Funcin subtaskIssueTypes . . . . . . . . .
B.2.16 Funcin unreleasedVersions . . . . . . . .
B.2.17 Funcin votedIssues . . . . . . . . . . . . .
B.2.18 Funcin watchedIssues . . . . . . . . . . . .
B.3 Palabras reservadas . . . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
345
346
347
347
349
349
351
352
352
353
354
354
355
356
357
358
358
360
362
363
363
364
365
366
366
367
367
368
369
370
371
371
372
373
373
374
C Changelog
377
C.1 1.01 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
ndice alfabtico
379
xiii
ndice general
Bibliografa
xiv
389
ndice de figuras
2.1
2.2
2.3
2.4
2.5
2.6
2.7
Componentes de un proyecto . . . . . . . . . . . . . . . .
Versiones de un proyecto . . . . . . . . . . . . . . . . . . .
Road map de un proyecto . . . . . . . . . . . . . . . . . .
Ventana de detalle de incidencia . . . . . . . . . . . . . .
Relacin entre estado de una incidencia y flujo de trabajo
Flujo de trabajo por defecto de JIRA . . . . . . . . . . .
Organizacin de los conceptos en JIRA . . . . . . . . . .
13
16
16
17
23
25
28
3.1
3.2
3.3
3.4
Ventana de login de JIRA . . . . . . . . . . . . . . . . . .

Ventana de signup de JIRA . . . . . . . . . . . . . . . . .
Seccin de menus de la barra de herramientas de JIRA . .
Seccin de herramientas de la barra de herramientas de
JIRA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Barra de herramientas de JIRA Administracin Parte izquierda . . . . . . . . . . . . . . . . . . . . . . . . . .
Barra de herramientas de JIRA Administracin Parte derecha . . . . . . . . . . . . . . . . . . . . . . . . . . .
Ventana de ayuda de los atajos de teclado . . . . . . . . .
40
41
42
Navegador de proyecto. . . . . . . . . . . . . . . . . . . .
Navegador de proyecto. . . . . . . . . . . . . . . . . . . .
Navegador de proyecto Barra de creacin de incidencias.
Navegador de proyecto Ventana Summary. . . . . . . .
Navegador de proyecto Barra de herramientas de la
ventana Summary. . . . . . . . . . . . . . . . . . . . . . .
Navegador de proyecto Ventana Issues. . . . . . . . . .
Navegador de proyecto Ventana Road map. . . . . . . .
Navegador de proyecto Ventana Changelog. . . . . . . .
52
53
55
57
3.5
3.6
3.7
4.1
4.2
4.3
4.4
4.5
4.6
4.7
4.8
42
44
44
46
57
59
60
61
xv
ndice de figuras
4.9
4.10
4.11
4.12
4.13
4.14
4.15
4.16
4.17
Navegador
Navegador
Navegador
Navegador
Navegador
Navegador
Navegador
Navegador
Navegador
5.1
5.2
5.3
5.4
Botn de creacin de incidencia . . . . . . . . . . . . . . . 74

Navegador de proyecto Barra de creacin de incidencias. 74
Ventana de creacin de incidencia . . . . . . . . . . . . . . 75
Ventana de creacin de incidencia Configuracin de
campos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Citacin de otro usuario . . . . . . . . . . . . . . . . . . . 78
Ventana de detalle de incidencia . . . . . . . . . . . . . . 79
Men de acciones . . . . . . . . . . . . . . . . . . . . . . . 80
Compartir una incidencia. . . . . . . . . . . . . . . . . . . 82
Ventana para adjuntar ficheros a una incidencia . . . . . . 83
Vista previa de los ficheros adjuntos a una incidencia . . . 85
Vista de galera de los ficheros adjuntos a una incidencia . 85
Menu de operaciones sobre ficheros adjuntos a una incidencia 86
Vista previa de un fichero adjunto de tipo ZIP o JAR . . 87
Ventana de gestin de ficheros adjuntos . . . . . . . . . . 87
Ventana de confirmacin para ejecutar un applet Java . . 88
Ventana para adjuntar capturas de pantalla . . . . . . . . 89
Formulario de creacin de un comentario . . . . . . . . . . 90
Comentarios colapsados y expandidos . . . . . . . . . . . 91
Iconos para operar sobre un comentario . . . . . . . . . . 91
Fragmento de cdigo formateado con la macro code . . . 95
Fragmento de XML formateado con la macro code . . . . 95
Ventana de creacin de sub-tarea . . . . . . . . . . . . . . 96
Ventana de detalle de sub-tarea . . . . . . . . . . . . . . . 97
Lista de sub-tareas de una incidencia . . . . . . . . . . . . 97
Operaciones de una sub-tarea . . . . . . . . . . . . . . . . 98
Menu de operaciones de una sub-tarea . . . . . . . . . . . 99
Formulario de creacin de sub-tarea en el panel Sub-tasks
99
Formulario de conversin de incidencia a sub-tarea . . . . 100
5.5
5.6
5.7
5.8
5.9
5.10
5.11
5.12
5.13
5.14
5.15
5.16
5.17
5.18
5.19
5.20
5.21
5.22
5.23
5.24
5.25
5.26
5.27
5.28
5.29
5.30
xvi
de
de
de
de
de
de
de
de
de
proyecto Ventana Popular issues. . . . .

proyecto Ventana Versions. . . . . . . .
proyecto Detalle de versin. . . . . . . .
proyecto Detalle de versin Builds . .
proyecto Detalle de versin Build Plans
proyecto Ventana Components. . . . . .
proyecto Ventana Labels. . . . . . . . . .
proyecto Ventana Source. . . . . . . . . .
proyecto Ventana Source. . . . . . . . . .
62
62
64
65
66
66
68
69
70
ndice de figuras
5.31 Formulario de conversin de campos para la conversin a
sub-tarea . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
5.32 Formulario de confirmacin de conversin de incidencia a
sub-tarea . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
5.33 Formulario de creacin de un enlace entre incidencias . . . 106
5.34 Formulario de creacin de un enlace entre incidencias . . . 106
5.35 Bsqueda de una incidencia por cdigo o ttulo . . . . . . 107
5.36 Bsqueda de una incidencia utilizando un filtro . . . . . . 107
5.37 Detalle de un enlace entre incidencias . . . . . . . . . . . 108
5.38 Ventana de gestin de enlaces entre incidencias . . . . . . 108
5.39 Seccin de filtrado por fecha de resolucin en el navegador
de incidencias . . . . . . . . . . . . . . . . . . . . . . . . . 110
5.40 Ejemplo de filtrado por fecha de resolucin en el navegador
de incidencias . . . . . . . . . . . . . . . . . . . . . . . . . 111
5.41 Formulario para la creacin de un criterio de bsqueda por
fecha de resolucin con intervalos temporales relativos. . . 112
5.42 Segmentacin de usuarios con niveles de seguridad de incidencia . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
5.43 Modificar el nivel de seguridad de una incidencia . . . . . 116
5.44 Nivel de seguridad de una incidencia en la ventana de detalle117
5.47 Formulario de creacin de una etiqueta en una incidencia 119
5.48 Panel Time tracking de una incidencia . . . . . . . . . . . 120
5.49 Pestaa Work log del panel Activity de una incidencia . . 121
5.50 Campos para la estimacin del trabajo requerido de una
incidencia . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
5.51 Formulario de registro de trabajo . . . . . . . . . . . . . . 124
5.52 Registro de trabajo con controles de gestin . . . . . . . . 126
5.53 Formulario de registro de trabajo en una ventana de resolucin de incidencia . . . . . . . . . . . . . . . . . . . . . 126
5.54 Registro de trabajo modificado . . . . . . . . . . . . . . . 128
5.55 Ventana de eliminacin de registro de trabajo . . . . . . . 129
5.56 Asistente de migracin de incidencias Paso 1 . . . . . . 131
5.60 Inhabilitar las notificaciones durante una operacin masiva 134
5.61 Operacin Bulk change en el men Tools . . . . . . . . . . 135
5.62 Seleccin de las incidencias sobre las cuales efectuar la
operacin masiva . . . . . . . . . . . . . . . . . . . . . . . 135
xvii
ndice de figuras
5.63 Seleccin del tipo de operacin masiva . . . . . . . . . . .
5.64 Confirmacin de una eliminacin masiva . . . . . . . . . .
5.65 Aviso de exclusin de sub-tareas durante una migracin
masiva . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.66 Seleccin de proyecto y tipo de incidencia de destino en
una migracin masiva . . . . . . . . . . . . . . . . . . . .
5.67 Seleccin de tipo de sub-tarea de destino en una migracin
masiva . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.68 Actualizacin de campos de una incidencia en una migracin masiva . . . . . . . . . . . . . . . . . . . . . . . . . .
5.69 Ventana de confirmacin de una migracin masiva . . . .
5.70 Ventana de modificacin de campos en una operacin de
modificacin masiva . . . . . . . . . . . . . . . . . . . . .
5.71 Ventana de modificacin de campos en una operacin de
modificacin masiva . . . . . . . . . . . . . . . . . . . . .
5.72 Asistente de migracin de incidencias Paso 4 . . . . . .
5.73 Incidencia Revisin de Crucible . . . . . . . . . . . . .
5.74 Incidencia Changesets de FishEye . . . . . . . . . . . .
5.75 Incidencia Builds de Bamboo . . . . . . . . . . . . . .
5.76 Panel de Personas en la ventana de detalles de incidencias
5.77 Panel de Personas en la ventana de detalles de incidencias
5.78 Ventana de gestin de Watchers de una incidencia . . . .
6.1
6.2
6.3
6.4
6.5
6.6
6.7
6.8
6.9
6.10
6.11
6.12
6.13
xviii
Paneles de bsqueda del navegador de incidencias 1 . .

Navegador de incidencias Aviso de refresco . . . . . . .
Paneles de bsqueda del navegador de incidencias 2 . .
Navegador de incidencias Campos Reporter y Assignee
Navegador de incidencias Campos Reporter y Assignee
Formulario para la creacin de un criterio de bsqueda por
fecha de creacin con intervalos temporales relativos. . . .
Criterio de bsqueda de ejemplo. . . . . . . . . . . . . . .
Criterio de bsqueda de ejemplo en el interfaz de bsqueda
avanzada. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Modificacin del criterio de bsqueda de ejemplo en el interfaz de bsqueda avanzada. . . . . . . . . . . . . . . . .
Modificacin del criterio de bsqueda de ejemplo en el interfaz de bsqueda avanzada. . . . . . . . . . . . . . . . .
Navegador de incidencias. . . . . . . . . . . . . . . . . . .
Men Actions de una incidencia en el navegador de incidencias. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Men Actions y Tools del navegador de incidencias. . . .
136
136
137
138
138
139
141
145
146
146
151
152
154
154
155
156
160
161
162
163
164
166
170
170
171
171
172
174
174
ndice de figuras
6.14 Ventana de detalle de la incidencia con controles de bsqueda. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.15 Jerarqua de configuracin del navegador de incidencias. .
6.16 Ventana de configuracin de campos del navegador de incidencias. . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.17 Ventana de configuracin de campos del navegador de incidencias Establecer configuracin por defecto. . . . . .
6.18 Panel Preferences del perfil de usuario. . . . . . . . . . . .
6.19 Control de bsqueda rpida. . . . . . . . . . . . . . . . . .
6.20 Aviso de activacin de bsqueda inteligente. . . . . . . . .
6.21 Registracin de un motor de bsqueda OpenSearch. . . .
6.22 Ejemplo de bsqueda desde el control de bsqueda del
navegador. . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.1
7.2
7.3
7.4
7.5
7.6
7.7
7.8
7.9
8.1
8.2
8.3
8.4
8.5
8.6
8.7
8.8
8.9
8.10
8.11
8.12
8.13
8.14
177
178
179
180
181
187
187
193
193
Ventana de bsqueda avanzada. . . . . . . . . . . . . . . . 196

Auto-finalizacin de un campo en una consulta JQL. . . . 210
Auto-finalizacin de un operador en una consulta JQL. . . 210
Auto-finalizacin de un valor en una consulta JQL. . . . . 211
Formulario de creacin de consultas JQL. . . . . . . . . . 212
Auto-finalizacin de un campo en una consulta JQL. . . . 212
Auto-finalizacin en consultas JQL Seleccin de campos.213
Auto-finalizacin en consultas JQL Seleccin de operadores. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Auto-finalizacin en consultas JQL Seleccin de valores
y funciones. . . . . . . . . . . . . . . . . . . . . . . . . . . 214
Filtros favoritos en la barra de herramientas de JIRA. . .
Creacin de filtros. . . . . . . . . . . . . . . . . . . . . . .
Ventana de creacin de filtros. . . . . . . . . . . . . . . .
Sumario de un filtro. . . . . . . . . . . . . . . . . . . . . .
Men Issues Operacin Manage filters. . . . . . . . . .
Ventana de gestin de filtros Pestaa Favorite. . . . . .
Ventana de gestin de filtros Pestaa Search. . . . . . .
Aviso de eliminacin de filtro favorito. . . . . . . . . . . .
Ventana de modificacin de un filtro. . . . . . . . . . . . .
Controles para la modificacin de las identidades con las
cuales se comparte un filtro. . . . . . . . . . . . . . . . . .
Compartir un filtro con un grupo de usuarios. . . . . . . .
Compartir un filtro con un rol de proyecto. . . . . . . . .
Ventana de bsqueda de filtros. . . . . . . . . . . . . . . .
Resultados de bsqueda de filtros. . . . . . . . . . . . . .
220
220
221
222
223
224
224
225
226
228
228
229
231
232
xix
ndice de figuras
8.15
8.16
8.17
8.18
8.19
8.20
8.21
8.22
8.23
8.24
9.1
9.2
9.3
9.4
9.5
9.6
9.7
9.8
9.9
9.10
9.11
9.12
9.13
9.14
9.15
9.16
9.17
9.18
9.19
xx
Resultados de bsqueda de filtros. . . . . . . . . . . . . .

Modificacin del criterio de bsqueda de un filtros. . . . .
Modificacin del criterio de bsqueda de un filtros. . . . .
Jerarqua de configuracin del navegador de incidencias. .
Jerarqua de configuracin del navegador de incidencias
Filtros. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Ventana de gestin de filtros - Operaciones. . . . . . . . .
Navegador de incidencias - Configuracin de columnas de
un filtro. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Navegador de incidencias Men Tools Modificacin
de la configuracin de columnas de un filtro. . . . . . . . .
Navegador de incidencias Eliminar configuracin de columnas de un filtro. . . . . . . . . . . . . . . . . . . . . .
Navegador de incidencias Seleccin de la configuracin
de columnas. . . . . . . . . . . . . . . . . . . . . . . . . .
233
234
235
235
236
237
237
238
239
240
Suscripcin a filtro. . . . . . . . . . . . . . . . . . . . . . . 242

Formulario de suscripcin a un filtro. . . . . . . . . . . . . 243
Formulario de suscripcin a un filtro Seleccin de franja
horaria. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Formulario de suscripcin a un filtro Seleccin de das
de la semana. . . . . . . . . . . . . . . . . . . . . . . . . . 245
Formulario de suscripcin a un filtro Seleccin de das
del mes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
Formulario de suscripcin a un filtro Expresin cron. . 246
Feed RSS de JIRA visualizado en el navegador Apple Safari.253
Ejemplo de documento Microsoft Word generado de una
bsqueda en JIRA. . . . . . . . . . . . . . . . . . . . . . . 256
Ejemplo de documento Microsoft Excel generado de una
bsqueda en JIRA. . . . . . . . . . . . . . . . . . . . . . . 257
Grfico Agerage age. . . . . . . . . . . . . . . . . . . . . . 259
Grfico Created vs. resolved. . . . . . . . . . . . . . . . . . 259
Grfico Created vs. resolved. . . . . . . . . . . . . . . . . . 260
Grfico Pie chart. . . . . . . . . . . . . . . . . . . . . . . 260
Grfico Recently created. . . . . . . . . . . . . . . . . . . . 261
Grfico Time since. . . . . . . . . . . . . . . . . . . . . . 261
Navegador de incidencias Tipos de grfico. . . . . . . . 262
Navegador de incidencias Ver como grfico. . . . . . . 262
Navegador de incidencias Personaliza grfico. . . . . . 263
Grabacin de grfico en el cuadro de mando Seleccin
de cuadro de mando. . . . . . . . . . . . . . . . . . . . . . 264
ndice de figuras
9.20 Grabacin de grfico en el cuadro de mando Creacin
automtica de un cuadro de mando. . . . . . . . . . . . . 264
10.1 Cuadro de manos de un proyecto Men Reports. . . . .
10.2 Cuadro de manos de un proyecto Men Reports desplegado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.3 Workload pie chart Configuracin. . . . . . . . . . . .
10.4 Ventana de seleccin de proyecto o filtro. . . . . . . . . .
10.5 Report Workload pie chart. . . . . . . . . . . . . . . . . .
10.6 User workload Configuracin. . . . . . . . . . . . . . .
10.7 Report User workload. . . . . . . . . . . . . . . . . . . . .
10.8 Version workload Configuracin. . . . . . . . . . . . . .
10.9 Report Versin workload. . . . . . . . . . . . . . . . . . .
10.10Time tracking Configuracin. . . . . . . . . . . . . . .
10.11Report Time tracking. . . . . . . . . . . . . . . . . . . . .
10.12Report Time tracking Barras de resumen. . . . . . . .
10.13Single level group by Configuracin. . . . . . . . . . . .
10.14Report Single level group by. . . . . . . . . . . . . . . . .
10.15Created vs. resolved Configuracin. . . . . . . . . . . .
10.16Report Created vs. Resolved Grfico. . . . . . . . . . .
10.17Report Created vs. Resolved Tabla de datos. . . . . . .
10.18Report Created vs. Resolved Grfico. . . . . . . . . . .
10.19Resolution time Configuracin. . . . . . . . . . . . . .
10.20Report Resolution time Grfico. . . . . . . . . . . . . .
10.21Report Resolution time Tabla de datos. . . . . . . . . .
10.22Pie chart Configuracin. . . . . . . . . . . . . . . . . .
10.23Report Pie chart Grfico. . . . . . . . . . . . . . . . .
10.24Report Pie chart Tabla de datos. . . . . . . . . . . . .
10.25Average age Configuracin. . . . . . . . . . . . . . . . .
10.26Report Average age Grfico. . . . . . . . . . . . . . . .
10.27Report Average age Tabla de datos. . . . . . . . . . . .
10.28Recently created issues Configuracin. . . . . . . . . .
10.29Report Recently created issues Grfico. . . . . . . . . .
10.30Report Recently created issues Tabla de datos. . . . . .
10.31Time since issues Configuracin. . . . . . . . . . . . . .
10.32Report Time since issues Grfico. . . . . . . . . . . . .
10.33Report Time since issues Tabla de datos. . . . . . . .
266
266
268
268
269
270
271
272
272
273
275
276
277
278
279
280
281
282
282
284
285
285
286
286
287
288
289
290
291
292
292
293
294
11.1 Cuadro de mandos vaco. . . . . . . . . . . . . . . . . . . 297

11.2 Cuadro de mandos Disponer un gadget. . . . . . . . . 297
11.3 Men Dashboards. . . . . . . . . . . . . . . . . . . . . . . 298
xxi
ndice de figuras
11.4 Ventana de gestin de cuadros de mandos. . . . . . . . . . 298
11.5 Ventana de gestin de cuadros de mandos. . . . . . . . . . 299
11.6 Confirmacin de eliminacin de un cuadro de mandos de
la lista de favoritos. . . . . . . . . . . . . . . . . . . . . . 300
11.7 Control de creacin de cuadros de mandos. . . . . . . . . 301
11.8 Formulario de creacin de cuadros de mandos. . . . . . . 302
11.9 Ventana de gestin de cuadros de mandos Operacin
Copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
11.10Ventana de gestin de cuadros de mandos Operacin
Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
11.11Ventana de modificacin de cuadros de mandos . . . . . . 304
11.12Ventana de gestin de cuadros de mandos Operacin
Delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
11.13Ventana de confirmacin de eliminacin de cuadro de mandos305
11.14Ventana de bsqueda de cuadro de mandos . . . . . . . . 306
11.15Ventana de bsqueda de cuadro de mandos Resultados 306
12.1
12.2
12.3
12.4
12.5
12.6
12.7
12.8
Ventana de cuadro de mandos Operaciones . . . . . . . 310

Ventana de cuadro de mandos Men Tools . . . . . . . 310
Ventana de seleccin de distribucin del cuadro de mandos 311
Ventana de seleccin de gadget . . . . . . . . . . . . . . . 312
Barra de herramientas de un gadget . . . . . . . . . . . . 313
Barra de herramientas de un gadget Men de operaciones314
Mover un gadget en un cuadro de mandos . . . . . . . . . 314
Ventana de confirmacin de eliminacin de un gadget de
un cuadro de mandos . . . . . . . . . . . . . . . . . . . . 315
12.9 Gadget Activity stream Configuracin . . . . . . . . . . 318
12.10Gadget Activity stream . . . . . . . . . . . . . . . . . . . . 319
12.11Gadget Administration . . . . . . . . . . . . . . . . . . . . 319
12.12Gadget Assigned to me . . . . . . . . . . . . . . . . . . . . 320
12.13Gadget Assigned to me . . . . . . . . . . . . . . . . . . . . 321
12.14Gadget Average age chart . . . . . . . . . . . . . . . . . . 322
12.15Gadget Average age chart . . . . . . . . . . . . . . . . . . 323
13.1
13.2
13.3
13.4
13.5
13.6
13.7
xxii
Barra de herramientas Perfil de Usuario . . . . . .

Perfil de Usuario . . . . . . . . . . . . . . . . . . . . .
Perfil de usuario Edicin de los detalles de usuario
Perfil de usuario Edicin del avatar del usuario . .
Perfil de usuario Edicin del avatar del usuario . .
Perfil de usuario Cambio de contrasea . . . . . . .
Perfil de usuario Modificacin de las preferencias .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
326
326
327
328
329
329
331
ndice de tablas
1.1
Licencias comerciales . . . . . . . . . . . . . . . . . . . . .
2.1
2.2
Campos estndar de una incidencia . . . . . . . . . . . . .

Eventos en el esquema de notificaciones . . . . . . . . . .
20
33
3.1
3.2
3.3
3.4
Tecla modificadora por navegador y sistema operativo

Atajos de teclado globales . . . . . . . . . . . . . . . .
Atajos de teclado en las ventanas de incidencias . . . .
Atajos de teclado en los formularios de JIRA . . . . .
46
47
48
49
4.1
4.2
4.4
4.5
4.6
4.7
Navegador de proyecto Informacin relativa al proyecto.

Navegador de proyecto Informacin relativa a las versiones del proyecto. . . . . . . . . . . . . . . . . . . . . . .
Navegador de proyecto Informacin relativa a los componentes del proyecto. . . . . . . . . . . . . . . . . . . . .
Navegador de proyecto Paneles de la ventana Summary.
Navegador de proyecto Paneles de la ventana Issues. .
Navegador de proyecto Ventanas de versiones. . . . . .
Navegador de proyecto Ventanas de componentes. . . .
5.1
5.2
5.3
Nombre de ficheros adjuntos Caracteres no permitidos

84
Macro del wiki-style renderer . . . . . . . . . . . . . . . . 94
Campos estndar de una incidencia . . . . . . . . . . . . . 143
6.1
6.2
6.3
6.4
Acciones en el men Actions en el navegador de incidencias.175

Acciones en el men Actions en el navegador de incidencias.176
Caracteres especiales en las bsquedas de texto. . . . . . . 183
Trminos especiales en las bsquedas de texto. . . . . . . 183
4.3
.
.
.
.
.
.
.
.
54
54
55
56
59
63
67
xxiii
ndice de tablas
7.1
7.2
Caracteres JQL reservados. . . . . . . . . . . . . . . . . . 197

Campos JQL. . . . . . . . . . . . . . . . . . . . . . . . . . 198
9.1
9.2
9.3
Tipos de campos JQL. . . . . . . . . . . . . . . . . . . . .

Valores de los campos de una expresin cron de JIRA. . .
Significado de los caracteres especiales de una expresin
cron de JIRA. . . . . . . . . . . . . . . . . . . . . . . . .
Significado de los caracteres especiales de una expresin
cron de JIRA. . . . . . . . . . . . . . . . . . . . . . . . .
9.4
244
247
247
250
10.1 Reportes integrados en JIRA. . . . . . . . . . . . . . . . . 267

10.2 Reporte Intervalos temporales. . . . . . . . . . . . . . . 279
11.1 Controles para el ordenamiento de los elementos de la lista. 301
12.1 Cuadro de mandos Distribuciones . . . . . . . . . . . . 310
12.2 Barrade herramientas de un gadget Controles . . . . . 313
12.3 Gadgets para el cuadro de mandos de JIRA . . . . . . . . 317
B.1
B.2
B.3
B.4
B.5
B.6
B.7
B.8
B.9
B.10
B.11
B.12
B.13
B.14
xxiv
Tipos de campos JQL. . . . . . . . . . . . . . . . . . . . . 343

Operadores soportados por los campos JQL. . . . . . . . . 344
Operadores JQL soportados por campos personalizados. . 345
Operadores y funciones soportados por campos de tipo
versin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
usuario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
categora. . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
Operadores y funciones soportados por campos de tipo texto.348
componente. . . . . . . . . . . . . . . . . . . . . . . . . . . 349
Operadores y funciones soportados por campos de tipo fecha.350
Operadores y funciones soportados por campos de tipo filtro.351
incidencia. . . . . . . . . . . . . . . . . . . . . . . . . . . 352
incidencia. . . . . . . . . . . . . . . . . . . . . . . . . . . 352
nivel de seguridad. . . . . . . . . . . . . . . . . . . . . . . 353
duracin. . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
ndice de tablas
B.15 Operadores y funciones soportados por campos de tipo
prioridad. . . . . . . . . . . . . . . . . . . . . . . . . . . .
proyecto. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
resolucin. . . . . . . . . . . . . . . . . . . . . . . . . . . .
estado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
tipo de incidencia. . . . . . . . . . . . . . . . . . . . . . .
nmero. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
B.21 Funciones JQL soportados por tipo de campo de campo y
clase de operador. . . . . . . . . . . . . . . . . . . . . . .
B.22 Tipo de campo de campo y clase de operador soportada
por cascadeOption. . . . . . . . . . . . . . . . . . . . . .
por componentsLeadByUser. . . . . . . . . . . . . . . . .
por currentLogin. . . . . . . . . . . . . . . . . . . . . . .
por currentUser. . . . . . . . . . . . . . . . . . . . . . .
por issueHistory. . . . . . . . . . . . . . . . . . . . . . .
por lastLogin. . . . . . . . . . . . . . . . . . . . . . . . .
por linkedIssues. . . . . . . . . . . . . . . . . . . . . . .
por membersOf. . . . . . . . . . . . . . . . . . . . . . . . .
por now. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
por projectsLeadByUser. . . . . . . . . . . . . . . . . . .
por projectsWhereUserHasPermission. . . . . . . . . . .
por projectsWhereUserHasRole. . . . . . . . . . . . . . .
por releasedVersions. . . . . . . . . . . . . . . . . . . .
354
355
355
356
357
358
359
360
362
363
364
364
365
366
367
367
368
369
369
370
xxv
Prefacio
B.35 Tipo de campo de campo y
por standardIssueTypes. .
por subtaskIssueTypes. .
por unreleasedVersions. .
por votedIssues. . . . . .
por watchedIssues. . . . .
B.40 Palabras JQL reservadas. .
xxvi
clase de
. . . . .
clase de
. . . . .
clase de
. . . . .
clase de
. . . . .
clase de
. . . . .
. . . . .
operador soportada
. . . . . . . . . . . .
operador soportada
. . . . . . . . . . . .
operador soportada
. . . . . . . . . . . .
operador soportada
. . . . . . . . . . . .
operador soportada
. . . . . . . . . . . .
. . . . . . . . . . . .
371
371
372
373
373
375
Prefacio
Este libro est dividido en dos volumenes: la Gua del usuario y la
Gua del administrador. La Gua del usuario describe las funcionalidades de JIRA y las herramientas a disposicin del usuario. El volmen comienza con una rpida introduccin a los conceptos bsicos de
la plataforma y progresa adentrndose en las funciones ms comunes
tales como creacin, trabajo y filtrado de incidencias. Los ltimos
captulos del volmen se dedican a funcionalidades ms avanzadas la
funcionalidad de generacin de reportes y la gestin de los cuadros de
mandos.
El segundo volumen, la Gua del administrador, est dedicado a
describir los procedimientos de administracin de la plataforma: el
volumen comienza con los procedimientos de instalacin en las plataformas soportadas, progresa con los procedimiento de personalizacin
de cada esquema de configuracin de JIRA hasta llegar a funcionalidades ms avanzadas, menos comunes pero no menos importantes
tales como migracin y archivado de proyectos y administracin diaria
del server.
Relacin con la documentacin oficial de JIRA
Atlassian desempea un excelente trabajo manteniendo la documentacin de sus productos siempre actualizada y disponible en la web
oficial [10] y reconozco que, sin esa excepcional fuente de informacin,
esta gua tampoco existira, por lo menos en la forma en la que est
presentada.
Una de las necesidades que me impulsaron a escribir esta gua,
de hecho, fue la escasez, por decirlo con un eufemismo, de documentacin e informacin en castellano de calidad. El primer intento
xxvii
Prefacio
fue comenzar a traducir la documentacin de JIRA en castellano alojndola, adems, en una instancia de Atlassian Confluence, el mismo
gestor de contenido con el cual se publica la documentacin oficial de
JIRA. De esta forma, poda mantener la estructura y la subdivisin
en secciones de la documentacin oficial, facilitando la explotacin de
la informacin a los usuarios acostumbrados a utilizar la documentacin de Atlassian. Sin embargo, segn el trabajo progresaba, empec
a darme cuenta que, an excelente y sorprendentemente detallada, a
la documentacin de JIRA falta algo importante: no se parece a una
gua, sino a documentacin de referencia.
Empec a escribir este libro, pues, para traducir y enriquecer a la
documentacin oficial, introduciendo la informacin de una forma ms
accesible a los usuarios con escasa experiencia e intentando guiarles
paso por paso aadiendo explicaciones, buenas prcticas, casos de
usos tpicos y ejemplos.
Confesando una personal inclinacin para la lectura sobre papel
en lugar de sobre pantalla, espero proporcionar a los usuarios que
compartan conmigo esta debilidad un producto ms agradable a
leer y utilizar. Un libro, adems, tiene la innegable ventaja de estar
siempre disponible sin la necesidad de una conexin a internet.
Por otro lado, el mantenimiento de un libro de estas caractersticas no facilita la labor de sincronizacin de la documentacin oficial
con esta gua. Atlassian mejora sus productos con una velocidad admirable, y no me es siempre posible actualizar inmediatamente esta
documentacin. De hecho, no excluyo siquiera que algunas caractersticas nuevas o modificadas no se vean reflejadas en este libro por
un error, y no por una decisin informada. Por las mismas razones,
las imgenes incluidas en este libro podran no estar siempre actualizadas.
A quin est dirigido cada volumen

He ha intentado organizar el conocimiento de JIRA por categoras de
usuario y a cada una de ellas he dedicado un volumen de este libro:
por un lado estn las personas que utilizan JIRA como herramienta de
trabajo, los usuarios, y por el otro estn las personas que administran
y configuran la herramienta, los administradores.
Sin embargo, incluso en casos de usos muy comunes, la frontera
ente las dos categoras de usuarios se hace borrosa: los usuarios, para
poder formular adecuadamente sus requerimientos, debern conocer,
xxviii
Prefacio
al menos de forma somera, las caractersticas de la plataforma. Un
conocimiento limitado de las funcionalidades de JIRA as como de
cualquier otro sistema pueden llevar los usuarios a utilizar la herramienta de forma distorsionada, ineficiente y no optimizada a sus
reales necesidades. Los usuarios que ignoran la existencia de algn
tipo de funcionalidad corren el riesgo de renunciar a ella sin llegar
siquiera a solicitarla a los administradores. De acuerdo a nuestra experiencia esta situacin no se da solo en el caso de alguna funcin
extica de la plataforma o alguna otra funcin inhabilitada por defecto: este problema se manifiesta tambin con funciones bsicas
de la plataforma como la personalizacin de los esquemas de configuracin de un proyecto y, sobre todo, los flujos de trabajo asociados a
los tipos de incidencias manejados.
Los administradores, por otra parte, para interpretar e implementar correctamente los requerimientos, solicitudes e incluso los deseos
de los usuarios, debern familiarizarse con los conceptos y los procedimientos de trabajo bsicos de la herramienta.
Adicionalmente, es necesario tener en cuenta que algunos usuarios
podran tener un rol que los acerca naturalmente a los administradores, por lo menos limitadamente al proyecto en que trabajan. Los
jefes de proyecto, por ejemplo, sern frecuentemente interlocutores de
los administradores: casi siempre en fase de creacin y configuracin
del proyecto, cuando los usuarios definan por primera vez los requerimientos de negocio que el mismo deber satisfacer, y a veces en fases
sucesivas, como la de mantenimiento de un proyecto, cuando vayan
incorporndose modificaciones necesarias a satisfacer las nuevas necesidades del proyecto. Aunque limitadamente a un subconjunto de
funciones, los administradores podran delegar la administracin de
un proyecto a un grupo de usuarios que no sean administradores de
JIRA.
Por estas razones, aunque est dirigido principalmente a los usuarios, el primer volumen debera ser una lectura recomendada tambin
a los administradores que, de esta forma, conocern los principios que
rigen la interaccin entre usuario y plataforma, las funciones disponibles, as como las limitaciones y las idiosincrasias de la misma.
Viceversa, limitadamente a los usuarios que requieran este tipo de
conocimiento tales como los jefes de proyecto, el segundo volumen,
dirigido principalmente a los administradores de JIRA, debera ser
una lectura recomendada para aprender cuales son todas las funciones
proporcionadas por la plataforma, muchas de las cuales, por razn de
espacio y audiencia, no se tratan con el debido detalle en la Gua del
xxix
Prefacio
usuario.
He tomado la precaucin, all donde considero que se est presentando una funcionalidad que pueda interesar a una audiencia ms
amplia, de avisar el lector e incorporar referencias cruzadas entre los
dos volmenes.
Nomenclatura
Considero importante aclarar una cuestin acerca de la nomenclatura que comnmente se utiliza relativamente a JIRA. Aunque JIRA
es una herramienta que naci para resolver un problema comn en el
mundo del desarrollo, la gestin de bugs, JIRA se diferencia de otros
programa similares por su flexibilidad, virtud que le permite ser utilizada para gestionar con xito todo tipo de proyecto. No obstante,
se ha arraigado el uso de la terminologa de los gestores de incidencias y, por lo tanto, se suele llamar incidencia al objeto gestionado
en un proyecto y manejado en un flujo de trabajo y desarrollador al
usuario cuyo rol es el de trabajar en una incidencia.
Es importante, pues, subrayar como las palabras incidencia y
desarrollador sean insuficientes para expresar la infinidad de objetos y casos de uso que se puedan gestionar en JIRA as como los
roles de usuarios que puedan crearse para manejar dichos objetos:
documentos, facturas, pedidos o cualquier otra entidad que pueda
manejarse en un flujo de trabajo son ejemplos de objetos candidatos
a ser gestionados en JIRA.
En esta gua, para conformarnos a esta costumbre, seguiremos
utilizando esta nomenclatura aunque reiteradas veces advertiremos
al lector de como la palabra incidencia haya que considerarse ms
como una costumbre histrica que una limitacin, o ms sencillamente el objetivo, de esta herramienta.
Convenios tipogrficos
Para facilitar la lectura de esta gua se utilizarn los siguientes convenios tipogrficos:
Para los comandos se utilizar una fuente mono-espacio.
Para enfatizar conceptos o hacer referencias a identificadores de
ventanas, de control o de men se utilizar una fuente itlica.
Para hacer referencias se utilizarn Small Caps.
xxx
Prefacio
Los ejemplos se editarn en un bloque de texto parecido al siguiente:
Ejemplo 0.1. El ejemplo terminar con un tombstone.
El formato de este libro
Este libro ha sido editado en una hoja de tipo DIN A5 (210 mm148
mm), un formato de hoja estndar cuyo tamao es igual al tamao
de una hoja DIN A4 (297 mm210 mm) cortada a la mitad y girada
de 90 grados.
La eleccin de este formato me ha permitido editar este volumen
manteniendo una estructura de pgina agradable y fcil de leer,
un objetivo difcil de conseguir en una hoja DIN A4 a menos de no
desperdiciar papel utilizando mrgenes demasiado grandes.
El formato DIN A4 es, probablemente, el formato de papel ms
comn en Europa y, aunque no sea difcil conseguir papel en formato
DIN A5, este libro podr imprimirse comodamente en formato A4
manteniendo el tamao original de las pginas gracias al hecho que
una hoja DIN A4 puede cortarse exactamente en 2 hojas DIN A5.
Algunas impresoras permiten, incluso, organizar la impresin de 4
pginas en una hoja A4 de forma que el usuario pueda cortar las
pginas a la mitad y obtener el ordenamiento natural de las pginas
del libro.
Otra opcin, que es mi preferida cuando deseo imprimir un libro
de ciertas dimensiones, es imprimirlo en fascculos. De esta forma,
en lugar de obtener decenas o centenares de hojas sueltas, obtengo
un nmero mucho ms reducido de fascculos los cuales, adems, son
ms fcil de sujetar con una normal grapadora de oficina. Un libro
como este, de aproximadamente 400 hojas, impreso en fascculos de
32 hojas en papel A4, se convierte en una docena de fascculos, cada
uno compuesto por 8 hojas A4 dobladas por la mitad. El resultado,
en mi opinin, es ms fcil de imprimir y grapar y, por supuesto, de
leer y llevar consigo.
Sugerencias
Estar agradecido a quin deseara enviarme correcciones, sugerencias
o cualquier otro tipo de solicitud: no hay mejor manera de refinar
un trabajo sino a travs del feedback de tus usuarios. Os ruego de
xxxi

dirigir vuestras sugerencias al buzn de correo electrnico indicado a
continuacin:
the.jira.guide@gmail.com
Estar encantado de responder a los comentarios y, en los casos que
considere oportuno, a aplicar las modificaciones sugeridas.
Donde encontrar este libro
La licencia de este libro permite su redistribucin. Sin embargo, siempre aconsejo obtener la ltima versin a la siguiente direccin [1]:
http://thegreyblog.blogspot.com/
Enrico M. Crisostomo
xxxii
La documentacin oficial de JIRA [10] es un producto de excelente calidad: alojada en una instancia de Atlassian Confluence para
ser consultada online, y tambin disponible en formato PDF, est
dividida por sujeto y proporciona toda la informacin necesaria para instalar, configurar, utilizar y administrar una instancia de JIRA.
Este recurso valioso ha sido la documentacin de referencia para editar este libro y sin ella, con toda seguridad, este libro no sera tan
detallado. Entonces, por qu decid de escribir esta gua?
La primera razn que me impuls a redactar esta gua es una razn
lingstica. La documentacin oficial de Atlassian, por lo menos hasta
la fecha de redaccin de este libro, est disponible exclusivamente en
Ingls. Aunque el ingls sea la lengua franca del mundo tecnolgico,
he constatado que en muchos casos, todava, la barrera lingstica
es un factor que limita la adopcin de muchas soluciones ya que los
usuarios temen que puedan tener problemas a la hora utilizar la documentacin o recibir soporte en lengua Ingls. El Castellano, adems,
es la segunda lengua nativa ms utilizada en el mundo: disponer de
documentacin en este idioma, por lo tanto, puede contribuir a favorecer la adopcin de estas soluciones en el colectivo hispano-hablante.
Ya que esta gua no es simplemente una traduccin sino una extensin de la Gua del usuario de JIRA, incluso usuarios con buenos
conocimientos de Ingls se podrn aventajar de una mayor cantidad
de informacin.
La segunda razn fue el deseo de reorganizar y extender el contenido de la documentacin de Atlassian. La documentacin oficial es un
compendio exhaustivo de la funcionalidad de JIRA, organizado por
tema y fcilmente explotable. Sin embargo creo que muchos usuarios,
tanto principiantes como expertos, podran beneficiarse de informaxxxiii

cin adicional tal como casos de uso y ejemplos, que son notables
ausentes en la documentacin oficial.
Por esta razn, empec a redactar este volumen con el objetivo de
proporciona una gua que pudiera satisfacer las necesidades de usuarios de de cualquier nivel de experiencia. Para guiar a los usuarios
inexpertos en el descubrimiento de JIRA y de toda su funcionalidad,
he intentado aadir ejemplos, sugerencias y casos de uso para aclarar el por qu de las cosas, sin limitarme simplemente al como se
hacen. Para usuarios expertos, he intentado poner en luz la variedad de funciones que la plataforma ofrece a sus usuarios, incluso las
ms inusuales, estableciendo relaciones con las tareas administrativas
cuando lo consider oportuno.
Enrico M. Crisostomo
xxxiv
Gua del usuario
1
Introduccin
Atlassian JIRA es una herramienta verstil utilizada principalmente como gestor de incidencias y gestin de proyectos. JIRA es una
producto propietario desarrollada por Atlassian, una software house
australiana, que proporciona soporte y cdigo fuente de la plataforma
a clientes que adquieran una licencia comercial.
Quines hayan utilizado otra aplicacin para la gestin de incidencias tales como Bugzilla, Mantis, HP Quality Center, Trac, etc.,
notar que, a primera vista, el mnimo comn mltiple entre estas
aplicaciones es un comportamiento bastante parecido: un grupo de
usuarios sern quienes creen las incidencias y otro grupo de usuarios,
los operadores (los desarrolladores en la jerga de JIRA) sern quienes
lleven a cabo el trabajo sobre las incidencias. Cada tipo de incidencia que se est manejando est opcionalmente sometido a flujos
de trabajos distintos: los operadores que tengan permiso de hacerlo
podrn mover la incidencia en la red de estados definida en el flujo
de trabajo asociado al especfico tipo de incidencia.
JIRA es una aplicacin extremadamente verstil y el valor aadido que aporta es una grande flexibilidad y la posibilidad de configurar
prcticamente cualquier parmetros en lo que concierne las incidencias, su flujo de trabajo y las ventanas a travs de las cuales los
usuarios trabajan sobre las incidencias. En las siguientes secciones se
explorarn someramente las caractersticas de JIRA ms importantes
que hacen que sea la plataforma ideal para cualquier proyecto.
1.1
Interfaz grfica
JIRA proporciona mltiples maneras para interactuar con ella, cada

una de las cuales satisface distintas necesidades y distintos casos de
uso. Los usuarios, normalmente, acceden e interactan con JIRA a
3
1. Introduccin
travs de su interfaz web. La interfaz web proporciona un entorno
de ltima generacin, intuitivo y fcil de utilizar, que ofrece todas
las herramientas necesarias para desempear las labores de usuarios
y operadores.
La interfaz de gestin de las incidencias proporciona un conjunto
de ventanas, configurables tanto a nivel global como a nivel de proyecto, con las cuales el usuario puede examinar las incidencias, sus
atributos, su historia y su estado actual.
La ventana de detalle de las incidencias encapsula la mayora de
la funcionalidad, concentrando en un nico cuadro de mandos toda
la informacin y las actividades que pueden desempearse sobre una
incidencia. De esta forma, los usuarios no necesitarn moverse en
muchas ventanas distintas y podrn, de una forma rpida y intuitiva,
operar sobre incidencias de cualquier tipo a travs de una interfaz
homognea.
La ventana de detalle de las incidencias proporciona todas las
operaciones definidas en el flujo de trabajo asociado con la incidencia, ofreciendo al usuario exclusivamente las operaciones que pueden
efectuarse en el estado en que se encuentra la incidencia y con los
permiso de los que el usuario disponga. Incidencias de tipos distintos
asignadas a flujos de trabajo distintos se manejarn a travs de la
misma interfaz: el tiempo necesario para que un usuario aprenda a
utilizar la herramienta se reduce, por lo tanto, al mnimo.
La interfaz web de JIRA ofrece tambin mltiples herramientas
para buscar e filtrar incidencias, cada una de las cuales satisfacen
exigencias distintas. El interfaz de bsqueda simple, por ejemplo,
proporciona al usuario una ventana con la cual construir consultas
utilizando exclusivamente herramientas grficas. Usuarios ms expertos, que necesiten el mximo control sobre las consultas creadas,
podrn utilizar el interfaz de bsqueda avanzada en la cual podrn
crear consultas utilizando el lenguaje de bsquedas de JIRA, JQL,
en una interfaz igualmente fcil de utilizar que proporciona ayudas
inteligentes mientras el usuario est tecleando la consulta.
Tambin en lo que concierne la gestin de los proyectos y la administracin de la plataforma, la interfaz grfica de JIRA tambin
ofrece herramientas excelentes y fciles de utilizar. Sin embargo, la
descripcin de las mismas est fuera del alcance de este libro y se
tratarn el el Volumen ii.
4
1.2. Los cuadros de mandos

1.2
Los cuadros de mandos
Otra herramienta muy flexible que JIRA proporciona a sus usuarios

son los cuadros de mandos. Los cuadros de mandos son ventanas
que pueden ser creadas y compartidas por los mismos usuarios en las
cuales el pueden aadirse gadgets de distinta naturaleza.
JIRA ofrece un conjunto muy extenso de gadgets que permiten,
por ejemplo, visualizar los resultados de una bsqueda grabada en un
filtro, generar grficos, visualizar estadsticas o flujos de actividad.
En un cuadro de mando podr incluirse cualquier gadget OpenSocial
e, incluso, los usuarios o las organizaciones que posean la competencia necesaria podrn desarrollarse sus propios gadgets utilizando las
herramientas del Atlassian SDK.
Los cuadros de mandos son herramientas ideales no solo para los
usuarios y los operadores de JIRA, sino para roles tales como los
jefes de proyectos o los clientes. Un cuadro de mando permite crear
rpidamente ventanas donde filtrar, agregar, resumir y analizar datos
provenientes de JIRA y, por lo tanto, ser vehculo de informacin fcil
de explotar y siempre actualizada.
Un jefe de proyecto o un cliente que necesite comprobar que se
estn respetando los acuerdos de nivel de servicio (ANS) por un conjunto de incidencias en un proyecto podrn, por ejemplo, definir las
consultas necesarias a extraer dicha informacin y presentarla en un
cuadro de mando. La informacin presentada, ya sea como resultado de una bsqueda o como grfico, podr ser una fuente de eventos
y, por lo tanto, avisar inmediatamente a los usuarios interesados
cuando dicha informacin vara, como en el caso en que la fecha de
resolucin de una incidencia supere el plazo de vencimiento definido
por el ANS.
1.3
JIRA es OpenSocial
Las ltimas versiones de JIRA son contenedores OpenSocial. OpenSocial es un conjunto de interfaces de programacin (APIs) que facilitan la construccin de aplicaciones sociales y que promueven la
interoperabilidad y la portabilidad de componentes web. OpenSocial
es promovido por organizaciones y redes sociales del calibre de Google
y MySpace y que es utilizado, por ejemplo, en aplicaciones web de
ltima generacin como iGoogle.
Tanto si se desea crear un componente web para expandir la funcionalidad de JIRA, tanto si se desea integrar un gadget OpenSocial
5
1. Introduccin
existente1 , JIRA podr importar e utilizar de forma inmediata los
gadgets y el usuario podr aadirlos y disponerlos a su gusto en los
cuadros de mando de la aplicacin (??).
1.4
Flexibilidad
JIRA es una herramienta moderna que proporciona al usuario una

interfaz web de ltima generacin, clara y fcil de utilizar. Cada
usuario maneja incidencias 2 en el mbito de un proyecto y cada proyecto puede parametrizarse para ajustarse a los requerimientos de sus
usuarios.
En el contexto de un proyecto pueden definirse, por ejemplo, los
tipos de incidencias que se desea manejar. Cada tipo de incidencia,
a su vez, podr asociarse a una configuracin de campos que define
cuales campos pueden ser utilizados en la definicin de una incidencia
y las propiedades de los mismos.
En un proyecto con incidencias de tipo factura, por ejemplo, podr
declararse que dichas incidencias poseen como campos adicionales los
campos cliente, importe y fecha de emisin, que todos los campos son
obligatorios, que el campo importe es un campo numrico y que el
campo fecha de emisin contiene un valor de tipo fecha.
De la misma forma, el tipo de incidencia de tipo factura estar
vinculado a un flujo de trabajo personalizado que prevea, por ejemplo,
los estados emitida, rechazada, parcialmente pagada y pagada.
Ya que las operaciones de un flujo de trabajo pueden protegerse
con polticas de seguridad, los objetos de tipo factura podrn ser
visibles solo a un subconjunto de usuarios y, entre ellos, solo una
parte podr operar sobre una factura.
1.5
Seguridad
El modelo de seguridad basada en roles de JIRA permite definir polticas de seguridad con grano muy fino y aplicarlas en casi cualquier
1 Como por ejemplo los gadget de iGoogle o gadget proporcionados por otras
aplicaciones de la suite de Atlassian
2 Como explicado en el prefacio, seguiremos la costumbre de Atlassian y llamaremos incidencias a los objetos gestionados en el mbito de un proyecto.
La flexibilidad de JIRA permite fcilmente parametrizar proyectos que manejen
objetos de cualquier naturaleza y, en esos casos, el significado de la palabra incidencia no transmite de forma suficientemente clara las potencialidades de la
aplicacin.
1.6. Facilidad de gestin

operacin ejecutable en la aplicacin. De esta forma, los jefes de proyectos podrn subdividir su base de usuarios en roles y asignar a cada
uno de ellos los permisos que requieren durante el desempeo de sus
labores diarias.
Los permisos de proyecto disponibles en la definicin de las polticas de seguridad, as como la aplicacin de las mismas, permiten controlar el acceso a prcticamente cualquier entidad gestionada por
JIRA, tales como proyectos, incidencias, ficheros adjuntos, comentarios, filtros, bsquedas o perfiles de usuarios, as como las operaciones
que pueden efectuarse sobre dichas entidades.
Los usuarios que soliciten acceso a informacin protegida a la que
no pueden acceder, de acuerdo a los privilegios que poseen, no podrn
siquiera saber que dicha informacin existe. En el caso de las bsquedas, por ejemplo, JIRA ocultar oportunamente los datos inaccesibles
al usuario que est efectuando la solicitud.
Por otro lado, la flexibilidad de las polticas de seguridad que
pueden crearse, permite no solo proteger a los datos almacenados en
JIRA, sino construir flujos de trabajo que involucren usuarios distintos, con permisos distintos, en distintas fases del mismo: definiendo
los roles de proyecto adecuados para cada proyecto, es muy sencillo
crear polticas de seguridad basadas en roles que, siendo una propiedad de cada proyecto, se asignen a las identidades que se requieran
con independencia de los dems proyectos en los que operan.
1.6
Facilidad de gestin
La organizacin de las configuraciones en jerarqua de objetos reutilizables llamados esquemas, adems, proporciona una herramienta fcil
de utilizar que minimiza las labores administrativas permitiendo encapsular comportamiento comn aplicable en distintos contextos en
esquemas que puedan grabarse y aplicar a proyectos distintos cada
vez que se detecte la necesidad.
La configuracin basada en esquemas, adems, es la herramienta fundamental que permite desacoplar los proyectos entre s y proporcionar mltiples entornos de trabajos distintos y estancos a los
usuarios de JIRA. As mismo, por ejemplo, los flujos de trabajo a los
que se someten las incidencias en un proyecto pueden ser definidos
y modelados por los usuarios: esto permite gestionar sin esfuerzo y
a travs de una interfaz comn no solo incidencias de proyectos de
desarrollo sino las entidades ms diversas en proyectos de todo tipo.
7
1. Introduccin
Documentacin, riesgos de proyecto, facturas, rdenes de pago y
entregas de material son solo algunos de los objetos gestionados por
instancias de JIRA en las organizaciones ms distintas.
JIRA se integra perfectamente con otros productos de la suite
Atlassian tales como Crowd, FishEye/Crucible, Confluence y Bamboo y permite agregar informacin procedente de cualquiera de estas
herramientas en un nico cuadro de mando utilizando la tecnologa
de los gadgets.
1.7
Elegir una licencia
Comenzar a utilizar JIRA es fcil: Atlassian proporciona licencias de

evaluacin de la duracin de 30 das que se pueden solicitar directamente en la web oficial de Atlassian. Una aplicacin con licencia de
prueba no tiene restringida prcticamente ninguna funcionalidad: la
nica forma de darse cuenta que se est utilizando una instancia de
JIRA con licencia de evaluacin ser un aviso en el pi de pgina del
interfaz web avisando de esta condicin con un mensaje parecido al
siguiente:
THIS JIRA SITE IS FOR DEMONSTRATION PURPOSES ONLY.
Despus de haber probado libremente a JIRA con una licencia de

evaluacin, a menos de no encontrarse en el supuesto necesario para
solicitar a Atlassian una licencia gratuita (??), es necesario adquirir
una licencia comercial para poder utilizar JIRA en un entorno de
produccin.
1.7.1
Licencias comerciales
JIRA es una herramienta propietaria que requiere una licencia comercial para poderse utilizar. El modelo de licencia de JIRA se basa
en el nmero mximo de usuarios activos que se desean utilizar en la
instancia de JIRA a licenciar: hoy en da existen licencias para 10,
25, 100 e ilimitados usuarios.
En el Cuadro 1.1 se detallan las opciones y los precios de las
licencias comerciales de JIRA actualmente en comercio. Los precios
indicados en ste Cuadro se proporcionan a ttulo informativo: para
consultar los precios actualmente en vigor es necesario contactar con
Atlassian [8] o con un Atlassian Partner [12] en cualquier pas del
mundo.
8
1.7. Elegir una licencia

Licencias comerciales
10
25
50
100
100+
Usuarios
Usuarios
Usuarios
Usuarios
Usuarios
$10
$1200
$2200
$4000
$8000
Tabla 1.1: Licencias comerciales
Pequeos proyectos con menos de 10 usuarios pueden solicitar la

licencia bsica que es disponible a un precio simblico de $10 cuyos
beneficios Atlassian destina a obras de beneficencias.
1.7.2
Licencia gratuita
Tambin existe una licencia gratuita de JIRA que puede ser solicitada
por proyectos open source y organizaciones que cumplan una serie de
requisitos entre los cuales figuran los siguientes:
(i)
(ii)
(iii)
(iv)
(v)
(vi)
1.7.3
ser
ser
ser
ser
ser
ser
una
una
una
una
una
una
organizacin
organizacin
organizacin
organizacin
organizacin
organizacin
sin nimo de lucro;

no gubernamental;
no acadmica;
no comercial;
no poltica;
secular.
Contactar con un Experto
Existe una red de expertos oficiales de Atlassian (Experts) a nivel

mundial a los cuales los usuarios y las organizaciones pueden acudir para solicitar licencias o cualquier tipo de ayuda e informacin
adicional.
La lista de Partners oficiales de Atlassian est disponible a la
siguiente direccin [9]:
http://www.atlassian.com/resources/experts
2
Conceptos bsicos
A menudo los usuarios inexpertos de JIRA tienden a pensar en los
proyectos solo como a una subdivisin lgica de incidencias en la
plataforma: un conjunto de sacos con nombre, muy similares entre
ellos, donde almacenar las incidencias.
Esta visin, an correcta en su esencia, es demasiado limitada y
no toma en consideracin ninguna de las caractersticas que hacen de
JIRA la plataforma tan flexible que supo salir del nicho de la gestin
de proyectos de desarrollo y diferenciare de su competencia.
Esta percepcin por parte de los usuarios puede a menudo generar
problemas a la hora de utilizar la herramienta lejos de los parmetros para los cuales ha sido creada y con los cuales est, todava,
siendo distribuida. JIRA, por defecto, proporciona un conjunto de
tipos bsicos de incidencias y un flujo de trabajo estndar pero, a
diferencia de otras herramientas, proporciona mucha flexibilidad a la
hora de definir los parmetros de trabajo: prcticamente cualquier
aspecto del entorno de trabajo puede configurarse.
Es imperativo que los usuarios, antes que nadie, entiendan cuales
son los puntos de fuerza de JIRA y sean conscientes de las funcionalidades que sta puede ofrecer. Solo disponiendo de este conocimiento
los usuarios podrn formular adecuadamente los requerimientos que
mejor satisfagan a sus necesidades e impulsar la implementacin de
los mismos, por parte de los administradores, en el conjunto apropiado de esquemas de configuracin y modelar as la funcionalidad de
un proyecto.
Por esta razn, en este captulo introductivo se presentarn los
conceptos bsicos manejados en JIRA, tales como proyecto, incidencia
y flujo de trabajo, y las relaciones que se establecen entre ellos, con
el objetivo de familiarizar al usuario con estas entidades y con la
11
2. Conceptos bsicos
organizacin de conceptos dentro de la plataforma ya que stos son
los objetos fundamentales que se manejan en JIRA.
2.1
Proyectos
En lo que concierne los usuarios de JIRA, un proyecto es el contenedor

de las incidencias, el lugar donde los usuarios pueden abrir incidencias
o trabajar sobre ellas. El proyecto, adems, es el contexto donde
se aplican las configuraciones que satisfacen los requerimientos y las
funcionalidades solicitadas por los usuarios. Siempre que un usuario
opera sobre una incidencia, lo hace en el contexto de un proyecto
y la mayora del comportamiento de JIRA y de las incidencias est
determinado por las configuraciones que se han establecido a este
nivel.
Aunque dominio de los administradores, es importante que los
usuarios conozcan las herramientas que proporciona JIRA para configurar un proyecto y adecuarlo a sus necesidades. Para un usuario,
el proyecto debe poderse considerar una instancia de JIRA privada, aislada de los dems proyectos. Los usuarios podrn entonces
definir sus requerimientos en libertad y solicitar a los administradores
la personalizacin de su proyecto para ajustarlo a las necesidades del
negocio que necesitan gestionar.
En las siguientes secciones (2.5) se introducir el concepto de
esquema, se aclarar como los esquemas definen el comportamiento
de las incidencias dentro de un determinado proyecto y se detallarn
los aspectos ms importantes que los usuarios de un proyecto podrn
ajustar a sus necesidades.
2.1.1
Componentes
Un proyecto puede dividirse opcionalmente en componentes. Un componente es una agrupacin lgica de incidencias y una incidencia
puede pertenecer a ninguno, uno o muchos componentes a la vez. Un
componente tiene los siguientes atributos:
(i) Nombre.
(ii) Descripcin.
(iii) Responsable del componente.
Un componente puede pensarse tambin como un sub-proyecto,
con un responsable y un conjunto de incidencias a gestionar. JIRA,
12
2.1. Proyectos
de hecho, proporciona un cuadro de mando de componente, idntico
al cuadro de mando de proyecto, donde se visualizan los indicadores
de actividad del proyecto y otras estadsticas.
El responsable de un componente se un operador al que, por defecto, se asignan las incidencias de un componente: de esta manera,
si entran incidencias en el sistema sin ser asignadas esplicitamente
a un usuario, JIRA podr asignarlas al mejor operador utilizando
los componentes a ella asignados como parmetros para tomar esta
decisin.
La subdivisin de un proyecto en componentes, o sub-proyectos,
ser un requerimiento de los usuarios ya que, a menudo, no solo es una
particin lgica sino que refleja la organizacin del equipo. La gestin de los componente puede ser efectuada por usuarios que tengan
los permisos correspondientes, es decir, el permiso de proyecto Administer projects. Aunque es comn efectuar esta operacin al principio
del proyecto, JIRA permite modificar la lista de componentes en cualquier momento y aadir, por ejemplo, los nuevos componentes que se
vayan necesitando con el tiempo.
En Figura 4.14 puede verse un detalle de la ventana de configuracin de proyecto de Figura 4.4, el panel de componentes de un
proyecto.
Figura 2.1: Componentes de un proyecto
Ejemplo 2.1. Un proyecto de desarrollo de una aplicacin web podra organizar sus incidencias en componentes tales como:
(i)
(ii)
(iii)
(iv)
(v)
(vi)
Database.
Interfaz web.
Documentacin de proyecto.
API.
Web Services.
Pruebas.
13
2. Conceptos bsicos
En este caso cada componente refleja las tecnologas que se estn
empleando para construir la aplicacin y esta subdivisin permite
organizar las incidencias en grupos que pueden ser asignados a equipos
distintos.
Ejemplo 2.2. Los usuarios de un proyecto JIRA para la gestin
de incidencias en un call center de una empresa de logstica podran
requerir una subdivisin del mismo en los siguientes componentes:
(i) Pedidos.
(ii) Facturacin.
(iii) Transporte.
En este caso cada componente refleja una unidad organizativa dentro
de la empresa.
2.1.2
Versiones
Algunas tipologas de proyecto podran beneficiarse de una subdivisin en fases llamadas versiones. Una versin tiene los siguientes
atributos:
(i)
(ii)
(iii)
(iv)
Nombre.
Descripcin.
Fecha de entrega.
Planificacin.
Una versin puede estar en uno de los siguiente estados:

(i) Unreleased: la versin todava no se ha entregado.
(ii) Released: la versin se ha entregado.
(iii) Archived: la versin se ha archivado.
Las versiones no estn organizadas en jerarquas sino que son un
conjunto de atributos de un proyecto que pueden relacionarse con
las incidencias en campos de tipo versin. Las incidencias de JIRA
llevan por defecto dos campos relacionados con las versiones, Affects
version(s) y Fix version(s), a travs de las cuales pueden establecerse
las relaciones bsicas entre incidencia, i, y versione, v:
(i) La incidencia i afecta la versin v:
afecta
i v
14
(2.1)
2.1. Proyectos
(ii) La incidencia i se soluciona en la versin v:
se soluciona en
i v
(2.2)
El usuario, sin embargo, podr solicitar la creacin de campos personalizados de tipo versin y, por lo tanto, definir cualquier relacin
necesite. Las versiones, en este sentido, pueden pensarse como un
tipo de agrupacin ms de incidencias de un proyecto.
A pesar del nombre y del origen de este tipo de campos, los usuarios pueden utilizar campos de tipo versin para subdividir el proyectos en grupos de incidencias los cuales tienen como factor comn un
atributo con las caractersticas peculiares de una versin, es decir:
una planificacin y un estado (vase el Ejemplo 2.3).
Ejemplo 2.3. Los usuarios de un proyecto quisieran poder organizar
las incidencias en grupos utilizando el parmetro ao. En este caso,
el administrador de proyecto podr definir una versin por cada ao
que comienza. La fecha de vencimiento de la incidencia ser el 31
Diciembre del ao correspondiente y, cada vez que termine un ao, la
versin se entregar para que cambie de estado y los usuarios vean el
estado actualizado en los controles de tipo versin.
En este caso, la versin se utilizar simplemente para registrar
las incidencias en el ao corriente con independencia de los dems de
campos de tipo fecha utilizados para la planificacin de las incidencias.
Ejemplo 2.4. Un proyecto de desarrollo ha decidido utilizar la metodologa gil Scrum [32] la cual sugiere dividir las actividades de
desarrollo en unidades bsicas, llamadas sprint, de duracin limitada
y prefijada.
Para organizar las incidencias en JIRA de acuerdo a los principios de Scrum y facilitar las labores del equipo, se pueden utilizar
las versiones para representar a un sprint y seguir un procedimiento
parecido al siguiente:
(i) Al momento de la creacin de las incidencias en JIRA no se
utilizan los campos de tipo versin.
(ii) El Scrum Master (o quin tenga responsabilidades parecidas),
despus de cada reunin de planificacin de un sprint, crea una
versin para representar el sprint.
(iii) Se asignan las incidencias a resolverse durante el sprint utilizando campos de tipo versin.
15
2. Conceptos bsicos
(iv) La fecha de entrega de la versin corresponder a la duracin
establecida al sprint en curso.
(v) Al final de cada sprint, se entrega la versin correspondiente.
En Figura 4.10 puede verse un detalle de la ventana de configuracin de proyecto de Figura 4.4 con las versiones de un proyecto.
Figura 2.2: Versiones de un proyecto
Las versiones pueden utilizarse para generar change logs y road

maps disponibles, por defecto, en el cuadro de mando de JIRA como
ilustrado en Figura 4.7.
Figura 2.3: Road map de un proyecto
2.2
Incidencias
Las incidencias son los objetos de negocio que se manejan en JIRA.

Como explicado en el prefacio de esta gua, la utilizacin de la palabra incidencia radica en la costumbre de utilizar JIRA en proyectos
16
2.2. Incidencias
relacionados con el desarrollo y el control de calidad del software. Sin
embargo, JIRA permite manejar proyectos e incidencias de cualquier naturaleza.
En Figura 2.4 puede verse una captura de pantalla de la ventana
estndar de detalle de incidencia de JIRA. En la parte superior de la
ventana, debajo del ttulo de la incidencia, pueden verse los botones
que representan todas las operaciones que el usuario puede efectuar
sobre la incidencia. Los botones visibles dependern de los privilegios
del usuario y solo estarn disponibles las operaciones que estn habilitadas de acuerdo a los permisos que el usuario conectado tenga en
el contexto del proyecto utilizado.
La lista de campos visibles en esta ventana podr depender de las
configuraciones personalizadas que el administrador haya implementado en el proyecto y, por lo tanto, la ventana de detalle de incidencia
de otro proyecto u otro tipo de incidencia podr ser distinta de ventana de la ilustracin.
Figura 2.4: Ventana de detalle de incidencia
17
2. Conceptos bsicos
2.2.1
Tipo de incidencia
Todas las incidencias en un proyecto pertenecen a un tipo de incidencia. El tipo de incidencia es uno de los parmetros fundamentales
que gobiernan el comportamiento de las incidencias en un proyecto
de JIRA ya que es la entidad con la que se establecen enlaces con
las dems categoras de parmetros de configuracin relacionados con
las incidencias tales como:
(i) El comportamiento de las incidencias de cada tipo en un flujo
de trabajo.
(ii) Los datos almacenados en cada incidencia en una configuracin
de campos.
(iii) Las pantallas utilizadas por los usuarios en una configuracin
de pantallas.
Por defecto, JIRA proporciona los siguientes tipos de incidencia:
(i)
(ii)
(iii)
(iv)
Bug
Improvement
New feature
Task
Dependiendo de los requerimientos de los usuarios, se podrn crearn los tipos de incidencias que cada proyecto necesite.
Ejemplo 2.5. Un proyecto para la gestin de auditoras de calidad
de software podra requerir la definicin de los siguientes tipos de
incidencias:
(i) Riesgo: para modelar los riesgos de proyecto manifestados por
las aplicaciones a auditar.
(ii) Entregable: para modelar los entregables que las aplicaciones
someten a auditora.
(iii) Hito: para modelar los hitos en la planificacin de las aplicaciones auditadas.
(iv) Auditora: para modelar las auditoras solicitadas por las aplicaciones.
Ejemplo 2.6. Un un proyecto de desarrollo y mantenimiento de software podra requerir la definicin de los siguientes tipos de incidencias:
18
2.2. Incidencias
(i) Dependencia: para modelar la dependencia con otro departamento u organizacin.
(ii) Documentacin: para modelar la documentacin a producirse.
(iii) Instalacin: para modelar la instalacin de la aplicacin en un
entorno.
(iv) Configuracin: para modelar la configuracin de la aplicacin
en un entorno.
2.2.2
Campos
Las incidencias, por defecto, llevan una serie de campos detallados en

Tabla 2.1.
Los campos estndar de las incidencias de JIRA no pueden ni borrarse ni modificarse: a lo sumo, algunos campos pueden esconderse,
siempre que sean campos opcionales de las incidencias.
Sin embargo, los usuarios no estn limitados a utilizar exclusivamente los campos de incidencia estndar de JIRA: la plataforma
permite extender el significado de las incidencias definiendo campos
personalizados y asignndolos a los tipos de incidencias que se desean
modificar. De esta forma, los usuarios podrn solicitar los campos
que necesitan almacenar en cada tipo de incidencia e modelar as
libremente la estructura de los objetos manejados por su negocio.
Ejemplo 2.7. Un proyecto para la gestin de auditoras de calidad de
software podra requerir la definicin de campos personalizados para
las incidencias de tipo riesgo y entregable vistas en el ejemplo 2.5.
Para las incidencias de tipo riesgo se podran definir los siguientes
campos:
(i)
(ii)
(iii)
(iv)
Aplicacin: la aplicacin que manifiesta el riesgo.

Tipo: el tipo de riesgo.
Estado: el estado del riesgo (manifestado, mitigado, etc.).
Impacto: el impacto del riesgo.
Para las incidencias de tipo entregable se podran definir los siguientes campos:
(i) Aplicacin: la aplicacin que somete a revisin el entregable.
(ii) Tipo: el tipo de entregable.
(iii) Estado: el estado del entregable (rechazado, aceptado, etc.).
19
2. Conceptos bsicos
Nombre
Descripcin
Project
Key
El proyecto al que pertenece la incidencia.

El identificador nico de la incidencia. El formato del identificador es PKEY-IKEY donde PKEY es
el identificador nico del proyecto y IKEY es el
identificador nico de la incidencia en el proyecto.
Ttulo de la incidencia.
El tipo de incidencia. (2.2.1)
El estado de la incidencia. (2.2.4)
La prioridad de la incidencia. (2.2.3)
El estado de resolucin de la incidencia (2.2.5).
Opcional. Las versiones del proyecto en las cuales se est manifestando la incidencia.
Opcional. Las versiones del proyecto en las cuales estar resuelta la incidencia.
Opcional. Los componentes del proyecto relacionados con la incidencia.
Opcional. Las etiquetas asignadas a la incidencia.
Opcional. El entorno al que est relacionada la
incidencia.
Descripcin de la incidencia.
Enlaces a incidencias relacionadas.
El operador al que est asignada la incidencia.
El usuario que ha abierto la incidencia.
Los votos otorgados a la incidencia.
El nmero de usuarios que estn observando la
incidencia.
Opcional. La fecha estimada de resolucin de la
incidencia.
Fecha de creacin de la incidencia.
Fecha de ltima actualizacin de la incidencia.
Fecha de resolucin de la incidencia.
Estimacin del tiempo requerido para solucionar
la incidencia.
Estimacin del tiempo que queda para solucionar
la incidencia.
Suma del tiempo dedicado por los operadores a
la resolucin de la incidencia.
Summary
Type
Status
Priority
Resolution
Affect version(s)
Fix version(s)
Component(s)
Label(s)
Environment
Description
Links
Assignee
Reporter
Votes
Watches
Due
Created
Updated
Resolved
Estimate
Remaining
Logged
Tabla 2.1: Campos estndar de una incidencia
20
2.2. Incidencias
Ejemplo 2.8. En un proyecto de desarrollo de software podran asignarse campos personalizados a los tipos de incidencias que representan solicitudes a otros departamentos u otras organizaciones (vase
ejemplo 2.6) para mantener traza de las mismas en el caso en que no
se puedan utilizar enlaces de incidencias. Los campos que se podran
definir son, por ejemplo:
(i) Nmero de ticket: el identificador de la solicitud.
(ii) Acuerdo de nivel de servicio: para reflejar el acuerdo de nivel
de servicio que aplica a este tipo de incidencia.
(iii) Contacto: para almacenar la persona de contacto a cargo de la
incidencia.
2.2.3
Prioridad
La prioridad de una incidencia es un campo que permite establecer

la importancia relativa de una incidencia con respeto a otras incidencias en el mismo proyecto. Por defecto JIRA proporciona las
siguientes prioridades, en orden decreciente de importancia:
(i) Blocker: prioridad asignada a incidencias que bloquean el progresar de otras labores.
(ii) Critical: prioridad asignada a incidencias de importancia crtica
que, al momento, no estn bloqueando otras labores.
(iii) Major: prioridad asignada a incidencias de importancia mayor.
(iv) Minor: prioridad asignada a incidencias de importancia menor.
(v) Trivial: prioridad asignada a incidencias de importancia trivial.
El administrador de JIRA puede definir niveles adicionales de prioridad aunque dichos niveles no sern limitados al contexto de un proyecto sino a toda la plataforma.
La prioridad se utiliza primariamente en operaciones de filtrado
de incidencias, asignacin y reporting.
Ejemplo 2.9. El jefe de proyecto o un cliente podran estar interesados a saber cuales incidencias alcanzan el nivel de prioridad critical y
blocker. Las incidencias que alcanzan estos niveles de prioridad pueden, por ejemplo, filtrarse a travs de una bsqueda personalizada
cuyo resultado puede utilizarse para poblar un gadget del cuadro de
21
2. Conceptos bsicos
mando o desencadenar una notificacin por correo electrnico a los
usuarios suscritos a dicho filtro.
2.2.4
Estado
El estado de una incidencia es un flag que indica en que punto de su

flujo de trabajo (2.3) se encuentra una incidencia. Los estados que
por defecto estn definidos en el flujo de trabajo estndar de JIRA
son los siguientes:
(i) Open: Estado inicial de una incidencia antes de que se empiece
a operar sobre ella.
(ii) In progress: Incidencia sobre la cual un operador est trabajando.
(iii) Resolved: Incidencia que ha sido resuelta.
(iv) Reopened: Incidencia que se ha vuelto a abrir despus de haber
estado resuelta o cerrada.
(v) Closed: Incidencia cerrada.
No es necesario que exista una relacin uno a uno entre los
estados de las incidencias y los estados del flujo de trabajo asociado a
esa incidencia: normalmente, de hecho, distintos estados de un flujo
de trabajo pondrn ser relacionados al mismo estado de la incidencia.
Ejemplo 2.10. Un estado que a menudo puede estar asociado a
mltiples estados de un flujo de trabajo es el estado In progress. Si un
proyecto decide extender el flujo de trabajo estndar de JIRA para
reflejar actividades de auditora sobre el trabajo realizado, podra
decidir aadir los siguientes estados:
(i) Entregado.
(ii) Auditando.
(iii) Auditado.
Sin embargo, de cara a los operadores, puede considerarse innecesario
crear estados adicionales a relacionarse con dichos estados del flujo
de trabajo ya que, en lo que concierne el trabajo de los usuarios, la
incidencia puede considerarse en progreso.
La relacin entre estados de una incidencia y estados de un flujo de
trabajo se establecen a nivel de flujo de trabajo y, por lo tanto, pueden
configurarse en el contexto de un proyecto a travs de un esquema de
flujo de trabajo (??). En Figura 2.5 se ilustran las relaciones entre
22
2.2. Incidencias
los conceptos de estado de incidencia y estado de un flujo de trabajo.
Figura 2.5: Relacin entre estado de una incidencia y flujo de trabajo
Ejemplo 2.11. Un proyecto con necesidades parecidas al proyecto

ilustrado en el ejemplo 2.10 podra decidir de querer reflejar en el estado que una incidencia se encuentra en espera mientras los actores
externos trabajan sobre ella. En este caso se podran definir nuevo
estados, tales como el estado En espera, y asignarlos a uno o ms
estado del flujo de trabajo de ste tipo de incidencia.
2.2.5
Resolucin
A las incidencias que entran en un sistema no siempre se solucionan

de la misma forma: a veces se implementa una solucin, otras veces
las incidencias no son tales y otras veces se toma la decisin de no
solucionarla. El campo resolucin define como y si una incidencia
se ha solucionado. Las resoluciones que JIRA define por defecto son
las siguientes:
(i)
(ii)
(iii)
(iv)
Fixed: la incidencia ha sido resuelta.

Wont fix: la incidencia no se resolver.
Duplicate: la incidencia no se resolver porque es un duplicado.
Incomplete: la incidencia no se resolver porque ha sido descrita
de forma incompleta.
23
2. Conceptos bsicos
(v) Cannot reproduce: la incidencia no se resolver porque no se
puede reproducir siguiendo las instrucciones proporcionadas por
el usuario que ha reportado la incidencia.
Los usuarios que necesiten definir nuevos tipos de resolucin podrn solicitarlas a los administradores de JIRA y las resoluciones
creadas se aadirn al conjunto de resoluciones que existen en la plataforma.
Las resoluciones son un parmetro global de JIRA y, por lo tanto,
sern visibles a todos los proyectos.
Ejemplo 2.12. En un proyecto donde se estn gestionando incidencias proporcionando el servicio definido en un contrato de soporte,
podran definirse resoluciones adicionales para tener traza de la casustica que puede presentarse:
(i) Soporte insuficiente: la incidencia no se resolver porque el nivel de soporte contratado por el usuario no cubre este tipo de
incidencias.
(ii) Solicitud de mejora: la incidencia no se resolver porque se
considera una solicitud de mejora y, por lo tanto, deber abrirse
una nueva incidencia del tipo correspondiente.
2.3
Flujos de trabajo
Los flujos de trabajo definen la mquina de estados asociada a uno

o ms tipos de incidencias en JIRA. JIRA proporciona un flujo de
trabajo por defecto que no puede modificarse y que est ilustrado en
Figura 2.6: las cajas son los estados de la mquina y las flechas
son las transiciones entre estados. El flujo de trabajo por defecto
contempla los siguientes estados:
(i) Open: una incidencia ha sido creada y todava no se ha comenzado a trabajar sobre ella.
(ii) In progress: se est trabajando sobre la incidencia.
(iii) Resolved: la incidencia se ha resuelto.
(iv) Closed: la incidencia se ha cerrado.
(v) Reopened: la incidencia se ha vuelvo a abrir despus de haber
sido resuelta o cerrada.
24
2.3. Flujos de trabajo
Figura 2.6: Flujo de trabajo por defecto de JIRA
Subrayamos que la aparente duplicidad entre el estado resuelta y

cerrada se debe a que JIRA proporciona dos permisos de proyecto
distintos para resolver y cerrar incidencias. Esta flexibilidad puede
utilizarse, por ejemplo, para otorgar el permiso de cerrar incidencias
solo a un subconjunto de usuarios que tienen como responsabilidad
la supervisin del trabajo de los operadores.
Cada proyecto distinto puede tener necesidades de negocio distintas y los flujos de trabajo asociados a cada tipo de incidencia son
una parte fundamental de la adaptacin de la herramienta a las necesidades del negocio y de los usuarios. Un proyecto para gestionar
campaas de captacin de clientes, por ejemplo, requerir flujos de
trabajo completamente distintos a los que requiera un proyecto de
desarrollo de software o un proyecto para la gestin de solicitudes de
soporte tcnico.
La creacin de flujos de trabajos personalizados permite implementar cualquier comportamiento que los usuarios requieran para todos los tipos de incidencias gestionados en su proyecto, siempre que
dicho comportamiento se pueda modelar con una mquina de estados.
Un flujo de trabajo se modela de forma sencilla utilizando el interfaz web de JIRA. Los usuarios, que normalmente no pueden utilizar
25
2. Conceptos bsicos
esta herramienta, debern definir los siguientes requerimientos y proporcionarlos a los administradores de la plataforma:
(i) Los estados de la mquina de estados.
(ii) Las transiciones entre estados.
(iii) La relacin entre estado de una incidencia y estado del flujo de
trabajo.
Adicionalmente, a cada transicin podrn asignarse validadores, condiciones y una pantalla a visualizarse durante la transicin.
El administrador puede definir los flujos de trabajos necesarios
para los proyectos de su organizacin y asignarlos a tipos de incidencias en el contexto de un proyecto a travs de un esquema de flujo de
trabajo.
Ejemplo 2.13. Un proyecto que utilice los tipos de incidencia introducidos en el ejemplo 2.5 (riesgo, entregable, hito y auditora) podran
desear asociarlas a flujos de trabajo personalizados.
El flujo de trabajo de las incidencias de tipo riesgo, por ejemplo,
podra tener los siguientes estados:
(i)
(ii)
(iii)
(iv)
Manifestado.
Mitigado.
Transferido.
Rechazado.
El flujo de trabajo de las incidencias de tipo auditora podra

obtenerse copiando y reduciendo el flujo de trabajo estndar de
JIRA:
(i) Open.
(ii) In progess.
(iii) Closed.
2.4
Organizacin de los conceptos
Parte de la flexibilidad de la plataforma se debe a la organizacin

modular y jerrquica de los conceptos gestionados por la misma. Por
un lado, JIRA organiza y subdivide las configuraciones en grupos
de atributos, llamados esquemas, funcionalmente relacionados entre
ellos. Existen, por ejemplo, esquemas de configuracin de campos, en
26
2.4. Organizacin de los conceptos

los cuales se establece el conjunto de parmetros de configuracin de
los campos de las incidencias, o esquemas de configuracin de pantalla, en los cuales se establece cuales pantallas se utilizarn por cada
operacin definida en el esquema.
Por el otro lado, el administrador selecciona los mdulos de configuracin necesarios a satisfacer las necesidades de un proyecto y
los asocia con el mismo. La estructura jerrquica resultante es el mecanismo a travs del cual las configuraciones se aplican en el contexto
de los proyectos a ellas relacionados y garantizan que, con un mecanismo parecido a las muecas rusas, cada proyecto de JIRA sea
un entorno de trabajo completamente aislado de los proyectos que no
comparten esquemas con l.
Como explicado en 2.1, los usuarios de JIRA, cuando operan
sobre las incidencias, actan siempre dentro en el contexto de un
proyecto. El proyecto es el contenedor donde se agregan todos los
esquemas de configuracin de JIRA que estarn activos en el contexto
del mismo: configuracin de campos, pantallas, flujos de trabajo y
seguridad son solo algunos ejemplos de las configuraciones que pueden
establecerse a nivel de proyecto.
Los esquemas que componen la configuracin de un proyecto son
elementos que pueden reutilizarse cuando proyectos distintos comparten similitudes. Es importante, no obstante, subrayar que compartir
esquemas genera un acoplamiento entre proyectos distintos y que, por
lo tanto, cada modificacin aportada en un esquema compartido se
reflejar de inmediato en todo proyecto que lo est utilizando.
Es responsabilidad de los usuarios determinar si, y cuando, compartir esquemas entre proyectos distintos teniendo en cuenta de las
ventajas y de los problemas que esta eleccin conlleva. Para facilitar
las tareas de administracin parece conveniente reducir al mnimo el
nmero de esquemas existentes y fomentar la reutilizacin de configuraciones que ya se han establecido. Sin embargo, nadie mejor que el
usuario puede determinar cuando es conveniente crear nuevos esquemas y dedicarlos exclusivamente a un proyecto o cuando es preferible
compartirlos con otros.
Durante la toma de esta decisin habr que analizar muchos factores y oportunidades. Es necesario evaluar, por ejemplo, si las necesidades de un grupo de proyectos estn sujetas a variar con el tiempo
y acabar divergiendo.
En caso de duda, y siempre cuando se est considerando de compartir esquemas con proyectos fuera de nuestro control, es conveniente
reducir las interferencias al mnimo y empezar solicitando esquemas
27
2. Conceptos bsicos
distintos. La consolidacin de esquemas, cuando se detecta que es
beneficioso compartir esquemas y reducir la redundancia de configuracin, siempre se podr efectuar a posteriori.
2.5
Esquemas
Para aclarar este concepto es importante saber que, desde el punto

de vista administrativo, un proyecto es una particin de JIRA con
un nombre y un cdigo de identificacin en la cual se establecen las
relaciones con los esquemas de configuracin de JIRA. En Figura 2.7
puede verse la relacin que JIRA establece entre esquemas y proyectos.
Figura 2.7: Organizacin de los conceptos en JIRA
Las configuraciones establecidas en los esquemas relacionados con

un proyecto determinan un gran nmero de parmetros de funcionamiento incluyendo, aunque la lista no sea exhaustiva, las ventanas
del proyecto, los tipos y los atributos de la incidencia y los flujos de
trabajo. En la actualidad, un proyecto de JIRA establece relaciones
con los siguientes esquemas:
(i)
(ii)
(iii)
(iv)
(v)
(vi)
(vii)
Esquema
Esquema
Esquema
Esquema
Esquema
Esquema
Esquema
de
de
de
de
de
de
de
tipos de incidencia (2.5.2).

configuracin de campos (2.5.3).
pantallas para tipos de incidencia (2.5.4).
flujo de trabajo (2.5.5).
notificacin (2.5.6).
permisos (2.5.7).
seguridad de incidencia (2.5.8).
Los esquemas son el medio a travs del cual proyectos distintos

podrn implementar requerimientos de negocios completamente distintos. Como hemos visto en los ejemplos de las secciones precedente,
28
2.5. Esquemas
un proyecto de desarrollo de software podr definir un conjunto de
tipos de incidencias, campos y flujos de trabajos que reflejen las necesidades de un proyecto de ese tipo utilizando los correspondientes
tipos de esquemas. Un proyecto para gestionar una campaa de marketing, por otro lado, implementar las caractersticas nicas de su
funcionalidad en un conjunto de esquemas distintos que satisfagan a
sus necesidades.
Los esquemas de configuracin, en las versiones de JIRA hasta
la fecha, solo pueden ser creados por los administradores de JIRA.
Sin embargo, el conocimiento funcional para definir las caractersticas de cada esquema y si un esquema puede o no reutilizarse entre
proyectos distintos es responsabilidad de los usuarios que han solicitado dichos esquemas. Es fundamental, por lo tanto, que tanto los
administradores como los usuarios se familiaricen con este conceptos
y sea conscientes de las implicaciones que existen cuando proyectos
distintos comparten algn esquema.
Ejemplo 2.14. Los tipos incidencias manejadas por los usuarios en
el contexto de un proyecto, por ejemplo, estn determinados por el
esquema de configuracin de tipos de incidencias. Proyectos que manejen incidencias de tipos distintos se asociarn, por lo tanto, a esquemas de tipos de incidencia distintos.
Ejemplo 2.15. El esquema de configuracin de campos define el
significado de las incidencias definiendo los atributos que estas almacenan. Es por lo tanto posible que proyectos distintos estn compartiendo un tipo de incidencia, como por ejemplo el tipo factura: sin
embargo, cada uno de los proyectos podr definir los atributos de cada tipo de incidencia y, por lo tanto, es en el contexto de un proyecto
donde las incidencias cobran el significado que se les ha otorgado en
virtud de las necesidades del mismo.
Ejemplo 2.16. Cada tipo de incidencia puede asociarse a un flujo
de trabajo a travs del esquema de flujos de trabajo. Las operaciones
disponibles para cada tipo de incidencias estn entonces definidas
por los flujo de trabajo a ellas asociados en el contexto del proyecto:
los usuarios tiene, por lo tanto, plena libertad de definir sus flujos
con independencia de las elecciones que se hayan tomado en otros
proyectos.
29
2. Conceptos bsicos
2.5.1
Desacoplamiento de proyectos y reutilizacin de

esquemas
Los esquemas de configuracin de JIRA son una herramienta poderosa que permiten al administrador desacoplar las configuraciones de
los proyectos a los que aplican. De esta forma los esquemas se convierten en componente reutilizables donde encapsular configuraciones
comunes a ms que un proyecto.
De la misma forma los esquema aislan proyectos distintos y permiten crear, aplicar o modificar parmetros de configuracin sin que
dichas modificaciones interfieran en otros proyectos no relacionados
con los esquemas modificados.
Una buena recomendacin es que, a menos que los usuarios pidan
explcitamente que algunos proyectos compartan esquema, el administrador asle todo proyecto creando un conjunto de esquemas ad
hoc. Para facilitar estas labores JIRA proporciona tanto la posibilidad de crear un nuevo esquema copiando un esquema existente
cuanto la posibilidad de comparar esquemas distintos, comprobar si
son equivalentes y reducir la redundancia. Es ms seguro consolidar
esquemas a posteriori que correr el riesgo que los proyectos interfieran el uno con el otro cuando se modifiquen algunas configuraciones
compartidas.
2.5.2
Tipos de incidencias disponibles
Cada proyecto manejar entidades distintas y, por lo tanto, es importante que stas se plasmen en los correspondientes tipos de incidencias disponibles a los usuarios sin limitarse a los tipos proporcionados
por defecto.
El esquema de tipos de incidencias es la herramienta que permite
definir el conjunto de tipos de incidencias que se podrn manejar en
el contexto de un proyecto.
2.5.3
Configuracin de campos
Cada tipo de incidencia estar asociado a un conjunto de campos

potencialmente distinto y JIRA proporciona la posibilidad de definir
el contexto de aplicacin de un campo personalizado que puede ser
global o por tipo de incidencia.
An as, proyectos distintos podran necesitar configuraciones distintas para los campos de los tipos de incidencias que comparten:
30
2.5. Esquemas
campos obligatorios en un proyecto podran ser opcionales en otros
o, incluso, algunos campos podran ser innecesarios .
El usuario podr definir, en un esquema de configuracin de campos, la obligatoriedad del campo, la visibilidad del campo y las pantallas en las cuales el campo est disponible.
2.5.4
Configuracin de pantallas
JIRA presenta al usuarios pantallas distintas en respuesta a operaciones de diverso tipo:

(i)
(ii)
(iii)
(iv)
Creacin de incidencia.
Vista de detalle de incidencia.
Modificacin de incidencia.
Transicciones de flujos de trabajo, tales como la resolucin o el
cierre de una incidencia.
Por defecto, las pantallas que JIRA ofrece son muy parecidas y,
por lo tanto, los usuarios inexpertos podran no percatarse de esta
funcionalidad. JIRA sin embargo, permite que el usuario configure
cada pantalla de acuerdo a sus necesidades.
El usuario puede configurar la estructura de la pantalla proporcionada por cada operacin sobre las incidencias (creacin, detalle y
edicin) e, incluso, especificar configuraciones distintas por cada tipo
de incidencia utilizada en un proyecto. El usuario, adems, podr
escoger una configuracin de pantalla por cada transicin de flujo de
trabajo que requiera introduccin de datos por parte del usuario.
Ejemplo 2.17. Los responsables de un proyecto que utiliza el tipo
de incidencia auditora quisieran asegurarse de que algunos campos
de una esta incidencia no pudiera modificarse despus de haber sido
introducidos y antes de que la incidencia se cierre1 .
Una de las formas de conseguir este objetivo es ofrecer la posibilidad de introducir este dato solo en la ventanas de transicin de
flujo de trabajo durante determinadas transiciones. Dependiendo de
la mquina de estados del flujo de trabajo, podra ser incluso imposible volver a la ventana de transicin y, por lo tanto, modificar el
campo en cuestin.
An cuando fuese posible efectuar otras transiciones para volver a
esta ventana, el responsable de proyecto podr aplicar una poltica de
1 Una
incidencia cerrada no puede modificarse
31
2. Conceptos bsicos
seguridad para asegurarse que solo los usuarios autorizados puedan
efectuar esta operacin.
2.5.5
Describe all of
the options?
Flujos de trabajos disponibles
Como explicado en 2.3, los usuarios de un proyecto pueden definir

los flujos de trabajo asociados a cada tipo de incidencia que manejan
en sus proyectos en un esquema de flujo de trabajo.
JIRA ofrece a sus usuarios un motor de flujos de trabajo flexible y
poderoso. La definicin de flujos de trabajo personalizados permite:
(i) Definir el ciclo de vida de las incidencias.
(ii) Definir las operaciones que pueden efectuarse sobre una incidencia.
(iii) Establecer polticas de seguridad que protejan el ciclo de vida
de una incidencia y otorguen la posibilidad de efectuar cada
transicin exclusivamente a los usuarios que tengan los permisos
necesarios.
(iv) Definir reglas de validacin a evaluarse durante cada transicin.
(v) Definir condiciones que deben satisfacerse durante cada transicin.
(vi) Definir estados de incidencia asociados a cada estado del flujo
de trabajo.
(vii) Asociar una ventana a cada transicin.
(viii) Asociar operaciones a efectuarse despus de cada transicin tales como el lanzamiento de una notificacin.
2.5.6
Notificaciones
JIRA, en respuesta a determinados eventos, enva notificaciones a los

usuarios que hayan sido suscritos a cada uno de ellos.
El esquema de notificaciones establece la relacin entre tipos de
eventos y usuarios que recibirn la notificacin. Los eventos disponibles en la actualidad en el esquema de notificacin son los eventos
detallados en Tabla 2.2.
La creacin de relaciones entre evento e identidades es muy flexible
ya que los usuarios de un proyecto pueden asignar eventos no solo
a cuentas de usuarios (o grupos) de JIRA, sino a un conjunto ms
amplio de identidades:
(i) Asignatario de la incidencia.
32
2.5. Esquemas
Nombre
Descripcin
Issue
Issue
Issue
Issue
Issue
Issue
Issue
Creacin de una incidencia.

Actualizacin de una incidencia.
Asignacin de una incidencia a un usuario.
Resolucin de una incidencia.
Cierre de una incidencia.
Creacin de comentario en una incidencia.
Modificacin de un comentario en una incidencia.
Reabertura de una incidencia.
Borrado de una incidencia.
Migracin de una incidencia a otro proyecto.
Trabajo registrado en una incidencia.
Trabajo comenzado en una incidencia.
Trabajo terminado en una incidencia.
Actualizacin de registro de trabajo en una
incidencia.
Borrado de registro de trabajo en una incidencia.
Evento genrico.
created
updated
assigned
resolved
closed
commented
comment edited
Issue reopened
Issue deleted
Issue moved
Work logged on issue
Work started on issue
Work stopped on issue
Issue worklog updated
Issue worklog deleted
Generic event
Tabla 2.2: Eventos en el esquema de notificaciones
(ii)
(iii)
(iv)
(v)
(vi)
(vii)
(viii)
(ix)
(x)
(xi)
Reporter de una incidencia.

Responsable de proyecto.
Responsable de componente.
Usuario.
Grupo.
Rol de proyecto.
Direccin de correo electrnico.
Usuarios que estn observando la incidencia.
Usuario indicado en un campo personalizado de la incidencia.
Grupo indicado en un campo personalizado de la incidencia.
Un usuario que desee ser avisado de inmediato cuando se produce algn evento, podr utilizar el mecanismo de las notificaciones y
subscribirse a las fuentes de eventos que le interesan.
Los eventos genricos proporcionan, adems, la posibilidad de
emitir un evento en respuesta de acciones que no estn previstas en
JIRA. En una transicin de un flujo de trabajo personalizado, por
33
2. Conceptos bsicos
ejemplo, podrn lanzarse un evento genrico para que los usuarios
puedan interceptar dicha accin y recibir la correspondiente notificacin.
Ejemplo 2.18. En un proyecto los operadores pueden resolver pero
no cerrar las incidencias ya que, cada una de ellas, deber ser revisada
y cerrada solo para usuarios en el rol de proyecto revisores.
Los revisores pueden utilizar el mecanismo de las notificaciones para ser avisados cada vez que una incidencia entra en el estado resuelta
para minimizar los tiempos de respuesta del equipo. Estos usuarios
podrn suscribirse al evento Issue resolved pidiendo que se aada su
rol en la lista de identidades que reciben este tipo de notificaciones.
Utilizando el rol de proyecto, adems, se podrn utilizar las categoras de usuarios del proyecto, y no de la plataforma, facilitando as
la administracin de las identidades y los parmetros de configuracin
a ellas relacionado en el mbito de cada proyecto.
Ejemplo 2.19. Una organizacin desea poder moderar los comentarios de las incidencias ya que, en algunos casos, los usuarios que
tienen acceso a la plataforma estn fuera del control de la misma.
Para solventar este problema, los responsables de proyecto pueden
solicitar la creacin de un rol de proyecto para los moderadores y aadir esta identidad a los usuarios que reciben las notificaciones de los
eventos Issue commented e Issue comment edited. Los moderadores
recibirn las notificaciones en tiempo real y podrn as moderar todo
comentario creado o modificado sin necesidad de controlar peridicamente las incidencias modificadas.
Ejemplo 2.20. Un proyecto ha definido flujos de trabajo personalizados para un conjunto de tipos de incidencias que contempla transiciones a un estado llamado auditado. Las transiciones sucesivas, hasta
al cierre de las incidencias, solo pueden ser ejecutadas por usuarios
en el rol responsables, previa revisin de las labores desempeadas.
Es imperativo, para garantizar la continuidad de las labores y la reduccin de los tiempos de accin, que los usuarios de este rol puedan
ser notificados de inmediato cada vez que una incidencia requiera su
atencin.
Los usuarios del rol responsables se aadirn por lo tanto a los
usuarios que reciben notificaciones de eventos genricos (Generic event) y se modificar el flujo de trabajo de manera que se lance dicho
evento durante la transicin al estado auditado.
34
2.5. Esquemas
2.5.7
Polticas de seguridad
El esquema de permisos es la herramienta que permite definir las

polticas de seguridad que aplican en el contexto de un proyecto. JIRA
de fine un conjunto de permisos que permiten construir polticas de
seguridad con grano muy fino y organizar los usuarios que acceden
a un proyecto en todos los roles que se consideren necesarios.
Debido a la complejidad de este tema, se ha dedicado un captulo
entero del Volumen ii de esta gua (??) a la definicin de polticas
de seguridad en JIRA. No obstante, es importante subrayar que los
responsables de un proyecto pueden solicitar la definicin de roles
de proyectos y polticas de seguridad que les permitan proteger, de
acuerdo a sus necesidades, la informacin almacenada en JIRA.
Los usuarios no necesitan conocer detalladamente la organizacin
de los permisos de JIRA. Sin embargo, considero oportuno que los
usuarios conozcan, por lo menos a grandes rasgos, las categoras que
permisos que existen:
(i)
(ii)
(iii)
(iv)
(v)
(vi)
Permisos
Permisos
Permisos
Permisos
Permisos
Permisos
para
para
para
para
para
para
proteger
proteger
proteger
proteger
proteger
proteger
proyecto.
incidencia.
votantes y observadores.
comentarios.
ficheros adjuntos.
el registro de trabajo.
Los permisos, en general, permiten proteger las acciones ms comunes que pueden efectuarse sobre las entidades que protegen, como
por ejemplo la creacin, la actualizacin y la eliminacin. JIRA tambin permite proteger las transiciones de flujo de trabajo asignando
polticas de seguridad a las transiciones del mismo.
Como usuarios, por lo tanto, no debemos extraarnos si en determinadas situaciones vemos que alguna funcionalidad nos ha sido
restringida, tanto a nivel de plataforma como a nivel de proyecto.
Como jefes de proyecto, debemos ser conscientes de la flexibilidad
de JIRA a la hora de parametrizar nuestros proyectos, para definir e
implementar un entorno que satisfaga nuestros requerimientos funcionales, incluidos los requerimientos de seguridad.
Ejemplo 2.21. Los responsables de un proyecto tienen la responsabilidad de asignar las incidencias para distribuir el trabajo entre los
operadores de acuerdo a su criterio y las necesidades de la empresa.
35
2. Conceptos bsicos
Para otorgar el permiso para asignar una incidencia a un subconjunto de usuarios, es suficiente otorgar el permiso Assign issues al rol
responsables y revocarlo a todos los dems roles de proyecto.
Ejemplo 2.22. Los responsables de proyecto y componentes quieren
revisar el trabajo desempeado por los operadores para aprobar el
cierre de las incidencias.
En este caso, ser necesario otorgar el permiso Close issues a los
roles a los que pertenecen los responsables y revocarlo a todos los
dems roles de proyecto. De esta forma, los operadores podrn exclusivamente al estado correspondiente a la resolucin de una incidencia
y los operadores se reservarn el privilegio de cerrarlas, cuando lo
crean conveniente.
Ejemplo 2.23. En el proyecto cuyos requerimientos se han descrito
en el ejemplo 2.20 ser necesario crear los roles de proyectos necesarios a definir las polticas de seguridad que se necesitan implementar
y proteger las transiciones de flujo de trabajo que se originan en el
estado auditado asignando el permiso de efectuar las mismas exclusivamente a los roles correspondientes.
2.5.8
Niveles de seguridad de las incidencias
Las herramientas para definir polticas de seguridad descritas en precedencia (2.5.7), permiten crear polticas de grano muy fino pero
no permiten distinguir entre incidencias.
A veces, sin embargo, puede surgir la necesidad de restringir el
acceso a incidencias concretas y sera incmodo, o inviable, crear proyectos distintos para poder proteger las incidencias distintas con polticas distintas.
Para solventar este problema y dar soporte a este escenario, JIRA
permite definir esquemas de nivel de seguridad. Un esquema de este
tipo define un conjunto de niveles de seguridad y el acceso a cada uno
de los niveles puede otorgarse a un conjunto de identidades, entre las
cuales las siguientes:
(i)
(ii)
(iii)
(iv)
(v)
(vi)
36
Reporter de la incidencia.
Usuario.
Grupo.
Rol de proyecto.
Responsable de proyecto.
Asignatario de la incidencia.
2.5. Esquemas
(vii) Usuario indicado en un campo personalizado de la incidencia.
(viii) Grupo indicado en un campo personalizado de la incidencia.
Los niveles de seguridad, por lo tanto, permiten definir tantas polticas de seguridad como el proyecto requiera para proteger a sus
incidencias.
La incidencia a protegerse podr asociarse a un nivel de seguridad
y la asociacin podr cambiarse siempre que sea necesario. En ese
momento, el acceso estar restringido a las identidades especificadas
por la poltica de seguridad del nivel asignado.
La asociacin de una incidencia con un nivel de seguridad podr
hacerla exclusivamente un usuario con el permiso Set issue security.
Ejemplo 2.24. Un proyecto se utiliza para recibir incidencias de
usuarios con mltiple niveles de servicio. Los responsables del proyecto requieren que se restrinja el acceso a las incidencias que contengan informacin disponible exclusivamente a los usuarios que hayan
contratado el nivel de soporte correspondiente, o superior.
Una de las formas de conseguir este objetivo es el siguiente:
(i) Crear los roles de proyecto necesarios a definir las polticas de
seguridad que se requieren, por ejemplo Usuarios Plata, Usuarios Oro y Usuarios Platino.
(ii) Crear un esquema de nivel de seguridad para incidencias y crear
un nivel de seguridad para cada nivel de soporte.
(iii) Otorgar el acceso a cada nivel de seguridad al rol correspondiente (y a los superiores).
Ejemplo 2.25. Un equipo quiere compartir su proyecto con usuarios

externos para permitirles abrir incidencias en el mismo proyecto en
que trabajan. Sin embargo, tambin se requiere que los usuarios
externos puedan ver exclusivamente las incidencias abiertas por ellos
mismos y ocultar las incidencias internas del equipo de trabajo.
Para conseguir este objetivo se puede:
(i) Crear un rol de proyecto para los usuarios externos.
(ii) Crear un esquema de nivel de seguridad para incidencias con
dos niveles de seguridad: un nivel para los usuarios de la organizacin (Internos) y otro nivel para los usuarios externos
(Externos).
37
2. Conceptos bsicos
(iii) Otorgar acceso a cada nivel de seguridad a los roles correspondientes.
38
3
Primeros pasos
En este captulo se har una introduccin de JIRA y de las operaciones bsicas que un usuario puede efectuar:
(i) Acceso a la plataforma, introduccin de las credenciales de usuario y el recupero de credenciales olvidadas.
(ii) Introduccin al cuadro de mando de JIRA y de su funcionalidad
bsica.
(iii) Atajos de teclado.
Para un usuario, es sorprendente darse cuenta de como la mayora de la funcionalidad de JIRA est condensada en un conjunto de
ventanas tan reducido sin que su compleja funcionalidad afecte negativamente ni a la usabilidad, ni a la homogeneidad, ni a su coherencia
como conjunto.
Es muy importante afianzarse con ellas, ya que en ellas los usuarios pasarn casi la totalidad del tiempo pasado en JIRA. El gradiente
de aprendizaje es muy suave y en poco tiempo, y casi de forma automtica, los usuarios aprendern a interactuar con la funciones ms
avanzadas de la herramienta.
3.1
Login: acceder a JIRA
Los usuarios interactan con JIRA principalmente a travs de su interfaz web. Dependiendo de las polticas de seguridad implementadas
por el administrador, el acceso a algunas secciones de la herramientas
podra ser permitido a usuarios annimos mientras que el acceso a
otras secciones (o incidencias) podra estar restringido a usuarios autenticados que tengan los privilegios necesarios para acceder al recurso
solicitado.
39
3. Primeros pasos
Dependiendo del modo en que JIRA est ejecutndose, adems,
un usuario podra crearse unas credenciales de acceso de forma automtica solicitndolas a travs de un formulario en la aplicacin misma
(modo pblico) o podra necesitar la intervencin de un administrador
para la creacin manual de una cuenta (modo privado).
En Figura 3.1 puede verse la ventana de login de JIRA en modo
pblico en la cual aparece el enlace Sign up que lleva a la ventana
para la creacin de una cuenta de usuario cuya captura de pantalla
puede verse en Figura 3.2. Si el usuario ha olvidad sus credenciales, el
enlace Cant access your acccount? puede ser utilizado para solicitar
la creacin de una nueva contrasea, generada por el sistema, y su
envo a travs de la cuenta de correo electrnico del usuario que ha
solicitado la contrasea.
Figura 3.1: Ventana de login de JIRA
A travs de la ventana de login un usuario puede introducir sus

credenciales y autenticarse en la plataforma. Despus de la autenticacin el usuario acceder directamente al cuadro de mando de JIRA.
3.2
Cuadro de mando
El cuadro de mando de JIRA es una ventana que cada usuario puede

configurar a su gusto. En el cuadro de mando pueden integrarse gadgets OpenSocial: JIRA proporciona un conjunto de gadgets con los
cuales pueden visualizarse contenidos tales como reportes, resultados
de filtros de bsquedas, grficos as como datos provenientes de otras
aplicaciones. Las aplicaciones de la suite de productos Atlassian, tales
como JIRA, Confluence, FishEye o Bamboo, pueden publicar sus gadgets y ser utilizados en los cuadros de mandos de otras aplicaciones.
40
3.3. Barra de las herramientas
Figura 3.2: Ventana de signup de JIRA
De esta forma usuarios que deseen agregar informacin proveniente

de muchas aplicaciones, como los jefes de proyecto, podrn concentrarla en un nico sitio donde facilitar su explotacin. De la misma
forma podrn insertarse en el cuadro de mando gadgets desarrollados
por la organizacin e integrar as JIRA con otras aplicaciones de la
empresa.
3.3
Barra de las herramientas
La barra de las herramientas es una barra visualizada en cada pgina

de JIRA que proporciona la utente enlaces rpidos a las pginas ms
comunes de JIRA. En la parte izquierda de la barra de herramientas,
ilustrada en Figura 3.3, el usuario puede acceder a los menus de JIRA
que, por defecto, son los siguientes:
(i) Dashboards: proporciona acceso al cuadro de mando de sistema,
a los cuadros de mandos ms utilizados y a la ventana de gestin
de los mismos.
(ii) Projects: proporciona acceso rpido al ltimo proyecto utilizado, a los proyectos ms utilizados y a la lista completa de
proyectos visibles al usuario conectado.
41
3. Primeros pasos
(iii) Issues: proporciona acceso rpido a las ventanas de bsqueda
y creacin de incidencias, a las ltimas incidencias visitadas, a
los filtros favoritos y a la ventana de gestin de los mismos.
Figura 3.3: Seccin de menus de la barra de herramientas de JIRA
Los plugins de JIRA pueden enriquecer la barra de herramientas

aadiendo menus (o entradas de menus) personalizados: en la imagen
precedente puede apreciarse por ejemplo el menu Agile, un menu proporcionado por un plugin de JIRA, GreenHopper. Dependiendo de la
configuracin de JIRA, por lo tanto, los mens visualizados podrn
variar: los mens de primer nivel presentes por defecto y detallados
en precedencia, sin embargo, estarn siempre visibles.
En Figura 3.4 puede verse la parte derecha de la barra de herramientas de JIRA. Esta parte hospeda los siguientes controles:
(i)
(ii)
(iii)
(iv)
El
El
El
El
menu del usuario.

enlace al men Administration.
control de texto para la bsqueda simple.
botn Create issues para la creacin de nuevas incidencias.
Figura 3.4: Seccin de herramientas de la barra de herramientas de

JIRA
3.3.1
Men Dashboards
El menu Dashboards (Cuadros de mandos) proporciona al usuario un

acceso directo a los cuadros de mando disponibles y a su herramienta
de gestin. Los cuadros accesibles a un usuario son el cuando de
mando del sistema, los cuadros de mandos personales que el mismo
42
3.3. Barra de las herramientas

usuario se haya creado y los dems cuadros de mandos compartidos
con l por otros usuarios.
El men desplegable del men Dashboards contiene los siguientes
elementos:
(i) Un enlace al cuadro de mando de sistema.
(ii) Una lista de cuadros de mando a los que se haya accedido recientemente.
(iii) Un enlace a la herramienta de gestin de cuadros de mandos.
En ?? se detallar el funcionamiento de las herramientas de gestin de los cuadros de mando.
3.3.2
Men Projects
El men Projects (Proyectos) proporciona la usuario un acceso directo

a la ventana principal del ltimo proyecto al que se haya accedido.
El men desplegable del men proyectos contiene los siguientes
elementos:
(i) El proyecto corriente, es decir, es ltimo proyecto utilizado por
el usuario a travs de cualquier ventana de JIRA.
(ii) Una lista de proyectos a los que se haya accedido recientemente.
(iii) La lista de todos los proyectos visibles al usuario.
3.3.3
Men Issues
El menu Issues (Incidencias) proporciona al usuario un acceso directo al navegador de incidencias, la herramienta que permite crear
bsquedas y filtros utilizando una interfaz web intuitiva y adapta a
cualquier usuario (6 y siguientes).
El men desplegable del men Issues contiene normalmente los
siguientes elementos:
(i) Un enlace al navegador de incidencias.
(ii) Un enlace a la ventana de creacin de incidencia.
(iii) Una lista de enlaces a las ltimas incidencias que se hayan manejado.
(iv) Un enlace a la herramienta de gestin de filtros.
En 6 y siguientes se detallarn las funciones de bsqueda y filtrado ofrecidas por JIRA, tales como la gestin de filtros y el navegador
de incidencias (6.2).
43
3. Primeros pasos
3.3.4
Menu Administration
Si el usuario tiene los privilegios necesarios y puede entrar en el apartado de administracin, Administration, entonces JIRA proporcionar una barra de herramientas dedicada mientras que el usuario
permanezca en dicha modalidad1 .
En Figura 3.5 puede verse el lado izquierdo de la barra de herramientas en modalidad administracin, con mens de primer nivel
para acceder a las apartados de administracin ms utilizados:
(i)
(ii)
(iii)
(iv)
(v)
Administracin
Administracin
Administracin
Administracin
Administracin
de proyectos.
de plugins.
de usuarios.
de incidencias.
del sistema.
En Figura 3.6 puede verse su lado derecho, muy parecido al lado derecho de la barra de herramientas en modalidad usuario, con el
enlace Exit Administration que permite salir del apartado de administracin.
Figura 3.5: Barra de herramientas de JIRA Administracin Parte

izquierda
Figura 3.6: Barra de herramientas de JIRA Administracin Parte

derecha
1 En las versiones de JIRA precedentes a la versin 5, en lugar de proporcionar

una barra de las herramientas distinta, JIRA proporcionaba un men de primer
nivel adicional en la misma, llamado Administration.
44
3.4. Atajos de teclado

3.3.5
Menu del usuario
El menu del usuario, situado en la parte superior derecha de la barra

de herramientas de JIRA, proporciona un acceso rpido a la ventana
de gestin del perfil del usuario. En esta seccin el usuario puede,
a travs de una serie de cuadros de mando, gestionar su perfil y sus
preferencias. El cuadro de mando del perfil del usuario proporciona,
entre otras, la siguiente informacin:
(i)
(ii)
(iii)
(iv)
3.4
Detalles del perfil de usuario.

Flujo de actividad del usuario.
Proyecto con incidencias abiertas del usuario.
Configuraciones personales de JIRA.
Atajos de teclado
Recientemente, JIRA ha incorporado los atajos de teclado en su interfaz web: en lugar de poder utilizar exclusivamente el ratn, el usuario
puede ahora utilizar el teclado para interactuar con JIRA2 . Algunos
atajos estn disponibles a nivel global y pueden por lo tanto utilizarse
en cualquier ventana de JIRA; otros son especficos de algunas ventanas en concreto. Para acceder a una ventana de ayuda que resume
los principales atajos3 , una captura de pantalla de la cual puede verse
en Figura 3.7, es suficiente teclear ? o Shift+/.
3.4.1
Tecla modificadora
En algunos atajos de teclado se utiliza una tecla modificadora que

depende tanto del navegador como del sistema operativo utilizado por
el cliente. La tecla modificadora, desde aqu en adelante, se indicar
con el smbolo . En Tabla 3.1 se resume cual es la tecla modificadora
en los navegadores y los sistemas operativos ms utilizados.
2 Los atajos de teclado deben estar habilitado a nivel de plataforma. Si no lo
estuviesen, es necesario solicitar su activacin al administrador de JIRA. Siempre
que a nivel de sistema est habilitada, un usuario puede personalizar el comportamiento de JIRA para sus sesiones activando o desactivando esta funcionalidad
en su perfil de usuario.
3 Los atajos de teclado, como cualquier otro elemento de la interfaz grfica de
JIRA puede extenderse a travs de plugins. En este caso, la ventana de ayuda en
cuestin tambin incluye atajos de teclados definidos por Greenhopper.
45
3. Primeros pasos
Figura 3.7: Ventana de ayuda de los atajos de teclado
Tecla modificadora
Navegador
Firefox
Internet Explorer
Safari
Chrome
Windows
Alt + Shift
Alt
Ctrl
Alt + Shift
UNIX
Alt + Shift
Mac OS X
Ctrl
Alt + Shift
Ctrl + Alt
Ctrl + Alt
Tabla 3.1: Tecla modificadora por navegador y sistema operativo
46

3.4.2
Atajos globales
Los atajos de teclado globales, disponibles en cualquier ventana de

JIRA, estn resumidos en Tabla 3.2. La nomenclatura de los atajos
es la siguiente:
(i) x, y: se pulsa la tecla x, se suelta y se pulsa la tecla y.
(ii) x + y: se pulsa la tecla x y, mantenindola pulsada, se pulsa la
tecla y.
(iii) x | y: se puede pulsar la tecla x o la tecla y.
Atajos de teclado globales
Atajo
g, d
g, p
g, i
/
c
?
+ d
+ p
+ i
g, g
Descripcin
Abre el cuadro de mando.
Abre el proyecto corriente.
Abe el navegador de incidencias.
Pone el cursor en el campo Quick search (Bsqueda rpida).
Abre la ventana de creacin de una incidencia.
Abre la ventana de ayuda de los atajos de teclado.
Abre el menu desplegable Dashboards.
Abre el menu desplegable Projects.
Abre el menu desplegable Issues.
Abre la ventana de bsqueda Administration Search.
Tabla 3.2: Atajos de teclado globales
3.4.3
Atajos de las ventanas de incidencias
Los atajos descritos a continuacin (Tabla 3.3) pueden utilizarse

tanto en la ventana de detalle de incidencia como en el navegador de
incidencias.
3.4.4
Atajos en los formularios
Los atajos descritos a continuacin (Tabla 3.4) pueden utilizarse en

cualquier formulario de JIRA.
47
3. Primeros pasos
Atajos de teclado Ventanas de incidencias

Atajo
o | Enter
j
k
u
[
n
p
f
Esc
e
a
m
l
s
.
Descripcin
Abre la incidencia seleccionada en el navegador de
incidencias.
Navega a la incidencia siguiente (solo si se ha llegado
a la incidencia desde el navegador de incidencias).
Navega a la incidencia precedente (solo si se ha llegado a la incidencia desde el navegador de incidencias).
Vuelve al navegador de incidencias (solo si se ha llegado a la incidencia desde el navegador de incidencias).
Nasconde o muestra el panel izquierdo en el navegador de incidencias.
Navega al siguiente elemento en la seccin de actividad (en la pantalla de detalle de incidencia).
Navega al precedente elemento en la seccin de actividad (en la pantalla de detalle de incidencia).
Posiciona el cursor en el campo bsqueda avanzada
o bsqueda simple.
Quita el foco de un campo de texto (para poder utilizar los dems atajos de teclado).
Abre la pgina Modifica incidencia.
Abre la ventana Asigna incidencia.
Abre la ventana para aadir comentarios a una incidencia.
Abre la ventana Etiquetas.
Abre la ventana Share para compartir una incidencia.
Abre la ventana Operaciones, desde la cual se puede acceder (buscndola textualmente) y lanzar cualquier operacin aplicable a la incidencia seleccionada.
Tabla 3.3: Atajos de teclado en las ventanas de incidencias
48
Atajos de teclado Formularios

Atajo
+ s
+
Esc
u
+ r
Descripcin
Enva un formulario.
Anula un formulario.
Quita el foco de un campo de texto (para poder utilizar
los dems atajos de teclado).
Vuelve a la ventana de detalle de la incidencia.
Selecciona la checkbox para recordar las credenciales del
usuario (solo en el formulario de login).
Tabla 3.4: Atajos de teclado en los formularios de JIRA
49
4
Explorar un proyecto
JIRA ofrece a sus usuarios dos tipos de ventanas en las cuales se
resume la informacin presente en la plataforma:
(i) Los cuadros de mandos.
(ii) Los navegadores de proyecto.
Los cuadros de mandos, como se ver en 11, son pantallas totalmente configurables por el usuario en las cuales, a travs de gadgets
OpenSocial, ste puede agregar toda la informacin procedente de la
plataforma que necesite. Los cuadros de mandos son herramientas
ideales para obtener una visin global del estado de los proyectos y
las actividades en las cuales est involucrado un usuario.
La pantalla de navegacin de un proyecto, sin embrago, es una
pantalla diseada para que el usuario pueda acceder de forma rpida
e intuitiva a toda la informacin relacionada con un proyecto, navegar en los detalles de cada seccin e, incluso, generar reportes (ms
informacin acerca de este tema se detallar en 10).
En este captulo se detallarn las caractersticas de la ventana navegador de proyecto y las herramientas que JIRA proporciona a los
usuarios para analizar en todo detalla la informacin procedente de
los proyectos. Tngase en cuenta que en este captulo se encontrarn
muchos conceptos que sern objeto de discusin en los captulos siguientes de este libro. He ha intentado poner un nmero suficiente de
referencias cruzadas para ayudar el lector a profundizar los conceptos
que se van introduciendo en este captulo.
4.1
Estructura
Un usuario puede acceder al navegador de proyecto seleccionando un

proyecto en el men desplegable Projects en la barra de herramien51
4. Explorar un proyecto
tas de JIRA. En las versiones ms recientes de JIRA esta ventana
est en realidad compuesta por un conjunto de ventanas que agregan
informacin de distintos mbito (Figura 4.1).
Figura 4.1: Navegador de proyecto.
Las ventanas que componen el navegador estn organizadas con

una interfaz grfica de pestaas (Figura 4.2): a travs de ellas,
el usuario puede acceder a la informacin que necesita. Las pestaas
presentes en el navegador de proyecto, y por lo tanto las ventanas
correspondientes, pueden variar ya que dependen de un conjunto de
52
4.1. Estructura
Figura 4.2: Navegador de proyecto.
factores, como por ejemplo la integracin de JIRA con otros productos, que se detallarn a continuacin. A ttulo de ejemplo, en Figura
4.2 puede verse el conjunto de pestaas presentes en el navegador de
proyecto de una instalacin tpica de JIRA.
Desde esta ventana, el usuario tiene acceso a toda la informacin
relativa al proyecto y sus atributos:
(i) Informacin relativa al proyecto (Tabla 4.1).
(ii) Informacin relativa a las versiones de un proyecto (Tabla 4.2).
(iii) Informacin relativa a los componentes de un proyecto (Tabla
4.3).
4.1.1
Acceso rpido a la creacin de incidencias
El navegador de proyecto, con independencia de la ventana seleccionada por el usuario, proporciona una barra rpida de creacin de
53
Nombre
Descripcin
Summary
Actividad reciente del proyecto y lista de incidencias

que estn por caducar.
Resumen de las incidencias agrupadas por estado.
Resumen de las incidencias no resueltas agrupadas
por asignatario, prioridad, versin y componente.
Incidencias no resueltas para las siguientes versiones
de un proyecto.
Incidencias resueltas en precedentes versiones de un
proyecto.
Incidencias no resueltas ordenadas por popularidad.
Resumen de las versiones recientes.
Resumen de los componentes.
Resumen de las etiquetas utilizadas en las incidencias.
Builds de Atlassian Bamboo (disponible exclusivamente si se configur la integracin entre JIRA y
Bamboo).
Resumen de los cambios recientes registrados en FishEye (disponible exclusivamente si se configur la
integracin entre JIRA y FishEye).
Resumen de las revisiones recientes registrados en
Crucible (disponible exclusivamente si se configur
la integracin entre JIRA y Crucible).
Issues
Road Map
Change Log
Popular Issues
Versions
Components
Labels
Builds
Source
Reviews
Tabla 4.1: Navegador de proyecto Informacin relativa al proyecto.
Nombre
Descripcin
Version Summary
Actividad reciente en una versin del proyecto y lista de actividades que estn cerca de
su caducidad.
Incidencias asignadas a una versin del proyecto.
Incidencias populares asignadas a una versin del proyecto.
Builds de Atalssian Bamboo de una versin
del proyecto (disponible exclusivamente si se
configur la integracin entre JIRA y Bamboo).
Version Issues
Version Popular Issues
Version Builds
Tabla 4.2: Navegador de proyecto Informacin relativa a las versiones

del proyecto.
54
4.1. Estructura
Nombre
Descripcin
Component Summary
Component Issues
Actividad reciente sobre un componente del proyecto.

Incidencias pertenecientes a un componente del
proyecto.
Incidencias a resolver de un componente del proyecto, agrupadas en versiones del proyecto.
Incidencias resueltas de un componente del proyecto, agrupadas en versiones del proyecto.
Incidencias populares a resolver de un componente del proyecto, ordenadas por popularidad (nmero de votos).
Component Road
Map
Component Change Log
Component Popular Issues
Tabla 4.3: Navegador de proyecto Informacin relativa a los

componentes del proyecto.
incidencias en su rincn superior derecho (Figura 4.3). A travs de
Figura 4.3: Navegador de proyecto Barra de creacin de incidencias.
los controles de la barra el usuario podr crear incidencias de todos los

tipos soportados en el proyecto seleccionado. Para los tipos de incidencias recin utilizados se proporcionar un botn a parte1 , mientras
que los dems tipos de incidencias podrn crearse accediendo al men
desplegable Other.
4.1.2
Acceso a informacin adicional
Por razones de espacio y de optimizacin de la interfaz grfica de

JIRA, algunos paneles que componen las ventanas del navegador de
1 Como
es el caso de los controles Bug y Documentation en Figura 4.3.
55
proyectos visualizan, por defecto, exclusivamente la informacin ms
reciente.
Algunos de estos paneles, sin embargo, permiten acceder a la ventana de detalle en la cual puede encontrarse la informacin completa.
Los paneles que exhiben este comportamiento son los paneles que
proporcionan un botn identificado con el icono de un ojo ( ):
pulsando dicho botn el usuario acceder a la ventana de detalle.
4.2
Summary
En la ventana Summary el usuario podr acceder a informacin genrica e informacin sobre la actividad reciente del proyecto, incluyendo
versiones e incidencias que caducan en pocos das. Un ejemplo de ventana de resumen puede verse en Figura 4.4.
La ventana Summary est compuesta por distintos paneles que
agregan informacin de distinta naturaleza; en Tabla 4.4 se detalla
que tipo de informacin est disponible en cada panel de la ventana.
Nombre
Descripcin
Description
Issues: Due
Issues: 30 days summary
Informacin bsica sobre el proyecto.

Incidencias que han caducado.
Reporte grfico de incidencias abiertas y
resueltas en los ltimos 30 das.
Incidencias actualizadas recientemente.
Versiones que han caducado.
Flujo de actividad.
Issues: Updated recently

Versions: Due
Activity Stream
Tabla 4.4: Navegador de proyecto Paneles de la ventana Summary.
En el extremo superior derecho de la ventana Summary, JIRA

proporciona una barra de herramientas, visible en Figura 4.5, que
permite al usuario acceder de forma rpida a las siguientes funciones:
(i) Creacin de reportes (vase 10).
(ii) Acceso a filtros (vase 8).
Mayores detalles sobre las caractersticas de estas funciones sern detalladas en los captulos correspondientes.
56
4.2. Summary
Figura 4.4: Navegador de proyecto Ventana Summary.
Figura 4.5: Navegador de proyecto Barra de herramientas de la

ventana Summary.
57
4.2.1
Activity Stream
El panel Activity Stream presenta el flujo de actividad reciente en el

proyecto corriente. Generalmente, el flujo de actividad ser relativo
a operaciones sobre incidencias de la instancia de JIRA local. Sin
embargo, si el administrador ha configurado la integracin de JIRA
con otras aplicaciones2 , el flujo de actividad incluir tambin la informacin procedentes de stas aplicaciones. El flujo de actividad,
por lo tanto, es una herramienta cmoda a la hora de aglutinar en
un nico lugar la informacin relativa a un proyecto y procedente de
distintas fuentes.
En el panel Activity Stream el usuario tiene la posibilidad de suscribirse a un feed RSS para recibir la informacin actualizada utilizando un lector de feeds RSS. Para suscribirse al feed, es suficiente
recuperar su URL utilizando el icono del feed ( ) e insertarlo en un
lector RSS. Utilizando este icono directamente desde el navegador
web permite ver el contenido actual del feed en la ventana del mismo
navegador.
4.3
Issues
La ventana Issues del navegador de proyectos (Figura 4.6) proporciona un reporte sobre el estado de las incidencias del proyecto seleccionado. La ventana est dividida en paneles, detallados en Tabla
4.5, en los cuales se detalla el estado de las incidencias agrupadas por
estado y el estado de las incidencias no solucionadas agrupadas por
varios campos.
Los enlaces proporcionados en esta ventana permiten al usuario
acceder al navegador de incidencias (6 y sucesivos) configurado con
el filtro correspondiente. Si, por ejemplo, se selecciona el enlace correspondiente al nombre de un usuario en el panel Unresolved: By
Assignee, JIRA llevar el usuario a la ventana del navegador de incidencias configurado para devolver las incidencias no resueltas y asignadas al usuario seleccionado.
4.4
Road Map
La ventana Road map del navegador de proyectos (Figura 4.7) proporciona informacin sobre las versiones del proyecto todava no en2 JIRA
puede integrarse con otras aplicaciones de Atlassian (tales como Confluence, FishEye, Crucible y Bamboo) u aplicaciones de terceras partes.
58
4.4. Road Map

Nombre
Descripcin
Status summary
Reporte de incidencias agrupadas por

estado.
Incidencias no resueltas, agrupadas
por prioridad.
por usuario asignado.
por versin.
por componente.
Unresolved: By priority
Unresolved: By assignee
Unresolved: By version
Unresolved: By component
Tabla 4.5: Navegador de proyecto Paneles de la ventana Issues.
Figura 4.6: Navegador de proyecto Ventana Issues.
tregadas. Esta ventana est disponible solo si en el proyecto seleccionado se estn utilizando versiones.
En el reporte de esta ventana se resume la siguiente informacin:
(i) La lista de versiones todava por entregar.
(ii) La lista y el nmero de incidencias asignadas a cada versin.
(iii) El porcentaje de trabajo finalizado y por finalizar por cada versin.
El reporte de la ventana Road map agrega todas las incidencias
asignadas a las versiones del proyecto: sin embargo, un usuario puede acceder al road map personal, es decir, el road map generado
59
Figura 4.7: Navegador de proyecto Ventana Road map.
considerando exclusivamente las incidencias asignadas al usuario actualmente conectado, utilizando el control View personal road map
en el extremo superior derecho de la ventana.
4.5
Change Log
La ventana Change log del navegador de proyectos (Figura 4.8) proporciona informacin sobre las versiones del proyecto que se han entregado. Esta ventana est disponible solo si en el proyecto seleccionado
se estn utilizando versiones.
En el reporte de esta ventana se resume la siguiente informacin:
(i) La lista de versiones entregadas.

(ii) La lista y el nmero de incidencias asignadas a cada versin.
60
4.6. Popular Issues
Figura 4.8: Navegador de proyecto Ventana Changelog.
4.6
Popular Issues
La ventana Popular issues del navegador de proyectos (Figura 4.9)

proporciona informacin sobre las incidencias ms votadas (vase
5.20) por los usuarios.
El reporte de esta ventana tiene las siguientes caractersticas:
(i) Contiene la lista de incidencias no resueltas del proyecto que
tengan al menos un voto.
(ii) La lista de incidencias est ordenada por el nmero de votos en
orden decrescente.
4.7
Versions
La ventana Versions del navegador de proyectos (Figura 4.10) proporciona informacin sobre las versiones del proyecto seleccionado.
Esta ventana est disponible solo si en el proyecto seleccionado se
estn utilizando versiones.
61
Figura 4.9: Navegador de proyecto Ventana Popular issues.
Figura 4.10: Navegador de proyecto Ventana Versions.
62
4.7. Versions
Esta ventana presenta la lista de todas las versiones del proyecto
seleccionado, tanto entregadas como por entregar. Si el usuario tiene
el permiso requerido, el control Manage versions en el extremo superior derecho de esta ventana permite acceder a la ventana de gestin
de versiones.
Seleccionando una versin de la lista, utilizando el enlace en el
nmero de versin, la ventana Versions otorga acceso a otras ventanas
que proporcionan detalles sobre la versin seleccionada. Las ventanas
que presentan la informacin de una versin se detallan en Tabla 4.6.
Nombre
Descripcin
Summary
Actividad reciente de la versin seleccionada y

lista de incidencias que estn por caducar.
Resumen de las incidencias de la versin seleccionada agrupadas por estado. Resumen de las
incidencias de la versin seleccionada no resueltas agrupadas por asignatario, prioridad, versin
y componente.
Incidencias no resueltas de la versin seleccionada ordenadas por popularidad.
Issues
Popular Issues
Tabla 4.6: Navegador de proyecto Ventanas de versiones.
Las ventanas de detalle de versin son parecidas a las homnimas ventanas del navegador de proyecto y, por lo tanto, vanse las
secciones correspondientes de este libro para obtener mayores detalles
sobre la funcionalidad de las mismas. Una imagen de ejemplo de dicha
ventana puede verse en Figura 4.11, en la cual puede apreciarse como tanto la estructura global como la estructura de los paneles que la
componen sea parecida a la estructura de los homlogos componentes
de la ventana del navegador de proyecto.
4.7.1
Builds de la versin
Si se est utilizando Atlassian Bamboo para automatizar la construccin de un proyecto y el administrador de JIRA ha configurado la
integracin entre JIRA y Bamboo, el usuario puede obtener informacin relativa a los builds y los planes de builds de Bamboo relativos
a una versin de un proyecto directamente en la sub-ventana Builds
63
Figura 4.11: Navegador de proyecto Detalle de versin.
de la ventana de detalle de una versin. La informacin disponible es

la siguiente:
(i) La lista de builds relativos a la versin seleccionada.
(ii) El ltimo estado de los build plans (planes de construccin)
relacionados a dichos builds.
Para ver los builds de una versin (Figura 4.12), es necesario
efectuar las siguientes operaciones:
(i) Acceder a la ventana de detalle de la versin del proyecto deseada, como explicado anteriormente.
(ii) Seleccionar la pestaa Builds en la ventana de detalle de una
versin del proyecto.
(iii) Asegurarse que la opcin Related builds by date est seleccionada
en el campo View.
Para ver el ltimo estado de los planes de construccin (Figura
4.13), es necesario efectuar las siguientes operaciones:
64
4.8. Components
Figura 4.12: Navegador de proyecto Detalle de versin Builds
(i) Acceder a la ventana de detalle de la versin del proyecto deseada, como explicado anteriormente.
(ii) Seleccionar la pestaa Builds en la ventana de detalle de una
versin del proyecto.
(iii) Asegurarse que la opcin Latest plan status est seleccionada en
el campo View.
4.8
Components
La ventana Components del navegador de proyectos (Figura 4.14)

proporciona informacin sobre los componentes del proyecto seleccionado. Esta ventana est disponible solo si en el proyecto seleccionado
se estn utilizando componentes.
Esta ventana presenta la lista de todos los componentes del proyecto seleccionado. Si el usuario tiene el permiso requerido, el control
Add a new component en el extremo superior derecho de esta ventana
permite acceder a la ventana de creacin de componente.
65
Figura 4.13: Navegador de proyecto Detalle de versin Build Plans
Figura 4.14: Navegador de proyecto Ventana Components.
66
4.9. Labels
Como en el caso de la ventana de versiones, seleccionando un componente de la lista, utilizando el enlace en el nombre de componente,
la ventana Components otorga acceso a otras ventanas que proporcionan detalles sobre el componente seleccionado. Las ventanas que
presentan la informacin de un componente se detallan en en Tabla
4.7.
Nombre
Descripcin
Summary
Actividad reciente del componente seleccionado

y lista de incidencias que estn por caducar.
Resumen de las incidencias del componente seleccionado agrupadas por estado. Resumen de
las incidencias del componente seleccionado no
resueltas agrupadas por asignatario, prioridad,
versin y componente.
Incidencias no resueltas del componente seleccionado para las siguientes versiones de un proyecto.
Incidencias resueltas del componente seleccionado en precedentes versiones de un proyecto.
Incidencias no resueltas del componente seleccionado ordenadas por popularidad.
Issues
Road Map
Change Log
Popular Issues
Tabla 4.7: Navegador de proyecto Ventanas de componentes.
Las ventanas de detalle de componente son parecidas en presentacin y funcionalidad a las homnimas ventanas del navegador de
proyecto con la diferencia que las primeras presentan datos filtrados
por el componente seleccionado. Por esta razn, vanse las secciones
correspondientes de este libro para obtener mayores detalles sobre la
funcionalidad de las mismas.
4.9
Labels
La ventana Labels del navegador de proyectos (Figura 4.15) proporciona informacin sobre los componentes del proyecto seleccionado.
Esta ventana presenta la lista de etiquetas (labels, vase 5.14) utilizadas en las incidencias del proyecto seleccionado, ordenadas segn
el criterio especificado por el usuario en las opciones de configuracin
de la ventana. El usuario puede especificar las siguientes opciones
utilizando los controles presentes en la parte superior de la ventana:
67
Figura 4.15: Navegador de proyecto Ventana Labels.
(i) View: Con esta opcin se puede seleccionar cuales etiquetas

se desean ver. Seleccionando Popular labels se visualizarn las
etiquetas populares y seleccionando All labels se visualizarn
todas las etiquetas.
(ii) Field: Con esta opcin se puede seleccionar cuales campos utilizar para determinar las etiquetas de las incidencias. Seleccionando Labels se utilizarn los campos de tipo etiquetas y
seleccionando Epic/Theme se utilizarn dichos campos para determinarlas.
(iii) Order: Con esta opcin se puede seleccionar el orden en el que
se presentarn las etiquetas. Seleccionando Alphabetically se
presentarn las etiquetas en orden alfabtico y seleccionando
popularity se presentarn en orden de popularidad.
Las etiquetas visualizadas en esta ventanas son enlaces que el
usuario puede utilizar para visualizar las incidencias que contienen
la etiqueta seleccionada: el usuario ser llevado al navegador de incidencias (vase 6.2) donde se ejecutar un filtro auto-generado que
devolver como resultado las incidencias correspondientes.
4.10
Builds de Bamboo
Si la instancia de JIRA ha sido integrada con una instancia de Bamboo, estar disponible la pestaa Builds en la cual se podr obtener
68
4.11. Fisheye changesets: cambios en las fuentes

la informacin relativa a los builds de Bamboo y a sus builds plan
relacionados con el proyecto seleccionado.
La presentacin y la funcionalidad de esta ventana es parecida
a la anloga ventana Builds de las versiones, descrita en 4.7.1 e
ilustrada en Figura 4.12 y 4.13. Por esta razn, vanse las secciones
correspondientes de este libro para obtener mayores detalles sobre la
funcionalidad de las mismas.
4.11
Fisheye changesets: cambios en las fuentes
Si la instancia de JIRA ha sido integrada con una instancia de Fisheye,

estar disponible la pestaa Source, la cual ofrece un resumen de la
actividad de Fisheye reciente relacionada con el proyecto seleccionado.
La ventana ofrece la siguiente informacin, dependiendo del tipo
de reporte seleccionando en la lista de reportes en la parte superior
de la ventana:
(i) Reporte de los ltimos commits relacionados con el proyecto seleccionado, seleccionando el reporte Changeset (Figura 4.16).
(ii) Reporte de las estadsticas de actividad en Fisheye, seleccionando el reporte Statistics (Figura 4.17).
(iii) La agregacin de los dos reporte precedentes, seleccionando el
reporte All.
Figura 4.16: Navegador de proyecto Ventana Source.
La ventana con el reporte de las estadsticas (Figura 4.17), por

defecto, proporciona estadsticas por lneas de cdigo. Sin embargo,
en cada panel de la ventana es posible especificar el indicador que se
desea entre las siguientes posibilidades:
69
Figura 4.17: Navegador de proyecto Ventana Source.
(i) LOC, o Lneas de cdigo.

(ii) Files.
(iii) Commits.
70
5
Manejo de incidencias
Las operaciones que los usuarios suelen efectuar ms frecuentemente
en JIRA estn relacionadas con el manejo de las incidencias. En un
caso de uso tpico de la plataforma, los usuarios se dividen principalmente en dos grupos: los usuarios que solicitan trabajo abriendo
incidencias en el sistema y los usuarios que trabajan sobre ellas.
Los usuarios del primer grupo, usuarios en la jerga de JIRA, utilizan la plataforma para abrir incidencias y observar el trabajo que
se vaya desempeando sobre ellas. A estos usuarios, JIRA ofrece una
serie de herramientas que les permiten tener la visibilidad que necesitan sobre las incidencias que desean observar a lo largo de todo
su ciclo de vida, desde el momento de su creacin hasta el momento en que terminan su recorrido por la mquina de estados del flujo
de trabajo al que estn sometidas. Estas herramientas permiten, entre otras cosas, a) crear una incidencia rellenando un formulario que
recoge los campos asociados al tipo de incidencia escogido; b) organizar las incidencias utilizando enlaces y etiquetas; c) buscar entre las
incidencias componiendo criterios de bsquedas flexibles y creando filtros reutilizables; d) observar las incidencias abiertas suscribindose
a notificaciones o utilizando las herramientas de reporting de JIRA;
e) interactuar con los operadores y con otros usuarios a travs de
comentarios; f ) solicitar la resolucin de una incidencia a travs del
mecanismo de los votos.
Los usuarios del segundo grupo, desarrolladores en la jerga de JIRA y operadores en la nomenclatura de esta gua, utilizarn la plataforma para trabajar sobre las incidencias que los usuarios han abierto.
A esta categora de usuarios JIRA ofrece una serie de herramientas
especficas que permiten, entre otras cosas, a) trabajar sobre una incidencia movindola a travs de la red de estados definida en su flujo
de trabajo; b) organizar las incidencias a travs de los mecanismos de
71
5. Manejo de incidencias
los enlaces y de las etiquetas; c) proteger las incidencias estableciendo
polticas de seguridad; d) mantener constancia del trabajo realizado
a travs del log de trabajo.
JIRA no obliga el administrador de un proyecto a marcar confines muy rgidos entre una categora de usuarios y la otra. Al revs,
simplemente otorgndole los privilegios requeridos, cualquier usuario
puede utilizar cualquier herramientas que JIRA ofrezca. Esta flexibilidad a nivel de las polticas de seguridad se traduce por lo tanto en
flexibilidad a la hora de perfilar las responsabilidades de cada categora de usuarios que se desea introducir en un determinado proyecto.
Un jefe de proyecto, por ejemplo, puede ejercer al mismo tiempo
las funciones de usuario y operador. Por un lado observar y organizar el progresar de las labores a travs de bsquedas, filtros, flujos
de actividades y las herramientas de reporting de JIRA; por el otro
lado, participar activamente en las labores del equipo creando nuevas incidencias, asignando las incidencias existentes a los miembros
del equipo para repartir eficazmente el trabajo e, incluso, trabajando
sobre alguna de ellas, tal vez de un tipo pensado explcitamente por
su rol.
La experiencia con otras herramientas que brillan por flexibilidad
podra hacer sospechar a muchos usuarios que la riqueza de funcionalidad de una plataforma como JIRA tenga repercusiones negativas en
otros aspectos no menos importantes para la eficacia y la eficiencia
del trabajo tales como la facilidad de utilizacin o el tiempo de aprendizaje requerido para convertirse en un usuario competente. Sorprendentemente, en el caso de JIRA esto no sucede y este logro, sin duda,
ha sido uno de sus ms importantes selling points.
Detrs de este logro ha habido una decisin de diseo fundamental. En lugar de trasladar al usuario, a travs del interfaz de JIRA1 ,
las complejidades y la heterogeneidad de posibles escenarios distintos
procedentes de su elevada flexibilidad, se tom la decisin de a) homogeneizar el interfaz; b) reducir al mnimo el nmero de ventanas de
la plataforma; c) trasladar la flexibilidad de la plataforma al interfaz
utilizando ventanas que se rellenan dinmicamente.
El trabajo sobre una incidencia, por ejemplo, se efecta en una nica ventana, con independencia de cualquier privilegio y rol otorgado al
usuario conectado. La ventana en cuestin, descrita detalladamente
en las secciones siguientes de ste captulo, es modular y logra la ho1 As
como a cualquier otro nivel en que tiene lugar una interaccin entre JIRA
y un sistema externo, incluso un ser humano.
72
5.1. Creacin de una incidencia

mogeneizacin de los perfiles de usuarios poblando automticamente
sus paneles con los controles habilitados de acuerdo a los privilegios
otorgados al usuario conectado.
La segmentacin de los usuarios en roles de proyecto, cuya responsabilidad es de los administradores en el mbito de cada proyecto, no se repercute en la forma en que los usuarios interactan con
la herramienta: stos no debern preocuparse de aprender a utilizar
herramientas distintas o especficas para desempear las labores que
se les encomienden en el contexto de cada proyecto.
En un caso de uso tpico, por ejemplo, los usuarios tendrn los privilegios necesarios a crear incidencias en un proyecto pero no podrn
trabajar sobre ellas y cambiarlas de estado. Los operadores podrn
trabajar sobre las incidencias a ellos asignadas y moverlas a travs
de un conjunto de estados en su flujo de trabajo. Los supervisores
podrn asignar (o re-asignar) las tareas a los operadores, revisarlas
y cerrarlas e, incluso, borrarlas del sistema. Todas estas operaciones
se efectuarn en la misma ventana, utilizando adems controles funcionalmente muy similares. En el caso en que un usuario adquiera
privilegios distintos en el contexto de otro proyecto, ste no requerir
aprender a utilizar herramientas distintas ya que, funcionalmente, no
apreciar diferencias sustanciales en el interfaz de la herramienta.
5.1
Creacin de una incidencia
El primer paso durante la utilizacin de JIRA es el proceso de creacin

de una incidencia. Los usuarios con este privilegio (Create Issues) en
un proyecto podrn acceder a la ventana de creacin de incidencias y
rellenar los detalles requeridos por el tipo de incidencia que se desea
crear.
JIRA proporciona dos accesos a la ventana de creacin de incidencias:
(i) El primer acceso, ilustrado en Figura 5.1, es el botn de creacin
de incidencias que est siempre presente en el extremo derecho
de la barra de herramientas de JIRA, como explicado en 3.3.
(ii) El segundo acceso, presente en la parte superior de la ventana
del navegador de proyecto, es la barra de creacin de incidencias,
descrita en 4.1.1 e ilustrada en Figura 5.2.
JIRA 5 unific el comportamiento de ambos controles y, ahora,
todos llevan a una nica ventana de creacin de incidencia, visible
73
Figura 5.1: Botn de creacin de incidencia
Figura 5.2: Navegador de proyecto Barra de creacin de incidencias.
en Figura 5.3. La nica diferencia funcional que queda entre los

dos controles de creacin de incidencia es que la barra de creacin
de incidencias en el navegador de proyecto proporciona una serie de
botones de acceso rpido para seleccionar los tipos de incidencia que
hayan sido utilizados ms recientemente: en el caso ilustrado en figura, por ejemplo, pueden verse los botones Bug y Documentation para
crear una incidencia del tipo correspondiente. A la derecha de estos
botones JIRA proporciona el botn Other que despliega un men con
los dems tipos de incidencias aceptables en el proyecto corriente.
La ventana de creacin de incidencia es una form que recoge todos
los campos de una incidencia que el usuario puede rellenar durante
su creacin. El nmero y el tipo de campos presentes en esta ventana
son configurados por el administrador en el contexto de cada proyecto
por cada tipo de incidencia admisible. Los primeros pasos a cumplir
durante la creacin de una incidencia ser, por lo tanto, los siguientes:
(i) La eleccin del proyecto en el cual la incidencia debe crearse,
seleccionando el proyecto deseado en el men desplegable del
campo Project.
(ii) La eleccin del tipo de incidencia a crear, seleccionando el tipo
deseado en el men desplegable del campo Issue Type.
Una vez escogido estos datos, la ventana de creacin de incidencia se
74
Figura 5.3: Ventana de creacin de incidencia
75
actualizar automticamente para reflejar la configuracin de campos
del tipo de incidencia escogido en el contexto del proyecto seleccionado. Por esta razn, los usuarios podran ver ventanas con un distinto
conjunto de campos para el mismo tipo de incidencia en proyectos
distintos.
En las versiones de JIRA anteriores a la versin 5, la ventana
de creacin de incidencia proporcionaba todos los campos previstos
por la configuracin de campos del tipo de incidencia seleccionada.
Esta ventana poda contener muchos campos opcionales, algunos de
los cuales raras veces utilizados por los usuarios, y su composicin
no poda modificarse. Desde la introduccin de JIRA 5 los usuarios
pueden personalizar la configuracin de campos de esta ventana aadiendo los campos que utilizan ms a menudo y ocultando los campos
que raramente utilizan. La nica limitacin, obviamente, es ningn
campo obligatorios para un tipo de incidencia no puede ocultarse.
La configuracin de la ventana se efecta utilizando el formulario de
configuracin al que se accede utilizando el botn Configure Fields en
la esquina superior izquierda de la misma e ilustrado en Figura 5.4.
El campo Show Fields puede asumir los siguientes valores:
Figura 5.4: Ventana de creacin de incidencia Configuracin de

campos
(i) All, si la ventana visualizar todos los campos.

(ii) Custom, si la ventana visualizar solo los campos escogidos por
el usuario.
76

En el segundo caso, el usuario podr decidir cuales campos visualizar
y cuales campos ocultar utilizando los controles de tipo check-box que
aparecen a la izquierda del nombre de cada campo previsto por el tipo
de incidencia actualmente seleccionado: deseleccionando el check-box
de un campo, se ocultar el campo en la ventana.
Cuando el usuario termine de rellenar el formulario de creacin y
pulse el botn Create JIRA crear la incidencia y llevar el usuario a
la ventana de detalle de incidencia (2.2, Figura 2.4 e 5.2).
Si, por el otro lado, el usuario necesita crear ms de una incidencia, desde JIRA 5 puede optar para crearlas de forma seguida sin salir
de la ventana de creacin de incidencia. Esta versin de JIRA incluye
un control adicional de tipo check-box, llamado Create another, que,
si seleccionado, instruye JIRA a no cerrar la ventana despus de la
confirmacin de creacin de incidencia (como explicado en el prrafo anterior) sino vaciarla para que el usuario pueda seguir creando
incidencias de forma ms rpida.
5.1.1
Citacin de otros usuarios y envo de mail
JIRA 5 permite la citacin de otros usuarios de la plataforma en los

campos Description y Comment. La citacin de usuario est ligada a
otra funcionalidad nueva, la posibilidad de compartir incidencias con
nuevos usuarios, que se detallar en 5.4.
Es posible citar un usuario en un campo de texto que lo permita
pueden introduciendo su nombre en una de las siguientes formas:
(i) @nombre.
(ii) [~nombre].
Cuando el usuario comienza a teclear estos caracteres, JIRA sugerir
la lista de usuarios que satisfagan los criterios introducidos, como
ilustrado en Figura 5.5. Seleccionando un usuario de la lista de
sugerencias completar automticamente el texto que el usuario est
introduciendo. Si un usuario est siendo citado durante la creacin
de una incidencia2 , JIRA le enviar un correo electrnico.
Vase 5.4 para obtener ms informaciones sobre esta funcionalidad.
2 As
como ocurre durante las dems operaciones sobre una incidencia.
77
Figura 5.5: Citacin de otro usuario
5.2
Ventana de detalle de incidencia
La ventana de detalle de la incidencia es una de las ventanas ms

utilizadas por los usuarios. Los usuarios utilizan esta ventana para
observar el trabajo que se va desempeando sobre ella y los operadores
utilizan esta ventana para toda labor que efecten sobre la incidencia. La ventana est compuesta por paneles, cada uno del los cuales
agrupa informacin de distinta naturaleza. En Figura 5.6 volvemos a
reproducir Figura 2.4.
En la parte superior de la ventana, en la seccin Detalles, los usuarios pueden ver tanto la informacin bsica sobre una incidencia, tipo,
prioridad, estado y resolucin, como todos los campos disponibles al
tipo de incidencia y contexto seleccionado.
El la columna derecha, en las secciones People y Dates, se ensean
la informacin relativa a los usuarios que estn relacionados con la
incidencia: repoter, asignatario, votos y watches. En el panel Time
Tracking, por otro lado, puede verse un resumen grfico del trabajo a
desempear y desempeado, de acuerdo a la estimacin introducida
por los usuarios y el trabajo registrado por los operadores.
En la parte central de la ventana pueden verse paneles que contiene
informacin adicional de la incidencia, tales como su descripcin y los
enlaces entre incidencias.
La parte inferior de la ventana est organizada en pestaas a travs
de las cuales se puede acceder a la dems informacin relacionada con
la incidencia: comentarios, work log, actividad, etc.
Algunos plugins de JIRA enriquecen las ventanas de la plataforma
y, dependiendo de cada instalacin, es posible que el contenido vare.
En la ilustracin, por ejemplo, puede verse la pestaa Source que
proporciona informacin que proviene de Atlassian FishEye.
78
5.3. Operaciones disponibles
Figura 5.6: Ventana de detalle de incidencia
5.3
Operaciones disponibles
En la ventana de detalle de incidencia (Figura 5.6), debajo del ttulo,

hay una barra de botones. Como explicado en precedencia (2.2),
las operaciones que un usuario puede efectuar sobre una incidencia,
de acuerdo a los permisos que tiene en el proyecto, son accesibles a
travs de dichos botones.
Las operaciones se dividen en dos categoras:
(i) Operaciones comunes a toda incidencia.
(ii) Operaciones del flujo de trabajo de un tipo de incidencia.
Las operaciones comunes son las operaciones que un usuario de JIRA
puede efectuar sobre cualquier incidencia y son, bsicamente, operaciones de actualizacin de los campos de la incidencia (Edit, Comment, Attach files, etc.) y operaciones de organizacin de las incidencias (Clone, Move, Delete, etc.). En Figura 5.7 pueden verse los
botones correspondientes a las operaciones comunes ms utilizadas y
el botn More Actions que despliega un men con todas las dems
operaciones disponibles para una incidencia.
79
Figura 5.7: Men de acciones
La segunda categora de operaciones desciende del flujo de trabajo

de cada tipo de incidencia y de las operaciones de workflow (transiciones) que se puedan invocar en el estado corriente de una incidencia.
En el flujo de trabajo estndar de JIRA, para una incidencia en estado Open, solo pueden ejecutarse las transiciones Start progress para
empezar a trabajar sobre la incidencia, Resolve para resolver de inmediato una incidencia sin abrirla (probablemente para no aceptarla)
y Close. En Figura 5.7 pueden verse los botones que corresponden
a algunas de estas transiciones estndar.
Sin embargo, los administradores de proyecto pueden crear flujos
de trabajos personalizados y asignarlos a determinados tipos de incidencias. En Figura 5.6, por ejemplo, pueden verse los botones Back
to Todo y Back to In Progress asociados a las correspondientes transiciones en un flujo de trabajo personalizado asociado a las incidencias
del tipo Bug de ese proyecto.
80
5.4. Compartir una incidencia por correo electrnico

5.4
Compartir una incidencia por correo electrnico
Un usuario tiene dos opciones para enviar a otro usuario de la plataforma el enlace a una incidencia por mail3 :
(i) Citando el destinatario en un campo que soporte las citaciones,
como los campos descripcin y resumen.
(ii) Compartiendo la incidencia.
5.4.1
Citar un usuario
El mecanismo de las citaciones, que se detall en 5.1.1, permite

enviar un correo electrnico al buzn de un usuario cada vez que
ste sea citado en un campo de tipo texto que soporte las citaciones
(como descripcin y resumen) durante una operacin la creacin o la
modificacin de una incidencia o de un comentario a una incidencia.
Para citar un usuario, es necesario efectuar las operaciones detalladas en 5.1.1 durante una cualquiera de las operaciones mencionadas
con anterioridad.
5.4.2
Compartir una incidencia
Una incidencia puede ser compartida con otros usuarios de la plataforma: al acto de compartir, se puede introducir una nota que,
conjuntamente a la direccin de la incidencia compartida, se remitir
por correo electrnico a los destinatarios.
Para compartir una incidencia con otros usuarios, es necesario
(i) Seleccionar la incidencia que se quiere compartir y entrar en su
ventana de detalle.
(ii) Pulsar el botn Share 4 : aparecer el formulario para compartir
la incidencia (Figura 5.8). Alternativamente, puede utilizarse
el atajo de teclado s.
(iii) Aadir los usuarios con los cuales se quiere compartir la incidencia tecleando sus nombres o sus direcciones de correo electrnico
en el campo de texto User name or email.
3 Con
independencia del mecanismo de las notificaciones.

botn est disponible solo si un servidor de envo de correo SMTP ha
sido configurado por el administrador de JIRA.
4 Este
81
(iv) Eliminar usuarios con los cuales no se quiere compartir la incidencia utilizando el control identificar con el icono basura
( ).
(v) Introducir la nota que se desea enviar a los usuarios en el campo
de texto Note.
(vi) Pulsar el botn Share para comparir la incidencia.
Figura 5.8: Compartir una incidencia.
5.5
Adjuntar ficheros o capturas de pantallas a una incidencia
Con independencia de la exhaustividad de los campos asociados con

un tipo de incidencia, a veces se presenta la necesidad de proporcionar
datos aadidos relacionados con la incidencia. A menudo dichos datos
estn contenidos en ficheros y, en la mayora de los casos, no sera
prctico ni viable transcribir su contenido en un campo dedicado.
Muy a menudo, de hecho, los usuarios desean adjuntar una captura
de pantalla, para ofrecer a los operadores un feedback visual. En otras
ocasiones, podran ser los operadores quienes soliciten a los usuarios
que han abierto una incidencia de adjuntar ficheros, los cuales pueden ser de cualquier naturaleza, como formularios, documentacin
adicional o ficheros de log de una aplicacin.
82
5.5. Adjuntar ficheros o capturas de pantallas a una incidencia

Si el formato del fichero adjunto es un formato reconocido por
JIRA podr verse una vista previa del fichero directamente en la
ventana de detalle de incidencias sin la necesidad de descargarlo previamente para abrirlo con una aplicacin local.
La posibilidad de adjuntar ficheros est subordinada a que el administrador de JIRA haya habilitado est funcionalidad en la plataforma
(a nivel global) (??) y que el usuario posea los privilegios necesarios
(Create attachments). Si estas condiciones estn satisfechas, el usuario podr utilizar la funcionalidad Attach files y Attach screenshot.
Por defecto, adems, no es posible editar incidencias cerradas y, por
lo tanto, tampoco es posible aadir ficheros adjuntos a incidencias en
ste estado. Si se desea editar una incidencia cerrada, es necesario
solicitar esta funcionalidad al administrador de JIRA.
Para adjuntar un fichero es necesario efectuar las siguientes operaciones:
(i) Abrir la incidencia en la cual se desea adjuntar el fichero.
(ii) Pulsar el botn Attach files en el menu More actions (o utilizar
el formulario de acciones accesible con el atajo de teclado .) y
aparecer la ventana ilustrada en Figura 5.9.
Figura 5.9: Ventana para adjuntar ficheros a una incidencia
(iii) Seleccionar los ficheros que se desean adjuntar5 utilizando la

5 El
tamao mximo del fichero adjunto es establecido por el administrador

de JIRA y, por defecto, es de 10 MB.
83
ventana de seleccin de ficheros que aparece pulsando el botn
Choose File. Dependiendo del navegador que se est utilizando,
podra ser necesario repetir esta operacin por cada fichero que
se desea adjuntar. El nombre de los ficheros adjuntos no puede
contener ninguno de los caracteres detallados en Tabla 5.1.
Caracteres no permitidos
\
"
Tabla 5.1: Nombre de ficheros adjuntos Caracteres no permitidos
(iv) Si se desea no adjuntar un fichero seleccionado por error, es

suficiente deseleccionar el control de tipo check-box que aparece
a la izquierda de sun nombre.
(v) Opcionalmente, insertar un comentario para ofrecer una descripcin al fichero adjunto rellenando el campo de texto Comment. Se puede establecer un nivel de seguridad para el comentario y restringir su visibilidad a un nico rol de proyecto
escogiendo el rol deseados en el men desplegable que se encuentra debajo del campo Comment. En Figura 5.9 puede verse el
men de seleccin del nivel de seguridad del comentario con los
tres roles de proyecto que, por defecto, adquiere un proyecto en
JIRA.
(vi) Pulsar el botn Attach para finalizar la operacin y adjuntar los
ficheros seleccionados.
Despus de haber adjunto los ficheros a la incidencia seleccionada,
JIRA ensear una vista previa en la ventana de detalle de la incidencia, siempre que el administrador haya habilitado esta funcionalidad
de JIRA (??) y siempre que le formato del fichero sea uno de los
formatos de imagen reconocido por JIRA6 , como ilustrado en Figura
5.10.
Las vistas previas tambin pueden verse en galera, a un tamao
mayor, y de esta forma poder acceder rpidamente a los ficheros sin
necesidad de descargarlos en el ordenador local, sobre todo cuando
el tamao de los ficheros adjuntos es grande. Para acceder a la vista
de galera es suficiente hacer click sobre la vista previa de cualquier
fichero; en la vista de galera es posible navegar entre los ficheros
6 Tales
84
como: GIF, JPG, PNG, ZIP, etc.
5.6. Gestionar los ficheros adjuntos
Figura 5.10: Vista previa de los ficheros adjuntos a una incidencia
adjuntos, cuando haya ms que uno, a travs de los controles que

aparecern en pantalla, como ilustrado en Figura 5.11.
Figura 5.11: Vista de galera de los ficheros adjuntos a una incidencia
5.6
Gestionar los ficheros adjuntos
El menu desplegable a la derecha de la seccin de fichero adjuntos,

ilustrado en Figura 5.12, permite gestionar los ficheros adjuntos y
(i) Ordenar los ficheros adjuntos por nombre y fechas.
(ii) Bajarse todos los ficheros adjuntos en un archivo comprimido
de tipo ZIP.
(iii) Acceder a la ventana de gestin de ficheros adjuntos en la cual
es posible eliminar los ficheros que no se desean.
85
Figura 5.12: Menu de operaciones sobre ficheros adjuntos a una

incidencia
En las siguientes secciones se detallar la funcionalidad de cada

operacin mencionada.
5.6.1
Ordenar los ficheros adjuntos
Para ordenar la lista de ficheros adjuntos de acuerdo a los criterios

deseados es necesario efectuar las siguientes operaciones:
(i) Abrir el men desplegable de gestin de los ficheros adjuntos.
(ii) Escoger el criterio de ordenacin deseado: a) Sort By Name para ordenar por nombre; b) Sort By Date para ordenar por fecha;
c) Ascending para ordenar de forma ascendente; d) Descending
para ordenar de forma descendente.
Tngase en cuenta que el criterio de ordenacin as establecido
ser aplicado a todas las incidencias abiertas de aqu en adelanta as
como a cualquier vista donde se gestionen ficheros adjuntos, como las
galeras.
5.6.2
Acceder al contenido de adjuntos de tipo ZIP
Si un fichero adjunto es un fichero de tipo ZIP (como los ficheros

JAR), JIRA proporcionar en su interfaz un explorador a travs del
cual es posible examinar los contenidos del archivo comprimido sin
necesidad de bajarlo y descomprimirlo en el cliente, como ilustrado
en Figura 5.13.
Esta funcionalidad estar disponible solo si el administrador ha
habilitado la funcin de gestin de ficheros ZIP de JIRA (??).
86
Figura 5.13: Vista previa de un fichero adjunto de tipo ZIP o JAR
5.6.3
Eliminar ficheros adjuntos
Para eliminar un fichero adjunto de una incidencia es necesario efectuar las siguientes operaciones:
(i) Acceder a la ventana de gestin de ficheros adjuntos (Figura
5.14) utilizando el enlace Manage attachments (Gestiona ficheros adjuntos) en el men de gestin de los ficheros adjuntos (5.6
y Figura 5.12).
(ii) Eliminar los ficheros adjuntos utilizando el icono papelera ( )
a la extrema derecha del registro correspondiente al fichero a
eliminar.
Figura 5.14: Ventana de gestin de ficheros adjuntos
5.6.4
Bajar todos los adjuntos en un archivo ZIP
Si una incidencia tiene ms que un fichero adjunto y el usuario desea

bajrselos todos, JIRA ofrece la posibilidad de bajarse todos los archivos comprimidos en un nico archivo ZIP en lugar de obligar el
usuario a bajrselos de uno en uno.
Para bajarse todos los ficheros adjuntos de una incidencia como
archivo ZIP es necesario abrir el men de gestin de los ficheros adjuntos (5.6 y Figura 5.12) y seleccionar el elemento Download All.
87
5.6.5
Adjuntar una captura de pantalla
Attach screenshot (Adjuntar captura de pantalla) es una versin optimizada de la funcionalidad Attach files pensada para adjuntar capturas de pantallas a una incidencia. La ventana para adjuntar capturas de pantalla permite al usuario generar una captura de pantalla
y subirla a JIRA utilizando un applet Java sin necesidad de grabar
ficheros en el cliente para subirlos manualmente.
Para adjuntar una captura de pantalla es necesario seleccionar
la operacin Attach screenshot en el men desplegable More actions.
La primera vez que se utiliza esta funcionalidad, dependiendo de las
preferencias del navegador del usuario, podra aparecer una ventana
de confirmacin para la ejecucin del applet Java que JIRA utiliza en
el ordenador del cliente, como ilustrado en Figura 5.15.
Figura 5.15: Ventana de confirmacin para ejecutar un applet Java
Despus de haber confirmado que se desea ejecutar el applet para adjuntar capturas de pantalla, aparecer la pantalla ilustrada en
Figura 5.16.
Utilizando el botn Paste es posible pegar en la ventana la captura de pantalla para sucesivamente adjuntarla a la incidencia. En el
campo File name es posible especificar el nombre del fichero adjunto;
los nombres vlidos no debern contener los siguientes caracteres: /,
\, \", %, :, $, ? y *. Los dems campos de la ventana tienen la
misma funcionalidad que se explic anteriormente en la ventana para
adjuntar ficheros.
88
Figura 5.16: Ventana para adjuntar capturas de pantalla
El procedimiento para copiar en memoria una captura de la pantalla del cliente depende del sistema operativo utilizado:
(i) En Microsoft Windows puede utilizarse la combinacin de
teclas Alt + Print screen para capturar la ventana seleccionada o la combinacin Ctrl + Alt + Print screen para capturar la pantalla entera.
(ii) En Mac OS X puede utilizarse la combinacin de teclas Ctrl +
Apple + Shift + 4 para capturar la ventana corriente o Ctrl
+ Apple + Shift + 3 para capturar la pantalla entera.
Para descubrir como capturar pantallas en otros sistemas operativos,
vase su documentacin oficial.
89
5.7
Comentarios
Los comentarios de una incidencia son una herramienta muy til a la

hora de aadir informacin sobre una incidencia o como herramienta
de colaboracin entre usuarios. Los comentarios pueden verse en la
pestaa Comments de la seccin Activity de la ventana de detalle de
una incidencia.
Para aadir un comentario as una incidencia es necesario seleccionar el botn Comment en la barra de operaciones en la ventana de
detalle de la incidencia a comentar o el botn Comment que aprece
en el rincn inferior izquierdo de la misma ventana. En la misma
ventana de detalle de incidencia aparecer el formulario para aadir
el comentario, ilustrado en Figura 5.17.
Figura 5.17: Formulario de creacin de un comentario
Un usuario necesita poseer el permiso Add comments para poder

aadir un comentario a una incidencia. Debido a que los comentarios
son hijos de una incidencia, el usuario debe tambin poseer el permiso Browse project para poder acceder al proyecto y a la incidencia.
Los comentarios, as como toda la informacin almacenada por JIRA, pueden ser protegido para que solo los usuarios autorizado puedan
verlos. Dependiendo de como el administrador haya configurado la
visibilidad de comentarios, podrn escogerse roles de proyecto y grupos durante el establecimiento de la poltica de seguridad que protege
a un comentario, utilizando el men desplegable que aparece debajo
del formulario e identificable con el icono de un candado.
En los comentarios puede insertarse texto formateado e utilizar el
wiki markup (??).
En la interfaz web de JIRA, los comentarios pueden colapsarse y
expanderse utilizando los correspondientes iconos a la izquierda del
comentario. En Figura 5.18 puede verse un ejemplo de comentario
colapsado (arriba) y expandido (abajo).
90
5.7. Comentarios
Figura 5.18: Comentarios colapsados y expandidos
Posicionando el ratn encima de un comentario, aparecern unos

iconos a la izquierda del comentario con las cuales los usuarios que posean los permisos requeridos pueden operar sobre un comentario. En
Figura 5.19 pueden verse los iconos correspondientes a las operaciones
de creacin de enlace, modificacin y borrado de comentario.
Figura 5.19: Iconos para operar sobre un comentario
5.7.1
Modificar un comentario
A veces es necesario modificar un comentario existente si, por ejemplo, es necesario corregir la informacin introducida o moderar un
comentario que no cumple con las polticas de la empresa. Tambin
es posible modificar la poltica de seguridad de un permiso y modificar
el valor del campo Viewable by.
El permiso requerido para modificar un comentario propio es el
permiso Edit own comments y para modificar cualquier comentario
se requiere el permiso Edit all comments.
Para modificar un comentario es necesario utilizar el control de
modificacin de comentario indicado con el icono de un lpiz a la derecha del comentario. Seleccionando esta operacin el usuario ser
enviado a una ventana parecida a la ventana de creacin de comentario para que pueda aportar las modificaciones deseadas.
91
5.7.2
Eliminar un comentario
Un comentario tambin puede ser eliminado por un usuario que posea

el permiso requerido: para eliminar un comentario propio es necesario
tener el permiso Delete own comments y para eliminar un comentario
de otro usuario es necesario tener el permiso Delete all comments.
Para eliminar un comentario es necesario utilizar el icono de eliminacin de comentario, identificado con una papelera, a la derecha
del comentario a borrar.
5.7.3
Crear un enlace a un comentario
Muchas veces los comentarios contienen informacin de inters introducida por otros usuarios. Los operadores, por ejemplo, pueden
utilizar los comentarios para colaborar con los dems usuario e compartir, por ejemplo, instrucciones para solucionar una incidencia.
Por esta razn es til poder disponer de un mecanismo para enlazar directamente a un comentario para poder almacenar una referencia a l y compartirla con otros usuarios a travs del correo electrnico, en una pgina web o con cualquier otro medio de comunicacin
electrnica.
JIRA soporta la creacin de permalinks hacia los comentarios utilizando el icono de enlace que se encuentra a la derecha del comentario seleccionado. Despus de haber pulsado el comentario, la pgina
se recargar y, si la pgina de detalle de la incidencia es ms grande
de la pantalla del usuario, la pgina se posicionar a la altura del comentario seleccionado. El URL que aparece en la barra de direcciones
del navegador es el permalink generado por JIRA y puede copiarse e
compartirse con otros usuarios.
5.8
Campos de texto formateado
En JIRA el rendering de los campos es efectuado por los renderers. JIRA proporciona renderers por todos los tipos de campos que
pueden aparecer en sus pginas: sin embargo, renderers adicionales
pueden ser instalados por plugins y el administrador puede asociar
un renderer especfico a un campo en una configuracin de campos.
Las recientes versiones de JIRA proporcionan el wiki-style renderer que permite formatear campos de texto libre (como los comentarios) con efectos sofisticados utilizando una notacin heredada de
Atlassian Confluence. Los campos para los cuales el administrador ha
92
5.8. Campos de texto formateado

configurado el wiki-style renderer pueden reconocerse por unos iconos
adicionales que pueden verse en Figura 5.20.
El icono que representa una pantalla azul es la funcin de vista

previa que permite visualizar el campo de texto formateado, y ver
los efectos aplicados a travs de la notacin wiki, antes de grabar las
modificaciones. El icono amarillo con un punto de interrogacin proporciona una ventana de ayuda sobre la notacin wiki. En Figura
5.21 puede verse la funcin de vista previa aplicada al texto insertado
en el campo de Figura 5.20.
5.8.1
Macros
El wiki-style renderer permite formatear un campo de texto con efectos sofisticados tales como:
(i) Efectos tipogrficos tales como fuente itlica, negrita, etc.
(ii) Creacin de ttulos de mltiple niveles.
93
(iii) Creacin de listas, listas numeradas, tablas y citaciones.
(iv) Visualizacin de imgenes.
(v) Preparacin rpida de fragmentos de cdigo.
JIRA, por defecto, proporciona las macros ilustradas en el Cuadro
5.2.
Wiki-style renderer Macro
Macro
anchor
code
quote
noformat
panel
color
loremipsum
html
Efecto
Crea un anchor en un punto especfico de la pgina.
Formatea un fragmento de cdigo. La macro formatea
Java, JavaScript, ActionScript, XML, HTML y SQL.
Formatea una citacin.
Crea una seccin dentro de la cual el formateo wiki no
se aplica.
Crea un panel.
Cambia el color del texto.
Inserta prrafos de prueba.
Inyecta fragmentos de HTML.
Tabla 5.2: Macro del wiki-style renderer
5.8.2
Sintaxis de las macros
La sintaxis para utilizar las macros del wiki-style renderer es la siguiente:

{macro}
...
{macro}
Algunas macros, como la macro panel aceptan parmetros opcionales

que se especificarn de la siguiente forma:
{macro:attr0=valor|attr1=valor|...}
...
{macro}
5.8.3
Macro code
La macro code permite formatear fragmentos de cdigo de forma fcil

en un campo de texto de JIRA. El texto:
94
5.9. Sub-tareas
{code:title=Example.java}
// Comment
public String getFoo()
{
return foo;
}
{code}
produce el resultado de Figura 5.22.
Figura 5.22: Fragmento de cdigo formateado con la macro code
Por defecto la macro code asume que el lenguaje de programacin

del fragmento sea Java. Sin embargo, es posible utilizar otros lenguajes (JavaScript, ActionScript, XML, HTML y SQL). El siguiente
fragmento:
{code:xml}
<element>
<child attribute="value"/>
</element>
{code}
produce el resultado de Figura 5.23.
Figura 5.23: Fragmento de XML formateado con la macro code
5.9
Sub-tareas
En su sentido ms amplio, la incidencias de JIRA puede representar

una tarea asignada a un usuario y sujeta a un flujo de trabajo determinado. En muchos casos de usos es til poder subdividir una tarea
95
en sub-tareas, cada una de las cuales puede ser gestionada independientemente de la dems. Dividir una tareas en sub-tareas permite
tener una visin ms completa del estado de avance de una incidencia
y, adems, permite paralelizar los trabajos requeridos para solucionar
una tarea ya que cada sub-tarea puede asignarse a usuarios distintos.
Las sub-tareas, de todos modos, tienen algunas limitaciones. Las
sub-tareas, antes que todo, pertenecern al mismo proyecto de la incidencia padre. Los tipos de incidencia de las sub-tareas son distintos
de los tipos de incidencia de incidencias de primer nivel. En JIRA
pueden crearse tambin tipos de incidencias para sub-tareas; sin embargo el nivel de flexibilidad de la configuracin es menor y se reduce,
bsicamente, a asignar un nombre y un icono a cada tipo de sub-tarea
creado. Las sub-tareas no pueden tener sub-tareas: el rbol de incidencias de un proyecto como mucho tiene profundidad 2. Si una
sub-tarea necesita tener sub-tareas, se puede promover la sub-tarea
a tarea de primer nivel; para mantener una relacin entre distintas
incidencias podr utilizarse un mecanismo alternativo, el mecanismo
de los enlaces.
Esta funcionalidad estar disponible en JIRA solo si el administrador ha habilitado las sub-tareas (??).
5.9.1
Crear sub-tareas
Para crear una sub-tarea, el usuario necesita el permiso Create issue.

Para crear una sub-tarea en una incidencia de JIRA es necesario entrar en la ventana de detalle de la incidencia y seleccionar la operacin
Create sub-task en el men More actions: el usuario podr seleccionar
el tipo de sub-tarea en la ventana de creacin de sub-tareas que se
ilustra en Figura 5.24. El tipo de sub-tarea seleccionado por defecto
es el tipo de sub-tarea estndar de JIRA, Sub-task pero, como explicado anteriormente, la lista puede de tipos de sub-tareas puede ser
configurada por el administrador.
Figura 5.24: Ventana de creacin de sub-tarea
96
5.9. Sub-tareas
Despus de haber seleccionado el tipo de tarea, el usuario tendr
que completar el formulario en la ventana de creacin de incidencia
(5.1): los campos de una sub-tarea son los campos de una incidencia
estndar de JIRA, exceptuando el nivel de seguridad que siempre se
hereda de la incidencia padre. Despus de haber creado la sub-tarea,
el usuario ser llevado a la ventana de detalle de incidencia. En el
caso de las sub-tareas, la ventana de detalle es la misma que en el
caso de las incidencias y puede verse un exemplo en Figura 5.25.
Figura 5.25: Ventana de detalle de sub-tarea
Puede notarse que la incidencia es efectivamente una sub-tarea ya

que encima del nombre de la incidencia puede verse el nombre del
proyecto y el nombre de la incidencia padre:
JIRA Guide / JRADG-1 I think I found a bug / JRAGD-2
Utilizando esos enlaces y pulsando el nombre de la incidencia padre

(JRADG-1) el usuario puede ir a la ventana de detalle de esta incidencia
y comprobar que las sub-tareas que sta contiene pueden verse en la
ventana de detalle. En Figura 5.26 puede verse el panel Sub-tasks que
aparece en la ventana de detalle cuando una incidencia tiene alguna
sub-tarea.
Figura 5.26: Lista de sub-tareas de una incidencia
97
5.9.2
Gestin de sub-tareas
Las sub-tareas no difieren mucho de las incidencias de primer nivel

y el usuario podr trabajar con ellas de la misma manera en que
trabaja con cualquier otra incidencia. Las diferencias ms relevantes,
de hecho, estn a nivel de interfaz de usuario.
Como visto en la seccin precedente, en la ventana de detalle de
incidencia existe un panel dedicado a las sub-tareas de una incidencia,
el panel Sub-tasks. A travs de este panel es posible filtrar las subtareas, ordenarlas y efectuar muchas de las operaciones que pueden
efectuarse a travs de la ventana de detalle de incidencia. El panel
Sub-tasks tiene dos vistas con las cuales pueden visualizarse todas las
sub-tareas o solo las sub-tareas abiertas (no completadas). Cuando se
posiciona el ratn encima de una sub-tarea, aparecen unos controles
adicionales, ilustrados en (Figura 5.27).
Figura 5.27: Operaciones de una sub-tarea
Los controles a forma de flecha permiten ordenar las sub-tareas,

movindolas arriba y abajo, segn los criterios establecidos por el
usuario. El segundo control, identificado con el icono de un engranaje, despliega el men de acciones (que puede verse en Figura 5.28)
que contiene las operaciones que es posible efectuar sobre una subtarea. Ntese que el men de acciones contiene prcticamente todas
las operaciones disponibles sobre una incidencia, tanto las operaciones
comunes como las operaciones de flujo de trabajo.
En el panel Sub-tasks pueden verse las barras de progreso del trabajo sobre una incidencia se ilustra de forma grfica el tiempo estimado
para la resolucin de una incidencia y el trabajo desempeado hasta
el momento.
A travs del control identificado con el icono + puede crearse rpidamente una sub-tarea a la incidencia seleccionada. Seleccionando
ese control, aparecer la form de creacin de sub-tarea directamente
en el panel Sub-tasks, como ilustrado en Figura 5.29
98
5.9. Sub-tareas
Figura 5.28: Menu de operaciones de una sub-tarea
Figura 5.29: Formulario de creacin de sub-tarea en el panel Sub-tasks
99
5.9.3
Convertir una incidencia en sub-tarea
A veces es deseable modificar la organizacin de las incidencias a

posteriori. Un jefe de proyecto, por ejemplo, podra querer agregar
un conjunto de incidencias de primer nivel como sub-tareas de otra
incidencia con el objetivo de facilitar el seguimiento de unas labores.
En otras ocasiones, un jefe de proyecto quisiera subdividir el trabajo
de una incidencia en sub-tareas para agilizar su resolucin y asignar
mltiples unidades de trabajo a muchos miembros del equipo a la
vez.
JIRA permite convertir una incidencia de primer nivel a sub-tarea
(y viceversa). Ya que, como explicado, las sub-tareas no pueden tener
sub-tareas, no es posible convertir a sub-tarea una incidencia que
tenga sub-tareas.
Para convertir una tarea de primer nivel en sub-tarea, es necesario
(i) Seleccionar la incidencia a convertir.
(ii) Seleccionar la operacin Convert to sub-task del men More
actions.
(iii) En la form de conversin ilustrada en Figura 5.30 seleccionar la
tarea a la que pertenecer la incidencia despus de convertirse
en sub-tarea.
Figura 5.30: Formulario de conversin de incidencia a sub-tarea
(iv) Seleccionar el tipo de incidencia de la sub-tarea.

(v) En el caso en que el estado de la tarea a convertir no fuese
permitido por el tipo de sub-tarea escogida, aparecer un formulario para escoger el estado de la incidencia despus de la
conversin. En el caso no fuese necesario hacer esta conversin,
la ventana no aparecer.
100
5.9. Sub-tareas
(vi) En el caso en que el tipo de sub-tarea escogido requiriese campos adicionales, el usuario podr introducirlos en el formulario
ilustrado en Figura 5.31. En el caso no fuese necesario aadir
ninguna informacin adicional, la ventana presentar un mensaje informativo.
Figura 5.31: Formulario de conversin de campos para la conversin a

sub-tarea
(vii) Al final del proceso, se visualizar la ventana de confirmacin

ilustrada en Figura 5.32. Pulsando el botn Finish se llevar
a cabo el proceso de conversin al final del cual aparecer la
ventana de detalle de la incidencia.
Figura 5.32: Formulario de confirmacin de conversin de incidencia a

sub-tarea
5.9.4
Convertir una sub-tarea en incidencia
En ciertas ocasiones puede ser deseable hacer la conversin inversa y

transformar una sub-tarea en una incidencia de primer nivel. Los pasos necesarios a efectuar la transformacin y las ventanas propuestas
al usuario son las mismas que se han visto durante la conversin de
una incidencia de primer nivel en sub-tarea (5.9.3). En resumen, las
operaciones a efectuar son las siguientes:
(i) Seleccionar la sub-tarea a convertir.
(ii) Seleccionar la operacin Convert to issue del men More actions.
101
(iii) Seleccionar el tipo de incidencia.
(iv) En el caso en que el estado de la sub-tarea a convertir no fuese permitido por el tipo de incidencia escogida, aparecer un
formulario para escoger el estado de la incidencia despus de la
conversin. En el caso no fuese necesario hacer esta conversin,
la ventana no aparecer.
(v) En el caso en que el tipo de incidencia escogido requiriese campos adicionales, el usuario podr introducirlos en el formulario
parecido a la ventana ilustrada en Figura 5.31. En el caso no
fuese necesario aadir ninguna informacin adicional, la ventana presentar un mensaje informativo.
(vi) Al final del proceso, se visualizar una ventana de confirmacin
parecida a la ilustrada en Figura 5.32. Pulsando el botn Finish se llevar a cabo el proceso de conversin al final del cual
aparecer la ventana de detalle de la incidencia.
5.10
Duplicar una incidencia
En ciertas ocasiones puede ser til poder crear una incidencia copiando una incidencia existente y evitar as volver a rellenar muchos
campos cuyo valor coincide en ambas incidencias: si, por ejemplo,
se necesita crear una incidencia muy parecida a una incidencia ya
registrada en JIRA, puede clonarse dicha incidencia para obtener
una copia exacta (con las excepciones detalladas ms adelante) de la
incidencia y de sus campos y cambiar solo la informacin que necesita modificarse. Durante la copia de una incidencia la informacin
relativa al trabajo desempeado sobre la incidencia original (time
tracking, comentarios, etc.) no se copiarn. Los campos copiados son
los siguientes:
(i)
(ii)
(iii)
(iv)
(v)
(vi)
(vii)
(viii)
(ix)
(x)
102
Ttulo.
Descripcin.
Usuarios al que se asign la incidencia.
Entorno.
Prioridad.
Tipo de incidencia.
Seguridad.
Usuario que ha reportado la incidencia.
Componentes.
Versiones afectadas.
5.10. Duplicar una incidencia

(xi)
(xii)
(xiii)
(xiv)
Resolucin para versiones.

Enlaces de incidencia.
Ficheros adjuntos
Proyecto.
Los campos copiados podrn, obviamente, modificarse despus de

haberse creado la copia. En el caso del campo proyecto, por ejemplo,
podr moverse la incidencia duplicada a otro proyecto.
En algunos casos de uso, puede ser til dejar constancia de la operacin de copia utilizando un link (enlace) entre la incidencia original
y su copia.
Para duplicar una incidencia es necesario efectuar las siguientes
operaciones:
(i) Seleccionar la incidencia a duplicarse.
(ii) Selecciona la operacin Clone del men More actions.
(iii) En la ventana siguiente puede modificarse el ttulo de la incidencia. Por defecto, JIRA aade un prefijo (??) al ttulo de la
incidencia original.
(iv) Si la incidencia contiene enlaces a otras incidencias es posible
elegir si duplicar los enlaces o no.
(v) Si la incidencia contiene sub-tareas es posible elegir si duplicar
las sub-tareas o no.
(vi) Si la incidencia contiene ficheros adjuntos es posible elegir si
incluir estos ficheros en la incidencia duplicada.
(vii) Finalizar la duplicacin de la incidencia pulsando el botn Create.
5.10.1
Crear un enlace a una incidencia duplicada
Puede ser deseable mantener constancia de las operaciones de duplicacin de incidencia y para conseguir este objetivo JIRA permite
crear de forma automtica un enlace entre las dos incidencias. Por
defecto esta funcionalidad est inhabilitada y solo el administrador
puede activarla.
Para activar la creacin automtica de enlaces durante la duplicacin de incidencias el administrador debe impostar la propiedad
jira.clone.linktype.name en el fichero de configuracin de JIRA,
jira-application.properties con el nombre del enlace a crear.
Por defecto el nombre es Cloners, como puede verse en el fragmento
de cdigo 5.1.
103
Cdigo 5.1 Nombre por defecto del enlace automtico a incidencias
duplicadas
jira.clone.linktype.name = Cloners
El tipo de enlace configurado debe existir y, por defecto, el enlace

de tipo Cloners no existe en JIRA. Para habilitar esta funcionalidad
el administrador deber por lo tanto crear el enlace de tipo Cloners
o crear otro enlace y configurar adecuadamente la propiedad en cuestin.
5.10.2
Prefijo del ttulo de las incidencias duplicadas
Cuando se duplica una incidencia JIRA aade automticamente un

prefijo al ttulo de la incidencia duplicada y, por defecto, el prefijo
utilizado es CLONE -. El prefijo utilizado puede elegirse modificando
la propiedad jira.clone.prefix en el fichero de configuracin de JIRA, jira-application.properties, como ilustrado en el fragmento
de cdigo 5.2.
Cdigo 5.2 Prefijo del ttulo de las incidencias duplicadas
jira.clone.prefix = CLONE -
5.10.3
Duplicacin de incidencias y sub-tareas
El proceso de duplicacin de incidencias maneja de forma distinta

las sub-tareas dependiendo del contexto en el que las sub-tareas
aparecen. Si se est duplicando una sub-tarea, el procedimiento de
duplicacin ser idntico al proceso de duplicacin de cualquier incidencia. Si se est duplicando una incidencia que contiene sub-tareas,
las sub-tareas podrn duplicarse tambin pero el prefijo del ttulo se
aplicar solo a la incidencia padre.
5.11
Enlaces entre incidencias
JIRA proporciona algunos mecanismos para establecer una relacin

entre incidencias. Los enlaces son, probablemente, el ms flexible de
estos mecanismos. Esta funcionalidad es habilitada y configurada por
el administrador de JIRA. El administrador puede definir los tipos de
104
5.11. Enlaces entre incidencias

enlaces que se requieren y los usuarios que posean el permiso Link
issues pueden escoger un tipo de enlace y establecer una relacin
entre dos incidencias.
Los enlaces son relaciones bidireccionales 7 que indicaremos con la
notacin . Por su naturaleza bidireccional, establecer una relacin

entre dos incidencias x y y:
x y
(5.1)
o la correspondiente inversa 1 entre y y x:

1
x y
(5.2)
otorga el mismo resultado: JIRA indicar la existencia de la relacin

en la ventana de detalle de x, y la existencia de la relacin 1 en
la ventana de detalle de y. Cuando el administrador crea un enlace
nuevo, entonces, es necesario definir tanto la descripcin para que
para la relacin inversa, 1 .
Desde o hacia una incidencia pueden crearse tantos enlaces como
sean necesarios. El interfaz de JIRA, en la ventana de detalle de incidencia, agregar los enlaces del mismo tipo y direccin para facilitar
la lectura y la organizacin de los enlaces entre incidencias.
Relaciones muy comnmente utilizadas son, por ejemplo, la relaciones de duplicidad y dependencia. La relacin de duplicidad, por
ejemplo, puede ser definida por el administrador como x duplica y y y
es duplicada por x. El administrador podr definir, a travs de la consola de administracin de JIRA, todos los tipos de enlaces requeridos
por los proyectos gestionados por la plataforma.
Para establecer una relacin entre dos incidencias es necesario
(i) Seleccionar una incidencia. La incidencia, como veremos, puede
ser tanto la incidencia donde se origina la relacin o la incidencia
donde termina la relacin. En la notacin x y x es la

incidencia donde origina y y la incidencia donde termina la
relacin.
(ii) Seleccionar la operacin Link del men More actions y aparecer la ventana de creacin de enlace que puede verse en Figura
5.33.
7 Que
pueden navegarse en ambos sentidos.
105
Figura 5.33: Formulario de creacin de un enlace entre incidencias
(iii) En la ventana de creacin elegir el tipo de enlace que se desea

establecer. En la combo (Figura 5.34) podr elegirse tanto una
relacin que origina como una relacin que termina en la
incidencia seleccionada. En Figura 5.34 pueden verse, por ejemplo, las relaciones de dependencia, duplicacin y relacin y las
correspondientes relaciones inversas.
Figura 5.34: Formulario de creacin de un enlace entre incidencias
(iv) En el campo Issues se pueden escoger las incidencias con las

cuales hay que establecer la relacin. Las incidencias pueden
seleccionarse empezando a teclear el cdigo o el ttulo de la incidencia y JIRA propondr una lista de incidencias, generada
dinmicamente, que satisfacen el criterio de bsqueda de acuerdo al texto escogido por el usuario (Figura 5.35).
(v) Las incidencias pueden buscarse tambin utilizando un filtro de
bsqueda que el usuario haya definido (vase ??) en el buscador
106
5.11. Enlaces entre incidencias
Figura 5.35: Bsqueda de una incidencia por cdigo o ttulo
de incidencias que aparece seleccionado el control + a la derecha de la combo Issues (Figura 5.36). Si se desean seleccionar
mltiples incidencias, se puede utilizar el botn Select multiple
issues y seleccionar las incidencias deseadas utilizando los check
box que aparecen al lado de cada incidencia.
Figura 5.36: Bsqueda de una incidencia utilizando un filtro
(vi) Puede insertarse un comentario al enlace creado insertando un

107
texto en el control Comment.
(vii) Puede escogerse que tipo de visibilidad tendr el enlace escogiendo un role de proyecto en el control Viewable by (vase
??).
(viii) Crear el enlace seleccionando el botn Link.
Despus de haber creado el enlace podrn verse los detalles de los
enlaces a los que pertenece la incidencia seleccionada en el panel Issue
Links de la ventana de detalles de incidencia. Un enlace de ejemplo
puede verse en Figura 5.37.
Figura 5.37: Detalle de un enlace entre incidencias
Como en otros paneles de JIRA, en el rincn superior derecho

pueden verse controles adicionales. En este caso est el control de
gestin de enlaces, identificado con el icono de un engranaje y el
control para aadir un enlace, identificado con un icono con el smbulo
+.
5.11.1
Gestionar los enlaces entre incidencias
El control de gestin de enlaces, identificado con un engranaje, lleva

a la ventana de gestin de enlaces. En esta ventana, ilustrada en
Figura 5.38, pueden organizarse los enlaces, ordenndolos utilizando
los controles identificados con flechas y eliminar enlaces, utilizando
el control de eliminacin, identificado con el icono de basura.
Figura 5.38: Ventana de gestin de enlaces entre incidencias
108
5.12. Planificar las incidencias

5.12
Planificar las incidencias
JIRA permite planificar las incidencias que creamos dentro de los

proyectos incluyendo la fecha de resolucin (Due date). La fecha de
resolucin es una estimacin de la fecha en la que una incidencia
debera cerrarse y, por defecto, es un campo opcional en los tipos de
incidencia y relativas configuraciones de campos de una instalacin
estndar de JIRA.
La fecha de resolucin puede utilizarse, por ejemplo, para priorizar
la resolucin de las incidencias que estn prximas a la fecha lmite.
Creando filtros (??) es posible, por ejemplo, crear reportes en el
cuadro de mando de JIRA de un jefe de equipo y obtener una imagen
del estado de resolucin de las incidencias de un proyecto. De la
misma forma, es posible utilizar este campo para enviar notificaciones
(??) cuando una incidencia supera la fecha lmite sin estar resuelta
y ser avisado inmediatamente cuando este evento ocurre.
Esta funcionalidad de JIRA est siempre habilitada y, para modificar el valor de este campo, un usuario debe tener el permiso Schedule
issues.
Un usuario puede modificar el campo Due date en el momento
de la creacin de una incidencia o, posteriormente, modificando una
incidencia existente.
5.12.1
Filtrar incidencias utilizando la fecha de resolucin
Las herramientas de bsqueda y filtrado de incidencia de JIRA son

poderosas y permiten realizar bsquedas complejas utilizando cualquier campo de una incidencia, incluidos los campos personalizados
creados por los administradores de acuerdo a las necesidades de cada
proyecto.
El campo fecha de resolucin es un campo estndar de las incidencias y es posible realizar bsquedas simples o avanzadas. En
este captulo se detallar el mecanismo de bsqueda simple. Las bsquedas avanzadas aprovechan del lenguaje de query de JIRA que se
detallar en ??.
La seccin relativa al filtrado por fecha de resolucin del navegador de incidencias puede verse en Figura 5.39. Debido a la naturaleza
del valor almacenado en este campo, JIRA permite realizar dos tipos de bsquedas de forma fcil a travs de una interfaz de usuario
especializada:
109
Figura 5.39: Seccin de filtrado por fecha de resolucin en el navegador

de incidencias
(i) Bsquedas por valores exactos, utilizando los campos Due after
y Due before.
(ii) Bsquedas por intervalos temporales relativos a la fecha buscada, utilizando los campos From, To y el formulario de bsqueda
por valores relativos disponible utilizando el icono calendario
a la derecha de estos campos.
En las bsquedas por valores exactos se utiliza un valor absoluto
para filtrar las incidencias; llamando t0 y t1 los valores introducidos
por el usuario y x el valor del campo fecha de resolucin de una
incidencia, pueden realizarse las siguientes operaciones a travs del
interfaz de usuario de JIRA:
(i)
(ii)
(iii)
(iv)
Buscar
Buscar
Buscar
Buscar
las
las
las
las
incidencias
incidencias
incidencias
incidencias
que
que
que
que
satisfagan
satisfagan
satisfagan
satisfagan
x = t0 .
x t0 .
x t0 .
t0 x t1 .
Los campos Due after y Due before se poblarn con los valores t0
y t1 de acuerdo con la bsqueda que se est deseando realizar. Para
realizar la bsqueda (ii), por ejemplo, habr que poner el valor t0 en
el campo Due before; para realizar la bsqueda (iv), habr que poner
el valor t0 en el campo Due after y el valor t1 en el campo Due before.
La fecha puede especificarse utilizando los formatos descritos en
?? o utilizando los controles calendarios cuyos iconos pueden verse
a la derecha de los campos Due after y Due before. En Figura 5.40
puede verse como filtar las incidencias con x t0 cuando la fecha de
resolucin es el 10 de Enero de 2011.
110
5.12. Planificar las incidencias
Figura 5.40: Ejemplo de filtrado por fecha de resolucin en el navegador

de incidencias
Las bsquedas por intervalos temporales relativos a la fecha actual

permiten efectuar bsquedas de los siguientes tipos:
(i) Buscar las incidencias que hayan sobrepasado la fecha lmite.
(ii) Buscar las incidencias que hayan sobrepasado la fecha lmite por
un nmero de das n t0 .
(iii) Buscar las incidencias que habrn sobrepasado la fecha lmite
dentro de n das8 .
(iv) Buscar las incidencias cuya fecha lmite est en el intervalo [t +
t0 , t + t1 ] donde t es la fecha al momento de la bsqueda y t0 y
t1 son dos parmetros especificados por el usuario.
El formulario de bsqueda (Figura 5.39) contiene dos campos:
From y To. Todas las bsquedas por intervalos temporales relativos
pueden realizarse poblando adecuadamente estos campos. Sin embargo, el usuario puede componer ms fcilmente el formulario utilizando
la ventana de seleccin (Figura 5.41) a la que se accede seleccionando el icono identificado con un calendario a la derecha de dichos
campos. La ventana de seleccin permite poblar el formulario con los
valores adecuados al tipo de bsqueda que se desea realizar.
8 Es
posible especificar si se desea recuperar tambin las incidencias que hayan

ya sobrepasado la fecha lmite al momento de la bsqueda
111
Figura 5.41: Formulario para la creacin de un criterio de bsqueda por

fecha de resolucin con intervalos temporales relativos.
La bsqueda de tipo (i) se obtiene utilizando los valores9 :

(
From =
To = 0
La bsqueda de tipo (ii) se obtiene utilizando los valores:
(
From =
To = nd
La bsqueda de tipo (iii) se obtiene utilizando los valores:
(
From = 0
To = nd
(5.3)
(5.4)
(5.5)
Si se desea encontrar tambin las incidencias que hayan sobrepasado

la fecha lmite en el momento de la bsqueda, se utilizarn los valores:
(
From =
(5.6)
To = nd
9 Con
112
el smbulo se entiende que el campo se queda vaco.
5.13. Proteger una incidencia

La bsqueda de tipo (iv) se obtiene utilizando los valores:
(
From = t0
To = t1
(5.7)
donde t0 y t1 pueden utilizar la notacin xw yd wh zm donde w

indica el nmero de semanas, d el nmero de das, h el nmero de
horas y m el nmero de minutos. 1w 2d indicar, por ejemplo, una
semana y dos das en el pasado, ya que est prefijado con el signo .
5.13
Proteger una incidencia
Los roles de proyecto y los esquemas de permisos permiten al administrador de definir polticas de seguridad con una resolucin muy fina.
Sin embargo, en algunos casos de uso, no es suficiente otorgar el permiso para ver las incidencias de un proyecto (Browse projects) a un
conjunto de roles ya que podra necesitarse proteger un subconjunto
de las incidencias existentes para que sean visibles solo a un grupo
restringido de usuarios.
Los niveles de seguridad de las incidencias permiten subdividir
las incidencias en grupos cada uno de los cuales puede tener una
poltica de seguridad distinta y, por lo tanto, ser visible a grupos de
usuarios diferentes. Sin esta funcionalidad, la nica opcin viable para
obtener un resultado parecido sera la creacin de mltiples proyectos
con usuarios y roles de proyectos distintos. Sin embargo, la gestin de
mltiples proyectos sera ms complicada y se duplicaran de forma
innecesaria las herramientas que el jefe de proyecto utilizara para
monitorizar las labores sobre los proyectos tales como filtros, cuadros
de mandos y reportes.
Cuando una incidencia est protegida con un nivel de seguridad,
la incidencia ser invisible a los usuarios no autorizados a travs de
cualquier herramienta proporcionada por JIRA, incluyendo reportes,
bsquedas, filtros, notificaciones, etc.
5.13.1
Caso de uso: segmentacin de usuarios
Un caso de uso tpico de los niveles de seguridad de las incidencias

es la segmentacin de los usuarios de un proyecto de JIRA. El mismo proyecto, por ejemplo, podra estar recogiendo incidencias por
usuarios, clientes en este caso, que hayan contratado soportes con
distintos niveles de servicio. En este caso de uso podra ser deseable
113
establecer una segmentacin de clientes de manera que los clientes
que han contratado un nivel de servicio ms elevado tengan acceso
a informacin restringida a usuarios con soporte de nivel ms bajo.
En la segmentacin de ejemplo ilustrada en Figura 5.42, los usuarios con el nivel de soporte Silver-level support podrn acceder a un
sub-conjunto de la informacin gestionada en el proyecto JIRA y
no podrn ver la informacin reservada a los niveles superiores. Los
Figura 5.42: Segmentacin de usuarios con niveles de seguridad de

incidencia
usuarios con el nivel de soporte inmediatamente superior, Gold-level

support, podrn acceder a la informacin disponible al nivel Silver
y a un conjunto de informacin adicional. Los usuarios con el nivel
Platinum podrn acceder a la informacin disponible a los usuarios
de los niveles inferiores y a un conjunto de informacin adicional.
Este tipo de segmentacin no solo permite crear vistas diferentes del mismo proyecto para usuarios distintos sino que puede ser de
ayuda a la hora de planificar el trabajo sobre las incidencias. El jefe
de proyecto y los operadores asignados al proyecto pueden utilizar la
segmentacin para priorizar las labores sobre las incidencias. La forma ms sencilla consiste en planificar la resolucin de las incidencia
de forma manual: el jefe de equipo utilizar la segmentacin y la prioridad de las incidencias para asignarlas a los operadores de acuerdo
a las necesidades del proyecto, de los clientes y de la importancia de
las incidencias.
Otro enfoque, ms apto a proyectos con un grande nmero de incidencias y operadores, es la implementacin de una segmentacin de
operadores. La segmentacin de operadores permite crear grupos de
operadores dedicados: para ofrecer un nivel de servicio ms elevado
a clientes con soporte ms alto se pueden asignar ms recursos10 al
grupo de operadores dedicados al nivel de seguridad ms elevado.
10 La
114
asignacin de una cantidad de recursos ms elevada podra traducirse en
5.13. Proteger una incidencia

5.13.2
Caso de uso: proteger informacin confidencial
Otro caso de uso para los niveles de seguridad de las incidencias es la

proteccin de informacin confidencial de un proyecto.
Para un usuario de JIRA, un proyecto no es solo un sitio donde
reportar incidencias y observar el trabajo desempeado sobre ella.
Uno de los valores aadidos ms importantes de la plataforma JIRA
es el hecho de que se proporciona un espacio donde los usuarios pueden
colaborar y donde se favorece la interaccin directa con otros usuarios
de la plataforma.
Un proyecto de JIRA es el lugar ideal donde una empresa, o una
unidad organizativa de una empresa, puede concentrar toda la informacin relativa a las labores dentro del marco de una iniciativa.
La consolidacin de la informacin en una sola plataforma facilitar
la explotacin de la informacin histrica y la gestin de las labores
diarias de los equipos.
En ciertas circunstancias, sin embargo, una organizacin quisiera utilizar JIRA para almacenar y tener constancia de informacin
confidencial relativa a un proyecto garantizando, al mismo tiempo,
que el acceso a dicha informacin estuviera restringido a los usuarios
autorizados.
Los niveles de seguridad de las incidencias permiten crear las polticas de seguridad necesarias a proteger un conjunto de incidencias
y otorgar el acceso a ellas solo a un grupo de usuarios selectos.
5.13.3
Proteger una incidencia
La definicin de los niveles de seguridad disponibles en un proyecto

es una responsabilidad del administrador de JIRA. Los usuarios de
un proyecto que tengan el permiso Set issue security podrn escoger
el nivel de seguridad de una incidencia al momento de su creacin o,
posteriormente, al momento de su modificacin.
Es importante subrayar que un usuario puede escoger como nivel
de seguridad de una incidencia solo un nivel del cual l mismo sea
miembro. De esta forma se garantiza que no pueda asociarse una
incidencia con un nivel de seguridad para el cual no exista ningn
miembro activo y, por lo tanto, perder esa incidencia ya que resultara inaccesible para todo usuario del proyecto.
un nmero de operadores ms elevados e, incluso, en un horario extendido de
trabajo sobre las incidencias.
115
Para seleccionar el nivel de seguridad de una incidencia es necesario modificar el valor del campo Security level. En Figura 5.43
puede verse el men desplegable del campo Security level en la ventana de modificacin de una incidencia. En este caso solo existen dos
Figura 5.43: Modificar el nivel de seguridad de una incidencia
opciones:
(i) None: Seleccionando esta opcin no se aplicar ningn nivel
de seguridad a la incidencia que, por lo tanto, estar visible a
todos los usuarios que tenga el permiso Browse projects.
(ii) Silver: Seleccionando esta opcin se aplicar el nivel de seguridad Silver a la incidencia. La incidencia estar visible a todos
los usuarios autorizados por este nivel de seguridad.
Al proyecto al que pertenece la incidencia ilustrada, JIRA Guide,
se ha asignado un esquema de nivel de seguridad de incidencias que
contiene los tres niveles que se introdujeron en 5.13.1:
(i) Platinum.
(ii) Gold.
(iii) Silver.
Sin embargo, en Figura 5.43, solo se puede seleccionar el valor Silver
en el campo Security level ya que el usuario conectado solo tiene
acceso a incidencias en este nivel de seguridad.
Despus de haber confirmado el nivel de seguridad de la incidencia podr verse reflejado el nuevo valor en la ventana de detalle de
incidencias (Figura 5.44).
116
5.14. Poner etiquetas a una incidencias
Figura 5.44: Nivel de seguridad de una incidencia en la ventana de

detalle
Un usuario que no tenga acceso a este nivel de seguridad no podr

ver las incidencias asociadas. Para ilustrar esta caractersticas se
han asociados todas las incidencias del proyecto al nivel de seguridad
Silver. Un usuario bsico que no tenga acceso a ningn nivel de
seguridad no ver ninguna actividad en el proyecto, como ilustrado
en Figura 5.45.

detalle
5.14
Poner etiquetas a una incidencias
Las etiquetas (labels) son un tipo de campo introducido recientemente

en JIRA que permite al usuario agregar un conjunto de etiquetas
libres a las incidencias. Las incidencias, por defecto, llevan un campo
de este tipo denominado Label y el administrador de JIRA puede crear
campos personalizados adicionales de este tipo.
117
Un ejemplo de etiquetas, AJAX y JQuery, pueden verse en
Figura 5.46. Las etiquetas de JIRA son muy parecidas a las etiquetas

detalle
que pueden verse en un gran nmero de aplicaciones de distintos tipos

como las etiquetas que pueden adjuntarse a un blog post. Los usuarios
con permiso a modificar una incidencia (Edit issues) pueden aadir
etiquetas a una incidencia y este mecanismo es ideal para organizar
las incidencia de una forma ms informal.
En JIRA, los mecanismos alternativos utilizado para organizar incidencias son los componentes y las versiones. Sin embargo, ninguno
de estos dos mecanismos se prestan a que los usuarios puedan organizar las incidencia de forma de acuerdo a los criterios que ellos
mismos establezcan: ambos son una caracterstica de un entero proyecto y solo los administradores y los usuarios que tengan los permisos
adecuados (como los jefes de proyecto) podrn manejar versiones y
componentes. Por otro lado, cualquier usuario que pueda modificar
una incidencia puede asignar etiquetas a la misma y, por lo tanto,
agrupar incidencias utilizando palabras claves.
Las etiquetas, como cualquier otro campo, permiten efectuar bsquedas y filtros utilizando el valor de este campo. Pulsando una
etiqueta en una incidencia de JIRA, adems, el usuario ser llevado
al navegador de incidencias donde se seleccionarn automticamente
todas las incidencias que tengan la etiqueta que se haya seleccionado.
Las etiquetas pueden crearse durante el proceso de creacin de
una incidencia, durante el proceso de modificacin de una incidencia
o utilizando el formulario de gestin de etiquetas de una incidencia.
Para aadir una etiqueta a una incidencia utilizando el formulario de
gestin de etiquetas es necesario efectuar las siguientes operaciones:
(i) Seleccionar la incidencia que se desea etiquetar yendo a su ventana de detalle.
118
5.14. Poner etiquetas a una incidencias

(ii) Seleccionar el control para gestionar etiquetas, identificado con
el icono de un lpiz, a la derecha del campo Labels en el panel
Details.
(iii) En el formulario que aparecer (Figura 5.47), teclear las etiquetas que se desean aadir. Mientras se est tecleando una etiqueta, JIRA propondr al usuario las etiquetas existentes que
coincidan con las letras tecleadas.
Figura 5.47: Formulario de creacin de una etiqueta en una incidencia
(iv) Seleccionar la checkbox Send update notification si se desea que

JIRA enve la notificacin de modificacin de incidencia a los
usuarios.
(v) Confirmar la modificacin pulsando el botn Update.
5.14.1
Eliminar una etiqueta
El procedimiento de para eliminar una etiqueta de una incidencia es

similar al procedimiento de creacin. Una etiqueta puede eliminarse
durante la modificacin de una incidencia o utilizando el formulario
de gestin de etiquetas de una incidencia. Para remover una etiqueta
de una incidencia utilizando el formulario de gestin de etiquetas es
necesario efectuar las siguientes operaciones:
(i) Seleccionar la incidencia que se desea etiquetar yendo a su ventana de detalle.
(ii) Seleccionar el control para gestionar etiquetas, identificado con
el icono de un lpiz, a la derecha del campo Labels en el panel
Details.
(iii) En el formulario que aparecer (Figura 5.47), eliminar las etiquetas que se desean borrar seleccionando con el ratn el control
de eliminacin de etiqueta, identificado con el icono , a la derecha de la etiqueta a borrar.
119
(iv) Seleccionar la checkbox Send update notification si se desea que
JIRA enve la notificacin de modificacin de incidencia a los
usuarios.
(v) Confirmar la modificacin pulsando el botn Update.
5.15
Trabajar sobre una incidencia
JIRA permite mantener un control de horario (time tracking) para

cada incidencia a travs del cual es posible:
(i) Registrar el tiempo estimado para resolver una incidencia.
(ii) Obtener una estimacin del tiempo restante para resolver una
incidencia.
(iii) Registrar el tiempo trabajado en una incidencia con una descripcin del trabajo desempeado.
(iv) Si una incidencia tiene sub-tareas, adems, es posible ver los
tiempos agregados.
Esta informacin puede utilizarse para generar reportes y controlar
los niveles de servicios que se proporcionan a los usuarios.
El administrador puede habilitar la funcionalidad de time tracking a nivel de plataforma. Cuando esta funcionalidad es disponible,
la ventana de detalle de incidencia mostrar un panel, Time tracking,
donde se presentar esta informacin de forma grfica, como ilustrado
en Figura 5.48. La primera barra, la barra azul con la etiqueta Es-
Figura 5.48: Panel Time tracking de una incidencia
timated, indica el tiempo estimado para resolver una incidencia: este

valor es el valor del campo Original estimate y puede establecerse
durante la creacin de una incidencia. Este campo puede modificarse
posteriormente pero antes de que un usuario registre trabajo sobre la
120
5.15. Trabajar sobre una incidencia

incidencia. Si un usuario ha registrado trabajo en una incidencia, el
campo que podr modificarse ser el campo Remaining estimate.
La segunda barra, la barra naranja con la etiqueta Remaining,
indica el tiempo restante estimado para resolver la incidencia. Este valor, tr es el valor del campo Remaining estimate y satisface la
condicin
tr = to tw
(5.8)
donde to es la estimacin original (Original estimate) menos el trabajo
tw trabajado por los operadores. En el caso en que se decida agregar la
informacin de las sub-tareas, cada uno de los valores indicados sern
la suma de los respectivos valores en el conjunto de las sub-tareas:
o Tw
Tr = T
Tr =
tr ()
X
(5.9)
To =
to ()
tw ()
Tw =
La incidencia cuyo panel Time tracking puede verse en Figura 5.48

tena To = 4 d y Tw = 1 d y, por lo tanto, un valor Tr = 3 d.
La tercera barra, la barra verde con la etiqueta Logged, indica el
tiempo tw (o Tw ) que los operadores han registrado como trabajado sobre esta incidencia. JIRA mantendr un registro histrico del
trabajo registrado por los operadores en la plataforma en la pestaa
Work log del panel Activity cuya captura de pantalla puede verse en
Figura 5.49.
Figura 5.49: Pestaa Work log del panel Activity de una incidencia
121
5.15.1
Hacer una estimacin del trabajo requerido
La primera accin que normalmente efectan los operadores, o el jefe

de proyecto que asigna la incidencia, es hacer una estimacin del
tiempo necesario para solucionar la incidencia. Esta estimacin se
registra en el campo Original estimate (Figura 5.50) y puede asumir
valores del tipo xw yd wh zm donde x, y, w y z son, respectivamente,
el nmero de semanas, das, horas y minutos.
Figura 5.50: Campos para la estimacin del trabajo requerido de una

incidencia
Dependiendo de la versin de JIRA y de la configuracin que

el administrador haya establecido, la funcionalidad de time tracking
podra funcionar en modalidad legacy o no. En la modalidad legacy,
el campo Original estimate puede modificarse exclusivamente antes
de que un operador registre en la butaca el primer parte de actividad.
Despus de que un operador haya registrado trabajo, aparecer el
campo Remaining estimate en lugar del campo Original estimate y
solo podr modificarse el valor de este campo.
En las nuevas versiones de JIRA, sin embargo, se ha introducido
una nueva funcionalidad y ambos campos Original estimate y Remaining estimate pueden modificarse despus de que el trabajo sobre una
incidencia haya empezado. Para mantener el comportamiento de las
antiguas versiones de JIRA el administrador puede configurar el time
tracking para funcionar en modalidad legacy en la cual el comportamiento de la plataforma emular el comportamiento de las versiones
antiguas de JIRA.
Los campos Original estimate y Remaining estimate estn por defecto accesibles en la ventana de modificacin de la incidencia. Sin
embargo estos campos, as como cualquier otro campo de JIRA, puede
hacerse disponible en otras pantallas tambin de acuerdo a las configuraciones que haya establecido el administrador a nivel de esquema
de pantallas por tipo de incidencia y de pantallas de transiciones de
flujo de trabajo.
122

5.15.2
Registrar trabajo sobre una incidencia
JIRA permite registrar en el log de actividad de una incidencia el

la cantidad de trabajo desempeado por los operadores con una descripcin de las actividades realizadas. El log de actividad es una herramienta importante para todos los usuarios de la plataforma: jefes
de equipo, operadores y usuarios. Los jefes de equipo podrn, entre
otras cosas, observar el trabajo del equipo y mantener un histrico
de actividades para saber exactamente que actividades han mantenido ocupado un operador en cada momento y cuales incidencias han
generado ms trabajo. Los operadores dispondrn de la historia de
toda actividad llevada a cabo que podrn consultar en cualquier momento en caso de duda, revisin o reapertura de una incidencia. Los
operadores se beneficiarn de esta informacin para detectar las actividades que han resultado ms problemticas durante las resolucin
de las incidencias y ser una informacin valiosa a la hora de estimar y
planificar trabajos futuros. Los usuarios, por otra parte, podrn utilizar esta informacin para observar los trabajos que se desempean
sobre una incidencia mientras esperan su resolucin.
Los operadores pueden registrar el trabajo que van desempeando
a travs del campo denominado Log work. El campo Log work, en
realidad, es un conjunto de campos que permiten:
(i) Registrar el trabajo.
(ii) Efectuar opcionalmente un ajuste sobre la estimacin de trabajo
restante.
(iii) Adjuntar una descripcin del trabajo desempeado.
Por defecto, el campo es accesible a travs de la operacin Log
work en la ventana de detalle de una incidencia. El campo Log work,
como cualquier campo de JIRA, puede aadirse a cualquier pantalla
de acuerdo a las necesidades del proyecto y es una solicitud comn
disponer de este campo en una ventana de transicin de flujo de trabajo, especialmente en las transiciones que implican un trabajo,
como las transiciones de resolucin y cierre de incidencia.
Para registrar trabajo desde la ventana de detalle de incidencia es
(i) Seleccionar la incidencia deseada.
(ii) Seleccionar la operacin Log work en el men More actions.
(iii) Rellenar el formulario Log work presentado al usuario e ilustrado
en Figura 5.51.
123
Figura 5.51: Formulario de registro de trabajo
Aadir seccin sobre

el formato
de intervalos de tiempo
Aadir seccin sobre
el control
calendario
124
(iv) Introducir en el campo Time spent la cantidad de trabajo desempeada. La cantidad de tiempo puede introducirse en el formato
xw yd wh zm detallado en precedencia (??).
(v) En el campo Date started introducir la fecha en la que se comenz la unidad de trabajo a registrar. La fecha puede seleccionarse
utilizando el control calendario al que se puede acceder seleccionando el control, identificado con el icono calendario, a la
derecha del campo.
(vi) El campo Remaining estimate puede utilizarse para efectuar un
ajuste de la estimacin del tiempo restante hasta la resolucin
de la incidencia. En este campo puede seleccionarse una de las
siguientes opciones:
Adjust automatically, para que el tiempo restante se calcule
con tr = to tw .

Leave estimate unset 11 , para no introducir ninguna estimacin.
Use existing estimate of. . . 12 , para que el valor tr no se modifique despus de la introduccin del registro de trabajo
corriente.
Set to. . . , para modificar manualmente la estimacin de
tiempo restante tr . El formato del valor introducido es el
formato xw yd wh zm detallado en precedencia (??).
Reduce by. . . , para reducir manualmente la estimacin de
tiempo restante tr de la cantidad especificada. El formato
del valor introducido es el formato xw yd wh zm detallado
en precedencia (??).
(vii) Introducir opcionalmente la descripcin del trabajo realizado en
el campo Work description.
(viii) Utilizar opcionalmente el control Viewable by, identificado con
el icono candado, para establecer una poltica de seguridad
sobre el registro de trabajo y decidir que usuarios, grupos o
roles de proyecto pueden acceder a l.
(ix) Confirmar la operacin pulsando el botn Log.
Despus de haber creado el registro de trabajo el usuario volver
a la ventana de detalle de incidencia en la cual aparecer el registro
recin creado (en el panel Activity) y las estimaciones del panel Time
tracking se habrn actualizado de acuerdo a la informacin introducida.
En Figura 5.52 puede verse un registro de trabajo y a la derecha
del registro se aprecian los controles que aparecen cuando el ratn se
encuentra encima del mismo. Los controles son similares a los dems
controles de gestin de otras entidades gestionadas por JIRA y el
funcionamiento de cada uno de ellos se explorar en las siguientes
secciones.
5.15.3
Registrar trabajo durante una transicin de estado en el flujo de trabajo
Como explicado en precedencia, el administrador puede aadir el

campo Log work en cualquier pantalla de acuerdo a las necesidades
11 Este campo es disponible solo si la incidencia no tiene todava ninguna estimacin de tiempo necesario para la resolucin.
12 Este campo es disponible solo si la incidencia tiene una estimacin de tiempo
necesario para la resolucin.
125
Figura 5.52: Registro de trabajo con controles de gestin
de los proyectos. Es comn aadir este campo en las pantallas de

transicin de estado hacia el estado Resuelta y Cerrada del flujo de
trabajo de las incidencias: de esta forma los usuarios podrn resolver
una incidencia y registrar el trabajo efectuado en una nica operacin.
En Figura 5.53 puede verse una ventana de resolucin de incidencia
con el campo Log work habilitado.
Figura 5.53: Formulario de registro de trabajo en una ventana de

resolucin de incidencia
Cuando se utiliza el campo Log work en una ventana de transicin de estado de flujo de trabajo, el comportamiento de los campos
Comment y Viewable by. . . dependen de como el administrador haya
126

configurado la funcionalidad de time tracking. Por defecto, JIRA copiar el contenido del campo Comment en la descripcin del registro
de trabajo y proteger el registro con la poltica seleccionada en el
control Viewable by. . . .
Sin embargo el administrador puede inhabilitar esta funcionalidad
y, por lo tanto:
(i) El registro podra ser visible a cualquier usuario que pueda ver
la incidencia.
(ii) La descripcin del registro de trabajo podra estar vaca.
Ambos problemas pueden solucionarse a posteriori modificando el
registro de trabajo creado durante la transicin. Sin embargo es aconsejable solicitar al administrador la habilitacin de la funcionalidad
de copia de comentarios en el registro de trabajo para reducir el nmero de operaciones que el usuario tiene que efectuar y, por lo tanto,
reducir los errores que potencialmente pudieran ocurrir durante la
creacin de registros de trabajo.
5.15.4
Crear un enlace a un registro de trabajo
JIRA permite crear enlaces permanentes (permalink) a un registro de

trabajo. El control identificado con un icono parecido a (5.15.2)
se utiliza para crear un enlace permanente tal y como se detall en
??.
Aadir sec5.15.5
Modificar un registro de trabajo
ciones sobre
permalinks
Un registro de trabajo puede ser modificado despus de su creacin

utilizando el control de modificacin, identificado con un icono lpiz
(5.15.2), del registro de trabajo a modificar. Un usuario necesita
el permiso Edit own work log para modificar un registro de trabajo
creado por l mismo y necesita el permiso Edit all work logs para
modificar los registros de los dems usuarios.
Seleccionando el control de modificacin de registro de trabajo
aparecer la ventana de modificacin. La ventana de modificacin es
una ventana parecida a la ventana Log work descrita en 5.15.2 y las
instrucciones para modificar el registro son parecidas a las instrucciones de creacin de registros detalladas en la seccin citada. Tngase
en cuenta que en la ventana de modificacin no aparecer la opcin
Reduce by. . . del control Remaining estimate y, por lo tanto, se podr
ajustar la estimacin utilizando exclusivamente los dems controles.
127
Despus de haber confirmado la modificacin de un registro de
trabajo el usuario ser llevado a la ventana de detalle de la incidencia
donde estarn reflejadas las modificaciones aportadas al registro, particularmente en las estimaciones de la seccin Time tracking. Para
facilitar su identificacin, los registros de trabajo modificados sern
marcados con la etiqueta edited, como el registro ilustrado en Figura
5.54.
Figura 5.54: Registro de trabajo modificado
5.15.6
Eliminar un registro de trabajo
Un registro de trabajo puede ser eliminado despus de su creacin

utilizando el control de eliminacin, identificado con un icono basura (5.15.2), del registro de trabajo a eliminar. Un usuario necesita
el permiso Delete own work log para eliminar un registro de trabajo
creado por l mismo y necesita el permiso Delete all work logs para
eliminar los registros de los dems usuarios.
Seleccionando el control de eliminacin de registro de trabajo, aparecer la ventana de eliminacin ilustrada en Figura 5.55. Esta ventana es muy parecida a la ventana de creacin de registro cuya funcionalidad se detall en 5.15.2. Durante la eliminacin de un registro
de trabajo se dar la opcin al usuario de ajustar la estimacin de
trabajo restante tr con un subconjunto de las opciones detalladas en
5.15.2 y las siguientes opciones adicionales:
(i) Auto adjust: esta opcin compensa la estimacin tr aumentando su valor con el valor tw del registro de trabajo a borrar.
El valor resultante, tr + tw , ser el mismo valor que tena tr
antes de crear el registro de trabajo.
(ii) Increase estimated time remaining by. . . : esta opcin permite
aumentar tr con un valor introducido por el usuario. La cantidad de tiempo puede introducirse en el formato xw yd wh zm
detallado en precedencia (??).
128
5.16. Mover una incidencia
Figura 5.55: Ventana de eliminacin de registro de trabajo
Despus de haber eliminado un registro de trabajo el usuario ser

llevado a la ventana de detalle de la incidencia donde estarn reflejadas las modificaciones aportadas al registro, particularmente en
las estimaciones de la seccin Time tracking. El registro de trabajo
eliminado desaparecer de la seccin Work log del panel activity y
el nico rastro que quedar del registro en la plataforma sern las
correspondientes entradas en el registro histrico (??) de JIRA.
Aadir sec-
5.16
Mover una incidencia
cin sobre el
registro histrico
JIRA llava migracin la operacin a travs de la cual se cambia el

proyecto al que pertenece una incidencia y/o su tipo de incidencia.
Despus de una reestructuracin de proyectos puede ser conveniente mover incidencias de un proyecto a otro. Un proyecto que ha
ido creciendo con el tiempo, por ejemplo, podra partirse en mltiples
proyectos, cada uno de los cuales con su conjunto distinto de usuarios
y operadores, y las incidencias existentes podran distribuirse entre
los nuevos proyectos de acuerdo a los criterios establecidos durante la
creacin de dichos proyectos.
En otras situaciones, un proyecto podra detectar la necesidad de
crear un nuevo tipo de incidencia y solicitar la creacin y la configuracin de dicho tipo (configuracin de campos, flujo de trabajo, etc.).
Podra darse la necesidad, entonces, de mover (convertir), las incidencias que mientras tanto se hayan ido creando en el nuevo tipo de
incidencia.
129
Una incidencia no puede simplemente moverse de un proyecto
a otro o cambiarse de tipo: cada proyecto puede tener un conjunto
de esquemas de configuracin diferentes y algunos de estos esquemas
podran incluso ser incompatibles el uno con el otro. El conjunto de
tipos de incidencias de un proyecto, por ejemplo, podra no incluir
todos los tipos contemplados en otro proyecto y, por lo tanto, una
incidencia de un tipo que no exista en otro proyecto solo podr moverse efectuando una conversin a otro tipo. An cuando el mismo
tipo de incidencia exista en ambos proyectos, el esquema de campos
asociado en un proyecto podra ser distinto, e incompatible, con el
esquema de campos asociado en el otro proyecto. Dos campos con el
mismo nombre podran ser campos de tipo distinto y, una vez ms,
su valor debera convertirse cuando la incidencia se mueva. En otro
escenario un esquema de campos podra prever como campo opcional
un campo que en el esquema de campos del proyecto de destino se
considera requerido: como consecuencia, cuando se mueva una incidencia habr que rellenar los campos requeridos que estn vacos y
entonces invlidos en el esquema de destino.
Otra fuente de incompatibilidades entre configuraciones de proyectos distintos son los estados personalizados de las incidencias. JIRA
permite definir estados personalizados y utilizarlos en los flujos de
trabajo asociados a un conjunto de tipos de incidencias en un proyecto. Una incidencia de una proyecto podra tener un estado que no
est contemplado en el flujo de trabajo asociado al tipo de incidencia correspondiente en el proyecto de destino. En este caso tambin
se requerir intervencin del usuario para escoger un nuevo estado a
asociar a la incidencia que se est moviendo.
Para facilitar estas labores, JIRA proporciona un asistente que
ayuda el operador a llevar a cabo la labor de migracin de incidencias
y encargndose de detectar posibles incompatibilidades que podran
surgir a raz de la migracin y proponiendo posibles soluciones.
Para mover una incidencia el usuario necesita el permiso Move
issues en el proyecto de origen y, ya que desde el punto de vista de
ste la operacin que se est efectuando es una creacin, el permiso
Create issues en el proyecto de destino.
Para mover una incidencia es necesario efectuar las siguientes operaciones:
(i) Seleccionar la incidencia que se desea mover.
(ii) Seleccionar la operacin Move en el men More actions.
130
5.16. Mover una incidencia

(iii) El usuario ser llevado en la primera ventana del asistente para
la migracin de incidencia, cuya captura de pantalla puede verse
en Figura 5.56. En esta ventana el usuario puede escoger el
Figura 5.56: Asistente de migracin de incidencias Paso 1
proyecto de destino y el tipo de incidencia en el proyecto de

destino.
(iv) Si el estado de la incidencia a mover no es un estado vlido para
el tipo de incidencia seleccionado en el proyecto de destino el
usuario ser llevado a la segunda ventana del asistente (Figura 5.57) en la cual podr seleccionar el nuevo estado para la
incidencia.
(v) Si el asistente detecta que algunos campos de la incidencia en el

proyecto de destino tengan que ser actualizados por el usuario,
el usuario ser llevado a la tercera ventana del asistente (Figura
5.58).
(vi) Cuando todos los datos estn correctamente rellenados, el asistente presentar la ventana de confirmacin (Figura 5.59) en la
131
cual se presentar un resumen de las operaciones que se llevarn

a cabo.
(vii) Confirmar la operacin pulsando el botn Move.

Despus de haber confirmado la operacin, JIRA mover la incidencia al proyecto de destino aplicando todos los cambios especificados por el usuario en el asistente de migracin y el usuario ser
llevado a la ventana de detalle de la incidencia.
5.17
Modificar mltiples incidencias a la vez
En ciertas circunstancias es deseable efectuar una operacin sobre un

grupo de incidencias: eliminacin, migracin de un proyecto a otro o
transicin de flujo de trabajo son operaciones que, a menudo, pueden
efectuarse sobre muchas incidencias a la vez y la posibilidad de hacerlo
reduce el trabajo de los usuarios y la posibilidad de cometer errores
a lo largo del proceso.
132
5.17. Modificar mltiples incidencias a la vez

JIRA permite efectuar operaciones bulk (operaciones masivas) sobre el resultado de una bsqueda y las operaciones permitidas son las
operaciones que ms comnmente se necesitan:
(i)
(ii)
(iii)
(iv)
Transiciones de flujo de trabajo.

Eliminaciones.
Migraciones.
Modificaciones.
Las operaciones masivas de transicin de flujo de trabajo permiten, por ejemplo, resolver un conjunto de bsquedas: si, por ejemplo,
se efecta una labor por la cual un grupo de incidencias resulta resuelto o, por otro lado, se toma la decisin de no resolver un conjunto
de incidencias, se puede efectuar la transicin de flujo de trabajo correspondiente (hacia el estado resuelto o no resuelto) con una nica
operacin.
Las operaciones masivas de eliminacin y migracin permiten, por
ejemplo, de eliminar o migrar a otro proyecto, en una sola operacin,
un grupo de incidencias. Si se decide, por ejemplo, crear proyectos
adicionales para distribuir a distintos equipos (y usuarios) las incidencias de un proyecto existente, esta funcionalidad permitir a los
jefes de proyecto de filtrar las incidencias con los criterios escogidos
y moverlas a los proyectos que correspondan a dicho criterio con una
sola operacin.
De la misma forma, la operacin masiva de modificacin permite
aplicar la misma modificacin a un grupo de incidencias. En el caso
en que se sustituya un operador, por ejemplo, todas las incidencias
a l asociadas podrn asociarse al nuevo operador de forma masiva.
En otra situacin, por ejemplo, un proyecto podra decidir modificar
las incidencias asociadas a una versin determinada a otra versin:
es el caso en que, por necesidades de calendario, se decide entregar
una release de un producto dejando abiertas algunas incidencias que
no se pueden entregar a tiempo: con un filtrado ser posible escoger
las incidencias no resueltas de la versin a entregar y asociarlas, en
una sola operacin, a otra versin futura.
Para efectuar una operacin masiva un usuario necesita tener el
permiso Bulk change. El permiso Bulk change es un permiso global de
JIRA (??) el administrador podr otorgarlo a los grupos de usuarios
seleccionados. Debido a que los permisos de proyecto se comprobarn
durante una operacin masiva, el usuario que efecte una operacin
masiva necesitar tambin el permiso correspondiente a la opera-
Atar
a
global.permission.
133
cin efectuada (como detallado en las secciones anteriores): en el caso
de una operacin masiva de migracin, por ejemplo, el usuario deber tener el permiso global Bulk move y el permiso de proyecto Move
issues.
5.17.1
Inhabilitar las notificaciones durante una operacin masiva
Durante una operacin masiva, el usuario que tenga el permiso de

administrador o administrador de proyecto en todos los proyectos a
los cuales pertenecen las incidencias modificadas podr seleccionar la
opcin Send mail for this update (Figura 5.60): de esta forma las
operaciones que se ejecuten no enviarn correos de notificacin a los
usuarios suscritos.
Figura 5.60: Inhabilitar las notificaciones durante una operacin masiva
Es aconsejable inhabilitar el envo de notificaciones en las situaciones en las cuales dicha notificacin no sea informativa: si, por
ejemplo, se estn migrando incidencias a un nuevo proyecto es probablemente innecesario enviar los correspondientes correos de notificacin a los usuarios13 ya que, verosmilmente, los usuarios estarn al
corriente de la migracin.
5.17.2
Efectuar una operacin masiva
Para efectuar una operacin masiva es necesario efectuar las siguientes

operaciones:
(i) Efectuar una bsqueda en el Navegador de incidencias pare recuperar el grupo de incidencia sobre las cuales efectuar la operacin masiva.
(ii) Seleccionar la operacin Bulk change en el men Tools. Esta
operacin estar disponible exclusivamente a los usuarios que
tengan los permisos requeridos (5.17). En dicha opcin, si el
13 El
nmero de correos recibidos por usuario sera igual al nmero de incidencias modificadas
134
Figura 5.61: Operacin Bulk change en el men Tools
navegador de incidencias devuelve ms de una pgina de resultados (Figura 5.61 izquierda), seleccionar si la operacin masiva
debera efectuarse sobre las incidencias en la pgina de resultados corriente o en todas las incidencias recuperadas. Si la
bsqueda devuelve ms de 1000 resultados, solo se podrn seleccionar las primeras 1000 incidencias devueltas (Figura 5.61
derecha).
(iii) En la pantalla siguiente, la pantalla de seleccin de incidencias,
el usuario podr escoger las incidencias sobre las cuales efectuar
la operacin masiva (Figura 5.62). Si el filtro utilizado no es lo
Figura 5.62: Seleccin de las incidencias sobre las cuales efectuar la

operacin masiva
suficientemente fino, el usuario podr escoger las incidencias

una por una seleccionando el check-box a la izquierda de cada
incidencia. Si el usuario desea seleccionar todas las incidencias,
podr hacerlo utlizando el check-box en la cabecera de la tabla
de resultados.
(iv) En la pantalla siguiente elegir el tipo de operacin masiva a
135
efectuar (Figura 5.63).
Figura 5.63: Seleccin del tipo de operacin masiva
Las dems operaciones a efectuar dependern del tipo de operacin masiva escogido, tal y como se detalla en las siguientes secciones.
5.17.3
Operacin masiva de eliminacin
Si la operacin masiva seleccionada en 5.17.2 es una operacin de

eliminacin, los ltimos pasos del asistente sern decidir si enviar
un correo de notificacin (5.17.1) y la confirmacin de la operacin
(Figura 5.64). Despus de la confirmacin, JIRA eliminar todas las
Figura 5.64: Confirmacin de una eliminacin masiva
incidencias seleccionadas.
136

5.17.4
Operacin masiva de migracin
Si la operacin masiva seleccionada en 5.17.2 es una operacin de

migracin, los siguientes pasos del asistente sern similares a los pasos
detallados en 5.16, a los cuales se hace referencia, y con las diferencias
detalladas a continuacin.
La operacin masiva de migracin, como detallado en 5.16, se
divide en las siguientes sub-operaciones:
(i) Seleccin de incidencias.
(ii) Seleccin de proyecto de destino y de tipo de incidencia para
incidencias de primer nivel y sub-tareas.
(iii) Seleccin de estado de destino para estados que no existan en
los flujos de trabajo de los tipos de incidencias seleccionados en
el proyecto de destino.
(iv) Seleccin de valores para campos obligatorios y campos invlidos.
(v) Confirmacin de la operacin.
La seleccin de incidencias (i) a mover durante una operacin
masiva tiene que tener en cuenta de la relacin padre-hijo entre incidencias de primer nivel y sub-tareas. Por esta razn, si se selecciona
una incidencias de primer nivel y algunas de sus sub-tareas durante
una operacin masiva de migracin y se opta para efectuar una migracin de proyecto, las sub-tareas se movern siempre en el proyecto
especificado para la incidencia padre y la nica transformacin que se
propondr al usuario ser la eleccin de un tipo de incidencia para las
sub-tareas. JIRA avisar el usuario proponiendo una alerta parecida
a la ilustrada en Figura 5.65.
Figura 5.65: Aviso de exclusin de sub-tareas durante una migracin

masiva
El primer paso del asistente de migracin masiva es la seleccin

del proyecto de destino y del tipo de incidencia final (ii) para cada
grupo de incidencias que compartan los valores (proyecto de origen,
tipo de incidencia) como ilustrado en Figura 5.66: para cada uno de
137
Figura 5.66: Seleccin de proyecto y tipo de incidencia de destino en

una migracin masiva
estos grupos JIRA pedir al usuario de escoger las nuevas coordenadas. Como en el caso de la operacin de migracin de una incidencia (5.16), la operacin de migracin masiva puede utilizarse para
mover incidencias dentro del mismo proyecto y efectuar un cambio
de tipo de incidencia. La transformacin de tipo de incidencia solo
aplicar a las incidencias de primer nivel y las sub-tareas sern excluidas automticamente durante el proceso de transformacin. JIRA
tambin permite escoger un destino comn para todos los grupos
utilizando el control Use the above project and issue type pair for all
other combinations que puede verse en Figura 5.66.
En el caso en que se est moviendo un grupo de incidencias con
sub-tareas a otro proyecto, el asistente de migracin podr solicitar al
usuario de escoger el tipo de sub-tarea de destino para las sub-tareas
que sern migradas automticamente con las incidencias de primer
nivel (Figura 5.67).
Figura 5.67: Seleccin de tipo de sub-tarea de destino en una migracin

masiva
El siguiente paso, (iii), es la eleccin del estado de destino. Como

138

explicado en 5.16, JIRA solicitar al usuario de elegir el nuevo estado
para las incidencias que tengan un estado que no exista en el flujo de
trabajo asociado al tipo de incidencia de destino en el contexto del
proyecto de destino. Si los estados de todas las incidencias existen en
el proyecto de destino, JIRA no propondr al usuario est ventana
del asistente de migracin.
Sucesivamente, JIRA propondr al usuario de asignar un valor a
los campos cuyo valor no sea vlido de acuerdo a la configuracin de
campos para el tipo de incidencia de destino escogido (Figura 5.68).
Para cumplir con los requerimientos de las configuraciones de campos
Figura 5.68: Actualizacin de campos de una incidencia en una

migracin masiva
que aplican despus de la migracin, el usuario deber actualizar los

campos invlidos con un nuevo valor y rellenar los campos obligatorios que no tengan un valor asociado. Los valores escogidos sern
utilizados para toda incidencia en el grupo de incidencias que se est
migrando de forma masiva. Para los siguientes tipos de campos, JIRA proporcionar un men desplegable con el cual el usuario podr
escoger uno de los posibles valores vlidos para el campo en cuestin:
(i)
(ii)
(iii)
(iv)
Componente.
Versin afectada.
Versin de resolucin.
Campos personalizados de tipo Version-picker.
Es importante subrayar que, en los campos de tipo versin, ser posible escoger exclusivamente versiones que todava no se hayan archivado. En el caso se necesitase utilizar estos valores ser necesario
des-archivar la versin requerida, efectuar la migracin masiva de incidencias y volver a archivar la versin.
check names
add index
139
Como ejemplo, en Figura 5.68 pueden verse los mens desplegables
proporcionados al usuarios para actualizar los valores de los campos
Versin de resolucin y Componentes.
En algunos casos, para el mismo campo, algunas incidencias tendrn un valor vlido y otras tendrn un valor invlido. El caso ms
frecuente se da cuando un campo de una incidencia es opcional en
la configuracin de salida y obligatorio en la configuracin de destino
ya que podrn existir incidencias que tengan este campo vaco e incidencias con este campo valorizado. En estos casos, el usuario podr
decidir si actualizar todas las incidencias con el nuevo valor o mantener el valor antiguo en las incidencias que lo tengan vlido: para
mantener los valores antiguos vlidos para un campo es necesario seleccionar el check-box Retain que aparece en la ltima columna en la
ventana de actualizacin de campos de Figura 5.68. Este campo estar inhabilitado por los campos de tipo (i)-(iv) ya que estos campos
requieren una relacin explcita.
Despus de haber completado el asistente de migracin, JIRA proporcionar una ventana de confirmacin en la que se resumen todas
las transformaciones que se efectuarn durante la migracin de las
incidencias. Por cada grupo de incidencias con el mismo (proyecto,
tipo de incidencia), JIRA detallar la siguiente informacin (cuando
aplique):
(i) Issue targets: proyecto y tipo de incidencia de destino.
(ii) Workflow: flujo de trabajo de destino y nuevo estado final de
destino.
(iii) Updated fields: nuevos valores para los campos actualizados.
(iv) Removed fields: campos eliminados porque no vlidos en la configuracin de campos de destino.
En Figura 5.69 puede verse una ventana de confirmacin de ejemplo donde se pueden apreciar las secciones (i), (iii) para las incidencias
a mover al tipo Bug y Sub-task del proyecto CC.
Despus de haber confirmado la operacin JIRA migrar todas las
incidencias seleccionadas efectuando las transformaciones especificadas en el asistente de migracin.
5.17.5
Operacin masiva de modificacin
La operacin de modificacin masiva permite modificar un conjunto

de campos de un grupo de incidencias a la vez. Esta operacin es
140
Figura 5.69: Ventana de confirmacin de una migracin masiva
141
til en muchos casos de usos en los cuales el mismo campo necesite
una actualizacin en muchas incidencias a la vez: cambio de usuario
asignado a una incidencia, cambio de un campo de tipo versin de
una incidencia, cambio de componentes, etc. Los campos que pueden
actualizarse durante una operacin masiva de este tipo pueden verse
en Tabla 5.3.
Campos actualizables en una modificacin masiva
Campo
Versin afectada
Usuario asignado
Comentario
Componentes
Fecha lmite
Versin de resolucin
Tipo de incidencia
Prioridad
Reporter
142
Condicin
Proyecto con versiones.
Permiso Edit Issue.
Campo visible en toda configuracin asociada
al campo.
Permiso Assign issue.
al campo.
Permiso Comment issue.
al campo.
Proyecto con componentes.
al campo.
Permiso Edit issue.
al campo.
Permiso Edit issue.
Permiso Schedule issue.
Proyecto con versiones.
al campo.
Permiso Edit issue.
Permiso Edit issue.
al campo.
Permiso Edit issue.
al campo.
Permiso Edit issue.
Permiso Modify reporter.
Contina en la siguiente pgina

Campos actualizables en una modificacin masiva
Campo
Nivel de seguridad
Condicin
al campo.
Todos los proyectos con el mismo esquema de
seguridad de incidencias.
Campo personalizado Campo personalizado existe o
Todas las incidencias son del mismo tipo con
un campo personalizado o
Todas las incidencias son del mismo proyecto
con un campo personalizado de proyecto.
Tabla 5.3: Campos estndar de una incidencia
Un requerimiento adicional que es necesario cumplir si se estn

modificando incidencias cerradas ser que el flujo de trabajo de las
incidencias que se desea modificar permita la modificacin de incidencias cerradas.
Los siguientes campos no podrn modificarse con una operacin
masiva:
(i)
(ii)
(iii)
(iv)
(v)
(vi)
Ficheros adjuntos.
Ttulo.
Descripcin.
Entorno.
Proyecto14 .
Resolucin15 .
add
reference
to
bulk.workflow.transition
Despus de haber seleccionado las incidencias para una operacin

de modificacin masiva, como explicado en 5.17.2, las operaciones a
realizar en el asistente de migracin son las siguientes:
(i) Seleccin de los campos a modificar y modificacin de su valor.
(ii) Revisin de los cambios y confirmacin de la operacin.
14 Un grupo de incidencias pueden moverse de un proyecto a otro con una
operacin masiva de migracin como detallado en 5.17.4.
15 Puede efectuarse una transicin de flujo de trabajo para un grupo de incidencias con una operacin masiva de transicin de flujo de trabajo como detallado
en ??
143
La seleccin de campos a modificar (i) se efecta en la ventana de
modificacin de campos del asistente de migracin ilustrada en Figura
5.70. En esta ventana JIRA propondr la usuario la lista de campos
que se pueden modificar en el grupo de incidencias seleccionadas. El
usuario puede seleccionar los campos a modificar utilizando el checkbox en la columna izquierda y escoger el nuevo valor utilizando los
controles de edicin en la columna derecha. Dependiendo del tipo de
campo escogido JIRA proporcionar el editor correspondiente. En la
ventana de Figura 5.70, por ejemplo, puede verse un men desplegable
para escoger el nivel de seguridad de las incidencias, un campo de
texto libre para el campo Comentario y un campo de seleccin de
usuarios para el campo Reporter. Para las operaciones masivas de
modificacin puede utilizarse el control descrito en 5.17.1 y visible
en figura para decidir si enviar una notificacin de modificacin a los
usuarios.
Despus de haber modificado todos los campos que se desean modificar y pulsado el botn Next JIRA llevar el usuario a la ventana
de confirmacin donde puede verse un resumen de las modificaciones
que se efectuarn. En Figura 5.71 puede verse un ejemplo de ventana de modificacin masiva en la cual se detalla la actualizacin del
campo Nivel de seguridad de las incidencias al valor Silver.
Pulsar el botn Confirm se confirmar la operacin y JIRA aplicar las modificaciones elegidas a todas las incidencias seleccionadas.
5.18
Registro histrico de cambios de una incidencia
Muchas de las operaciones efectuadas por los usuarios de JIRA se

graban en el registro histrico de cambios. Algunas de las operaciones
que generan una entrada en el registro histrico de cambios de una
incidencias son:
(i)
(ii)
(iii)
(iv)
(v)
(vi)
Modificacin de un campo.
Subida de un fichero adjunto.
Creacin de un enlace entre incidencias.
Eliminacin de un comentario.
Eliminacin de un registro de trabajo.
Eliminacin de un enlace entre incidencias.
Para cada uno de los eventos que han desencadenado la grabacin

de un registro de cambios JIRA almacena la siguiente informacin:
(i) El usuario que ha realizado el cambio.
144
5.18. Registro histrico de cambios de una incidencia
Figura 5.70: Ventana de modificacin de campos en una operacin de

modificacin masiva
145
Figura 5.71: Ventana de modificacin de campos en una operacin de

modificacin masiva
(ii) La hora en la que se ha realizado el cambio.

(iii) Si el cambio es la modificacin de un campo, los valores del
campo antes y despus de la modificacin.
El registro de cambios puede consultarse en la pestaa History del
panel Activity en la ventana de detalle de la incidencia cuyo registro se
desea consultar. El registro no se pueden manipular y es informacin
de sola lectura. En Figura 5.72 se ilustra una seccin del registro de
cambios de una incidencia de ejemplo.
146
5.19. Integracin de JIRA con otras aplicaciones

5.19
Integracin de JIRA con otras aplicaciones
Uno de los objetivos de JIRA es convertirse en el centro de gravedad

de las actividades que orbitan alrededor de las actividades del proceso
de desarrollo y de mantenimiento. Por esta razn, la plataforma ofrece
mltiples herramientas que pueden utilizarse a la hora de efectuar
actividades tales como a) la integracin de aplicaciones externas, b) la
extensin de la plataforma, c) la utilizacin de la plataforma como
fuente de datos.
En el caso se estn utilizando otros productos de Atlassian, sin
embargo, la integracin entre ellos es garantizada out-of-the-box y el
mecanismo se conoce por el nombre de application links 16 . Un enlace entre aplicaciones, establecido por el administrador de sistemas,
establece una relacin de confianza entre las dos aplicaciones relacionadas entre s, lo cual permite a cada una de ellas de utilizar datos
procedente de la otra. JIRA, as como otros productos de Atlassian,
integran en su interfaz de usuario muchas funcionalidades construidas
encima de este mecanismo tales como las pestaas Source de la ventana de detalle de una incidencia, que presenta informacin procedente
de FishEye.
En las siguientes secciones se detallarn las funcionalidades opcionales de este tipo ofrecidas por JIRA en el mbito de la gestin de
las incidencias:
(i) Creacin de enlaces entre incidencias en instancias de JIRA distintas.
(ii) Creacin de enlaces entre incidencias y pginas de Confluence.
(iii) Creacin de enlaces entre incidencias y recursos identificados
por URL.
(iv) Obtencin de informacin sobre revisiones de Crucible.
(v) Obtencin de informacin sobre changesets de FishEye.
(vi) Obtencin de informacin sobre builds de Bamboo.
5.19.1
Crear enlaces a incidencias en otras instancias de

JIRA
Si el administrador de JIRA ha creado por lo menos un enlace a

otra instancia de JIRA, los usuarios podrn establecer enlaces entre
incidencias en diferentes sistemas.
16 Llamados
enlaces entre aplicaciones en la presente gua.
147
Para establecer un enlace con una incidencia en otra instancia de
JIRA es necesario efectuar las siguientes operaciones:
(i) Utilizar el procedimiento detallado en 5.11 para acceder a la
ventana de creacin de enlace entre incidencias.
(ii) Seleccionar el botn17 Remote JIRA issue en la ventana de creacin de enlaces ente incidencias.
(iii) Opcionalmente18 , efectuar el procedimiento de login en la instancia remota de JIRA haca la cual se desea establecer un enlace entre incidencias.
(iv) Si el administrador ha configurado mltiples enlaces de aplicacin, ser necesario seleccionar la instancia de JIRA remota que
se desea utilizar en el men desplegable Server.
(v) Seleccionar el tipo de enlace a establecer en el men desplegable
This issue.
(vi) Introducir el identificador de la incidencia que se desea enlazar19 .
(vii) Seleccionar el check box Create reciprocal link si se desea crear
el enlace inverso en la instancia remota de JIRA.
(viii) Utilizar los dems pasos del procedimiento detallado en 5.11
para terminar la configuracin del enlace.
Es importante tener en cuenta que, durante la creacin de un
enlace entre incidencias en distintos sistemas, cada instancia de JIRA
tendr potencialmente dos conjuntos de permisos distintos para el
usuario que est efectuando la operacin. Es posible, por lo tanto, que
la operacin de creacin de enlace pueda no terminar con xito debido
a una limitacin de permisos del usuario en cuestin. Los enlaces
entre aplicaciones, adems, tambin tienen una direccin: es posible
por lo tanto, que no se pueda crear el enlace inverso en determinadas
circunstancias, de acuerdo a como el administrador de JIRA haya
configurado dicho enlace. En todo caso, el usuario ser avisado del
problema con un mensaje de error coherente.
17 Dicho control solo estar disponible si el administrador de JIRA ha establecido por lo menos un enlace con una instancia remota de JIRA.
18 Este paso ser necesario solo si el administrador de JIRA ha configurado el
enlace entre las aplicaciones con autenticacin de tipo OAuth.
19 Durante la creacin de enlaces entre incidencias en distintas instancias de
JIRA el campo no soporta el completamento automtico de los identificadores.
Es necesario, por lo tanto, conocer exactamente el identificador de la incidencia a
enlazar.
148

5.19.2
Enlaces a pginas de Confluence
Como explicado en 5.19.1, JIRA puede integrarse con otros productos de Atlassian y actuar como hub, agregando y manejando informacin procedente de distintas fuentes. Confluence, el enterprise wiki de
Atlassian, se utiliza a menudo para documentar un producto, incluso
para detallar de forma ms extensa la informacin relacionada con
una incidencia. Es deseable, por lo tanto, que pueda enlazarse una
incidencia con una pgina de Confluence (y vice versa). Esta funcionalidad estar disponible solo si el administrador ha establecido un
enlace de aplicaciones entre JIRA y por lo menos una instancia de
Confluence.
Para enlazar una incidencia a una pgina de Confluence es necesario efectuar las siguientes operaciones:
(ii) Seleccionar el botn20 Confluence Page en la ventana de creacin de enlaces ente incidencias.
(iii) Si el administrador ha configurado mltiples enlaces de aplicacin a instancias de Confluence, ser necesario seleccionar la
instancia de Confluence remota que se desea utilizar en el men
desplegable Server.
(iv) Especificar la pgina de Confluence que se desea enlazar como
explicado a continuacin.
(v) Utilizar los dems pasos del procedimiento detallado en 5.11
Para especificar la pgina de Confluence que se desea enlazar, es
necesario utilizar uno de los siguientes mtodos:
(i) Introducir el URL21 de la pgina a enlazar en el campo Page
URL.
(ii) Buscar la pgina a enlazar utilizando la ventana de bsqueda
que aparece pulsando el enlace Search for a page. Los campos
Search pueden utilizarse para filtrar los resultados de bsqueda
utilizando los criterios especificados.
20 Dicho control solo estar disponible si el administrador de JIRA ha establecido por lo menos un enlace con una instancia Confluence.
21 El URL tiene que ser calificado: http://conf-server/display/etc/etc.
149
Es importante tener en cuenta que, durante la creacin de un
enlace entre incidencias en distintos sistemas, la instancia de JIRA y
la instancia de Confluence tendrn potencialmente dos conjuntos de
permisos distintos para el usuario que est efectuando la operacin.
Es posible, por lo tanto, que la operacin de creacin de enlace pueda
no terminar con xito debido a una limitacin de permisos del usuario
en cuestin. En todo caso, el usuario ser avisado del problema con
un mensaje de error coherente.
5.19.3
Enlaces a pginas web
El ltimo tipo de contenido que JIRA permite enlazar a una incidencia es un contenido genrico identificado simplemente por un URL.
De esta forma los usuarios podrn enlazar una incidencia a cualquier
tipo de recurso accesible utilizando un URL, tales como a) pginas
web relacionadas con la incidencia en cuestin, b) archivos de configuracin, c) documentacin de APIs.
Para enlazar una incidencia a un recurso identificado por una URL
es necesario efectuar las siguientes operaciones:
(ii) Seleccionar el botn Web link.
(iii) Introducir el URL del recurso a enlazar.
(iv) Introducir la descripcin del enlace establecido en el campo Link
text.
(v) Utilizar los dems pasos del procedimiento detallado en 5.11
5.19.4
Revisiones de Crucible
En la ventana de detalle de una incidencias es posible obtener informacin relativa a sus revisiones de Crucible y, por lo tanto:
(i)
(ii)
(iii)
(iv)
(v)
(vi)
150
Examinar el mensaje de commit.

Examinar la lista de files en el commit.
Examinar las diferencias y la historia de cada file.
Acceder a cada file.
Crear una revisin de Crucible.
Ver el estado de una revisin de Crucible.

Para ver las revisiones de una incidencia es necesario efectuar las
siguientes operaciones:
(i) Acceder a la ventana de detalle de la incidencia en cuestin.
(ii) Seleccionar la pestaa Reviews en el panel Activity.
En la pestaa Reviews aparecer la informacin relativa a las revisiones de Crucible de la incidencia seleccionada, como ilustrado en
Figura 5.73.
Figura 5.73: Incidencia Revisin de Crucible
5.19.5
Changesets de FishEye
En la ventana de detalle de la incidencia es posible obtener informacin relativa a los changesets de FishEye, en el caso en que se est
utilizando un sistema de versionado de cdigo fuente visible a FishEye
y, por lo tanto:
(i)
(ii)
(iii)
(iv)
(v)
(vi)
Examinar el mensaje de commit.

Examinar la lista de files en el commit.
Examinar las diferencias y la historia de cada file.
Acceder a cada file.
Crear una revisin de Crucible.
Ver el estado de una revisin de Crucible.
Las incidencias se relacionan con las incidencias buscando en el

mensaje de commit el identificador de la incidencia. La expresin
regular con la cual se efecta esta bsqueda es la siguiente:
151
(^|[^a-zA-Z0-9-])
Para que se relacionen correctamente incidencias e commits es necesario, por lo tanto, asegurarse que:
(i) El mensaje de commit comience con el cdigo de la incidencia.
(ii) Si no es as, que el carcter que precede y el carcter que sigue el
cdigo de la incidencia no sea una letra (mayscula o minscula)
entre a y z, un nmero entre 0 y 9 o un guin (-).
Para ver los changesets de FisyEye de una incidencia es necesario
(ii) Seleccionar la pestaa Source en el panel Activity.
En la pestaa Source aparecer la informacin relativa a los changesets de FishEye de la incidencia seleccionada, como ilustrado en
Figura 5.74.
Figura 5.74: Incidencia Changesets de FishEye
152
5.20. Observar y votar una incidencia

5.19.6
Builds de Bamboo
En la ventana de detalle de la incidencia es posible obtener informacin relativa a los builds de Bamboo, en el caso en que se est
utilizando el sistema de construccin e integracin continua Bamboo
y, por lo tanto:
(i) Examinar el nombre del build y del plano de build.
(ii) Examinar la fecha de ltima ejecucin del plan de build.
(iii) Examinar informacin relativa al build, tal como builds relacionados, estado del build y duracin del build.
(iv) Examinar las etiquetas del build.
(v) Examinar los enlaces a artefactos del build.
Para ver los builds de Bamboo de una incidencia es necesario
(ii) Seleccionar la pestaa Builds en el panel Activity.
En la pestaa Builds aparecer la informacin relativa a los buidls
de Bamboo de la incidencia seleccionada, como ilustrado en Figura
5.75.
5.20
Observar y votar una incidencia
Uno de los mecanismos proporcionado por JIRA para facilitar la comunicacin y la colaboracin entre usuarios es el mecanismo de los
votos y de los watch (vigilancia).
Los votos permiten a los usuarios dar una preferencia a una
incidencia para comunicar a los operadores su inters a que la incidencia se solucione y los operadores, por otra parte, pueden utilizar
esta informacin para priorizar la resolucin de las incidencias.
Los watch permiten a los usuarios suscribirse a las notificaciones
de actualizacin de la incidencia. Cada vez que la incidencia sea
modificada, siempre el proyecto est configurado con un esquema de
notificacin, los usuarios recibirn los correos electrnicos generados
por los eventos de modificacin de la incidencia vigilada.
El nmero de usuarios que han votado y que estn vigilando una
incidencia puede verse en el panel People (Personas) en la ventana de
detalle de la incidencia, como ilustrado en Figura 5.76. La incidencia
153
Figura 5.75: Incidencia Builds de Bamboo
Figura 5.76: Panel de Personas en la ventana de detalles de incidencias
154
5.20. Observar y votar una incidencia

ilustrada ha sido votada por un usuario y est siendo vigilada por un
usuario.
Cuando se est visualizando una incidencia que no se ha votado,
el enlace que indica el nmero de votos tendr la etiqueta Vote; posicionando el ratn encima de este enlace un icono verde con el smbolo
"+" se solapar al icono con el pulgar levantado y pulsando el enlace
el usuario podr votar instantaneamente a la incidencia seleccionada.
Por otra parte, cuando se est visualizando una incidencia qua ya se
ha votado, el enlace que indice el nmero de votos tendr la etiqueta
Voted; posicionando el ratn encima de este enlace un icono rojo con
el smbolo "" se solapar al icono con el pulgar levantado y pulsando el enlace el usuario podr eliminar instantaneamente el voto a la
incidencia seleccionada. El mismo mecanismo se utiliza para observar o dejar de observar a una incidencia: en este caso se seleccionar
el enlace Watching para comenzar o dejar de observar la incidencia
seleccionada. En Figura 5.77, en la imagen a la izquierda puede verse
el enlace Vote seleccionado en una incidencia que no se ha votado y
en la imagen a la derecha puede verse el enlace Voted seleccionado en
una incidencia que se ha votado.
Figura 5.77: Panel de Personas en la ventana de detalles de incidencias
Un usuario con el permiso necesario para ver la lista de usuarios

que han votado y/o vigilado una incidencia, el permiso View voters
and watchers, puede utilizar el enlace que indica el nmero de usuarios
que han votado o observado una incidencia para acceder a la ventana
de gestin de Voters (votantes) y Watchers (observadores), ilustrada
en Figura 5.78. En esta ventana de gestin el usuario podr ver la
lista de usuarios que han expresado su voto o que se han suscrito a
las notificaciones.
Un usuario que tenga el permiso Manage watcher list podr utilizar la ventana de gestin de Watchers para modificar la lista de
usuarios que estn observando la incidencia, aadiendo o eliminando
155
Figura 5.78: Ventana de gestin de Watchers de una incidencia
usuarios de la lista de suscritos.
156
6
Buscar y filtrar incidencias
JIRA proporciona herramientas para la bsqueda y el filtrado de incidencias poderosas y fcil de utilizar. Las dos herramientas de bsqueda proporcionadas por la plataforma son la bsqueda rpida y el
navegador de incidencias. La bsqueda rpida permite efectuar bsquedas rpidas tecleando el criterio de bsqueda en un control que se
encuentra en el rincn superior derecho de la barra de herramientas de
JIRA (Figura 6.19). El navegador de incidencias es una herramienta
orientada a la creacin de bsquedas complejas a travs de una interfaz grfica (interfaz de bsqueda simple) u, opcionalmente, utilizando
el lenguaje de query de JIRA (interfaz de bsqueda avanzada).
La interfaz web de la bsqueda simple del Navegador de incidencias permite a un usuario utilizar criterios de bsqueda que tengan
en cuenta de los campos estndar proporcionados por JIRA y de los
campos personalizados creado por el usuario.
El nico lmite del navegador de incidencias, en cuanto a construccin de criterios de bsqueda, es el hecho que cuando se construyen
criterios mltiples utilizando los distintos controles de la interfaz
del navegador de incidencias, la query resultante es la proposicin lgica que concatena todos los criterios con el operador (and). Si,
por ejemplo, se selecciona para el estado s el valor Open (Abierta) y
para la resolucin r el valor Wont fix (No se resolver) en la interfaz
del navegador, la query resultante ser
(s = Open) (r = Won0 t fix)
(6.1)
que, probablemente, no es la query deseada y devolver casi siempre

ningn registro. Si el usuario desease ejecutar la query
(s = Open) (r = Won0 t fix)
(6.2)
157
6. Buscar y filtrar incidencias

no podr utilizar la interfaz de bsqueda simple y deber recurrir a
la interfaz de bsqueda avanzada (7), en la cual el usuario puede
construir queries de cualquier complejidad utilizando el lenguaje de
query de JIRA. No obstante, en la mayora de los casos se podr
utilizar la interfaz de la bsqueda simple para construir fcilmente
los varios criterios que componen la bsqueda y utilizar la interfaz de
bsqueda avanzada para cambiar solo los operadores lgicos que los
relacionan, como explicado en 6.1.7.
Las queries creadas por los usuarios podrn grabarse en filtros
(??) que podrn utilizarse para repetir la bsqueda y como fuente
de datos para otros componentes como gadgets del cuadro de mandos,
reportes y otros plugins.
Para acceder al navegador de incidencias es necesario pulsar el enlace Issues de la barra de herramientas de JIRA. Por defecto, el navegador de incidencias se abre en la ltima bsqueda o filtro utilizado
en la sesin de usuario corriente: para efectuar una nueva bsqueda
es necesario seleccionar la pestaa New en la barra a la izquierda de
la pgina.
6.1
Bsquedas simples
El navegador de incidencias permite definir criterios de bsqueda de

forma sencilla utilizando una intuitiva interfaz grfica. La parte izquierda de la ventana ofrece un conjunto de controles que, dependiendo del tipo de campos asociados, permiten escoger o introducir
los valores con los cuales se desea filtrar las incidencias. Los controles
estn organizados en paneles que dividen los controles en categorias formadas por controles afines. Los paneles disponibles en el
navegador de incidencias son los siguientes:
(i)
(ii)
(iii)
(iv)
(v)
(vi)
Panel principal de bsqueda.

Components/Versions.
Issue attributes.
Dates and times.
Work ratio.
Custom fields.
Como regla general, JIRA construir una query construyendo una

proposicin que relaciona los criterios generados por cada panel con
el operador lgico (and). Si el usuario rellena campos de bsqueda
en un conjunto de paneles, llamando {pi , i [0, n]} el conjunto de
158
6.1. Bsquedas simples

fragmentos de query generados por cada panel, la query resultante
ejecutada por JIRA ser:
p0 p1 pn
(6.3)
En general, mltiples controles dentro del mismo panel tambin generarn fragmentos relacionados con el operador aunque existen
excepciones que se detallarn ms adelante en la descripcin de cada
panel. En el caso de los controles que permiten seleccin mltiple
de los elementos de una lista, como el control Status, JIRA generar
un fragmento de query de tipo in: si {si , i [0, n]} son los estados
seleccionados, JIRA crear el fragmento de query correspondiente al
criterio:
s {si , i [0, n]}
(6.4)
Este criterio, conceptualmente, equivale a la siguiente proposicin:
(s = s0 ) (s = s1 ) (s = sn )
6.1.1
(6.5)
Panel principal de bsqueda
El panel principal de bsqueda (i), ilustrado en Figura 6.1 (izquierda), ofrece como funcionalidad el filtrado de incidencias por proyecto,
por tipo de incidencia y por palabra clave en algunos campos estndar detallados a continuacin. En el control Query el usuario puede
introducir texto libre que JIRA buscar en los campos seleccionados a
travs de los controles de tipo check-box que estn debajo del control
Query:
(i)
(ii)
(iii)
(iv)
Ttulo.
Descripcin.
Comentarios.
Entornos.
La seleccin de mltiples campos de bsqueda {ci , i [0, n]} durante

la bsqueda de una cadena x se traduce en una query del tipo:
x {ci , i [0, n]} = (c0 = x) (c1 = x) (cn = x)
(6.6)
y, por lo tanto, JIRA devolver las incidencias en las cuales almenos

uno de los campos seleccionados satisfaga el filtro de bsqueda.
Los controles Project y Issue type permiten seleccionar el proyecto y el tipo de incidencias que se desean filtrar. Estos dos componentes permiten efectuar selecciones mltiples (que indicaremos
159
Figura 6.1: Paneles de bsqueda del navegador de incidencias 1
{pi , i [0, n]} y {ti , i [0, m]}) entre los valores propuestos y los
criterios generados sern respectivamente
p {pi , i [0, n]} = (p = p0 ) (p = pn )
(6.7)
t {ti , i [0, m]} = (t = t0 ) (t = tm )
(6.8)
y
Esto significa que JIRA devolver las incidencias que pertenezcan a
uno de los proyectos seleccionados1 y cuyo tipo sea uno de los tipos
escogidos2 .
1 Debido a que una incidencia solo puede pertenecer a un proyecto, no tendra
sentido una bsqueda que ha la interseccin de mltiples proyectos.
2 Una incidencia slo puede ser de un tipo.
160

Cuando se utilizan los tres controles de este panel a la vez, los
criterios generados por cada control se juntarn en una preposicin
utilizando el operador lgico (and):
x {ci , i [0, n]} p {pi , i [0, k]} t {ti , i [0, m]} =
((c0 = x) (cn = x)) ((p = p0 ) (p = pk ))
((t = t0 ) (t = tm )) (6.9)
Esto es, JIRA devolver las incidencias que cumplan los criterios de
bsqueda establecidos en cada control del panel a la vez.
Es importante subrayar que, dependiendo de la seleccin corriente
en los controles Project y Issue type, otros paneles del navegador de
bsqueda podran necesitar ser recargados para que los datos en ellos
contenidos reflejen los datos relativos a los proyectos y a los tipos de
incidencias seleccionados. JIRA informar el usuario que es necesario
recargar el navegador de bsqueda utilizando un mensaje parecido al
ilustrado en Figura 6.2. Pulsando el enlace Refresch search en el
Figura 6.2: Navegador de incidencias Aviso de refresco
mensaje el navegador de incidencias actualizar sus paneles de bsqueda para reflejar los valores relativos a la nueva seleccin.
6.1.2
Panel de bsqueda por componentes y versiones
El panel de bsqueda Components/Versions (ii), ilustrado en Figura

6.3 (izquierda), permite efectuar bsquedas por componentes y versiones. El panel proporciona un conjunto de controles, Fix for, Components y Affects versions, que permiten efectuar bsquedas filtrando
por lo campos asociados a los controles. Los controles mencionados
161
Figura 6.3: Paneles de bsqueda del navegador de incidencias 2
aparecern cuando se est efectuando una bsqueda en proyectos que

posean informacin asociada a los campos en cuestin: si un proyecto est asociado con un esquema de configuracin de campos que no
prev la utilizacin de los campos de versin para ningn tipo de incidencias, los controles correspondientes no aparecern en el navegador
de incidencias.
Los controles Fix for y Affects versions permiten filtrar las incidencias utilizando las versiones especificadas en la lista y los siguientes
valores:
(i) Any: Cualquier valor.
(ii) No version: Incidencias que no especifiquen ningn valor para
este campo.
(iii) Unreleased version: Incidencias cuyo campo especifique una versin que no haya sido entregada.
El control Components permiten filtrar las incidencias utilizando
los componentes especificados en la lista y los siguientes valores:
(i) Any: Cualquier valor.
(ii) No components: Incidencias que no estn asociadas a ningn
componente.
Los controles en este panel son controles que permiten seleccionar
mltiples entradas de la lista de opciones propuestas: en este caso
tambin, el criterio de bsqueda generado ser un criterio de tipo in
162

y JIRA devolver las incidencias cuyo campo contenga uno de los
valores escogidos en la lista.
6.1.3
Panel de bsqueda por atributos de incidencia
El panel de bsqueda por atributos de incidencias (iii), ilustrado en

Figura 6.1 (centro), contiene controles que permiten filtrar las incidencias utilizando los siguientes campos:
(i)
(ii)
(iii)
(iv)
(v)
(vi)
Reporter: usuario que ha reportado la incidencia.

Assignee: usuario asignado a la incidencia.
Status: estado de la incidencia.
Resolutions: resolucin de la incidencia.
Priorities: prioridad de la incidencia.
Labels: etiquetas de la incidencia.
Los campos Reporter y Assignee tienen un funcionamiento muy

similar y permiten filtrar las incidencias utilizando uno de los criterios
proporcionados en el men desplegable del control (Figura 6.4):
(i) Any user: Cualquier usuario.
(ii) No reporter/Unassigned: La incidencia no est asociada a ningn reporter o no est asignada a ningn usuario.
(iii) Current user: El usuario que est efectuando la bsqueda.
(iv) Specify user: El usuario especificado.
(v) Specify group: El grupo especificado.
Figura 6.4: Navegador de incidencias Campos Reporter y Assignee
Si se selecciona la opcin Specify user o Specify group, el usuario podr especificar el usuario o el grupo con el cual filtrar introducindolo
en el campo de seleccin de usuario o grupo debajo del control, como ilustrado en Figura 6.5. Los campos de seleccin de usuarios
y grupos de JIRA son campos de textos que, segn el usuario va
163
Figura 6.5: Navegador de incidencias Campos Reporter y Assignee
Add
section
to user picker
fields
tecleando el nombre de la entidad, van sugiriendo al operador los posibles nombres que satisfagan el texto insertado hasta el momento.
Si se prefiere, se puede escoger un usuario (o un grupo) utilizando
la ventana de seleccin de usuarios (o de grupos) a la cual se accede
pulsando el control identificado con el icono hombre a la derecha
del campo de seleccin de usuario.
Los controles Status, Resolutions y Priorities son controles con
seleccin mltiple que recogen todos los estados, resoluciones y prioridades definidos en el conjunto de proyectos y tipos de incidencia
seleccionados. El criterio de bsqueda generado por estos controles
ser un criterio de tipo in y JIRA devolver las incidencias cuyo campo contenga uno de los valores escogidos en la lista.
El control Labels es un campo de texto libre que permite filtrar
las incidencias especificando las etiquetas a buscar. Un mtodo alternativo y ms rpido para buscar las incidencias que compartan una
etiqueta con una incidencia que se est observando en la ventana de
detalle ha sido descrito en 5.14.
6.1.4
Panel de bsqueda por fechas
El panel de bsqueda por fechas (iv), ilustrado en Figura 6.1 (derecha), permite filtrar las incidencias utilizando un grupo de controles
asociados a los correspondientes campos de tipo fecha:
(i)
(ii)
(iii)
(iv)
Fecha
Fecha
Fecha
Fecha
de creacin.
de ltima actualizacin.
lmite de resolucin.
de resolucin.
Los controles de este panel estn divididos en cuatro grupos, uno

por cada uno de los tipos de fecha, y en cada grupo se encuentra:
164

(i) Un control, llamado . . . After, que acepta una fecha absoluta.
(ii) Un control, llamado . . . Before, que acepta una fecha absoluta.
(iii) Un control, llamado From, que acepta una fecha relativa.
(iv) Un control, llamado To, que acepta una fecha relativa.
El principio de funcionamiento de cada grupo de controles es idntico al funcionamiento del grupo Fecha lmite de resolucin, cuyo funcionamiento se detall en 5.12.1 y que se resume a continuacin.
Los controles del tipo . . . After y . . . Before aceptan fechas
absolutas y pueden utilizarse para efectuar bsquedas por valores exactos; llamando t0 y t1 los valores introducidos por el usuario, xa el
campo . . . After, xb el campo . . . Before y x el valor del campo asociado al grupo de controles en cuestin, pueden realizarse las
siguientes bsquedas:
Update 5.12.1
to reflect the
existence of this
chapter
(i) Buscar las incidencias que satisfagan x = t0 , poniendo:

xa = xb = t0
(6.10)
(ii) Buscar las incidencias que satisfagan x t0 , poniendo:

xb = t 0
(6.11)
(iii) Buscar las incidencias que satisfagan x t0 , poniendo:

xa = t 0
(6.12)
(iv) Buscar las incidencias que satisfagan t0 x t1 , poniendo:

(
xa = t0
xb = t1
Los controles From y To permiten hacer bsquedas por intervalos
temporales relativos a la fecha actual. Las bsquedas que se pueden efectuar son las mismas detalladas en los elementos de la lista
precedente con la diferencia que los tiempos t0 y t1 se expresan con
cantidades relativas al instante en el que se efecta la bsqueda. El
formato aceptado en los campos de tipo fecha relativa es xw yd wh
zm donde x, y, w y z son, respectivamente, el nmero de semanas,
das, horas y minutos. El signo del campo indica si la cantidad de
tiempo indicada es relativa a un instante en el futuro o en el pasado:
Add
section
about
the
relative
time
format.
165

un campo con el tiempo positivo (con el signo +) indicar un instante en el futuro y un campo con el tiempo negativo (con el signo )
indicar un instante en el pasado.
En cada grupo de controles de tipo fecha podrn utilizarse unos
asistentes para rellenar el valor de dichos campos, tanto para los campos con fechas absolutas como para los campos con fechas relativas:
los asistente se podrn abrir utilizando el control identificado con el
icono calendario a la derecha del campo que se desea modificar.
Los asistentes para campos de tipo fecha absoluta son controles de
tipo calendario que permiten introducir una fecha seleccionndola en
un calendario (Figura 5.40). Los asistentes para campos de tipo fecha relativa son ventanas que ofrecen varias opciones intuitivas para
rellenar los campos From y To utilizando opciones tales como:
(i) Fecha anterior al instante especificado.
(ii) Fecha posterior al instante especificado.
(iii) Fecha en el intervalo especificado.
En Figura 5.41 puede verse la ventana del asistente para el grupo
de controles Fecha lmite de resolucin y en Figura 6.6 la ventana
para el grupo de controles Fecha de creacin. Los asistente de los
Figura 6.6: Formulario para la creacin de un criterio de bsqueda por

fecha de creacin con intervalos temporales relativos.
166

dems grupos de controles son similares a los asistentes ilustrados y
el principio de funcionamiento es idntico al detallado en esta seccin.
6.1.5
Panel de bsqueda por porcentaje de trabajo realizado
El panel de bsqueda por porcentaje de trabajo realizado (v), ilustrado en Figura 6.3 (derecha), permite filtrar las incidencias utilizando
como criterio el porcentaje de trabajo realizado:
w=
wr
100
wt
(6.13)
donde wr es el trabajo realizado y wt es el trabajo estimado total. En

este panel pueden utilizarse dos controles, Min y Max, para realizar
las siguientes bsquedas:
(i) Bsqueda de incidencias con porcentaje de trabajo realizado
w = w0 , poniendo:
wmin = wmax = w
(6.14)
(ii) Bsqueda de incidencias con porcentaje de trabajo realizado

w w0 , poniendo:
wmax = w
(6.15)
(iii) Bsqueda de incidencias con porcentaje de trabajo realizado
w w0 , poniendo:
wmin = w
(6.16)
(iv) Bsqueda de incidencias con porcentaje de trabajo realizado
w0 w w1 , poniendo:
(
wmin = w0
wmax = w1
6.1.6
Panel de bsqueda por campos personalizados
El panel de bsqueda por campos personalizados (v), ilustrado en

Figura 6.3 (derecha), permite filtrar las incidencias utilizando los
campos personalizados que el administrador haya configurado en el
contexto de un proyecto.
Los controles relativos a los campos personalizados aparecern en
este panel solo despus de haber seleccionado un contexto vlido: un
167
add documentation about JIRA field types
proyecto, en el caso de campos personalizados de proyecto o un tipo

de incidencia, en el caso de campos personalizados de un tipo de
incidencia.
El tipo de control que aparezca, as como su funcionamiento, depender del tipo de campo personalizado que se haya escogido.
6.1.7
Modificar manualmente una query simple
Como explicado en 6 y succesivas, el navegador de incidencias es

una herramienta muy til a la hora de construir bsquedas utilizando todos los criterios disponibles a travs de una interfaz grfica de
usuario. De esta forma cualquier usuario, incluso los usuarios que
no tengan ninguna familiaridad con los lenguajes de query, podrn
efectuar las bsquedas que necesiten.
Sin embargo, las consultas de tipo simple producidas por el navegador de incidencias estn sujetas a algunas limitaciones (6) y,
en ciertas ocasiones, podra ser necesario deber utilizar una bsqueda
avanzada. En las bsquedas avanzadas el usuario utilizar el lenguaje
de query de JIRA y, por lo tanto, no estar sujeto a las restricciones
impuestas por el interfaz grfico de bsqueda simple del navegador
de incidencias. Las bsquedas avanzadas se describirn en detalle en
7.
Aun as, sobre todo en casos simples (como la necesidad de cambiar algn operador lgico), el usuario podr beneficiarse del interfaz
grfico de bsqueda simple para construir el esqueleto de la consulta
y pasar al interfaz grfico de bsqueda avanzada para modificar manualmente la query generada. Cuando se pasa al interfaz de bsqueda
avanzada despus de haber creado una consulta, JIRA recordar la
consulta ejecutada y poblar esta ventana con el texto de la query
en el lenguaje de query de JIRA. De esta forma, entonces, el usuario
podr analizar la query generada y aportar las modificaciones necesarias reduciendo el tiempo necesario para construir la consulta y los
errores que puedan producirse a lo largo del proceso.
Ejemplo 6.1. Una bsqueda que no puede hacerse a travs del interfaz de bsqueda simple es la siguiente: filtrar las incidencias que
han sido creadas en la ltima semana o cuya fecha de finalizacin
haya pasado desde hace ms de 15 das. Esta bsqueda contiene dos
criterios:
(i) Cc = (fecha de creacin 7 d)
(ii) Cd = (fecha de finalizacin 15 d)
168

juntados con el operador lgico (or): Cc Cd . A pesar de no
poderse expresar la consulta Cc Cd con el interfaz grfica, el usuario
podr beneficiarse de la interfaz de bsqueda simple para crear los
criterios Cc y Cd utilizando los asistentes y juntarlos posteriormente
con el operador utilizando el lenguaje de query de JIRA. Como
explicado en 6, los criterios generados por cada panel (o a veces
incluso entre controles del mismo panel) deben satisfacerse al mismo
tiempo, es decir, sern juntados con el operador lgico (and) y la
query resultante sera:
fecha de creacin 7 d y fecha de finalizacin 15 d
|
{z
} |{z} |
{z
}
Cc
(6.17)
Cd
La modificacin que hay que aplicar a la query precedente para obtener la query que se necesita es simplemente el operador lgico que
les relaciona:
fecha de creacin 7 d |{z}
o fecha de finalizacin 15 d
|
{z
}
|
{z
}
Cc
(6.18)
Cd
es decir, simplemente sustituir con . Para modelar la query 6.17 el

usuario pondr entonces los datos siguientes en el interfaz de bsqueda
simple:
(
tc (from) = 7 d
(6.19)
td (to) = 15 d
como se ilustra en Figura 6.7. Para modificar la query y obtener
la query 6.18 el usuario podr efectuar la bsqueda3 y pasar a la
interfaz de bsqueda avanzada pulsando el enlace correspondiente.
En Figura 6.8 puede verse la query creada en los pasos precedentes
expresada en el lenguaje de query de JIRA. En el texto de la query
puede verse claramente el operador generado por el interfaz de
bsqueda simple:
due 15 d |{z}
and created 7 d
|
{z
}
{z
}
|
Cd
(6.20)
Cc
El usuario podr modificar la query para obtener la consulta 6.18

sustituyendo and con or, como ilustrado en Figura 6.9. El interfaz
3 Es
necesario efectuar la bsqueda para que JIRA recuerde la consulta y se

pueda pasar a la interfaz de bsqueda avanzada sin perdida de datos.
169
Figura 6.7: Criterio de bsqueda de ejemplo.
Figura 6.8: Criterio de bsqueda de ejemplo en el interfaz de bsqueda

avanzada.
170
Figura 6.9: Modificacin del criterio de bsqueda de ejemplo en el

interfaz de bsqueda avanzada.
de bsqueda avanzado, como puede apreciarse en figura, ayuda el

operador en la tarea de creacin de queries sugiriendo en un men
desplegable las palabras claves y los campos estndar de JIRA.
Es importante subrayar que una query modificada manualmente

puede ser imposible de expresarse a travs del interfaz grfico de
bsqueda simple y, por lo tanto, si se vuelve a esta interfaz despus
de haber modificado manualmente una query JIRA podr informar
el usuario de este problema con un mensaje parecido al ilustrado en
Figura 6.10.
Figura 6.10: Modificacin del criterio de bsqueda de ejemplo en el

interfaz de bsqueda avanzada.
En 7.9 se proporciona informacin adicional sobre las situaciones

en las cuales no es posible regresar al interfaz de bsqueda simple
desde el interfaz de bsqueda avanzada.
171

6.2
El navegador de incidencias
El navegador de incidencias es la ventana en la que JIRA devuelve los

resultados de las bsquedas efectuadas a travs de filtros, bsquedas
rpidas y bsquedas avanzadas. Una captura de pantalla de ejemplo
del navegador de incidencias puede verse en Figura 6.11.
Figura 6.11: Navegador de incidencias.
La incidencia actualmente seleccionada ser indicada con un tringulo negro (I) a la extrema izquierda de los registros cuyo color de
fondo, adems, ser distinto del color de los dems (Figura 6.11). El
usuario podr utilizar los atajos de teclado (3.43.4.3) para mover
la seleccin a otros registros: el usuario podr por ejemplo utilizar la
tecla j para mover la seleccin hacia abajo, la tecla k para mover la
seleccin hacia arriba y la tecla o para ir a la ventana de detalle de
la incidencia seleccionada.
6.2.1
Crear un enlace permanente a una bsqueda
JIRA permite crear un permalink a la pgina de resultados de una

bsqueda: los resultados de la bsqueda corriente, por ejemplo, podrn as ser compartidos con usuarios externos a travs de un enlace
que podr enviarse por correo o utilizarse en otras pginas web. Para crear un permalink a la bsqueda corriente es necesario utilizar
172
6.2. El navegador de incidencias

el control identificado con un icono parecido a y proceder como
explicado en ??.
6.2.2
Aadir
secciones
sobre
permalinks
Herramientas en el navegador de incidencias
En la ventana del navegador de incidencias, sin embargo, el usuario

no puede solo examinar los resultados de la bsqueda o navegar a
la ventana de detalle de la incidencia seleccionada: el usuario puede
tambin efectuar operaciones sobre el conjunto de resultados o sobre
cada una de las incidencias.
El usuario puede escoger las operaciones disponibles sobre cada incidencias seleccionando el men Actions, parecido al men de acciones
de la ventana de detalle de incidencia e identificado con el icono de
un engranaje, que aparece a la derecha de una incidencia cuando el
usuario la selecciona con el ratn (Figura 6.12). En el men Actions
el usuario podr efectuar las operaciones detalladas en Tabla 6.1:
es importante subrayar que las lista de operaciones disponibles en el
men Actions se construye dinmicamente dependiendo de parmetros tales como los permisos del usuario, la habilitacin de algunas
caractersticas de JIRA y los flujos de trabajos asociados a cada tipo
de incidencia.
El men Views (Figura 6.13, derecha), identificado con el icono
ojo en la esquina superior izquierda del navegador de incidencias,
permite operar sobre el conjunto de resultados devueltos por la bsqueda. Las operaciones disponibles en este men se han resumido en
Tabla 6.2.
El men Tools del navegador de incidencias (Figura 6.13, izquierda) permite efectuar operaciones masivas, como explicado en 5.17,
y para configurar las columnas utilizadas en el navegador de incidencias4 , como explicado en ??.
6.2.3
Ordenar los resultados
El navegador de incidencias permite ordenar los resultados de una

bsqueda por el valor de uno de los campos (las columnas) visualizados5 .
4 Las columnas configuradas en el navegador de incidencias se utilizan para
visualizar los resultados de bsqueda y para exportar o transformar los resultados
en algunas operaciones del men Views, como explicado en Tabla 6.2
5 No todos los campos pueden utilizarse para ordenar las bsquedas: los campos de tipo fichero (como las imgenes) o los campos de agregacin (cuyo nombre empieza por ) no son campos que pueden ordenarse.
173
Figura 6.12: Men Actions de una incidencia en el navegador de

incidencias.
Figura 6.13: Men Actions y Tools del navegador de incidencias.
174
6.2. El navegador de incidencias
Acciones en el men Actions

Accin
Start progress
Resolve issue
Close issue
Reopen issue
Edit
Assign
Assign to me
Comment
Log work
Attach file
Attach screenshot
Voters
Add vote
Watch issue
Stop watching
Watchers
Create sub-task
Convert to issue
Convert to sub-task
Move
Link
Clone
Labels
Delete
Descripcin
Comenzar a trabajar sobre una incidencia poniendo su estado a In progress (En progreso).
Resolver una incidencia poniendo su estado a Resolved (Resuelta).
Cerrar una incidencia poniendo su estado a Closed (Cerrada).
Volver a abrir una incidencia poniendo su estado
a Reopened.
Modificar una incidencia.
Asignar una incidencia.
Asignar una incidencia a s mismo.
Aadir un comentario a la incidencia.
Registrar trabajo sobre la incidencia.
Aadir un fichero adjunto a la incidencia.
Aadir una captura de pantalla a la incidencia.
Consultar la lista de usuarios que han votado la
incidencia.
Votar la incidencia.
Observar la incidencia.
Dejar de observar la incidencia.
Consultar la lista de usuarios que estn observando la incidencia.
Crear una sub-tarea en la incidencia.
Convertir en incidencia.
Convertir en sub-tarea.
Mover la incidencia.
Crear un enlace a la incidencia.
Clonar la incidencia.
Modificar las etiquetas de la incidencia.
Borrar la incidencia.
Tabla 6.1: Acciones en el men Actions en el navegador de incidencias.
175

Acciones en el men Views
Accin
Printable
Full content
XML
RSS (Issues)
RSS (Comments)
Word
Excel (All fields)
Excel (Current fields)
Charts
On dashboard
Descripcin
Visualiza los resultados en una pgina con los
campos actualmente configurados.
Visualiza los resultados en una pgina incluyendo todos los datos estndar de las incidencias.
Visualiza los resultados en XML. Vase 9.3.
Un feed RSS v. 2.0 con las incidencias. Vase
9.2
Un feed RSS v. 2.0 con los comentarios a las
incidencias. Vase 9.2
Exporta las incidencias en un documento Microsoft Word. Vase 9.4
Exporta los campos estndar de las incidencias en un documento Microsoft Excel. Vase
9.5
Exporta los campos actualmente configurados de las incidencias en un documento Microsoft Excel. Vase 9.5.
Genera un grfico con los resultados de la
bsqueda. Vase 9.6.
Visualiza los resultados en un gadget en el
cuadro de mandos. Vase 9.6.1.
Tabla 6.2: Acciones en el men Actions en el navegador de incidencias.
Para ordenar los resultados de una bsqueda es suficiente pulsar

el nombre del campo en la cabecera de la tabla de resultados. La
primera vez que se utiliza un campo para ordenar los datos de una
consulta, el ordenamiento ser ascendente y se visualizar una flecha
hacia arriba () a la derecha del nombre del campo. Para invertir el
criterio de ordenamiento es suficiente pulsar una segunda vez sobre el
mismo campo: los datos se cargarn con el ordenamiento descendiente
y se visualizar una flecha hacia abajo () a la derecha del nombre
del campo.
En Figura 6.11, por ejemplo, puede verse la ventana del navegador de incidencias con los datos ordenados de forma descendiente por
el campo Key (Clave).
176
6.3. Configurar el navegador de incidencias

6.2.4
Visualizar las incidencia
Desde la ventana del navegador de incidencias, el usuario puede acceder a los datos de una incidencia seleccionndola y navegando hasta
la ventana de detalle de la incidencia seleccionada. Cuando se accede
a esta ventana a travs del navegador de incidencias, JIRA informar
el usuario visualizando unos controles adicionales en la esquina superior derecha de la ventana de detalle, como ilustrado en Figura 6.14.
Los controles adicionales desempean las siguientes funciones:
Figura 6.14: Ventana de detalle de la incidencia con controles de

bsqueda.
(i) Avisan el usuario que existe una bsqueda en curso.

(ii) Informan el usuario que se est visualizando la incidencia isima de un conjunto de n resultados (8 de 9 en la ventana de
ejemplo).
(iii) Permiten navegar a las dems incidencias utilizando los controles de navegacin identificados con tringulos hacia arriba (N)
y hacia abajo (H).
Si el usuario decidiera o necesitara volver al navegador de incidencias, podr hacerlo seleccionando el enlace Return to search (Vuelve
a la bsqueda) en los controles de navegacin.
6.3
Configurar el navegador de incidencias
El usuario puede personalizar el navegador de incidencias (6.2) especificando:

(i) Las columnas visualizadas.
(ii) El nmero de lneas de resultados visualizadas.
(iii) La visibilidad de la columna de acciones de las incidencias.
Como explicado en 6.2, las columnas visualizadas en el navegador de incidencias afectan tambin el comportamiento de algunas
operaciones del men Views (6.2) utilizadas para generar una representacin alternativa de los resultados de una bsqueda. Por otro
177

lado, como explicado en 5.17, una de las opciones de seleccin de
incidencias durante una operacin de modificacin masiva es la seleccin de una pgina de resultados. Por estas razones, estos parmetros
de configuracin no sirven solo para personalizar la esttica de la
ventana de resultados sino que tienen repercusiones en la usabilidad
de la herramienta y en las operaciones que se pueden efectuar.
La configuracin del navegador de incidencia se determina navegando una jerarqua de configuraciones, ilustradas en Figura 6.15: la
configuracin que queda establecida es la primera configuracin que
JIRA encuentra a partir del nivel ms bajo de la jerarqua. Por lo tan-
Figura 6.15: Jerarqua de configuracin del navegador de incidencias.
to, si un usuario ha establecido una configuracin personalizada en su

perfil de usuario, la misma tendr precedencia sobre la configuracin
de sistema y ser la configuracin utilizada por JIRA. Si el usuario,
por el contrario, no ha establecido una configuracin personalizada,
JIRA utilizar la configuracin de sistema.
6.3.1
Configurar las columnas visualizadas
En el perfil de cada usuario, JIRA permite definir y almacenar la configuracin de columnas del navegador de incidencias. El navegador de
incidencias de un usuario que no haya establecido dicha configuracin
utilizar la configuracin por defecto establecida por los administradores de JIRA.
Para modificar el conjunto de columnas visualizadas en esta ventana, es necesario acceder a la ventana de configuracin de campos
del navegador de incidencias (Figura 6.16) seleccionando la operacin Configure columns en el men Tools. En esta ventana el usuario
podr modificar el conjunto de campos visualizados aadiendo, eliminando, reordenando y ocultando los campos disponibles:
(i) Para reordenar los campos de la ventana utilizar los controles
identificados con flechas (hacia la derecha y hacia la izquierda
) para mover el campo en la direccin especificada.
178
6.3. Configurar el navegador de incidencias
Figura 6.16: Ventana de configuracin de campos del navegador de

incidencias.
(ii) Para eliminar un campo de la ventana seleccionar el control de

eliminacin identificado con el icono basura.
(iii) Para aadir un campo a la ventana, seleccionar el campo en el
men desplegable Add new column (Aadir nueva columna) y
pulsar el botn Add (Aadir).
(iv) Para ocultar la columna de acciones, utilizar el botn Hide Actions menu. (Oculta el men Acciones).
(v) Para volver a la configuracin por defecto, utilizar el botn Restore defaults (Restablece valores originales).
La ventana de configuracin de campos del navegador tambin es
accesible desde la ventana del perfil del usuario, a travs del enlace
View navigator columns, ilustrado en Figura 6.18.
La configuracin de columnas del navegador de incidencias se almacena en el perfil de usuario de forma que cada usuario puede personalizar las columnas utilizadas por defecto en esta ventana.
Para modificar la configuracin de columnas, pueden repetirse los
pasos detallados en precedencias y ajustar la configuracin del proprio
perfil a las nuevas necesidades.
Un usuario tambin puede decir eliminar la configuracin de columnas de su perfil y, en este caso, el navegador de incidencias volver
a utilizar la configuracin por defecto establecida por el administrador de la plataforma. Para eliminar la configuracin de columnas
179

personalizada es necesario seleccionar la operacin Restore defaults
ilustrada en Figura 6.17.
Figura 6.17: Ventana de configuracin de campos del navegador de

incidencias Establecer configuracin por defecto.
6.3.2
Configurar el nmero de lneas visualizadas
El nmero de lneas de resultados devueltas por el navegador de incidencias es un parmetro de configuracin del perfil de cada usuario.
Para modificar este parmetro es necesario efectuar las siguientes operaciones:
(i) Acceder al perfil del usuario seleccionando el enlace con el nombre del usuario en la barra de herramientas de JIRA.
(ii) Seleccionar el icono de modificacin, identificado con el icono
lpiz, en el panel Preferences (Preferencias), como ilustrado
en Figura 6.18.
(iii) Modificar el parmetro Page size (Tamao de pgina) que, por
defecto, tiene el valor 50.
(iv) Confirmar la modificacin utilizando el botn Update.
180
6.4. Bsquedas de texto
Figura 6.18: Panel Preferences del perfil de usuario.
6.4
Bsquedas de texto
JIRA ofrece funciones avanzadas pensadas para la bsqueda eficaz de

texto:
(i)
(ii)
(iii)
(iv)
(v)
Bsquedas aproximadas, utilizando comodines (6.4.2).

Bsquedas fuzzy (6.4.3).
Bsquedas por proximidad (6.4.4).
Bsquedas con palabras de distinta importancia (6.4.5).
Operadores booleanos y de agrupacin para la construccin de
consultas complejas (6.4.6).
Para aclarar la importancia de estas funcionalidades, tomaremos

como ejemplo las bsquedas aproximadas. Para algunos tipos de
campos, una bsqueda aproximada podra ser de escasa utilidad o
incluso carecer de sentido. En el caso de otros campos, como los campos de tipo fecha, aunque el formato del campo est bien especificado
y no puedan introducirse valores arbitrarios, una bsqueda aproximada puede ayudar el usuario a acotar el conjunto de incidencias a
filtrar: para este tipo de campo JIRA ofrece, como visto en 6.1.4, la
posibilidad de buscar fechas relativas.
En los campos de texto los usuarios pueden introducir texto libre
y, por lo tanto, es difcil, sino imposible, asegurarse que se utilice un
diccionario de trminos acotado; an con esta restriccin, limitar la
bsqueda de texto a trminos exactos podra dificultar las operaciones
de filtrado y un usuario podra enfrentarse a problemas a la hora de
encontrar las incidencias que est buscando.
181

Si un usuario quisiera filtrar las incidencias utilizando como criterio un campo de texto y deseara buscar la palabra factura, por
ejemplo, si la bsqueda se limitara a encontrar palabras idnticas, el
usuario no encontrara eventuales variaciones de la palabra factura
como los plurales. En otros idiomas, adems, las palabras se declinan y, por lo tanto, una bsqueda exacta se revelara insuficiente y
el usuario debera construir criterios que tomasen en cuenta todas las
posibles variaciones que se puedan dar.
Este ejemplo demuestra que es necesario disponer de herramientas
que garanticen cierto nivel de flexibilidad y, sobre todo, confianza a
la hora de certificar que las incidencias que se han filtrado sean todas
las que cumplan los criterios que el usuario ha establecido.
6.4.1
Estructuras de las consultas
Antes de describir las funcionalidades de bsqueda de texto avanzadas

es importante familiarizarse con la estructura y los trminos utilizados
para describir una query de JIRA.
JIRA subdivide las palabras que forman una consulta en dos categoras: trminos y operadores. Los trminos son las palabras que
el usuario desea buscar y, a su vez, se subdividen en trminos nicos
y frases. Los trminos nicos son conjuntos de una palabra como
por ejemplo documento o implantacin mientras que las frases son
conjuntos ordenados de palabras, como por ejemplo documento de
implantacin. Para agrupar trminos y formar una frase es necesario
utilizar las comillas dobles (") para delimitar la misma: la bsqueda
"documento de implantacin" est compuesta por una frase de tres
palabras mientras que la bsqueda documento de implantacin es
una bsqueda con tres trminos. JIRA trata una frase como un conjunto indivisible de palabras que tiene que aparecer, con las palabras
en el orden especificado y sin interrupcin, en el campo que se est filtrando. Las dos bsquedas anteriores, por lo tanto, devolvern
conjuntos distintos de resultados siendo la segunda (documento de
implantacin), una bsqueda menos filtrante que la primera ya que
devolver la unin de los resultados de las tres palabras buscadas de
forma independiente.
La funcin de los operadores, por otro lado, es la de juntar mltiples trminos en un criterio de bsqueda ms complejo. Los operadores ms comnmente utilizados son, por ejemplo, los operadores
booleanos and () y or ().
182

El lenguaje de las consultas de texto contiene, como se ver en
las siguientes secciones, unos caracteres especiales que necesitarn ser
escapados para poderse utilizar en un trmino con su significado
literal. Los caracteres especiales estn detallados en Tabla 6.3. Para
+
}
&&
]
||
(
*
)
?
{
\
Tabla 6.3: Caracteres especiales en las bsquedas de texto.
utilizar los caracteres especiales en una consulta es necesario prefijarlos con el carcter de escape \.
Ejemplo 6.2. Para buscar el texto (x + y) + z, por ejemplo, ser
necesario ejecutar la consulta:
$x\+y$\+z
En la consulta precedente, se ha utilizado el carcter \ para escapar,

prefijndolo a ellos, los tres caracteres reservados que aparecan en la
consulta: (, ) y +.
Algunas palabras son consideradas especiales y sern ignoradas
en las bsquedas. Las palabras especiales dependen del lenguaje de
indicizacin de JIRA y, por lo tanto, no es posible ofrecer una lista
exhaustiva en todos los idioma en los que JIRA est disponible. Como
referencia, en Tabla 6.4 se detallan los trminos especiales de JIRA
en ingls.
Trminos especiales
a
by
no
t
they
and
for
not
that
this
are
if
of
the
to
as
in
on
their
was
at
into
or
then
will
be
is
s
there
with
but
it
such
these
Tabla 6.4: Trminos especiales en las bsquedas de texto.
183

6.4.2
Bsquedas aproximadas
JIRA permite utilizar los siguientes comodines para modificar el

significado de los trminos en los cuales se utilizan:
(i) ?: para indicar un carcter cualquiera.
(ii) *: para indicar un grupo de caracteres cualquiera.
La bsqueda de la palabra factur*, por lo tanto, devolver tanto
resultados de la palabra factura como resultados de las palabras
facturas, facturacin, etc.
La bsqueda de la palabra factur?, por otro lado, devolver los
resultados de la palabra factura pero no los resultados correspondientes a facturas o facturacin.
La nica limitacin de estos dos comodines es que no se pueden
utilizar como comienzo de palabra. Las bsquedas *ras, por ejemplo,
ser una bsqueda invlida.
6.4.3
Bsquedas fuzzy
Las bsquedas fuzzy permiten buscar trminos que se parezcan a

los trminos especificados en situaciones en las cuales la utilizacin
de comodines (6.4.2) para efectuar una bsqueda aproximada no
garantizaran un buen resultado. Las bsquedas fuzzy solo pueden
utilizarse por trminos nicos y no por frases (6.4.1).
Un usuario podra, por ejemplo, estar buscando una palabra que
se parece a otra pero, no sabiendo exactamente como se escribe esta
palabra, teme que la utilizacin de comodines podra resultar en un
filtrado ineficaz de las incidencias en el sistema.
Para efectuar una bsqueda fuzzy con un trmino es necesario
utilizar el modificador al final del trmino nico que se desea modificar. Para buscar de forma fuzzy utilizando el trmino factura, por
ejemplo, un usuario deber utilizar el trmino modificado factura.
6.4.4
Bsquedas por proximidad
Las bsquedas por proximidad permiten efectuar bsquedas con frases cuyas palabras no deben distar ms de la cantidad de palabras
especificadas.
Este tipo de bsqueda es til para refinar una bsqueda por frase
cuando no se tiene la certidumbre que la frase sea exacta y pueda
darse que la misma contenga palabras adicionales. De esta forma un
184

usuario puede seguir utilizando frases, un criterio ms filtrante que
un criterio por trminos nicos, asegurndose que las palabras no estn demasiados apartadas corriendo el riesgo de obtener resultados
diversos de los esperados.
Para efectuar una bsqueda por proximidad un usuario necesita
aadir el sufijo n donde n es la distancia mxima entre las palabras
de la misma frase. Para buscar el conjunto de palabras documento
de implantacin asegurndose que no disten ms de 5 palabras, el
usuario utilizar el trmino "documento de implantacin"5.
6.4.5
Bsqueda por importancia
JIRA categoriza los resultados de una bsqueda con un valor de

importancia relativa medido de acuerdo a los trminos encontrados.
Por defecto el nivel de importancia de un trmino de una bsqueda
de texto es 1.
El usuario puede modificar el nivel de importancia de un trmino,
tanto nico como frase, utilizando el modificador n donde n es el
nivel de importancia que se quiere asignar al trmino. El nivel de
importancia debe ser un nmero positivo: los nmeros n ]0, 1[ disminuyen el nivel de importancia de un trmino mientras que los nmeros n ]1, [ aumentan el nivel de importancia de un trmino. La
bsqueda
documento implantacin^4
por ejemplo, asignar un valor cuatro veces superior al trmino implantacin relativamente al trmino documento.
6.4.6
Operadores
Los operadores permiten combinar trminos para construir consultas

ms complejas. Los operadores booleanos soportados por JIRA son
los siguientes:
(i)
(ii)
(iii)
(iv)
(v)
AND o &&.
OR o ||.
NOT o !.
+.
-.
Ntese que un operador debe escribirse en maysculas, de lo contrario

JIRA lo interpretar como trmino (6.4).
185

El operador AND es un operador binario que relaciona dos trminos,
como en el criterio x AND y. Este operador indica a JIRA que ambos
trminos, x y y, deben encontrarse en la incidencia. Para hacer una
analoga con los conjuntos, el operador AND () hace una interseccin:
si X es el conjunto de resultados del trmino x y Y el del trmino y,
los resultados de x y sern x y.
El operador OR es un operador binario que indica a JIRA de devolver resultados que contengan o un trmino o el otro. Para hacer una
analoga con los conjuntos, el operador OR () hace una interseccin:
si X es el conjunto de resultados del trmino x y Y el del trmino y,
los resultados de x y sern x y.
El operador NOT es un operador binario que indica a JIRA de
devolver los resultados que contengan el trmino especificado por el
primer operando y que no contenga el trmino especificado por el
segundo operando. Para hacer una analoga con los conjuntos, el
operador NOT () hace una diferencia entre conjuntos. Si X es el
conjunto de resultados del trmino x y Y es el conjunto de resultados
del trmino y, el conjunto de resultados de la consulta xy ser X \Y .
El operador + es un operador unario que indica a JIRA que un
trmino de una consulta es un trmino requerido y debe encontrarse
en los resultados. A pesar de ser un operador unario, este operador no
tiene efecto si utilizado en una consulta con un solo trmino ya que,
en ambos casos, el conjunto de resultados coincidira. En la consulta:
documento +implantacin
los resultados debern contener la palabra implantacin y podrn

contener la palabra documento.
El operador - es un operador unario que indica a JIRA que un
trmino de una consulta es un trmino excluido de la consulta y no
debe encontrarse en los resultados. En la consulta:
"documento de implantacin" -borrador
los resultados debern contener la frase documento de implantacin

y no podrn contener la palabra borrador.
Los criterios de bsqueda pueden agruparse para formar consultas de complejidad superior y los caracteres de agrupacin son las
parntesis. Existe una limitacin por la cual una consulta no puede
comenzar con un carcter de agrupacin. La consulta
documento AND (explotacin OR implantacin)
186
6.5. Bsquedas rpidas

devolver resultados que contengan la palabra documento y contengan
una de las palabras explotacin o implantacin.
6.5
Bsquedas rpidas
El control de bsqueda rpida, ilustrado en Figura 6.19, est situado

en la barra de herramientas de JIRA y, por lo tanto, est disponible
en cualquier ventana de la aplicacin. Este control permite efectuar
Figura 6.19: Control de bsqueda rpida.
bsquedas tecleando el criterio directamente en el campo de texto:

por defecto, JIRA efectuar una bsqueda con texto libre buscando
el texto en los campos descriptivos de las incidencias: ttulo, descripcin y comentarios. El control de bsqueda rpida tambin reconoce algunos trminos que permite efectuar rpidamente bsquedas
inteligentes tales como bsqueda por usuario asignado o reporter,
bsquedas con fechas, bsquedas por estado, etc.
La bsqueda rpida, aunque no permita filtrar las incidencias con
criterios complejos como los que se pueden construir el navegador
de incidencias, es una herramienta puede resultar muy poderosa al
usuario que aprenda como utilizarla. Los resultados de las bsquedas
rpidas se visualizarn adems, como cualquier otra bsqueda, en el
navegador de incidencias: todas las funciones proporcionadas en esta
herramienta estarn por lo tanto a disposicin del usuario.
Cuando JIRA detecta una query inteligente, el usuario ser avisado en la ventana de resultados por un mensaje parecido al ilustrado
en Figura 6.20. Si la intencin del usuario era efectuar una bsqueda
Figura 6.20: Aviso de activacin de bsqueda inteligente.
de texto libre, se podr utilizar el enlace Run search without smart

187

query para volver a efectuar la bsqueda inhabilitando las queries
inteligentes6 .
La bsqueda rpida es una funcionalidad compatible con el control de bsqueda de navegadores basados en Mozilla: una instancia
de JIRA podr por lo tanto integrarse en los motores de bsqueda
gestionados por el navegador y el usuario podr efectuar bsquedas
rpidas en las instancias de JIRA registradas directamente desde el
navegador. De la misma forma en que los usuarios pueden iniciar una
navegacin utilizando otros motores de bsqueda (tales como Google), se podr efectuar una bsqueda en JIRA sin ni siquiera acceder
previamente a la misma y obtener los resultados accediendo directamente al navegador de incidencias. En seccin 6.5.14 se detallar
como configurar esta funcionalidad en los navegadores compatibles.
En las siguientes secciones se detallarn las bsquedas inteligentes que JIRA es capaz de reconocer.
6.5.1
Navegar a una incidencia
Uno de los casos de usos ms comunes para la bsqueda simple es la

navegacin hacia una incidencia utilizando su cdigo. La bsqueda
rpida proporciona el camino ms rpido hacia la ventana de detalle de una incidencia ya que, tecleando en el control un cdigo de
incidencia, JIRA llevar el usuario a la ventana de detalle correspondiente. Si, por ejemplo, un usuario quiere navegar hacia la incidencia
JRAGD-1, es suficiente teclear este cdigo en el control de bsqueda
rpida para que JIRA lleve directamente el usuario a la ventana de
detalle sin pasar por una ventana de resultados de bsqueda intermedia.
Si, adems, el usuario est buscando una incidencia en el mismo
proyecto en el que est trabajando, se podr omitir la clave de proyecto y teclear solo el nmero de incidencia: JIRA asumir que se
est buscando la incidencia en el mismo proyecto y llevar el usuario
al detalle de la incidencia.
6.5.2
Incidencias asignadas a uno mismo
Para encontrar incidencias asignadas a uno mismo se puede utilizar

la palabra clave my en el criterio de bsqueda utilizando los dems
trminos inteligentes proporcionados por JIRA. Si, por ejemplo, un
6 Las
queries inteligentes se inhabilitarn solo durante la bsqueda por la que

se ha utilizado este enlace.
188

usuario quisiera encontrar las incidencias asignadas a si mismo que no
se han resuelto en la fecha lmite (6.5.5), podr teclear my overdue
y JIRA devolver las incidencias requeridas. Si el usuario quisiera encontrar sus incidencias abiertas (6.5.7) en el proyecto JRAGD (6.5.4)
podr teclear my open JRAGD.
6.5.3
Incidencias por reporter
Si se quisieran filtar las incidencias utilizando el nombre del usuario

que ha reportado la incidencia7 podr utilizarse la cadena r: seguida
de:
(i) me: si se estn buscando las incidencias abiertas por uno mismo.
(ii) none: si se estn buscando las incidencias sin reporter.
(iii) nombre: si se estn buscando las incidencias abiertas por un
usuario especfico.
Si, por ejemplo, un usuario quisiera buscar las incidencias abiertas
por enrico podr utilizar r:enrico.
6.5.4
Incidencias en un proyecto
Para filtrar las incidencias de un proyecto es posible especificar el

cdigo o el nombre del mismo en el criterio de bsqueda. Si se quieren
buscar las incidencias del proyecto JRAGD se podr utilizar esta clave
en el criterio de bsqueda rpida para que JIRA acote el filtrado en
el contexto del proyecto especificado.
6.5.5
Incidencias atrasadas
Para buscar las incidencias atrasadas, es decir las incidencias cuya

fecha de resolucin ha pasado la fecha lmite especificada en el campo Due date, se puede utilizar el trmino overdue en el criterio de
bsqueda, como ilustrado en el ejemplo de 6.5.2.
6.5.6
Incidencias por fecha
Los prefijos created:, updated: y due: pueden utilizarse para buscar las incidencias cuya fecha de creacin, ltima actualizacin o vencimiento sea la especificada. El formato de fecha que puede utilizarse
7 Esta
funcionalidad est incluida en JIRA v. 4.3 y superiores
189
add section
con este tipo de bsqueda inteligente es exclusivamente una fecha relativa (??) o un intervalo de fechas relativas, utilizando la notacin
x,y donde x y y respetan el formato detallado en ?? y no contienen
ningn espacio.
Para facilitar la bsqueda, JIRA tambin entiende los siguientes
mnemnicos:
(i) yesterday
(ii) today
(iii) tomorrow
Para buscar incidencias creadas en la ltima semana puede utilizarse por ejemplo la bsqueda created:-1w. Para buscar incidencias actualizadas en los ltimos dos das puede utilizarse la bsqueda
updated:-2d,-1d.
6.5.7
Incidencias por estado
Para buscar incidencias de un particular estado puede utilizarse el

nombre del estado como trmino de bsqueda, como ilustrado en el
ejemplo my open JRAGD de 6.5.2 que devuelve las incidencias abiertas (open) asignadas a uno mismo en el proyecto JRAGD.
Los estados reconocidos sern exclusivamente los estados del flujo
de trabajo estndar de JIRA.
6.5.8
Incidencias por resolucin
El nombre de una resolucin (??) puede utilizarse para filtrar las

incidencias como en la busqueda my incomplete, para buscar incidencias en el estado Incomplete, o en la bsqueda r:me duplicate,
para buscar las incidencias duplicadas reportadas por uno mismo.
6.5.9
Incidencias por prioridad
Las incidencias pueden buscarse utilizando el nombre de la prioridad:

para buscar una incidencia con prioridad blocker, por ejemplo, se puede utilizar el trmino blocker como criterio de bsqueda inteligente.
6.5.10
Incidencias por tipo
El tipo de incidencia puede utilizarse como trmino de bsqueda inteligente: para buscar incidencias del tipo bug o task pueden utilizarse
190

los trminos bug o task en el criterio de bsqueda. JIRA, en algunos
casos, interpretar tambin los plurales y podrn efectuarse bsquedas tales como my open bugs para encontrar las incidencias abiertas
(open, 6.5.7) de tipo bug asignadas a uno mismo (my, 6.5.2).
6.5.11
Incidencias por versin
El prefijo v: puede utilizarse para especificar la versin a la que estn asociadas las incidencias que se estn buscando. JIRA devolver
las incidencias cuya versin sea igual a la que se especifique o que
comience con la cadena especificada siempre que el primer carcter
despus de sta sea un espacio.
Si en un proyecto, por ejemplo, se han definido las versiones 1.0,
1.0 Standard y 1.0.1 y se utiliza el trmino v:1.0 en una bsqueda
rpida, JIRA devolver las incidencias asociadas a las versiones 1.0 y
1.0 standalone. No se devolvern las incidencias asociadas a la versin
1.0.1 ya que el primer carcter despus de la cadena especificada (1.0)
no es un espacio sino un punto (.).
6.5.12
Incidencias por versin de resolucin
Las incidencias pueden filtrarse por el campo Fix version utilizando

el trmino ff: y especificando un nmero de versin. El mecanismo
de bsqueda es parecido al detallado en 6.5.11.
6.5.13
Incidencias por componente
El prefijo c: puede utilizarse para buscar las incidencias asociadas al

componente buscado. Este prefijo permite especificar una palabra (sin
espacios) y JIRA devolver las incidencias asociada a componentes
cuyo nombre contenga la palabra especificada.
6.5.14
Integracin con navegadores
La integracin de JIRA con el control de bsqueda de los navegadores es una forma muy cmoda de poder registrar cualquier instancia
de JIRA como motor de bsqueda y poder efectuar una bsqueda de
forma rpida, sin siquiera conectarse previamente a la plataforma y
acceder a sus herramientas de bsqueda. En lugar de utilizar estas
ltimas, el usuario podr teclear la bsqueda directamente en el control de bsqueda del navegador que, normalmente, est situado justo
a la derecha de la barra de navegacin. El navegador, despus de que
191

el usuario haya confirmado la bsqueda, contactar con JIRA para
enviarle la query introducida por el usuario que ser llevado directamente a la pgina de resultados del navegador de incidencias.
La funcionalidad de bsqueda rpida de JIRA puede integrarse
solo con algunos navegadores que deben cumplir una de las siguientes
condiciones:
(i) Soportar el estndar OpenSearch.
(ii) Ser un navegador derivado de Mozilla.
there can only

be one opensearch descriptor per domain.
El estndar OpenSearch [26], la opcin aconsejada para integrar

esta funcionalidad, es un estndar que se cre para la publicacin de
resultados de bsqueda y proporcionarlos en una forma que facilitara la agregacin y la sindicacin de los mismos. El descubrimiento
de las funcionalidades, la registracin y la utilizacin de un motor
de bsqueda que, como JIRA, soporte este estndar es automtica
y, por lo tanto, es una operacin muy sencilla a completarse incluso
para usuarios no expertos.
Los navegadores ms conocidos que hoy en da soportan este estndar son:
(i) Mozilla Firefox v. 2 y superiores.
(ii) Microsoft Internet Explorer v. 7 y superiores.
(iii) Google Chrome.
Para aadir una instancia de JIRA a los motores de bsqueda
configurados de un navegador soportado, es suficiente navegar a cualquier pgina de la plataforma. El navegador, una vez que se acceda a
la plataforma, acceder al descriptor OpenSearch proporcionado por
JIRA y el usuario podr aadir la instancia corriente en la configuracin del navegador. En Figura 6.21 puede verse un ejemplo con
Mozilla Firefox: utilizando el men desplegable a la izquierda del control de bsqueda (identificado, en las versiones recientes de Firefox,
con el logo del motor de bsqueda actualmente utilizado), aparecer
una entrada de men que permitir aadir a JIRA entre los motores
configurados.
Una vez registrado el motor, el usuario podr comenzar a teclear
sus bsquedas y enviarlas directamente a JIRA. En Figura6.22 puede verse el resultado de la bsqueda my open bugs efectuada desde
el control de bsqueda de Firefox.
El soporte del estndar OpenSocial permite la integracin de JIRA
con cualquier aplicacin que soporte este estndar. Aunque el caso
192
Figura 6.21: Registracin de un motor de bsqueda OpenSearch.
Figura 6.22: Ejemplo de bsqueda desde el control de bsqueda del

navegador.
193

ms comn ser la integracin con un navegador el usuario podr
integrar JIRA como motor de bsqueda en cualquier aplicacin o
lenguaje de programacin que soporte el estndar [27] directamente
o a travs de una librera, tales como: Alfresco, Drupal, Lucene,
MediaWiki, WordPress, etc. Vase [27] para obtener informacin
acerca de los clientes soportados.
Otra opcin de integracin para navegadores que deriven de Mozilla es la creacin de un bookmark personalizado que apunte a la
direccin8 :
http://your.jira/secure/QuickSearch.jspa?searchString=%s
El usuario podr escoger una keyword (palabra clave) para el bookmark que, por ejemplo, podra ser el mnemnico j. Para efectuar una
bsqueda en JIRA ser suficiente teclear la palabra clave escogida seguida del criterio deseado: para repetir la bsqueda del ejemplo de
Figura 6.22 el usuario deber teclear j my open bugs.
8 Sustituir
194
your.jira con la direccin de la instancia de JIRA a integrar.
7
Bsquedas avanzadas
La bsqueda avanzada es la herramienta de bsqueda ms completa proporcionada por JIRA. Para utilizar este tipo de bsqueda, a
diferencia de los dems tipos de bsquedas ofrecidos por JIRA (bsqueda simple, descrita en 6.1, y bsqueda rpida, descrita en 6.5),
es necesario conocer y emplear el JIRA query language (lenguaje de
query de JIRA, o JQL). El JQL es un lenguaje que se asemeja al
SQL, aunque con notables diferencias y limitaciones: a continuacin
se detallarn las ms importantes desde el punto de visto del usuario.
En primer lugar, el JQL permite efectuar bsquedas (la operacin
anloga al comando SELECT del SQL) pero no permite modificar los
datos: de hecho, ni siquiera existe el comando SELECT sino que se
asume implcitamente que el comando JQL sea una seleccin.
En segundo lugar, el JQL asla el usuario del modelo de datos
subyacente de JIRA: sencillamente, no existe el concepto de tabla (ni
conceptos a ella relacionados, tales como el join) y solo se manejan
campos en un espacio de nombres global.
En tercer lugar, no se puede utilizar un campo como valor en
una comparacin con otro campo: criterios vlidos (y comunes) en
SQL no podrn implementarse con ninguna herramienta de bsqueda
proporcionada por JIRA, ni siquiera con el JQL. Si, por ejemplo, un
usuario quisiera efectuar la bsqueda:
asignatario = reporter
(7.1)
fecha de creacin = fecha de actualizacin
(7.2)
o la bsqueda:
no habr forma de ejecutarla a travs de las herramientas de JIRA

ya que, por ejemplo, la consulta:
195
7. Bsquedas avanzadas
assignee = reporter
ser interpretada por JIRA como la bsqueda de las incidencias cuyo

asignatario se llame, literalmente, reporter.
Las bsquedas avanzadas se efectan en el navegador de incidencias (6.2), seleccionando en enlace Advanced para pasar de la modalidad simple a la modalidad avanzada, cuya captura de pantalla
puede verse en Figura 7.1. El usuario podr teclear la consulta
Figura 7.1: Ventana de bsqueda avanzada.
JQL en el cuadro de texto, pulsar el botn Search y los resultados se

visualizarn, como para cualquier otra bsqueda, en el navegador de
incidencias donde se podrn utilizar sus herramientas para manipular
los datos.
7.1
Estructura de una query JQL
La query JQL bsica est compuesta por los siguientes elementos:

assignee |{z}
= enrico
| {z }
| {z }
campo
(7.3)
operador valor
El campo es el identificador del campo a buscar: en este caso el campo

assignee, es decir, el usuario al que est asignada la incidencia.
El operador representa el tipo de filtrado que se desea efectuar
sobre el campo y devuelve un valor booleano : en este caso se desean
buscar valores iguales al valor proporcionado.
El valor es el parmetro requerido por algunos operadores para
completar el filtrado: en este caso, tratndose del operador binario
de igualidad, enrico es el valor que tiene que asumir el campo para
satisfacer nuestro criterio de bsqueda. En lugar de un valor, algunos
campos soportan la comparacin con el resultado de una funcin
Mltiples proposiciones pueden juntarse, utilizando operadores booleanos, para construir proposiciones complejas.
196
7.2. Caracteres reservados

7.2
Caracteres reservados
El lenguaje JQL tiene los caracteres reservados detallados en Tabla

7.1. Para utilizar caracteres reservados en las consultas JQL habr
""
/
+
%
,
$
;
#
?
@
|
[
*
]
Tabla 7.1: Caracteres JQL reservados.
que protegerles utilizando comillas o comillas dobles.

Ntese que, en el caso de bsquedas de texto habr que tener en
cuenta una lista adicional de caracteres reservados que ha sido detallada en 6.4.1. Este tipo de bsqueda, cuando se utilizan consultas
JQL, aplicarn a los siguientes campos:
(i)
(ii)
(iii)
(iv)
(v)
Ttulo.
Descripcin.
Entorno.
Comentarios.
Campos personalizados que utilicen el buscador de texto libre
(??), tales como:
a) Campo de texto libre.
b) Campo de texto.
c) Campo de texto de sola lectura.
7.3
Palabras reservadas
El lenguaje JQL tiene tambin palabras reservadas que, para poderse

utilizar en una consulta, debern ser protegidas con comillas. En
B.3 se detallar la lista completa de palabras reservadas de este
lenguaje.
7.4
Campos
En esta seccin se introducirn los campos ms comnmente utilizados en las consultas. Por razones de espacio y organizacin de este
libro, se ha dedicado una apndice (B) como referencia exhaustiva
sobre los campos JQL.
197
En Tabla 7.2 puede verse la lista de campos que pueden utilizarse
en una query JQL.
Descripcin
Nombre
Versin afectada
Asignatario
Categora
Comentario
Componente
Fecha de creacin
Descripcin
Fecha de vencimiento
Entorno
Filtro
Versin de resolucin
Clave de incidencia
Nivel de seguridad
Estimacin original
Padre
Prioridad
Proyecto
Estimacin restante
Reporter
Resolucin
Fecha de resolucin
Estado
Ttulo
Texto
Tipo de incidencia
Tiempo trabajado
Fecha de actualizacin
Usuario que ha votado
Nmero de votos
Usuario que observa
Porcentaje de trabajo
affectedVersion
assignee
category
comment
component
created
description
due
environment
filter
fixVersion
issueKey
level
originalEstimate
parent
priority
project
remainingEstimate
reporter
resolution
resolved
status
summary
text
issueType
timeSpent
updated
voter
votes
watcher
workRatio
Tabla 7.2: Campos JQL.
7.5
Palabras claves
Las palabras claves son trminos reservados JQL que se dividen en

las siguientes categoras:
198
7.5. Palabras claves

(i) Conectivas o operadores lgicos, como por ejemplo los operadores para conectar mltiples proposiciones en una proposicin
ms compleja: AND () y OR ().
(ii) Operadores de ordenamiento.
7.5.1
Palabra clave and
El operador lgico and () permite unir dos proposiciones lgicas (dos

criterios de bsqueda) X y Y en una proposicin ms compleja, X Y ,
que ser verdadera cuando ambos componentes sean verdaderos.
Ejemplo 7.1. Para buscar las incidencias de tipo bug asignadas a
un usuario llamado enrico es necesario juntar las proposiciones:
(i) la incidencia es de tipo bug
(ii) la incidencia est asignada al usuario denominado enrico
con el operador and:
type = Bug and assignee = enrico
Ejemplo 7.2. Para buscar las incidencias abiertas, urgentes y asignadas a enrico es necesario juntar las proposiciones
(i) la incidencias est abierta.
(ii) la prioridad de la incidencia es urgente.
(iii) la incidencia est asignada al usuario denominado enrico
con el operador and:
status = open and priority = urgent and assignee = enrico
7.5.2
Palabra clave or
El operador logico or () permite unir dos proposiciones lgicas (dos

criterios de bsqueda) X y Y en una proposicin ms compleja, X
Y , que ser verdadera cuando al menos uno de los componentes sea
verdadero.
Ejemplo 7.3. Para buscar las incidencias vencidas o las incidencias
que no especifican una fecha de vencimiento es necesario juntar las
proposiciones
199
(i) La incidencia ha vencido.
(ii) La incidencia no tiene fecha de vencimiento.
con el operador or:
duedate < now() or duedate is empty
7.5.3
Palabra clave not
El operador not () invierte la funcin de verdad de la proposicin:

si X es una proposicin y X es la proposicin negada, X ser
verdadera cuando X sea falsa y viceversa.
Ejemplo 7.4. Para buscar las incidencias abiertas, urgentes y que
no estn asignadas a enrico es necesario juntar las proposiciones
(i) La incidencias est abierta.
(ii) La prioridad de la incidencia es urgente.
(iii) La incidencia no est asignada al usuario denominado enrico.
y ejecutar, pues, la consulta:
status = open and priority = urgent and not assignee = enrico
7.5.4
Palabra clave empty
La palabra clave empty se utiliza en una query JQL como valor para
indicar que el campo no tiene un valor asignado. Esta palabra clave
solo puede utilizarse con campos (B.1.3) que soportan los operadores
is (7.6.11) e is not (7.6.12). Vase tambin 7.5.5.
Ejemplo 7.5. En el ejemplo 7.3 se utiliz el operador is y la palabra
clave empty para expresar el criterio la incidencia no tiene fecha de
vencimiento:
duedate is empty
200
7.6. Operadores
7.5.5
Palabra clave null
El operador null tiene una funcionalidad muy parecida al operador

empty: se utiliza en una query JQL como valor para indicar que el
campo no tiene un valor asignado. Esta palabra clave solo puede utilizarse con campos (B.1.3) que soportan los operadores is (7.6.11)
e is not (7.6.12). Vase tambin 7.5.4.
Ejemplo 7.6. En el ejemplo 7.5 se puede intercambiar el operador
empty con el operador null y expresar el mismo criterio de bsqueda:
duedate is null
7.5.6
Palabra clave order by
El operador order by permite especificar el campo con el cual se ordenarn los resultados. Por defecto este operador devolver los datos
en rden ascendente pero su comportamiento puede modificarse indicando explcitamente el rden deseado utilizando las palabras claves
asc y desc si se desea, respetivamente, ordenamiento ascendente o
descendiente.
Ejemplo 7.7. Si se desean ordenar los resultados de la consulta descrita en el ejemplo 7.3 en orden descendente utilizando el campo fecha
de creacin deber utilizarse la consulta:
duedate < now() or duedate is empty order by created
7.6
Operadores
Los operadores pueden pensarse como funciones que devuelven un

valor booleano y aceptan como parmetros un campo y su valor (o
una funcin). Los operadores definen los criterios de filtrado que el
usuario puede hacer sobre los campos y son los siguientes:
(i)
(ii)
(iii)
(iv)
(v)
El
El
El
El
El
campo
campo
campo
campo
campo
es
es
es
es
es
igual a (=): equals.

distinto de (6=): not equals.
mayor que (>): greater than.
mayor o igual que (): greater than equals.
menor que (<): less than.
201
(vi)
(vii)
(viii)
(ix)
(x)
(xi)
(xii)
7.6.1
El campo es menor o igual que (): less than equals.

El campo est en (): in.
El campo no est en ():
/ not in.
El campo contiene (3): contains.
El campo no contiene (63): does not contain.
El operador es (): is.
El operador no es (6): is not.
Operador equals
El operador equals (=) se utiliza cuando el valor de un campo tiene que coincidir con el valor especificado. Este operador no puede
utilizarse con campos de tipo texto (vase 7.6.9).
Ejemplo 7.8. En el ejemplo 7.1 se utiliz el operador = dos veces
en la consulta:
type = Bug and assignee = enrico
Ntese que en ambas proposiciones este operador se ha utilizado con

campos que no son textuales aunque, intuitivamente, se podra pensar
que lo fuesen.
7.6.2
Operador not equals
El operador not equals (6=) se utiliza cuando el valor de un campo

tiene que ser distinto que el valor especificado. Este campo puede
indicarse tambin como !=. Este operador no puede utilizarse con
campos de tipo texto (vase 7.6.10).
Una proposicin que utilice el operador 6= equivale a la negacin
de la misma proposicin en la que 6= se haya sustituido con el operador
=:
(campo != valor) = (not campo = valor)
Hay que subrayar tambin el hecho que, contrariamente a lo que

sugiere la intuicin, la proposicin campo != valor ser falsa cuando
el campo sea vaco (), es decir, no tenga ningn valor asignado. Si,
por lo tanto, se estn buscando las incidencias cuyo campo c satisfaga
el criterio c 6= v, incluso cuando el campo c est vaco, habr que
utilizar la proposicin (c 6= v) (c = ):
campo != valor or campo is empty
202
7.6. Operadores
Ejemplo 7.9. Para encontrar todas las incidencias asignadas a un
usuario distinto del usuario enrico ser necesario utilizar la proposicin:
assignee != enrico
o la proposicin:
not assignee = enrico
Ejemplo 7.10. Para encontrar todas las incidencias que no estn

asignadas al usuario enrico ser necesario utilizar la proposicin:
assignee != enrico or assignee is empty
Ejemplo 7.11. Para encontrar todas las incidencias que no hayan

sido reportadas por el usuario corriente, es decir, el usuario que est
efectuando la bsqueda, ser necesario utilizar la proposicin:
reporter != currentUser()
7.6.3
Operador greater than
El operador greater than (>) se utiliza cuando el valor de un campo

tiene que ser estrictamente mayor que el valor especificado1 .
Ejemplo 7.12. Para encontrar todas las incidencias no solucionadas que no hayan vencido todava ser necesario utilizar la siguiente
proposicin:
duedate > now() and resolution is empty
Ejemplo 7.13. Para encontrar todas las incidencias cuya prioridad

sea mayor que normal ser necesario utilizar la siguiente proposicin:
1 Debido a su naturaleza, el campo con el que se utiliza este operador tiene
que tener un tipo de valor para el cual exista una relacin de rden tales como las
fechas. Los campos de tipo texto, a pesar de que este tipo de campo suele poderse
ordenar, no pueden ser comparados utilizando este operador. Vase B.1.3 para
comprobar cuales operadores estn soportados por cada campo.
203
priority > normal
7.6.4
Operador greater than equals
El operador greater than equals () se utiliza cuando el valor de

un campo tiene que ser mayor o igual que el valor especificado2 .
Ejemplo 7.14. Para encontrar todas las incidencias que venzan a
partir del da 31 de Diciembre de 2008 incluido ser necesario utilizar
la siguiente proposicin:
duedate >= "2008/12/31"
Ejemplo 7.15. Para encontrar todas las incidencias que hayan sido creadas en los ltimos 7 das ser necesario utilizar la siguiente
proposicin:
created >= "-7d"
7.6.5
Operador less than
El operador less than (<) se utiliza cuando el valor de un campo

tiene que ser menor que el valor especificado3 .
Ejemplo 7.16. Para encontrar todas las incidencias que hayan sido
votadas menos que 4 ser necesario utilizar la siguiente proposicin:
votes <= 4
2 Vase
3 Vase
204
nota al pi 1.
nota al pi 1.
7.6. Operadores
7.6.6
Operador less than equals
El operador less than (<) se utiliza cuando el valor de un campo

tiene que ser menor o igual que el valor especificado4 .
Ejemplo 7.17. Para encontrar todas las incidencias que hayan sido actualizadas en las ltimas 4 semanas ser necesario utilizar la
siguiente proposicin:
updated <= "-4w"
7.6.7
Operador in
El operador in () se utiliza cuando el valor de un campo tiene que

pertenecer al conjunto de elementos especificados que se indicar con
la notacin (x, . . . , z). Como ya hemos subrayado en otra seccin
(6.1), la proposicin:
s {si , i [0, n]}
(7.4)
es equivalente a la siguiente proposicin:

(s = s0 ) (s = s1 ) (s = sn )
(7.5)
Por lo tanto, el operador in permite escribir proposiciones ms compactas y fciles de entender.

Ejemplo 7.18. Para encontrar todas las incidencias que hayan sido
abiertas o por enrico o por lourdes, ser necesario utilizar la siguiente
proposicin:
assignee in (enrico,lourdes)
Ejemplo 7.19. Para encontrar todas las incidencias que afecten a la

versin 3 o a la versin 4 ser necesario utilizar la siguiente proposicin:
affectedVersion in ("3", "4")
4 Vase
nota al pi 1.
205
7.6.8
Operador not in
El operador not in ()
/ se utiliza cuando el valor de un campo no
tiene que pertenecer al conjunto de elementos especificados.
Negando las proposiciones 7.4 y 7.5 se obtiene:
(s
/ {si , i [0, n]}) = ((s 6= s0 ) (s 6= s1 ) (s 6= sn ))
(7.6)
es decir, que el operador not in puede utilizarse para sustituir un

conjunto de proposiciones, relacionadas con el operador and, que comprueban que el campo no asuma ninguno de los valores especificados,
uno a la vez. Esto significa que, por ejemplo, la consulta JQL:
assignee not in (enrico,lourdes)
es equivalente a la consulta:
assignee != enrico and assignee != lourdes
El operador not in, como el operador in, permite simplificar algunas consultas y escribirlas con una notacin ms compacta y ms
fcil de entender.
Es importante subrayar que este operador tiene el mismo comportamiento del operador not equals (vase 7.6.2) cuando compara
campos vacos: si un campo c es vaco, c {ci , i [0, n]} ser siempre
falsa y, por lo tanto, las incidencias correspondientes no aparecern en
los resultados. Si se desea incluir las incidencias con el campo c vaco,
ser necesario aadirlas explicitamente en la consulta: c
/ C c = .
Ejemplo 7.20. Para encontrar todas las incidencias cuyo usuario
asignado no sea ni enrico ni lourdes ser necesario utilizar la siguiente
proposicin:
assignee not in (enrico,lourdes) or assignee is empty
7.6.9
Operador contains
El operador contains (3), un operador que se puede utilizar exclusivamente con campos de tipo texto, se utiliza para comprobar que un
campo tenga el valor especificado o un valor que se le parezca.
Cuando se utiliza contains, o para efectuar bsquedas de texto,
pueden utilizarse todas las funcionalidades descritas en 6.4, incluso
las bsquedas fuzzy. Vanse las secciones citadas para obtener mayor
informacin sobre la funcionalidad de este operador.
206
7.6. Operadores
Ejemplo 7.21. Para encontrar todas las incidencias cuyo ttulo contenga la frase problema de pantalla ser necesario utilizar la siguiente proposicin:
summary ~ "problema de pantalla"
Ejemplo 7.22. Para encontrar todas las incidencias cuyo ttulo contenga el trmino bug o los trminos parecidos con una bsqueda
fuzzy, ser necesario utilizar la siguiente proposicin:
summary ~ bug
Ejemplo 7.23. Para encontrar todas las incidencias cuyo ttulo contenga una palabra que comience con win, ser necesario utilizar la
summary ~ "win*"
7.6.10
Operador does not contain
El operador does not contain (63), o !, es el operador inverso del

operador contains (7.6.9): si un campo c satisface la proposicin
c 3 v, entonces no satisfar la proposicin c 63 v, y vice versa.
Este operador tiene el mismo principio de funcionamiento y est
sujeto a las mismas limitaciones del operador contains (vase 7.6.9
para mayor informacin).
Ejemplo 7.24. Para encontrar todas las incidencias que no satisfacen el criterio del ejemplo 7.22, es decir, cuyo ttulo no contenga el
trmino bug o trminos parecidos, ser necesario utilizar la siguiente
proposicin:
summary !~ bug
207
7.6.11
Operador is
Como explicado en las secciones dedicadas a otros varios operadores, el valor vaco () es un valor especial para un campo y las
proposiciones que involucran campos vacos no siempre devuelven el
resultado esperado. Simplificando, se puede pensar que, cuando un
campo c est vaco, c = , este campo no es comparable con ningn
valor no nulo ya que dicha proposicin devolver siempre no.
El operador is, y su inverso is not (7.6.12), sirve exclusivamente
para comprobar este particular estado: el operador is comprueba si
un campo est vaco, con el valor empty o null.
Ejemplo 7.25. Para encontrar todas las incidencias que tengan fecha
de vencimiento vaca ser necesario utilizar una de las dos siguientes
proposiciones:
duedate is null
duedate is empty
7.6.12
Operador is not
El operador is not, inverso del operador is (7.6.11), comprueba que

un campo no est vaco, comparndolo con el valor empty o null.
Ejemplo 7.26. Para encontrar todas las incidencias que tengan asignada una fecha de vencimiento (vase ejemplo 7.25) ser necesario
utilizar una de las dos siguientes proposiciones:
duedate is not null
duedate is not empty
7.7
rden de evaluacin
Cuando se compone una consulta JQL, as como cuando se componen

proposiciones lgicas, con operadores booleanos, el rden en el que se
ejecutan las evaluaciones es importante. JIRA, por defecto, evala las
proposiciones de una en una de izquierda a derecha. Si se considera
la consulta:
status = resolved and project = myproject or assignee = enrico
208
7.8. Auto-finalizacin de las consultas

llamado s el estado, p el proyecto y a el asignatario, JIRA la evaluar
de la siguiente forma:
(s = s0 ) (p = p0 a = a0 )
(7.7)
y devolver las incidencias resueltas, que pertenezcan al proyecto p0

o que hayan sido asignadas al usuario a0 .
Si lo que se desea es buscar las incidencias resueltas del proyecto
p0 o las incidencias asignadas a a0 ser necesario modificar la query
para establecer el rden en que se evalen las proposiciones. As como
se detall para otros tipos de bsqueda, en las bsquedas avanzadas
se utilizarn las parntesis para agrupar las sentencias. La query en
cuestin, por lo tanto, ser:
(status = resolved and project = myproject) or
assignee = enrico
Las parntesis tambin permiten utilizar el operador not para

negar una proposicin compuesta por otras proposiciones (utilizando
a = a):
(a b) = a b
(7.8)
y obtener una consulta ms compacta. La consulta:
not (status = resolved and assignee = enrico)
equivale a la consulta:
status != resolved or assignee != enrico)
7.8
Auto-finalizacin de las consultas
La interfaz grfica de bsquedas avanzadas de JIRA ofrece la funcionalidad de auto-finalizacin de las consultas: mientras el usuario
va tecleando la consulta JQL, JIRA va sugiriendo como sera posible
completar la consulta, tanto en lo que concierne los operadores, las
funciones y las palabras claves, como en lo que concierne los valores
de los campos. La tecnologa de auto-finalizacin determina de forma inteligente y de acuerdo a los datos introducidos por el usuario
aquellos fragmentos de consulta que, probablemente, el usuario ir a
teclear.
Si, por ejemplo, un usuario desea teclear la consulta:
assignee = enrico
209
y comienza a teclearla en el navegador de incidencias, en cuanto haya
teclado el carcter a, JIRA sugerir al usuario los dos campos cuyo
nombre comienza por a, es decir, affectedVersion y assignee,
como ilustrado en Figura 7.2. El usuario, entonces, podr seleccio-
Figura 7.2: Auto-finalizacin de un campo en una consulta JQL.
nar de la forma ms cmoda (con el teclado o con el ratn) el campo

deseado. Despus de haber seleccionado el campo, el usuario teclear
un espacio y JIRA sugerir los operadores que pueden utilizarse con
el campo en cuestin, como ilustrado en Figura 7.3. Despus de
Figura 7.3: Auto-finalizacin de un operador en una consulta JQL.
haber seleccionado el operador y haber tecleado otro espacio, JIRA

sugerir al usuario una posible lista de valores para el campo y el
operador que se han introducidos. En Figura ?? pueden verse los
usuarios sugeridos por JIRA despus de que el usuario teclease una
e: el nombre o la direccin de correo electrnico de los usuarios que
aparecen en el men desplegable de sugerencia comienzan todos con
la letra e.
El auto-finalizacin inteligente de consultas JQL es una herramienta poderosa que facilita mucho la labor de los usuarios a la hora
210
Figura 7.4: Auto-finalizacin de un valor en una consulta JQL.
de crearse una query JQL. A menudo no ser siquiera necesario recordar perfectamente los nombres de los campos, de los operadores
o de las funciones que JIRA pone a disposicin: ser la herramienta
misma quin facilitar al usuario los posibles trminos a introducir y,
por lo tanto, permitir la creacin de consultas de una forma rpida
y con errores mnimos.
Cuando se est tecleando una consulta, adems, JIRA informa
al usuario si la consulta que aparece en pantalla es vlida o no. En
Figura 7.3, por ejemplo, puede verse una seal de aviso, identificada por un tringulo amarillo con un punto exclamativo ( ), encima
del control en el cual se escriben las consultas JQL. En este caso la
consulta es invlida, todava, ya que falta por introducir tanto un
operador como un valor. En Figura 7.4, sin embargo, puede verse
que JIRA informa el usuario que la consulta es vlida con un crculo
verde y un tick ( ).
La funcionalidad de auto-finalizacin puede ser inhabilitada por el
administrador de JIRA a nivel global. Si la instancia de JIRA que se
est utilizando no proporciona esta funcionalidad, ser necesario solicitar a los administradores de la plataforma que habiliten la misma.
El usuario que lo desee, adems, puede inhabilitar la auto-finalizacin
durante la composicin de una consulta en el navegador de incidencia
utilizando el check-box Auto-complete debajo del campo de texto en
que se teclea la consulta, ilustrado en Figura 7.5.
El mecanismo de auto-finalizacin ofrece una lista de opciones en
las siguientes situaciones:
(i)
(ii)
(iii)
(iv)
Tecleando
Tecleando
Tecleando
Tecleando
un espacio al principio de una consulta.

algn carcter.
un espacio despus del nombre de un campo.
un espacio despus de un campo y un operador.
211
Figura 7.5: Formulario de creacin de consultas JQL.
(v) Teclando algn carcter despus de un campo y un operador.

El conjunto de resultados propuestos por JIRA ser compuesto por
los primeros 15 elementos que pueden completar el fragmento de consulta.
Si se teclea un espacio al principio de una consulta, (i), JIRA
sugerir los campos y los operadores con los cuales se puede comenzar la misma. En Figura 7.6, por ejemplo, puede verse la lista de
Figura 7.6: Auto-finalizacin de un campo en una consulta JQL.
sugerencias con algunos campos y el operador not.

212

Si se teclea algn carcter al principio de una consulta, (ii), JIRA
propondr la lista de campos cuyo nombre comienza con los caracteres introducidos. En Figura 7.7 puede verse la lista de sugerencias
cuando el usuario introduce como primer carcter la letra d.
Figura 7.7: Auto-finalizacin en consultas JQL Seleccin de campos.
Cuando el usuario teclea un espacio despus del nombre de un

campo, (iii), JIRA propondr la lista de operadores que pueden utilizarse con el mismo. En Figura 7.8 puede verse como, cuando el
usuario teclea un espacio despus del campo due, aparece la lista de
sugerencias que contiene los operadores soportados por dicho campo.
Figura 7.8: Auto-finalizacin en consultas JQL Seleccin de

operadores.
Despus de haber seleccionado el campo y el operador y tecleando

un espacio, (iv), JIRA proporcionar la lista de valores o funciones
que pueden completar la consulta introducida hasta ahora. En Figu213
ra 7.9 puede verse como, cuando el usuario teclea un espacio despus
del campo due y del operador >, aparece la lista de sugerencias que
contiene las funciones soportados por la combinacin de campo y operador introducida. Segn el usuario vaya tecleando otros caracteres,
Figura 7.9: Auto-finalizacin en consultas JQL Seleccin de valores y

funciones.
(v), JIRA filtrara la lista de resultados para ensear exclusivamente

los resultados que comiencen con los caracteres que el usuario est
tecleando.
7.9
Modificar una bsqueda avanzada con la interfaz de

bsqueda simple
Como subrayado mltiples veces a lo largo de 6, la interfaz de bsqueda simple no permite construir todas las consultas que pueden
expresarse con el lenguaje JQL. En 6.1.7 se ilustr como utilizar
la interfaz de bsqueda avanzada para modificar algunas consultas
simples, en casos muy sencillos.
Despus de haber aportado una modificacin que no puede implementarse en la interfaz de bsqueda simple, no es posible volver
a sta interfaz y JIRA avisar el usuario con un mensaje. Los casos
en que no es posible volver a la interfaz de bsqueda simple son los
siguientes:
(i)
(ii)
(iii)
(iv)
214
La consulta contiene el operador or ().

La consulta contiene el operador not ().
La consulta contiene el operador empty ().
La consulta contiene un operador de comparacin: !=, is, is
not, <, <=, > o >=.
7.9. Modificar una bsqueda avanzada con la interfaz de bsqueda simple

(v) La consulta contiene un campo relacionado con un proyecto pero
no incluye explcitamente un criterio sobre el proyecto (vase
Ejemplo 7.27).
Ejemplo 7.27. Una consulta JQL contiene un criterio que filtra las
incidencias por el campo fixVersion:
fixVersion = 1.0
De acuerdo al elemento (iv) de la lista de excepciones detallada en

7.9, la consulta no podr expresarse a travs de la interfaz de bsqueda simple, ya que no contiene explicitamente un criterio que utilice el
campo project.
Sin embargo si el usuario ha introducido la siguiente consulta JQL:
fixVersion = 1.0 and project = JRAGD
podr volver a la interfaz de bsqueda simple ya que sta cumple con

los requerimientos de dicho elemento.
215
8
Grabar una bsqueda en un filtro
JIRA permite grabar una bsqueda para poder almacenarla y utilizarla cuando sea necesario sin necesidad de volver a introducirla, ya
sea en la interfaz de bsqueda simple o en la interfaz de bsqueda
avanzada.
La funcionalidad de los filtros va ms all del simple almacenamiento. Los filtros son objetos sofisticados de JIRA que pueden:
(i) Utilizarse de forma sencilla, a travs del interfaz web de usuarios
de JIRA.
(ii) Buscarse.
(iii) Compartirse con otros usuarios.
(iv) Protegerse, a travs de polticas de seguridad.
(v) Modificarse y clonarse, para crear nuevos filtros.
La importancia de los filtros reside, adems, en su capacidad de
actuar como fuente de datos para otros objetos de JIRA. Los filtros, en este sentido, representan el conjunto de resultados de una
bsqueda y pueden utilizarse para:
(i) Visualizar los resultados en el navegador de incidencias. Los
usuarios podrn utilizar las herramientas de esta ventana para
actuar sobre los resultados como en el caso de, por ejemplo, una
exportacin a otro formato (9).
(ii) Visualizar los resultados en un reporte.
(iii) Utilizar los resultados en un gadget del cuadro de mandos.
(iv) Recibir notificaciones sobre los resultados del filtro.
Ejemplo 8.1. En un proyecto en el cual se definen acuerdos de nivel
de servicio es necesario establecer la prioridad, organizar la asignacin
217
8. Grabar una bsqueda en un filtro

y determinar el orden de resolucin de las incidencias, con el fin de
respetar los niveles de servicios establecidos.
En este caso de uso los responsables de proyecto pueden definir
un conjunto de filtro, de acuerdo a los parmetros que consideren
oportunos, que devuelvan el estado de las incidencias en cada nivel de
servicio y, utilizando estos datos, vayan estableciendo las prioridades
del trabajo.
Si, por ejemplo, se estn utilizando los siguientes 3 niveles de
servicio:
(i) Platinum: tempo de respuesta mximo de 1 hora.
(ii) Gold: tempo de respuesta mximo de 4 horas.
(iii) Silver: tempo de respuesta mximo de 8 hora.
se podrn crear filtros que devuelvan las incidencias en cada nivel que
no se hayan comenzado a investigar despus de un tiempo t, donde el
parmetro podr ajustarse de acuerdo a la experiencia acumulada y
al flujo de trabajo que vaya entrando. En el caso = .5, dichos filtros
devolvern las incidencias que todava estn sin comenzar despus de:
(i) Platinum: 30 minutos.
(ii) Gold: 2 horas.
(iii) Silver: 4 horas.
Los resultados de los filtros podrn utilizarse para crear notificaciones o reportes en cuadros de mandos personalizados y permitir a
los responsables de proyecto de tener una imagen del estado del servicio actualizada en tiempo real y de ser avisados tempestivamente
en el caso en que empiecen a observarse sntomas de retraso en las labores desempeadas por los miembros del equipo para tomar cuanto
antes medidas vueltas a mitigar el riesgo que se est corriendo.
En el ejemplo 8.4 se ver que mecanismos pueden utilizarse para
comunicarse tempestivamente con los operadores.
8.1
Organizacin de los filtros
Los filtros son objetos que, por defecto, pertenecen al usuario que
les ha creado y, por lo tanto, estn visibles exclusivamente en sus
sesiones de trabajo.
Muchas bsquedas, sin embargo, pueden cubrir las necesidades
de muchos usuarios. Los resultados de una bsqueda, por ejemplo,
puede proporcionar indicadores que pueden utilizarse en cuadros de
218
8.2. Creacin de un filtro

mandos de muchos perfiles de usuarios tales como jefes de equipo, de
componente o, incluso, clientes que utilicen JIRA como herramienta
de comunicacin con otros equipos. Por esta razn, los filtros pueden protegerse con polticas de seguridad que permiten compartirles
con un selecto conjunto de identidades. Todo usuario que tenga permiso para acceder a un filtro, podr disponer de l para ejecutarlo y
obtener los resultados de la bsqueda o para utilizarlo como fuente
de datos.
Los filtros pueden tambin ser objeto de bsquedas: los usuarios,
a travs de un buscador, podrn examinar los filtros existentes1 y
comprobar si existe un filtro que satisface sus necesidades.
Los filtros utilizados frecuentemente por un usuario pueden ser
marcados como filtros favoritos. De esta forma, el usuario podr
acceder a ellos de forma ms fcil y rpida ya que JIRA destacar
los favoritos en todos los controles que permiten acceder a los filtros
tal como, por ejemplo, el men Issues de la barra de herramientas de
JIRA, como ilustrado en Figura 8.1.
8.2
Creacin de un filtro
Para crear un filtro es necesario crear la bsqueda que se desea grabar; el usuario podr grabar una bsqueda creada con cualquiera de
las herramientas proporcionadas por JIRA, como explicado en los captulos 6 y 7. Cuando el usuario ha creado una consulta, en las
pestaas New o Edit del panel izquierdo de la ventana del navegador
de incidencias, JIRA proporcionar al usuario la posibilidad de grabar
la consulta corriente en un filtro. En Figura 8.2 puede ver el control
de creacin de filtros (el enlace Save it as a filter) en dos detalles
del panel izquierdo del navegador de incidencia. En la figura a la
izquierda puede verse el control en la pestaa Summary del panel,
mientras que en la figura a la derecha puede verse el mismo control
en la pestaa Edit. En ambos casos el control, as como otras operaciones, estar en la seccin Operations del panel, junto a las dems
operaciones que, en cada caso, puedan efectuarse en ese momento.
Para crear un filtro, es necesario efectuar las siguientes operaciones:
(i) Seleccionar el enlace Save it as a filter. El usuario ser llevado
a la ventana de creacin de filtro.
1 Un
usuario, incluso a travs del buscador de filtros, podr tener acceso exclusivamente al conjunto de filtros para los cuales tiene los permisos necesarios.
219
Figura 8.1: Filtros favoritos en la barra de herramientas de JIRA.
Figura 8.2: Creacin de filtros.
220
8.2. Creacin de un filtro

(ii) En la ventana de creacin de filtros, visible en Figura 8.3,
el usuario podr establecer el nombre y la descripcin del filtro
teclendolos, respectivamente, en el control Name y Description
del formulario.
Figura 8.3: Ventana de creacin de filtros.
(iii) Por defecto, un filtro creado por uno mismo es un filtro favorito (8.1), como puede verse por el control identificado con un
icono estrella amarilla ( ) en el formulario de creacin de filtro. Para crear el filtro sin aadirlo a la lista de los favoritos,
deseleccionar este control con un click del botn izquierdo del
ratn: ste control acta como un interruptor, el mismo se
volver gris ( ) y el filtro se excluir de los favoritos.
(iv) En el control Shares se detallan las listas de identidades con las
cuales se compartir el filtro. Por defecto, un filtro se comparte
con las identidades especificadas en el perfil de usuario. Si no se
ha especificado ninguna preferencia, se utilizar la preferencia
global, configurada por el administrador. Por defecto, un filtro
es privado y no se comparte con nadie.
(v) Opcionalmente, y siempre que el usuario posea el permiso Create shared object, se pueden aadir las identidades con las cuales
se desea compartir el filtro utilizando el control Add Shares del
formulario. Vase 8.8 para obtener mayores detalles sobre como compartir filtros con otros usuarios.
221

8.3
Sumario de un filtro
Cuando se ha seleccionado un filtro, en la barra de bsqueda del

navegador de incidencias aparece la pestaa Summary. En esta parte
de la ventana se ofrece un resumen de las caractersticas de un filtro
as como las operaciones disponibles que el usuario conectado puede
efectuar.
En Figura 8.4 puede verse el sumario de un filtro de un usuario.
En la parte superior de la ventana, en la seccin summary, se resume
Figura 8.4: Sumario de un filtro.
la siguiente informacin:
(i) Nombre del filtro.
(ii) Estado del flag favorito.
(iii) Criterio de bsqueda del filtro.
El estado del flag favorito ser indicado con un control identificado
con el icono estrella amarilla ( ) o estrella gris ( ) si el filtro es,
respectivamente, un filtro favorito o no. El control podr utilizarse
para cambiar este flag y aadir o remover el filtro seleccionado de la
lista de favoritos del usuario conectado.
El criterio de bsqueda del filtro ser resumido de forma distinta
dependiendo de si el criterio de bsqueda es un criterio simple (6) o
avanzado (7). Si la bsqueda es una bsqueda simple, se proporcionar la lista de los campos de bsqueda seleccionados por el creador
del filtro as como el valor seleccionado. Por otro lado, en el caso
222
8.4. Gestin de filtros

en que la bsqueda fuese avanzada, se proporcionar el texto de la
consulta en el lenguaje de query de JIRA.
En la seccin Operations de la ventana de sumario JIRA ofrecer
la lista de operaciones que el usuario puede efectuar sobre el filtro.
Las operaciones disponibles dependern de varios factores tales como
el autor del filtro y los privilegios del usuarios conectado.
Ejemplo 8.2. En la imagen de Figura 8.4 puede apreciarse como
el filtro se llame Unresolved issues y sea un filtro favorito del usuario
(indicado por el icono ).
La bsqueda del filtro es una bsqueda simple que especfica los
criterios project y status y los resultados se devuelven ordenados por
prioriy (prioridad) descendiente.
8.4
Gestin de filtros
La ventana de gestin de filtros permite ver, organizar y configurar

tanto los filtros propios como los filtros compartidos por otros usuarios. Para acceder a esta ventana es necesario seleccionar la operacin
Manage filters en el men Issues en la barra de herramientas de JIRA
(Figura 8.5).
Figura 8.5: Men Issues Operacin Manage filters.
223

Esta ventana est compuesta por las siguientes pestaas:
(i) Favorite: en esta pestaa el usuario tiene acceso directo a sus
filtros favoritos (Figura 8.6).
Figura 8.6: Ventana de gestin de filtros Pestaa Favorite.
(ii) My: en esta pestaa el usuario tiene acceso directo a sus filtros.
(iii) Popular: en esta pestaa, similar a la pestaa precedente, el
usuario tiene acceso a los filtros populares, es decir, los filtros
que muchos usuarios han marcados como favoritos. En esta
pestaa JIRA propondr al usuario los 20 filtros ms populares
entre los filtros al que el usuario tenga acceso.
(iv) Search: en esta pestaa, similar a la pestaa precedente, el
usuario puede efectuar bsquedas de filtros (Figura8.7).
Figura 8.7: Ventana de gestin de filtros Pestaa Search.
En esta ventana un usuario podr:

(i) Buscar filtros.
(ii) Aadir o remover filtros de la lista de favoritos.
(iii) Modificar y actualizar los filtros creados por l mismo.
224
8.5. Eliminar un filtro de la lista de favoritos

8.5
Eliminar un filtro de la lista de favoritos
El usuario puede modificar la lista de filtros favoritos aadiendo nuevos filtros o eliminando los filtros que ya no le interesan.
Para eliminar un filtro de la lista de favoritos es necesario efectuar
las siguientes operaciones:
(i) Localizar el filtro a eliminar de la lista de favoritos. El filtro
puede buscarse a travs del buscador de filtros (??) o navegando a la pestaa Favorite de la ventana de gestin de filtros,
(ii) Eliminar el filtro de la lista seleccionando el control identificado
con un icono estrella amarilla ( ). Despus de la eliminacin
el control se volver gris ( ) y se mostrar un aviso de eliminacin a travs del cual, en el caso la eliminacin hubiera sido
accidental, se podra anular la operacin. En Figura 8.8 puede verse el aviso de eliminacin y el control de anulacin de la
operacin, el enlace Undo.
Figura 8.8: Aviso de eliminacin de filtro favorito.
8.6
Aadir un filtro a la lista de favoritos
Todos los filtros creados por un usuario, por defecto y siempre que
no se haya explcitamente modificado esta opcin (8.2), son filtros
favoritos. Para aadir un filtro existente a la lista de filtros favoritos
(i) Localizar el filtro a eliminar de la lista de favoritos. El filtro
puede buscarse a travs del buscador de filtros (??) o navegando a la pestaa Favorite de la ventana de gestin de filtros,
225

(ii) Aadir el filtro a la lista de filtros favoritos utilizando el control
identificado con un icono estrella gris ( ). Despus de haber
aadido el filtro el control se volver amarillo ( ).
8.7
Modificacin de los atributos de un filtro
Durante la creacin de un filtro se establecen los siguiente algunos

atributos del filtro:
(i)
(ii)
(iii)
(iv)
Nombre.
Descripcin.
Favorito.
Identidades con los cuales se comparte.
El usuario al que pertenezca el filtro puede modificar estos atributos en cualquier momento efectuando las siguientes operaciones:
(i) Localizar el filtro a modificar. El filtro puede buscarse a travs
del buscador de filtros (??) o accediendo a la pestaa My en la
ventana de gestin de filtros (8.4) en la cual se enumeran los
filtros creados por el usuario conectado.
(ii) Seleccionar la operacin Edit en la columna Operations para
acceder a la ventana de modificacin de filtros que puede verse
en Figura 8.9.
Figura 8.9: Ventana de modificacin de un filtro.
226
8.8. Compartir un filtro con otros usuarios

(iii) En la ventana de modificacin pueden introducirse los nuevos
valores para los atributos que se desean modificar. Si se desean
modificar las identidades con las cuales se quiere compartir el
filtro es necesario seguir las instrucciones detalladas en 8.8.
(iv) Seleccionar el botn Save para confirmar la operacin.
8.8
Compartir un filtro con otros usuarios
Un filtro es una entidad que puede compartirse con otros usuarios

para favorecer la creacin y la explotacin de fuentes de datos que
puedan ser de utilidad general, por ejemplo para proporcionar datos
a utilizarse en la generacin de reportes.
Compartir filtros con otros usuarios tambin permite separar los
usuarios que explotan la informacin de los usuarios que organizan la
informacin y puede ser beneficioso en algunos casos de uso, como los
ilustrados en los ejemplos de esta seccin.
Sin embargo, la comparticin de una entidad genera un acoplamiento entre proveedores y consumidores de la informacin. Este
acoplamiento debe gestionarse adecuadamente como una dependencia y solo a travs de coordinacin es posible garantizar que eventuales modificaciones se hagan con el conocimiento y, eventualmente, el
acuerdo de los usuarios.
Los filtros pueden compartirse al momento de la creacin (8.2)
o posteriormente, modificando un filtro existente. En ambos casos,
tanto el procedimiento como la interfaz grfica utilizada para efectuar
esta operacin son los mismos.
Para poder compartir un filtro es necesario tener el permiso Create
shared object. Si el usuario no dispone de este permiso en las ventanas
de creacin y modificacin de filtro no sern visibles los controles para
compartir el filtro.
Para modificar las identidades con las cuales se desea compartir
el filtro es necesario efectuar las siguientes operaciones:
(i) Si se desea compartir el filtro durante su creacin, pasad directamente a (iii).
(ii) Localizar el filtro a compartir. El filtro puede buscarse a travs
del buscador de filtros (??) o accediendo a la pestaa My en la
ventana de gestin de filtros (8.4) en la cual se enumeran los
filtros creados por el usuario conectado.
(iii) En la ventana de modificacin del filtro pueden aadirse las
identidades con las cuales se desea compartir el filtro y elimi227

narse las identidades con las cuales no se desea seguir compartiendo el mismo. En Figura 8.10 pueden verse los controles
Shares y Add Shares que deben utilizarse para llevar a cabo
esta configuracin.
Figura 8.10: Controles para la modificacin de las identidades con las

cuales se comparte un filtro.
(iv) El control Shares detalla las identidades con las cuales se est
compartiendo un filtro. Para eliminar una identidad con la cual
ya no se desea seguir compartiendo el filtro corriente es necesario
utilizar el control identificado con el icono basura ( ).
(v) El control Add Shares contiene una serie de men a travs de
los cuales puede seleccionarse la identidad a aadir a la lista
de usuarios que comparten el filtro. En el primer men puede
seleccionarse el tipo de identidad:
a) Everyone, para grabar un filtro pblico que pueda ser utiliado por cualquier usuario de JIRA.
b) Group, para compartir el filtro con un grupo de usuarios.
c) Project, para compartir el filtro con un rol de proyecto.
Si se desea aadir un grupo, habr que seleccionar el elemento group en el control y JIRA propondr, como ilustrado en
Figura 8.11, la lista de grupos disponibles en otro control.
Figura 8.11: Compartir un filtro con un grupo de usuarios.
Si se selecciona aadir un rol de proyecto, habr que seleccionar

el elemento Project en el control y JIRA propondr, como ilustrado en Figura 8.12, la lista de proyectos disponibles y, para
cada proyecto que se seleccione, un control con la lista de roles
disponibles en el mismo.
228
8.8. Compartir un filtro con otros usuarios
Figura 8.12: Compartir un filtro con un rol de proyecto.
Para aadir la identidad seleccionada, pulsar el control Add,

identificado con el icono ms ( ) y repetir este paso hasta
que se hayan aadido todas las identidades con las cuales se
desea compartir el filtro.
Ejemplo 8.3. En el ejemplo 8.1 se ha visto como los filtros pueden
ser fuentes de datos tiles a la hora de obtener la informacin que se
necesita, de forma sencilla y actualizada en tiempo real.
Compartir filtros permite reutilizar los filtros existentes y, adems,
centralizar su gestin de forma que, si ms que un proyecto est sujeto
a las mismas polticas de servicio, no sea necesario modificar los filtros
de todos los proyectos sino, simplemente, el nico filtro que todos los
usuarios estn compartiendo.
En el caso que estamos ilustrando, por ejemplo, el filtro en cuestin podra ser utilizado poo el responsable de cualquier proyecto
simplemente utilizando oportunamente la proposicin
project = projectsLeadByUser
en el criterio de bsqueda utilizado por el filtro. De esta forma, el

filtro devolver solo las incidencias que estn cumpliendo los criterios
ilustrados en el ejemplo 8.1 en los proyectos gestionados por el usuario
que est utilizando el filtro.
Ejemplo 8.4. Los responsables del proyecto ilustrado en el ejemplo
8.1, en que se ofrece soporte de 3 niveles y cada uno con tiempos
de respuesta distintos, debe ser capaz de comunicar constantemente
con sus operadores para que las incidencias de nivel ms crtico se
vayan solucionando con antelacin sin dejar que sean los operadores
organicen el trabajo segn su albedro.
Una de las formas de solucionar este problema, complementaria a
los mecanismo estndar de JIRA tales como asignacin y prioridad
de incidencias, es proporcionar a los usuario un conjunto de filtros que
les proporcione los datos que cumplan los criterios que se hayan establecido a nivel de direccin de proyecto. De esta forma, en lugar de
229

dejar a los operadores la responsabilidad de examinar las incidencias
a ellos asignadas y determinar el orden de ejecucin de las labores, se
podr utilizar un filtro que les devuelva esta informacin.
Una ventaja adicional que deriva de la centralizacin en la gestin
de la informacin es que, en cada momento se decida modificar los parmetros utilizados para establecer el orden de trabajo, ser suficiente
modificar los relativos filtros ya que los usuarios que los compartan,
de forma inmediata, dispondrn de los datos actualizados.
Ejemplo 8.5. Con referencia al ejemplo 8.4, los campos que por defecto componen las incidencias de JIRA podran resultar insuficientes
a organizar la informacin requerida por los usuarios de forma eficiente.
El campo prioridad, a menudo utilizado para organizar el orden
de trabajo sobre las incidencias, se compone de un nmero finito,
normalmente reducido, de niveles. Utilizar este campo para ordenar
las incidencias, as como cualquier campo que adquiera un conjunto
de valores de tamao reducido, puede resultar ineficaz a los fines que
nos proponemos.
Una solucin comnmente utilizada es la creacin de campos personalizados (??) que puedan ordenarse (tales como los campos numricos, vase B.1.3) y utilizarlos como parmetros para establecer
el orden de trabajo sobre las incidencias.
8.9
Buscar un filtro
Debido a que los filtros son una funcionalidad muy comnmente utilizada por los usuarios de JIRA, no es inusual que en una instalacin
de la herramienta el nmero de filtros guardados sea elevado y que,
por lo tanto, el nmero de filtros visibles a un usuario, tantos propios
como compartidos por otros, sea grande.
Como descrito en precedencia, el usuario puede acceder rpidamente a algunas categoras de filtros, los filtros favoritos, los filtros
propios y los filtros populares, utilizando respectivamente las pestaas
Favorite, My y Popular de la ventana de gestin de filtros (8.4).
Sin embargo si el usuario necesita encontrar un filtro que no est
en ninguna una de estas ventanas ser necesario efectuar una bsqueda. Para facilitar esta tarea al usuario, JIRA ofrece el formulario de
bsqueda de filtros, ilustrado en Figura 8.13, al que se puede acceder
a travs de la pestaa Search de la ventana de gestin de filtros.
230
8.9. Buscar un filtro
Figura 8.13: Ventana de bsqueda de filtros.
A travs del formulario de bsqueda, el usuario podr acotar el

conjunto de filtros examinados utilizando los siguientes parmetros:
(i) Nombre y descripcin.
(ii) Autor.
(iii) Identidades con las que se comparte.
Para buscar un filtro es necesario efectuar las siguientes operaciones:
(i) Acceder a la ventana de gestin de filtros, seleccionando la operacin Manage filters en el men Issues en la barra de herramientas de JIRA.
(ii) Acceder a la ventana de bsqueda de filtros seleccionando la
pestaa Search en la ventana de gestin de filtros.
(iii) Si se desea efectuar una bsqueda de texto en el nombre o en
la descripcin del filtro, introducir el criterio de bsqueda en el
control Search.
(iv) Si se desea buscar entre los filtros creados por un usuario, introducir el nombre del usuario en el campo Author. Alternativamente, seleccionar el usuario utilizando la ventana de seleccin
de usuarios a la que se puede acceder a travs del control identificado por el icono ( ) situado a la derecha del control Author.
(v) Si se desea buscar entre los filtros que estn compartidos con
una identidad, seleccionar la identidad deseada en el control
Shared with. El funcionamiento de este control es parecido al
del control Add shares que ha sido detallado en 8.8.
(vi) Para confirmar la bsqueda, seleccionar el botn Search.
Los resultados de bsqueda sern visualizados en la parte inferior
de la ventana, como ilustrado en Figura 8.14. Los resultados podrn
231
Figura 8.14: Resultados de bsqueda de filtros.
ordenarse por los valores contenidos en algunas columnas, tales como

Name y Author, seleccionando el ttulo de la columna en la cabecera
de la tabla de resultados.
Seleccionando el nombre de un filtro en la lista de resultados,
JIRA establecer el filtro seleccionado como filtro corriente y llevar
el usuario directamente a la ventana de resultados de la bsqueda
asociada al filtro.
8.10
Copiar un filtro existente
Como explicado en 8.1, la funcionalidad de comparticin de filtros

permite centralizar la gestin de estas fuentes de datos y separar los
usuarios que explotan la informacin de los usuarios que organizan la
informacin. Esta funcionalidad tambin genera acoplamiento entre
proveedores, quienes definen un filtro compartido, y consumidores,
quienes utilizan el filtro.
En determinadas circunstancias, por lo tanto, los usuarios podran
preferir no tener que depender de un filtro que est fuera de su control:
de esta forma no corrern los riesgos relacionados con la dependencia con entidades de este tipo. El creador, por ejemplo, podra dejar
de compartir un filtro o, incluso, eliminarlo. El creador podra tambin modificar el criterio de bsqueda de un filtro y, por lo tanto,
quines estn utilizando esa fuente de datos podran estar recibiendo
datos que no corresponden a la bsqueda que estn esperando.
Para minimizar el trabajo del usuario en las situaciones en las cuales no es deseable acoplarse a un filtro compartido JIRA proporciona
la posibilidad de clonar un filtro existente: de esta forma, el usuario
podr crear una copia de un filtro y grabarlo en un filtro nuevo.
232
8.11. Modificacin de un filtro

La misma tcnica puede utilizarse tambin cuando quiere crearse
un filtro nuevo comenzando con los criterios grabados en otro filtro,
incluso del mismo usuario que est efectuando la copia.
Para copiar un filtro, es necesario efectuar las siguientes operaciones:
(i) Localizar y seleccionar el filtro que se desea copiar.
(ii) Seleccionar la pestaa Summary del panel de bsqueda.
(iii) Si el filtro es un filtro compartido por otro usuario, la lista
de operaciones disponibles ser reducida y parecida a la lista
ilustrada en Figura 8.15 (izquierda). Para copiar el filtro de
otro usuario es necesario seleccionar la operacin Create new
filter from current.
Figura 8.15: Resultados de bsqueda de filtros.
(iv) Si el filtro es un filtro propio, la lista de operaciones ser parecida a la lista ilustrada en Figura 8.15 (derecha). Para copiar un
filtro propio es necesario seleccionar la operacin Save as new
filter.
Despus de haber copiado el filtro se proceder como durante la
creacin de un filtro cualquiera. Las instrucciones para configurar un
nuevo filtro estn detalladas en 8.2.
8.11
Modificacin de un filtro
Un usuario no podr modificar filtros que no le pertenezcan: en este

caso la nica operacin permitida ser la copia (8.10) y la modifi233

cacin de la misma. El autor de un filtro, por el otro lado, puede
modificar el criterio de bsqueda asociado al mismo en cualquier momento. Sin embargo, por las razones explicadas en precedencia, es
aconsejable que un usuario que est compartiendo un filtro con otros
usuarios no modifique un filtro sin haberlo comunicado a los usuarios
que lo pueden estar utilizando.
Para modificar el criterio de bsqueda de un filtro es necesario
(i) Localizar y seleccionar el filtro que se desea copiar.
(ii) Seleccionar la pestaa Edit del panel de bsqueda.
(iii) Modificar el criterio de bsqueda en el navegador de incidencias
as como explicado en los Captulos 6 y 7, dependiendo del
tipo de bsqueda que se desee utilizar.
(iv) Si se utiliza la interfaz de bsqueda avanzada para modificar
el criterio de bsqueda, como ilustrado en Figura 8.16, las
operaciones disponibles sern visibles en la seccin Operations
de la pestaa Edit, en el lado izquierdo de la pgina. JIRA
Figura 8.16: Modificacin del criterio de bsqueda de un filtros.
informar al usuario de que existen modificaciones al filtro sin

grabar a travs del mensaje Filter modified since loading que
puede apreciarse en el lado izquierdo de la ventana.
(v) Si se utiliza la interfaz de bsqueda simple para modificar el criterio de bsqueda, como ilustrado en Figura 8.17, las operaciones disponibles no sern visibles en la pestaa Edit y solo sern
accesibles en la pestaa Summary. JIRA informar al usuario
de que existen modificaciones al filtro sin grabar a travs del
mensaje Filter modified since loading que puede apreciarse en
el lado izquierdo de la ventana.
234
8.12. Configurar el orden de columnas de un filtro
Figura 8.17: Modificacin del criterio de bsqueda de un filtros.
(vi) Para grabar las modificaciones en el filtro, seleccionar la operacin Save changes to filter. Para grabar las modificaciones en un
nuevo filtro y mantener el filtro original inalterado, seleccionar
la operacin Save as new filter.
8.12
Configurar el orden de columnas de un filtro
Como explicado en los captulos dedicados a las tecnologas de bsquedas ofrecidas por JIRA (??), las columnas visualizadas para los
resultados de bsqueda visualizados en el navegador de incidencias
dependern de las configuraciones que se hayan establecido tanto a
nivel de perfil de usuario como a nivel de sistema.
La configuracin del navegador de incidencia se determina navegando una jerarqua de configuraciones, ilustradas en Figura 8.18: la
configuracin que queda establecida es la primera configuracin que
JIRA encuentra a partir del nivel ms bajo de la jerarqua.
Figura 8.18: Jerarqua de configuracin del navegador de incidencias.
Sin embargo, los filtros aaden un elemento a esta jerarqua y JIRA ofrece la posibilidad de ignorar las configuraciones mencionadas
y asociar a un filtro una configuracin de columnas; la jerarqua de
configuraciones que JIRA analiza en este caso es la jerarqua ilustrada en Figura 8.19. De esta forma, si un filtro est asociado a una
configuracin de columnas personalizada, sta tendr la precedencia
con respeto a las dems configuraciones y ser la configuracin que
235
Figura 8.19: Jerarqua de configuracin del navegador de incidencias

Filtros.
quede establecida cuando JIRA visualice los resultados de bsqueda

de un filtro.
Por la naturaleza misma de los filtros y por el hecho de ser entidades que pueden compartirse entre usuarios, el autor de un filtro
podra querer proporcionar a los usuarios que utilicen sus resultados tanto el criterio de bsqueda como la configuracin de columnas
devueltas. Si esto no fuera posible, usuarios con configuraciones distintas que estuvieran utilizando el mismo filtro acabaran viendo los
mismos resultados pero, potencialmente, distintas columnas. Dependiendo de la naturaleza de la bsqueda asociada al filtro, este hecho
podra perjudicar el usuario y su comprensin de los datos devueltos.
Ejemplo 8.6. El conjunto de columnas utilizadas por defecto en la
configuracin por defecto del navegador de incidencias de JIRA no
incluye ninguna columna relacionada con el trabajo sobre las incidencias, como por ejemplo tiempo trabajado y porcentaje de trabajo
completado. Si un usuario deseara compartir un filtro cuyo criterio de
bsqueda est filtrando por columnas de este tipo, ser aconsejable
configurar el mismo de manera que dichas columnas aparezcan en los
resultados; de esta forma, los usuarios que utilicen los datos que proceden del filtro podrn ver los datos que el creador del filtro consider
importantes y que, por esa razn, utiliz en el criterio de bsqueda
del mismo.
Para establecer la configuracin de columnas asociada a un filtro
(i) Acceder a la ventana de configuracin del orden de columnas
del filtro que se desea modificar. Se puede acceder a la ventana
de configuracin del orden de columnas de un filtro tanto desde la ventana de gestin de filtros como desde el navegador de
incidencia, cuando un filtro est seleccionado. Desde le venta236
8.12. Configurar el orden de columnas de un filtro

na de gestin de filtro, se puede utilizar la operacin Columns
(Figura 8.20) del filtro que se desea modificar.
Figura 8.20: Ventana de gestin de filtros - Operaciones.
Desde la ventana del navegador de incidencias, cuando el filtro

a modificar est seleccionado, se puede utilizar la operacin Set
filters columns order del men Tools (Figura 8.21).
Figura 8.21: Navegador de incidencias - Configuracin de columnas de

un filtro.
(ii) En la ventana de configuracin de columnas se puede configurar

el orden de columnas del filtro de la misma forma en que se configura el orden de columnas del navegador de incidencias. Vase
6.3.1 para obtener mayores detalles sobre el procedimiento de
configuracin.
8.12.1
Modificar la configuracin de columnas de un filtro
La configuracin de columnas de un filtro puede modificarse utilizando

el procedimiento detallado a continuacin:
237

(i) Acceder a la ventana de configuracin del orden de columnas del
filtro que se desea modificar siguiendo las instrucciones detalladas en el la seccin precedente (8.12) teniendo en cuenta que,
cuando un filtro ya est asociado a una configuracin de columnas, la operacin que aparece en el men Tools del navegador
de incidencias ser Edit filters column order, como ilustrado en
Figura 8.22.
Figura 8.22: Navegador de incidencias Men Tools Modificacin

de la configuracin de columnas de un filtro.
(ii) Seguir las instrucciones detalladas en la seccin precedente (8.12)

para modificar la configuracin de columnas del filtro.
8.12.2
Eliminar la configuracin de columnas de un filtro
La configuracin de columnas de un filtro puede eliminarse para que

los resultados devueltos por un filtro vuelvan a mostrarse con la configuracin de columnas establecida a nivel de perfil de usuario o, en
su defecto, a nivel de plataforma.
Para eliminar la configuracin de columnas de un filtro es necesario
(i) Acceder a la ventana de configuracin del orden de columnas del
filtro que se desea modificar siguiendo las instrucciones detalladas en el la seccin precedente (8.12) teniendo en cuenta que,
cuando un filtro ya est asociado a una configuracin de columnas, la operacin que aparece en el men Tools del navegador
de incidencias ser Edit filters column order, como ilustrado en
Figura 8.22.
238
8.13. Utilizar la configuracin de columnas por defecto

(ii) Seleccionar la operacin Remove filters column order (Figura
8.23) para eliminar la configuracin de columnas asociada al
filtro.
Figura 8.23: Navegador de incidencias Eliminar configuracin de

columnas de un filtro.
8.13
Utilizar la configuracin de columnas por defecto
En las secciones precedentes hemos visto como JIRA proporciona una

grande flexibilidad a la hora de configurar las columnas a utilizarse en el navegador de incidencias. En determinadas situaciones, no
obstante, un usuario quisiera utilizar una configuracin de columnas
distintas a la establecida en el filtro. Esta situacin cobra mayor importancia en el caso en que se est utilizando un filtro compartido por
otro usuario y, por lo tanto, no pueda modificarse su configuracin de
orden de columnas.
Para utilizar la configuracin de columnas del usuario, determinada con el procedimiento detallado en 8.12, puede utilizarse la operacin Use your default column order del men Tools del navegador
de incidencias, como ilustrado en Figura 8.24 izquierda. Si se desea
volver a utilizar la configuracin de columnas especificada por el filtro
corriente, ser suficiente utilizar la operacin Use filters column order
del men Tools (Figura 8.24 derecha) para que JIRA presente los resultados del filtro corriente en el navegador de incidencias utilizando
dicha configuracin.
239
Figura 8.24: Navegador de incidencias Seleccin de la configuracin

de columnas.
8.14
Configuracin de columnas y exportacin de datos
A lo largo de este captulo se han ilustrado las funciones que ofrece

JIRA para compartir filtros entre usuarios y personalizar, incluso, las
columnas que JIRA visualice cuando ofrezca los resultados al usuario.
Sin embargo, la configuracin del orden de columnas no afecta slo
a los resultados visualizados en la ventana del navegador de incidencias: como se ver en el siguiente captulo, JIRA permite exportar
los resultados de bsquedas en mltiples formatos para permitir al
usuario de explotar los datos ms fcilmente. Como se ver, la configuracin de columnas afectar la operacin de exportacin de datos
ya que, en determinadas circunstancias, sta determinar cuales sern
las columnas exportadas.
240
9
Explotar los resultados de bsqueda
En los captulos precedentes se ha visto como los filtros permiten
grabar criterios de bsquedas para, entre otras cosas, utilizarlos como
fuente de datos en objetos como los gadgets.
Sin embargo, los resultados de una bsqueda o de un filtro pueden
explotarse tanto dentro JIRA, como por ejemplo para generar reportes
o grficos en el cuadro de mandos, como fuera de JIRA. JIRA, a travs
del navegador de incidencias, permite exportar los resultados de una
bsqueda a muchos formatos de uso comn, entre los cuales:
(i)
(ii)
(iii)
(iv)
9.1
XML.
Microsoft Word.
Microsoft Excel.
Correo electrnico.
Suscribirse a un filtro
JIRA permite a los usuarios suscribirse a un filtro y recibir peridicamente, de forma automtica, los resultados de los filtro a travs
de un correo electrnico. El usuario podr especificar la periodicidad
con la cual JIRA volver a ejecutar el filtro y tambin si el usuario
desea recibir un correo incluso cuando el filtro no devuelve ningn
resultado.
Con esta funcionalidad, el usuario podr observar la evolucin
de un conjunto de incidencias sin la necesidad de acceder a JIRA
y, en algunos casos, emplear este mecanismo como una herramienta
de notificacin: el lugar de controlar activamente el estado y la
evolucin de las incidencias a observar, JIRA avisar al usuario
envindole los resultados.
241
9. Explotar los resultados de bsqueda

Ejemplo 9.1. Un proyecto debe garantizar un conjunto de acuerdos
de nivel de servicio (ANS) y, para controlar ms fcilmente el estado
del trabajo, el jefe de proyecto prepara un conjunto de filtros, uno
para cada nivel de servicio a controlar, que devuelve la lista de incidencias que han pasado la fecha lmite de resolucin y estn todava
sin resolver. Un fragmento de criterio de bsqueda que devuelve las
incidencias no resueltas que hayan sido creadas en los ltimos n das
es el siguiente:
... resolution = unresolved and created <= -nd ...
Mientras se respeten los acuerdos de nivel de servicio, los filtros en

cuestin no devolvern ningn resultado. Un usuario que se suscriba
a ellos podr elegir no recibir ningn correo hasta que los mismos
devuelvan algn resultado y, de esta forma, ser avisado en el momento
en que no se estn respetando los acuerdos.
Para suscribirse a un filtro es necesario efectuar las siguientes operaciones:
(i) Localizar el filtro al que se desea subscribirse en la ventana de
gestin de filtros, siguiendo las instrucciones detalladas en 8.4.
(ii) Seleccionar la operacin Subscribe en la columna Suscriptions
del filtro al que se desea suscribirse, como ilustrado en Figura
9.1.
Figura 9.1: Suscripcin a filtro.
(iii) Rellenar el formulario de suscripcin que JIRA presentar e

ilustrado en Figura 9.2 como detallado a continuacin.
(iv) Seleccionar en el campo Recipients las identidades que recibirn
las notificaciones. Este campo permite seleccionar a uno mismo, escogiendo la opcin Personal subscription, o a un grupo
cualquiera de los grupos de usuarios de la plataforma.
242
9.1. Suscribirse a un filtro
Figura 9.2: Formulario de suscripcin a un filtro.
(v) Seleccionar el checkbox Email zero results si se desea recibir una

notificacin incluso cuando el filtro no devuelve ningn resultado. Por defecto, este checkbox no est seleccionado.
(vi) Seleccionar la periodicidad con la cual se desea recibir las notificaciones escogiendo una de las opciones del campo Schedule.
Las opciones disponibles estn detalladas en 9.1.1.
(vii) Pulsar el botn Subscribe para suscribirse al filtro.
9.1.1
Periodicidad
La frecuencia que un usuario puede escoger cuando se suscribe a un

filtro es una de las siguientes:
(i) Daily: el usuario recibir las notificaciones todos los das.
(ii) Days per week: el usuario recibir las notificaciones los das de
la semana que haya escogido.
(iii) Days per month: el usuario recibir las notificaciones los das
del mes que haya escogido.
(iv) Advanced: el usuario recibir las notificaciones como determinado por la expresin de tipo cron que se haya introducido.
Seleccionando la opcin Daily (i), el usuario recibir las notificaciones todos los das a un intervalo prefijado, seleccionado con el
campo Interval, y a una hora prefijada, seleccionada con los campos
at. Por defecto, el intervalo entre una notificacin y otra son 24 horas (once). Los valores que puede asumir el campo Interval estn
resumidos en Tabla 9.1.
243

Intervalos
24 horas
3 horas
2 horas
1 hora
30 minutos
15 minutos
Tabla 9.1: Tipos de campos JQL.
Si el usuario selecciona recibir ms que una notificacin a lo largo

del da y escoge por lo tanto un intervalo distinto del intervalo 24
horas, JIRA proporcionar al usuario la posibilidad de seleccionar la
franja horaria dentro de la cual el usuario desea recibir las notificaciones. La franja horaria [t0 , t1 ] se seleccionar especificando la hora
de comienzo t0 en el campo from y la hora de fin t1 en el campo to del
formulario de suscripcin ilustrado en Figura 9.3. De esta forma, se
Figura 9.3: Formulario de suscripcin a un filtro Seleccin de franja

horaria.
podr evitar de recibir notificaciones intilmente en horarios en los

cuales el usuario no est interesado a ellas.
Seleccionando la opcin Days per week (ii), el usuario recibir las
notificaciones con la frecuencia y en los das de la semana escogidos.
En el formulario de Figura 9.4 el usuario podr seleccionar los das
de las semanas en los cuales desea recibir las notificaciones marcando
244

los checkbox correspondientes a cada uno de ellos. Como en el caso
Figura 9.4: Formulario de suscripcin a un filtro Seleccin de das de

la semana.
(i), el interval podr asumir los valores especificados en Tabla 9.1

y, cuando aplique, especificar la franja horaria en la cual recibir las
notificaciones como explicado anteriormente.
Seleccionando la opcin Days per month (iii), el usuario recibir
las notificaciones en el da del mes y el ha hora escogida. En el
formulario de Figura 9.5 el usuario podr seleccionar el da del mes
en el cual desea recibir las notificaciones de dos formas:
(i) Especificando el ordinal del da.
(ii) Especificando el da de la semana y el ordinal de la semana del
mes.
Como en los casos precedentes, el momento en que se desea recibir la
notificacin se escoger utilizando los controles at.
Si la periodicidad con la cual el usuario desea recibir las notificaciones no encaja con ninguna de las opciones descritas en precedencia,
ste puede utilizar la modalidad avanzada seleccionando Advanced en
el control Schedule. En esta modalidad, el usuario podr especificar
245
Figura 9.5: Formulario de suscripcin a un filtro Seleccin de das del

mes.
una expresin de tipo cron en el campo Cron expression, ilustrado

en Figura 9.6. cron es un planificador de procesos utilizado en los
Figura 9.6: Formulario de suscripcin a un filtro Expresin cron.
sistemas operativos UNIX y UNIX-like cuya sintaxis de los ficheros

de configuracin, muy conocida, puede ser utilizada por los usuarios
de JIRA para definir suscripciones avanzadas.
La sintaxis de los ficheros de configuracin de cron es la siguiente:
|{z}
|{z}
|{z}
|{z}
segundos minutos horas da del mes
246
|{z}
|{z}
|{z}
mes
da de la semana
ao
(9.1)

Los campos, separados por espacios, pueden asumir los valores especificados en Tabla 9.2 teniendo los caracteres especiales el significado
detallado en Tabla 9.3.
Campo
Valores
Caracteres especiales
Segundos
Minutos
Horas
Da del mes
Mes
Da de la semana
Ao
[0, 59]
[0, 59]
[0, 23]
[1, 31]
[1, 12] o [Jan, Dec]
[1, 7] o [Sun, Sat]
[1970, 2099]
,
,
,
,
,
,
,
*
*
*
*
*
*
*
/
/
/
/ ?
/
/ ?
/
L W
L #
Tabla 9.2: Valores de los campos de una expresin cron de JIRA.
Carcter especial
*
,
/
?
L
W
#
Significado
Todos los posibles valores.
Lista de valores.
Intervalo de valores.
Incremento sobre un valor.
Ningn valor.
ltimo posible valor.
Da de la semana (de lunes a viernes).
n-esima ocurrencia de un da de la semana.
Tabla 9.3: Significado de los caracteres especiales de una expresin cron

de JIRA.
Ejemplo 9.2. Para recibir una notificacin cualquier da de la semana a las 10.00 de la maana se puede utilizar la expresin:
0 0 10 ? * *
Ejemplo 9.3. Para recibir una notificacin cualquier da de la semana, cada minuto entre las 10.00 y las 11.00 se puede utilizar la
expresin:
0 * 10 * * ?
247

9.1.2
Cualquier valor
El carcter * se utiliza para asignar cualquier valor vlido a un campo1 :

. . * . . . .
En este caso, se est asignando al campo hora cualquier valor vlido,

es decir, todos los valores del intervalo [0, 23].
El carcter ?, sin embargo, se utiliza cuando se necesita especificar
un valor a uno de los campos das del mes o da de la semana pero
ninguno al otro2 :
. . . ? . * .
En este caso, se est asignando cualquier al campo da del mes y

cualquier valor al campo da de la semana.
9.1.3
Listas de valores
El carcter , se utiliza para separar valores y asignar listas de valores

a un campo3 :
. . 9,12 . . . .
En este caso, se estn asignando al campo hora los valores 9 y 12.

Ejemplo 9.4. Para recibir una notificacin cualquier da de la semana, cada minuto entre las 10.00 y las 11.00 y entre las 12.00 y las
13.00 se puede utilizar la expresin:
0 * 10,12 * * ?
Ejemplo 9.5. Para recibir una notificacin cualquier Mircoles de

Marzo, a las 10.00 y a las 10.30, se puede utilizar la expresin:
0 0,30 10 ? 3 4
Alternativamente, para que sea ms fcil de leer, se puede utilizar la

expresin:
1 El carcter . se utiliza para marcar la posicin de un campo cuyo valor no
se est ignorando.
2 Vase nota 1.
3 Vase nota 1.
248

0 0,30 10 ? Mar Wed
9.1.4
Intervalo de valores
El carcter - se utiliza para separar dos valores y asignar un intervalo

de valores a un campo4 :
. . 9-12 . . . .
En este caso, se estn asignando al campo hora el intervalo de valores entre 9 y 12 y, por lo tanto, el campo asumir todos los valores
comprendidos entre los extremos del mismo.
Ejemplo 9.6. Para recibir una notificacin cualquier da de la semana, cada hora entre las 9.00 y las 18.00, se puede utilizar la expresin:
0 0 9-18 * * ?
Ejemplo 9.7. Para recibir una notificacin cualquier da de la semana, cada media hora entre las 9.00 y las 18.00, se puede utilizar la
expresin:
0 0,30 9-18 * * ?
Ejemplo 9.8. Para recibir una notificacin cualquier da de la semana entre Lunes y Viernes, cada media hora entre las 9.00 y las 18.00,
se puede utilizar la expresin:
0 0,30 9-18 ? * 2-6
4 Vase
nota 1.
249

9.1.5
Incremento de un valor
El carcter / se utiliza para especificar un incremento a un valor de

un campo, el valor inicial, y asignar al mismo todos los valores que
se obtienen sumando el incremento al valor inicial5 :
. . 0/2 . . . .
En este caso, se est asignando al campo hora cualquier valor vlido

obtenido aadiendo el incremento 2 al valor inicial 0, es decir, los
valores {0, 2, 4, . . . , 22}.
Ejemplo 9.9. Para recibir una notificacin cualquier da de la semana, cada 10 minutos, se puede utilizar la expresin:
0 0/10 * * * ?
Ejemplo 9.10. Para recibir una notificacin cualquier da de la semana, cada 5 minutos entre las 9.00 y las 18.00, se puede utilizar la
expresin:
0 0/5 9-17 * * ?
9.1.6
ltimo valor
El carcter L se utiliza para asignar a un campo el ltimo posible

valor vlido y puede utilizarse, adicionalmente, con los formatos especificados6 en Tabla 9.4.
Formato
L
xL
LW
Significado
ltimo posible valor.

ltimo da x del mes.
ltimo da laborable del mes.
Tabla 9.4: Significado de los caracteres especiales de una expresin cron

de JIRA.
5 Vase
nota 1.
Tabla 9.4 los smbolos w y m identifican, respetivamente, los campos da
de la semana y da del mes.
6 En
250

El formato bsico con el que se puede utilizar este carcter especial
es7 :
. . . L . . .
En este caso, se est asignando al campo da del mes el ltimo valor vlido. Dependiendo del mes corriente, por lo tanto, este campo
asumir uno de los valores en el conjunto {28, 29, 30, 31}.
Este carcter especial se puede utilizar con el campo da de la
semana con el formato xL, donde x es un valor vlido para el campo:
en este caso significar el ltimo da x del mes.
Este carcter especial tambin se puede utilizar con el campo da
del mes en el formato LW: en este caso significar el ltimo da (entre
lunes y viernes) del mes.
Ejemplo 9.11. Para recibir una notificacin el ltimo da del mes,
a las 10.00 de la maana, se puede utilizar la expresin:
0 0 10 L * ?
Ejemplo 9.12. Para recibir una notificacin el ltimo da laborable

(entre Lunes y Viernes) del mes, a las 10.00 de la maana, se puede
utilizar la expresin:
0 0 10 LW * ?
Ejemplo 9.13. Para recibir una notificacin el ltimo Viernes del

mes, a las 10.00 de la maana, se puede utilizar la expresin:
0 0 10 ? * 6L
9.1.7
Ocurrencias
El carcter # se utiliza para especificar la n-esima ocurrencia de un

valor del campo da de la semana 8 :
. . . . . 6#2 .
7 Vase
8 Vase
nota 1.
nota 1.
251

En este caso, se est asignando al campo da de la semana la segunda
ocurrencia del valor 6, de decir, el segundo Viernes del mes.
Ejemplo 9.14. Para recibir una notificacin el segundo Viernes del
mes, a las 10.00 de la maana, se puede utilizar la expresin:
0 0 10 ? * 6#2
9.2
Recibir resultados de bsqueda en un feed RSS
JIRA permite recibir los resultados de una bsqueda a travs de un

feed RSS v. 2.0 y la bsqueda a la que est asociado un feed RSS
puede ser una bsqueda grabada como filtro o una bsqueda de recin
creacin y visualizada en el navegador de incidencias. Como detallado
en 6.2, los feeds pueden devolver datos de incidencia o comentarios.
Para limitar el nmero de resultados devueltos en el feed RSS, JIRA prev la utilizacin de un parmetro de solicitud HTTP, tempMax,
a travs del cual el usuario puede escoger el tamao de la pgina de
resultados.
Para suscribirse a un feed RSS asociado a una bsqueda, es necesario efectuar las siguientes operaciones:
(i) Utilizar el navegador de incidencias como detallado en ste captulo para construir la consulta deseada.
(ii) Seleccionar la operacin deseada en el men Views (6.2.2): RSS
(Issues) si se desea un feed que devuelva los datos de las incidencias o RSS (Comments) si se desea un feed que devuelva los
comentarios de las incidencias.
(iii) Copiar el enlace del feed RSS de la barra de navegacin del navegador. Algunos navegadores, como ilustrado en Figura 9.7,
pueden visualizar el feed RSS y facilitar herramientas adicionales tales como un lector de feed RSS.
(iv) Opcionalmente, modificar el valor del parmetro de solicitud
HTTP tempMax. El valor de este parmetro determina el nmero mximo de resultados devueltos en el feed RSS y, por
defecto, su valor es 1000.
El URL del feed RSS podr utilizarse con un lector de feeds; los
lectores de feeds RSS permiten examinar fcilmente la informacin
contenida en los feeds y notificar el usuario cuando la informacin
252
9.2. Recibir resultados de bsqueda en un feed RSS
Figura 9.7: Feed RSS de JIRA visualizado en el navegador Apple Safari.
devuelta vara. Algunos clientes de correo electrnico muy difundidos tales como Apple Mail o Mozilla Thunderbird integran en sus
funciones la capacidad de recibir feeds RSS.
Si el feed RSS devuelto por JIRA est vaco, comprobar que el
usuario tiene los permisos necesarios para acceder a dicha informacin. Para autenticar el usuario que accede a JIRA utilizando un feed
RSS, vase 9.2.1.
9.2.1
Autenticar el usuario de un feed RSS
La informacin publicada a travs de un feed RSS podra ser informacin confidencial y, por lo tanto, el usuario deber autenticarse para
poder acceder a los datos solicitados. Para acceder a la informacin
confidencial el usuario puede utilizar una de las siguientes tcnicas:
(i) Utilizar los parmetros de solicitud HTTP os_username y os_password para enviar sus credenciales a JIRA.
(ii) Utilizar el parmetro de solicitud HTTP os_authType con el
valor basic para utilizar el protocolo de autenticacin HTTP
253

bsico.
El problema de ambos mtodos es que las credenciales del usuario
viajarn en claro a travs de la red y sern entonces susceptibles de ser
interceptadas por usuarios maliciosos. Es importante notar que, de
todos modos, esto no es un problema limitado a los feeds RSS sino que
es un problema comn a toda la plataforma cuando se est utilizando
el protocolo HTTP, como explicado en el captulo de instalacin. Para obtener mayor informacin acerca de los problemas de seguridad
que existen utilizando JIRA a travs del protocolo HTTP as como
instrucciones para utilizar JIRA a travs del protocolo HTTPS, vase
??.
9.3
Recibir resultados de bsqueda en XML
JIRA permite recibir los resultados de una bsqueda en formato XML.

El formato XML es un formato ideal para proporcionar los resultados
de bsqueda a otra herramienta que efecte un post-procesamiento
de los datos. Muchos plugins utilizan este formato para procesar la
informacin recibida y formatearla en el cuadro de mandos de JIRA
u de otra aplicacin: la macro JIRA Issue de Atlassian Confluence,
por ejemplo, utiliza este formato para recibir y utilizar informacin
que proviene de JIRA en las pginas de Confluence. Este formato
puede utilizarse si se est utilizando un lector de feeds RSS v. 0.9.29 .
Uno de los caminos de integracin con JIRA, por lo menos en lo
que concierne los casos de uso en los cuales JIRA sea simplemente
una fuente de datos, es utilizar este formato para el intercambio de
informacin. Uno de los objetivos que llev a la definicin del formato XML era la necesidad de definir un formato de documento que
fuera fcil de leer y procesar de forma mecanizada: la mayora de los
lenguajes de programacin y de los frameworks de uso comn, hoy
en da, proporcionan las herramientas necesarias para leer y generar
flujos de datos en formato XML. Integrar JIRA como fuente de datos
en una plataforma que sea capaz de entender el formato XML es
fcil, aunque fuera de los objetivos de este documento.
La utilizacin del XML que se hace en JIRA no est pensada para
el uso por parte de un ser humano. No obstante, estas instrucciones
son necesarias para determinar el URL a travs del cual JIRA publicar los resultados de una bsqueda y poder as proporcionar dicha
direccin a la aplicacin que la utilice.
9 Si
254
est utilizando RSS v. 2.0, vase 9.2
9.4. Exportar resultados de bsqueda a Microsoft Word

Para obtener los resultados de una bsqueda en formato XML es
(ii) Seleccionar la operacin XML en el men Views (6.2.2).
(iii) Copiar el enlace que aparece en la barra de navegacin del navegador.
(iv) Opcionalmente, modificar el valor del parmetro de solicitud
HTTP tempMax. El valor de este parmetro determina el nmero mximo de resultados devueltos en el documento XML y,
por defecto, su valor es 1000.
(v) Opcionalmente, configurar los campos que sern devueltos en el
documento XML siguiendo las instrucciones detalladas a continuacin (9.3.1). Por defecto, JIRA devolver todos los campos
en el documento generado.
9.3.1
Seleccin de campos devueltos en el documento
JIRA, por defecto, devolver todos los campos en el documento XML

generado. Para facilitar la explotacin de la informacin contenida
en el documento XML devuelto y reducir el tamao del documento recibido, el usuario puede especificar cuales campos incluir en el
documento utilizando el parmetro de solicitud HTTP field. El
parmetro field puede asumir un conjunto de valores detallados a
continuacin y, para incluir mltiples campos, ser suficiente incluir
en el URL del documento XML el parmetro field tantas veces como
sea necesario:
...&field=campo1&field=campo2&...
Los posibles campos que puedan incluirse en el documento XML,

los correspondientes valores del parmetro field y ejemplos de fragmentos de documento XML generados pueden encontrarse en A.
9.4
Exportar resultados de bsqueda a Microsoft Word
JIRA permite exportar los resultados de bsqueda a un documento de

Microsoft Word. Esta funcionalidad es til cuando el usuario necesite
incluir resultados de bsquedas en un documento, por ejemplo para
redactar un informe de seguimiento o de estado del arte.
255

Para exportar los resultados a un documento de Microsoft Word
(ii) Seleccionar la operacin Word en el men Views (6.2.2).
(iii) JIRA generar un file Microsoft Word y, dependiendo del navegador y del sistema operativo utilizado, se abrir en el navegador
o ser descargado a una carpeta local.
En Figura 9.8 puede verse un ejemplo de documento Microsoft
Word generado a partir de una bsqueda en JIRA.
Figura 9.8: Ejemplo de documento Microsoft Word generado de una

bsqueda en JIRA.
Es importante subrayar que, durante la exportacin de resultados

de bsqueda a Microsoft Word, JIRA exportar todos los campos de
la incidencia, con independencia de la configuracin de campos activa
durante la exportacin.
9.5
Exportar resultados de bsqueda a Microsoft Excel
Poder exportar los resultados de una bsqueda a Microsoft Excel

es una funcionalidad til para los usuarios que necesitan recoger los
datos de una bsqueda para tratarlos a posteriori: creacin de reportes, filtrados de datos, agregaciones, grficos son solo algunas de
las operaciones que pueden hacerse con Microsoft Excel sobre un conjunto de datos.
256
9.6. Visualizar los resultados en un grfico

Para exportar los resultados a un documento de Microsoft Excel
(ii) Seleccionar la operacin Excel (All fields) o Excel (Current fields)
en el men Views (6.2.2): la primera operacin permite exportar todos los campos de las incidencias encontradas y la segunda
permite exportar solo los campos configurados en el navegador
de incidencias (vanse ?? y 8.12).
(iii) JIRA generar un file Microsoft Excel y, dependiendo del navegador y del sistema operativo utilizado, se abrir en el navegador
o ser descargado a una carpeta local.
En Figura 9.9 puede verse un documento Microsoft Excel generado a partir de una bsqueda en JIRA.
Figura 9.9: Ejemplo de documento Microsoft Excel generado de una

bsqueda en JIRA.
9.6
Visualizar los resultados en un grfico
El navegador de incidencias de JIRA permite ver rpidamente los

resultados de una bsqueda en uno de los tipos de grficos disponibles,
detallados a continuacin. El usuario que haya generado un grfico
tendr adems la posibilidad de grabar el grfico en un gadget del
cuadro de mandos de forma muy sencilla.
257

Los tipos de grficos que JIRA ofrece incluyen, entre otros:
(i) Average age. Grfico de la edad media de una incidencia sin
resolver (Figura 9.13).
(ii) Created vs. resolved issues. Grfico de la diferencia entre incidencias creadas y resueltas. El grfico, que opcionalmente
puede ser cumulativo, dibujar areas rojas cuando la diferencia
es positiva y verde cuando la diferencia es negativa (Figura
9.16).
(iii) Resolution time. Grfico de barra del tiempo10 de resolucin
medio de las incidencias (Figura 9.12).
(iv) Pie chart. Grfico de torta de las incidencias agrupadas por
cualquier tipo de estadstica (asignatario, estado, prioridad, etc.)
(Figura 9.12).
(v) Recently created. Grfico de barra cuya parte verde son las incidencias resueltas y cuya parte roja son las incidencias creadas
y no resueltas (Figura 9.12).
(vi) Time since. Grfico de barra que relaciona fechas con el nmero
de incidencias que tenan un campo de tipo fecha, seleccionado
por el usuario, igual a la fecha en grfico (Figura 9.15).
Para visualizar los resultados de una bsqueda en un grfico, es
(i) En la ventana de resultados del navegador de incidencias, seleccionar la operacin Charts en el men Views debajo de la barra
de herramientas, como ilustrado en Figura 9.17.
(ii) Seleccionar el grfico que se desea visualizar en la ventana de
seleccin presentada por JIRA.
(iii) Si se desea modificar los parmetros de configuracin del grfico
seleccionado, pulsar el control identificado con un engranaje
ilustrado en Figura 9.18, personalizar los parmetros del grfico y pulsar el botn Save.
9.6.1
Visualizar los resultados de bsqueda en el cuadro

de mandos
Los grficos generados con los resultados de bsqueda del navegador

de incidencias y descritos en la seccin precedente pueden aadirse
como gadget en el cuadro de mando de JIRA. De esta forma, no
10 El
258
tiempo de resolucin medio se mide en das.
Figura 9.10: Grfico Agerage age.
Figura 9.11: Grfico Created vs. resolved.
259
Figura 9.12: Grfico Created vs. resolved.
Figura 9.13: Grfico Pie chart.
260
Figura 9.14: Grfico Recently created.
Figura 9.15: Grfico Time since.
261
Figura 9.16: Navegador de incidencias Tipos de grfico.
Figura 9.17: Navegador de incidencias Ver como grfico.
262
Figura 9.18: Navegador de incidencias Personaliza grfico.
ser necesario regenerar el grfico cada vez que los resultados de una
bsqueda se actualicen ya que el gadget estar siempre disponible, y
actualizado automticamente con los datos actuales, en el cuadro de
mando de un usuario.
Para aadir un grfico generado con los resultados de una bsqueda es necesario efectuar las siguientes operaciones:
(i) Generar el grfico siguiendo las instrucciones detalladas en 9.6.
(ii) Pulsar el botn Save to dashboard en la ventana de configuracin
del grfico.
(iii) Seleccionar el cuadro de mando en que se desea aadir el gadget
en el campo Select dashboard de la ventana de seleccin del cuadro de mando que aparece a continuacin (Figura 9.19). En el
caso en que el usuario no tenga ningn cuadro de mando y est
utilizando el cuadro de mando del sistema, JIRA crear automticamente un nuevo cuadro de mando y avisar el usuario
con el aviso ilustrado en Figura 9.20.
(iv) En el campo Filter name seleccionar el nombre del filtro asociado a la bsqueda corriente que JIRA crear conjuntamente
al gadget del cuadro de mando.
263
Figura 9.19: Grabacin de grfico en el cuadro de mando Seleccin

de cuadro de mando.
Figura 9.20: Grabacin de grfico en el cuadro de mando Creacin

automtica de un cuadro de mando.
(v) Pulsar el botn Save.

JIRA crear un filtro y un gadget que ser aadido al cuadro de
mando indicado por el usuario. Si el usuario lo necesita, el gadget
en cuestin podr ser posicionado y configurado utilizando las herramientas del cuadro de mando.
264
10
Generar reportes
La informacin almacenada en un sistema es valiosa si puede ser explotada. Una herramienta como JIRA va almacenando continuamente
informacin de inters para una organizacin y es fundamental poder
consultarla de forma eficiente cuando sea necesario.
En los captulos precedentes se ha detallado como la funcionalidad
de bsqueda de JIRA proporciona una herramienta sofisticada para
poder extraer del sistema la informacin que se necesita. Se vio,
adems, como los resultados de bsquedas pueden compartirse con
otros usuarios, ser utilizadas para la exportacin a otros formatos o
ser utilizados para la generacin de grficos. En este captulo se ver
otra herramienta para la explotacin de datos que JIRA ofrece a sus
usuarios: los reportes.
JIRA ofrece un conjunto de reportes que ofrecen varios tipos de
estadsticas a sus usuarios, tales como carga de trabajo o tiempos de
resolucin. Tipos de reportes adicionales pueden integrarse en JIRA
como plugins: una organizacin puede comprobar si el reporte que
se est buscando existe en el ecosistema de JIRA [28] [29] y, en su
defecto, un nuevo plugin puede ser fcilmente desarrollado utilizando
el Atlassian SDK [30].
En Tabla 10.1 se enumeran los reportes integrados y distribuidos
con JIRA y a continuacin se detallarn las caractersticas de cada
uno de ellos as como las operaciones necesarias para generarlos.
Todos los reportes son accesibles a travs del men Reports que
aparece en el cuadro de mando de un proyecto, indicado en Figura
10.1. Como puede verse en Figura 10.2, el men Reports es un
men desplegable en el cual se encuentra una entrada por cada uno
de los tipos de reportes soportados por la plataforma: tanto para los
reportes que JIRA proporciona por defecto como para los reportes
adicionales instalados a travs de plugins.
265
10. Generar reportes
Figura 10.1: Cuadro de manos de un proyecto Men Reports.
Figura 10.2: Cuadro de manos de un proyecto Men Reports

desplegado.
266
10.1. Workload pie chart

Nombre
Descripcin
Workload
chart
pie
User workload
Version workload
Version time tracking
Single level group

by
Created vs. resolved issues
Resolution time
Pie chart
Average age
Recently created
issues
Time since issues
Carga de trabajo media de los usuarios asignados

a las incidencias de un proyecto o devueltas por
un filtro.
Carga de trabajo de un usuario y tiempo estimado para la finalizacin de los trabajos.
Trabajo a finalizar, para usuarios y para incidencias, antes de que finalice una versin.
Tiempo estimado para la finalizacin de los trabajos de una versin, calculado utilizando registros de trabajos y estimaciones de tiempo de trabajo requerido de las incidencias.
Resultados de un filtro, agrupados por un campo
a eleccin del usuario.
Nmero de incidencias creadas contra nmero de
incidencias resueltas en un intervalo de tiempo
especificado.
Tiempo medio de resolucin de las incidencias.
Resultados de un filtro o de un proyecto, agrupados por un campo a eleccin del usuario, en un
grfico de torta.
Edad media de las incidencias (en das).
Frecuencia de creacin de las incidencias.
Nmero de incidencias que tienen un campo de
tipo fecha, escogido por el usuario, igual a la fecha indicada.
Tabla 10.1: Reportes integrados en JIRA.
10.1
Workload pie chart
El reporte workload pie chart resume la carga de trabajo (relativa)

de los usuarios asignados a un grupo de incidencias; el grupo de incidencias sobre el cual se efecta el clculo puede ser el conjunto de
incidencias de un entero proyecto o las incidencias devueltas por un
filtro escogido por el usuario.
Para poder utilizar este reporte es necesario que:
(i) El administrador de JIRA haya habilitado la funcionalidad de
time tracking.
(ii) Est instalado el plugin JIRA Charting Plugin [31].
267

Para generar un reporte de este tipo es necesario efectuar las siguientes operaciones:
(i) Acceder al cuadro de mando del proyecto que se desea navegar.
(ii) Seleccionar el reporte en el men Reports en el cuadro de mando
del proyecto.
(iii) En la ventana de configuracin del reporte (Figura 10.3), seleccionar el proyecto o el filtro que proporciona los datos al mismo
seleccionando el enlace Select filter or project. . . a la derecha
del campo Project or saved filter. Aparecer la ventana de se-
Figura 10.3: Workload pie chart Configuracin.
leccin de proyecto o filtro (Figura 10.4) en la cual el usuario

podr escoger o buscar entidades de ambos tipos.
Figura 10.4: Ventana de seleccin de proyecto o filtro.
(iv) Seleccionar el campo utilizado para agregar los datos en el grfico de torta utilizando el men desplegable del campo Statistic
type. Por defecto el campo seleccionado es Assignee.
268
10.1. Workload pie chart

(v) Seleccionar la estimacin de tiempo a utilizar en el men desplegable del campo Time field to report on. El men devuelve los
campos de estimacin de tiempo de JIRA, es decir: estimacin
corriente, estimacin original y tiempo trabajado.
(vi) Seleccionar el botn Next para generar el reporte.
Un ejemplo de reporte de este tipo, generado agregando datos
del campo Assignee, est ilustrado en Figura 10.5. En la parte
Figura 10.5: Report Workload pie chart.
superior del reporte puede verse el grfico de tipo torta que ilustra el
porcentaje de trabajo asignado a cada usuario. En la parte inferior
del reporte puede verse la tabla con los mismos datos reportados en
forma numrica: en la segunda columna de la tabla est el nmero
de horas asignadas a cada usuario (calculadas utilizando el campo
269

indicado durante la configuracin del reporte) y la carga de trabajo
relativa de cada uno de ellos, calculada como el porcentaje de horas
asignadas a cada usuario sobre el total.
10.2
User workload
El reporte User workload resume la carga de trabajo de un usuario y

el tiempo estimado para la finalizacin de los trabajos pendientes.
Para poder utilizar este reporte es necesario que el administrador
de JIRA haya habilitado la funcionalidad de time tracking.
del proyecto.
(iii) En la ventana de configuracin del reporte (Figura 10.6), seleccionar el usuario del que se desea obtener el reporte introduciendo su nombre en el campo User o buscndolo a travs del
buscador de usuarios al que se accede seleccionando el control
identificado por el icono ( ) situado a la derecha del mismo
campo.
Figura 10.6: User workload Configuracin.
(iv) Seleccionar el botn Next para generar el reporte.

Un ejemplo de reporte de este tipo, generado para el usuario enrico, est ilustrado en Figura 10.7. En el reporte puede verse la tabla
que agrega por proyecto (primera columna) la carga de trabajo del
usuario seleccionado generada por las incidencias que tiene en cada
270
10.3. Version workload
Figura 10.7: Report User workload.
uno de los proyectos indicados (segunda columna); en la ltima columna de la tabla, Workload, puede verse la carga de trabajo total
en cada proyecto y en el ltimo registro de la tabla pueden verse los
totales de los datos detallados.
10.3
Version workload
El reporte Version workload resume el trabajo a finalizar, para usuarios y para incidencias, antes de que finalice una versin de un proyecto.
del proyecto.
(iii) Configurar el reporte en la ventana de configuracin del reporte (Figura 10.8) siguiendo las instrucciones que se detallan a
continuacin.
(iv) Seleccionar en el men desplegable del campo Version la versin
del proyecto para la cual se desea generar el reporte.
(v) Seleccionar en el men desplegable del campo Display unestimated issues si se desea incluir en el reporte las incidencias para
las cuales no exista una estimacin de tiempo restante para la
finalizacin.
(vi) Seleccionar en el men desplegable del campo Sub-task inclusion
qu tipo de sub-tareas se desean incluir en el reporte:
271
Figura 10.8: Version workload Configuracin.
a) Seleccionar el valor Only including sub-tasks with the selected version para incluir en el reporte las sub-tareas que
tengan la misma versin de la incidencia que las contiene.
b) Seleccionar el valor Also include sub-tasks without a version set para incluir en el reporte las sub-tareas que tengan la misma versin de la incidencia que las contiene y
las sub-tareas que tengan el campo versin vaco.
c) Seleccionar el valor Include all sub-tasks para incluir todas
las sub-tareas en el reporte.
(vii) Seleccionar el botn Next para generar el reporte.
Un ejemplo de reporte de este tipo est ilustrado en Figura 10.9.
En la parte superior del reporte, Summary, puede verse la carga de
Figura 10.9: Report Versin workload.
272
10.4. Time tracking

trabajo que queda por efectuar desglosada por usuario y tipo de incidencia. En la parte inferior del reporte, Individual estimates, puede
verse el detalle de los trabajos pendientes, organizados por usuarios
y tipo de tarea.
10.4
Time tracking
El reporte Time tracking resume el tiempo estimado para la finalizacin de los trabajos de una versin, calculado tanto utilizando la
estimacin inicial como los registros de trabajos de las incidencias. El
reporte tambin indicar si una incidencia se finalizar a tiempo o en
retraso, respeto a la estimacin original.
del proyecto.
(iii) Configurar el reporte en la ventana de configuracin del reporte
(Figura 10.10) siguiendo las instrucciones que se detallan a
continuacin.
Figura 10.10: Time tracking Configuracin.
(iv) Seleccionar en el men desplegable del campo Fix version la

versin del proyecto para la cual se desea generar el reporte:
273

el reporte incluir las incidencias cuyo campo Fix versin sea
igual a la versin indicada.
(v) Seleccionar en el men desplegable del campo Sorting el criterio
con el cual se ordenarn las incidencias en el reporte utilizando
el valor del campo estimacin de tiempo restante:
a) Seleccionar Least completed issues first para ordenar las
incidencias con estimacin de tiempo restante descendiente.
b) Seleccionar Most completed issues first para ordenar las
incidencias con estimacin de tiempo restante ascendiente.
(vi) Seleccionar en el men desplegable del campo Issues cuales incidencias incluir en el reporte:
a) Seleccionar All para incluir todas las incidencias de la versin elegida.
b) Seleccionar Incomplete issues only para excluir del reporte
las incidencias completadas y las incidencias que tengan la
estimacin de tiempo vaca.
(vii) Seleccionar en el men desplegable del campo Sub-task inclusion
qu tipo de sub-tareas se desean incluir en el reporte:
a) Seleccionar el valor Only including sub-tasks with the selected version para incluir en el reporte las sub-tareas que
tengan la misma versin de la incidencia que las contiene.
b) Seleccionar el valor Also include sub-tasks without a version set para incluir en el reporte las sub-tareas que tengan la misma versin de la incidencia que las contiene y
las sub-tareas que tengan el campo versin vaco.
c) Seleccionar el valor Include all sub-tasks para incluir todas
las sub-tareas en el reporte.
(viii) Seleccionar el botn Next para generar el reporte.
Un ejemplo de reporte de este tipo est ilustrado en Figura 10.11.
En el reporte puede verse la tabla con el detalle de los datos extrados;
en las ltimas columnas dicha tabla se presentan los datos de los
cuatros campos utilizados para el seguimiento de tiempo del proyecto:
(i) Original estimate: la estimacin original tf del tiempo necesario
para finalizar la incidencia.
(ii) Estimated time remaining: la estimacin actual ta del tiempo
necesario para finalizar la incidencia.
274
10.4. Time tracking
Figura 10.11: Report Time tracking.
(iii) Time spent: la cantidad de tiempo ts trabajado en la incidencia.

(iv) Accuracy: la exactitud de la estimacin original comparada con
la estimacin actual calculada como
at = tf (ts + ta )
(10.1)
Si at es at < 0, la incidencia est en retraso con la estimacin,

mientras que si at 0 la incidencia est respetando la estimacin inicial.
Si las sub-tareas estn habilitadas en la plataforma, cada una de
las
P columnas (i)-(iv) llevar un valor adicional, indicado con la letra
en la cabecera de la columna, que indicar los valores agregados
para las incidencias con sub-tareas. Si una incidencia b tiene un conjunto de n sub-tareas {bi : i [1, n], i N}, el valor agregado para
un campo x cualquiera de los campos indicados en precedencia ser:
x(b) =
n
X
x(bi )
(10.2)
El ltimo registro del reporte es la agregacin de los datos de todas

las incidencias incluidas en el mismo.
En la parte superior del reporte JIRA proporciona una representacin grfica del estado de progreso y exactitud de las estimaciones
275
Figura 10.12: Report Time tracking Barras de resumen.
para la versin seleccionada (Figura 10.12). El grfico de barras

tiene las siguientes carctersticas:
(i) La barra de progreso ilustra la cantidad de trabajo llevado a
cabo, en color verde, y la cantidad de trabajo que falta por
ejecutar en las incidencias todava abiertas, en color naranja.
La relacin entre la longitud de un segmento coloreado y la
longitud total de la barra representa el porcentaje de trabajo
completado o por completar.
(ii) La barra de exactitud (Accuracy) ilustra la exactitud de las
estimaciones: en el caso ilustrado la exactitud es negativa y eso
indica un retraso de los trabajos estimado en el 14% del tiempo
total.
(iii) La relacin entre longitud de la barra de accuracy con respeto a
la longitud de la barra de progreso tambin indica si el trabajo
est completndose a tiempo, en adelanto o en retraso. Si la
longitud de la barra de accuracy es ms corta de la barra de
la barra de progreso, como en Figura 10.12, el trabajo va en
retraso. Si la longitud es la misma, el trabajo est completndose de acuerdo a las estimaciones. Si la longitud de la barra de
accuracy es ms grande de la longitud de la barra de progreso,
el trabajo est completndose en adelanto.
10.5
Single level group by
El reporte Single level group by permite organizar los resultados de

bsqueda de un filtro agrupndolos por un campo escogido por el
usuario.
Ejemplo 10.1. El jefe de proyecto desea organizar por asignatario las
incidencias abiertas para un componente de un proyecto y planificadas
para solucionarse en una versin del proyecto. Para generar este
reporte, el jefe de proyecto podr crear un filtro que devuelva las
incidencias buscadas:
project=... and component=... and version=... and status=open
276
10.6. Created vs. resolved issues

Para agrupar los resultados del filtro por asignatario, el usuario
podr configurar un reporte de tipo Single level group by para que
utilice el filtro en cuestin y agrupe las incidencias utilizando el campo
Assignee.
del proyecto.
continuacin.
Figura 10.13: Single level group by Configuracin.
(iv) Seleccionar el filtro a utilizarse como fuente de datos del reporte utilizando la ventana de seleccin de filtros que aparece
seleccionando el enlace Select filter. . . en el campo Filter.
(v) Seleccionar en el men desplegable del campo Statistic type el
campo de las incidencias a utilizarse para agregar los datos.
Un ejemplo de reporte de este tipo, configurado agregando las
incidencias por el campo Assignee, est ilustrado en Figura 10.14.
En el filtro pueden verse las incidencias devueltas por el filtro asociado
al reporte agregadas por asignatario.
10.6
Created vs. resolved issues
El reporte Created vs. resolved issues resume la diferencia entre el

nmero de incidencias creadas y resueltas, procedentes de un filtro o
277
Figura 10.14: Report Single level group by.
de un proyecto, en un intervalo temporal escogido por el usuario.

del proyecto.
continuacin.
(iv) Seleccionar el filtro o el proyecto asociado al reporte utilizando
la ventana de seleccin de filtros y proyectos a la que se accede utilizando el enlace Select filter or project. . . en el campo
Project or saved filter.
(v) Seleccionar en el men desplegable del campo Period el intervalo
temporal utilizado para la visualizacin del reporte. Los valores
disponibles para este campo estn resumidos en Tabla 10.2.
(vi) Seleccionar en el campo Days previously el nmero de das n
de datos a tener en cuenta para la generacin del grfico. El
reporte utilizar los datos procedentes de las incidencias creadas
278
10.6. Created vs. resolved issues
Figura 10.15: Created vs. resolved Configuracin.

Nombre
Descripcin
Hourly
Daily
Weekly
Monthly
Quarterly
Yearly
Intervalo
Intervalo
Intervalo
Intervalo
Intervalo
Intervalo
de
de
de
de
de
de
una hora.
un da.
una semana.
un mes.
3 meses.
un ao.
Tabla 10.2: Reporte Intervalos temporales.
o modificadas en el intervalo temporal [t0 n, t0 ] siendo t0 la

fecha actual de generacin del grfico.
(vii) Seleccionar en el men desplegable del campo Cumulative totals? si los datos del reporte deben ser cumulativos o invididuales.
(viii) Seleccionar en el men desplegable del campo Display versions?
si y para que tipo de versiones deben enseare las fechas de
liberacin en el grfico.
(ix) Seleccionar el botn Next para generar el reporte.
Un ejemplo de reporte de este tipo, generado utilizando los parmetros:
(
Period = Daily
(10.3)
Days previously = 30
279

est ilustrado en Figura 10.16 y 10.17.
Figura 10.16: Report Created vs. Resolved Grfico.
Las areas verdes del grfico representan los intervalos de tiempo

en los cuales el nmero de incidencias resueltas ir , ha sido mayor que
el nmero de incidencias creadas ic :ir > ic . Las areas rojas, al revs,
representan los intervalos de tiempo en los cuales ir < ic .
El mismo conjunto de datos se ha utilizado para generar el siguiente reporte, utilizando los siguientes parmetros:
(
Period = Weekly
(10.4)
Como puede verse en Figura 10.18, los datos diarios del grfico
precedente se han agregados en datos semanales. La curva resultante
es la curva generada sumando los datos diarios a lo largo de los das
de cada semana. Puede verse como la curva de Figura 10.18 es ms
suave de la curva de Figura 10.16 por efecto de la operacin de
280
10.7. Resolution time
Figura 10.17: Report Created vs. Resolved Tabla de datos.
suma y que las areas coloreadas en el primer grfico se reflejan en las

areas coloreadas en el mismo color en el segundo grfico.
10.7
Resolution time
El reporte Resolution time resume el tiempo medio que se ha requerido para resolver las incidencias, calculado en intervalos de longitud
especificada por el usuario. El conjunto de incidencias analizadas en
este tipo de reporte puede proceder tanto de un filtro como de un
entero proyecto.
del proyecto.
continuacin.
281
Figura 10.18: Report Created vs. Resolved Grfico.
Figura 10.19: Resolution time Configuracin.
282
10.8. Pie chart

(
Period = Daily
(10.5)
En el grfico de barras del reporte puede verse el tiempo medio de
resolucin, calculado sobre el intervalo especificado, representado por
la altura y de las barras. En la tabla de datos pueden apreciarse los
mismos datos en forma numrica: la tabla tiene 30 registros, como
especificado en el parmetro Days previously y la media del tiempo
de resolucin se ha calculado en base diaria, como especificado en el
parmetro Period.
10.8
Pie chart
El reporte Pie chart es un reporte similar al reporte Single level group

by (10.5): este reporte permite agrupar un conjunto de incidencias
por un campo escogido por el usuario y ensear el resultado de la
agrupacin de forma grfica en un grfico de torta.
Ejemplo 10.2. Como en el Ejemplo 10.1, el jefe de proyecto desea
organizar por asignatario las incidencias abiertas para un componente
de un proyecto y planificadas para solucionarse en una versin del
proyecto. En este caso, sin embargo, el jefe de proyecto quiere ilustrar
los resultados en un grfico de tarta.
283
Figura 10.20: Report Resolution time Grfico.
Para agrupar los resultados del filtro por asignatario, el usuario

podr configurar un reporte de tipo Pie chart para que utilice el filtro
en cuestin y agrupe las incidencias utilizando el campo Assignee.
del proyecto.
continuacin.
(iv) Seleccionar el filtro o el proyecto a utilizarse como fuente de
datos del reporte utilizando la ventana de seleccin de filtros
y proyectos que aparece seleccionando el enlace Select filter or
project. . . en el campo Project or saved filter.
284
10.8. Pie chart
Figura 10.21: Report Resolution time Tabla de datos.
Figura 10.22: Pie chart Configuracin.
285

(v) Seleccionar en el men desplegable del campo Statistic type el
campo con el cual agregar los datos.
Un ejemplo de reporte de este tipo, configurado agregando las
incidencias por el campo Assignee, est ilustrado en Figura 10.23 y
10.24.
Figura 10.23: Report Pie chart Grfico.
Figura 10.24: Report Pie chart Tabla de datos.
Como puede observarse, el grfico de torta ilustra el porcentaje

de incidencias que componen cada uno de los conjuntos obtenidos
agregando las incidencias por el campo especificado. En la tabla de
datos, se detallan de forma numrica los datos ilustrados en el grfico.
286
10.9. Average age

10.9
Average age
El reporte Average age resume la edad media (medida en das) de las

incidencias no resueltas en cada instante de tiempo con la frecuencia
escogida por el usuario.
del proyecto.
continuacin.
Figura 10.25: Average age Configuracin.

287

(
Period = Daily
(10.6)
Figura 10.26: Report Average age Grfico.
En el grfico del reporte puede verse una barra por cada intervalo
especificado por el usuario cuya altura indica la edad media de las
incidencias abiertas y no resueltas en ese intervalo de tiempo. En la
tabla de datos del reporte pueden verse los mismos datos en forma
numrica.
10.10
Recently created issues
El reporte Recently created issues resume la frecuencia con la cual se

estn creando nuevas incidencias. La frecuencia se calcula sobre el
288
10.10. Recently created issues
Figura 10.27: Report Average age Tabla de datos.
conjunto de incidencias devueltas por un filtro o un proyecto y un

intervalo de tiempo escogido por el usuario.
del proyecto.
continuacin.
289
Figura 10.28: Recently created issues Configuracin.

(
Period = Daily
(10.7)
especificado por el usuario cuya altura indica el nmero de incidencias
abiertas en el intervalo de tiempo correspondiente. La longitud del
segmento de barra coloreado en verde indica el porcentaje de incidencias que se han resuelto y el segmento coloreado en rojo el porcentaje
de incidencias que todava quedan por resolver. En la tabla de datos
del reporte pueden verse los mismos datos en forma numrica.
10.11
Time Since Issues Report
El reporte Time since issues resume el nmero de incidencias cuyo

campo de tipo fecha escogido por el usuario es igual a la fecha indicada. En conjunto de incidencias analizado en el reporte puede proceder
de un filtro o de un proyecto escogido por el usuario.
290
10.11. Time Since Issues Report
Figura 10.29: Report Recently created issues Grfico.

del proyecto.
continuacin.
(v) Seleccionar en el men desplegable del campo Date field el campo de tipo fecha de las incidencias a utilizar en el reporte.
(vi) Seleccionar en el men desplegable del campo Period el intervalo
(vii) Seleccionar en el campo Days previously el nmero de das n
291
Figura 10.30: Report Recently created issues Tabla de datos.
Figura 10.31: Time since issues Configuracin.
292
10.11. Time Since Issues Report

(viii) Seleccionar en el men desplegable del campo Cumulative totals? si los totales deben ser cumulativos o individuales.
(ix) Seleccionar el botn Next para generar el reporte.
(
Period = Daily
(10.8)
Figura 10.32: Report Time since issues Grfico.
especificado por el usuario cuya altura indica el nmero de incidencias
cuyo campo especificado es igual a la fecha del intervalo correspondiente. En la tabla de datos del reporte pueden verse los mismos
datos en forma numrica.
293
Figura 10.33: Report Time since issues Tabla de datos.
10.12
Cach de los navegadores
Dependiendo de la configuracin de la cach del navegador que se est

utilizando, puede suceder que las pginas de los reportes visualicen
datos no actualizados. Es importante, por lo tanto, configurar la
cach de forma que compruebe de forma automtica si existe una
versin actualizada para una pgina presente en la cach.
294
11
Gestionar los cuadros de mandos
El cuadro de mandos de JIRA es la primera ventana a la que llega el
usuario despus del login. Dependiendo de la configuracin del cuadro
de mando por defecto de JIRA, los contenidos de esta ventana pueden
cambiar.
Para muchos usuarios y en muchos casos de uso, los cuadros de
mandos adquieren una importancia relevante en una aplicacin como JIRA. En los captulos precedentes nos hemos focalizado en la
interaccin entre usuarios y JIRA en el contexto de un proyecto. En
navegador de proyecto, por ejemplo, puede considerarse el cuadro de
mandos de un proyecto y desde esa ventana el usuario puede acceder
a cualquier funcin e informacin relacionada con el mismo.
Sin embargo, algunos roles de usuarios pueden estr involucrados
en un amplio conjunto de proyectos: las herramientas especficas de
proyecto, o incluso los filtros, pueden resultar lentas y engorrosas a
la hora de recuperar, agregar y analizar la informacin procedente de
varios proyectos.
Los cuadros de mandos proporcionan una solucin a esta necesidad: el usuario puede utilizar los gadgets para recuperar y presentar
la informacin que necesitan en una nica ventana. La fuente de datos
utilizada por los gadgets para recuperar la informacin que presentan
suelen ser filtros: de esta forma el usuario puede definir de forma sencilla la bsqueda de los datos que le interesan (como explicado en 6 y
posteriores), grabarla para reutilizarla y compartirla con otros usuarios e utilizar los gadgets para agregar y visualizar esta informacin
en ventanas dedicadas.
Un usuario podr definir tantos cuadros de mandos como necesite
e, incluso, compartirlos con otros usuarios. Los cuadros de mandos,
por lo tanto, son ventanas de reporting flexible y fcil de utilizar que
pueden considerarse tambin activos de la plataforma: los jefes de
295
11. Gestionar los cuadros de mandos

proyectos de proyectos distintos podrn, por ejemplo, compartir un
cuadro de mando que defina la estructura de la informacin que
necesitan. La flexibilidad de los filtros har que cada usuario que
utilice un cuadro de mandos vea una versin personalizada de los
datos que le interesan.
En este Captulo se detallar el procedimiento de gestin de los
cuadros de mandos. En el siguiente Captulo se detallar el procedimiento de personalizacin de los cuadros de mandos.
11.1
Contenedores de gadgets OpenSocial
Como explicado en la introduccin de este captulo, la caracterstica

principal de esta ventana o, para ser ms precisos, de este tipo de
ventanas, es su extrema flexibilidad. Un cuadro de mandos es un
contenedor de gadgets OpenSocial en el cual el usuario puede aadir
gadgets compatibles con los cuales disear su ventana.
OpenSocial es un conjunto de APIs1 que en un principio fue promocionado por Google y otras empresas con el fin de poder compartir
informacin entre distintas aplicaciones utilizando componentes, los
gadgets, que se pudieran aadir fcilmente en la capa de presentacin.
Atlassian, despus de haber comenzado a utilizar esta tecnologa en
JIRA, ha extendido su utilizacin a sus dems productos proporcionando al usuario una forma efectiva y sencilla de poder personalizar,
de acuerdo a sus necesidades y a sus gustos, las ventanas de las aplicaciones. En Figura 11.1 puede verse un cuadro de mandos vaco.
El usuario podr ir aadiendo los gadgets que desea, conectndolos
cuando sea necesario a las fuentes de datos que requieran, y configurar el aspecto de la ventana moviendo los gadgets en la posicin
deseada arrastrndolo simplemente con el ratn (Figura 11.2).
Como explicado a continuacin, la utilizacin de una tecnologa
estndar para la personalizacin de los cuadros de mandos permite al
usuario integrar informacin procedente de otras aplicaciones, siempre que el gadget utilizado cumpla los requerimientos del estndar
OpenSocial. De esta forma, los cuadros de mandos de JIRA pueden
convertirse en cuadros de mandos globales en los cuales los usuarios
pueden agregar cmodamente la informacin procedente de las aplicaciones que utilizan.
1 Application
cin).
296
Programming Interfaces (Interfaces de Programacin de Aplica-
11.1. Contenedores de gadgets OpenSocial
Figura 11.1: Cuadro de mandos vaco.
Figura 11.2: Cuadro de mandos Disponer un gadget.
297

11.2
Gestin de los cuadros de mandos
Los cuadros de mandos son entidades que, a la par que otras entidades
de JIRA tales como los filtros, pueden:
(i)
(ii)
(iii)
(iv)
Crearse.
Compartirse.
Buscarse.
Marcarse como favoritos.
Los usuarios pueden utilizar la ventana de gestin de cuadros de mandos para gestionar los cuadros de mandos que desea utilizar, tantos
propios como creados por otros usuarios. De esta forma, cada usuario
podr utilizar tantos cuadros de mandos como necesite para mantener
la informacin organizada con los criterios deseados.
Para acceder a la ventana de gestin de cuadros de mandos se
selecciona la operacin Manage dashboards del men Dashboards en
la barra de herramientas de JIRA (Figura 11.3).
Figura 11.3: Men Dashboards.
La ventana de gestin est compuesta por distintas sub-ventanas,

accesibles a travs de las pestaas que pueden verse a la izquierda de
Figura 11.4 y detalladas a continuacin:
Figura 11.4: Ventana de gestin de cuadros de mandos.
298
11.2. Gestin de los cuadros de mandos

(i) Favorite: Ventana de gestin de cuadros de mandos favoritos,
cuya funcionalidad est detallada en 11.2.1.
(ii) My: Ventana de gestin de cuadros de mandos del usuario conectado. Las operaciones disponibles en esta ventana estn detalladas en las secciones siguientes.
(iii) Popular: Ventana de gestin de cuadros de mandos populares.
Esta ventana propone la lista de los cuadros de mandos ms
populares, de acuerdo al nmero de usuarios que los aade a su
lista de favoritos.
(iv) Search: Ventana de bsqueda de cuadros de mandos, cuya funcionalidad est detalladas en 11.3.
11.2.1
Gestin de cuadros de mandos favoritos
La ventana que por defecto se presenta al usuario es la ventana de

gestin de cuadros de mandos favoritos (Figura 11.4). Los cuadros
de mandos, a la par que otras entidades tales como los filtros, pueden
marcarse como favoritos. Los cuadros de mandos favoritos se proponen al usuario como pestaas en el lado izquierdo de cualquier cuadro
de mando que se est utilizando, como puede verse en Figura 11.5.
De esta forma, los usuarios podrn acceder a los cuadros de mandos
Figura 11.5: Ventana de gestin de cuadros de mandos.
que ms utilicen de forma rpida y desde cualquier otro cuadro de

mando.
Como puede observarse en Figura 11.4, los cuadros de mandos
favoritos estn sealados con un control identificados con un icono
estrella amarilla ( ). Seleccionando este control se puede quitar un
cuadro de mando de la lista de favoritos. JIRA avisar el usuario
299

que la operacin de eliminacin de un cuadro de mando de la lista de
favoritos se ha completado con xito con un mensaje parecido al que
se ilustra en Figura 11.6. Si se desea anular la operacin de elimina-
Figura 11.6: Confirmacin de eliminacin de un cuadro de mandos de la

lista de favoritos.
cin del cuadro de mandos de la lista de favoritos, es posible hacerlo

utilizando el enlace Undo disponible en el mensaje de confirmacin
(Figura 11.6).
De forma anloga, es posible aadir un cuadro de mandos a la
lista de favoritos utilizando el control estrella. Por eso, es necesario
encontrar el cuadro de mando que se desea agregar a la lista de
favoritos2 y seleccionar el control identificado con un icono estrella
gris ( ). Despus de que el cuadro de mandos se haya marcado como
favorito, el control se volver amarillo ( ) y el cuadro de mando podr
gestionarse de la ventana de gestin Favorite.
11.2.2
Ordenar los cuadros de mandos favoritos
Por cada uno de los cuadros de mandos favoritos JIRA presenta una
pestaa en la parte izquierda de la ventana de cuadros de mandos
con la cual el usuario puede acceder rpidamente al cuadro deseado.
En la ventana de gestin de cuadros de mandos favoritos el usuario
puede ordenar los elementos de la lista de forma que las pestaas
correspondientes aparezcan en el rden deseado.
Para ordenar los elementos de la lista, el usuario puede utilizar
los controles que aparecen en cada elemento de la lista, descritos en
Tabla 11.1.
11.2.3
Creacin de un cuadro de mandos
Los usuarios, a parte de utilizar el cuadro de mandos del sistema

proporcionado por la plataforma y que no pueden ser modificados
sino por el administrador de JIRA, pueden crear cuadros de mandos
adicionales que pueden configurarse a placer.
2 En
las siguientes secciones se detallarn varios mecanismos proporcionados

por JIRA para encontrar un cuadro de mando.
300

Control
Descripcin
Mover a la primera posicin.
Mover hacia arriba.
Mover hacia abajo.
Mover a la ltima posicin.
Tabla 11.1: Controles para el ordenamiento de los elementos de la lista.
Un cuadro de mandos puede crearse:

(i) Copiando un cuadro de mandos existente, como explicado en
11.2.4.
(ii) Creando un cuadro de mandos nuevo, como explicado a continuacin.
Independientemente de como se haya creado el cuadro de mandos, el
usuario podr modificarlo de acuerdo a sus necesidades eliminando
gadgets que no se necesiten (si el cuadro de mandos ha sido copiado)
y aadiendo los que se requieran.
Para crear un cuadro de mandos es necesario efectuar las siguientes
operaciones:
(i) Utilizar el comando Create new dashboard en la esquina superior
derecha de cualquier ventana de gestin de cuadros de mandos
(Figura 11.7). JIRA presentar al usuario el formulario de
Figura 11.7: Control de creacin de cuadros de mandos.
creacin de cuadros de mandos, ilustrado en Figura 11.8.

(ii) Establecer el nombre del cuadro de mandos en el control Name.
(iii) Establecer la descripcin del cuadro de mandos en el control
Description.
(iv) Decidir que cuadro de mandos existente puede utilizar como maqueta seleccionando un cuadro de mandos del men desplegable
del control Start from.
(v) Aadir el cuadro de mandos a la lista de favoritos utilizando
el control Favorite, identificado con el icono estrella amarilla
( ), como explicado en 11.2.1.
301
Figura 11.8: Formulario de creacin de cuadros de mandos.
(vi) Compartir el cuadro de mandos aadiendo las identidades con

las cuales se desea compartirlo utilizando el control Add shares,
como detallado a continuacin.
(vii) Si se desea compartir el cuadro de mandos con cualquier usuario
de la plataforma, seleccionar la identidad Everyone en el men
desplegable del control Add shares y aadindola a la lista de
identidades compartidas pulsando el control Add, identificado
con el icono (+).
(viii) Si se desea compartir el cuadro de mandos con un grupo de
usuarios, seleccionar la identidad Group en el men desplegable
del control Add shares. En el men desplegable que aparecer a
la derecha del men de identidades, seleccionar el grupo deseado
y aadirlo a la lista de identidades compartidas pulsando el
control Add.
(ix) Si se desea compartir el cuadro de mandos con usuarios que
pertenezcan a un rol de un proyecto, seleccionar la identidad
Project en el men desplegable del control Add shares. En los
mens desplegables que aparecern a la derecha del men de
identidades, seleccionar el proyecto y el rol de proyecto deseado,
y aadirlo a la lista de identidades compartidas pulsando el
control Add.
(x) Confirmar la creacin del cuadro de mandos seleccionando el
302

botn Add en el formulario de creacin de cuadros de mandos.
11.2.4
Copiar un cuadro de mandos
En determinadas circunstancias es deseable crear un nuevo cuadro de

mandos utilizando un cuadro de mandos existente como maqueta
inicial a la cual aportar las modificaciones que se necesitan. En 11.2.3
se ha visto que en el procedimiento estndar de creacin de cuadros
de mandos se puede utilizar el control Start from para seleccionar el
cuadro de mandos que se desea utilizar como maqueta.
Sin embargo, existe otra opcin que permite copiar un cuadro
de mandos. En las listas de cuadros de mandos presentadas en las
ventanas de gestin, se puede utilizar la operacin Copy para copiar el cuadro de mandos elegido, como ilustrado en Figura 11.9.
Seleccionando esta operacin, el usuario ser llevado a la ventana de
Figura 11.9: Ventana de gestin de cuadros de mandos Operacin

Copy
creacin de cuadro de mandos y el campo Start from del formulario de creacin ser valorizado con el cuadro escogido. El usuario
podr seguir configurando el nuevo cuadro de mando siguiendo las
instrucciones detalladas en 11.2.3.
11.2.5
Modificar un cuadro de mandos
Todos los parmetros establecidos al acto de la creacin de un cuadro de mandos pueden modificarse a posteriori utilizando la ventana
de modificacin de cuadro de mandos. Para acceder a la ventana de
modificacin es necesario seleccionar la operacin Edit del cuadro de
mandos a modificar en una de las ventanas de gestin, como ilustrado en Figura 11.10. Seleccionando esta operacin, el usuario ser
llevado al formulario de modificacin de cuadro de mandos, ilustrada
303

Edit
en Figura 11.11, cuya funcionalidad es idntica a la del formulario

de creacin. A travs de este formulario, siguiendo las instrucciones
Figura 11.11: Ventana de modificacin de cuadros de mandos
detalladas en 11.2.3, el usuario podr modificar el cuadro de mandos

seleccionado de acuerdo a sus necesidades.
11.2.6
Eliminar un cuadro de mandos
Un cuadro de mandos puede ser eliminado por el usuario que lo ha

creado utilizando la operacin Delete en una de las ventanas de gestin de cuadros de mandos, como ilustrado en Figura 11.12. Despus
de haber seleccionado esta operacin, JIRA pedir confirmacin al
usuario con una ventana parecida a la ilustrada en Figura 11.13.
Despus de haber confirmado la operacin, JIRA proceder a la eliminacin del cuadro seleccionado.
304
11.3. Bsqueda de cuadro de mandos

Delete
Figura 11.13: Ventana de confirmacin de eliminacin de cuadro de

mandos
11.3
Bsqueda de cuadro de mandos
La ventana de bsqueda de cuadro de mandos, ilustrada en Figura 11.14, permite buscar entre los cuadros de mandos los que que
cumplan los criterios establecidos por el usuario:
(i) Texto libre en nombre y descripcin.
(ii) Autor.
(iii) Tipo de identidad con la cual el cuadro de mando est compartido.
Para buscar un cuadro de mandos es necesario efectuar las siguientes operaciones:
(i) Si se desea utilizar un criterio de bsqueda de texto libre en el
nombre o en la descripcin del cuadro de mando, introducir el
texto a buscar en el campo Search.
(ii) Si se desea restringir la bsqueda a los cuadros de mandos de un
usuario, introducir el nombre del usuario en el control Author
305
Figura 11.14: Ventana de bsqueda de cuadro de mandos
o elegir el usuario en la ventana de seleccin de usuarios que

aparece seleccionando el control identificado por el icono ( ).
(iii) Si se desea restringir la bsqueda a los cuadros de mandos que
se han compartido con una determinada identidad, utilcense
el control Shared with para seleccionar la identidad deseada. El
funcionamiento de este control es parecido al del control Add
shares descrito en 11.2.3.
(iv) Efectuar la bsqueda seleccionando el botn Search en el formulario de bsqueda.
Los resultados sern presentado en una lista de cuadros de mandos
debajo del formulario de bsqueda, como ilustrado en Figura 11.15.
Los cuadros de mandos en la lista de resultados podrn aadirse a la
Figura 11.15: Ventana de bsqueda de cuadro de mandos Resultados
306
11.3. Bsqueda de cuadro de mandos

lista de favoritos utilizando el procedimiento descrito en 11.2.1.
307
12
Personalizar el cuadro de mandos
En el Captulo precedente se ha visto como JIRA permite a cada
usuario crear sus cuadros de mandos, gestionarlos e, incluso, utilizar
cuadros de mandos creados y compartidos por otros usuarios.
En este Captulo se ver como cada usuario puede personalizar
sus cuadros de mandos para organizar la informacin que se desee
manejar y presentar en cada uno de ellos.
12.1
Operaciones sobre un cuadro de mandos
En el rincn superior derecho de la ventana del cuadro de mandos

JIRA proporciona una serie de operaciones, ilustradas en Figura
12.1:
(i) Add Gadget, para aadir un gadget al cuadro de mandos, como
explicado en ??.
(ii) Edit layout, para seleccionar la distribucin del cuadro de mandos, como explicado en 12.2.
(iii) Tools, un men desplegable (Figura 12.2) que ofrece operaciones comunes de gestin, detalladas en el captulo precedente
(11).
12.2
Seleccin de la distribucin de un cuadro de mandos
JIRA ofrece distintas distribuciones, detalladas en Tabla 12.1, para

que el usuario pueda escoger la que mejor se adapte a sus cuadro de
mandos, de acuerdo a los gadgets que vaya a disponer en l.
Para elegir la distribucin de un cuadro de mando es necesario
309
12. Personalizar el cuadro de mandos
Figura 12.1: Ventana de cuadro de mandos Operaciones
Figura 12.2: Ventana de cuadro de mandos Men Tools
Distribucin
Descripcin
Pgina entera.
Dos columnas.
Dos columnas, derecha doble.
Dos columnas, izquierda doble.
Tres columnas.
Tabla 12.1: Cuadro de mandos Distribuciones
310
12.3. Aadir gadgets al cuadro de mandos

(i) Seleccionar el control Edit layout (vase 12.1) en la barra de
herramientas de la ventana del cuadro de mandos.
(ii) Seleccionar la nueva disposicin (vase 12.1) en la ventana de
seleccin de disposiciones, ilustrada en Figura 12.3.
Figura 12.3: Ventana de seleccin de distribucin del cuadro de mandos
(iii) Cerrar la ventana de seleccin de distribuciones utilizando el

control Close.
El cuadro de mandos utilizar ahora la nueva distribucin seleccionada.
12.3
Aadir gadgets al cuadro de mandos
El usuario puede disponer en un cuadro de mandos cualquiera de

los gadgets disponible en JIRA. La lista de gadgets disponibles por
defecto est detallada en 12.7. Es importante subrayar que el administrador de la plataforma puede aadir gadgets adicionales y que, por
la naturaleza y la flexibilidad proporcionada por el estndar OpenSocial, se pueden utilizar gadgets de otras aplicaciones utilizando su
URL.
Para aadir un gadget a un cuadro de mandos es necesario efectuar
las siguientes operaciones:
(i) Seleccionar el control Add gadget (vase 12.1) en la barra de
herramientas de la ventana del cuadro de mandos.
(ii) Seleccionar el gadget que se desea aadir escogindolo en la
ventana de seleccin de gadgets que JIRA presentar al usuario
311
Figura 12.4: Ventana de seleccin de gadget
(iii) Los gadgets estn organizados en categoras y un usuario puede

restringir el nmero de gadgets propuestos en la ventana de
seleccin escogiendo la categora deseada en el navegador de
categoras en la parte izquierda de la ventana.
(iv) El usuario puede buscar un gadget utilizando el control de bsqueda en el rincn superior derecho de la ventana de seleccin.
(v) Para aadir un gadget, pulsar el botn Add it now del gadget
deseado.
(vi) Para finalizar la insercin de gadgets y cerrar la ventana de
seleccin, pulsar el botn Finished en el rincn inferior derecho
de la ventana de seleccin.
Muchos gadgets, especialmente los gadgets que utilizan una fuente de datos para proporcionar informacin al usuario, necesitan ser
configurados despus de haberlos aadido a un cuadro de mandos. El
proceso de configuracin es especfico de cada gadget y a continuacin (12.7 y sucesivas) se detallar el proceso de configuracin de los
gadgets distribuidos con JIRA.
312
12.4. Operaciones sobre un gadget en un cuadro de mandos

12.4
Operaciones sobre un gadget en un cuadro de mandos
Cada gadget en un cuadro de mandos tiene una barra de herramientas

que est visible cuando el ratn est encima de la barra del ttulo del
mismo, como ilustrado en Figura 12.5. Los controles de la barra de
Figura 12.5: Barra de herramientas de un gadget
herramientas permiten personalizar el tamao del gadget y efectuar

operaciones comunes sobre l. La funcionalidad de cada control de la
barra de herramientas est resumido en Tabla 12.2.
Control
Descripcin
Mover el gadget.
Maximizar el tamao del gadget.
Restablecer el tamao del gadget.
Men de operaciones.
Tabla 12.2: Barrade herramientas de un gadget Controles
El men de operaciones, accesible utilizando el control ( ) e ilustrado en Figura 12.6, permite efectuas operaciones comunes sobre
un gadget:
(i) Cambiar el tamao del gadget.
313

(ii) Cambiar el color del gadget, escogindolo de una lista de colores
ofrecidos por JIRA.
(iii) Eliminar el gadget.
(iv) Configurar el gadget.
(v) Refrescar el contenido del gadget.
Figura 12.6: Barra de herramientas de un gadget Men de

operaciones
12.5
Mover un gadget en un cuadro de mandos
Los gadgets de un cuadro de mandos pueden disponerse a placer, para

organizar el aspecto del cuadro como desee el autor del mismo.
Para mover un gadget de una posicin a otra, es suficiente arrastrar el gadget con el ratn en la nueva posicin, como ilustrado en
Figura 12.7.
Figura 12.7: Mover un gadget en un cuadro de mandos
314
12.6. Eliminar un gadget de un cuadro de mandos

12.6
Eliminar un gadget de un cuadro de mandos
Para eliminar un gadget de un cuadro de mandos es necesario seleccionar la operacin Delete del men de operaciones del gadget,
como descrito en 12.4. JIRA pedir confirmacin al usuario, en una
ventana parecida a la que se ilustra en Figura 12.8, y si el usuario
confirma la operacin pulsando el botn Ok JIRA eliminar el gadget
seleccionado del cuadro de mandos.
Figura 12.8: Ventana de confirmacin de eliminacin de un gadget de

un cuadro de mandos
12.7
Gadgets disponibles
JIRA pone a disposicin del usuario un gran nmero de gadgets y,

adems, el usuario podr aadir a un cuadro de mando gadgets que
procedan de plugins de JIRA o de otras aplicaciones. En Tabla 12.3
se detalla la lista de gadgets incluidos en JIRA y una breve descripcin
se su funcionalidad.
Gadget
Activity stream
Administration
Assigned to me
Average age
Descripcin
Resumen de la actividad reciente.
Enlaces rpidos a funciones administrativas.
Incidencias abiertas en cualquier proyecto
asignadas al usuario conectado.
Grfico de barras del nmero medio de das
en los cuales una incidencia se ha quedado
abierta.
315

Gadget
Bamboo charts
Bamboo plan
mary chart
Bamboo plans
sum-
Bugzilla ID search
Calendar
Clover coverage
Created vs. resolved
Crucible charts
Favourite filter
Filter result
FishEye charts
FishEye recent changesets
In progress
Introduction
Issue statistics
JIRA: news
Pie chart
Projects
Quick links
Resolution time
Road map
316
Descripcin
Grficos y estadsticas de una instancia de
Bamboo.
Resumen grfico de un plan de construccin
de Bamboo.
Resumen de los planes de una instancia de
Bamboo y de sus estados.
Bsqueda por ID de una incidencia en una
instancia de Bugzilla.
Fechas de caducidad de incidencias y versiones en un calendario.
Cobertura de Clover de planes de una instancia de Bamboo.
Grfico de diferencias de las incidencias creadas y resueltas en un intervalo de tiempo.
Resmenes estadsticos grficos de las revisiones de Crucible.
Lista de los filtros favoritos del usuario conectado.
Resultados de un filtro.
Grficos de estadsticas sobre un repositorio
de FishEye.
Resumen de los cambios recientes en un repositorio de FishEye.
Incidencias en progreso y asignadas al usuario conectado.
Mensaje de bienvenida configurable.
Estadsticas sobre los resultados de un filtro
por el campo especificado.
Noticias recientes sobre Atlassian JIRA.
Grfico de torta de los resultados de un filtro
o las incidencias de un proyecto agrupadas
por el campo especificado.
Informacin y filtros relacionados con el proyecto especificado.
Enlaces tiles a incidencias asignadas al
usuario conectado.
Grfico de barras de la frecuencia de creacin
y resolucin de las incidencias.
Grfico de barras del tiempo medio de resolucin de las incidencias.
Resumen del road map de versiones a entregar y del trabajo a realizar por cada versin.
12.8. Activity stream gadget

Gadget
Text
Time since issues
Descripcin
Fragmento HTML configurable.
Grfico de barras del nmero de incidencias
cuyo campo de tipo fecha elegido cumpla el
criterio escogido.
Two dimensional filter Datos estadsticos sobre el filtro escogido en
statistics
forma tabular.
Voted
Incidencias votadas por el usuario conectado.
Watched
Incidencias observadas por el usuario conectado.
Los gadgets marcados con el smbolo sern

disponibles solo si el administrador de JIRA
los ha instalado.
Tabla 12.3: Gadgets para el cuadro de mandos de JIRA
12.8
Activity stream gadget
El gadget Activity stream permite de obtener el resumen de la actividad reciente en un grupo de proyectos, opcionalmente filtrada por
una lista de usuarios. Este gadget tambin proporciona un feed RSS
que puede utilizarse para consultar la informacin proporcionada por
el gadget a travs de un lector de feeds RSS.
Para configurar este gadget es necesario efectuar las siguientes
operaciones:
(i) Acceder a la pantalla de configuracin del gadget, ilustrada en
Figura 12.9.
(ii) Seleccionar los proyectos cuya actividad se desea observar seleccionndolos en la lista de seleccin mltiple del control Projects.
(iii) Opcionalmente, seleccionar los usuarios con los cuales se desea
filtrar la lista de resultados introduciendo sus nombres, separados por coma (,), en el control Username.
(iv) Introducir el nmero de elementos a visualizarse en la lista en
el control Number of entries.
(v) Seleccionar la frecuencia de actualizacin de los datos del gadget
escogiendo un valor en el men desplegable del control Refresh
interval.
(vi) Confirmar la configuracin pulsando el botn Save.
317
Figura 12.9: Gadget Activity stream Configuracin
Despus de haber configurado el gadget, se visualizarn los datos

obtenidos como ilustrado en Figura 12.10.
12.9
Administration gadget
El gadget Administration proporciona atajos a las tareas administrativas ms comunes. Debido a la naturaleza de las operaciones proporcionadas, este gadget es de utilizada para usuarios que posean el
permiso global JIRA Administrators o JIRA System Administrators.
Este gadget no posee ningn tipo de configuracin y un ejemplo
puede verse ilustrado en Figura 12.11.
318
12.9. Administration gadget
Figura 12.10: Gadget Activity stream
Figura 12.11: Gadget Administration
319

12.10
Assigned to me gadget
El gadget Assigned to me proporciona la lista de incidencias asignadas al usuario corriente y las columnas visualizadas en la lista de
resultados pueden ser configuradas por el usuario.
operaciones:
Figura 12.12.
Figura 12.12: Gadget Assigned to me
(ii) Introducir el nmero de elementos a visualizarse en la lista en

el control Number of results.
(iii) Opcionalmente, seleccionar las columnas a visualizar en la lista
de resultados seleccionndolas en la lista de seleccin mltiples
del control Columns to display.
(iv) Seleccionar la frecuencia de actualizacin de los datos del gadget
interval.
(v) Confirmar la configuracin pulsando el botn Save.
320
12.11. Average age chart gadget

Figura 12.13: Gadget Assigned to me
12.11
Average age chart gadget
El gadget Average age chart proporciona un grfico de la edad media

(en das) de las incidencias no resueltas, en el proyecto o en el filtro
especificado, en los instantes especificados.
operaciones:
Figura 12.14.
(ii) Seleccionar el proyecto o el filtro a utilizarse como fuente de
datos introduciendo su nombre en el control Project or saved
filter o seleccionndolo en la ventana de seleccin de filtros y
proyectos a la que se accede seleccionando el control Advanced
search.
321
Figura 12.14: Gadget Average age chart
(iii) Seleccionar el tamao del interval de tiempo a utilizarse en el

men desplegable del control Period.
(iv) Introducir el nmero de das a tomarse en consideracin en el
control Days previously.
(v) Seleccionar la frecuencia de actualizacin de los datos del gadget
interval.
(vi) Confirmar la configuracin pulsando el botn Save.
322
12.11. Average age chart gadget
Figura 12.15: Gadget Average age chart
323
13
Gestionar el perfil del usuario
El perfil de usuario es el rea privada que contiene un resumen de
la posicin global del usuario, de sus proyectos y de sus tareas y
donde cada usuario de forma independiente puede especificar valores
personalizados para un conjunto de parmetros que personalizan la
funcionalidad y la apariencia de la plataforma. En este rea, adems,
el usuario tiene acceso a algunas tiles herramientas tales como un
conjunto de reportes personales.
Ejemplos de parmetros de configuracin de inters muy comn
que pueden establecerse a nivel de perfil de usuario son:
(i)
(ii)
(iii)
(iv)
(v)
El tamao de pgina.
El idioma del interfaz grfico.
El huso horario utilizado en la actualidad.
El tipo de formato de email que se desean recibir.
Las columnas visualizadas por defecto en los navegadores de
incidencia.
Para acceder al perfil del usuario, es necesario seleccionar el propio

nombre de usuario en la barra de herramientas de JIRA o el elemento
Profile en ese mismo men desplegable (como puede verse en Figura
13.1):
La ventana del perfil de usuario (Figura 13.2), contiene algunos
paneles, sobre los cuales destacan los siguiente1 :
(i) Details: donde puede consultarse un resumen de los detalles del
usuario.
1 Los paneles visibles en la ventana del perfil de usuario pueden depender de
las caractersticas de la instalacin de la plataforma y de la informacin presente
por cada uno de los usuarios.
325
13. Gestionar el perfil del usuario
Figura 13.1: Barra de herramientas Perfil de Usuario
(ii) Preferences: un conjunto de configuraciones y personalizaciones

de la plataforma.
(iii) Activity Stream: el flujo de actividad del usuario en cuestin.
Figura 13.2: Perfil de Usuario
Para modificar una propiedad en cualquier panel que lo prevea,

es necesario utilizar el icono de edicin ( ): JIRA proporcionar una
ventana de edicin en la cual ser posible personalizar las propiedades
modificables.
326
13.1. Modificar los detalles del usuario

13.1
Modificar los detalles del usuario
En el panel Details es posible modificar los siguientes parmetros:

(i)
(ii)
(iii)
(iv)
El avatar del usuario.

El nombre completo del usuario.
La direccin email del usuario.
La contrasea del usuario.
Para modificar uno de estos datos, con la excepcin del avatar, es

(i) Seleccionar el icono de edicin ( ) del panel.
(ii) En la ventana de edicin proporcionada por JIRA (Figura
13.3), modificar los parmetros que se desean modificar utilizando los campos correspondientes.
Figura 13.3: Perfil de usuario Edicin de los detalles de usuario
13.1.1
Modificar el avatar del usuario
Para modificar el avatar del usuario, es necesario efectuar las siguientes operaciones:
(i) Seleccionar el avatar corriente del usuario o el icono de edicin
del avatar ( ) que se encuentra a su derecha.
(ii) En la ventana de edicin del avatar (Figura 13.4) seleccionar
un avatar entre los avatares disponibles o subir al servidor un
avatar personalizado.
327
Figura 13.4: Perfil de usuario Edicin del avatar del usuario
(iii) En la ventana de edicin del avatar (Figura 13.4) puede seleccionarse a) un avatar entre los distribuidos con JIRA, disponibles en la pestaa Built-in; b) un avatar entre todos los disponibles en la plataforma, disponibles en la pestaa All; c) un
avatar entre los subidos por el usuario, disponibles en la pestaa Custom. Para seleccionar un avatar entre los avatares
existentes, es necesario seleccionarlo con un click del mouse.
(iv) Si se prefiere utilizar un avatar personalizado en lugar de un
avatar de los disponibles en la plataforma, es posible subir una
imagen a JIRA. Para subir un avatar personalizado, seleccionar el botn Choose File y seleccionar la imagen deseada. En
la ventana de edicin de los avatares personalizados (Figura
13.5) ser posible escoger la porcin de la imagen subida que se
desea utilizar. El avatar debe ser cuadrado y puede escogerse la
parte del a imagen deseada arrastrando la rejilla del avatar y
cambiar su dimensin arrastrando los tiradores cuadrados que
se encuentran en sus vrtices.
(v) Finalizar la operacin seleccionando el botn Choose Avatar y
el avatar seleccionado se asociar al usuario.
13.1.2
Modificar la contrasea
Como visto en la seccin precedente (13.1), la contrasea de un

usuario puede modificarse utilizando el procedimiento all detallado,
siempre que la gestin de las contrasea no haya sido delegada a un
programa externo. Sin embargo, la contrasea puede modificarse di328
13.1. Modificar los detalles del usuario
Figura 13.5: Perfil de usuario Edicin del avatar del usuario
rectamente seleccionando el enlace Change Password del campo Password en el panel Details. En este caso, JIRA visualizar la ventana de
cambio de contrasea (Figura 13.6) podr cambiarse la contrasea
utilizando el procedimiento detallado a continuacin:
(i) Introducir la contrasea actual en el campo Current Password.
(ii) Introducir la nueva contrasea en el campo New Password.
(iii) Introducir nuevamente la nueva contrasea en el campo Confirm
Password.
(iv) Confirmar la operacin pulsando el botn Update.
Figura 13.6: Perfil de usuario Cambio de contrasea
329

13.2
Modificar las preferencias del usuario
En el panel Preferences pueden cambiarse los siguientes parmetros

de configuracin del usuario:
(i) Page Size (Tamao de pgina): el nmero de incidencias visualizadas en una pgina del navegador de incidencias.
(ii) Email Type (Formato email): el formato de los emails que se
desea recibir de la plataforma.
(iii) Language (Idioma): el idioma del interfaz web de JIRA.
(iv) Time Zone (Huso horario): el huso horario a asociar al usuario.
(v) My Changes (Mis cambios): parmetro que controla si un usuario recibe notificaciones sobre sus propios cambios.
(vi) Sharing (Intercambio): valor por defecto de la opcin de intercambio de filtros y cuadros de mandos.
(vii) Keyboard Shortcuts (Atajos de teclado): parmetro que controla
si los atajos de teclado de JIRA estn habilitados.
(viii) Navigator Columns (Columnas del navegador): columnas visibles por defecto en la ventana del navegador de incidencias.
Las preferencias del usuario, con la excepcin de las columnas del
navegador, pueden cambiarse utilizando los correspondientes campos
de la ventana de modificacin de preferencias (Figura 13.7) accesible
seleccionando el icono de edicin ( ).
13.2.1
Cambiar las columnas del navegador de incidencias
Las columnas que por defecto se utilizan en el navegador de incidencias se establecen utilizando las siguientes opciones:
(i) Las columnas especificadas en el perfil del usuario conectado, si
existen.
(ii) Las columnas especificadas por el administrador a nivel de plataforma.
Cada usuario, por lo tanto, puede personalizar el aspecto del navegador de incidencias para que se utilicen, por defecto, las columnas que
ms le interesen.
Para modificar las columnas que el navegador de incidencias utilizar por defecto, es necesario efectuar las siguientes operaciones:
330
13.2. Modificar las preferencias del usuario
Figura 13.7: Perfil de usuario Modificacin de las preferencias
(i) Seleccionar el enlace View Navigator Columns en el campo Navigator Columns.

(ii) Seguir el procedimiento ya ilustrado en 6.3.
331
Apndices e ndices
333
A
Documento XML de bsqueda
title:
<title>[TEST-4] This is a test</title>
link:
<link>https://jira.url:443/jira/browse/TEST-4</link>
project:
<project id="10330" key="TST">Test</project>
description:
<description>Issue description.<description>
environment:
<environment>Sydney network<environment>
key:
<key id="22574">TEST-4</key>
summary:
<summary>This is a test<summary>
type:
<type id="3"
iconUrl="http://jira.url/jira/images/icons/...">
Task
</type>
priority:
<priority
id="4"
Minor
<priority>
335
A. Documento XML de bsqueda

status:
<status
id="5"
Resolved
</status>
resolution:
<resolution id="1">Fixed</resolution>
labels:
<labels>
<label>focus</label>
...
<labels>
assignee:
<assignee username="jsmith">John Smith</assignee>
reporter:
<security id="10021">Private</security>
created:
<created>
Mon, 1 Sep 2008 17:30:03 -0500 (CDT)
</created>
updated:
<updated>
Mon, 1 Sep 2008 17:30:03 -0500 (CDT)
</updated>
resolved:
<resolved>
Mon, 1 Sep 2008 17:30:03 -0500 (CDT)
</resolved>
due:
<due>
Mon, 1 Sep 2008 17:30:03 -0500 (CDT)
</due>
version:
<version>2.4.7</version>
fixfor:
336
<fixVersion>2.6</fixVersion>
component:
<component>Documentation</component>
votes:
<votes>1</votes>
comments:
<comments>
<comment id="39270" author="jsmith"
created="Tue, 24 Feb 2009 16:45:02 -0600 (CST)">
this looks familiar
</comment>
...
</comments>
attachments:
<attachments>
<attachment id="30318" name="image.png"
size="16161" author="yoz"
created="Mon, 9 Feb 2009 13:32:58 -0600 (CST)"/>
...
</attachments>
timeoriginalestimate:
<timeoriginalestimate seconds="600">
10 minutes
</timeoriginalestimate>
timeestimate:
<timeestimate seconds="300">
5 minutes
</timeestimate>
timespent:
<timespent seconds="300">
5 minutes
</timespent>
aggregatetimeoriginalestimate:
<aggregatetimeoriginalestimate seconds="36000">
10 hours
</aggregatetimeoriginalestimate>
aggregatetimeestimate:
337
A. Documento XML de bsqueda

<aggregatetimeremainingestimate seconds="18000">
5 hours
</aggregatetimeremainingestimate>
aggregatetimespent:
<aggregatetimespent seconds="18000">
5 hours
</aggregatetimespent>
timetracking:
<timeoriginalestimate seconds="600">
10 minutes
</timeoriginalestimate>
<timeestimate seconds="300">
5 minutes
</timeestimate>
<timespent seconds="300">
5 minutes
</timespent>
<aggregatetimeoriginalestimate seconds="36000">
10 hours
</aggregatetimeoriginalestimate>
<aggregatetimeremainingestimate seconds="18000">
5 hours
</aggregatetimeremainingestimate>
<aggregatetimespent seconds="18000">
5 hours
</aggregatetimespent>
issuelinks:
<issuelinks>
<issuelinktype id="10020">
<name>Duplicate</name>
<inwardlinks description="is duplicated by">
<issuelink>
<issuekey id="22477">INTSYS-1009</issuekey>
</issuelink>
</inwardlinks>
</issuelinktype>
</issuelinks>
subtasks:
<subtasks>
<subtask id="22623">TEST-8</subtask>
</subtasks>
338
customfield_xxxxx:
<customfields>
<customfield id="customfield_10112"
key="com.atlassian.jira.plugin.system.customfieldtypes:select">
<customfieldname>Department</customfieldname>
<customfieldvalues>
<customfieldvalue>Adminstration</customfieldvalue>
</customfieldvalues>
</customfield>
</customfields>
allcustom:
<customfields>
<customfield id="customfield_10112"
key="com.atlassian.jira.plugin.system.customfieldtypes:select">
<customfieldname>Department</customfieldname>
<customfieldvalues>
<customfieldvalue>Adminstration</customfieldvalue>
</customfieldvalues>
</customfield>
...
</customfields>
339
B
Campos y funciones JQL
Este captulo es un captulo de referencia sobre los aspectos del lenguaje JQL que, por razones de espacio o oportunidad, no se han
detallado en otros captulos del libro. Como tal, este captulo ser
til a la hora de solucionar las dudas o profundizar las cuestiones que
puedan surgir mientras se editan consultas JQL.
B.1
Campos
En este apartado se detallarn las caractersticas de los campos que

pueden utilizarse en las consultas JQL.
En la primera seccin se detallarn los tipos y los operadores soportados por cada uno de los campos. La mayora de las caractersticas de un campo estn determinadas por su tipo y las caractersticas
comunes a todos los campos se han detallado anteriormente en 7: en
este captulo, por lo tanto, se dedicar una seccin exclusivamente a
aquellos campos que necesitasen informacin adicional.
B.1.1
Nombres o identificadores?
Algunos campos representan atributos que pueden ser filtrados tanto

por nombre como por identificador. Los identificadores son coordenadas nicas, generalmente numricas, que JIRA establece al momento de la creacin de una entidad y no cambiarn nunca a lo
largo de la vida de la misma. Los nombres, sin embargo, son mnemnicos asignados por los administradores del proyecto y pueden
cambiarse en cualquier momento.
Durante la edicin de consultas que utilicen campos con esta caracterstica, es aconsejable utilizar el identificador en lugar del nombre
siempre que se pueda. Debido a la volatilidad de los nombres, las
341
B. Campos y funciones JQL

consultas que utilicen este dato son frgiles y susceptibles a invalidarse con el paso del tiempo. Si, adems, se decide grabar una consulta
y almacenarla como filtro, es todava ms importante utilizar parmetros que no estn susceptibles a variaciones ya que, con el paso del
tiempo, una modificacin en un nombre podra invalidar cualquier
filtro que est utilizando este ltimo como valor de un campo.
La utilizacin de identificadores en lugar de nombres aporta adems otra ventaja. Los identificadores son coordenadas nicas a nivel
global: ninguna entidad de JIRA, en cualquier proyecto, podr ser
asignada un identificador ya utilizado por otra entidad. Los nombres,
sin embargo, no garantizan este tipo de unicidad y, por lo tanto, una
consulta que utilice nombres es frgil ya que, si no se toman precauciones1 , podran devolverse resultados que no se esperan provenientes
de otros proyectos.
Los campos que tienen esta particularidad son los campos de los
tipos siguientes:
(i)
(ii)
(iii)
(iv)
(v)
(vi)
(vii)
(viii)
Versin
Componente
Filtro
Nivel de seguridad
Prioridad
Resolucin
Estado
Tipo de incidencia
Esta informacin tambin est convenientemente resumida en Tabla

B.1.
B.1.2
Tipos de campos JQL
Los campos JQL estn subdivididos en tipos y esta propiedad determina la mayora del comportamiento del campo, tanto a nivel de
formato de los valores aceptados, como a nivel de operadores (B.1.3)
o funciones (B.2) soportadas por dichos campos.
Los tipos de campos que existen en JIRA son los detallados en
Tabla B.1. La primera segunda columna de esta tabla indica el
smbolo que hemos escogido para referirnos al tipo de campo. La
utilizacin de esta simbologa se debe a razones prcticas, como por
1 Tales
como filtrar de forma explcita la lista de proyectos en la que se est

efectuando la bsqueda.
342
B.1. Campos
Tipo
Versin
Usuario
Categora
Texto
Componente
Fecha
Filtro
Incidencia
Nivel de seguridad
Duracin
Prioridad
Proyecto
Resolucin
Estado
Tipo de incidencia
Nmero
Cascading option
Smbulo
Clave/Valor
v
u
l
t
c
f
x
i
s
d
o
p
r
e
y
n
co
Tabla B.1: Tipos de campos JQL.
ejemplo situaciones en los cuales existen restricciones de espacio como

las tablas, y est restringida al contexto de esta gua.
La segunda columna de la tabla indica si el campo soporta la
dualidad identificador/nombre durante la evaluacin de las consultas. Cuando se utilicen campos de este tipo, se recomienda seguir las
indicaciones detalladas en B.1.1.
B.1.3
Operadores soportados por los campos
En Tabla B.2 se detallan los operadores soportados por todos los

campos. Para razones de espacio se utilizar una sola columna para
los siguientes grupos de operadores:
(i)
(ii)
(iii)
(iv)
(v)
= y 6=, indicados con el smbulo =.

y !, indicados con el smbulo .
>, , < y , indicados con el smbulo .
is, is not, indicados con el smbulo .
in, not in, indicados con el smbulo .
343

Si un campo soporta un operador entonces soportar tambin el operador inverso y si un campo es de un tipo para el cual existe la relacin
de rden, soportar todos los operadores en (iii).
En la columna tipo se detallar el tipo de campo utilizando los
smbolos definidos en Tabla B.1.
affectedVersion
assignee
category
comment
component
created
description
due
environment
filter
fixVersion
issueKey
level
originalEstimate
parent
priority
project
remainingEstimate
reporter
resolution
resolved
status
summary
text
type
timeSpent
updated
voter
votes
watcher
workRatio
tipo
v
u
l
t
c
f
t
f
t
x
v
i
s
d
i
o
p
d
u
r
f
e
t
t
y
d
f
u
n
u
n
Tabla B.2: Operadores soportados por los campos JQL.
En el caso de los campos personalizados, la lista de operadores

soportados depender del tipo de campo en cuestin:
344
B.1. Campos
(i) Numricos: los campos de tipo nmero o fecha soportarn relaciones de equivalencia, rden.
(ii) Seleccin: los campos de tipo picker, seleccin, check box y radio
soportarn relaciones de equivalencia.
(iii) Texto: los campos de tipo texto soportarn todas las funcionalidades relacionadas con la bsqueda de texto.
En Tabla B.3 puede verse la lista de operadores soportados por los
varios tipos de campos personalizados.
=
Numrico
Seleccin
Texto
Tabla B.3: Operadores JQL soportados por campos personalizados.
B.1.4
Campos de tipo versin
Los campos de tipo versin soportan los operadores y las funciones

detalladas en Tabla B.4.
affectedVersion
fixVersion
releasedVersions()
unreleasedVersions()
tipo
v
v
Tabla B.4: Operadores y funciones soportados por campos de tipo

versin.
Como explicado en B.1.1, debido a que el nombre de una versin

puede cambiar a lo largo de la vida de un proyecto y debido a que
proyectos distintos pueden tener versiones con el mismo nombre, se
aconseja utilizar el identificador de versin en las bsquedas, especialmente cuando las bsquedas se graban en filtros. De esta forma,
siendo ste un valor nico que no puede cambiarse, los filtros existentes no se vern afectados por eventuales operaciones de renombrado
de las versiones de un proyecto.
345

Los campos de tipo versin soportan la relacin de rden detallada
en ??.
Ejemplo B.1. Para buscar las incidencias que afecten a la versin
1.0, ser necesario utilizar la siguiente proposicin:
affectedVersion = "1.0"
Ntese que en la proposicin precedente, debido a que el punto (.)

es un carcter reservado (vase 7.2), es necesario poner el valor del
campo entre comillas.
Ejemplo B.2. Para buscar las incidencias que afecten a la versin
cuyo identificados es 10350, ser necesario utilizar la siguiente proposicin:
affectedVersion = 10350
B.1.5
Campos de tipo usuario
Los campos de tipo usuario soportan los operadores y las funciones

assignee
reporter
voter
watcher
currentUsers()
membersOf()
tipo
u
u
u
u

usuario.
El valor especificado para un campo de tipo usuario se comparar

con los atributos nombre, identificado y direccin de correo electrnico de los usuarios de JIRA y se devolvern aquellas incidencias
para las cuales al menos uno de estos atributos satisfaga el criterio
especificado.
Cuando se evalen proposiciones que utilicen los campos voter y
watcher se podr acceder exclusivamente a los valores para los cuales
346
B.1. Campos
el usuario que efecta la bsqueda tenga el permiso View voters and
watchers.
Ejemplo B.3. Para buscar las incidencias cuyo asignatario sea el
usuario que efecta la bsqueda, ser necesario utilizar la siguiente
proposicin:
assignee = currentUser()
Ejemplo B.4. Para buscar las incidencias cuyo asignatario tenga la

direccin de correo electrnico especificada, ser necesario utilizar la
assignee = "enrico@myserver.com"
ntese que en la proposicin precedente, debido a que el arroba (@)

es un carcter reservado (vase ??), es necesario poner el valor entre
comillas.
B.1.6
Campos de tipo categora
Los campos de tipo categora soportan los operadores y las funciones

category
tipo

categora.
B.1.7
Campos de tipo texto
Los campos de tipo texto soportan los operadores y las funciones

Todos los campos detallados en Tabla ?? permiten efectuar bsquedas en los campos correspondientes de las incidencias.
El campo text, sin embargo, no corresponde a ningn atributo de
una incidencia y es un campo maestro que permite buscar en todos
los campos de tipo texto en una nica proposicin. Los campos que
347

tipo
comment
description
environment
summary
text
t
t
t
t
t
Tabla B.7: Operadores y funciones soportados por campos de tipo texto.
se examinarn durante una proposicin que utilice el campo text son

los siguientes:
(i)
(ii)
(iii)
(iv)
(v)
Ttulo.
Descripcin.
Entorno.
Comentarios.
Campos personalizados que utilicen el buscador de texto libre
(??), tales como:
a) Campo de texto libre.
b) Campo de texto.
c) Campo de texto de sola lectura.
Ejemplo B.5. Para buscar las incidencias cuyo ttulo contenga el

trmino transferencia ser necesario utilizar la siguiente proposicin:
summary ~ transferencia
Ejemplo B.6. Para buscar las incidencias que tengan un campo

de texto que contenga el trmino enrico ser necesario utilizar la
text ~ enrico
Ejemplo B.7. Para buscar las incidencias que tengan un campo de

texto que contenga la frase pago de factura ser necesario utilizar la
348
B.1. Campos
text ~ "pago de factura"
B.1.8
Campos de tipo componente
Los campos de tipo componente soportan los operadores y las funciones detalladas en Tabla B.8.
component
componentsLeadByUser()
tipo

componente.
Como explicado en B.1.1, el valor especificado para un campo de

tipo componente puede ser tanto el nombre como el identificador del
componente. Es aconsejable utilizar el identificador del componente en lugar del nombre ya que el primero es un identificador nico,
generado al momento de la creacin del componente, que no puede
cambiarse a lo largo de la vida del proyecto. El nombre de un componente, sin embargo, puede cambiarse en cualquier momento y, por lo
tanto, las consultas que utilicen este dato son frgiles y susceptibles a
invalidarse con el paso del tiempo. Los nombres de los componentes,
adems, no siendo nicos, pueden repetirse en mltiples proyectos y,
por lo tanto, las consultas pueden devolver datos inesperados si esta
situacin no se maneja oportunamente.
Ejemplo B.8. Para buscar las incidencias que pertenezcan al componente cuyo identificador es 20500, ser necesario utilizar la siguiente
proposicin:
component = 20500
B.1.9
Campos de tipo fecha
Los campos de tipo fecha soportan los operadores y las funciones

El formato de los valores aceptados para un campo de tipo fecha
son los siguientes:
349
created
due
resolved
updated
currentLogin()
lastLogin()
now()
tipo
f
f
f
f
Tabla B.9: Operadores y funciones soportados por campos de tipo fecha.
(i)
(ii)
(iii)
(iv)
(v)
"yyyy/MM/dd HH:mm".
"yyyy-MM-dd HH:mm".
"yyyy/MM/dd".
"yyyy-MM-dd".
"xw yd zh tm".
Los primeros 4 formatos se utilizan para especificar una fecha absoluta mientras que el ltimo formato se utiliza para indicar una fecha
relativa.
En el formato de campo para fechas relativas, los coeficientes de los
campos w, d, h y t indican, respectivamente, el nmero de semanas,
horas, das y minutos. El signo + indicar una intervalo en el futuro
mientras que el signo indicar una intervalo en el pasado.
El campo due solo contiene informacin acerca de la fecha de
resolucin e ignora la informacin relativa a la hora.
Ejemplo B.9. Para buscar las incidencias que se hayan creado despus del da 06/09/2010 (6 de Septiembre del 2010), ser necesario
utilizar la siguiente proposicin:
created > "2010/09/06"
Ntese que, para satisfacer el formato de este campo, deber ponerse

antes el ao, seguido por mes y da.
Ejemplo B.10. Para buscar las incidencias que no se hayan actualizadas en las ltimas 3 semanas, ser necesario utilizar la siguiente
proposicin:
updated < "-3w"
350
B.1. Campos
B.1.10
Campos de tipo filtro
Los campos de tipo filtro soportan los operadores y las funciones

filter
tipo

filtro.
El campo JQL filter no es un atributo de las incidencias de JIRA

y proporciona un mecanismo para acotar las incidencias filtradas a
los resultados de un filtro existente.
Como explicado en B.1.1, es aconsejable utilizar el identificador
del filtro en lugar del nombre ya que el primero es un identificador
nico, generado al momento de la creacin del filtro, que no puede
cambiarse a lo largo de su vida. El nombre de un filtro, sin embargo,
puede cambiarse en cualquier momento y, por lo tanto, las consultas
que utilicen este dato son frgiles y susceptibles a invalidarse con el
paso del tiempo.
Cuando se utiliza este campo es importante subrayar lo siguiente:
(i) El ordenamiento que, opcionalmente, se especifique en la consulta (con el operador order by) tendr precedencia sobre el
ordenamiento especificado en el filtro.
(ii) No puede ejecutarse una consulta que genere un bucle infinito,
por ejemplo utilizando un filtro que a su vez haga referencia al
filtro corriente.
Ejemplo B.11. Para buscar las incidencias devueltas por el filtro
con identificador 12000 para seleccionar aquellas asignadas al usuario
enrico, ser necesario utilizar la siguiente proposicin:
filter = 12000 and assignee = enrico
Ejemplo B.12. Para buscar las incidencias devueltas por el filtro

llamado rdenes impagados, ser necesario utilizar la siguiente proposicin:
351

filter = "rdenes impagados"
Ntese que, en este caso, se est utilizando el nombre de un filtro en

lugar de su identificador y, por lo tanto, el usuario est expuestos a
los problemas detallados en B.1.1.
B.1.11
Campos de tipo incidencia
Los campos de tipo incidencia soportan los operadores y las funciones

detalladas en Tabla B.11 y Tabla B.12.
issueKey
issueHistory()
linkedIssues()
votedIssues()
watchedIssues()
tipo

incidencia.
parent
tipo

incidencia.
Ejemplo B.13. Para buscar la incidencia con identificador JGD-135,

ser necesario utilizar la siguiente proposicin:
issueKey = JGD-135
B.1.12
Campos de tipo nivel de seguridad
Los campos de tipo nivel de seguridad soportan los operadores y las

funciones detalladas en Tabla B.13.
del nivel de seguridad en lugar del nombre ya que el primero es un
352
B.1. Campos
level
tipo

nivel de seguridad.
identificador nico, generado al momento de la creacin del nivel, que

no puede cambiarse a lo largo de su vida. El nombre de un nivel de
seguridad, sin embargo, puede cambiarse en cualquier momento y, por
lo tanto, las consultas que utilicen este dato son frgiles y susceptibles
a invalidarse con el paso del tiempo.
Ejemplo B.14. Para buscar la incidencia con nivel de seguridad Responsables de proyecto o operadores, ser necesario utilizar la siguiente
proposicin:
level in ("Responsables de proyecto",operadores)
B.1.13
Campos de tipo duracin
Los campos de tipo duracin soportan los operadores y las funciones

originalEstimate
remainingEstimate
timeSpent
tipo
d
d
d

duracin.
El formato de los valores aceptados para un campo de tipo duracin es:

(i) "xw yd zh tm".
Los coeficientes de los campos w, d, h y t indican, respectivamente, el
nmero de semanas, horas, das y minutos. El signo + indicar una
353

intervalo en el futuro mientras que el signo indicar una intervalo
en el pasado.
B.1.14
Campos de tipo prioridad
Los campos de tipo prioridad soportan los operadores y las funciones

priority
currentLogin()
lastLogin()
now()
tipo

prioridad.

de la prioridad en lugar del nombre ya que el primero es un identificador nico, generado al momento de la creacin del nivel, que no
puede cambiarse a lo largo de su vida. El nombre de una prioridad,
sin embargo, puede cambiarse en cualquier momento y, por lo tanto, las consultas que utilicen este dato son frgiles y susceptibles a
invalidarse con el paso del tiempo.
Ejemplo B.15. Para buscar las incidencias con prioridad High, ser
necesario utilizar la siguiente proposicin:
priority = High
B.1.15
Campos de tipo proyecto
Los campos de tipo proyecto soportan los operadores y las funciones

El campo project permite filtrar las incidencias por proyecto y el
valor utilizado en la proposicin ser comparado con los atributos
nombre de proyecto, clave de proyecto e identificador de proyecto: las
incidencias que pertenezcan a un proyecto que satisfaga al menos uno
de dichos atributos sern devueltas como resultado.
354
B.1. Campos
tipo
project
projectsLeadByUser()
projectsWhereUserHasPermission()
projectsWhereUserHasRole()

proyecto.
Ejemplo B.16. Para buscar las incidencia que pertenezcan al proyecto que se llame JIRA Guide, ser necesario utilizar la siguiente
proposicin:
project = "JIRA Guide"
Ejemplo B.17. Para buscar las incidencia que pertenezcan al proyecto cuya clave sea JRAGD, ser necesario utilizar la siguiente proposicin:
project = "JRAGD"
B.1.16
Campos de tipo resolucin
Los campos de tipo resolucin soportan los operadores y las funciones

resolution
tipo

resolucin.

tipo resolucin puede ser tanto el nombre como el identificador de la
resolucin. Es aconsejable utilizar el identificador del resolucin en
lugar del nombre ya que el primero es un identificador nico, generado
355

al momento de la creacin de la misma, que no puede cambiarse a lo
largo de su vida. El nombre de una resolucin, sin embargo, puede
cambiarse en cualquier momento y, por lo tanto, las consultas que
utilicen este dato son frgiles y susceptibles a invalidarse con el paso
del tiempo.
Ejemplo B.18. Para buscar las incidencia que no hayan sido resueltas todava, ser necesario utilizar la siguiente proposicin:
resolution = unresolved
Ejemplo B.19. Para buscar las incidencia que no hayan sido resultas
con resolucin Cannot reproduce, ser necesario utilizar la siguiente
proposicin:
resolution = "Cannot Reproduce"
B.1.17
Campos de tipo estado
Los campos de tipo estado soportan los operadores y las funciones

status
tipo

estado.
Como explicado en B.1.1, el valor especificado para un campo

de tipo estado puede ser tanto el nombre como el identificador del
estado. Es aconsejable utilizar el identificador de estado en lugar
del nombre ya que el primero es un identificador nico, generado al
momento de la creacin del mismo, que no puede cambiarse a lo largo
de su vida. El nombre de un estado, sin embargo, puede cambiarse
en cualquier momento y, por lo tanto, las consultas que utilicen este
dato son frgiles y susceptibles a invalidarse con el paso del tiempo.
Ejemplo B.20. Para buscar las incidencia que estn en estado Open,
ser necesario utilizar la siguiente proposicin:
356
B.1. Campos
status = Open
B.1.18
Campos de tipo tipo de incidencia
Los campos de tipo tipo de incidencia soportan los operadores y las

funciones detalladas en Tabla B.19.
type
tipo
Tabla B.19: Operadores y funciones soportados por campos de tipo tipo

de incidencia.

tipo tipo de incidencia puede ser tanto el nombre como el identificador del tipo de incidencia. Es aconsejable utilizar el identificador de
tipo de incidencia en lugar del nombre ya que el primero es un identificador nico, generado al momento de la creacin del mismo, que no
puede cambiarse a lo largo de su vida. El nombre de un tipo de incidencia, sin embargo, puede cambiarse en cualquier momento y, por lo
tanto, las consultas que utilicen este dato son frgiles y susceptibles
a invalidarse con el paso del tiempo.
Ejemplo B.21. Para buscar las incidencia de tipo bug, ser necesario
type = Bug
Ejemplo B.22. Para buscar las incidencia de tipo factura, ser necesario utilizar la siguiente proposicin:
type = Factura
357
votes
workRatio
tipo
n
n

nmero.
B.1.19
Campos de tipo nmero
Los campos de tipo nmero soportan los operadores y las funciones

El campo votes permite filtrar las incidencias utilizando el nmero
usuarios que hayan votado la incidencia.
El campo work ratio permite filtrar las incidencia utilizando el porcentaje de trabajo, w, definido como relacin entre trabajo realizado,
wr , y trabajo estimado total, wt :
w=
B.2
wr
100
wt
(B.1)
Funciones
JIRA ofrece un conjunto de funciones JQL que pueden utilizarse en

las consultas en lugar de un valor. Las funcionen responden a la necesidad de poder expresar, grabar y compartir consultas en las cuales
aparecen campos cuyo valor depende, por ejemplo, del usuario que
est ejecutando la misma y que deberan establecerse en tiempo de
ejecucin.
El valor devuelto por una funcin, generalmente, depende de parmetros tales como el usuario que efecta la consulta, el instante en
que se efecta una consulta, las polticas de seguridad en vigor o los
atributos de las incidencias que se examinan. Algunas funciones, adems, devuelven valores de los parmetros de configuracin de JIRA y
sus proyectos (tales como los componentes liderados por un usuario).
Sin ellas, no sera posible efectuar algunas consultas de forma sencilla
y sera necesario efectuarlas en dos pasos: antes, habra que determinar los valores por los que se desean filtrar los campos2 y, despus,
efectuar la consulta con los valores adecuados.
2 Ya
sea a travs de otra consulta o examinando directamente la configuracin

de JIRA y sus proyectos.
358
B.2. Funciones
Sin funciones no podran compartirse, por ejemplo, consultas tan
sencillas como incidencias abiertas por el usuario que efecta la consulta. En falta de una funcin (currentUser()) que devuelva dinmicamente el nombre del usuario actualmente conectado, cada
usuario debera remplazar el valor del campo assignee en la consulta:
assignee = enrico ...
De esta forma, sera materialmente imposible grabar esta consulta en

un filtro y compartirlo con otros usuarios ya que, cada uno de ellos,
debera modificar la misma y guardarla en otro filtro.
Las funciones devuelven valores de distintos tipos y, por lo tanto,
una funcin no puede utilizarse con cualquier combinacin de campo
y operador: dependiendo de la combinacin utilizada, como puede
verse en Tabla B.21, existe un conjunto de funciones soportadas
cuya funcionalidad ser detallada a continuacin.
tipo
cascadeOption(.,.)
componentsLeadByUser(.)
currentLogin()
currentUser()
issueHistory()
lastLogin()
linkedIssues(.,.)
membersOf(.)
now()
projectsLeadByUser(.)
projectsWhereUserHasPermission(.)
projectsWhereUserHasRole(.)
releasedVersions(.)
standardIssueTypes()
subtaskIssueTypes()
unreleasedVersions(.)
votedIssues()
watchedIssues()
co
c
f
u
i
f
i
u
f
p
p
p
v
y
y
v
i
i
Tabla B.21: Funciones JQL soportados por tipo de campo de campo y

clase de operador.
359

En la primera columna de la tabla se indica el nombre de la funcin. Si la funcin acepta parmetros, entonces se indicarn con la
notacin (.,.) en el nombre de la funcin.
En la segunda columna se indica el tipo de campo con el cual puede
utilizarse la funcin. La nomenclatura de tipos es la misma que se ha
utilizado en precedencia y que es detallada en Tabla B.1.
En las siguientes columnas se indica cuales operadores estn soportados por la funcin, agrupando los operadores JQL en los grupos
que se han utilizado con anterioridad. Para mayores detalles sobre
esta notacin, vase B.1.3.
Ejemplo B.23. La funcin projectsWhereUserHasPermission, por
ejemplo, tiene las siguientes caractersticas:
(i) Acepta un parmetro.
(ii) Puede utilizarse con campos de tipo proyecto.
(iii) Puede utilizarse exclusivamente con operadores de tipo , es
decir, los operadores in y not in.
Ejemplo B.24. La funcin currentLogin, por ejemplo, tiene las

siguientes caractersticas:
(i) No acepta ningn parmetro.
(ii) Puede utilizarse con campos de tipo fecha.
(iii) Puede utilizarse exclusivamente con operadores de tipo = y ,
es decir, los operadores =, !=, <, <=, > y >=.
B.2.1
Funcin cascadeOption
La funcin cascadeOption soporta el tipo de campo y los operadores

detallados en Tabla B.22. Esta funcin permite filtrar las incidentipo
cascadeOption(.,.)
co
Tabla B.22: Tipo de campo de campo y clase de operador soportada por

cascadeOption.
360
B.2. Funciones
cias por un campo de tipo cascading select de uno o dos niveles de
profundidad.
La funcin acepta dos parmetros:
(i) El primer parmetro identifica la opcin de primer nivel contra
la cual hay que filtrar el campo de las incidencias.
(ii) El segundo parmetro, un parmetro opcional, identifica la opcin de segundo nivel contra la cual hay que filtrar el campo de
las incidencias.
Para indicar como parmetro a una opcin vaca puede utilizarse la
palabra clave none.
Ejemplo B.25. Si se ha definido un campo personalizado de tipo
cascading option, llamado provincia, para filtrar aquellas incidencias
cuyo campo sea la pareja (Espaa, Madrid), ser necesario efectuar
provincia in cascadeOption("Espaa", "Madrid")
Ejemplo B.26. Si se ha definido el mismo campo personalizado descrito en el ejemplo B.25, para filtrar aquellas incidencias cuyo campo
sea la pareja (Espaa, ), es decir, en el cual el valor de primer nivel sea Espaa y el valor de segundo nivel est vaco, ser necesario
efectuar utilizar la siguiente proposicin:
provincia in cascadeOption("Espaa", none)
Ejemplo B.27. Si se ha definido el mismo campo personalizado descrito en el ejemplo B.25, para filtrar aquellas incidencias cuyo campo
est vaco (en ambos niveles), ser necesario efectuar utilizar la siguiente proposicin:
provincia in cascadeOption(none)
361

tipo
componentsLeadByUser(.)

componentsLeadByUser.
B.2.2
Funcin componentsLeadByUser
La funcin componentsLeadByUser soporta el tipo de campo y los

operadores detallados en Tabla B.23. Esta funcin permite filtrar las
incidencias por un campo de tipo componente utilizando el conjunto
de componentes cuyo lder sea el usuario especificado por parmetro.
La funcin acepta un parmetros:
(i) El primer parmetro, opcional, identifica el usuario lder de los
componentes que se desean buscar. En el caso en que no se especificare este parmetro, la funcin devolver los componentes
liderados por el usuario que est efectuando la consulta.
En el caso en que el usuario que efecta la consulta no est autenticado en JIRA, as como en el caso en que se pretenda grabar
la consulta en un filtro que pueda ser utilizado por un usuario no
autenticado, el parmetro debe ser especificado.
Ejemplo B.28. Para filtrar aquellas incidencias cuyo campo component
contenga un componente liderado por el usuario enrico, ser necesario
component in componentsLeadByUser(enrico)
Ejemplo B.29. Para filtrar aquellas incidencias cuyo campo component

contenga un componente liderado por el usuario que est efectuando
la consulta, ser necesario efectuar utilizar la siguiente proposicin:
component in componentsLeadByUser()
362
B.2. Funciones
currentLogin()
tipo

currentLogin.
B.2.3
Funcin currentLogin
La funcin currentLogin soporta el tipo de campo y los operadores

detallados en Tabla B.24. Esta funcin devuelve la fecha correspondiente al momento en que el usuario que est efectuando la consulta
ha efectuado login en la plataforma. Vase la funcin lastLogin
(??), que devuelve la fecha de autenticacin en la sesin anterior.
Ejemplo B.30. Para filtrar aquellas incidencias que se han creado
despus de que el usuario haya hecho login, ser necesario efectuar
created > currentLogin()
Ejemplo B.31. Para filtrar aquellas incidencias que se han actualizado despus de que el usuario haya hecho login, ser necesario efectuar
updated > currentLogin()
Ejemplo B.32. Para filtrar aquellas incidencias que se han resuelto

despus de que el usuario haya hecho login, ser necesario efectuar
resolved > currentLogin()
B.2.4
Funcin currentUser
La funcin currentUser soporta el tipo de campo y los operadores

detallados en Tabla B.25. Esta funcin devuelve el usuario actualmente conectado a la plataforma.
363
currentUser()
tipo

currentUser.
Si el usuario que efecta la consulta no est autenticado en JIRA,

esta funcin no est disponible. En este caso, por lo tanto, as como
en el caso en que se pretenda grabar la consulta en un filtro que pueda
ser utilizado por un usuario no autenticado, no hay que utilizar esta
funcin.
Ejemplo B.33. Para filtrar aquellas incidencias asignadas al usuario
que est efectuando la consulta, ser necesario efectuar utilizar la
assignee = currentUser()
Ejemplo B.34. Para filtrar aquellas incidencias asignadas al usuario

que est efectuando la consulta y que no hayan sido creadas por l,
ser necesario efectuar utilizar la siguiente proposicin:
assignee = currentUser() and created != currentUser()
B.2.5
Funcin issueHistory
La funcin issueHistory soporta el tipo de campo y los operadores

detallados en Tabla B.26. Esta funcin devuelve el conjunto de incitipo
issueHistory()

issueHistory.
dencias que estn en la historia reciente del usuario, es decir, aquellas

incidencias que el usuario haya utilizado recientemente.
364
B.2. Funciones
Si el usuario est autenticado en la plataforma, JIRA devolver
las ltimas 50 incidencias que el usuario haya utilizado en la sesin
corriente y en las dems sesiones. Si el usuario no est autenticado,
JIRA devolver exclusivamente las incidencias que hayan sido utilizadas en la sesin de navegacin corriente.
Ejemplo B.35. Para filtrar aquellas incidencias asignadas al usuario que est efectuando la consulta y que hayan sido utilizadas recientemente por el mismo, ser necesario efectuar utilizar la siguiente
proposicin:
assignee = currentUser() and issue in issueHistory()
B.2.6
Funcin lastLogin
La funcin lastLogin soporta el tipo de campo y los operadores

detallados en Tabla B.27. Esta funcin devuelve la fecha correspon-
lastLogin()
tipo

lastLogin.
diente al momento en que el usuario que est efectuando la consulta

ha efectuado login en la plataforma en la sesin precedente. Vase la
funcin currentLogin (??), que devuelve la fecha de autenticacin
en la sesin corriente.
Ejemplo B.36. Para filtrar aquellas incidencias que se han resuelto
despus de la precedente sesin de usuario, ser necesario efectuar
resolved > lastLogin()
365

tipo
linkedIssues(.,.)

linkedIssues.
B.2.7
Funcin linkedIssues
La funcin linkedIssues soporta el tipo de campo y los operadores

detallados en Tabla B.28. Esta funcin devuelve el conjunto de incidencias con las cuales la incidencia especificada establece un enlace.
La bsqueda se puede acotar utilizando los parmetros de la funcin,
que son los siguientes:
(i) El primer parmetro es la clave de la incidencia de la cual se
buscan los enlaces.
(ii) El segundo parmetro, opcional, es el tipo de enlace que se desea
encontrar. Es importante subrayar que este parmetro es casesensitive.
Ejemplo B.37. Para filtrar aquellas incidencias que tengan un enlace con la incidencia JRAGD-1, ser necesario efectuar utilizar la
issue in linkedIssues(JRAGD-1)
Ejemplo B.38. Para filtrar aquellas incidencias que tengan un enlace

de tipo is duplicated by con la incidencia JRAGD-1, ser necesario
issue in linkedIssues(JRAGD-1, "is duplicated by")
B.2.8
Funcin membersOf
La funcin membersOf soporta el tipo de campo y los operadores

detallados en Tabla B.29. Esta funcin devuelve el conjunto de
usuarios que pertenecen al grupo especificado por parmetro. Los
parmetros aceptados por la funcin son los siguientes:
366
B.2. Funciones
tipo
membersOf(.)

membersOf.
(i) El grupo del cual se quieren encontrar los usuarios.

Ejemplo B.39. Para filtrar aquellas incidencias que tengan un enlace
de tipo is duplicated by con la incidencia JRAGD-1, ser necesario
issue in linkedIssues(JRAGD-1, "is duplicated by")
B.2.9
Funcin now
La funcin now soporta el tipo de campo y los operadores detallados

en Tabla B.30. Esta funcin devuelve la fecha correspondiente al
now()
tipo

now.
instante en que se est evaluando la funcin.

Ejemplo B.40. Para filtrar aquellas incidencias que hayan vencido en el instante de la bsqueda, ser necesario efectuar utilizar la
due < now() and status not in (closed, resolved)
B.2.10
Funcin projectsLeadByUser
La funcin projectsLeadByUser soporta el tipo de campo y los operadores detallados en Tabla B.31. Esta funcin devuelve el conjunto
de proyectos liderados por el usuario especificado por parmetro. Los
parmetros aceptados por la funcin son los siguientes:
367

tipo
projectsLeadByUser(.)

projectsLeadByUser.
(i) El primer parmetro, opcional, es el usuario del cual se quieren

buscar los proyectos liderados. Si no se especifica ningn valor,
la funcin devolver los proyectos liderados por el usuario que
est efectuando la consulta.
Si el usuario que efecta la consulta no est autenticado en JIRA,
el parmetro debe ser especificado. En este caso, por lo tanto, as
como en el caso en que se pretenda grabar la consulta en un filtro
que pueda ser utilizado por un usuario no autenticado, no hay que
utilizar esta funcin sin especificar el parmetro.
Ejemplo B.41. Para filtrar aquellas incidencias que estn abiertas en
un proyecto liderado por uno mismo, ser necesario efectuar utilizar
la siguiente proposicin:
project in projectsLeadByUser() AND status = Open
Ejemplo B.42. Para filtrar aquellas incidencias que estn abiertas

en un proyecto liderado por el usuario enrico, ser necesario efectuar
project in projectsLeadByUser(enrico) AND status = Open
B.2.11
Funcin projectsWhereUserHasPermission
La funcin projectsWhereUserHasPermission soporta el tipo de

campo y los operadores detallados en Tabla B.32. Esta funcin
devuelve el conjunto de proyectos en los cuales el el usuario posee el
permiso especificado por parmetro. Los parmetros aceptados por
la funcin son los siguientes:
368
B.2. Funciones
tipo
projectsWhereUserHasPermission(.)

projectsWhereUserHasPermission.
(i) El primer parmetro es el permiso que tiene que tener el usuario en los proyectos especificados. Puede utilizarse cualquier
permiso de proyecto, cuya lista puede encontrarse en ??.
autenticado, esta funcin no puede utilizarse.
cualquier proyecto donde se tenga permiso para resolver incidencias,
project in projectsWhereUserHasPermission("Resolve Issues")
AND status = Open
B.2.12
Funcin projectsWhereUserHasRole
La funcin projectsWhereUserHasRole soporta el tipo de campo y

los operadores detallados en Tabla B.33. Esta funcin devuelve el
tipo
projectsWhereUserHasRole(.)

projectsWhereUserHasRole.
conjunto de proyectos en los cuales el el usuario posee el rol especificado por parmetro. Los parmetros aceptados por la funcin son
los siguientes:
(i) El primer parmetro es el rol que tiene que tener el usuario en
los proyectos especificados.
369

autenticado, esta funcin no puede utilizarse.
cualquier proyecto donde se tenga rol de desarrollador, ser necesario
project in projectsWhereUserHasRole("Developers")
AND status = Open
B.2.13
Funcin releasedVersions
La funcin releasedVersions soporta el tipo de campo y los operadores detallados en Tabla B.34. Esta funcin devuelve el conjunto
tipo
releasedVersions(.)

releasedVersions.
de versiones entregadas en el proyecto especificado por parmetro.

Los parmetros aceptados por la funcin son los siguientes:
(i) El primer parmetro, opcional, es el proyecto del que se se desea
obtener las versiones entregas. Si se omite este parmetro, la
funcin devolver las versiones entregadas de cualquier proyecto.
Ejemplo B.45. Para filtrar aquellas incidencias cuyo atributo resuelta en versin sea una versin entregada de cualquier proyecto,
fixVersion in releasedVersions()
Ejemplo B.46. Para filtrar aquellas incidencias cuyo atributo resuelta en versin sea una versin entregada del proyecto JRAGD,
370
B.2. Funciones
fixVersion in releasedVersions(JRAGD)
B.2.14
Funcin standardIssueTypes
La funcin standardIssueTypes soporta el tipo de campo y los operadores detallados en Tabla B.35. Esta funcin devuelve el conjunto
tipo

standardIssueTypes.
de tipos de incidencias de primer nivel, eso es, tipos de incidencias

que no corresponden a sub-tareas.
Ejemplo B.47. Para filtrar aquellas incidencias que no sean subtareas, ser necesario efectuar utilizar la siguiente proposicin:
issuetype in standardIssueTypes()
B.2.15
Funcin subtaskIssueTypes
La funcin subtaskIssueTypes soporta el tipo de campo y los operadores detallados en Tabla B.36. Esta funcin devuelve el conjunto
tipo

subtaskIssueTypes.
de tipos de incidencias de segundo nivel, eso es, tipos de incidencias

que corresponden a sub-tareas.
Ejemplo B.48. Para filtrar aquellas incidencias que sean sub-tareas,
371

issuetype in subtaskIssueTypes()
B.2.16
Funcin unreleasedVersions
La funcin unreleasedVersions soporta el tipo de campo y los operadores detallados en Tabla B.37. Esta funcin devuelve el conjunto
tipo
unreleasedVersions(.)

unreleasedVersions.
de versiones por entregar en el proyecto especificado por parmetro.

Los parmetros aceptados por la funcin son los siguientes:
(i) El primer parmetro, opcional, es el proyecto del que se se desea
obtener las versiones por entregar. Si se omite este parmetro,
la funcin devolver las versiones por entregar de cualquier proyecto.
Ejemplo B.49. Para filtrar aquellas incidencias cuyo atributo resuelta en versin sea una versin no entregada de cualquier proyecto,
fixVersion in unreleasedVersions()
Ejemplo B.50. Para filtrar aquellas incidencias cuyo atributo resuelta en versin sea una versin no entregada del proyecto JRAGD,
fixVersion in unreleasedVersions(JRAGD)
372
B.2. Funciones
tipo
votedIssues()

votedIssues.
B.2.17
Funcin votedIssues
La funcin votedIssues soporta el tipo de campo y los operadores

detallados en Tabla B.38. Esta funcin devuelve las incidencias que
han sido votadas por el usuario que efecta la consulta.
autenticado, esta funcin no puede ser utilizada.
Ejemplo B.51. Para filtrar aquellas incidencias que hayan sido votadas por el usuario que efecta la consulta, ser necesario efectuar
issue in votedIssues()
B.2.18
Funcin watchedIssues
La funcin watchedIssues soporta el tipo de campo y los operadores

detallados en Tabla B.39. Esta funcin devuelve las incidencias que
tipo
watchedIssues()

watchedIssues.
estn siendo observadas por el usuario que efecta la consulta.

autenticado, esta funcin no puede ser utilizada.
373

Ejemplo B.52. Para filtrar aquellas incidencias que estn siendo observadas por el usuario que efecta la consulta, ser necesario efectuar
issue in watchedIssues()
B.3
Palabras reservadas
El lenguaje JQL tiene tambin palabras reservadas que, para poderse

utilizar en una consulta, debern ser protegidas con comillas. En
Tabla B.40 se detallar la lista completa de palabras reservadas de
este lenguaje.
374
B.3. Palabras reservadas
abort
access
add
after
alias
all
alter
and
any
as
asc
audit
avg
before
begin
between
boolean
break
by
byte
catch
cf
char
character
check
checkpoint
collate
collation
column
commit
connect
continue
count
create
current
date
decimal
declare
decrement
default
defaults
define
delete
delimiter
desc
difference
distinct
divide
do
double
drop
else
empty
encoding
end
equals
escape
exclusive
exec
execute
exists
explain
false
fetch
file
field
first
float
for
from
function
go
goto
grant
greater
group
having
identified
if
immediate
in
increment
index
initial
inner
inout
input
insert
int
integer
intersect
intersection
into
is
isempty
isnull
join
last
left
less
like
limit
lock
long
max
min
minus
mode
modify
modulo
more
multiply
next
noaudit
not
notin
nowait
null
number
object
of
on
option
or
order
outer
output
power
previous
prior
privileges
public
raise
raw
remainder
rename
resource
return
returns
revoke
right
row
rowid
rownum
rows
select
session
set
share
size
sqrt
start
strict
string
subtract
sum
synonym
table
then
to
trans
transaction
trigger
true
uid
union
unique
update
user
validate
values
view
when
whenever
where
while
with
Tabla B.40: Palabras JQL reservadas.
375
C
Changelog
C.1
1.01
(i) Se aadi el captulo Changelog (C).

(ii) Se actualiz la lista de campos por defecto de una incidencia a
los campos presentes en JIRA 5.
(iii) Se actualizaron algunos pantallazos para reflejar algunas mejoras introducidas en JIRA 5.
(iv) Se actualiz la seccin 3.3 para contemplar la nueva barra de
herramientas de administracin introducida en JIRA 5.
(v) Se actualiz la seccin 4 para reflejar las mejoras introducidas
en JIRA 5.
(vi) Se actualiz la seccin 5.11 para detallar el procedimiento de
creacin de enlaces entre incidencias en diferentes instancias de
JIRA.
(vii) Se aadi la seccin 5.19.2 para detallar el procedimiento de
creacin de enlaces entre incidencias y pginas de Confluence.
(viii) Se aadi la seccin 5.19.3 para detallar el procedimiento de
creacin de enlaces entre incidencias y recursos identificados por
URL.
(ix) Se aadi la seccin 5.19.4 para describir la integracin entre
JIRA y Crucible.
(x) Se aadi la seccin 5.19.5 para describir la integracin entre
JIRA y FishEye.
(xi) Se aadi la seccin 5.19.6 para describir la integracin entre
JIRA y Bamboo.
377
ndice alfabtico
JIRA Administrators
permiso, 308
JIRA System Administrators
permiso, 308
created:, vase Bsqueda
due:, vase Bsqueda
field, 245
jira.clone.linktype.name, 101
jira.clone.prefix, 102
my, vase Bsqueda
os_authType, 243
os_username, 243
overdue, 179
tempMax, 242, 245
today, vase Bsqueda
tomorrow, vase Bsqueda
updated:, vase Bsqueda
yesterday, vase Bsqueda
Activity stream
gadget, vase Gadget
Add comments
permiso, 88
Administer project
permiso, 13
Administration
gadget, vase Gadget
Alfresco, 184
Apache Lucene, 184
Apple Mail, 243

Apple Safari, 243
Assign issue
permiso, 139
Assigned to me
gadget, vase Gadget
Atajos de teclado, 45
formularios, 47
globales, 47
tecla modificadora, 45
ventanas de incidencias, 47
Atlassian SDK, 5
Attach screenshot, vase Capturas de pantallas
Average age
gadget, vase Gadget
Bsqueda, 147
avanzada, 148, 158, 162,
185
de texto, 171
aproximada, 174
carcter de escape, 173
caracteres especiales, 173
estructura, 172
fuzzy, 174
operador, 172
operadores, 175
palabras especiales, 173
379
ndice alfabtico
por importancia, 175
por proximidad, 174
trmino, 172
exportacin, 231
exportar a Microsoft Excel, 246
exportar a Microsoft Word,
245
exportar a XML, 244
feed RSS, 242
ordenar, 163
permalink, 162
por atributos de incidencia, 153
por campos personalizados,
157
por componentes, 151
por fechas, 154
por porcentaje de trabajo
realizado, 157
por versiones, 151
rpida, 162, 177
c:, 181
created:, 179
due:, 179
overdue, 179
r:me, 179
r:none, 179
r:, 179
today, 180
tomorrow, 180
updated:, 179
v:, 181
yesterday, 180
en un proyecto, 179
integrar en navegador, 178
navegar a incidencia, 178
por componente, 181
por estado, 180
por fecha, 179
por prioridad, 180
380
por reporter, 179

por resolucin, 180
por tipo, 180
por versin, 181
por versin de resolucin,
181
vencidas, 179
simple, 147, 148
modificar, 158
Bamboo
builds, 63, 68
Bamboo charts
gadget, vase Gadget
Bamboo plan summary chart
gadget, vase Gadget
Bamboo plans
gadget, vase Gadget
Beneficiencia, 9
Browse project
permiso, 88
Browse projects
permiso, 113
Bugzilla ID search
gadget, vase Gadget
Bulk change
permiso, 131
Bulk operation, vase Operacin masiva
Cach del navegador, 284
Calendar
gadget, vase Gadget
Campos de texto
formatear, 90
Capturas de pantallas
adjuntar, 83
Change log, vase Proyecto
Clover coverage
gadget, vase Gadget
Comentarios, 87
creacin, 87
ndice alfabtico
eliminacin, 89
modificacin, 89
visibilidad, 88
Comment issue
permiso, 139
Componentes, vase Proyecto
Configuracin de campos, 6, 90
Contrasea, vase Usuario
Control de horario, vase Registro de trabajo
Create issue
permiso, 94
Create issues
permiso, 128
Create shared object
permiso, 211, 217
Created vs. resolved
gadget, vase Gadget
Crucible charts
gadget, vase Gadget
Cuadro de mando, 106
Cuadro de mandos, 285
aadir gadget, 301
buscar, 295
copiar, 293
creacin, 290
distribucin, 299
eliminar, 294
eliminar un gadget, 305
gestin, 288
modificar, 293
mover un gadget, 304
operaciones, 299
operaciones sobre un gadget, 303
Dashboard, vase Cuadro de mandos
Delete all comments
permiso, 89
Delete all work logs
permiso, 125
Delete own comments
permiso, 89
Delete own work log
permiso, 125
Drupal, 184
Due date, vase Fecha de resolucin
Edit all comments
permiso, 89
Edit all work logs
permiso, 125
Edit issue
permiso, 139, 140
Edit issues
permiso, 115
Edit own comments
permiso, 89
Edit own work log
permiso, 125
Enlace, vase Incidencia
Esquema de nivel de seguridad
de incidencias, 114
Esquema de notificacin, 144
Esquema de pantallas
por tipo de incidencia, 120
Esquemas, 7, 28
Etiqueta
crear, 114
eliminar, 116
Favourite filter
gadget, vase Gadget
Fecha de resolucin, 106
Feed RSS
bsqueda, vase Bsqueda
Ficheros adjuntos, 82, 101
JAR
navegar, 84
381
ndice alfabtico
remover, 85
ZIP
descargar, 84
navegar, 84
Filtro, 147, 148, 162, 207, 242
buscar, 220
compartir, 217
copiar, 222
creacin, 209
exportacin, 231
favorito
aadir, 215
eliminar, 215
gestin, 213
orden de columnas, 225
eliminar, 228
modificar, 227
sumario, 212
suscripcin, 231
periodicidad, 233
Fisheye
changesets, 69
FishEye charts
gadget, vase Gadget
FishEye recent changesets
gadget, vase Gadget
Flujo de trabajo, 24, 80
transicin, 80
Gadget
Activity stream, 305, 307
feed RSS, 307
Administration, 305, 308
Assigned to me, 305, 310
Average age, 305
Average age chart, 311
Bamboo charts, 305
Bamboo plan summary chart,
305
Bamboo plans, 305
Bugzilla ID search, 305
382
Calendar, 305
Clover coverage, 305
Created vs. resolved, 305
Crucible charts, 305
Favourite filter, 305
FishEye charts, 305
FishEye recent changesets,
305
In progress, 305
Issue statistics, 305
JIRA: news, 305
Pie chart, 305
Projects, 305
Quick links, 305
Recently created issues, 305
Resolution time, 305
Road map, 305
Text, 305
Time since issues, 305
Two dimensional filter statistics, 305
Voted, 305
Watched, 305
Generic event
evento, 33
Google Chrome, 182
GreenHopper, vase JIRA
HTTP, 242, 243
HTTPS, 244
In progress
gadget, vase Gadget
Incidencia, 16
cambiar tipo de, 127
campos, 16
compartir por mail, 81
convertir en sub-tarea, 97
creacin, 73
duplicar, 100
crear enlace a, 101
ndice alfabtico
enlace, 100, 102
gestionar, 105
etiqueta, vase Etiqueta
mover a otro proyecto, 127
navegar a, 178
planificar, 106
prioridad, 21
registro histrico de cambios, 141
resolucin, 23
tipo, vase Tipo de incidencia
ventana de detalle, 78
vigilar, 143
votar, 143
Incidencias
watch, 78
Issue assigned
evento, 33
Issue closed
evento, 33
Issue comment edited
evento, 33
Issue commented
evento, 33
Issue created
evento, 33
Issue deleted
evento, 33
Issue moved
evento, 33
Issue reopened
evento, 33
Issue resolved
evento, 33
Issue statistics
gadget, vase Gadget
Issue updated
evento, 33
Issue worklog deleted
evento, 33
Issue worklog updated

evento, 33
JIRA
GreenHopper, 42
modo, 40
pblico, 40
privado, 40
JIRA Query Language, vase
JQL
JIRA: news
gadget, vase Gadget
JQL, 185
campos, 187
affectedVersion, 335
assignee, 336
category, 337
comment, 337
component, 339
created, 339
description, 337
due, 339
environment, 337
filter, 341
fixVersion, 335
issueKey, 342
level, 342
originalEstimate, 343
priority, 344
project, 344
remainingEstimate, 343
reporter, 336
resolution, 345
resolved, 339
status, 346
summary, 337
text, 337
timeSpent, 343
type, 347
updated, 339
voter, 336
383
ndice alfabtico
votes, 348
watcher, 336
workRatio, 348
tipo categora, 337
tipo componente, 339
tipo duracin, 343
tipo estado, 346
tipo fecha, 339
tipo filtro, 341
tipo incidencia, 342
tipo nmero, 348
tipo nivel de seguridad,
342
tipo prioridad, 344
tipo proyecto, 344
tipo resolucin, 345
tipo texto, 337
tipo tipo de incidencia,
347
tipo usuario, 336
tipo versin, 335
caracteres reservados, 187
funciones, 348
cascadeOption, 350
componentsLeadByUser,
352
currentLogin, 353
currentUser, 353
issueHistory, 354
lastLogin, 355
linkedIssues, 356
membersOf, 356
now, 357
projectsLeadByUser, 357
projectsWhereUserHasRole,
359
projectsWhereUserHasPermission, 358
releasedVersions, 360
standardIssueTypes, 361
subtaskIssueTypes, 361
384
unreleasedVersions, 362
votedIssues, 363
watchedIssues, 363
operadores, 191
contains, 196
does not contain, 197
equals, 192
greater than equals,
194
greater than, 193
in, 195
is not, 198
is, 198
less than equals, 195
less than, 194
not equals, 192
not in, 196
palabras claves, 188
and, 189
empty, 190
not, 190
null, 191
order by, 191
or, 189
palabras reservados, 187,
364
query
estructura, 186
Keyboard shortcuts, vase Atajos de teclado
Lenguaje de bsqueda, 107, 158
Licencia comercial, 8
Licencia de evaluacin, 8
Licencia gratuita, 8, 9
Licencias, 8
Link issues
permiso, 102
Log work
campo, 120
ndice alfabtico
Lucene, vase Apache Lucene
Manage watcher list
permiso, 145
MediaWiki, 184
Microsoft Excel, 166, 246
Microsoft Internet Explorer, 182
Microsoft Word, 166, 245
Modify reporter
permiso, 140
Move issues
permiso, 128, 131
Mozilla, 178, 182
Mozilla Firefox, 182
Mozilla Thunderbird, 243
Navegador de incidencias, 43,
147
configurar columnas, 167
descripcin, 162
Navegador de proyecto, 51
activity stream, 58
builds, 68
builds de la versin, 63
change log, 60
components, 65
estructura, 51
Fisheye changeset, 69
issues, 58
labels, 67
popular issues, 61
road map, 58
source, 69
summary, 56
versions, 61
Nivel de seguridad, 110
Nomenclatura, xxx
OpenSearch, 182
clientes, 182
OpenSocial, 5, 286
Operacin masiva, 130, 132

eliminacin, 133
migracin, 133
modificacin, 139
Organizaciones, 9
no acadmicas, 9
no comerciales, 9
no gubernamentales, 9
no polticas, 9
seculares, 9
sin nimo de lucro, 9
os_password, 243
Perfil de usuario, vase Usuario
Perfil del usuario, 45
Permalink, 90, 162
registro de trabajo, vase
Registro de trabajo
Pie chart
gadget, vase Gadget
Plugins
JIRA Charting, 257
Prioridad, vase Incidencia
Projects
gadget, vase Gadget
Proyecto, 12
change log, 16
componentes, 12, 115
explorar, vase Navegador
de proyecto
road map, 16
versiones, 14, 115
Proyectos open source, 9
Query Language, vase Lenguaje de bsqueda
Quick links
gadget, vase Gadget
385
ndice alfabtico
gadget, vase Gadget
Registro de trabajo, 117
crear, 120
crear en transicin de flujo de trabajo, 123
eliminar, 125
estimacin, 119
modificar, 125
permalink, 124
Renderers, 90
Wiki-style, 90
code macro, 92
macros, 91
sintaxis de macros, 91
Reporte
average age, 277
cach del navegador, 284
created vs. resolved issues,
267
pie chart, 273
recently created issues, 278
resolution time, 271
single level group by, 266
time since issues, 280
time tracking, 263
user workload, 260
version workload, 261
workload pie chart, 257
Reportes, 255
incluidos con JIRA, 255
plugin, 255
Resolucin, vase Incidencia
Resolution time
gadget, vase Gadget
Road map, vase Proyecto
gadget, vase Gadget
Roles de proyecto, 7
RSS, vase Feed RSS
Schedule issue
permiso, 139
386
Schedule issues
permiso, 106
Set issue security
permiso, 37, 113
SQL, 185
SELECT, 185
Sub-tareas, 93, 101
convertir en incidencia, 99
crear, 94
duplicar, 102
gestin, 95
Text
gadget, vase Gadget
Time since issues
gadget, vase Gadget
Time tracking, vase Control
de horario
Tipo de incidencia, 18
Two dimensional filter statistics
gadget, vase Gadget
Usuario
avatar, 317
modificar, 317
contrasea, 317
modificar, 318
email, 317
nombre completo, 317
perfil, 315
Version-picker
tipo de campo, 136
Versiones, vase Proyecto
View voters and watchers
permiso, 145, 337
Voted
gadget, vase Gadget
Watch, vase Incidencias
ndice alfabtico
Watched
gadget, vase Gadget
Wiki markup, 88
Wiki-style renderer, vase Renderers
WordPress, 184
Work logged on issue
evento, 33
Work started on issue
evento, 33
Work stopped on issue
evento, 33
Workflow, vase Flujo de trabajo
387
Bibliografa
[1]
The Grey Blog, http://thegreyblog.blogspot.com/
[2]
Creative Commons, Attribution-NonCommercial-NoDerivs 3.0

Unported.
http://creativecommons.org/licenses/by-nc-nd/3.0/
[3]
Creative Commons, Attribution-NonCommercial-NoDerivs 3.0

Unported.
http://creativecommons.org/licenses/by-nc-nd/3.0/legalcode
[4]
Creative Commons, Public domain.

http://wiki.creativecommons.org/Public_domain
[5]
Creative Commons, Frequently Asked Questions Do Creative

Commons licenses affect fair use, fair dealing or other exceptions
to copyright?.
http://wiki.creativecommons.org/Frequently_Asked_Questions#Do_Creative_Commons_licenses_affect_fair_use.2C_fair_dealing_or_other_exceptions_to_copyright.3F
[6]
Creative Commons, Frequently Asked Questions I dont like

the way a person has used my work in a derivative work or
included it in a collective work; what can I do?.
http://wiki.creativecommons.org/Frequently_Asked_Questions#I_don.E2.80.99t_like_the_way_a_person_has_used_my_work_in_a_derivative_work_or_included_it_in_a_collective_work.3B_what_can_I_do.3F
[7]
Creative Commons, Frequently Asked Questions When are

publicity rights relevant?.
http://wiki.creativecommons.org/Frequently_Asked_Questions#When_are_publicity_rights_relevant.3F
389
Bibliografa
[8]
Atlassian, Atlassian JIRA Pricing.

http://www.atlassian.com/software/jira/pricing.jsp
[9]
Atlassian, Atlassian Experts.

http://www.atlassian.com/resources/experts
[10] Atlassian, Atlassian JIRA Documentation.

http://confluence.atlassian.com/display/JIRA/JIRA+Documentation
[11] Atlassian, Atlassian JIRA Users Guide.

http://confluence.atlassian.com/display/JIRA/JIRA+User%27s+Guide
[12] Atlassian, Atlassian Partner Directory.

http://confluence.atlassian.com/display/APW/Navigation
[13] Atlassian, End of support announcements for JIRA.

http://confluence.atlassian.com/display/JIRA/End+of+Support+Announcements+for+JIRA
[14] Sunfreeware, Freeware and Open Source Software (FOSS) for

Sun Microsystems Solaris.
http://www.sunfreeware.com/
[15] Blastwave, Blastwave.org An OpenSolaris Community Site.

http://www.blastwave.org/
[16] OpenCSW, OpenCSW.

http://www.opencsw.org/
[17] Atlassian JIRA, JIRA does not install well on Vista/Win7 with
UAC and the installer.
http://jira.atlassian.com/browse/JRA-19683
[18] VeriSign, Official VeriSign Home Page.

http://www.verisign.com/
[19] Thawte, Official Thawte Home Page.

http://www.thawte.com/
[20] Apache HTTP Server, SSL/TLS Strong Encryption: FAQ.

http://httpd.apache.org/docs/2.0/ssl/ssl_faq.html#vhosts
[21] Apache-SSL, Apache-SSL.

http://www.apache-ssl.org/
390
Bibliografa
[22] Apache, Apache ISAPI Redir DLL.
http://www.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/
[23] Atlassian JIRA Installation Guide, Integrating JIRA with IIS.

http://confluence.atlassian.com/display/JIRA/Integrating+JIRA+with+IIS
[24] The Grey Blog, Setting Up Solaris 10 Projects to Control

Resource Usage.
http://thegreyblog.blogspot.com/2009/01/setting-up-solaris-10-projects-to.html
[25] The Grey Blog, Credentials and Projects for a Solaris 10

SMF-Managed Service.
http://thegreyblog.blogspot.com/2010/06/credentials-and-projects-for-solaris-10.html
[26] OpenSearch.org, OpenSearch.org Home Page.

http://www.opensearch.org/
[27] OpenSearch.org, OpenSearch search clients.

http://www.opensearch.org/Community/OpenSearch_enabled_search_clients
[28] Atlassian Plugin Exchange, Atlassian Plugin Exchange.

https://plugins.atlassian.com/
[29] Atlassian Documentation, JIRA Extensions.

http://confluence.atlassian.com/display/JIRAEXT/JIRA+Extensions
[30] Atlassian Documentation, Atlassian Developer Network.

http://confluence.atlassian.com/display/DEVNET
[31] JIRA Charting Plugin, JIRA Charting Plugin.

https://studio.plugins.atlassian.com/wiki/display/JCHART/JIRA+Charting+Plugin
[32] Scrum, Wikipedia, the free encyclopedia,

http://es.wikipedia.org/wiki/Scrum
391

Jira User Guide 1.01

Cargado por

Copyright:

Formatos disponibles

También podría gustarte

Jira User Guide 1.01

Cargado por

Información del documento

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Jira User Guide 1.01

Cargado por

Copyright:

Formatos disponibles

Enrico M.

Atlassian JIRA, The Definitive Guide, Volumen i.

Este libro est protegido por la licencia Creative Commons AttributionNon

Prefacio a la gua del usuario

8 Grabar una bsqueda en un filtro

Buscar un filtro . . . . . . . . . . . . . . . . . . . . . . 230

12 Personalizar el cuadro de mandos

13 Gestionar el perfil del usuario

A Documento XML de bsqueda

B Campos y funciones JQL

Ventana de login de JIRA . . . . . . . . . . . . . . . . . .

Botn de creacin de incidencia . . . . . . . . . . . . . . . 74

proyecto Ventana Popular issues. . . . .

Paneles de bsqueda del navegador de incidencias 1 . .

Ventana de bsqueda avanzada. . . . . . . . . . . . . . . . 196

Resultados de bsqueda de filtros. . . . . . . . . . . . . .

Suscripcin a filtro. . . . . . . . . . . . . . . . . . . . . . . 242

11.1 Cuadro de mandos vaco. . . . . . . . . . . . . . . . . . . 297

Ventana de cuadro de mandos Operaciones . . . . . . . 310

Barra de herramientas Perfil de Usuario . . . . . .

Campos estndar de una incidencia . . . . . . . . . . . . .

Tecla modificadora por navegador y sistema operativo

Navegador de proyecto Informacin relativa al proyecto.

Nombre de ficheros adjuntos Caracteres no permitidos

Acciones en el men Actions en el navegador de incidencias.175

Caracteres JQL reservados. . . . . . . . . . . . . . . . . . 197

Tipos de campos JQL. . . . . . . . . . . . . . . . . . . . .

10.1 Reportes integrados en JIRA. . . . . . . . . . . . . . . . . 267

Tipos de campos JQL. . . . . . . . . . . . . . . . . . . . . 343

A quin est dirigido cada volumen

Prefacio a la gua del usuario

Prefacio a la gua del usuario

Prefacio a la gua del usuario

Gua del usuario

JIRA proporciona mltiples maneras para interactuar con ella, cada

1.2. Los cuadros de mandos

Los cuadros de mandos

Otra herramienta muy flexible que JIRA proporciona a sus usuarios

JIRA es una herramienta moderna que proporciona al usuario una

1.6. Facilidad de gestin

Elegir una licencia

Comenzar a utilizar JIRA es fcil: Atlassian proporciona licencias de

Despus de haber probado libremente a JIRA con una licencia de

1.7. Elegir una licencia

Tabla 1.1: Licencias comerciales

Pequeos proyectos con menos de 10 usuarios pueden solicitar la

sin nimo de lucro;

Contactar con un Experto

Existe una red de expertos oficiales de Atlassian (Experts) a nivel

En lo que concierne los usuarios de JIRA, un proyecto es el contenedor

Figura 2.1: Componentes de un proyecto

Una versin puede estar en uno de los siguiente estados:

Figura 2.2: Versiones de un proyecto

Las versiones pueden utilizarse para generar change logs y road

Figura 2.3: Road map de un proyecto

Las incidencias son los objetos de negocio que se manejan en JIRA.

Figura 2.4: Ventana de detalle de incidencia

Las incidencias, por defecto, llevan una serie de campos detallados en

Aplicacin: la aplicacin que manifiesta el riesgo.