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 Denitive Guide, Volumen i.
Versin ..
Este libro est protegido por la licencia Creative Commons AttributionNon
commercialNoDerivs . Unported (CC BYNCND .) cuyo trminos pue-
den 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 especicadas
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 nes 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, Conuence, FishEye, Crucible, Bamboo y Crowd son marcas
registradas de Atlassian.
Atlassian JIRA
The Definitive Guide
ndice general
ndice general v
ndice de guras xv
ndice de tablas xxiii
Prefacio xxvii
Relacin con la documentacin ocial de JIRA . . . . . . . xxvii
A quin est dirigido cada volumen . . . . . . . . . . . . . . xxviii
Nomenclatura . . . . . . . . . . . . . . . . . . . . . . . . . . xxx
Convenios tipogrcos . . . . . . . . . . . . . . . . . . . . . xxx
El formato de este libro . . . . . . . . . . . . . . . . . . . . xxxi
Sugerencias . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxi
Prefacio a la gua del usuario xxxiii
1 Introduccin 3
1.1 Interfaz grca . . . . . . . . . . . . . . . . . . . . . . 3
1.2 Los cuadros de mandos . . . . . . . . . . . . . . . . . 5
1.3 JIRA es OpenSocial . . . . . . . . . . . . . . . . . . . 5
1.4 Flexibilidad . . . . . . . . . . . . . . . . . . . . . . . . 6
1.5 Seguridad . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.6 Facilidad de gestin . . . . . . . . . . . . . . . . . . . 7
1.7 Elegir una licencia . . . . . . . . . . . . . . . . . . . . 8
1.7.1 Licencias comerciales . . . . . . . . . . . . . . . 8
1.7.2 Licencia gratuita . . . . . . . . . . . . . . . . . 9
1.7.3 Contactar con un Experto . . . . . . . . . . . . 9
ndice general
2 Conceptos bsicos 11
2.1 Proyectos . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.1.1 Componentes . . . . . . . . . . . . . . . . . . . 12
2.1.2 Versiones . . . . . . . . . . . . . . . . . . . . . 14
2.2 Incidencias . . . . . . . . . . . . . . . . . . . . . . . . 16
2.2.1 Tipo de incidencia . . . . . . . . . . . . . . . . 18
2.2.2 Campos . . . . . . . . . . . . . . . . . . . . . . 19
2.2.3 Prioridad . . . . . . . . . . . . . . . . . . . . . 21
2.2.4 Estado . . . . . . . . . . . . . . . . . . . . . . . 22
2.2.5 Resolucin . . . . . . . . . . . . . . . . . . . . 23
2.3 Flujos de trabajo . . . . . . . . . . . . . . . . . . . . . 24
2.4 Organizacin de los conceptos . . . . . . . . . . . . . . 26
2.5 Esquemas . . . . . . . . . . . . . . . . . . . . . . . . . 28
2.5.1 Desacoplamiento de proyectos y reutilizacin de
esquemas . . . . . . . . . . . . . . . . . . . . . 30
2.5.2 Tipos de incidencias disponibles . . . . . . . . 30
2.5.3 Conguracin de campos . . . . . . . . . . . . 30
2.5.4 Conguracin de pantallas . . . . . . . . . . . . 31
2.5.5 Flujos de trabajos disponibles . . . . . . . . . . 32
2.5.6 Noticaciones . . . . . . . . . . . . . . . . . . . 32
2.5.7 Polticas de seguridad . . . . . . . . . . . . . . 35
2.5.8 Niveles de seguridad de las incidencias . . . . . 36
3 Primeros pasos 39
3.1 Login: acceder a JIRA . . . . . . . . . . . . . . . . . . 39
3.2 Cuadro de mando . . . . . . . . . . . . . . . . . . . . . 40
3.3 Barra de las herramientas . . . . . . . . . . . . . . . . 41
3.3.1 Men Dashboards . . . . . . . . . . . . . . . . 42
3.3.2 Men Projects . . . . . . . . . . . . . . . . . . 43
3.3.3 Men Issues . . . . . . . . . . . . . . . . . . . . 43
3.3.4 Menu Administration . . . . . . . . . . . . . . 44
3.3.5 Menu del usuario . . . . . . . . . . . . . . . . . 45
3.4 Atajos de teclado . . . . . . . . . . . . . . . . . . . . . 45
3.4.1 Tecla modicadora . . . . . . . . . . . . . . . . 45
3.4.2 Atajos globales . . . . . . . . . . . . . . . . . . 47
3.4.3 Atajos de las ventanas de incidencias . . . . . . 47
3.4.4 Atajos en los formularios . . . . . . . . . . . . 47
4 Explorar un proyecto 51
4.1 Estructura . . . . . . . . . . . . . . . . . . . . . . . . . 51
4.1.1 Acceso rpido a la creacin de incidencias . . . 53
i
ndice general
4.1.2 Acceso a informacin adicional . . . . . . . . . 55
4.2 Summary . . . . . . . . . . . . . . . . . . . . . . . . . 56
4.2.1 Activity Stream . . . . . . . . . . . . . . . . . . 58
4.3 Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
4.4 Road Map . . . . . . . . . . . . . . . . . . . . . . . . . 58
4.5 Change Log . . . . . . . . . . . . . . . . . . . . . . . . 60
4.6 Popular Issues . . . . . . . . . . . . . . . . . . . . . . 61
4.7 Versions . . . . . . . . . . . . . . . . . . . . . . . . . . 61
4.7.1 Builds de la versin . . . . . . . . . . . . . . . 63
4.8 Components . . . . . . . . . . . . . . . . . . . . . . . . 65
4.9 Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
4.10 Builds de Bamboo . . . . . . . . . . . . . . . . . . . . 68
4.11 Fisheye changesets: cambios en las fuentes . . . . . . . 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 cheros o capturas de pantallas a una incidencia 82
5.6 Gestionar los cheros adjuntos . . . . . . . . . . . . . 85
5.6.1 Ordenar los cheros adjuntos . . . . . . . . . . 86
5.6.2 Acceder al contenido de adjuntos de tipo ZIP . 86
5.6.3 Eliminar cheros 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 Modicar 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
ii
ndice general
5.9.4 Convertir una sub-tarea en incidencia . . . . . 101
5.10 Duplicar una incidencia . . . . . . . . . . . . . . . . . 102
5.10.1 Crear un enlace a una incidencia duplicada . . 103
5.10.2 Prejo del ttulo de las incidencias duplicadas . 104
5.10.3 Duplicacin de incidencias y sub-tareas . . . . 104
5.11 Enlaces entre incidencias . . . . . . . . . . . . . . . . . 104
5.11.1 Gestionar los enlaces entre incidencias . . . . . 108
5.12 Planicar las incidencias . . . . . . . . . . . . . . . . . 109
5.12.1 Filtrar incidencias utilizando la fecha de reso-
lucin . . . . . . . . . . . . . . . . . . . . . . . 109
5.13 Proteger una incidencia . . . . . . . . . . . . . . . . . 113
5.13.1 Caso de uso: segmentacin de usuarios . . . . . 113
5.13.2 Caso de uso: proteger informacin condencial 115
5.13.3 Proteger una incidencia . . . . . . . . . . . . . 115
5.14 Poner etiquetas a una incidencias . . . . . . . . . . . . 117
5.14.1 Eliminar una etiqueta . . . . . . . . . . . . . . 119
5.15 Trabajar sobre una incidencia . . . . . . . . . . . . . . 120
5.15.1 Hacer una estimacin del trabajo requerido . . 122
5.15.2 Registrar trabajo sobre una incidencia . . . . . 123
5.15.3 Registrar trabajo durante una transicin de es-
tado en el ujo de trabajo . . . . . . . . . . . . 125
5.15.4 Crear un enlace a un registro de trabajo . . . . 127
5.15.5 Modicar un registro de trabajo . . . . . . . . 127
5.15.6 Eliminar un registro de trabajo . . . . . . . . . 128
5.16 Mover una incidencia . . . . . . . . . . . . . . . . . . . 129
5.17 Modicar mltiples incidencias a la vez . . . . . . . . 132
5.17.1 Inhabilitar las noticaciones durante una ope-
racin masiva . . . . . . . . . . . . . . . . . . . 134
5.17.2 Efectuar una operacin masiva . . . . . . . . . 134
5.17.3 Operacin masiva de eliminacin . . . . . . . . 136
5.17.4 Operacin masiva de migracin . . . . . . . . . 137
5.17.5 Operacin masiva de modicacin . . . . . . . 140
5.18 Registro histrico de cambios de una incidencia . . . . 144
5.19 Integracin de JIRA con otras aplicaciones . . . . . . 147
5.19.1 Crear enlaces a incidencias en otras instancias
de JIRA . . . . . . . . . . . . . . . . . . . . . . 147
5.19.2 Enlaces a pginas de Conuence . . . . . . . . 149
5.19.3 Enlaces a pginas web . . . . . . . . . . . . . . 150
5.19.4 Revisiones de Crucible . . . . . . . . . . . . . . 150
5.19.5 Changesets de FishEye . . . . . . . . . . . . . . 151
5.19.6 Builds de Bamboo . . . . . . . . . . . . . . . . 153
iii
ndice general
5.20 Observar y votar una incidencia . . . . . . . . . . . . . 153
6 Buscar y ltrar incidencias 157
6.1 Bsquedas simples . . . . . . . . . . . . . . . . . . . . 158
6.1.1 Panel principal de bsqueda . . . . . . . . . . . 159
6.1.2 Panel de bsqueda por componentes y versiones 161
6.1.3 Panel de bsqueda por atributos de incidencia 163
6.1.4 Panel de bsqueda por fechas . . . . . . . . . . 164
6.1.5 Panel de bsqueda por porcentaje de trabajo
realizado . . . . . . . . . . . . . . . . . . . . . 167
6.1.6 Panel de bsqueda por campos personalizados 167
6.1.7 Modicar manualmente una query simple . . . 168
6.2 El navegador de incidencias . . . . . . . . . . . . . . . 172
6.2.1 Crear un enlace permanente a una bsqueda . 172
6.2.2 Herramientas en el navegador de incidencias . . 173
6.2.3 Ordenar los resultados . . . . . . . . . . . . . . 173
6.2.4 Visualizar las incidencia . . . . . . . . . . . . . 177
6.3 Congurar el navegador de incidencias . . . . . . . . . 177
6.3.1 Congurar las columnas visualizadas . . . . . . 178
6.3.2 Congurar el nmero de lneas visualizadas . . 180
6.4 Bsquedas de texto . . . . . . . . . . . . . . . . . . . . 181
6.4.1 Estructuras de las consultas . . . . . . . . . . . 182
6.4.2 Bsquedas aproximadas . . . . . . . . . . . . . 184
6.4.3 Bsquedas fuzzy . . . . . . . . . . . . . . . . . 184
6.4.4 Bsquedas por proximidad . . . . . . . . . . . 184
6.4.5 Bsqueda por importancia . . . . . . . . . . . . 185
6.4.6 Operadores . . . . . . . . . . . . . . . . . . . . 185
6.5 Bsquedas rpidas . . . . . . . . . . . . . . . . . . . . 187
6.5.1 Navegar a una incidencia . . . . . . . . . . . . 188
6.5.2 Incidencias asignadas a uno mismo . . . . . . . 188
6.5.3 Incidencias por reporter . . . . . . . . . . . . . 189
6.5.4 Incidencias en un proyecto . . . . . . . . . . . . 189
6.5.5 Incidencias atrasadas . . . . . . . . . . . . . . . 189
6.5.6 Incidencias por fecha . . . . . . . . . . . . . . . 189
6.5.7 Incidencias por estado . . . . . . . . . . . . . . 190
6.5.8 Incidencias por resolucin . . . . . . . . . . . . 190
6.5.9 Incidencias por prioridad . . . . . . . . . . . . 190
6.5.10 Incidencias por tipo . . . . . . . . . . . . . . . 190
6.5.11 Incidencias por versin . . . . . . . . . . . . . . 191
6.5.12 Incidencias por versin de resolucin . . . . . . 191
6.5.13 Incidencias por componente . . . . . . . . . . . 191
ir
ndice general
6.5.14 Integracin con navegadores . . . . . . . . . . . 191
7 Bsquedas avanzadas 195
7.1 Estructura de una query JQL . . . . . . . . . . . . . . 196
7.2 Caracteres reservados . . . . . . . . . . . . . . . . . . 197
7.3 Palabras reservadas . . . . . . . . . . . . . . . . . . . . 197
7.4 Campos . . . . . . . . . . . . . . . . . . . . . . . . . . 197
7.5 Palabras claves . . . . . . . . . . . . . . . . . . . . . . 198
7.5.1 Palabra clave and . . . . . . . . . . . . . . . . . 199
7.5.2 Palabra clave or . . . . . . . . . . . . . . . . . 199
7.5.3 Palabra clave not . . . . . . . . . . . . . . . . . 200
7.5.4 Palabra clave empty . . . . . . . . . . . . . . . 200
7.5.5 Palabra clave null . . . . . . . . . . . . . . . . 201
7.5.6 Palabra clave order by . . . . . . . . . . . . . 201
7.6 Operadores . . . . . . . . . . . . . . . . . . . . . . . . 201
7.6.1 Operador equals . . . . . . . . . . . . . . . . . 202
7.6.2 Operador not equals . . . . . . . . . . . . . . 202
7.6.3 Operador greater than . . . . . . . . . . . . . 203
7.6.4 Operador greater than equals . . . . . . . . 204
7.6.5 Operador less than . . . . . . . . . . . . . . . 204
7.6.6 Operador less than equals . . . . . . . . . . 205
7.6.7 Operador in . . . . . . . . . . . . . . . . . . . 205
7.6.8 Operador not in . . . . . . . . . . . . . . . . . 206
7.6.9 Operador contains . . . . . . . . . . . . . . . 206
7.6.10 Operador does not contain . . . . . . . . . . 207
7.6.11 Operador is . . . . . . . . . . . . . . . . . . . 208
7.6.12 Operador is not . . . . . . . . . . . . . . . . . 208
7.7 rden de evaluacin . . . . . . . . . . . . . . . . . . . 208
7.8 Auto-nalizacin de las consultas . . . . . . . . . . . . 209
7.9 Modicar una bsqueda avanzada con la interfaz de
bsqueda simple . . . . . . . . . . . . . . . . . . . . . 214
8 Grabar una bsqueda en un ltro 217
8.1 Organizacin de los ltros . . . . . . . . . . . . . . . . 218
8.2 Creacin de un ltro . . . . . . . . . . . . . . . . . . . 219
8.3 Sumario de un ltro . . . . . . . . . . . . . . . . . . . 222
8.4 Gestin de ltros . . . . . . . . . . . . . . . . . . . . . 223
8.5 Eliminar un ltro de la lista de favoritos . . . . . . . . 225
8.6 Aadir un ltro a la lista de favoritos . . . . . . . . . 225
8.7 Modicacin de los atributos de un ltro . . . . . . . . 226
8.8 Compartir un ltro con otros usuarios . . . . . . . . . 227
r
ndice general
8.9 Buscar un ltro . . . . . . . . . . . . . . . . . . . . . . 230
8.10 Copiar un ltro existente . . . . . . . . . . . . . . . . 232
8.11 Modicacin de un ltro . . . . . . . . . . . . . . . . . 233
8.12 Congurar el orden de columnas de un ltro . . . . . . 235
8.12.1 Modicar la conguracin de columnas de un
ltro . . . . . . . . . . . . . . . . . . . . . . . . 237
8.12.2 Eliminar la conguracin de columnas de un ltro238
8.13 Utilizar la conguracin de columnas por defecto . . . 239
8.14 Conguracin de columnas y exportacin de datos . . 240
9 Explotar los resultados de bsqueda 241
9.1 Suscribirse a un ltro . . . . . . . . . . . . . . . . . . . 241
9.1.1 Periodicidad . . . . . . . . . . . . . . . . . . . 243
9.1.2 Cualquier valor . . . . . . . . . . . . . . . . . . 248
9.1.3 Listas de valores . . . . . . . . . . . . . . . . . 248
9.1.4 Intervalo de valores . . . . . . . . . . . . . . . . 249
9.1.5 Incremento de un valor . . . . . . . . . . . . . 250
9.1.6 ltimo valor . . . . . . . . . . . . . . . . . . . 250
9.1.7 Ocurrencias . . . . . . . . . . . . . . . . . . . . 251
9.2 Recibir resultados de bsqueda en un feed RSS . . . . 252
9.2.1 Autenticar el usuario de un feed RSS . . . . . . 253
9.3 Recibir resultados de bsqueda en XML . . . . . . . . 254
9.3.1 Seleccin de campos devueltos en el documento 255
9.4 Exportar resultados de bsqueda a Microsoft Word . . 255
9.5 Exportar resultados de bsqueda a Microsoft Excel . . 256
9.6 Visualizar los resultados en un grco . . . . . . . . . 257
9.6.1 Visualizar los resultados de bsqueda en el cua-
dro de mandos . . . . . . . . . . . . . . . . . . 258
10 Generar reportes 265
10.1 Workload pie chart . . . . . . . . . . . . . . . . . . . . 267
10.2 User workload . . . . . . . . . . . . . . . . . . . . . . . 270
10.3 Version workload . . . . . . . . . . . . . . . . . . . . . 271
10.4 Time tracking . . . . . . . . . . . . . . . . . . . . . . . 273
10.5 Single level group by . . . . . . . . . . . . . . . . . . . 276
10.6 Created vs. resolved issues . . . . . . . . . . . . . . . . 277
10.7 Resolution time . . . . . . . . . . . . . . . . . . . . . . 281
10.8 Pie chart . . . . . . . . . . . . . . . . . . . . . . . . . 283
10.9 Average age . . . . . . . . . . . . . . . . . . . . . . . . 287
10.10Recently created issues . . . . . . . . . . . . . . . . . . 288
10.11Time Since Issues Report . . . . . . . . . . . . . . . . 290
ri
ndice general
10.12Cach de los navegadores . . . . . . . . . . . . . . . . 294
11 Gestionar los cuadros de mandos 295
11.1 Contenedores de gadgets OpenSocial . . . . . . . . . . 296
11.2 Gestin de los cuadros de mandos . . . . . . . . . . . . 298
11.2.1 Gestin de cuadros de mandos favoritos . . . . 299
11.2.2 Ordenar los cuadros de mandos favoritos . . . . 300
11.2.3 Creacin de un cuadro de mandos . . . . . . . 300
11.2.4 Copiar un cuadro de mandos . . . . . . . . . . 303
11.2.5 Modicar un cuadro de mandos . . . . . . . . . 303
11.2.6 Eliminar un cuadro de mandos . . . . . . . . . 304
11.3 Bsqueda de cuadro de mandos . . . . . . . . . . . . . 305
12 Personalizar el cuadro de mandos 309
12.1 Operaciones sobre un cuadro de mandos . . . . . . . . 309
12.2 Seleccin de la distribucin de un cuadro de mandos . 309
12.3 Aadir gadgets al cuadro de mandos . . . . . . . . . . 311
12.4 Operaciones sobre un gadget en un cuadro de mandos 313
12.5 Mover un gadget en un cuadro de mandos . . . . . . . 314
12.6 Eliminar un gadget de un cuadro de mandos . . . . . . 315
12.7 Gadgets disponibles . . . . . . . . . . . . . . . . . . . 315
12.8 Activity stream gadget . . . . . . . . . . . . . . . . . . 317
12.9 Administration gadget . . . . . . . . . . . . . . . . . . 318
12.10Assigned to me gadget . . . . . . . . . . . . . . . . . . 320
12.11Average age chart gadget . . . . . . . . . . . . . . . . 321
13 Gestionar el perl del usuario 325
13.1 Modicar los detalles del usuario . . . . . . . . . . . . 327
13.1.1 Modicar el avatar del usuario . . . . . . . . . 327
13.1.2 Modicar la contrasea . . . . . . . . . . . . . 328
13.2 Modicar las preferencias del usuario . . . . . . . . . . 330
13.2.1 Cambiar las columnas del navegador de inci-
dencias . . . . . . . . . . . . . . . . . . . . . . 330
A Documento XML de bsqueda 335
B Campos y funciones JQL 341
B.1 Campos . . . . . . . . . . . . . . . . . . . . . . . . . . 341
B.1.1 Nombres o identicadores? . . . . . . . . . . . 341
B.1.2 Tipos de campos JQL . . . . . . . . . . . . . . 342
B.1.3 Operadores soportados por los campos . . . . . 343
rii
ndice general
B.1.4 Campos de tipo versin . . . . . . . . . . . . . 345
B.1.5 Campos de tipo usuario . . . . . . . . . . . . . 346
B.1.6 Campos de tipo categora . . . . . . . . . . . . 347
B.1.7 Campos de tipo texto . . . . . . . . . . . . . . 347
B.1.8 Campos de tipo componente . . . . . . . . . . 349
B.1.9 Campos de tipo fecha . . . . . . . . . . . . . . 349
B.1.10 Campos de tipo ltro . . . . . . . . . . . . . . 351
B.1.11 Campos de tipo incidencia . . . . . . . . . . . . 352
B.1.12 Campos de tipo nivel de seguridad . . . . . . . 352
B.1.13 Campos de tipo duracin . . . . . . . . . . . . 353
B.1.14 Campos de tipo prioridad . . . . . . . . . . . . 354
B.1.15 Campos de tipo proyecto . . . . . . . . . . . . 354
B.1.16 Campos de tipo resolucin . . . . . . . . . . . . 355
B.1.17 Campos de tipo estado . . . . . . . . . . . . . . 356
B.1.18 Campos de tipo tipo de incidencia . . . . . . . 357
B.1.19 Campos de tipo nmero . . . . . . . . . . . . . 358
B.2 Funciones . . . . . . . . . . . . . . . . . . . . . . . . . 358
B.2.1 Funcin cascadeOption . . . . . . . . . . . . . 360
B.2.2 Funcin componentsLeadByUser . . . . . . . . 362
B.2.3 Funcin currentLogin . . . . . . . . . . . . . . 363
B.2.4 Funcin currentUser . . . . . . . . . . . . . . 363
B.2.5 Funcin issueHistory . . . . . . . . . . . . . . 364
B.2.6 Funcin lastLogin . . . . . . . . . . . . . . . . 365
B.2.7 Funcin linkedIssues . . . . . . . . . . . . . . 366
B.2.8 Funcin membersOf . . . . . . . . . . . . . . . . 366
B.2.9 Funcin now . . . . . . . . . . . . . . . . . . . . 367
B.2.10 Funcin projectsLeadByUser . . . . . . . . . 367
B.2.11 Funcin projectsWhereUserHasPermission . 368
B.2.12 Funcin projectsWhereUserHasRole . . . . . 369
B.2.13 Funcin releasedVersions . . . . . . . . . . . 370
B.2.14 Funcin standardIssueTypes . . . . . . . . . 371
B.2.15 Funcin subtaskIssueTypes . . . . . . . . . . 371
B.2.16 Funcin unreleasedVersions . . . . . . . . . 372
B.2.17 Funcin votedIssues . . . . . . . . . . . . . . 373
B.2.18 Funcin watchedIssues . . . . . . . . . . . . . 373
B.3 Palabras reservadas . . . . . . . . . . . . . . . . . . . . 374
C Changelog 377
C.1 1.01 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
ndice alfabtico 379
riii
ndice general
Bibliografa 389
ri
ndice de guras
2.1 Componentes de un proyecto . . . . . . . . . . . . . . . . 13
2.2 Versiones de un proyecto . . . . . . . . . . . . . . . . . . . 16
2.3 Road map de un proyecto . . . . . . . . . . . . . . . . . . 16
2.4 Ventana de detalle de incidencia . . . . . . . . . . . . . . 17
2.5 Relacin entre estado de una incidencia y ujo de trabajo 23
2.6 Flujo de trabajo por defecto de JIRA . . . . . . . . . . . 25
2.7 Organizacin de los conceptos en JIRA . . . . . . . . . . 28
3.1 Ventana de login de JIRA . . . . . . . . . . . . . . . . . . 40
3.2 Ventana de signup de JIRA . . . . . . . . . . . . . . . . . 41
3.3 Seccin de menus de la barra de herramientas de JIRA . . 42
3.4 Seccin de herramientas de la barra de herramientas de
JIRA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
3.5 Barra de herramientas de JIRA Administracin Par-
te izquierda . . . . . . . . . . . . . . . . . . . . . . . . . . 44
3.6 Barra de herramientas de JIRA Administracin Par-
te derecha . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
3.7 Ventana de ayuda de los atajos de teclado . . . . . . . . . 46
4.1 Navegador de proyecto. . . . . . . . . . . . . . . . . . . . 52
4.2 Navegador de proyecto. . . . . . . . . . . . . . . . . . . . 53
4.3 Navegador de proyecto Barra de creacin de incidencias. 55
4.4 Navegador de proyecto Ventana Summary. . . . . . . . 57
4.5 Navegador de proyecto Barra de herramientas de la
ventana Summary. . . . . . . . . . . . . . . . . . . . . . . 57
4.6 Navegador de proyecto Ventana Issues. . . . . . . . . . 59
4.7 Navegador de proyecto Ventana Road map. . . . . . . . 60
4.8 Navegador de proyecto Ventana Changelog. . . . . . . . 61
r
ndice de figuras
4.9 Navegador de proyecto Ventana Popular issues. . . . . 62
4.10 Navegador de proyecto Ventana Versions. . . . . . . . 62
4.11 Navegador de proyecto Detalle de versin. . . . . . . . 64
4.12 Navegador de proyecto Detalle de versin Builds . . 65
4.13 Navegador de proyecto Detalle de versin Build Plans 66
4.14 Navegador de proyecto Ventana Components. . . . . . 66
4.15 Navegador de proyecto Ventana Labels. . . . . . . . . . 68
4.16 Navegador de proyecto Ventana Source. . . . . . . . . . 69
4.17 Navegador de proyecto Ventana Source. . . . . . . . . . 70
5.1 Botn de creacin de incidencia . . . . . . . . . . . . . . . 74
5.2 Navegador de proyecto Barra de creacin de incidencias. 74
5.3 Ventana de creacin de incidencia . . . . . . . . . . . . . . 75
5.4 Ventana de creacin de incidencia Conguracin de
campos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
5.5 Citacin de otro usuario . . . . . . . . . . . . . . . . . . . 78
5.6 Ventana de detalle de incidencia . . . . . . . . . . . . . . 79
5.7 Men de acciones . . . . . . . . . . . . . . . . . . . . . . . 80
5.8 Compartir una incidencia. . . . . . . . . . . . . . . . . . . 82
5.9 Ventana para adjuntar cheros a una incidencia . . . . . . 83
5.10 Vista previa de los cheros adjuntos a una incidencia . . . 85
5.11 Vista de galera de los cheros adjuntos a una incidencia . 85
5.12 Menu de operaciones sobre cheros adjuntos a una incidencia 86
5.13 Vista previa de un chero adjunto de tipo ZIP o JAR . . 87
5.14 Ventana de gestin de cheros adjuntos . . . . . . . . . . 87
5.15 Ventana de conrmacin para ejecutar un applet Java . . 88
5.16 Ventana para adjuntar capturas de pantalla . . . . . . . . 89
5.17 Formulario de creacin de un comentario . . . . . . . . . . 90
5.18 Comentarios colapsados y expandidos . . . . . . . . . . . 91
5.19 Iconos para operar sobre un comentario . . . . . . . . . . 91
5.22 Fragmento de cdigo formateado con la macro code . . . 95
5.23 Fragmento de XML formateado con la macro code . . . . 95
5.24 Ventana de creacin de sub-tarea . . . . . . . . . . . . . . 96
5.25 Ventana de detalle de sub-tarea . . . . . . . . . . . . . . . 97
5.26 Lista de sub-tareas de una incidencia . . . . . . . . . . . . 97
5.27 Operaciones de una sub-tarea . . . . . . . . . . . . . . . . 98
5.28 Menu de operaciones de una sub-tarea . . . . . . . . . . . 99
5.29 Formulario de creacin de sub-tarea en el panel Sub-tasks 99
5.30 Formulario de conversin de incidencia a sub-tarea . . . . 100
ri
ndice de guras
5.31 Formulario de conversin de campos para la conversin a
sub-tarea . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
5.32 Formulario de conrmacin 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 ltro . . . . . . 107
5.37 Detalle de un enlace entre incidencias . . . . . . . . . . . 108
5.38 Ventana de gestin de enlaces entre incidencias . . . . . . 108
5.39 Seccin de ltrado por fecha de resolucin en el navegador
de incidencias . . . . . . . . . . . . . . . . . . . . . . . . . 110
5.40 Ejemplo de ltrado 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 in-
cidencia . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
5.43 Modicar 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 reso-
lucin de incidencia . . . . . . . . . . . . . . . . . . . . . 126
5.54 Registro de trabajo modicado . . . . . . . . . . . . . . . 128
5.55 Ventana de eliminacin de registro de trabajo . . . . . . . 129
5.56 Asistente de migracin de incidencias Paso 1 . . . . . . 131
5.57 Asistente de migracin de incidencias Paso : . . . . . . 131
5.58 Asistente de migracin de incidencias Paso . . . . . . 132
5.60 Inhabilitar las noticaciones 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
rii
ndice de figuras
5.63 Seleccin del tipo de operacin masiva . . . . . . . . . . . 136
5.64 Conrmacin de una eliminacin masiva . . . . . . . . . . 136
5.65 Aviso de exclusin de sub-tareas durante una migracin
masiva . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
5.66 Seleccin de proyecto y tipo de incidencia de destino en
una migracin masiva . . . . . . . . . . . . . . . . . . . . 138
5.67 Seleccin de tipo de sub-tarea de destino en una migracin
masiva . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
5.68 Actualizacin de campos de una incidencia en una migra-
cin masiva . . . . . . . . . . . . . . . . . . . . . . . . . . 139
5.69 Ventana de conrmacin de una migracin masiva . . . . 141
5.70 Ventana de modicacin de campos en una operacin de
modicacin masiva . . . . . . . . . . . . . . . . . . . . . 145
5.71 Ventana de modicacin de campos en una operacin de
modicacin masiva . . . . . . . . . . . . . . . . . . . . . 146
5.73 Incidencia Revisin de Crucible . . . . . . . . . . . . . 151
5.74 Incidencia Changesets de FishEye . . . . . . . . . . . . 152
5.75 Incidencia Builds de Bamboo . . . . . . . . . . . . . . 154
5.76 Panel de Personas en la ventana de detalles de incidencias 154
5.77 Panel de Personas en la ventana de detalles de incidencias 155
5.78 Ventana de gestin de Watchers de una incidencia . . . . 156
6.1 Paneles de bsqueda del navegador de incidencias 1 . . 160
6.2 Navegador de incidencias Aviso de refresco . . . . . . . 161
6.3 Paneles de bsqueda del navegador de incidencias : . . 162
6.4 Navegador de incidencias Campos Reporter y Assignee 163
6.5 Navegador de incidencias Campos Reporter y Assignee 164
6.6 Formulario para la creacin de un criterio de bsqueda por
fecha de creacin con intervalos temporales relativos. . . . 166
6.7 Criterio de bsqueda de ejemplo. . . . . . . . . . . . . . . 170
6.8 Criterio de bsqueda de ejemplo en el interfaz de bsqueda
avanzada. . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
6.9 Modicacin del criterio de bsqueda de ejemplo en el in-
terfaz de bsqueda avanzada. . . . . . . . . . . . . . . . . 171
6.10 Modicacin del criterio de bsqueda de ejemplo en el in-
terfaz de bsqueda avanzada. . . . . . . . . . . . . . . . . 171
6.11 Navegador de incidencias. . . . . . . . . . . . . . . . . . . 172
6.12 Men Actions de una incidencia en el navegador de inci-
dencias. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
6.13 Men Actions y Tools del navegador de incidencias. . . . 174
riii
ndice de guras
6.14 Ventana de detalle de la incidencia con controles de bs-
queda. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
6.15 Jerarqua de conguracin del navegador de incidencias. . 178
6.16 Ventana de conguracin de campos del navegador de in-
cidencias. . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
6.17 Ventana de conguracin de campos del navegador de in-
cidencias Establecer conguracin por defecto. . . . . . 180
6.18 Panel Preferences del perl de usuario. . . . . . . . . . . . 181
6.19 Control de bsqueda rpida. . . . . . . . . . . . . . . . . . 187
6.20 Aviso de activacin de bsqueda inteligente. . . . . . . . . 187
6.21 Registracin de un motor de bsqueda OpenSearch. . . . 193
6.22 Ejemplo de bsqueda desde el control de bsqueda del
navegador. . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
7.1 Ventana de bsqueda avanzada. . . . . . . . . . . . . . . . 196
7.2 Auto-nalizacin de un campo en una consulta JQL. . . . 210
7.3 Auto-nalizacin de un operador en una consulta JQL. . . 210
7.4 Auto-nalizacin de un valor en una consulta JQL. . . . . 211
7.5 Formulario de creacin de consultas JQL. . . . . . . . . . 212
7.6 Auto-nalizacin de un campo en una consulta JQL. . . . 212
7.7 Auto-nalizacin en consultas JQL Seleccin de campos.213
7.8 Auto-nalizacin en consultas JQL Seleccin de opera-
dores. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
7.9 Auto-nalizacin en consultas JQL Seleccin de valores
y funciones. . . . . . . . . . . . . . . . . . . . . . . . . . . 214
8.1 Filtros favoritos en la barra de herramientas de JIRA. . . 220
8.2 Creacin de ltros. . . . . . . . . . . . . . . . . . . . . . . 220
8.3 Ventana de creacin de ltros. . . . . . . . . . . . . . . . 221
8.4 Sumario de un ltro. . . . . . . . . . . . . . . . . . . . . . 222
8.5 Men Issues Operacin Manage lters. . . . . . . . . . 223
8.6 Ventana de gestin de ltros Pestaa Favorite. . . . . . 224
8.7 Ventana de gestin de ltros Pestaa Search. . . . . . . 224
8.8 Aviso de eliminacin de ltro favorito. . . . . . . . . . . . 225
8.9 Ventana de modicacin de un ltro. . . . . . . . . . . . . 226
8.10 Controles para la modicacin de las identidades con las
cuales se comparte un ltro. . . . . . . . . . . . . . . . . . 228
8.11 Compartir un ltro con un grupo de usuarios. . . . . . . . 228
8.12 Compartir un ltro con un rol de proyecto. . . . . . . . . 229
8.13 Ventana de bsqueda de ltros. . . . . . . . . . . . . . . . 231
8.14 Resultados de bsqueda de ltros. . . . . . . . . . . . . . 232
rir
ndice de figuras
8.15 Resultados de bsqueda de ltros. . . . . . . . . . . . . . 233
8.16 Modicacin del criterio de bsqueda de un ltros. . . . . 234
8.17 Modicacin del criterio de bsqueda de un ltros. . . . . 235
8.18 Jerarqua de conguracin del navegador de incidencias. . 235
8.19 Jerarqua de conguracin del navegador de incidencias
Filtros. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
8.20 Ventana de gestin de ltros - Operaciones. . . . . . . . . 237
8.21 Navegador de incidencias - Conguracin de columnas de
un ltro. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
8.22 Navegador de incidencias Men Tools Modicacin
de la conguracin de columnas de un ltro. . . . . . . . . 238
8.23 Navegador de incidencias Eliminar conguracin de co-
lumnas de un ltro. . . . . . . . . . . . . . . . . . . . . . 239
8.24 Navegador de incidencias Seleccin de la conguracin
de columnas. . . . . . . . . . . . . . . . . . . . . . . . . . 240
9.1 Suscripcin a ltro. . . . . . . . . . . . . . . . . . . . . . . 242
9.2 Formulario de suscripcin a un ltro. . . . . . . . . . . . . 243
9.3 Formulario de suscripcin a un ltro Seleccin de franja
horaria. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
9.4 Formulario de suscripcin a un ltro Seleccin de das
de la semana. . . . . . . . . . . . . . . . . . . . . . . . . . 245
9.5 Formulario de suscripcin a un ltro Seleccin de das
del mes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
9.6 Formulario de suscripcin a un ltro Expresin cron. . 246
9.7 Feed RSS de JIRA visualizado en el navegador Apple Safari.253
9.8 Ejemplo de documento Microsoft Word generado de una
bsqueda en JIRA. . . . . . . . . . . . . . . . . . . . . . . 256
9.9 Ejemplo de documento Microsoft Excel generado de una
bsqueda en JIRA. . . . . . . . . . . . . . . . . . . . . . . 257
9.10 Grco Agerage age. . . . . . . . . . . . . . . . . . . . . . 259
9.11 Grco Created vs. resolved. . . . . . . . . . . . . . . . . . 259
9.12 Grco Created vs. resolved. . . . . . . . . . . . . . . . . . 260
9.13 Grco Pie chart. . . . . . . . . . . . . . . . . . . . . . . 260
9.14 Grco Recently created. . . . . . . . . . . . . . . . . . . . 261
9.15 Grco Time since. . . . . . . . . . . . . . . . . . . . . . 261
9.16 Navegador de incidencias Tipos de grco. . . . . . . . 262
9.17 Navegador de incidencias Ver como grco. . . . . . . 262
9.18 Navegador de incidencias Personaliza grco. . . . . . 263
9.19 Grabacin de grco en el cuadro de mando Seleccin
de cuadro de mando. . . . . . . . . . . . . . . . . . . . . . 264
rr
ndice de guras
9.20 Grabacin de grco en el cuadro de mando Creacin
automtica de un cuadro de mando. . . . . . . . . . . . . 264
10.1 Cuadro de manos de un proyecto Men Reports. . . . . 266
10.2 Cuadro de manos de un proyecto Men Reports desple-
gado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
10.3 Workload pie chart Conguracin. . . . . . . . . . . . 268
10.4 Ventana de seleccin de proyecto o ltro. . . . . . . . . . 268
10.5 Report Workload pie chart. . . . . . . . . . . . . . . . . . 269
10.6 User workload Conguracin. . . . . . . . . . . . . . . 270
10.7 Report User workload. . . . . . . . . . . . . . . . . . . . . 271
10.8 Version workload Conguracin. . . . . . . . . . . . . . 272
10.9 Report Versin workload. . . . . . . . . . . . . . . . . . . 272
10.10Time tracking Conguracin. . . . . . . . . . . . . . . 273
10.11Report Time tracking. . . . . . . . . . . . . . . . . . . . . 275
10.12Report Time tracking Barras de resumen. . . . . . . . 276
10.13Single level group by Conguracin. . . . . . . . . . . . 277
10.14Report Single level group by. . . . . . . . . . . . . . . . . 278
10.15Created vs. resolved Conguracin. . . . . . . . . . . . 279
10.16Report Created vs. Resolved Grco. . . . . . . . . . . 280
10.17Report Created vs. Resolved Tabla de datos. . . . . . . 281
10.18Report Created vs. Resolved Grco. . . . . . . . . . . 282
10.19Resolution time Conguracin. . . . . . . . . . . . . . 282
10.20Report Resolution time Grco. . . . . . . . . . . . . . 284
10.21Report Resolution time Tabla de datos. . . . . . . . . . 285
10.22Pie chart Conguracin. . . . . . . . . . . . . . . . . . 285
10.23Report Pie chart Grco. . . . . . . . . . . . . . . . . 286
10.24Report Pie chart Tabla de datos. . . . . . . . . . . . . 286
10.25Average age Conguracin. . . . . . . . . . . . . . . . . 287
10.26Report Average age Grco. . . . . . . . . . . . . . . . 288
10.27Report Average age Tabla de datos. . . . . . . . . . . . 289
10.28Recently created issues Conguracin. . . . . . . . . . 290
10.29Report Recently created issues Grco. . . . . . . . . . 291
10.30Report Recently created issues Tabla de datos. . . . . . 292
10.31Time since issues Conguracin. . . . . . . . . . . . . . 292
10.32Report Time since issues Grco. . . . . . . . . . . . . 293
10.33Report Time since issues Tabla de datos. . . . . . . . 294
11.1 Cuadro de mandos vaco. . . . . . . . . . . . . . . . . . . 297
11.2 Cuadro de mandos Disponer un gadget. . . . . . . . . 297
11.3 Men Dashboards. . . . . . . . . . . . . . . . . . . . . . . 298
rri
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 Conrmacin 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 modicacin de cuadros de mandos . . . . . . 304
11.12Ventana de gestin de cuadros de mandos Operacin
Delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
11.13Ventana de conrmacin 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 Ventana de cuadro de mandos Operaciones . . . . . . . 310
12.2 Ventana de cuadro de mandos Men Tools . . . . . . . 310
12.3 Ventana de seleccin de distribucin del cuadro de mandos 311
12.4 Ventana de seleccin de gadget . . . . . . . . . . . . . . . 312
12.5 Barra de herramientas de un gadget . . . . . . . . . . . . 313
12.6 Barra de herramientas de un gadget Men de operaciones314
12.7 Mover un gadget en un cuadro de mandos . . . . . . . . . 314
12.8 Ventana de conrmacin de eliminacin de un gadget de
un cuadro de mandos . . . . . . . . . . . . . . . . . . . . 315
12.9 Gadget Activity stream Conguracin . . . . . . . . . . 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 Barra de herramientas Perl de Usuario . . . . . . . . 326
13.2 Perl de Usuario . . . . . . . . . . . . . . . . . . . . . . . 326
13.3 Perl de usuario Edicin de los detalles de usuario . . 327
13.4 Perl de usuario Edicin del avatar del usuario . . . . 328
13.5 Perl de usuario Edicin del avatar del usuario . . . . 329
13.6 Perl de usuario Cambio de contrasea . . . . . . . . . 329
13.7 Perl de usuario Modicacin de las preferencias . . . 331
rrii
ndice de tablas
1.1 Licencias comerciales . . . . . . . . . . . . . . . . . . . . . 9
2.1 Campos estndar de una incidencia . . . . . . . . . . . . . 20
2.2 Eventos en el esquema de noticaciones . . . . . . . . . . 33
3.1 Tecla modicadora por navegador y sistema operativo . . 46
3.2 Atajos de teclado globales . . . . . . . . . . . . . . . . . . 47
3.3 Atajos de teclado en las ventanas de incidencias . . . . . . 48
3.4 Atajos de teclado en los formularios de JIRA . . . . . . . 49
4.1 Navegador de proyecto Informacin relativa al proyecto. 54
4.2 Navegador de proyecto Informacin relativa a las ver-
siones del proyecto. . . . . . . . . . . . . . . . . . . . . . . 54
4.3 Navegador de proyecto Informacin relativa a los com-
ponentes del proyecto. . . . . . . . . . . . . . . . . . . . . 55
4.4 Navegador de proyecto Paneles de la ventana Summary. 56
4.5 Navegador de proyecto Paneles de la ventana Issues. . 59
4.6 Navegador de proyecto Ventanas de versiones. . . . . . 63
4.7 Navegador de proyecto Ventanas de componentes. . . . 67
5.1 Nombre de cheros adjuntos Caracteres no permitidos 84
5.2 Macro del wiki-style renderer . . . . . . . . . . . . . . . . 94
5.3 Campos estndar de una incidencia . . . . . . . . . . . . . 143
6.1 Acciones en el men Actions en el navegador de incidencias.175
6.2 Acciones en el men Actions en el navegador de incidencias.176
6.3 Caracteres especiales en las bsquedas de texto. . . . . . . 183
6.4 Trminos especiales en las bsquedas de texto. . . . . . . 183
rriii
ndice de tablas
7.1 Caracteres JQL reservados. . . . . . . . . . . . . . . . . . 197
7.2 Campos JQL. . . . . . . . . . . . . . . . . . . . . . . . . . 198
9.1 Tipos de campos JQL. . . . . . . . . . . . . . . . . . . . . 244
9.2 Valores de los campos de una expresin cron de JIRA. . . 247
9.3 Signicado de los caracteres especiales de una expresin
cron de JIRA. . . . . . . . . . . . . . . . . . . . . . . . . 247
9.4 Signicado de los caracteres especiales de una expresin
cron de JIRA. . . . . . . . . . . . . . . . . . . . . . . . . 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 Tipos de campos JQL. . . . . . . . . . . . . . . . . . . . . 343
B.2 Operadores soportados por los campos JQL. . . . . . . . . 344
B.3 Operadores JQL soportados por campos personalizados. . 345
B.4 Operadores y funciones soportados por campos de tipo
versin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
usuario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
categora. . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
B.7 Operadores y funciones soportados por campos de tipo texto.348
componente. . . . . . . . . . . . . . . . . . . . . . . . . . . 349
B.9 Operadores y funciones soportados por campos de tipo fecha.350
B.10 Operadores y funciones soportados por campos de tipo ltro.351
incidencia. . . . . . . . . . . . . . . . . . . . . . . . . . . 352
incidencia. . . . . . . . . . . . . . . . . . . . . . . . . . . 352
nivel de seguridad. . . . . . . . . . . . . . . . . . . . . . . 353
duracin. . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
rri
ndice de tablas
prioridad. . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
proyecto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
resolucin. . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
estado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
tipo de incidencia. . . . . . . . . . . . . . . . . . . . . . . 357
nmero. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
B.21 Funciones JQL soportados por tipo de campo de campo y
clase de operador. . . . . . . . . . . . . . . . . . . . . . . 359
B.22 Tipo de campo de campo y clase de operador soportada
por cascadeOption. . . . . . . . . . . . . . . . . . . . . . 360
por componentsLeadByUser. . . . . . . . . . . . . . . . . 362
por currentLogin. . . . . . . . . . . . . . . . . . . . . . . 363
por currentUser. . . . . . . . . . . . . . . . . . . . . . . 364
por issueHistory. . . . . . . . . . . . . . . . . . . . . . . 364
por lastLogin. . . . . . . . . . . . . . . . . . . . . . . . . 365
por linkedIssues. . . . . . . . . . . . . . . . . . . . . . . 366
por membersOf. . . . . . . . . . . . . . . . . . . . . . . . . 367
por now. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
por projectsLeadByUser. . . . . . . . . . . . . . . . . . . 368
por projectsWhereUserHasPermission. . . . . . . . . . . 369
por projectsWhereUserHasRole. . . . . . . . . . . . . . . 369
por releasedVersions. . . . . . . . . . . . . . . . . . . . 370
rr
Prefacio
por standardIssueTypes. . . . . . . . . . . . . . . . . . . 371
por subtaskIssueTypes. . . . . . . . . . . . . . . . . . . 371
por unreleasedVersions. . . . . . . . . . . . . . . . . . . 372
por votedIssues. . . . . . . . . . . . . . . . . . . . . . . 373
por watchedIssues. . . . . . . . . . . . . . . . . . . . . . 373
B.40 Palabras JQL reservadas. . . . . . . . . . . . . . . . . . . 375
rri
Prefacio
Este libro est dividido en dos volumenes: la Gua del usuario y la
Gua del administrador. La Gua del usuario describe las funcionali-
dades de JIRA y las herramientas a disposicin del usuario. El vol-
men 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 ltrado 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 plata-
formas soportadas, progresa con los procedimiento de personalizacin
de cada esquema de conguracin de JIRA hasta llegar a funciona-
lidades 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 documen-
tacin de sus productos siempre actualizada y disponible en la web
ocial [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 docu-
mentacin e informacin en castellano de calidad. El primer intento
rrii
Prefacio
fue comenzar a traducir la documentacin de JIRA en castellano alo-
jndola, adems, en una instancia de Atlassian Conuence, el mismo
gestor de contenido con el cual se publica la documentacin ocial de
JIRA. De esta forma, poda mantener la estructura y la subdivisin
en secciones de la documentacin ocial, facilitando la explotacin de
la informacin a los usuarios acostumbrados a utilizar la documenta-
cin 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 ocial, 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 caractersti-
cas no facilita la labor de sincronizacin de la documentacin ocial
con esta gua. Atlassian mejora sus productos con una velocidad ad-
mirable, y no me es siempre posible actualizar inmediatamente esta
documentacin. De hecho, no excluyo siquiera que algunas caracte-
rsticas nuevas o modicadas no se vean reejadas 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 actuali-
zadas.
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 conguran 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,
rriii
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 herra-
mienta de forma distorsionada, ineciente 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 ex-
periencia esta situacin no se da solo en el caso de alguna funcin
extica de la plataforma o alguna otra funcin inhabilitada por de-
fecto: este problema se maniesta tambin con funciones bsicas
de la plataforma como la personalizacin de los esquemas de congu-
racin de un proyecto y, sobre todo, los ujos de trabajo asociados a
los tipos de incidencias manejados.
Los administradores, por otra parte, para interpretar e implemen-
tar correctamente los requerimientos, solicitudes e incluso los deseos
de los usuarios, debern familiarizarse con los conceptos y los proce-
dimientos 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 administra-
dores, 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 conguracin
del proyecto, cuando los usuarios denan por primera vez los requeri-
mientos de negocio que el mismo deber satisfacer, y a veces en fases
sucesivas, como la de mantenimiento de un proyecto, cuando vayan
incorporndose modicaciones necesarias a satisfacer las nuevas ne-
cesidades 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 usua-
rios, 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 disponi-
bles, 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
rrir
Prefacio
usuario.
He tomado la precaucin, all donde considero que se est pre-
sentando 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 nomenclatu-
ra 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 exibilidad, virtud que le permite ser uti-
lizada para gestionar con xito todo tipo de proyecto. No obstante,
se ha arraigado el uso de la terminologa de los gestores de inciden-
cias y, por lo tanto, se suele llamar incidencia al objeto gestionado
en un proyecto y manejado en un ujo 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 insucientes para expresar la innidad de ob-
jetos 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 ujo 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 sencilla-
mente el objetivo, de esta herramienta.
Convenios tipogrficos
Para facilitar la lectura de esta gua se utilizarn los siguientes con-
venios tipogrcos:
Para los comandos se utilizar una fuente mono-espacio.
Para enfatizar conceptos o hacer referencias a identicadores de
ventanas, de control o de men se utilizar una fuente itlica.
Para hacer referencias se utilizarn Small Caps.
rrr
Prefacio
Los ejemplos se editarn en un bloque de texto parecido al si-
guiente:
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 A (:1o mm18
mm), un formato de hoja estndar cuyo tamao es igual al tamao
de una hoja DIN A (: mm:1o mm) cortada a la mitad y girada
de o 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 A a menos de no
desperdiciar papel utilizando mrgenes demasiado grandes.
El formato DIN A es, probablemente, el formato de papel ms
comn en Europa y, aunque no sea difcil conseguir papel en formato
DIN A, este libro podr imprimirse comodamente en formato A
manteniendo el tamao original de las pginas gracias al hecho que
una hoja DIN A puede cortarse exactamente en : hojas DIN A.
Algunas impresoras permiten, incluso, organizar la impresin de
pginas en una hoja A 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 ocina. Un libro
como este, de aproximadamente oo hojas, impreso en fascculos de
: hojas en papel A, se convierte en una docena de fascculos, cada
uno compuesto por 8 hojas A 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 renar
un trabajo sino a travs del feedback de tus usuarios. Os ruego de
rrri
Prefacio a la gua del usuario
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 modicaciones sugeridas.
Donde encontrar este libro
La licencia de este libro permite su redistribucin. Sin embargo, siem-
pre aconsejo obtener la ltima versin a la siguiente direccin [1]:
http://thegreyblog.blogspot.com/
Enrico M. Crisostomo
rrrii
La documentacin ocial de JIRA [10] es un producto de excelen-
te calidad: alojada en una instancia de Atlassian Conuence para
ser consultada online, y tambin disponible en formato PDF, est
dividida por sujeto y proporciona toda la informacin necesaria pa-
ra instalar, congurar, utilizar y administrar una instancia de JIRA.
Este recurso valioso ha sido la documentacin de referencia para edi-
tar 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 ocial 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 docu-
mentacin 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 favo-
recer la adopcin de estas soluciones en el colectivo hispano-hablante.
Ya que esta gua no es simplemente una traduccin sino una exten-
sin 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 conteni-
do de la documentacin de Atlassian. La documentacin ocial 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 beneciarse de informa-
rrriii
cin adicional tal como casos de uso y ejemplos, que son notables
ausentes en la documentacin ocial.
Por esta razn, empec a redactar este volumen con el objetivo de
proporciona una gua que pudiera satisfacer las necesidades de usua-
rios 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 acla-
rar el por qu de las cosas, sin limitarme simplemente al como se
hacen. Para usuarios expertos, he intentado poner en luz la varie-
dad 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
rrri
Gua del usuario
1
1
Introduccin
Atlassian JIRA es una herramienta verstil utilizada principalmen-
te 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 inci-
dencias 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 inci-
dencia que se est manejando est opcionalmente sometido a ujos
de trabajos distintos: los operadores que tengan permiso de hacerlo
podrn mover la incidencia en la red de estados denida en el ujo
de trabajo asociado al especco tipo de incidencia.
JIRA es una aplicacin extremadamente verstil y el valor aadi-
do que aporta es una grande exibilidad y la posibilidad de congurar
prcticamente cualquier parmetros en lo que concierne las inciden-
cias, su ujo 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
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, congurables tanto a nivel global como a nivel de pro-
yecto, 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 denidas en el ujo de trabajo asociado con la inciden-
cia, 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 ujos 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 ltrar 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 grcas. Usuarios ms ex-
pertos, 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 ad-
ministracin de la plataforma, la interfaz grca 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.
1.2. Los cuadros de mandos

1.2 Los cuadros de mandos
Otra herramienta muy exible 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
ltro, generar grcos, visualizar estadsticas o ujos de actividad.
En un cuadro de mando podr incluirse cualquier gadget OpenSocial
e, incluso, los usuarios o las organizaciones que posean la competen-
cia 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 ltrar, 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 con-
junto de incidencias en un proyecto podrn, por ejemplo, denir las
consultas necesarias a extraer dicha informacin y presentarla en un
cuadro de mando. La informacin presentada, ya sea como resulta-
do de una bsqueda o como grco, 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 denido
por el ANS.
1.3 JIRA es OpenSocial
Las ltimas versiones de JIRA son contenedores OpenSocial. Open-
Social es un conjunto de interfaces de programacin (APIs) que fa-
cilitan 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 fun-
cionalidad de JIRA, tanto si se desea integrar un gadget OpenSocial
1. Introduccin
existente
1
, 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 pro-
yecto puede parametrizarse para ajustarse a los requerimientos de sus
usuarios.
En el contexto de un proyecto pueden denirse, por ejemplo, los
tipos de incidencias que se desea manejar. Cada tipo de incidencia,
a su vez, podr asociarse a una conguracin de campos que dene
cuales campos pueden ser utilizados en la denicin 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 ujo de trabajo personalizado que prevea, por ejemplo,
los estados emitida, rechazada, parcialmente pagada y pagada.
Ya que las operaciones de un ujo 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 denir pol-
ticas de seguridad con grano muy no 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 lla-
maremos incidencias a los objetos gestionados en el mbito de un proyecto.
La exibilidad de JIRA permite fcilmente parametrizar proyectos que manejen
objetos de cualquier naturaleza y, en esos casos, el signicado de la palabra in-
cidencia no transmite de forma sucientemente clara las potencialidades de la
aplicacin.
6
1.6. Facilidad de gestin
operacin ejecutable en la aplicacin. De esta forma, los jefes de pro-
yectos 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 denicin de las polti-
cas de seguridad, as como la aplicacin de las mismas, permiten con-
trolar el acceso a prcticamente cualquier entidad gestionada por
JIRA, tales como proyectos, incidencias, cheros adjuntos, comenta-
rios, ltros, bsquedas o perles 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 bsque-
das, por ejemplo, JIRA ocultar oportunamente los datos inaccesibles
al usuario que est efectuando la solicitud.
Por otro lado, la exibilidad de las polticas de seguridad que
pueden crearse, permite no solo proteger a los datos almacenados en
JIRA, sino construir ujos de trabajo que involucren usuarios distin-
tos, con permisos distintos, en distintas fases del mismo: deniendo
los roles de proyecto adecuados para cada proyecto, es muy sencillo
crear polticas de seguridad basadas en roles que, siendo una propie-
dad 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 conguraciones en jerarqua de objetos reutili-
zables llamados esquemas, adems, proporciona una herramienta fcil
de utilizar que minimiza las labores administrativas permitiendo en-
capsular comportamiento comn aplicable en distintos contextos en
esquemas que puedan grabarse y aplicar a proyectos distintos cada
vez que se detecte la necesidad.
La conguracin basada en esquemas, adems, es la herramien-
ta fundamental que permite desacoplar los proyectos entre s y pro-
porcionar mltiples entornos de trabajos distintos y estancos a los
usuarios de JIRA. As mismo, por ejemplo, los ujos de trabajo a los
que se someten las incidencias en un proyecto pueden ser denidos
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.
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, Conuence y Bam-
boo 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 o das que se pueden solicitar directa-
mente en la web ocial 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 co-
mercial 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 1o,
:, 1oo 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
1o Usuarios $1o
Usuarios $1oo
o Usuarios $oo
1oo Usuarios $ooo
1oo+ Usuarios $Sooo
Tabla 1.1: Licencias comerciales
Pequeos proyectos con menos de 1o usuarios pueden solicitar la
licencia bsica que es disponible a un precio simblico de $1o cuyos
benecios Atlassian destina a obras de benecencias.
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 guran los siguientes:
(i) ser una organizacin sin nimo de lucro;
(ii) ser una organizacin no gubernamental;
(iii) ser una organizacin no acadmica;
(iv) ser una organizacin no comercial;
(v) ser una organizacin no poltica;
(vi) ser una organizacin secular.
1.7.3 Contactar con un Experto
Existe una red de expertos ociales de Atlassian (Experts) a nivel
mundial a los cuales los usuarios y las organizaciones pueden acu-
dir para solicitar licencias o cualquier tipo de ayuda e informacin
adicional.
La lista de Partners ociales 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 exible 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 parme-
tros 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 ujo de trabajo estndar pero, a
diferencia de otras herramientas, proporciona mucha exibilidad a la
hora de denir los parmetros de trabajo: prcticamente cualquier
aspecto del entorno de trabajo puede congurarse.
Es imperativo que los usuarios, antes que nadie, entiendan cuales
son los puntos de fuerza de JIRA y sean conscientes de las funcionali-
dades 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 apropia-
do de esquemas de conguracin 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 ujo 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 conguraciones 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 conguraciones que se han establecido a este
nivel.
Aunque dominio de los administradores, es importante que los
usuarios conozcan las herramientas que proporciona JIRA para con-
gurar un proyecto y adecuarlo a sus necesidades. Para un usuario,
el proyecto debe poderse considerar una instancia de JIRA priva-
da, aislada de los dems proyectos. Los usuarios podrn entonces
denir 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 denen 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 com-
ponente 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,
1:
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 de-
fecto, 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 reeja la organizacin del equipo. La ges-
tin de los componente puede ser efectuada por usuarios que tengan
los permisos correspondientes, es decir, el permiso de proyecto Admi-
nister projects. Aunque es comn efectuar esta operacin al principio
del proyecto, JIRA permite modicar la lista de componentes en cual-
quier 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 con-
guracin 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 po-
dra organizar sus incidencias en componentes tales como:
(i) Database.
(ii) Interfaz web.
(iii) Documentacin de proyecto.
(iv) API.
(v) Web Services.
(vi) Pruebas.
1
2. Conceptos bsicos
En este caso cada componente reeja 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 reeja una unidad organizativa dentro
de la empresa.
2.1.2 Versiones
Algunas tipologas de proyecto podran beneciarse de una subdivi-
sin en fases llamadas versiones. Una versin tiene los siguientes
atributos:
(i) Nombre.
(ii) Descripcin.
(iii) Fecha de entrega.
(iv) Planicacin.
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, Aects
version(s) y Fix version(s), a travs de las cuales pueden establecerse
las relaciones bsicas entre incidencia, i, y versione, :
(i) La incidencia i afecta la versin :
i
afecta
(2.1)
1
2.1. Proyectos
(ii) La incidencia i se soluciona en la versin :
i
se soluciona en
(2.2)
El usuario, sin embargo, podr solicitar la creacin de campos per-
sonalizados de tipo versin y, por lo tanto, denir 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 usua-
rios pueden utilizar campos de tipo versin para subdividir el proyec-
tos en grupos de incidencias los cuales tienen como factor comn un
atributo con las caractersticas peculiares de una versin, es decir:
una planicacin 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 denir una versin por cada ao
que comienza. La fecha de vencimiento de la incidencia ser el 1
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 planicacin de las incidencias.
Ejemplo 2.4. Un proyecto de desarrollo ha decidido utilizar la me-
todologa gil Scrum [32] la cual sugiere dividir las actividades de
desarrollo en unidades bsicas, llamadas sprint, de duracin limitada
y prejada.
Para organizar las incidencias en JIRA de acuerdo a los princi-
pios 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 planicacin de un sprint, crea una
versin para representar el sprint.
(iii) Se asignan las incidencias a resolverse durante el sprint utili-
zando campos de tipo versin.
1
2. Conceptos bsicos
(iv) La fecha de entrega de la versin corresponder a la duracin
establecida al sprint en curso.
(v) Al nal de cada sprint, se entrega la versin correspondiente.
En Figura 4.10 puede verse un detalle de la ventana de congura-
cin 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 pala-
bra 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 cual-
quier 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 habi-
litadas 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
conguraciones personalizadas que el administrador haya implemen-
tado 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 ven-
tana de la ilustracin.
Figura 2.4: Ventana de detalle de incidencia
1
2. Conceptos bsicos
2.2.1 Tipo de incidencia
Todas las incidencias en un proyecto pertenecen a un tipo de inciden-
cia. 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 conguracin relacionados con
las incidencias tales como:
(i) El comportamiento de las incidencias de cada tipo en un ujo
de trabajo.
(ii) Los datos almacenados en cada incidencia en una conguracin
de campos.
(iii) Las pantallas utilizadas por los usuarios en una conguracin
de pantallas.
Por defecto, JIRA proporciona los siguientes tipos de incidencia:
(i) Bug
(ii) Improvement
(iii) New feature
(iv) Task
Dependiendo de los requerimientos de los usuarios, se podrn crea-
rn 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 denicin 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 planicacin de las aplicacio-
nes auditadas.
(iv) Auditora: para modelar las auditoras solicitadas por las apli-
caciones.
Ejemplo 2.6. Un un proyecto de desarrollo y mantenimiento de soft-
ware podra requerir la denicin de los siguientes tipos de incidencias:
18
2.2. Incidencias
(i) Dependencia: para modelar la dependencia con otro departa-
mento u organizacin.
(ii) Documentacin: para modelar la documentacin a producirse.
(iii) Instalacin: para modelar la instalacin de la aplicacin en un
entorno.
(iv) Conguracin: para modelar la conguracin 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 bo-
rrarse ni modicarse: a lo sumo, algunos campos pueden esconderse,
siempre que sean campos opcionales de las incidencias.
Sin embargo, los usuarios no estn limitados a utilizar exclusi-
vamente los campos de incidencia estndar de JIRA: la plataforma
permite extender el signicado de las incidencias deniendo campos
personalizados y asignndolos a los tipos de incidencias que se desean
modicar. 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 denicin 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 denir los siguientes
campos:
(i) Aplicacin: la aplicacin que maniesta el riesgo.
(ii) Tipo: el tipo de riesgo.
(iii) Estado: el estado del riesgo (manifestado, mitigado, etc.).
(iv) Impacto: el impacto del riesgo.
Para las incidencias de tipo entregable se podran denir los si-
guientes 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.).
1
2. Conceptos bsicos
Nombre Descripcin
Project El proyecto al que pertenece la incidencia.
Key El identicador nico de la incidencia. El forma-
to del identicador es PKEY-IKEY donde PKEY es
el identicador nico del proyecto y IKEY es el
identicador nico de la incidencia en el proyec-
to.
Summary Ttulo de la incidencia.
Type El tipo de incidencia. (2.2.1)
Status El estado de la incidencia. (2.2.4)
Priority La prioridad de la incidencia. (2.2.3)
Resolution El estado de resolucin de la incidencia (2.2.5).
Aect version(s) Opcional. Las versiones del proyecto en las cua-
les se est manifestando la incidencia.
Fix version(s) Opcional. Las versiones del proyecto en las cua-
les estar resuelta la incidencia.
Component(s) Opcional. Los componentes del proyecto relacio-
nados con la incidencia.
Label(s) Opcional. Las etiquetas asignadas a la inciden-
cia.
Environment Opcional. El entorno al que est relacionada la
incidencia.
Description Descripcin de la incidencia.
Links Enlaces a incidencias relacionadas.
Assignee El operador al que est asignada la incidencia.
Reporter El usuario que ha abierto la incidencia.
Votes Los votos otorgados a la incidencia.
Watches El nmero de usuarios que estn observando la
incidencia.
Due Opcional. La fecha estimada de resolucin de la
incidencia.
Created Fecha de creacin de la incidencia.
Updated Fecha de ltima actualizacin de la incidencia.
Resolved Fecha de resolucin de la incidencia.
Estimate Estimacin del tiempo requerido para solucionar
la incidencia.
Remaining Estimacin del tiempo que queda para solucionar
la incidencia.
Logged Suma del tiempo dedicado por los operadores a
la resolucin de la incidencia.
Tabla 2.1: Campos estndar de una incidencia
:o
2.2. Incidencias
Ejemplo 2.8. En un proyecto de desarrollo de software podran asig-
narse campos personalizados a los tipos de incidencias que represen-
tan 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
denir son, por ejemplo:
(i) Nmero de ticket: el identicador de la solicitud.
(ii) Acuerdo de nivel de servicio: para reejar 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 in-
cidencias 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 pro-
gresar 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 denir niveles adicionales de priori-
dad aunque dichos niveles no sern limitados al contexto de un pro-
yecto sino a toda la plataforma.
La prioridad se utiliza primariamente en operaciones de ltrado
de incidencias, asignacin y reporting.
Ejemplo 2.9. El jefe de proyecto o un cliente podran estar interesa-
dos a saber cuales incidencias alcanzan el nivel de prioridad critical y
blocker. Las incidencias que alcanzan estos niveles de prioridad pue-
den, por ejemplo, ltrarse a travs de una bsqueda personalizada
cuyo resultado puede utilizarse para poblar un gadget del cuadro de
:1
2. Conceptos bsicos
mando o desencadenar una noticacin por correo electrnico a los
usuarios suscritos a dicho ltro.
2.2.4 Estado
El estado de una incidencia es un ag que indica en que punto de su
ujo de trabajo (2.3) se encuentra una incidencia. Los estados que
por defecto estn denidos en el ujo 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 trabajan-
do.
(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 ujo de trabajo asociado a
esa incidencia: normalmente, de hecho, distintos estados de un ujo
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 ujo de trabajo es el estado In progress. Si un
proyecto decide extender el ujo de trabajo estndar de JIRA para
reejar 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 ujo
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 ujo de
trabajo se establecen a nivel de ujo de trabajo y, por lo tanto, pueden
congurarse en el contexto de un proyecto a travs de un esquema de
ujo de trabajo (??). En Figura 2.5 se ilustran las relaciones entre
::
2.2. Incidencias
los conceptos de estado de incidencia y estado de un ujo de trabajo.
Figura 2.5: Relacin entre estado de una incidencia y ujo de trabajo
Ejemplo 2.11. Un proyecto con necesidades parecidas al proyecto
ilustrado en el ejemplo 2.10 podra decidir de querer reejar en el es-
tado que una incidencia se encuentra en espera mientras los actores
externos trabajan sobre ella. En este caso se podran denir nuevo
estados, tales como el estado En espera, y asignarlos a uno o ms
estado del ujo 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 dene como y si una incidencia
se ha solucionado. Las resoluciones que JIRA dene por defecto son
las siguientes:
(i) Fixed: la incidencia ha sido resuelta.
(ii) Wont x: la incidencia no se resolver.
(iii) Duplicate: la incidencia no se resolver porque es un duplicado.
(iv) Incomplete: la incidencia no se resolver porque ha sido descrita
de forma incompleta.
:
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 denir nuevos tipos de resolucin po-
drn solicitarlas a los administradores de JIRA y las resoluciones
creadas se aadirn al conjunto de resoluciones que existen en la pla-
taforma.
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 inciden-
cias proporcionando el servicio denido en un contrato de soporte,
podran denirse resoluciones adicionales para tener traza de la ca-
sustica que puede presentarse:
(i) Soporte insuciente: la incidencia no se resolver porque el ni-
vel 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 ujos de trabajo denen la mquina de estados asociada a uno
o ms tipos de incidencias en JIRA. JIRA proporciona un ujo de
trabajo por defecto que no puede modicarse y que est ilustrado en
Figura 2.6: las cajas son los estados de la mquina y las echas
son las transiciones entre estados. El ujo de trabajo por defecto
contempla los siguientes estados:
(i) Open: una incidencia ha sido creada y todava no se ha comen-
zado 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.
:
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 exibilidad 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 dis-
tintas y los ujos de trabajo asociados a cada tipo de incidencia son
una parte fundamental de la adaptacin de la herramienta a las ne-
cesidades del negocio y de los usuarios. Un proyecto para gestionar
campaas de captacin de clientes, por ejemplo, requerir ujos 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 ujos de trabajos personalizados permite imple-
mentar cualquier comportamiento que los usuarios requieran para to-
dos los tipos de incidencias gestionados en su proyecto, siempre que
dicho comportamiento se pueda modelar con una mquina de estados.
Un ujo de trabajo se modela de forma sencilla utilizando el inter-
faz web de JIRA. Los usuarios, que normalmente no pueden utilizar
:
2. Conceptos bsicos
esta herramienta, debern denir los siguientes requerimientos y pro-
porcionarlos 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 ujo de
trabajo.
Adicionalmente, a cada transicin podrn asignarse validadores, con-
diciones y una pantalla a visualizarse durante la transicin.
El administrador puede denir los ujos de trabajos necesarios
para los proyectos de su organizacin y asignarlos a tipos de inciden-
cias en el contexto de un proyecto a travs de un esquema de ujo de
trabajo.
Ejemplo 2.13. Un proyecto que utilice los tipos de incidencia intro-
ducidos en el ejemplo 2.5 (riesgo, entregable, hito y auditora) podran
desear asociarlas a ujos de trabajo personalizados.
El ujo de trabajo de las incidencias de tipo riesgo, por ejemplo,
podra tener los siguientes estados:
(i) Manifestado.
(ii) Mitigado.
(iii) Transferido.
(iv) Rechazado.
El ujo de trabajo de las incidencias de tipo auditora podra
obtenerse copiando y reduciendo el ujo de trabajo estndar de
JIRA:
(i) Open.
(ii) In progess.
(iii) Closed.
2.4 Organizacin de los conceptos
Parte de la exibilidad 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 conguraciones en grupos
de atributos, llamados esquemas, funcionalmente relacionados entre
ellos. Existen, por ejemplo, esquemas de conguracin de campos, en
:6
2.4. Organizacin de los conceptos
los cuales se establece el conjunto de parmetros de conguracin de
los campos de las incidencias, o esquemas de conguracin de panta-
lla, en los cuales se establece cuales pantallas se utilizarn por cada
operacin denida en el esquema.
Por el otro lado, el administrador selecciona los mdulos de con-
guracin necesarios a satisfacer las necesidades de un proyecto y
los asocia con el mismo. La estructura jerrquica resultante es el me-
canismo a travs del cual las conguraciones se aplican en el contexto
de los proyectos a ellas relacionados y garantizan que, con un me-
canismo 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 conguracin de JIRA que estarn activos en el contexto
del mismo: conguracin de campos, pantallas, ujos de trabajo y
seguridad son solo algunos ejemplos de las conguraciones que pueden
establecerse a nivel de proyecto.
Los esquemas que componen la conguracin de un proyecto son
elementos que pueden reutilizarse cuando proyectos distintos compar-
ten similitudes. Es importante, no obstante, subrayar que compartir
esquemas genera un acoplamiento entre proyectos distintos y que, por
lo tanto, cada modicacin aportada en un esquema compartido se
reejar de inmediato en todo proyecto que lo est utilizando.
Es responsabilidad de los usuarios determinar si, y cuando, com-
partir 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 congu-
raciones que ya se han establecido. Sin embargo, nadie mejor que el
usuario puede determinar cuando es conveniente crear nuevos esque-
mas y dedicarlos exclusivamente a un proyecto o cuando es preferible
compartirlos con otros.
Durante la toma de esta decisin habr que analizar muchos fac-
tores y oportunidades. Es necesario evaluar, por ejemplo, si las nece-
sidades 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 com-
partir esquemas con proyectos fuera de nuestro control, es conveniente
reducir las interferencias al mnimo y empezar solicitando esquemas
:
2. Conceptos bsicos
distintos. La consolidacin de esquemas, cuando se detecta que es
benecioso compartir esquemas y reducir la redundancia de congu-
racin, 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 identicacin en la cual se establecen las
relaciones con los esquemas de conguracin de JIRA. En Figura 2.7
puede verse la relacin que JIRA establece entre esquemas y proyec-
tos.
Figura 2.7: Organizacin de los conceptos en JIRA
Las conguraciones establecidas en los esquemas relacionados con
un proyecto determinan un gran nmero de parmetros de funciona-
miento incluyendo, aunque la lista no sea exhaustiva, las ventanas
del proyecto, los tipos y los atributos de la incidencia y los ujos de
trabajo. En la actualidad, un proyecto de JIRA establece relaciones
con los siguientes esquemas:
(i) Esquema de tipos de incidencia (2.5.2).
(ii) Esquema de conguracin de campos (2.5.3).
(iii) Esquema de pantallas para tipos de incidencia (2.5.4).
(iv) Esquema de ujo de trabajo (2.5.5).
(v) Esquema de noticacin (2.5.6).
(vi) Esquema de permisos (2.5.7).
(vii) Esquema de seguridad de incidencia (2.5.8).
Los esquemas son el medio a travs del cual proyectos distintos
podrn implementar requerimientos de negocios completamente dis-
tintos. Como hemos visto en los ejemplos de las secciones precedente,
:8
2.5. Esquemas
un proyecto de desarrollo de software podr denir un conjunto de
tipos de incidencias, campos y ujos de trabajos que reejen las ne-
cesidades de un proyecto de ese tipo utilizando los correspondientes
tipos de esquemas. Un proyecto para gestionar una campaa de mar-
keting, por otro lado, implementar las caractersticas nicas de su
funcionalidad en un conjunto de esquemas distintos que satisfagan a
sus necesidades.
Los esquemas de conguracin, en las versiones de JIRA hasta
la fecha, solo pueden ser creados por los administradores de JIRA.
Sin embargo, el conocimiento funcional para denir las caractersti-
cas de cada esquema y si un esquema puede o no reutilizarse entre
proyectos distintos es responsabilidad de los usuarios que han solici-
tado 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 conguracin de tipos de incidencias. Proyectos que ma-
nejen incidencias de tipos distintos se asociarn, por lo tanto, a es-
quemas de tipos de incidencia distintos.
Ejemplo 2.15. El esquema de conguracin de campos dene el
signicado de las incidencias deniendo los atributos que estas al-
macenan. Es por lo tanto posible que proyectos distintos estn com-
partiendo un tipo de incidencia, como por ejemplo el tipo factura: sin
embargo, cada uno de los proyectos podr denir los atributos de ca-
da tipo de incidencia y, por lo tanto, es en el contexto de un proyecto
donde las incidencias cobran el signicado que se les ha otorgado en
virtud de las necesidades del mismo.
Ejemplo 2.16. Cada tipo de incidencia puede asociarse a un ujo
de trabajo a travs del esquema de ujos de trabajo. Las operaciones
disponibles para cada tipo de incidencias estn entonces denidas
por los ujo de trabajo a ellas asociados en el contexto del proyecto:
los usuarios tiene, por lo tanto, plena libertad de denir sus ujos
con independencia de las elecciones que se hayan tomado en otros
proyectos.
:
2. Conceptos bsicos
2.5.1 Desacoplamiento de proyectos y reutilizacin de
esquemas
Los esquemas de conguracin de JIRA son una herramienta pode-
rosa que permiten al administrador desacoplar las conguraciones de
los proyectos a los que aplican. De esta forma los esquemas se con-
vierten en componente reutilizables donde encapsular conguraciones
comunes a ms que un proyecto.
De la misma forma los esquema aislan proyectos distintos y per-
miten crear, aplicar o modicar parmetros de conguracin sin que
dichas modicaciones intereran en otros proyectos no relacionados
con los esquemas modicados.
Una buena recomendacin es que, a menos que los usuarios pidan
explcitamente que algunos proyectos compartan esquema, el admi-
nistrador asle todo proyecto creando un conjunto de esquemas ad
hoc. Para facilitar estas labores JIRA proporciona tanto la posi-
bilidad 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 intere-
ran el uno con el otro cuando se modiquen algunas conguraciones
compartidas.
2.5.2 Tipos de incidencias disponibles
Cada proyecto manejar entidades distintas y, por lo tanto, es im-
portante que stas se plasmen en los correspondientes tipos de inciden-
cias disponibles a los usuarios sin limitarse a los tipos proporcionados
por defecto.
El esquema de tipos de incidencias es la herramienta que permite
denir 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 denir
el contexto de aplicacin de un campo personalizado que puede ser
global o por tipo de incidencia.
An as, proyectos distintos podran necesitar conguraciones dis-
tintas para los campos de los tipos de incidencias que comparten:
o
2.5. Esquemas
campos obligatorios en un proyecto podran ser opcionales en otros
o, incluso, algunos campos podran ser innecesarios .
El usuario podr denir, en un esquema de conguracin de cam-
pos, la obligatoriedad del campo, la visibilidad del campo y las pan-
tallas en las cuales el campo est disponible.
2.5.4 Configuracin de pantallas
JIRA presenta al usuarios pantallas distintas en respuesta a opera-
ciones de diverso tipo:
(i) Creacin de incidencia.
(ii) Vista de detalle de incidencia.
(iii) Modicacin de incidencia.
(iv) Transicciones de ujos 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 congure
cada pantalla de acuerdo a sus necesidades.
El usuario puede congurar la estructura de la pantalla propor-
cionada por cada operacin sobre las incidencias (creacin, detalle y
edicin) e, incluso, especicar conguraciones distintas por cada tipo
de incidencia utilizada en un proyecto. El usuario, adems, podr
escoger una conguracin de pantalla por cada transicin de ujo 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 modicarse despus de haber sido
introducidos y antes de que la incidencia se cierre
1
.
Una de las formas de conseguir este objetivo es ofrecer la posi-
bilidad de introducir este dato solo en la ventanas de transicin de
ujo de trabajo durante determinadas transiciones. Dependiendo de
la mquina de estados del ujo de trabajo, podra ser incluso impo-
sible volver a la ventana de transicin y, por lo tanto, modicar 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 modicarse
1
2. Conceptos bsicos
seguridad para asegurarse que solo los usuarios autorizados puedan
efectuar esta operacin.
2.5.5 Flujos de trabajos disponibles
Como explicado en 2.3, los usuarios de un proyecto pueden denir
los ujos de trabajo asociados a cada tipo de incidencia que manejan
en sus proyectos en un esquema de ujo de trabajo.
JIRA ofrece a sus usuarios un motor de ujos de trabajo exible y
poderoso. La denicin de ujos de trabajo personalizados permite: Describe all of
the options?
(i) Denir el ciclo de vida de las incidencias.
(ii) Denir las operaciones que pueden efectuarse sobre una inci-
dencia.
(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) Denir reglas de validacin a evaluarse durante cada transicin.
(v) Denir condiciones que deben satisfacerse durante cada transi-
cin.
(vi) Denir estados de incidencia asociados a cada estado del ujo
de trabajo.
(vii) Asociar una ventana a cada transicin.
(viii) Asociar operaciones a efectuarse despus de cada transicin ta-
les como el lanzamiento de una noticacin.
2.5.6 Notificaciones
JIRA, en respuesta a determinados eventos, enva noticaciones a los
usuarios que hayan sido suscritos a cada uno de ellos.
El esquema de noticaciones establece la relacin entre tipos de
eventos y usuarios que recibirn la noticacin. Los eventos dispo-
nibles en la actualidad en el esquema de noticacin son los eventos
detallados en Tabla 2.2.
La creacin de relaciones entre evento e identidades es muy exible
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.
:
2.5. Esquemas
Nombre Descripcin
Issue created Creacin de una incidencia.
Issue updated Actualizacin de una incidencia.
Issue assigned Asignacin de una incidencia a un usuario.
Issue resolved Resolucin de una incidencia.
Issue closed Cierre de una incidencia.
Issue commented Creacin de comentario en una incidencia.
Issue comment edited Modicacin de un comentario en una inci-
dencia.
Issue reopened Reabertura de una incidencia.
Issue deleted Borrado de una incidencia.
Issue moved Migracin de una incidencia a otro proyecto.
Work logged on issue Trabajo registrado en una incidencia.
Work started on issue Trabajo comenzado en una incidencia.
Work stopped on issue Trabajo terminado en una incidencia.
Issue worklog updated Actualizacin de registro de trabajo en una
incidencia.
Issue worklog deleted Borrado de registro de trabajo en una inci-
dencia.
Generic event Evento genrico.
Tabla 2.2: Eventos en el esquema de noticaciones
(ii) Reporter de una incidencia.
(iii) Responsable de proyecto.
(iv) Responsable de componente.
(v) Usuario.
(vi) Grupo.
(vii) Rol de proyecto.
(viii) Direccin de correo electrnico.
(ix) Usuarios que estn observando la incidencia.
(x) Usuario indicado en un campo personalizado de la incidencia.
(xi) Grupo indicado en un campo personalizado de la incidencia.
Un usuario que desee ser avisado de inmediato cuando se produ-
ce algn evento, podr utilizar el mecanismo de las noticaciones 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 ujo de trabajo personalizado, por
2. Conceptos bsicos
ejemplo, podrn lanzarse un evento genrico para que los usuarios
puedan interceptar dicha accin y recibir la correspondiente noti-
cacin.
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 noticaciones pa-
ra 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 noticaciones.
Utilizando el rol de proyecto, adems, se podrn utilizar las cate-
goras de usuarios del proyecto, y no de la plataforma, facilitando as
la administracin de las identidades y los parmetros de conguracin
a ellas relacionado en el mbito de cada proyecto.
Ejemplo 2.19. Una organizacin desea poder moderar los comen-
tarios 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 aa-
dir esta identidad a los usuarios que reciben las noticaciones de los
eventos Issue commented e Issue comment edited. Los moderadores
recibirn las noticaciones en tiempo real y podrn as moderar todo
comentario creado o modicado sin necesidad de controlar peridica-
mente las incidencias modicadas.
Ejemplo 2.20. Un proyecto ha denido ujos de trabajo personali-
zados para un conjunto de tipos de incidencias que contempla transi-
ciones 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 re-
duccin de los tiempos de accin, que los usuarios de este rol puedan
ser noticados 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 noticaciones de eventos genricos (Generic e-
vent) y se modicar el ujo de trabajo de manera que se lance dicho
evento durante la transicin al estado auditado.
2.5. Esquemas
2.5.7 Polticas de seguridad
El esquema de permisos es la herramienta que permite denir las
polticas de seguridad que aplican en el contexto de un proyecto. JIRA
de ne un conjunto de permisos que permiten construir polticas de
seguridad con grano muy no 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 denicin de polticas
de seguridad en JIRA. No obstante, es importante subrayar que los
responsables de un proyecto pueden solicitar la denicin 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) Permisos para proteger proyecto.
(ii) Permisos para proteger incidencia.
(iii) Permisos para proteger votantes y observadores.
(iv) Permisos para proteger comentarios.
(v) Permisos para proteger cheros adjuntos.
(vi) Permisos para proteger el registro de trabajo.
Los permisos, en general, permiten proteger las acciones ms comu-
nes que pueden efectuarse sobre las entidades que protegen, como
por ejemplo la creacin, la actualizacin y la eliminacin. JIRA tam-
bin permite proteger las transiciones de ujo de trabajo asignando
polticas de seguridad a las transiciones del mismo.
Como usuarios, por lo tanto, no debemos extraarnos si en de-
terminadas 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 exibilidad
de JIRA a la hora de parametrizar nuestros proyectos, para denir e
implementar un entorno que satisfaga nuestros requerimientos fun-
cionales, incluidos los requerimientos de seguridad.
Ejemplo 2.21. Los responsables de un proyecto tienen la responsa-
bilidad de asignar las incidencias para distribuir el trabajo entre los
operadores de acuerdo a su criterio y las necesidades de la empresa.
2. Conceptos bsicos
Para otorgar el permiso para asignar una incidencia a un subcon-
junto de usuarios, es suciente 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 exclu-
sivamente 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 necesa-
rios a denir las polticas de seguridad que se necesitan implementar
y proteger las transiciones de ujo de trabajo que se originan en el
estado auditado asignando el permiso de efectuar las mismas exclusi-
vamente a los roles correspondientes.
2.5.8 Niveles de seguridad de las incidencias
Las herramientas para denir polticas de seguridad descritas en pre-
cedencia (2.5.7), permiten crear polticas de grano muy no 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 pro-
yectos distintos para poder proteger las incidencias distintas con po-
lticas distintas.
Para solventar este problema y dar soporte a este escenario, JIRA
permite denir esquemas de nivel de seguridad. Un esquema de este
tipo dene 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) Reporter de la incidencia.
(ii) Usuario.
(iii) Grupo.
(iv) Rol de proyecto.
(v) Responsable de proyecto.
(vi) Asignatario de la incidencia.
6
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 denir tantas po-
lticas 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 especicadas
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 pro-
yecto requieren que se restrinja el acceso a las incidencias que conten-
gan 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 denir las polticas de
seguridad que se requieren, por ejemplo Usuarios Plata, Usua-
rios 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 correspon-
diente (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 or-
ganizacin (Internos) y otro nivel para los usuarios externos
(Externos).
2. Conceptos bsicos
(iii) Otorgar acceso a cada nivel de seguridad a los roles correspon-
dientes.
8
3
Primeros pasos
En este captulo se har una introduccin de JIRA y de las operacio-
nes bsicas que un usuario puede efectuar:
(i) Acceso a la plataforma, introduccin de las credenciales de usua-
rio 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 mayo-
ra de la funcionalidad de JIRA est condensada en un conjunto de
ventanas tan reducido sin que su compleja funcionalidad afecte nega-
tivamente ni a la usabilidad, ni a la homogeneidad, ni a su coherencia
como conjunto.
Es muy importante aanzarse con ellas, ya que en ellas los usua-
rios pasarn casi la totalidad del tiempo pasado en JIRA. El gradiente
de aprendizaje es muy suave y en poco tiempo, y casi de forma au-
tomtica, 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 in-
terfaz 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 au-
tenticados que tengan los privilegios necesarios para acceder al recurso
solicitado.
3. Primeros pasos
Dependiendo del modo en que JIRA est ejecutndose, adems,
un usuario podra crearse unas credenciales de acceso de forma auto-
mtica 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 autenti-
cacin 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
congurar a su gusto. En el cuadro de mando pueden integrarse gad-
gets OpenSocial: JIRA proporciona un conjunto de gadgets con los
cuales pueden visualizarse contenidos tales como reportes, resultados
de ltros de bsquedas, grcos as como datos provenientes de otras
aplicaciones. Las aplicaciones de la suite de productos Atlassian, tales
como JIRA, Conuence, FishEye o Bamboo, pueden publicar sus gad-
gets y ser utilizados en los cuadros de mandos de otras aplicaciones.
o
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 concen-
trarla 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 utili-
zado, a los proyectos ms utilizados y a la lista completa de
proyectos visibles al usuario conectado.
1
3. Primeros pasos
(iii) Issues: proporciona acceso rpido a las ventanas de bsqueda
y creacin de incidencias, a las ltimas incidencias visitadas, a
los ltros 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 pro-
porcionado por un plugin de JIRA, GreenHopper. Dependiendo de la
conguracin 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 herra-
mientas de JIRA. Esta parte hospeda los siguientes controles:
(i) El menu del usuario.
(ii) El enlace al men Administration.
(iii) El control de texto para la bsqueda simple.
(iv) El 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
:
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 re-
cientemente.
(iii) Un enlace a la herramienta de gestin de cuadros de mandos.
En ?? se detallar el funcionamiento de las herramientas de ges-
tin 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 di-
recto al navegador de incidencias, la herramienta que permite crear
bsquedas y ltros 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 ma-
nejado.
(iv) Un enlace a la herramienta de gestin de ltros.
En 6 y siguientes se detallarn las funciones de bsqueda y ltra-
do ofrecidas por JIRA, tales como la gestin de ltros y el navegador
de incidencias (6.2).
3. Primeros pasos
3.3.4 Menu Administration
Si el usuario tiene los privilegios necesarios y puede entrar en el apar-
tado de administracin, Administration, entonces JIRA proporcio-
nar una barra de herramientas dedicada mientras que el usuario
permanezca en dicha modalidad
1
.
En Figura 3.5 puede verse el lado izquierdo de la barra de he-
rramientas en modalidad administracin, con mens de primer nivel
para acceder a las apartados de administracin ms utilizados:
(i) Administracin de proyectos.
(ii) Administracin de plugins.
(iii) Administracin de usuarios.
(iv) Administracin de incidencias.
(v) Administracin del sistema.
En Figura 3.6 puede verse su lado derecho, muy parecido al la-
do derecho de la barra de herramientas en modalidad usuario, con el
enlace Exit Administration que permite salir del apartado de admi-
nistracin.
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 , en lugar de proporcionar
una barra de las herramientas distinta, JIRA proporcionaba un men de primer
nivel adicional en la misma, llamado Administration.
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 perl del usuario. En esta seccin el usuario puede,
a travs de una serie de cuadros de mando, gestionar su perl y sus
preferencias. El cuadro de mando del perl del usuario proporciona,
entre otras, la siguiente informacin:
(i) Detalles del perl de usuario.
(ii) Flujo de actividad del usuario.
(iii) Proyecto con incidencias abiertas del usuario.
(iv) Conguraciones personales de JIRA.
3.4 Atajos de teclado
Recientemente, JIRA ha incorporado los atajos de teclado en su inter-
faz web: en lugar de poder utilizar exclusivamente el ratn, el usuario
puede ahora utilizar el teclado para interactuar con JIRA
2
. Algunos
atajos estn disponibles a nivel global y pueden por lo tanto utilizarse
en cualquier ventana de JIRA; otros son especcos de algunas ven-
tanas en concreto. Para acceder a una ventana de ayuda que resume
los principales atajos
3
, una captura de pantalla de la cual puede verse
en Figura 3.7, es suciente teclear ? o Shift+/.
3.4.1 Tecla modificadora
En algunos atajos de teclado se utiliza una tecla modicadora que
depende tanto del navegador como del sistema operativo utilizado por
el cliente. La tecla modicadora, desde aqu en adelante, se indicar
con el smbolo . En Tabla 3.1 se resume cual es la tecla modicadora
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 compor-
tamiento de JIRA para sus sesiones activando o desactivando esta funcionalidad
en su perl de usuario.
3
Los atajos de teclado, como cualquier otro elemento de la interfaz grca de
JIRA puede extenderse a travs de plugins. En este caso, la ventana de ayuda en
cuestin tambin incluye atajos de teclados denidos por Greenhopper.
3. Primeros pasos
Figura 3.7: Ventana de ayuda de los atajos de teclado
Tecla modicadora
Navegador Windows UNIX Mac OS X
Firefox Alt + Shift Alt + Shift Ctrl
Internet Explorer Alt
Safari Ctrl Ctrl + Alt
Chrome Alt + Shift Alt + Shift Ctrl + Alt
Tabla 3.1: Tecla modicadora por navegador y sistema operativo
6
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 Descripcin
g, d Abre el cuadro de mando.
g, p Abre el proyecto corriente.
g, i Abe el navegador de incidencias.
/ Pone el cursor en el campo Quick search (Bsqueda r-
pida).
c Abre la ventana de creacin de una incidencia.
? Abre la ventana de ayuda de los atajos de teclado.
+ d Abre el menu desplegable Dashboards.
+ p Abre el menu desplegable Projects.
+ i Abre el menu desplegable Issues.
g, g 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.
3. Primeros pasos
Atajos de teclado Ventanas de incidencias
Atajo Descripcin
o | Enter Abre la incidencia seleccionada en el navegador de
incidencias.
j Navega a la incidencia siguiente (solo si se ha llegado
a la incidencia desde el navegador de incidencias).
k Navega a la incidencia precedente (solo si se ha llega-
do a la incidencia desde el navegador de incidencias).
u Vuelve al navegador de incidencias (solo si se ha lle-
gado a la incidencia desde el navegador de inciden-
cias).
[ Nasconde o muestra el panel izquierdo en el navega-
dor de incidencias.
n Navega al siguiente elemento en la seccin de activi-
dad (en la pantalla de detalle de incidencia).
p Navega al precedente elemento en la seccin de acti-
vidad (en la pantalla de detalle de incidencia).
f Posiciona el cursor en el campo bsqueda avanzada
o bsqueda simple.
Esc Quita el foco de un campo de texto (para poder uti-
lizar los dems atajos de teclado).
e Abre la pgina Modica incidencia.
a Abre la ventana Asigna incidencia.
m Abre la ventana para aadir comentarios a una inci-
dencia.
l Abre la ventana Etiquetas.
s Abre la ventana Share para compartir una inciden-
cia.
. Abre la ventana Operaciones, desde la cual se pue-
de acceder (buscndola textualmente) y lanzar cual-
quier operacin aplicable a la incidencia selecciona-
da.
Tabla 3.3: Atajos de teclado en las ventanas de incidencias
8
Atajos de teclado Formularios
Atajo Descripcin
+ s Enva un formulario.
+ Anula un formulario.
Esc Quita el foco de un campo de texto (para poder utilizar
los dems atajos de teclado).
u Vuelve a la ventana de detalle de la incidencia.
+ r 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
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 total-
mente congurables 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, nave-
gar 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 na-
vegador 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 si-
guientes de este libro. He ha intentado poner un nmero suciente 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 herramien-
1
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 grca 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
:
4.1. Estructura
Figura 4.2: Navegador de proyecto.
factores, como por ejemplo la integracin de JIRA con otros produc-
tos, 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 seleccio-
nada por el usuario, proporciona una barra rpida de creacin de
Nombre Descripcin
Summary Actividad reciente del proyecto y lista de incidencias
que estn por caducar.
Issues Resumen de las incidencias agrupadas por estado.
Resumen de las incidencias no resueltas agrupadas
por asignatario, prioridad, versin y componente.
Road Map Incidencias no resueltas para las siguientes versiones
de un proyecto.
Change Log Incidencias resueltas en precedentes versiones de un
proyecto.
Popular Issues Incidencias no resueltas ordenadas por popularidad.
Versions Resumen de las versiones recientes.
Components Resumen de los componentes.
Labels Resumen de las etiquetas utilizadas en las inciden-
cias.
Builds Builds de Atlassian Bamboo (disponible exclusiva-
mente si se congur la integracin entre JIRA y
Bamboo).
Source Resumen de los cambios recientes registrados en Fis-
hEye (disponible exclusivamente si se congur la
integracin entre JIRA y FishEye).
Reviews Resumen de las revisiones recientes registrados en
Crucible (disponible exclusivamente si se congur
la integracin entre JIRA y Crucible).
Tabla 4.1: Navegador de proyecto Informacin relativa al proyecto.
Nombre Descripcin
Version Summary Actividad reciente en una versin del proyec-
to y lista de actividades que estn cerca de
su caducidad.
Version Issues Incidencias asignadas a una versin del pro-
yecto.
Version Popular Issues Incidencias populares asignadas a una ver-
sin del proyecto.
Version Builds Builds de Atalssian Bamboo de una versin
del proyecto (disponible exclusivamente si se
congur la integracin entre JIRA y Bam-
boo).
Tabla 4.2: Navegador de proyecto Informacin relativa a las versiones
del proyecto.
4.1. Estructura
Nombre Descripcin
Component Sum-
mary
Actividad reciente sobre un componente del pro-
yecto.
Component Issues Incidencias pertenecientes a un componente del
proyecto.
Component Road
Map
Incidencias a resolver de un componente del pro-
yecto, agrupadas en versiones del proyecto.
Component Chan-
ge Log
Incidencias resueltas de un componente del pro-
yecto, agrupadas en versiones del proyecto.
Component Popu-
lar Issues
Incidencias populares a resolver de un componen-
te del proyecto, ordenadas por popularidad (n-
mero de votos).
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 inci-
dencias recin utilizados se proporcionar un botn a parte
1
, 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 grca 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.
proyectos visualizan, por defecto, exclusivamente la informacin ms
reciente.
Algunos de estos paneles, sin embargo, permiten acceder a la ven-
tana de detalle en la cual puede encontrarse la informacin completa.
Los paneles que exhiben este comportamiento son los paneles que
proporcionan un botn identicado 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 gen-
rica e informacin sobre la actividad reciente del proyecto, incluyendo
versiones e incidencias que caducan en pocos das. Un ejemplo de ven-
tana 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 Informacin bsica sobre el proyecto.
Issues: Due Incidencias que han caducado.
Issues: 30 days summary Reporte grco de incidencias abiertas y
resueltas en los ltimos o das.
Issues: Updated recently Incidencias actualizadas recientemente.
Versions: Due Versiones que han caducado.
Activity Stream Flujo de actividad.
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 ltros (vase 8).
Mayores detalles sobre las caractersticas de estas funciones sern de-
talladas en los captulos correspondientes.
6
4.2. Summary
Figura 4.4: Navegador de proyecto Ventana Summary.
Figura 4.5: Navegador de proyecto Barra de herramientas de la
ventana Summary.
4.2.1 Activity Stream
El panel Activity Stream presenta el ujo de actividad reciente en el
proyecto corriente. Generalmente, el ujo de actividad ser relativo
a operaciones sobre incidencias de la instancia de JIRA local. Sin
embargo, si el administrador ha congurado la integracin de JIRA
con otras aplicaciones
2
, el ujo de actividad incluir tambin la in-
formacin procedentes de stas aplicaciones. El ujo 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 sus-
cribirse a un feed RSS para recibir la informacin actualizada utili-
zando un lector de feeds RSS. Para suscribirse al feed, es suciente
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) propor-
ciona un reporte sobre el estado de las incidencias del proyecto selec-
cionado. 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) congurado con
el ltro correspondiente. Si, por ejemplo, se selecciona el enlace co-
rrespondiente al nombre de un usuario en el panel Unresolved: By
Assignee, JIRA llevar el usuario a la ventana del navegador de inci-
dencias congurado para devolver las incidencias no resueltas y asig-
nadas al usuario seleccionado.
4.4 Road Map
La ventana Road map del navegador de proyectos (Figura 4.7) pro-
porciona informacin sobre las versiones del proyecto todava no en-
2
JIRA puede integrarse con otras aplicaciones de Atlassian (tales como Con-
uence, FishEye, Crucible y Bamboo) u aplicaciones de terceras partes.
8
4.4. Road Map
Nombre Descripcin
Status summary Reporte de incidencias agrupadas por
estado.
Unresolved: By priority Incidencias no resueltas, agrupadas
por prioridad.
Unresolved: By assignee Incidencias no resueltas, agrupadas
por usuario asignado.
Unresolved: By version Incidencias no resueltas, agrupadas
por versin.
Unresolved: By component Incidencias no resueltas, agrupadas
por componente.
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 seleccio-
nado 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 nalizado y por nalizar por cada ver-
sin.
El reporte de la ventana Road map agrega todas las incidencias
asignadas a las versiones del proyecto: sin embargo, un usuario pue-
de acceder al road map personal, es decir, el road map generado
Figura 4.7: Navegador de proyecto Ventana Road map.
considerando exclusivamente las incidencias asignadas al usuario ac-
tualmente 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) pro-
porciona informacin sobre las versiones del proyecto que se han entre-
gado. 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.
6o
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) pro-
porciona 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.
6:
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 supe-
rior 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.
Issues Resumen de las incidencias de la versin selec-
cionada agrupadas por estado. Resumen de las
incidencias de la versin seleccionada no resuel-
tas agrupadas por asignatario, prioridad, versin
y componente.
Popular Issues Incidencias no resueltas de la versin selecciona-
da ordenadas por popularidad.
Tabla 4.6: Navegador de proyecto Ventanas de versiones.
Las ventanas de detalle de versin son parecidas a las homni-
mas 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 co-
mo 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 construc-
cin de un proyecto y el administrador de JIRA ha congurado la
integracin entre JIRA y Bamboo, el usuario puede obtener informa-
cin relativa a los builds y los planes de builds de Bamboo relativos
a una versin de un proyecto directamente en la sub-ventana Builds
6
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 desea-
da, 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:
6
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 desea-
da, 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 seleccio-
nado. Esta ventana est disponible solo si en el proyecto seleccionado
se estn utilizando componentes.
Esta ventana presenta la lista de todos los componentes del pro-
yecto 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.
6
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 com-
ponente de la lista, utilizando el enlace en el nombre de componente,
la ventana Components otorga acceso a otras ventanas que propor-
cionan 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.
Issues Resumen de las incidencias del componente se-
leccionado agrupadas por estado. Resumen de
las incidencias del componente seleccionado no
resueltas agrupadas por asignatario, prioridad,
versin y componente.
Road Map Incidencias no resueltas del componente seleccio-
nado para las siguientes versiones de un proyecto.
Change Log Incidencias resueltas del componente selecciona-
do en precedentes versiones de un proyecto.
Popular Issues Incidencias no resueltas del componente seleccio-
nado ordenadas por popularidad.
Tabla 4.7: Navegador de proyecto Ventanas de componentes.
Las ventanas de detalle de componente son parecidas en presen-
tacin y funcionalidad a las homnimas ventanas del navegador de
proyecto con la diferencia que las primeras presentan datos ltrados
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) propor-
ciona informacin sobre los componentes del proyecto seleccionado.
Esta ventana presenta la lista de etiquetas (labels, vase 5.14) uti-
lizadas en las incidencias del proyecto seleccionado, ordenadas segn
el criterio especicado por el usuario en las opciones de conguracin
de la ventana. El usuario puede especicar las siguientes opciones
utilizando los controles presentes en la parte superior de la ventana:
6
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 uti-
lizar para determinar las etiquetas de las incidencias. Selec-
cionando Labels se utilizarn los campos de tipo etiquetas y
seleccionando Epic/Theme se utilizarn dichos campos para de-
terminarlas.
(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 in-
cidencias (vase 6.2) donde se ejecutar un ltro 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 Bam-
boo, 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 se-
leccionado, seleccionando el reporte Changeset (Figura 4.16).
(ii) Reporte de las estadsticas de actividad en Fisheye, seleccionan-
do 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 especicar el indicador que se
desea entre las siguientes posibilidades:
6
Figura 4.17: Navegador de proyecto Ventana Source.
(i) LOC, o Lneas de cdigo.
(ii) Files.
(iii) Commits.
o
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 princi-
palmente 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, uti-
lizan 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 ne-
cesitan sobre las incidencias que desean observar a lo largo de todo
su ciclo de vida, desde el momento de su creacin hasta el momen-
to en que terminan su recorrido por la mquina de estados del ujo
de trabajo al que estn sometidas. Estas herramientas permiten, en-
tre otras cosas, a) crear una incidencia rellenando un formulario que
recoge los campos asociados al tipo de incidencia escogido; b) organi-
zar las incidencias utilizando enlaces y etiquetas; c) buscar entre las
incidencias componiendo criterios de bsquedas exibles y creando l-
tros reutilizables; d) observar las incidencias abiertas suscribindose
a noticaciones 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 JI-
RA y operadores en la nomenclatura de esta gua, utilizarn la plata-
forma para trabajar sobre las incidencias que los usuarios han abierto.
A esta categora de usuarios JIRA ofrece una serie de herramientas
especcas que permiten, entre otras cosas, a) trabajar sobre una in-
cidencia movindola a travs de la red de estados denida en su ujo
de trabajo; b) organizar las incidencias a travs de los mecanismos de
1
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 con-
nes 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 exibi-
lidad a nivel de las polticas de seguridad se traduce por lo tanto en
exibilidad a la hora de perlar las responsabilidades de cada catego-
ra 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 organi-
zar el progresar de las labores a travs de bsquedas, ltros, ujos
de actividades y las herramientas de reporting de JIRA; por el otro
lado, participar activamente en las labores del equipo creando nue-
vas incidencias, asignando las incidencias existentes a los miembros
del equipo para repartir ecazmente 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 exibilidad
podra hacer sospechar a muchos usuarios que la riqueza de funciona-
lidad de una plataforma como JIRA tenga repercusiones negativas en
otros aspectos no menos importantes para la ecacia y la eciencia
del trabajo tales como la facilidad de utilizacin o el tiempo de apren-
dizaje requerido para convertirse en un usuario competente. Sorpren-
dentemente, 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 fundamen-
tal. En lugar de trasladar al usuario, a travs del interfaz de JIRA
1
,
las complejidades y la heterogeneidad de posibles escenarios distintos
procedentes de su elevada exibilidad, se tom la decisin de a) ho-
mogeneizar el interfaz; b) reducir al mnimo el nmero de ventanas de
la plataforma; c) trasladar la exibilidad de la plataforma al interfaz
utilizando ventanas que se rellenan dinmicamente.
El trabajo sobre una incidencia, por ejemplo, se efecta en una ni-
ca 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 ho-
1
As como a cualquier otro nivel en que tiene lugar una interaccin entre JIRA
y un sistema externo, incluso un ser humano.
:
5.1. Creacin de una incidencia
mogeneizacin de los perles 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 res-
ponsabilidad es de los administradores en el mbito de cada proyec-
to, 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 especcas 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 pri-
vilegios 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 ujo 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 fun-
cionalmente 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 inci-
dencias:
(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 unic el comportamiento de ambos controles y, ahora,
todos llevan a una nica ventana de creacin de incidencia, visible
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 gu-
ra, 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 congurados 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

Figura 5.3: Ventana de creacin de incidencia
actualizar automticamente para reejar la conguracin de campos
del tipo de incidencia escogido en el contexto del proyecto selecciona-
do. 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 , la ventana
de creacin de incidencia proporcionaba todos los campos previstos
por la conguracin 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 modicarse. Desde la introduccin de JIRA los usuarios
pueden personalizar la conguracin de campos de esta ventana aa-
diendo 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 conguracin de la ventana se efecta utilizando el formulario de
conguracin al que se accede utilizando el botn Congure 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 Conguracin de
campos
(i) All, si la ventana visualizar todos los campos.
(ii) Custom, si la ventana visualizar solo los campos escogidos por
el usuario.
6
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 inciden-
cia, desde JIRA 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
conrmacin de creacin de incidencia (como explicado en el prra-
fo 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 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 incidencia
2
, JIRA le enviar un correo electrnico.
Vase 5.4 para obtener ms informaciones sobre esta funcionali-
dad.
2
As como ocurre durante las dems operaciones sobre una incidencia.
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 inciden-
cia. 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 usua-
rios 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 grco 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.
8
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 ujo 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, opera-
ciones de actualizacin de los campos de la incidencia (Edit, Com-
ment, Attach les, etc.) y operaciones de organizacin de las inci-
dencias (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.
Figura 5.7: Men de acciones
La segunda categora de operaciones desciende del ujo de trabajo
de cada tipo de incidencia y de las operaciones de workow (transicio-
nes) que se puedan invocar en el estado corriente de una incidencia.
En el ujo de trabajo estndar de JIRA, para una incidencia en esta-
do Open, solo pueden ejecutarse las transiciones Start progress para
empezar a trabajar sobre la incidencia, Resolve para resolver de in-
mediato 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 ujos
de trabajos personalizados y asignarlos a determinados tipos de inci-
dencias. En Figura 5.6, por ejemplo, pueden verse los botones Back
to Todo y Back to In Progress asociados a las correspondientes transi-
ciones en un ujo de trabajo personalizado asociado a las incidencias
del tipo Bug de ese proyecto.
8o
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 plata-
forma el enlace a una incidencia por mail
3
:
(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
modicacin de una incidencia o de un comentario a una incidencia.
Para citar un usuario, es necesario efectuar las operaciones detalla-
das 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 pla-
taforma: 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 inciden-
cia 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 noticaciones.
4
Este botn est disponible solo si un servidor de envo de correo SMTP ha
sido congurado por el administrador de JIRA.
81
(iv) Eliminar usuarios con los cuales no se quiere compartir la in-
cidencia utilizando el control identicar 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 in-
cidencia
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 cheros 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 cheros, los cuales pue-
den ser de cualquier naturaleza, como formularios, documentacin
adicional o cheros de log de una aplicacin.
8:
5.5. Adjuntar cheros o capturas de pantallas a una incidencia
Si el formato del chero adjunto es un formato reconocido por
JIRA podr verse una vista previa del chero directamente en la
ventana de detalle de incidencias sin la necesidad de descargarlo pre-
viamente para abrirlo con una aplicacin local.
La posibilidad de adjuntar cheros est subordinada a que el admi-
nistrador 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 usua-
rio podr utilizar la funcionalidad Attach les y Attach screenshot.
Por defecto, adems, no es posible editar incidencias cerradas y, por
lo tanto, tampoco es posible aadir cheros 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 chero es necesario efectuar las siguientes ope-
raciones:
(i) Abrir la incidencia en la cual se desea adjuntar el chero.
(ii) Pulsar el botn Attach les 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 cheros a una incidencia
(iii) Seleccionar los cheros que se desean adjuntar
5
utilizando la
5
El tamao mximo del chero adjunto es establecido por el administrador
de JIRA y, por defecto, es de MB.
8
ventana de seleccin de cheros que aparece pulsando el botn
Choose File. Dependiendo del navegador que se est utilizando,
podra ser necesario repetir esta operacin por cada chero que
se desea adjuntar. El nombre de los cheros adjuntos no puede
contener ninguno de los caracteres detallados en Tabla 5.1.
Caracteres no permitidos
\ / " % : $ ? *
Tabla 5.1: Nombre de cheros adjuntos Caracteres no permitidos
(iv) Si se desea no adjuntar un chero seleccionado por error, es
suciente deseleccionar el control de tipo check-box que aparece
a la izquierda de sun nombre.
(v) Opcionalmente, insertar un comentario para ofrecer una des-
cripcin al chero adjunto rellenando el campo de texto Com-
ment. Se puede establecer un nivel de seguridad para el co-
mentario y restringir su visibilidad a un nico rol de proyecto
escogiendo el rol deseados en el men desplegable que se encuen-
tra 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 nalizar la operacin y adjuntar los
cheros seleccionados.
Despus de haber adjunto los cheros a la incidencia seleccionada,
JIRA ensear una vista previa en la ventana de detalle de la inciden-
cia, siempre que el administrador haya habilitado esta funcionalidad
de JIRA (??) y siempre que le formato del chero sea uno de los
formatos de imagen reconocido por JIRA
6
, 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 cheros sin
necesidad de descargarlos en el ordenador local, sobre todo cuando
el tamao de los cheros adjuntos es grande. Para acceder a la vista
de galera es suciente hacer click sobre la vista previa de cualquier
chero; en la vista de galera es posible navegar entre los cheros
6
Tales como: GIF, JPG, PNG, ZIP, etc.
8
5.6. Gestionar los cheros adjuntos
Figura 5.10: Vista previa de los cheros 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 cheros adjuntos a una incidencia
5.6 Gestionar los ficheros adjuntos
El menu desplegable a la derecha de la seccin de chero adjuntos,
ilustrado en Figura 5.12, permite gestionar los cheros adjuntos y
(i) Ordenar los cheros adjuntos por nombre y fechas.
(ii) Bajarse todos los cheros adjuntos en un archivo comprimido
de tipo ZIP.
(iii) Acceder a la ventana de gestin de cheros adjuntos en la cual
es posible eliminar los cheros que no se desean.
8
Figura 5.12: Menu de operaciones sobre cheros 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 cheros adjuntos de acuerdo a los criterios
deseados es necesario efectuar las siguientes operaciones:
(i) Abrir el men desplegable de gestin de los cheros adjuntos.
(ii) Escoger el criterio de ordenacin deseado: a) Sort By Name pa-
ra 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 cheros adjuntos, como las
galeras.
5.6.2 Acceder al contenido de adjuntos de tipo ZIP
Si un chero adjunto es un chero de tipo ZIP (como los cheros
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 cheros ZIP de JIRA (??).
86
Figura 5.13: Vista previa de un chero adjunto de tipo ZIP o JAR
5.6.3 Eliminar ficheros adjuntos
Para eliminar un chero adjunto de una incidencia es necesario efec-
tuar las siguientes operaciones:
(i) Acceder a la ventana de gestin de cheros adjuntos (Figura
5.14) utilizando el enlace Manage attachments (Gestiona che-
ros adjuntos) en el men de gestin de los cheros adjuntos (5.6
y Figura 5.12).
(ii) Eliminar los cheros adjuntos utilizando el icono papelera ( )
a la extrema derecha del registro correspondiente al chero a
eliminar.
Figura 5.14: Ventana de gestin de cheros adjuntos
5.6.4 Bajar todos los adjuntos en un archivo ZIP
Si una incidencia tiene ms que un chero adjunto y el usuario desea
bajrselos todos, JIRA ofrece la posibilidad de bajarse todos los ar-
chivos comprimidos en un nico archivo ZIP en lugar de obligar el
usuario a bajrselos de uno en uno.
Para bajarse todos los cheros adjuntos de una incidencia como
archivo ZIP es necesario abrir el men de gestin de los cheros ad-
juntos (5.6 y Figura 5.12) y seleccionar el elemento Download All.
8
5.6.5 Adjuntar una captura de pantalla
Attach screenshot (Adjuntar captura de pantalla) es una versin op-
timizada de la funcionalidad Attach les pensada para adjuntar cap-
turas de pantallas a una incidencia. La ventana para adjuntar cap-
turas de pantalla permite al usuario generar una captura de pantalla
y subirla a JIRA utilizando un applet Java sin necesidad de grabar
cheros 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 conrmacin 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 conrmacin para ejecutar un applet Java
Despus de haber conrmado que se desea ejecutar el applet pa-
ra adjuntar capturas de pantalla, aparecer la pantalla ilustrada en
Figura 5.16.
Utilizando el botn Paste es posible pegar en la ventana la cap-
tura de pantalla para sucesivamente adjuntarla a la incidencia. En el
campo File name es posible especicar el nombre del chero 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 cheros.
88
Figura 5.16: Ventana para adjuntar capturas de pantalla
El procedimiento para copiar en memoria una captura de la pan-
talla del cliente depende del sistema operativo utilizado:
(i) En Microsoft Windows puede utilizarse la combinacin de
teclas Alt + Print screen para capturar la ventana seleccio-
nada o la combinacin Ctrl + Alt + Print screen para cap-
turar la pantalla entera.
(ii) En Mac OS Xpuede 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 ocial.
8
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 seleccio-
nar 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 per-
miso Browse project para poder acceder al proyecto y a la incidencia.
Los comentarios, as como toda la informacin almacenada por JI-
RA, pueden ser protegido para que solo los usuarios autorizado puedan
verlos. Dependiendo de como el administrador haya congurado la
visibilidad de comentarios, podrn escogerse roles de proyecto y gru-
pos durante el establecimiento de la poltica de seguridad que protege
a un comentario, utilizando el men desplegable que aparece debajo
del formulario e identicable 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).
o
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 po-
sean los permisos requeridos pueden operar sobre un comentario. En
Figura 5.19 pueden verse los iconos correspondientes a las operaciones
de creacin de enlace, modicacin y borrado de comentario.
Figura 5.19: Iconos para operar sobre un comentario
5.7.1 Modificar un comentario
A veces es necesario modicar un comentario existente si, por ejem-
plo, es necesario corregir la informacin introducida o moderar un
comentario que no cumple con las polticas de la empresa. Tambin
es posible modicar la poltica de seguridad de un permiso y modicar
el valor del campo Viewable by.
El permiso requerido para modicar un comentario propio es el
permiso Edit own comments y para modicar cualquier comentario
se requiere el permiso Edit all comments.
Para modicar un comentario es necesario utilizar el control de
modicacin de comentario indicado con el icono de un lpiz a la de-
recha del comentario. Seleccionando esta operacin el usuario ser
enviado a una ventana parecida a la ventana de creacin de comen-
tario para que pueda aportar las modicaciones deseadas.
1
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 eli-
minacin de comentario, identicado 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 in-
troducida por otros usuarios. Los operadores, por ejemplo, pueden
utilizar los comentarios para colaborar con los dems usuario e com-
partir, por ejemplo, instrucciones para solucionar una incidencia.
Por esta razn es til poder disponer de un mecanismo para en-
lazar directamente a un comentario para poder almacenar una refe-
rencia a l y compartirla con otros usuarios a travs del correo electr-
nico, en una pgina web o con cualquier otro medio de comunicacin
electrnica.
JIRA soporta la creacin de permalinks hacia los comentarios uti-
lizando el icono de enlace que se encuentra a la derecha del comen-
tario 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 co-
mentario 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 rende-
rers. 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 especco a un campo en una conguracin de campos.
Las recientes versiones de JIRA proporcionan el wiki-style rende-
rer que permite formatear campos de texto libre (como los comenta-
rios) con efectos sosticados utilizando una notacin heredada de
Atlassian Conuence. Los campos para los cuales el administrador ha
:
5.8. Campos de texto formateado
congurado 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
modicaciones. El icono amarillo con un punto de interrogacin pro-
porciona 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 efec-
tos sosticados tales como:
(i) Efectos tipogrcos tales como fuente itlica, negrita, etc.
(ii) Creacin de ttulos de mltiple niveles.
(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 Efecto
anchor Crea un anchor en un punto especco de la pgina.
code Formatea un fragmento de cdigo. La macro formatea
Java, JavaScript, ActionScript, XML, HTML y SQL.
quote Formatea una citacin.
noformat Crea una seccin dentro de la cual el formateo wiki no
se aplica.
panel Crea un panel.
color Cambia el color del texto.
loremipsum Inserta prrafos de prueba.
html 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 si-
guiente:
{macro}
...
{macro}
Algunas macros, como la macro panel aceptan parmetros opcionales
que se especicarn 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:
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 len-
guajes (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 ujo de trabajo deter-
minado. En muchos casos de usos es til poder subdividir una tarea
en sub-tareas, cada una de las cuales puede ser gestionada indepen-
dientemente 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 inci-
dencia 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 em-
bargo el nivel de exibilidad de la conguracin 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 in-
cidencias de un proyecto como mucho tiene profundidad :. 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 adminis-
trador 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 en-
trar 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 expli-
cado anteriormente, la lista puede de tipos de sub-tareas puede ser
congurada por el administrador.
Figura 5.24: Ventana de creacin de sub-tarea
6
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
5.9.2 Gestin de sub-tareas
Las sub-tareas no dieren 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 ltrar las sub-
tareas, 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 echa permiten ordenar las sub-tareas,
movindolas arriba y abajo, segn los criterios establecidos por el
usuario. El segundo control, identicado con el icono de un engra-
naje, despliega el men de acciones (que puede verse en Figura 5.28)
que contiene las operaciones que es posible efectuar sobre una sub-
tarea. Ntese que el men de acciones contiene prcticamente todas
las operaciones disponibles sobre una incidencia, tanto las operaciones
comunes como las operaciones de ujo de trabajo.
En el panel Sub-tasks pueden verse las barras de progreso del traba-
jo sobre una incidencia se ilustra de forma grca el tiempo estimado
para la resolucin de una incidencia y el trabajo desempeado hasta
el momento.
A travs del control identicado con el icono + puede crearse r-
pidamente 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
8
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
5.9.3 Convertir una incidencia en sub-tarea
A veces es deseable modicar 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 for-
mulario para escoger el estado de la incidencia despus de la
conversin. En el caso no fuese necesario hacer esta conversin,
la ventana no aparecer.
1oo
5.9. Sub-tareas
(vi) En el caso en que el tipo de sub-tarea escogido requiriese cam-
pos 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 men-
saje informativo.
Figura 5.31: Formulario de conversin de campos para la conversin a
sub-tarea
(vii) Al nal del proceso, se visualizar la ventana de conrmacin
ilustrada en Figura 5.32. Pulsando el botn Finish se llevar
a cabo el proceso de conversin al nal del cual aparecer la
ventana de detalle de la incidencia.
Figura 5.32: Formulario de conrmacin 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 pa-
sos 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 ac-
tions.
1o1
(iii) Seleccionar el tipo de incidencia.
(iv) En el caso en que el estado de la sub-tarea a convertir no fue-
se 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 cam-
pos 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 venta-
na presentar un mensaje informativo.
(vi) Al nal del proceso, se visualizar una ventana de conrmacin
parecida a la ilustrada en Figura 5.32. Pulsando el botn Fi-
nish se llevar a cabo el proceso de conversin al nal 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 co-
piando 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 nece-
sita modicarse. 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) Ttulo.
(ii) Descripcin.
(iii) Usuarios al que se asign la incidencia.
(iv) Entorno.
(v) Prioridad.
(vi) Tipo de incidencia.
(vii) Seguridad.
(viii) Usuario que ha reportado la incidencia.
(ix) Componentes.
(x) Versiones afectadas.
1o:
5.10. Duplicar una incidencia
(xi) Resolucin para versiones.
(xii) Enlaces de incidencia.
(xiii) Ficheros adjuntos
(xiv) Proyecto.
Los campos copiados podrn, obviamente, modicarse 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 ope-
racin 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 modicarse el ttulo de la inci-
dencia. Por defecto, JIRA aade un prejo (??) 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 cheros adjuntos es posible elegir si
incluir estos cheros en la incidencia duplicada.
(vii) Finalizar la duplicacin de la incidencia pulsando el botn Crea-
te.
5.10.1 Crear un enlace a una incidencia duplicada
Puede ser deseable mantener constancia de las operaciones de du-
plicacin 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 dupli-
cacin de incidencias el administrador debe impostar la propiedad
jira.clone.linktype.name en el chero de conguracin 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.
1o
Cdigo 5.1 Nombre por defecto del enlace automtico a incidencias
duplicadas
jira.clone.linktype.name = Cloners
El tipo de enlace congurado 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 congurar adecuadamente la propiedad en cues-
tin.
5.10.2 Prefijo del ttulo de las incidencias duplicadas
Cuando se duplica una incidencia JIRA aade automticamente un
prejo al ttulo de la incidencia duplicada y, por defecto, el prejo
utilizado es CLONE -. El prejo utilizado puede elegirse modicando
la propiedad jira.clone.prefix en el chero de conguracin de JI-
RA, jira-application.properties, como ilustrado en el fragmento
de cdigo 5.2.
Cdigo 5.2 Prejo 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 inci-
dencia. Si se est duplicando una incidencia que contiene sub-tareas,
las sub-tareas podrn duplicarse tambin pero el prejo 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 exible de
estos mecanismos. Esta funcionalidad es habilitada y congurada por
el administrador de JIRA. El administrador puede denir los tipos de
1o
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 r y j:
r

j (5.1)
o la correspondiente inversa
1
entre j y r:
r

1
j (5.2)
otorga el mismo resultado: JIRA indicar la existencia de la relacin
en la ventana de detalle de r, y la existencia de la relacin
1
en
la ventana de detalle de j. Cuando el administrador crea un enlace
nuevo, entonces, es necesario denir 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 inci-
dencia, 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 rela-
ciones de duplicidad y dependencia. La relacin de duplicidad, por
ejemplo, puede ser denida por el administrador como r duplica j y j
es duplicada por r. El administrador podr denir, a travs de la con-
sola 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 r

j r es la
incidencia donde origina y j la incidencia donde termina la
relacin.
(ii) Seleccionar la operacin Link del men More actions y apare-
cer la ventana de creacin de enlace que puede verse en Figura
5.33.
7
Que pueden navegarse en ambos sentidos.
1o
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 ejem-
plo, 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 in-
cidencia y JIRA propondr una lista de incidencias, generada
dinmicamente, que satisfacen el criterio de bsqueda de acuer-
do al texto escogido por el usuario (Figura 5.35).
(v) Las incidencias pueden buscarse tambin utilizando un ltro de
bsqueda que el usuario haya denido (vase ??) en el buscador
1o6
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 dere-
cha 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 ltro
(vi) Puede insertarse un comentario al enlace creado insertando un
1o
texto en el control Comment.
(vii) Puede escogerse que tipo de visibilidad tendr el enlace esco-
giendo 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, identicado con el icono de un engranaje y el
control para aadir un enlace, identicado con un icono con el smbulo
+.
5.11.1 Gestionar los enlaces entre incidencias
El control de gestin de enlaces, identicado 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 identicados con echas y eliminar enlaces, utilizando
el control de eliminacin, identicado con el icono de basura.
Figura 5.38: Ventana de gestin de enlaces entre incidencias
1o8
5.12. Planicar las incidencias
5.12 Planificar las incidencias
JIRA permite planicar 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 conguraciones 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 ltros (??) 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 noticaciones
(??) 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 modi-
car el valor de este campo, un usuario debe tener el permiso Schedule
issues.
Un usuario puede modicar el campo Due date en el momento
de la creacin de una incidencia o, posteriormente, modicando una
incidencia existente.
5.12.1 Filtrar incidencias utilizando la fecha de resolu-
cin
Las herramientas de bsqueda y ltrado de incidencia de JIRA son
poderosas y permiten realizar bsquedas complejas utilizando cual-
quier 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 in-
cidencias y es posible realizar bsquedas simples o avanzadas. En
este captulo se detallar el mecanismo de bsqueda simple. Las bs-
quedas avanzadas aprovechan del lenguaje de query de JIRA que se
detallar en ??.
La seccin relativa al ltrado por fecha de resolucin del navega-
dor de incidencias puede verse en Figura 5.39. Debido a la naturaleza
del valor almacenado en este campo, JIRA permite realizar dos ti-
pos de bsquedas de forma fcil a travs de una interfaz de usuario
especializada:
1o
Figura 5.39: Seccin de ltrado 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 busca-
da, 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 ltrar las incidencias; llamando t
0
y t
1
los valores introducidos
por el usuario y r el valor del campo fecha de resolucin de una
incidencia, pueden realizarse las siguientes operaciones a travs del
interfaz de usuario de JIRA:
(i) Buscar las incidencias que satisfagan r = t
0
.
(ii) Buscar las incidencias que satisfagan r t
0
.
(iii) Buscar las incidencias que satisfagan r t
0
.
(iv) Buscar las incidencias que satisfagan t
0
r t
1
.
Los campos Due after y Due before se poblarn con los valores t
0
y t
1
de acuerdo con la bsqueda que se est deseando realizar. Para
realizar la bsqueda (ii), por ejemplo, habr que poner el valor t
0
en
el campo Due before; para realizar la bsqueda (iv), habr que poner
el valor t
0
en el campo Due after y el valor t
1
en el campo Due before.
La fecha puede especicarse 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 ltar las incidencias con r t
0
cuando la fecha de
resolucin es el 10 de Enero de 2011.
11o
5.12. Planicar las incidencias
Figura 5.40: Ejemplo de ltrado 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 t
0
.
(iii) Buscar las incidencias que habrn sobrepasado la fecha lmite
dentro de n das
8
.
(iv) Buscar las incidencias cuya fecha lmite est en el intervalo [t +
t
0
, t + t
1
] donde t es la fecha al momento de la bsqueda y t
0
y
t
1
son dos parmetros especicados 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 embar-
go, el usuario puede componer ms fcilmente el formulario utilizando
la ventana de seleccin (Figura 5.41) a la que se accede seleccionan-
do el icono identicado 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 especicar 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 valores
9
:
From =
To = 0
(5.3)
La bsqueda de tipo (ii) se obtiene utilizando los valores:
From =
To = nd
(5.4)
La bsqueda de tipo (iii) se obtiene utilizando los valores:
From = 0
To = nd
(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 =
To = nd
(5.6)
9
Con el smbulo se entiende que el campo se queda vaco.
11:
5.13. Proteger una incidencia
La bsqueda de tipo (iv) se obtiene utilizando los valores:
From = t
0
To = t
1
(5.7)
donde t
0
y t
1
pueden utilizar la notacin rwjdnh .m donde w
indica el nmero de semanas, d el nmero de das, h el nmero de
horas y m el nmero de minutos. 1w2d indicar, por ejemplo, una
semana y dos das en el pasado, ya que est prejado con el signo .
5.13 Proteger una incidencia
Los roles de proyecto y los esquemas de permisos permiten al adminis-
trador de denir polticas de seguridad con una resolucin muy na.
Sin embargo, en algunos casos de uso, no es suciente otorgar el per-
miso 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 ltros, 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, ltros, noticaciones, 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 mis-
mo 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
11
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 usua-
rios 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 diferen-
tes del mismo proyecto para usuarios distintos sino que puede ser de
ayuda a la hora de planicar 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 for-
ma ms sencilla consiste en planicar la resolucin de las incidencia
de forma manual: el jefe de equipo utilizar la segmentacin y la prio-
ridad 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 in-
cidencias 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 recursos
10
al
grupo de operadores dedicados al nivel de seguridad ms elevado.
10
La asignacin de una cantidad de recursos ms elevada podra traducirse en
11
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 condencial 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 in-
formacin 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 quisie-
ra utilizar JIRA para almacenar y tener constancia de informacin
condencial 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 po-
lticas 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 denicin 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 modicacin.
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 resul-
tara inaccesible para todo usuario del proyecto.
un nmero de operadores ms elevados e, incluso, en un horario extendido de
trabajo sobre las incidencias.
11
Para seleccionar el nivel de seguridad de una incidencia es ne-
cesario modicar el valor del campo Security level. En Figura 5.43
puede verse el men desplegable del campo Security level en la ven-
tana de modicacin de una incidencia. En este caso solo existen dos
Figura 5.43: Modicar 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 segu-
ridad 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 conrmado el nivel de seguridad de la inciden-
cia podr verse reejado 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.
11
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 modicar 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 in-
cidencias son los componentes y las versiones. Sin embargo, ninguno
de estos dos mecanismos se prestan a que los usuarios puedan or-
ganizar las incidencia de forma de acuerdo a los criterios que ellos
mismos establezcan: ambos son una caracterstica de un entero pro-
yecto 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 modicar
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 bs-
quedas y ltros 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 modicacin 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 ven-
tana de detalle.
118
5.14. Poner etiquetas a una incidencias
(ii) Seleccionar el control para gestionar etiquetas, identicado 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 etique-
tas que se desean aadir. Mientras se est tecleando una eti-
queta, 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 notication si se desea que
JIRA enve la noticacin de modicacin de incidencia a los
usuarios.
(v) Conrmar la modicacin 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 modicacin 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 ven-
tana de detalle.
(ii) Seleccionar el control para gestionar etiquetas, identicado 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 eti-
quetas que se desean borrar seleccionando con el ratn el control
de eliminacin de etiqueta, identicado con el icono , a la de-
recha de la etiqueta a borrar.
11
(iv) Seleccionar la checkbox Send update notication si se desea que
JIRA enve la noticacin de modicacin de incidencia a los
usuarios.
(v) Conrmar la modicacin 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 des-
cripcin 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 trac-
king 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 grca, 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 modicarse
posteriormente pero antes de que un usuario registre trabajo sobre la
1:o
5.15. Trabajar sobre una incidencia
incidencia. Si un usuario ha registrado trabajo en una incidencia, el
campo que podr modicarse ser el campo Remaining estimate.
La segunda barra, la barra naranja con la etiqueta Remaining,
indica el tiempo restante estimado para resolver la incidencia. Es-
te valor, t
r
es el valor del campo Remaining estimate y satisface la
condicin
t
r
= t
o
t
w
(5.8)
donde t
o
es la estimacin original (Original estimate) menos el trabajo
t
w
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:
T
r
= T
o
T
w
T
r
=
t
r
()
T
o
=
t
o
()
T
w
=
t
w
()
(5.9)
La incidencia cuyo panel Time tracking puede verse en Figura 5.48
tena T
o
= 4 d y T
w
= 1 d y, por lo tanto, un valor T
r
= 3 d.
La tercera barra, la barra verde con la etiqueta Logged, indica el
tiempo t
w
(o T
w
) que los operadores han registrado como trabaja-
do 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
1:1
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 conguracin 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 modicarse 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 modicarse 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 Remai-
ning estimate pueden modicarse despus de que el trabajo sobre una
incidencia haya empezado. Para mantener el comportamiento de las
antiguas versiones de JIRA el administrador puede congurar el time
tracking para funcionar en modalidad legacy en la cual el comporta-
miento de la plataforma emular el comportamiento de las versiones
antiguas de JIRA.
Los campos Original estimate y Remaining estimate estn por de-
fecto accesibles en la ventana de modicacin 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 con-
guraciones que haya establecido el administrador a nivel de esquema
de pantallas por tipo de incidencia y de pantallas de transiciones de
ujo de trabajo.
1::
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 des-
cripcin de las actividades realizadas. El log de actividad es una he-
rramienta 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 manteni-
do 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 mo-
mento en caso de duda, revisin o reapertura de una incidencia. Los
operadores se beneciarn de esta informacin para detectar las acti-
vidades que han resultado ms problemticas durante las resolucin
de las incidencias y ser una informacin valiosa a la hora de estimar y
planicar trabajos futuros. Los usuarios, por otra parte, podrn uti-
lizar 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 ujo de tra-
bajo, 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.
1:
Figura 5.51: Formulario de registro de trabajo
(iv) Introducir en el campo Time spent la cantidad de trabajo desem-
peada. La cantidad de tiempo puede introducirse en el formato
xw yd wh zm detallado en precedencia (??). Aadir sec-
cin sobre
el formato
de interva-
los de tiem-
po
(v) En el campo Date started introducir la fecha en la que se comen-
z la unidad de trabajo a registrar. La fecha puede seleccionarse
utilizando el control calendario al que se puede acceder selec-
cionando el control, identicado con el icono calendario, a la
derecha del campo.
Aadir sec-
cin sobre
el control
calenda-
rio
(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 t
r
= t
o
t
w
.
1:
Leave estimate unset
11
, para no introducir ninguna esti-
macin.
Use existing estimate of. . .
12
, para que el valor t
r
no se mo-
dique despus de la introduccin del registro de trabajo
corriente.
Set to. . . , para modicar manualmente la estimacin de
tiempo restante t
r
. 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 t
r
de la cantidad especicada. 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, identicado 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) Conrmar 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 introdu-
cida.
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 es-
tado 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 esti-
macin de tiempo necesario para la resolucin.
12
Este campo es disponible solo si la incidencia tiene una estimacin de tiempo
necesario para la resolucin.
1:
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 ujo 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 transi-
cin de estado de ujo de trabajo, el comportamiento de los campos
Comment y Viewable by. . . dependen de como el administrador haya
1:6
congurado la funcionalidad de time tracking. Por defecto, JIRA co-
piar 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 modicando el
registro de trabajo creado durante la transicin. Sin embargo es acon-
sejable solicitar al administrador la habilitacin de la funcionalidad
de copia de comentarios en el registro de trabajo para reducir el n-
mero 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 identicado con un icono parecido a (5.15.2)
se utiliza para crear un enlace permanente tal y como se detall en
??. Aadir sec-
ciones sobre
permalinks
5.15.5 Modificar un registro de trabajo
Un registro de trabajo puede ser modicado despus de su creacin
utilizando el control de modicacin, identicado con un icono lpiz
(5.15.2), del registro de trabajo a modicar. Un usuario necesita
el permiso Edit own work log para modicar un registro de trabajo
creado por l mismo y necesita el permiso Edit all work logs para
modicar los registros de los dems usuarios.
Seleccionando el control de modicacin de registro de trabajo
aparecer la ventana de modicacin. La ventana de modicacin es
una ventana parecida a la ventana Log work descrita en 5.15.2 y las
instrucciones para modicar el registro son parecidas a las instruccio-
nes de creacin de registros detalladas en la seccin citada. Tngase
en cuenta que en la ventana de modicacin no aparecer la opcin
Reduce by. . . del control Remaining estimate y, por lo tanto, se podr
ajustar la estimacin utilizando exclusivamente los dems controles.
1:
Despus de haber conrmado la modicacin de un registro de
trabajo el usuario ser llevado a la ventana de detalle de la incidencia
donde estarn reejadas las modicaciones aportadas al registro, par-
ticularmente en las estimaciones de la seccin Time tracking. Para
facilitar su identicacin, los registros de trabajo modicados sern
marcados con la etiqueta edited, como el registro ilustrado en Figura
5.54.
Figura 5.54: Registro de trabajo modicado
5.15.6 Eliminar un registro de trabajo
Un registro de trabajo puede ser eliminado despus de su creacin
utilizando el control de eliminacin, identicado con un icono basu-
ra (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, apa-
recer la ventana de eliminacin ilustrada en Figura 5.55. Esta venta-
na es muy parecida a la ventana de creacin de registro cuya funcio-
nalidad 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 t
r
con un subconjunto de las opciones detalladas en
5.15.2 y las siguientes opciones adicionales:
(i) Auto adjust: esta opcin compensa la estimacin t
r
aumen-
tando su valor con el valor t
w
del registro de trabajo a borrar.
El valor resultante, t
r
+ t
w
, ser el mismo valor que tena t
r
antes de crear el registro de trabajo.
(ii) Increase estimated time remaining by. . . : esta opcin permite
aumentar t
r
con un valor introducido por el usuario. La can-
tidad de tiempo puede introducirse en el formato xw yd wh zm
detallado en precedencia (??).
1:8
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 re-
ejadas las modicaciones 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-
cin sobre el
registro his-
trico 5.16 Mover una incidencia
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 conve-
niente 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 congu-
racin de dicho tipo (conguracin de campos, ujo de trabajo, etc.).
Podra darse la necesidad, entonces, de mover (convertir), las inci-
dencias que mientras tanto se hayan ido creando en el nuevo tipo de
incidencia.
1:
Una incidencia no puede simplemente moverse de un proyecto
a otro o cambiarse de tipo: cada proyecto puede tener un conjunto
de esquemas de conguracin 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 mo-
verse 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 inci-
dencia habr que rellenar los campos requeridos que estn vacos y
entonces invlidos en el esquema de destino.
Otra fuente de incompatibilidades entre conguraciones de proyec-
tos distintos son los estados personalizados de las incidencias. JIRA
permite denir estados personalizados y utilizarlos en los ujos de
trabajo asociados a un conjunto de tipos de incidencias en un pro-
yecto. Una incidencia de una proyecto podra tener un estado que no
est contemplado en el ujo de trabajo asociado al tipo de inciden-
cia 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 ope-
raciones:
(i) Seleccionar la incidencia que se desea mover.
(ii) Seleccionar la operacin Move en el men More actions.
1o
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 (Figu-
ra 5.57) en la cual podr seleccionar el nuevo estado para la
incidencia.
Figura 5.57: Asistente de migracin de incidencias Paso
(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 asis-
tente presentar la ventana de conrmacin (Figura 5.59) en la
11
cual se presentar un resumen de las operaciones que se llevarn
a cabo.
(vii) Conrmar la operacin pulsando el botn Move.
Despus de haber conrmado la operacin, JIRA mover la in-
cidencia al proyecto de destino aplicando todos los cambios especi-
cados 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 ujo 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.
1:
5.17. Modicar mltiples incidencias a la vez
JIRA permite efectuar operaciones bulk (operaciones masivas) so-
bre el resultado de una bsqueda y las operaciones permitidas son las
operaciones que ms comnmente se necesitan:
(i) Transiciones de ujo de trabajo.
(ii) Eliminaciones.
(iii) Migraciones.
(iv) Modicaciones.
Las operaciones masivas de transicin de ujo de trabajo permi-
ten, por ejemplo, resolver un conjunto de bsquedas: si, por ejemplo,
se efecta una labor por la cual un grupo de incidencias resulta re-
suelto o, por otro lado, se toma la decisin de no resolver un conjunto
de incidencias, se puede efectuar la transicin de ujo de trabajo co-
rrespondiente (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 inci-
dencias de un proyecto existente, esta funcionalidad permitir a los
jefes de proyecto de ltrar 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 modicacin permite
aplicar la misma modicacin 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 modicar
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 ltrado 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 Atar a glo-
bal.permission.
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-
1
cin efectuada (como detallado en las secciones anteriores): en el caso
de una operacin masiva de migracin, por ejemplo, el usuario debe-
r tener el permiso global Bulk move y el permiso de proyecto Move
issues.
5.17.1 Inhabilitar las notificaciones durante una opera-
cin 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 modicadas podr seleccionar la
opcin Send mail for this update (Figura 5.60): de esta forma las
operaciones que se ejecuten no enviarn correos de noticacin a los
usuarios suscritos.
Figura 5.60: Inhabilitar las noticaciones durante una operacin masiva
Es aconsejable inhabilitar el envo de noticaciones en las situa-
ciones en las cuales dicha noticacin no sea informativa: si, por
ejemplo, se estn migrando incidencias a un nuevo proyecto es proba-
blemente innecesario enviar los correspondientes correos de notica-
cin a los usuarios
13
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 re-
cuperar el grupo de incidencia sobre las cuales efectuar la ope-
racin 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 inciden-
cias modicadas
1
Figura 5.61: Operacin Bulk change en el men Tools
navegador de incidencias devuelve ms de una pgina de resul-
tados (Figura 5.61 izquierda), seleccionar si la operacin masiva
debera efectuarse sobre las incidencias en la pgina de resul-
tados corriente o en todas las incidencias recuperadas. Si la
bsqueda devuelve ms de 1ooo resultados, solo se podrn se-
leccionar las primeras 1ooo 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 ltro utilizado no es lo
Figura 5.62: Seleccin de las incidencias sobre las cuales efectuar la
operacin masiva
sucientemente no, 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
1
efectuar (Figura 5.63).
Figura 5.63: Seleccin del tipo de operacin masiva
Las dems operaciones a efectuar dependern del tipo de opera-
cin 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 noticacin (5.17.1) y la conrmacin de la operacin
(Figura 5.64). Despus de la conrmacin, JIRA eliminar todas las
Figura 5.64: Conrmacin de una eliminacin masiva
incidencias seleccionadas.
16
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 ujos de trabajo de los tipos de incidencias seleccionados en
el proyecto de destino.
(iv) Seleccin de valores para campos obligatorios y campos invli-
dos.
(v) Conrmacin 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 inci-
dencias 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 mi-
gracin de proyecto, las sub-tareas se movern siempre en el proyecto
especicado 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 nal (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
1
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 coordena-
das. Como en el caso de la operacin de migracin de una inciden-
cia (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 ex-
cluidas 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
18
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 ujo 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 conguracin de
campos para el tipo de incidencia de destino escogido (Figura 5.68).
Para cumplir con los requerimientos de las conguraciones 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 obliga-
torios 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, JI-
RA proporcionar un men desplegable con el cual el usuario podr
escoger uno de los posibles valores vlidos para el campo en cuestin:
(i) Componente.
(ii) Versin afectada.
(iii) Versin de resolucin. check names
(iv) Campos personalizados de tipo Version-picker.
Es importante subrayar que, en los campos de tipo versin, ser po-
sible escoger exclusivamente versiones que todava no se hayan ar-
chivado. En el caso se necesitase utilizar estos valores ser necesario add index
des-archivar la versin requerida, efectuar la migracin masiva de in-
cidencias y volver a archivar la versin.
1
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 ten-
drn 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 conguracin de salida y obligatorio en la conguracin de destino
ya que podrn existir incidencias que tengan este campo vaco e inci-
dencias con este campo valorizado. En estos casos, el usuario podr
decidir si actualizar todas las incidencias con el nuevo valor o man-
tener el valor antiguo en las incidencias que lo tengan vlido: para
mantener los valores antiguos vlidos para un campo es necesario se-
leccionar el check-box Retain que aparece en la ltima columna en la
ventana de actualizacin de campos de Figura 5.68. Este campo es-
tar 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 pro-
porcionar una ventana de conrmacin 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) Workow: ujo de trabajo de destino y nuevo estado nal de
destino.
(iii) Updated elds: nuevos valores para los campos actualizados.
(iv) Removed elds: campos eliminados porque no vlidos en la con-
guracin de campos de destino.
En Figura 5.69 puede verse una ventana de conrmacin de ejem-
plo 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 conrmado la operacin JIRA migrar todas las
incidencias seleccionadas efectuando las transformaciones especica-
das en el asistente de migracin.
5.17.5 Operacin masiva de modificacin
La operacin de modicacin masiva permite modicar un conjunto
de campos de un grupo de incidencias a la vez. Esta operacin es
1o
Figura 5.69: Ventana de conrmacin de una migracin masiva
11
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 modicacin masiva
Campo Condicin
Versin afectada Proyecto con versiones.
Permiso Edit Issue.
Campo visible en toda conguracin asociada
al campo.
Usuario asignado Permiso Assign issue.
al campo.
Comentario Permiso Comment issue.
al campo.
Componentes Proyecto con componentes.
al campo.
Permiso Edit issue.
Fecha lmite Campo visible en toda conguracin asociada
al campo.
Permiso Edit issue.
Permiso Schedule issue.
Versin de resolucin Proyecto con versiones.
al campo.
Permiso Edit issue.
Tipo de incidencia Permiso Edit issue.
Prioridad Campo visible en toda conguracin asociada
al campo.
Permiso Edit issue.
Reporter Campo visible en toda conguracin asociada
al campo.
Permiso Edit issue.
Permiso Modify reporter.
Contina en la siguiente pgina
1:
Campos actualizables en una modicacin masiva
Campo Condicin
Nivel de seguridad Campo visible en toda conguracin asociada
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
modicando incidencias cerradas ser que el ujo de trabajo de las
incidencias que se desea modicar permita la modicacin de inci-
dencias cerradas.
Los siguientes campos no podrn modicarse con una operacin
masiva:
(i) Ficheros adjuntos.
(ii) Ttulo.
(iii) Descripcin.
(iv) Entorno.
(v) Proyecto
14
.
(vi) Resolucin
15
. add reference
to bulk.work-
ow.transition
Despus de haber seleccionado las incidencias para una operacin
de modicacin 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 modicar y modicacin de su valor.
(ii) Revisin de los cambios y conrmacin 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 ujo de trabajo para un grupo de inciden-
cias con una operacin masiva de transicin de ujo de trabajo como detallado
en ??
1
La seleccin de campos a modicar (i) se efecta en la ventana de
modicacin 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 modicar en el grupo de incidencias seleccionadas. El
usuario puede seleccionar los campos a modicar utilizando el check-
box 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
modicacin puede utilizarse el control descrito en 5.17.1 y visible
en gura para decidir si enviar una noticacin de modicacin a los
usuarios.
Despus de haber modicado todos los campos que se desean mo-
dicar y pulsado el botn Next JIRA llevar el usuario a la ventana
de conrmacin donde puede verse un resumen de las modicaciones
que se efectuarn. En Figura 5.71 puede verse un ejemplo de venta-
na de modicacin masiva en la cual se detalla la actualizacin del
campo Nivel de seguridad de las incidencias al valor Silver.
Pulsar el botn Conrm se conrmar la operacin y JIRA apli-
car las modicaciones 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) Modicacin de un campo.
(ii) Subida de un chero adjunto.
(iii) Creacin de un enlace entre incidencias.
(iv) Eliminacin de un comentario.
(v) Eliminacin de un registro de trabajo.
(vi) 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.
1
5.18. Registro histrico de cambios de una incidencia
Figura 5.70: Ventana de modicacin de campos en una operacin de
modicacin masiva
1
Figura 5.71: Ventana de modicacin de campos en una operacin de
modicacin masiva
(ii) La hora en la que se ha realizado el cambio.
(iii) Si el cambio es la modicacin de un campo, los valores del
campo antes y despus de la modicacin.
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.
16
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 en-
lace entre aplicaciones, establecido por el administrador de sistemas,
establece una relacin de conanza entre las dos aplicaciones relacio-
nadas 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 venta-
na de detalle de una incidencia, que presenta informacin procedente
de FishEye.
En las siguientes secciones se detallarn las funcionalidades opcio-
nales 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 dis-
tintas.
(ii) Creacin de enlaces entre incidencias y pginas de Conuence.
(iii) Creacin de enlaces entre incidencias y recursos identicados
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.
1
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 botn
17
Remote JIRA issue en la ventana de crea-
cin de enlaces ente incidencias.
(iii) Opcionalmente
18
, efectuar el procedimiento de login en la ins-
tancia remota de JIRA haca la cual se desea establecer un en-
lace entre incidencias.
(iv) Si el administrador ha congurado mltiples enlaces de aplica-
cin, 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 identicador de la incidencia que se desea enla-
zar
19
.
(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 conguracin 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
congurado 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 estable-
cido por lo menos un enlace con una instancia remota de JIRA.
18
Este paso ser necesario solo si el administrador de JIRA ha congurado 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 identicadores.
Es necesario, por lo tanto, conocer exactamente el identicador de la incidencia a
enlazar.
18
5.19.2 Enlaces a pginas de Confluence
Como explicado en 5.19.1, JIRA puede integrarse con otros produc-
tos de Atlassian y actuar como hub, agregando y manejando informa-
cin procedente de distintas fuentes. Conuence, 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 Conuence (y vice versa). Esta funcio-
nalidad estar disponible solo si el administrador ha establecido un
enlace de aplicaciones entre JIRA y por lo menos una instancia de
Conuence.
Para enlazar una incidencia a una pgina de Conuence es nece-
sario efectuar las siguientes operaciones:
(ii) Seleccionar el botn
20
Conuence Page en la ventana de crea-
cin de enlaces ente incidencias.
(iii) Si el administrador ha congurado mltiples enlaces de aplica-
cin a instancias de Conuence, ser necesario seleccionar la
instancia de Conuence remota que se desea utilizar en el men
desplegable Server.
(iv) Especicar la pgina de Conuence que se desea enlazar como
explicado a continuacin.
(v) Utilizar los dems pasos del procedimiento detallado en 5.11
Para especicar la pgina de Conuence que se desea enlazar, es
necesario utilizar uno de los siguientes mtodos:
(i) Introducir el URL
21
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 ltrar los resultados de bsqueda
utilizando los criterios especicados.
20
Dicho control solo estar disponible si el administrador de JIRA ha estable-
cido por lo menos un enlace con una instancia Conuence.
21
El URL tiene que ser calicado: http://conf-server/display/etc/etc.
1
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 Conuence 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 inciden-
cia es un contenido genrico identicado 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 con-
guracin, c) documentacin de APIs.
Para enlazar una incidencia a un recurso identicado 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 infor-
macin relativa a sus revisiones de Crucible y, por lo tanto:
(i) Examinar el mensaje de commit.
(ii) Examinar la lista de les en el commit.
(iii) Examinar las diferencias y la historia de cada le.
(iv) Acceder a cada le.
(v) Crear una revisin de Crucible.
(vi) Ver el estado de una revisin de Crucible.
1o
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 revi-
siones 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 informa-
cin 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) Examinar el mensaje de commit.
(ii) Examinar la lista de les en el commit.
(iii) Examinar las diferencias y la historia de cada le.
(iv) Acceder a cada le.
(v) Crear una revisin de Crucible.
(vi) Ver el estado de una revisin de Crucible.
Las incidencias se relacionan con las incidencias buscando en el
mensaje de commit el identicador de la incidencia. La expresin
regular con la cual se efecta esta bsqueda es la siguiente:
11
(^|[^a-zA-Z0-9-])
Para que se relacionen correctamente incidencias e commits es nece-
sario, 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 o y 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 chan-
gesets de FishEye de la incidencia seleccionada, como ilustrado en
Figura 5.74.
Figura 5.74: Incidencia Changesets de FishEye
1:
5.20. Observar y votar una incidencia
5.19.6 Builds de Bamboo
En la ventana de detalle de la incidencia es posible obtener infor-
macin 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 relacio-
nados, 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 co-
municacin 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 inci-
dencia 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 noticaciones
de actualizacin de la incidencia. Cada vez que la incidencia sea
modicada, siempre el proyecto est congurado con un esquema de
noticacin, los usuarios recibirn los correos electrnicos generados
por los eventos de modicacin 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
1
Figura 5.75: Incidencia Builds de Bamboo
Figura 5.76: Panel de Personas en la ventana de detalles de incidencias
1
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; posi-
cionando 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 pulsan-
do el enlace el usuario podr eliminar instantaneamente el voto a la
incidencia seleccionada. El mismo mecanismo se utiliza para obser-
var 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 noticaciones.
Un usuario que tenga el permiso Manage watcher list podr uti-
lizar la ventana de gestin de Watchers para modicar la lista de
usuarios que estn observando la incidencia, aadiendo o eliminando
1
Figura 5.78: Ventana de gestin de Watchers de una incidencia
usuarios de la lista de suscritos.
16
6
Buscar y ltrar incidencias
JIRA proporciona herramientas para la bsqueda y el ltrado de in-
cidencias poderosas y fcil de utilizar. Las dos herramientas de bs-
queda proporcionadas por la plataforma son la bsqueda rpida y el
navegador de incidencias. La bsqueda rpida permite efectuar bs-
quedas 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 inter-
faz grca (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 inciden-
cias 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 construc-
cin 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 l-
gica que concatena todos los criterios con el operador (and). Si,
por ejemplo, se selecciona para el estado : el valor Open (Abierta) y
para la resolucin : el valor Wont x (No se resolver) en la interfaz
del navegador, la query resultante ser
(: = Open) (: = Won
t x) (6.1)
que, probablemente, no es la query deseada y devolver casi siempre
ningn registro. Si el usuario desease ejecutar la query
(: = Open) (: = Won
t x) (6.2)
1
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 ltros
(??) 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 en-
lace Issues de la barra de herramientas de JIRA. Por defecto, el na-
vegador de incidencias se abre en la ltima bsqueda o ltro 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 denir criterios de bsqueda de
forma sencilla utilizando una intuitiva interfaz grca. La parte iz-
quierda de la ventana ofrece un conjunto de controles que, depen-
diendo del tipo de campos asociados, permiten escoger o introducir
los valores con los cuales se desea ltrar las incidencias. Los controles
estn organizados en paneles que dividen los controles en catego-
rias formadas por controles anes. Los paneles disponibles en el
navegador de incidencias son los siguientes:
(i) Panel principal de bsqueda.
(ii) Components/Versions.
(iii) Issue attributes.
(iv) Dates and times.
(v) Work ratio.
(vi) Custom elds.
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 j
i
, i [0, n] el conjunto de
18
6.1. Bsquedas simples
fragmentos de query generados por cada panel, la query resultante
ejecutada por JIRA ser:
j
0
j
1
j
n
(6.3)
En general, mltiples controles dentro del mismo panel tambin ge-
nerarn 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 :
i
, i [0, n] son los estados
seleccionados, JIRA crear el fragmento de query correspondiente al
criterio:
: :
i
, i [0, n] (6.4)
Este criterio, conceptualmente, equivale a la siguiente proposicin:
(: = :
0
) (: = :
1
) (: = :
n
) (6.5)
6.1.1 Panel principal de bsqueda
El panel principal de bsqueda (i), ilustrado en Figura 6.1 (izquier-
da), ofrece como funcionalidad el ltrado de incidencias por proyecto,
por tipo de incidencia y por palabra clave en algunos campos estn-
dar 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) Ttulo.
(ii) Descripcin.
(iii) Comentarios.
(iv) Entornos.
La seleccin de mltiples campos de bsqueda c
i
, i [0, n] durante
la bsqueda de una cadena r se traduce en una query del tipo:
r c
i
, i [0, n] = (c
0
= r) (c
1
= r) (c
n
= r) (6.6)
y, por lo tanto, JIRA devolver las incidencias en las cuales almenos
uno de los campos seleccionados satisfaga el ltro de bsqueda.
Los controles Project y Issue type permiten seleccionar el proyec-
to y el tipo de incidencias que se desean ltrar. Estos dos com-
ponentes permiten efectuar selecciones mltiples (que indicaremos
1
Figura 6.1: Paneles de bsqueda del navegador de incidencias 1
j
i
, i [0, n] y t
i
, i [0, :]) entre los valores propuestos y los
criterios generados sern respectivamente
j j
i
, i [0, n] = (j = j
0
) (j = j
n
) (6.7)
y
t t
i
, i [0, :] = (t = t
0
) (t = t
m
) (6.8)
Esto signica que JIRA devolver las incidencias que pertenezcan a
uno de los proyectos seleccionados
1
y cuyo tipo sea uno de los tipos
escogidos
2
.
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.
16o
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):
r c
i
, i [0, n] j j
i
, i [0, /] t t
i
, i [0, :] =
((c
0
= r) (c
n
= r)) ((j = j
0
) (j = j
k
))
((t = t
0
) (t = t
m
)) (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 reejen 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 bs-
queda para reejar 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 ver-
siones. El panel proporciona un conjunto de controles, Fix for, Com-
ponents y Aects versions, que permiten efectuar bsquedas ltrando
por lo campos asociados a los controles. Los controles mencionados
161
Figura 6.3: Paneles de bsqueda del navegador de incidencias
aparecern cuando se est efectuando una bsqueda en proyectos que
posean informacin asociada a los campos en cuestin: si un proyec-
to est asociado con un esquema de conguracin de campos que no
prev la utilizacin de los campos de versin para ningn tipo de inci-
dencias, los controles correspondientes no aparecern en el navegador
de incidencias.
Los controles Fix for y Aects versions permiten ltrar las inci-
dencias utilizando las versiones especicadas en la lista y los siguientes
valores:
(i) Any: Cualquier valor.
(ii) No version: Incidencias que no especiquen ningn valor para
este campo.
(iii) Unreleased version: Incidencias cuyo campo especique una ver-
sin que no haya sido entregada.
El control Components permiten ltrar las incidencias utilizando
los componentes especicados 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
16:
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 ltrar las inci-
dencias utilizando los siguientes campos:
(i) Reporter: usuario que ha reportado la incidencia.
(ii) Assignee: usuario asignado a la incidencia.
(iii) Status: estado de la incidencia.
(iv) Resolutions: resolucin de la incidencia.
(v) Priorities: prioridad de la incidencia.
(vi) Labels: etiquetas de la incidencia.
Los campos Reporter y Assignee tienen un funcionamiento muy
similar y permiten ltrar 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 nin-
gn reporter o no est asignada a ningn usuario.
(iii) Current user: El usuario que est efectuando la bsqueda.
(iv) Specify user: El usuario especicado.
(v) Specify group: El grupo especicado.
Figura 6.4: Navegador de incidencias Campos Reporter y Assignee
Si se selecciona la opcin Specify user o Specify group, el usuario po-
dr especicar el usuario o el grupo con el cual ltrar introducindolo
en el campo de seleccin de usuario o grupo debajo del control, co-
mo ilustrado en Figura 6.5. Los campos de seleccin de usuarios
y grupos de JIRA son campos de textos que, segn el usuario va
16
Figura 6.5: Navegador de incidencias Campos Reporter y Assignee
tecleando el nombre de la entidad, van sugiriendo al operador los po-
sibles nombres que satisfagan el texto insertado hasta el momento. Add section
to user picker
elds
Si se preere, 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 identicado 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 prio-
ridades denidos 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 cam-
po contenga uno de los valores escogidos en la lista.
El control Labels es un campo de texto libre que permite ltrar
las incidencias especicando las etiquetas a buscar. Un mtodo alter-
nativo 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 (dere-
cha), permite ltrar las incidencias utilizando un grupo de controles
asociados a los correspondientes campos de tipo fecha:
(i) Fecha de creacin.
(ii) Fecha de ltima actualizacin.
(iii) Fecha lmite de resolucin.
(iv) Fecha 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:
16
(i) Un control, llamado . . . After, que acepta una fecha absoluta.
(ii) Un control, llamado . . . Before, que acepta una fecha absolu-
ta.
(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 idn-
tico al funcionamiento del grupo Fecha lmite de resolucin, cuyo fun-
cionamiento se detall en 5.12.1 y que se resume a continuacin. Update 5.12.1
to reect the
existence of this
chapter
Los controles del tipo . . . After y . . . Before aceptan fechas
absolutas y pueden utilizarse para efectuar bsquedas por valores exac-
tos; llamando t
0
y t
1
los valores introducidos por el usuario, r
a
el
campo . . . After, r
b
el campo . . . Before y r el valor del cam-
po asociado al grupo de controles en cuestin, pueden realizarse las
siguientes bsquedas:
(i) Buscar las incidencias que satisfagan r = t
0
, poniendo:
r
a
= r
b
= t
0
(6.10)
(ii) Buscar las incidencias que satisfagan r t
0
, poniendo:
r
b
= t
0
(6.11)
(iii) Buscar las incidencias que satisfagan r t
0
, poniendo:
r
a
= t
0
(6.12)
(iv) Buscar las incidencias que satisfagan t
0
r t
1
, poniendo:
r
a
= t
0
r
b
= t
1
Los controles From y To permiten hacer bsquedas por intervalos
temporales relativos a la fecha actual. Las bsquedas que se pue-
den efectuar son las mismas detalladas en los elementos de la lista
precedente con la diferencia que los tiempos t
0
y t
1
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 Add section
about the
relative time
format.
tiempo indicada es relativa a un instante en el futuro o en el pasado:
16
un campo con el tiempo positivo (con el signo +) indicar un instan-
te 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 cam-
pos con fechas absolutas como para los campos con fechas relativas:
los asistente se podrn abrir utilizando el control identicado con el
icono calendario a la derecha del campo que se desea modicar.
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 fe-
cha relativa son ventanas que ofrecen varias opciones intuitivas para
rellenar los campos From y To utilizando opciones tales como:
(i) Fecha anterior al instante especicado.
(ii) Fecha posterior al instante especicado.
(iii) Fecha en el intervalo especicado.
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 rea-
lizado
El panel de bsqueda por porcentaje de trabajo realizado (v), ilustra-
do en Figura 6.3 (derecha), permite ltrar las incidencias utilizando
como criterio el porcentaje de trabajo realizado:
n =
n
r
n
t
100 (6.13)
donde n
r
es el trabajo realizado y n
t
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
n = n
0
, poniendo:
n
min
= n
max
= n (6.14)
(ii) Bsqueda de incidencias con porcentaje de trabajo realizado
n n
0
, poniendo:
n
max
= n (6.15)
(iii) Bsqueda de incidencias con porcentaje de trabajo realizado
n n
0
, poniendo:
n
min
= n (6.16)
(iv) Bsqueda de incidencias con porcentaje de trabajo realizado
n
0
n n
1
, poniendo:
n
min
= n
0
n
max
= n
1
6.1.6 Panel de bsqueda por campos personalizados
El panel de bsqueda por campos personalizados (v), ilustrado en
Figura 6.3 (derecha), permite ltrar las incidencias utilizando los
campos personalizados que el administrador haya congurado 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
16
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, de-
pender del tipo de campo personalizado que se haya escogido. add documenta-
tion about JI-
RA eld types
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 utilizan-
do todos los criterios disponibles a travs de una interfaz grca 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 na-
vegador 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 grco 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 cam-
biar algn operador lgico), el usuario podr beneciarse del interfaz
grco de bsqueda simple para construir el esqueleto de la consulta
y pasar al interfaz grco de bsqueda avanzada para modicar ma-
nualmente 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 modicaciones nece-
sarias 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 in-
terfaz de bsqueda simple es la siguiente: ltrar las incidencias que
han sido creadas en la ltima semana o cuya fecha de nalizacin
haya pasado desde hace ms de 1 das. Esta bsqueda contiene dos
criterios:
(i) C
c
= (fecha de creacin 7 d)
(ii) C
d
= (fecha de nalizacin 15 d)
168
juntados con el operador lgico (or): C
c
C
d
. A pesar de no
poderse expresar la consulta C
c
C
d
con el interfaz grca, el usuario
podr beneciarse de la interfaz de bsqueda simple para crear los
criterios C
c
y C
d
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

C
c
y
fecha de nalizacin 15 d

C
d
(6.17)
La modicacin que hay que aplicar a la query precedente para obte-
ner la query que se necesita es simplemente el operador lgico que
les relaciona:
fecha de creacin 7 d

C
c
o
fecha de nalizacin 15 d

C
d
(6.18)
es decir, simplemente sustituir con . Para modelar la query 6.17 el
usuario pondr entonces los datos siguientes en el interfaz de bsqueda
simple:
t
c
(from) = 7 d
t
d
(to) = 15 d
(6.19)
como se ilustra en Figura 6.7. Para modicar la query y obtener
la query 6.18 el usuario podr efectuar la bsqueda
3
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

C
d
and
created 7 d

C
c
(6.20)
El usuario podr modicar 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.
16
Figura 6.7: Criterio de bsqueda de ejemplo.
Figura 6.8: Criterio de bsqueda de ejemplo en el interfaz de bsqueda
avanzada.
1o
Figura 6.9: Modicacin del criterio de bsqueda de ejemplo en el
interfaz de bsqueda avanzada.
de bsqueda avanzado, como puede apreciarse en gura, 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 modicada manualmente
puede ser imposible de expresarse a travs del interfaz grco de
bsqueda simple y, por lo tanto, si se vuelve a esta interfaz despus
de haber modicado manualmente una query JIRA podr informar
el usuario de este problema con un mensaje parecido al ilustrado en
Figura 6.10.
Figura 6.10: Modicacin 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.
11
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 ltros, 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 trin-
gulo negro () 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, po-
drn as ser compartidos con usuarios externos a travs de un enlace
que podr enviarse por correo o utilizarse en otras pginas web. Pa-
ra crear un permalink a la bsqueda corriente es necesario utilizar
1:
6.2. El navegador de incidencias
el control identicado con un icono parecido a y proceder como
explicado en ??. Aadir sec-
ciones sobre
permalinks
6.2.2 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 in-
cidencias seleccionando el men Actions, parecido al men de acciones
de la ventana de detalle de incidencia e identicado 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 parme-
tros tales como los permisos del usuario, la habilitacin de algunas
caractersticas de JIRA y los ujos de trabajos asociados a cada tipo
de incidencia.
El men Views (Figura 6.13, derecha), identicado con el icono
ojo en la esquina superior izquierda del navegador de incidencias,
permite operar sobre el conjunto de resultados devueltos por la bs-
queda. Las operaciones disponibles en este men se han resumido en
Tabla 6.2.
El men Tools del navegador de incidencias (Figura 6.13, izquier-
da) permite efectuar operaciones masivas, como explicado en 5.17,
y para congurar las columnas utilizadas en el navegador de inciden-
cias
4
, 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) visualiza-
dos
5
.
4
Las columnas conguradas 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 cam-
pos de tipo chero (como las imgenes) o los campos de agregacin (cuyo nom-
bre empieza por ) no son campos que pueden ordenarse.
1
Figura 6.12: Men Actions de una incidencia en el navegador de
incidencias.
Figura 6.13: Men Actions y Tools del navegador de incidencias.
1
6.2. El navegador de incidencias
Acciones en el men Actions
Accin Descripcin
Start progress Comenzar a trabajar sobre una incidencia po-
niendo su estado a In progress (En progreso).
Resolve issue Resolver una incidencia poniendo su estado a Re-
solved (Resuelta).
Close issue Cerrar una incidencia poniendo su estado a Clo-
sed (Cerrada).
Reopen issue Volver a abrir una incidencia poniendo su estado
a Reopened.
Edit Modicar una incidencia.
Assign Asignar una incidencia.
Assign to me Asignar una incidencia a s mismo.
Comment Aadir un comentario a la incidencia.
Log work Registrar trabajo sobre la incidencia.
Attach le Aadir un chero adjunto a la incidencia.
Attach screenshot Aadir una captura de pantalla a la incidencia.
Voters Consultar la lista de usuarios que han votado la
incidencia.
Add vote Votar la incidencia.
Watch issue Observar la incidencia.
Stop watching Dejar de observar la incidencia.
Watchers Consultar la lista de usuarios que estn obser-
vando la incidencia.
Create sub-task Crear una sub-tarea en la incidencia.
Convert to issue Convertir en incidencia.
Convert to sub-task Convertir en sub-tarea.
Move Mover la incidencia.
Link Crear un enlace a la incidencia.
Clone Clonar la incidencia.
Labels Modicar las etiquetas de la incidencia.
Delete Borrar la incidencia.
Tabla 6.1: Acciones en el men Actions en el navegador de incidencias.
1
Acciones en el men Views
Accin Descripcin
Printable Visualiza los resultados en una pgina con los
campos actualmente congurados.
Ful l content Visualiza los resultados en una pgina inclu-
yendo todos los datos estndar de las inci-
dencias.
XML Visualiza los resultados en XML. Vase 9.3.
RSS (Issues) Un feed RSS v. .o con las incidencias. Vase
9.2
RSS (Comments) Un feed RSS v. .o con los comentarios a las
incidencias. Vase 9.2
Word Exporta las incidencias en un documento Mi-
crosoft Word. Vase 9.4
Excel (All elds) Exporta los campos estndar de las inciden-
cias en un documento Microsoft Excel. Vase
9.5
Excel (Current elds) Exporta los campos actualmente congura-
dos de las incidencias en un documento Mi-
crosoft Excel. Vase 9.5.
Charts Genera un grco con los resultados de la
bsqueda. Vase 9.6.
On dashboard 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 suciente 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 echa
hacia arriba () a la derecha del nombre del campo. Para invertir el
criterio de ordenamiento es suciente pulsar una segunda vez sobre el
mismo campo: los datos se cargarn con el ordenamiento descendiente
y se visualizar una echa hacia abajo () a la derecha del nombre
del campo.
En Figura 6.11, por ejemplo, puede verse la ventana del navega-
dor de incidencias con los datos ordenados de forma descendiente por
el campo Key (Clave).
16
6.3. Congurar el navegador de incidencias
6.2.4 Visualizar las incidencia
Desde la ventana del navegador de incidencias, el usuario puede acce-
der 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 supe-
rior 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 i-
sima de un conjunto de n resultados (8 de en la ventana de
ejemplo).
(iii) Permiten navegar a las dems incidencias utilizando los contro-
les de navegacin identicados con tringulos hacia arriba ()
y hacia abajo ().
Si el usuario decidiera o necesitara volver al navegador de inciden-
cias, 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) es-
pecicando:
(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 nave-
gador de incidencias afectan tambin el comportamiento de algunas
operaciones del men Views (6.2) utilizadas para generar una repre-
sentacin alternativa de los resultados de una bsqueda. Por otro
1
lado, como explicado en 5.17, una de las opciones de seleccin de
incidencias durante una operacin de modicacin masiva es la selec-
cin de una pgina de resultados. Por estas razones, estos parmetros
de conguracin 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 conguracin del navegador de incidencia se determina nave-
gando una jerarqua de conguraciones, ilustradas en Figura 6.15: la
conguracin que queda establecida es la primera conguracin que
JIRA encuentra a partir del nivel ms bajo de la jerarqua. Por lo tan-
Figura 6.15: Jerarqua de conguracin del navegador de incidencias.
to, si un usuario ha establecido una conguracin personalizada en su
perl de usuario, la misma tendr precedencia sobre la conguracin
de sistema y ser la conguracin utilizada por JIRA. Si el usuario,
por el contrario, no ha establecido una conguracin personalizada,
JIRA utilizar la conguracin de sistema.
6.3.1 Configurar las columnas visualizadas
En el perl de cada usuario, JIRA permite denir y almacenar la con-
guracin de columnas del navegador de incidencias. El navegador de
incidencias de un usuario que no haya establecido dicha conguracin
utilizar la conguracin por defecto establecida por los administra-
dores de JIRA.
Para modicar el conjunto de columnas visualizadas en esta ven-
tana, es necesario acceder a la ventana de conguracin de campos
del navegador de incidencias (Figura 6.16) seleccionando la opera-
cin Congure columns en el men Tools. En esta ventana el usuario
podr modicar el conjunto de campos visualizados aadiendo, eli-
minando, reordenando y ocultando los campos disponibles:
(i) Para reordenar los campos de la ventana utilizar los controles
identicados con echas (hacia la derecha y hacia la izquierda
) para mover el campo en la direccin especicada.
18
6.3. Congurar el navegador de incidencias
Figura 6.16: Ventana de conguracin de campos del navegador de
incidencias.
(ii) Para eliminar un campo de la ventana seleccionar el control de
eliminacin identicado 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 Ac-
tions menu. (Oculta el men Acciones).
(v) Para volver a la conguracin por defecto, utilizar el botn Res-
tore defaults (Restablece valores originales).
La ventana de conguracin de campos del navegador tambin es
accesible desde la ventana del perl del usuario, a travs del enlace
View navigator columns, ilustrado en Figura 6.18.
La conguracin de columnas del navegador de incidencias se al-
macena en el perl de usuario de forma que cada usuario puede per-
sonalizar las columnas utilizadas por defecto en esta ventana.
Para modicar la conguracin de columnas, pueden repetirse los
pasos detallados en precedencias y ajustar la conguracin del proprio
perl a las nuevas necesidades.
Un usuario tambin puede decir eliminar la conguracin de co-
lumnas de su perl y, en este caso, el navegador de incidencias volver
a utilizar la conguracin por defecto establecida por el administra-
dor de la plataforma. Para eliminar la conguracin de columnas
1
personalizada es necesario seleccionar la operacin Restore defaults
ilustrada en Figura 6.17.
Figura 6.17: Ventana de conguracin de campos del navegador de
incidencias Establecer conguracin por defecto.
6.3.2 Configurar el nmero de lneas visualizadas
El nmero de lneas de resultados devueltas por el navegador de inci-
dencias es un parmetro de conguracin del perl de cada usuario.
Para modicar este parmetro es necesario efectuar las siguientes ope-
raciones:
(i) Acceder al perl del usuario seleccionando el enlace con el nom-
bre del usuario en la barra de herramientas de JIRA.
(ii) Seleccionar el icono de modicacin, identicado con el icono
lpiz, en el panel Preferences (Preferencias), como ilustrado
en Figura 6.18.
(iii) Modicar el parmetro Page size (Tamao de pgina) que, por
defecto, tiene el valor o.
(iv) Conrmar la modicacin utilizando el botn Update.
18o
6.4. Bsquedas de texto
Figura 6.18: Panel Preferences del perl de usuario.
6.4 Bsquedas de texto
JIRA ofrece funciones avanzadas pensadas para la bsqueda ecaz de
texto:
(i) Bsquedas aproximadas, utilizando comodines (6.4.2).
(ii) Bsquedas fuzzy (6.4.3).
(iii) Bsquedas por proximidad (6.4.4).
(iv) Bsquedas con palabras de distinta importancia (6.4.5).
(v) 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 cam-
pos de tipo fecha, aunque el formato del campo est bien especicado
y no puedan introducirse valores arbitrarios, una bsqueda aproxi-
mada puede ayudar el usuario a acotar el conjunto de incidencias a
ltrar: 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 dicultar las operaciones
de ltrado y un usuario podra enfrentarse a problemas a la hora de
encontrar las incidencias que est buscando.
181
Si un usuario quisiera ltrar las incidencias utilizando como cri-
terio 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 decli-
nan y, por lo tanto, una bsqueda exacta se revelara insuciente 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 exibilidad y, sobre todo, conanza a
la hora de certicar que las incidencias que se han ltrado 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 ca-
tegoras: 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 con-
junto indivisible de palabras que tiene que aparecer, con las palabras
en el orden especicado y sin interrupcin, en el campo que se es-
t ltrando. Las dos bsquedas anteriores, por lo tanto, devolvern
conjuntos distintos de resultados siendo la segunda (documento de
implantacin), una bsqueda menos ltrante 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 ml-
tiples trminos en un criterio de bsqueda ms complejo. Los ope-
radores ms comnmente utilizados son, por ejemplo, los operadores
booleanos and () y or ().
18:
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 signicado
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 prejar-
los con el carcter de escape \.
Ejemplo 6.2. Para buscar el texto (r + j) + ., por ejemplo, ser
necesario ejecutar la consulta:
$x\+y$\+z
En la consulta precedente, se ha utilizado el carcter \ para escapar,
prejndolo 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 and are as at be but
by for if in into is it
no not of on or s such
t that the their then there these
they this to was will with
Tabla 6.4: Trminos especiales en las bsquedas de texto.
18
6.4.2 Bsquedas aproximadas
JIRA permite utilizar los siguientes comodines para modicar el
signicado 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 correspon-
dientes 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 especicados 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
ltrado inecaz de las incidencias en el sistema.
Para efectuar una bsqueda fuzzy con un trmino es necesario
utilizar el modicador al nal del trmino nico que se desea modi-
car. Para buscar de forma fuzzy utilizando el trmino factura, por
ejemplo, un usuario deber utilizar el trmino modicado factura.
6.4.4 Bsquedas por proximidad
Las bsquedas por proximidad permiten efectuar bsquedas con fra-
ses cuyas palabras no deben distar ms de la cantidad de palabras
especicadas.
Este tipo de bsqueda es til para renar 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
18
usuario puede seguir utilizando frases, un criterio ms ltrante que
un criterio por trminos nicos, asegurndose que las palabras no es-
tn demasiados apartadas corriendo el riesgo de obtener resultados
diversos de los esperados.
Para efectuar una bsqueda por proximidad un usuario necesita
aadir el sujo 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 modicar el nivel de importancia de un trmino,
tanto nico como frase, utilizando el modicador 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[ dis-
minuyen el nivel de importancia de un trmino mientras que los n-
meros 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 im-
plantacin 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) AND o &&.
(ii) OR o ||.
(iii) NOT o !.
(iv) +.
(v) -.
Ntese que un operador debe escribirse en maysculas, de lo contrario
JIRA lo interpretar como trmino (6.4).
18
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 A es el conjunto de resultados del trmino r y Y el del trmino j,
los resultados de r j sern r j.
El operador OR es un operador binario que indica a JIRA de devol-
ver resultados que contengan o un trmino o el otro. Para hacer una
analoga con los conjuntos, el operador OR () hace una interseccin:
si A es el conjunto de resultados del trmino r y Y el del trmino j,
los resultados de r j sern r j.
El operador NOT es un operador binario que indica a JIRA de
devolver los resultados que contengan el trmino especicado por el
primer operando y que no contenga el trmino especicado por el
segundo operando. Para hacer una analoga con los conjuntos, el
operador NOT () hace una diferencia entre conjuntos. Si A es el
conjunto de resultados del trmino r y Y es el conjunto de resultados
del trmino j, el conjunto de resultados de la consulta rj ser AY .
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 consul-
tas 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, descrip-
cin y comentarios. El control de bsqueda rpida tambin reco-
noce 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 ltrar 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 avisa-
do 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
18
query para volver a efectuar la bsqueda inhabilitando las queries
inteligentes
6
.
La bsqueda rpida es una funcionalidad compatible con el con-
trol 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 Goo-
gle), se podr efectuar una bsqueda en JIRA sin ni siquiera acceder
previamente a la misma y obtener los resultados accediendo directa-
mente al navegador de incidencias. En seccin 6.5.14 se detallar
como congurar esta funcionalidad en los navegadores compatibles.
En las siguientes secciones se detallarn las bsquedas inteligen-
tes 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 deta-
lle de una incidencia ya que, tecleando en el control un cdigo de
incidencia, JIRA llevar el usuario a la ventana de detalle correspon-
diente. Si, por ejemplo, un usuario quiere navegar hacia la incidencia
JRAGD-1, es suciente 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 interme-
dia.
Si, adems, el usuario est buscando una incidencia en el mismo
proyecto en el que est trabajando, se podr omitir la clave de pro-
yecto 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 en-
contrar 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 ltar las incidencias utilizando el nombre del usuario
que ha reportado la incidencia
7
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 especco.
Si, por ejemplo, un usuario quisiera buscar las incidencias abiertas
por enrico podr utilizar r:enrico.
6.5.4 Incidencias en un proyecto
Para ltrar las incidencias de un proyecto es posible especicar 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 ltrado en
el contexto del proyecto especicado.
6.5.5 Incidencias atrasadas
Para buscar las incidencias atrasadas, es decir las incidencias cuya
fecha de resolucin ha pasado la fecha lmite especicada en el cam-
po 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 prejos created:, updated: y due: pueden utilizarse para bus-
car las incidencias cuya fecha de creacin, ltima actualizacin o ven-
cimiento sea la especicada. El formato de fecha que puede utilizarse
7
Esta funcionalidad est incluida en JIRA v. . y superiores
18
con este tipo de bsqueda inteligente es exclusivamente una fecha re-
lativa (??) o un intervalo de fechas relativas, utilizando la notacin add section
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 uti-
lizarse por ejemplo la bsqueda created:-1w. Para buscar inciden-
cias 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 abier-
tas (open) asignadas a uno mismo en el proyecto JRAGD.
Los estados reconocidos sern exclusivamente los estados del ujo
de trabajo estndar de JIRA.
6.5.8 Incidencias por resolucin
El nombre de una resolucin (??) puede utilizarse para ltrar las
incidencias como en la busqueda my incomplete, para buscar inci-
dencias 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 pue-
de 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 inte-
ligente: para buscar incidencias del tipo bug o task pueden utilizarse
1o
los trminos bug o task en el criterio de bsqueda. JIRA, en algunos
casos, interpretar tambin los plurales y podrn efectuarse bsque-
das 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 prejo v: puede utilizarse para especicar la versin a la que es-
tn asociadas las incidencias que se estn buscando. JIRA devolver
las incidencias cuya versin sea igual a la que se especique o que
comience con la cadena especicada siempre que el primer carcter
despus de sta sea un espacio.
Si en un proyecto, por ejemplo, se han denido 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 especicada (1.0)
no es un espacio sino un punto (.).
6.5.12 Incidencias por versin de resolucin
Las incidencias pueden ltrarse por el campo Fix version utilizando
el trmino ff: y especicando un nmero de versin. El mecanismo
de bsqueda es parecido al detallado en 6.5.11.
6.5.13 Incidencias por componente
El prejo c: puede utilizarse para buscar las incidencias asociadas al
componente buscado. Este prejo permite especicar una palabra (sin
espacios) y JIRA devolver las incidencias asociada a componentes
cuyo nombre contenga la palabra especicada.
6.5.14 Integracin con navegadores
La integracin de JIRA con el control de bsqueda de los navegado-
res 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 con-
trol de bsqueda del navegador que, normalmente, est situado justo
a la derecha de la barra de navegacin. El navegador, despus de que
11
el usuario haya conrmado la bsqueda, contactar con JIRA para
enviarle la query introducida por el usuario que ser llevado directa-
mente 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.
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 facili-
tara 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. there can only
be one open-
search descrip-
tor per domain.
Los navegadores ms conocidos que hoy en da soportan este es-
tndar son:
(i) Mozilla Firefox v. : y superiores.
(ii) Microsoft Internet Explorer v. y superiores.
(iii) Google Chrome.
Para aadir una instancia de JIRA a los motores de bsqueda
congurados de un navegador soportado, es suciente navegar a cual-
quier 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 congu-
racin del navegador. En Figura 6.21 puede verse un ejemplo con
Mozilla Firefox: utilizando el men desplegable a la izquierda del con-
trol de bsqueda (identicado, 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
congurados.
Una vez registrado el motor, el usuario podr comenzar a teclear
sus bsquedas y enviarlas directamente a JIRA. En Figura6.22 pue-
de 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
1:
Figura 6.21: Registracin de un motor de bsqueda OpenSearch.
Figura 6.22: Ejemplo de bsqueda desde el control de bsqueda del
navegador.
1
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 Mo-
zilla es la creacin de un bookmark personalizado que apunte a la
direccin
8
:
http://your.jira/secure/QuickSearch.jspa?searchString=%s
El usuario podr escoger una keyword (palabra clave) para el book-
mark que, por ejemplo, podra ser el mnemnico j. Para efectuar una
bsqueda en JIRA ser suciente teclear la palabra clave escogida se-
guida del criterio deseado: para repetir la bsqueda del ejemplo de
Figura 6.22 el usuario deber teclear j my open bugs.
8
Sustituir your.jira con la direccin de la instancia de JIRA a integrar.
1
7
Bsquedas avanzadas
La bsqueda avanzada es la herramienta de bsqueda ms comple-
ta proporcionada por JIRA. Para utilizar este tipo de bsqueda, a
diferencia de los dems tipos de bsquedas ofrecidos por JIRA (bs-
queda 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 modicar 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)
o la bsqueda:
fecha de creacin = fecha de actualizacin (7.2)
no habr forma de ejecutarla a travs de las herramientas de JIRA
ya que, por ejemplo, la consulta:
1
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 inciden-
cias (6.2), seleccionando en enlace Advanced para pasar de la mo-
dalidad 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

campo
=
operador
enrico

valor
(7.3)
El campo es el identicador 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 ltrado 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 ltrado: 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 boo-
leanos, para construir proposiciones complejas.
16
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 deta-
llada en 6.4.1. Este tipo de bsqueda, cuando se utilizan consultas
JQL, aplicarn a los siguientes campos:
(i) Ttulo.
(ii) Descripcin.
(iii) Entorno.
(iv) Comentarios.
(v) 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 utiliza-
dos 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.
1
En Tabla 7.2 puede verse la lista de campos que pueden utilizarse
en una query JQL.
Descripcin Nombre
Versin afectada affectedVersion
Asignatario assignee
Categora category
Comentario comment
Componente component
Fecha de creacin created
Descripcin description
Fecha de vencimiento due
Entorno environment
Filtro filter
Versin de resolucin fixVersion
Clave de incidencia issueKey
Nivel de seguridad level
Estimacin original originalEstimate
Padre parent
Prioridad priority
Proyecto project
Estimacin restante remainingEstimate
Reporter reporter
Resolucin resolution
Fecha de resolucin resolved
Estado status
Ttulo summary
Texto text
Tipo de incidencia issueType
Tiempo trabajado timeSpent
Fecha de actualizacin updated
Usuario que ha votado voter
Nmero de votos votes
Usuario que observa watcher
Porcentaje de trabajo workRatio
Tabla 7.2: Campos JQL.
7.5 Palabras claves
Las palabras claves son trminos reservados JQL que se dividen en
las siguientes categoras:
18
7.5. Palabras claves
(i) Conectivas o operadores lgicos, como por ejemplo los opera-
dores 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) A y Y en una proposicin ms compleja, AY ,
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 asig-
nadas 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) A y Y en una proposicin ms compleja, A
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 especican una fecha de vencimiento es necesario juntar las
proposiciones
1
(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 A es una proposicin y A es la proposicin negada, A ser
verdadera cuando A 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
:oo
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 uti-
lizarse 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 especicar el campo con el cual se or-
denarn los resultados. Por defecto este operador devolver los datos
en rden ascendente pero su comportamiento puede modicarse indi-
cando 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 des-
crita 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 denen los criterios de ltrado que el
usuario puede hacer sobre los campos y son los siguientes:
(i) El campo es igual a (=): equals.
(ii) El campo es distinto de (,=): not equals.
(iii) El campo es mayor que (): greater than.
(iv) El campo es mayor o igual que (): greater than equals.
(v) El campo es menor que (<): less than.
:o1
(vi) El campo es menor o igual que (): less than equals.
(vii) El campo est en (): in.
(viii) El campo no est en (, ): not in.
(ix) El campo contiene (): contains.
(x) El campo no contiene (,): does not contain.
(xi) El operador es (): is.
(xii) El operador no es (,): is not.
7.6.1 Operador equals
El operador equals (=) se utiliza cuando el valor de un campo tie-
ne que coincidir con el valor especicado. 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 (,=) se utiliza cuando el valor de un campo
tiene que ser distinto que el valor especicado. 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 ,= equivale a la negacin
de la misma proposicin en la que ,= 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 ,= , incluso cuando el campo c est vaco, habr que
utilizar la proposicin (c ,= ) (c = ):
campo != valor or campo is empty
:o:
7.6. Operadores
Ejemplo 7.9. Para encontrar todas las incidencias asignadas a un
usuario distinto del usuario enrico ser necesario utilizar la proposi-
cin:
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 especicado
1
.
Ejemplo 7.12. Para encontrar todas las incidencias no soluciona-
das 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.
:o
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 especicado
2
.
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 si-
do creadas en los ltimos 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 especicado
3
.
Ejemplo 7.16. Para encontrar todas las incidencias que hayan sido
votadas menos que ser necesario utilizar la siguiente proposicin:
votes <= 4
2
Vase nota al pi 1.
3
Vase nota al pi 1.
:o
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 especicado
4
.
Ejemplo 7.17. Para encontrar todas las incidencias que hayan si-
do actualizadas en las ltimas 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 especicados que se indicar con
la notacin (r, . . . , .). Como ya hemos subrayado en otra seccin
(6.1), la proposicin:
: :
i
, i [0, n] (7.4)
es equivalente a la siguiente proposicin:
(: = :
0
) (: = :
1
) (: = :
n
) (7.5)
Por lo tanto, el operador in permite escribir proposiciones ms com-
pactas 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 o a la versin ser necesario utilizar la siguiente proposi-
cin:
affectedVersion in ("3", "4")
4
Vase nota al pi 1.
:o
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 especicados.
Negando las proposiciones 7.4 y 7.5 se obtiene:
(: , :
i
, i [0, n]) = ((: ,= :
0
) (: ,= :
1
) (: ,= :
n
)) (7.6)
es decir, que el operador not in puede utilizarse para sustituir un
conjunto de proposiciones, relacionadas con el operador and, que com-
prueban que el campo no asuma ninguno de los valores especicados,
uno a la vez. Esto signica 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 simplicar al-
gunas consultas y escribirlas con una notacin ms compacta y ms
fcil de entender.
Es importante subrayar que este operador tiene el mismo com-
portamiento del operador not equals (vase 7.6.2) cuando compara
campos vacos: si un campo c es vaco, c c
i
, 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 , Cc = .
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 (), un operador que se puede utilizar exclusi-
vamente con campos de tipo texto, se utiliza para comprobar que un
campo tenga el valor especicado 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.
:o6
7.6. Operadores
Ejemplo 7.21. Para encontrar todas las incidencias cuyo ttulo con-
tenga la frase problema de pantalla ser necesario utilizar la siguien-
te proposicin:
summary ~ "problema de pantalla"
tenga el trmino bug o los trminos parecidos con una bsqueda
fuzzy, ser necesario utilizar la siguiente proposicin:
summary ~ bug
tenga una palabra que comience con win, ser necesario utilizar la
summary ~ "win*"
7.6.10 Operador does not contain
El operador does not contain (,), o !, es el operador inverso del
operador contains (7.6.9): si un campo c satisface la proposicin
c , entonces no satisfar la proposicin c , , 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 satisfa-
cen 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
:o
7.6.11 Operador is
Como explicado en las secciones dedicadas a otros varios operado-
res, el valor vaco () es un valor especial para un campo y las
proposiciones que involucran campos vacos no siempre devuelven el
resultado esperado. Simplicando, 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 asig-
nada 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
:o8
7.8. Auto-nalizacin de las consultas
llamado : el estado, j el proyecto y o el asignatario, JIRA la evaluar
de la siguiente forma:
(: = :
0
) (j = j
0
o = o
0
) (7.7)
y devolver las incidencias resueltas, que pertenezcan al proyecto j
0
o que hayan sido asignadas al usuario o
0
.
Si lo que se desea es buscar las incidencias resueltas del proyecto
j
0
o las incidencias asignadas a o
0
ser necesario modicar 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
o = o):
(o /) = o / (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 grca de bsquedas avanzadas de JIRA ofrece la fun-
cionalidad de auto-nalizacin 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-nalizacin determina de for-
ma 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
:o
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-nalizacin 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-nalizacin 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-nalizacin inteligente de consultas JQL es una herra-
mienta poderosa que facilita mucho la labor de los usuarios a la hora
:1o
Figura 7.4: Auto-nalizacin de un valor en una consulta JQL.
de crearse una query JQL. A menudo no ser siquiera necesario re-
cordar 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, identica-
da 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-nalizacin 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 so-
licitar a los administradores de la plataforma que habiliten la misma.
El usuario que lo desee, adems, puede inhabilitar la auto-nalizacin
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-nalizacin ofrece una lista de opciones en
las siguientes situaciones:
(i) Tecleando un espacio al principio de una consulta.
(ii) Tecleando algn carcter.
(iii) Tecleando un espacio despus del nombre de un campo.
(iv) Tecleando un espacio despus de un campo y un operador.
:11
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 1 elementos que pueden completar el fragmento de con-
sulta.
Si se teclea un espacio al principio de una consulta, (i), JIRA
sugerir los campos y los operadores con los cuales se puede comen-
zar la misma. En Figura 7.6, por ejemplo, puede verse la lista de
Figura 7.6: Auto-nalizacin de un campo en una consulta JQL.
sugerencias con algunos campos y el operador not.
:1:
Si se teclea algn carcter al principio de una consulta, (ii), JIRA
propondr la lista de campos cuyo nombre comienza con los caracte-
res 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-nalizacin 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 uti-
lizarse 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-nalizacin 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 Figu-
:1
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 ope-
rador introducida. Segn el usuario vaya tecleando otros caracteres,
Figura 7.9: Auto-nalizacin en consultas JQL Seleccin de valores y
funciones.
(v), JIRA ltrara 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 bs-
queda 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 modicar algunas consultas
simples, en casos muy sencillos.
Despus de haber aportado una modicacin que no puede im-
plementarse 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) La consulta contiene el operador or ().
(ii) La consulta contiene el operador not ().
(iii) La consulta contiene el operador empty ().
(iv) La consulta contiene un operador de comparacin: !=, is, is
not, <, <=, > o >=.
:1
7.9. Modicar 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 ltra 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 bsque-
da 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.
:1
8
Grabar una bsqueda en un ltro
JIRA permite grabar una bsqueda para poder almacenarla y utili-
zarla 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 ltros va ms all del simple almacena-
miento. Los ltros son objetos sosticados 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) Modicarse y clonarse, para crear nuevos ltros.
La importancia de los ltros reside, adems, en su capacidad de
actuar como fuente de datos para otros objetos de JIRA. Los l-
tros, 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 noticaciones sobre los resultados del ltro.
Ejemplo 8.1. En un proyecto en el cual se denen acuerdos de nivel
de servicio es necesario establecer la prioridad, organizar la asignacin
:1
8. Grabar una bsqueda en un filtro
y determinar el orden de resolucin de las incidencias, con el n de
respetar los niveles de servicios establecidos.
En este caso de uso los responsables de proyecto pueden denir
un conjunto de ltro, 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 niveles de
servicio:
(i) Platinum: tempo de respuesta mximo de 1 hora.
(ii) Gold: tempo de respuesta mximo de horas.
(iii) Silver: tempo de respuesta mximo de 8 hora.
se podrn crear ltros 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 ujo de trabajo que vaya entrando. En el caso = .5, dichos ltros
devolvern las incidencias que todava estn sin comenzar despus de:
(i) Platinum: o minutos.
(ii) Gold: : horas.
(iii) Silver: horas.
Los resultados de los ltros podrn utilizarse para crear notica-
ciones o reportes en cuadros de mandos personalizados y permitir a
los responsables de proyecto de tener una imagen del estado del ser-
vicio actualizada en tiempo real y de ser avisados tempestivamente
en el caso en que empiecen a observarse sntomas de retraso en las la-
bores 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 ltros 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
:18
8.2. Creacin de un ltro
mandos de muchos perles 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 ltros pue-
den protegerse con polticas de seguridad que permiten compartirles
con un selecto conjunto de identidades. Todo usuario que tenga per-
miso para acceder a un ltro, podr disponer de l para ejecutarlo y
obtener los resultados de la bsqueda o para utilizarlo como fuente
de datos.
Los ltros pueden tambin ser objeto de bsquedas: los usuarios,
a travs de un buscador, podrn examinar los ltros existentes
1
y
comprobar si existe un ltro que satisface sus necesidades.
Los ltros utilizados frecuentemente por un usuario pueden ser
marcados como ltros 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 ltros
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 ltro es necesario crear la bsqueda que se desea gra-
bar; el usuario podr grabar una bsqueda creada con cualquiera de
las herramientas proporcionadas por JIRA, como explicado en los ca-
ptulos 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 ltro. En Figura 8.2 puede ver el control
de creacin de ltros (el enlace Save it as a lter) en dos detalles
del panel izquierdo del navegador de incidencia. En la gura a la
izquierda puede verse el control en la pestaa Summary del panel,
mientras que en la gura a la derecha puede verse el mismo control
en la pestaa Edit. En ambos casos el control, as como otras opera-
ciones, estar en la seccin Operations del panel, junto a las dems
operaciones que, en cada caso, puedan efectuarse en ese momento.
Para crear un ltro, es necesario efectuar las siguientes operacio-
nes:
(i) Seleccionar el enlace Save it as a lter. El usuario ser llevado
a la ventana de creacin de ltro.
1
Un usuario, incluso a travs del buscador de ltros, podr tener acceso ex-
clusivamente al conjunto de ltros para los cuales tiene los permisos necesarios.
:1
Figura 8.1: Filtros favoritos en la barra de herramientas de JIRA.
Figura 8.2: Creacin de ltros.
::o
8.2. Creacin de un ltro
(ii) En la ventana de creacin de ltros, visible en Figura 8.3,
el usuario podr establecer el nombre y la descripcin del ltro
teclendolos, respectivamente, en el control Name y Description
del formulario.
Figura 8.3: Ventana de creacin de ltros.
(iii) Por defecto, un ltro creado por uno mismo es un ltro favori-
to (8.1), como puede verse por el control identicado con un
icono estrella amarilla ( ) en el formulario de creacin de l-
tro. Para crear el ltro 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 ltro se excluir de los favoritos.
(iv) En el control Shares se detallan las listas de identidades con las
cuales se compartir el ltro. Por defecto, un ltro se comparte
con las identidades especicadas en el perl de usuario. Si no se
ha especicado ninguna preferencia, se utilizar la preferencia
global, congurada por el administrador. Por defecto, un ltro
es privado y no se comparte con nadie.
(v) Opcionalmente, y siempre que el usuario posea el permiso Crea-
te shared object, se pueden aadir las identidades con las cuales
se desea compartir el ltro utilizando el control Add Shares del
formulario. Vase 8.8 para obtener mayores detalles sobre co-
mo compartir ltros con otros usuarios.
::1
8.3 Sumario de un filtro
Cuando se ha seleccionado un ltro, 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 ltro
as como las operaciones disponibles que el usuario conectado puede
efectuar.
En Figura 8.4 puede verse el sumario de un ltro de un usuario.
En la parte superior de la ventana, en la seccin summary, se resume
Figura 8.4: Sumario de un ltro.
la siguiente informacin:
(i) Nombre del ltro.
(ii) Estado del ag favorito.
(iii) Criterio de bsqueda del ltro.
El estado del ag favorito ser indicado con un control identicado
con el icono estrella amarilla ( ) o estrella gris ( ) si el ltro es,
respectivamente, un ltro favorito o no. El control podr utilizarse
para cambiar este ag y aadir o remover el ltro seleccionado de la
lista de favoritos del usuario conectado.
El criterio de bsqueda del ltro 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 proporcio-
nar la lista de los campos de bsqueda seleccionados por el creador
del ltro as como el valor seleccionado. Por otro lado, en el caso
:::
8.4. Gestin de ltros
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 ltro.
Las operaciones disponibles dependern de varios factores tales como
el autor del ltro y los privilegios del usuarios conectado.
Ejemplo 8.2. En la imagen de Figura 8.4 puede apreciarse como
el ltro se llame Unresolved issues y sea un ltro favorito del usuario
(indicado por el icono ).
La bsqueda del ltro es una bsqueda simple que especca 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 ltros permite ver, organizar y congurar
tanto los ltros propios como los ltros compartidos por otros usua-
rios. Para acceder a esta ventana es necesario seleccionar la operacin
Manage lters en el men Issues en la barra de herramientas de JIRA
(Figura 8.5).
Figura 8.5: Men Issues Operacin Manage lters.
::
Esta ventana est compuesta por las siguientes pestaas:
(i) Favorite: en esta pestaa el usuario tiene acceso directo a sus
ltros favoritos (Figura 8.6).
Figura 8.6: Ventana de gestin de ltros Pestaa Favorite.
(ii) My: en esta pestaa el usuario tiene acceso directo a sus ltros.
(iii) Popular: en esta pestaa, similar a la pestaa precedente, el
usuario tiene acceso a los ltros populares, es decir, los ltros
que muchos usuarios han marcados como favoritos. En esta
pestaa JIRA propondr al usuario los :o ltros ms populares
entre los ltros al que el usuario tenga acceso.
(iv) Search: en esta pestaa, similar a la pestaa precedente, el
usuario puede efectuar bsquedas de ltros (Figura8.7).
Figura 8.7: Ventana de gestin de ltros Pestaa Search.
En esta ventana un usuario podr:
(i) Buscar ltros.
(ii) Aadir o remover ltros de la lista de favoritos.
(iii) Modicar y actualizar los ltros creados por l mismo.
::
8.5. Eliminar un ltro de la lista de favoritos
8.5 Eliminar un filtro de la lista de favoritos
El usuario puede modicar la lista de ltros favoritos aadiendo nue-
vos ltros o eliminando los ltros que ya no le interesan.
Para eliminar un ltro de la lista de favoritos es necesario efectuar
las siguientes operaciones:
(i) Localizar el ltro a eliminar de la lista de favoritos. El ltro
puede buscarse a travs del buscador de ltros (??) o nave-
gando a la pestaa Favorite de la ventana de gestin de ltros,
(ii) Eliminar el ltro de la lista seleccionando el control identicado
con un icono estrella amarilla ( ). Despus de la eliminacin
el control se volver gris ( ) y se mostrar un aviso de elimi-
nacin a travs del cual, en el caso la eliminacin hubiera sido
accidental, se podra anular la operacin. En Figura 8.8 pue-
de verse el aviso de eliminacin y el control de anulacin de la
operacin, el enlace Undo.
Figura 8.8: Aviso de eliminacin de ltro favorito.
8.6 Aadir un filtro a la lista de favoritos
Todos los ltros creados por un usuario, por defecto y siempre que
no se haya explcitamente modicado esta opcin (8.2), son ltros
favoritos. Para aadir un ltro existente a la lista de ltros favoritos
(i) Localizar el ltro a eliminar de la lista de favoritos. El ltro
puede buscarse a travs del buscador de ltros (??) o nave-
gando a la pestaa Favorite de la ventana de gestin de ltros,
::
(ii) Aadir el ltro a la lista de ltros favoritos utilizando el control
identicado con un icono estrella gris ( ). Despus de haber
aadido el ltro el control se volver amarillo ( ).
8.7 Modificacin de los atributos de un filtro
Durante la creacin de un ltro se establecen los siguiente algunos
atributos del ltro:
(i) Nombre.
(ii) Descripcin.
(iii) Favorito.
(iv) Identidades con los cuales se comparte.
El usuario al que pertenezca el ltro puede modicar estos atri-
butos en cualquier momento efectuando las siguientes operaciones:
(i) Localizar el ltro a modicar. El ltro puede buscarse a travs
del buscador de ltros (??) o accediendo a la pestaa My en la
ventana de gestin de ltros (8.4) en la cual se enumeran los
ltros creados por el usuario conectado.
(ii) Seleccionar la operacin Edit en la columna Operations para
acceder a la ventana de modicacin de ltros que puede verse
en Figura 8.9.
Figura 8.9: Ventana de modicacin de un ltro.
::6
8.8. Compartir un ltro con otros usuarios
(iii) En la ventana de modicacin pueden introducirse los nuevos
valores para los atributos que se desean modicar. Si se desean
modicar las identidades con las cuales se quiere compartir el
ltro es necesario seguir las instrucciones detalladas en 8.8.
(iv) Seleccionar el botn Save para conrmar la operacin.
8.8 Compartir un filtro con otros usuarios
Un ltro 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 ltros con otros usuarios tambin permite separar los
usuarios que explotan la informacin de los usuarios que organizan la
informacin y puede ser benecioso en algunos casos de uso, como los
ilustrados en los ejemplos de esta seccin.
Sin embargo, la comparticin de una entidad genera un acopla-
miento entre proveedores y consumidores de la informacin. Este
acoplamiento debe gestionarse adecuadamente como una dependen-
cia y solo a travs de coordinacin es posible garantizar que eventua-
les modicaciones se hagan con el conocimiento y, eventualmente, el
acuerdo de los usuarios.
Los ltros pueden compartirse al momento de la creacin (8.2)
o posteriormente, modicando un ltro existente. En ambos casos,
tanto el procedimiento como la interfaz grca utilizada para efectuar
esta operacin son los mismos.
Para poder compartir un ltro es necesario tener el permiso Create
shared object. Si el usuario no dispone de este permiso en las ventanas
de creacin y modicacin de ltro no sern visibles los controles para
compartir el ltro.
Para modicar las identidades con las cuales se desea compartir
el ltro es necesario efectuar las siguientes operaciones:
(i) Si se desea compartir el ltro durante su creacin, pasad direc-
tamente a (iii).
(ii) Localizar el ltro a compartir. El ltro puede buscarse a travs
del buscador de ltros (??) o accediendo a la pestaa My en la
ventana de gestin de ltros (8.4) en la cual se enumeran los
ltros creados por el usuario conectado.
(iii) En la ventana de modicacin del ltro pueden aadirse las
identidades con las cuales se desea compartir el ltro y elimi-
::
narse las identidades con las cuales no se desea seguir compar-
tiendo el mismo. En Figura 8.10 pueden verse los controles
Shares y Add Shares que deben utilizarse para llevar a cabo
esta conguracin.
Figura 8.10: Controles para la modicacin de las identidades con las
cuales se comparte un ltro.
(iv) El control Shares detalla las identidades con las cuales se est
compartiendo un ltro. Para eliminar una identidad con la cual
ya no se desea seguir compartiendo el ltro corriente es necesario
utilizar el control identicado 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 ltro. En el primer men puede
seleccionarse el tipo de identidad:
a) Everyone, para grabar un ltro pblico que pueda ser uti-
liado por cualquier usuario de JIRA.
b) Group, para compartir el ltro con un grupo de usuarios.
c) Project, para compartir el ltro con un rol de proyecto.
Si se desea aadir un grupo, habr que seleccionar el elemen-
to 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 ltro 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 ilus-
trado 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.
::8
8.8. Compartir un ltro con otros usuarios
Figura 8.12: Compartir un ltro con un rol de proyecto.
Para aadir la identidad seleccionada, pulsar el control Add,
identicado con el icono ms ( ) y repetir este paso hasta
que se hayan aadido todas las identidades con las cuales se
desea compartir el ltro.
Ejemplo 8.3. En el ejemplo 8.1 se ha visto como los ltros 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 ltros permite reutilizar los ltros 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 modicar los ltros
de todos los proyectos sino, simplemente, el nico ltro que todos los
usuarios estn compartiendo.
En el caso que estamos ilustrando, por ejemplo, el ltro en cues-
tin podra ser utilizado poo el responsable de cualquier proyecto
simplemente utilizando oportunamente la proposicin
project = projectsLeadByUser
en el criterio de bsqueda utilizado por el ltro. De esta forma, el
ltro 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 ltro.
Ejemplo 8.4. Los responsables del proyecto ilustrado en el ejemplo
8.1, en que se ofrece soporte de 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 ltros que
les proporcione los datos que cumplan los criterios que se hayan esta-
blecido a nivel de direccin de proyecto. De esta forma, en lugar de
::
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 ltro 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 modicar los pa-
rmetros utilizados para establecer el orden de trabajo, ser suciente
modicar los relativos ltros 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 de-
fecto componen las incidencias de JIRA podran resultar insucientes
a organizar la informacin requerida por los usuarios de forma e-
ciente.
El campo prioridad, a menudo utilizado para organizar el orden
de trabajo sobre las incidencias, se compone de un nmero nito,
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 inecaz a los nes que
nos proponemos.
Una solucin comnmente utilizada es la creacin de campos per-
sonalizados (??) que puedan ordenarse (tales como los campos nu-
mricos, 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 ltros son una funcionalidad muy comnmente uti-
lizada por los usuarios de JIRA, no es inusual que en una instalacin
de la herramienta el nmero de ltros guardados sea elevado y que,
por lo tanto, el nmero de ltros visibles a un usuario, tantos propios
como compartidos por otros, sea grande.
Como descrito en precedencia, el usuario puede acceder rpida-
mente a algunas categoras de ltros, los ltros favoritos, los ltros
propios y los ltros populares, utilizando respectivamente las pestaas
Favorite, My y Popular de la ventana de gestin de ltros (8.4).
Sin embargo si el usuario necesita encontrar un ltro que no est
en ninguna una de estas ventanas ser necesario efectuar una bsque-
da. Para facilitar esta tarea al usuario, JIRA ofrece el formulario de
bsqueda de ltros, ilustrado en Figura 8.13, al que se puede acceder
a travs de la pestaa Search de la ventana de gestin de ltros.
:o
8.9. Buscar un ltro
Figura 8.13: Ventana de bsqueda de ltros.
A travs del formulario de bsqueda, el usuario podr acotar el
conjunto de ltros examinados utilizando los siguientes parmetros:
(i) Nombre y descripcin.
(ii) Autor.
(iii) Identidades con las que se comparte.
Para buscar un ltro es necesario efectuar las siguientes operacio-
nes:
(i) Acceder a la ventana de gestin de ltros, seleccionando la ope-
racin Manage lters en el men Issues en la barra de herra-
mientas de JIRA.
(ii) Acceder a la ventana de bsqueda de ltros seleccionando la
pestaa Search en la ventana de gestin de ltros.
(iii) Si se desea efectuar una bsqueda de texto en el nombre o en
la descripcin del ltro, introducir el criterio de bsqueda en el
control Search.
(iv) Si se desea buscar entre los ltros creados por un usuario, intro-
ducir el nombre del usuario en el campo Author. Alternativa-
mente, seleccionar el usuario utilizando la ventana de seleccin
de usuarios a la que se puede acceder a travs del control iden-
ticado por el icono ( ) situado a la derecha del control Author.
(v) Si se desea buscar entre los ltros 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 conrmar 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
:1
Figura 8.14: Resultados de bsqueda de ltros.
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 ltro en la lista de resultados,
JIRA establecer el ltro seleccionado como ltro corriente y llevar
el usuario directamente a la ventana de resultados de la bsqueda
asociada al ltro.
8.10 Copiar un filtro existente
Como explicado en 8.1, la funcionalidad de comparticin de ltros
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 denen un ltro compartido, y consumidores,
quienes utilizan el ltro.
En determinadas circunstancias, por lo tanto, los usuarios podran
preferir no tener que depender de un ltro que est fuera de su control:
de esta forma no corrern los riesgos relacionados con la dependen-
cia con entidades de este tipo. El creador, por ejemplo, podra dejar
de compartir un ltro o, incluso, eliminarlo. El creador podra tam-
bin modicar el criterio de bsqueda de un ltro 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 cua-
les no es deseable acoplarse a un ltro compartido JIRA proporciona
la posibilidad de clonar un ltro existente: de esta forma, el usuario
podr crear una copia de un ltro y grabarlo en un ltro nuevo.
::
8.11. Modicacin de un ltro
La misma tcnica puede utilizarse tambin cuando quiere crearse
un ltro nuevo comenzando con los criterios grabados en otro ltro,
incluso del mismo usuario que est efectuando la copia.
Para copiar un ltro, es necesario efectuar las siguientes operacio-
nes:
(i) Localizar y seleccionar el ltro que se desea copiar.
(ii) Seleccionar la pestaa Summary del panel de bsqueda.
(iii) Si el ltro es un ltro 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 ltro de
otro usuario es necesario seleccionar la operacin Create new
lter from current.
Figura 8.15: Resultados de bsqueda de ltros.
(iv) Si el ltro es un ltro propio, la lista de operaciones ser pareci-
da a la lista ilustrada en Figura 8.15 (derecha). Para copiar un
ltro propio es necesario seleccionar la operacin Save as new
lter.
Despus de haber copiado el ltro se proceder como durante la
creacin de un ltro cualquiera. Las instrucciones para congurar un
nuevo ltro estn detalladas en 8.2.
8.11 Modificacin de un filtro
Un usuario no podr modicar ltros que no le pertenezcan: en este
caso la nica operacin permitida ser la copia (8.10) y la modi-
:
cacin de la misma. El autor de un ltro, por el otro lado, puede
modicar el criterio de bsqueda asociado al mismo en cualquier mo-
mento. Sin embargo, por las razones explicadas en precedencia, es
aconsejable que un usuario que est compartiendo un ltro con otros
usuarios no modique un ltro sin haberlo comunicado a los usuarios
que lo pueden estar utilizando.
Para modicar el criterio de bsqueda de un ltro es necesario
(i) Localizar y seleccionar el ltro que se desea copiar.
(ii) Seleccionar la pestaa Edit del panel de bsqueda.
(iii) Modicar 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 modicar
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: Modicacin del criterio de bsqueda de un ltros.
informar al usuario de que existen modicaciones al ltro sin
grabar a travs del mensaje Filter modied since loading que
puede apreciarse en el lado izquierdo de la ventana.
(v) Si se utiliza la interfaz de bsqueda simple para modicar el cri-
terio de bsqueda, como ilustrado en Figura 8.17, las operacio-
nes disponibles no sern visibles en la pestaa Edit y solo sern
accesibles en la pestaa Summary. JIRA informar al usuario
de que existen modicaciones al ltro sin grabar a travs del
mensaje Filter modied since loading que puede apreciarse en
el lado izquierdo de la ventana.
:
8.12. Congurar el orden de columnas de un ltro
Figura 8.17: Modicacin del criterio de bsqueda de un ltros.
(vi) Para grabar las modicaciones en el ltro, seleccionar la opera-
cin Save changes to lter. Para grabar las modicaciones en un
nuevo ltro y mantener el ltro original inalterado, seleccionar
la operacin Save as new lter.
8.12 Configurar el orden de columnas de un filtro
Como explicado en los captulos dedicados a las tecnologas de bs-
quedas ofrecidas por JIRA (??), las columnas visualizadas para los
resultados de bsqueda visualizados en el navegador de incidencias
dependern de las conguraciones que se hayan establecido tanto a
nivel de perl de usuario como a nivel de sistema.
La conguracin del navegador de incidencia se determina nave-
gando una jerarqua de conguraciones, ilustradas en Figura 8.18: la
conguracin que queda establecida es la primera conguracin que
JIRA encuentra a partir del nivel ms bajo de la jerarqua.
Figura 8.18: Jerarqua de conguracin del navegador de incidencias.
Sin embargo, los ltros aaden un elemento a esta jerarqua y JI-
RA ofrece la posibilidad de ignorar las conguraciones mencionadas
y asociar a un ltro una conguracin de columnas; la jerarqua de
conguraciones que JIRA analiza en este caso es la jerarqua ilustra-
da en Figura 8.19. De esta forma, si un ltro est asociado a una
conguracin de columnas personalizada, sta tendr la precedencia
con respeto a las dems conguraciones y ser la conguracin que
:
Figura 8.19: Jerarqua de conguracin del navegador de incidencias
Filtros.
quede establecida cuando JIRA visualice los resultados de bsqueda
de un ltro.
Por la naturaleza misma de los ltros y por el hecho de ser en-
tidades que pueden compartirse entre usuarios, el autor de un ltro
podra querer proporcionar a los usuarios que utilicen sus resulta-
dos tanto el criterio de bsqueda como la conguracin de columnas
devueltas. Si esto no fuera posible, usuarios con conguraciones dis-
tintas que estuvieran utilizando el mismo ltro acabaran viendo los
mismos resultados pero, potencialmente, distintas columnas. Depen-
diendo de la naturaleza de la bsqueda asociada al ltro, 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
conguracin por defecto del navegador de incidencias de JIRA no
incluye ninguna columna relacionada con el trabajo sobre las inci-
dencias, como por ejemplo tiempo trabajado y porcentaje de trabajo
completado. Si un usuario deseara compartir un ltro cuyo criterio de
bsqueda est ltrando por columnas de este tipo, ser aconsejable
congurar el mismo de manera que dichas columnas aparezcan en los
resultados; de esta forma, los usuarios que utilicen los datos que pro-
ceden del ltro podrn ver los datos que el creador del ltro consider
importantes y que, por esa razn, utiliz en el criterio de bsqueda
del mismo.
Para establecer la conguracin de columnas asociada a un ltro
(i) Acceder a la ventana de conguracin del orden de columnas
del ltro que se desea modicar. Se puede acceder a la ventana
de conguracin del orden de columnas de un ltro tanto des-
de la ventana de gestin de ltros como desde el navegador de
incidencia, cuando un ltro est seleccionado. Desde le venta-
:6
8.12. Congurar el orden de columnas de un ltro
na de gestin de ltro, se puede utilizar la operacin Columns
(Figura 8.20) del ltro que se desea modicar.
Figura 8.20: Ventana de gestin de ltros - Operaciones.
Desde la ventana del navegador de incidencias, cuando el ltro
a modicar est seleccionado, se puede utilizar la operacin Set
lters columns order del men Tools (Figura 8.21).
Figura 8.21: Navegador de incidencias - Conguracin de columnas de
un ltro.
(ii) En la ventana de conguracin de columnas se puede congurar
el orden de columnas del ltro de la misma forma en que se con-
gura el orden de columnas del navegador de incidencias. Vase
6.3.1 para obtener mayores detalles sobre el procedimiento de
conguracin.
8.12.1 Modificar la configuracin de columnas de un fil-
tro
La conguracin de columnas de un ltro puede modicarse utilizando
el procedimiento detallado a continuacin:
:
(i) Acceder a la ventana de conguracin del orden de columnas del
ltro que se desea modicar siguiendo las instrucciones detalla-
das en el la seccin precedente (8.12) teniendo en cuenta que,
cuando un ltro ya est asociado a una conguracin de colum-
nas, la operacin que aparece en el men Tools del navegador
de incidencias ser Edit lters column order, como ilustrado en
Figura 8.22.
Figura 8.22: Navegador de incidencias Men Tools Modicacin
de la conguracin de columnas de un ltro.
(ii) Seguir las instrucciones detalladas en la seccin precedente (8.12)
para modicar la conguracin de columnas del ltro.
8.12.2 Eliminar la configuracin de columnas de un fil-
tro
La conguracin de columnas de un ltro puede eliminarse para que
los resultados devueltos por un ltro vuelvan a mostrarse con la con-
guracin de columnas establecida a nivel de perl de usuario o, en
su defecto, a nivel de plataforma.
Para eliminar la conguracin de columnas de un ltro es necesario
(i) Acceder a la ventana de conguracin del orden de columnas del
ltro que se desea modicar siguiendo las instrucciones detalla-
das en el la seccin precedente (8.12) teniendo en cuenta que,
cuando un ltro ya est asociado a una conguracin de colum-
nas, la operacin que aparece en el men Tools del navegador
de incidencias ser Edit lters column order, como ilustrado en
Figura 8.22.
:8
8.13. Utilizar la conguracin de columnas por defecto
(ii) Seleccionar la operacin Remove lters column order (Figura
8.23) para eliminar la conguracin de columnas asociada al
ltro.
Figura 8.23: Navegador de incidencias Eliminar conguracin de
columnas de un ltro.
8.13 Utilizar la configuracin de columnas por defecto
En las secciones precedentes hemos visto como JIRA proporciona una
grande exibilidad a la hora de congurar las columnas a utilizar-
se en el navegador de incidencias. En determinadas situaciones, no
obstante, un usuario quisiera utilizar una conguracin de columnas
distintas a la establecida en el ltro. Esta situacin cobra mayor im-
portancia en el caso en que se est utilizando un ltro compartido por
otro usuario y, por lo tanto, no pueda modicarse su conguracin de
orden de columnas.
Para utilizar la conguracin de columnas del usuario, determina-
da con el procedimiento detallado en 8.12, puede utilizarse la ope-
racin 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 conguracin de columnas especicada por el ltro
corriente, ser suciente utilizar la operacin Use lters column order
del men Tools (Figura 8.24 derecha) para que JIRA presente los re-
sultados del ltro corriente en el navegador de incidencias utilizando
dicha conguracin.
:
Figura 8.24: Navegador de incidencias Seleccin de la conguracin
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 ltros entre usuarios y personalizar, incluso, las
columnas que JIRA visualice cuando ofrezca los resultados al usuario.
Sin embargo, la conguracin del orden de columnas no afecta slo
a los resultados visualizados en la ventana del navegador de inciden-
cias: 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 con-
guracin de columnas afectar la operacin de exportacin de datos
ya que, en determinadas circunstancias, sta determinar cuales sern
las columnas exportadas.
:o
9
Explotar los resultados de bsqueda
En los captulos precedentes se ha visto como los ltros 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 ltro pueden
explotarse tanto dentro JIRA, como por ejemplo para generar reportes
o grcos 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) XML.
(ii) Microsoft Word.
(iii) Microsoft Excel.
(iv) Correo electrnico.
9.1 Suscribirse a un filtro
JIRA permite a los usuarios suscribirse a un ltro y recibir peri-
dicamente, de forma automtica, los resultados de los ltro a travs
de un correo electrnico. El usuario podr especicar la periodicidad
con la cual JIRA volver a ejecutar el ltro y tambin si el usuario
desea recibir un correo incluso cuando el ltro 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 noticacin: el lugar de controlar activamente el estado y la
evolucin de las incidencias a observar, JIRA avisar al usuario
envindole los resultados.
:1
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 ltros, uno
para cada nivel de servicio a controlar, que devuelve la lista de inci-
dencias 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 ltros 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 ltro es necesario efectuar las siguientes ope-
raciones:
(i) Localizar el ltro al que se desea subscribirse en la ventana de
gestin de ltros, siguiendo las instrucciones detalladas en 8.4.
(ii) Seleccionar la operacin Subscribe en la columna Suscriptions
del ltro al que se desea suscribirse, como ilustrado en Figura
9.1.
Figura 9.1: Suscripcin a ltro.
(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 noticaciones. Este campo permite seleccionar a uno mis-
mo, escogiendo la opcin Personal subscription, o a un grupo
cualquiera de los grupos de usuarios de la plataforma.
::
9.1. Suscribirse a un ltro
Figura 9.2: Formulario de suscripcin a un ltro.
(v) Seleccionar el checkbox Email zero results si se desea recibir una
noticacin incluso cuando el ltro no devuelve ningn resulta-
do. Por defecto, este checkbox no est seleccionado.
(vi) Seleccionar la periodicidad con la cual se desea recibir las no-
ticaciones 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 ltro.
9.1.1 Periodicidad
La frecuencia que un usuario puede escoger cuando se suscribe a un
ltro es una de las siguientes:
(i) Daily: el usuario recibir las noticaciones todos los das.
(ii) Days per week: el usuario recibir las noticaciones los das de
la semana que haya escogido.
(iii) Days per month: el usuario recibir las noticaciones los das
del mes que haya escogido.
(iv) Advanced: el usuario recibir las noticaciones como determi-
nado por la expresin de tipo cron que se haya introducido.
Seleccionando la opcin Daily (i), el usuario recibir las noti-
caciones todos los das a un intervalo prejado, seleccionado con el
campo Interval, y a una hora prejada, seleccionada con los campos
at. Por defecto, el intervalo entre una noticacin y otra son : ho-
ras (once). Los valores que puede asumir el campo Interval estn
resumidos en Tabla 9.1.
:
Intervalos
horas
horas
horas
1 hora
o minutos
1 minutos
Tabla 9.1: Tipos de campos JQL.
Si el usuario selecciona recibir ms que una noticacin a lo largo
del da y escoge por lo tanto un intervalo distinto del intervalo :
horas, JIRA proporcionar al usuario la posibilidad de seleccionar la
franja horaria dentro de la cual el usuario desea recibir las notica-
ciones. La franja horaria [t
0
, t
1
] se seleccionar especicando la hora
de comienzo t
0
en el campo from y la hora de n t
1
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 ltro Seleccin de franja
horaria.
podr evitar de recibir noticaciones intilmente en horarios en los
cuales el usuario no est interesado a ellas.
Seleccionando la opcin Days per week (ii), el usuario recibir las
noticaciones 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 noticaciones marcando
:
los checkbox correspondientes a cada uno de ellos. Como en el caso
Figura 9.4: Formulario de suscripcin a un ltro Seleccin de das de
la semana.
(i), el interval podr asumir los valores especicados en Tabla 9.1
y, cuando aplique, especicar la franja horaria en la cual recibir las
noticaciones como explicado anteriormente.
Seleccionando la opcin Days per month (iii), el usuario recibir
las noticaciones 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 noticaciones de dos formas:
(i) Especicando el ordinal del da.
(ii) Especicando 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
noticacin se escoger utilizando los controles at.
Si la periodicidad con la cual el usuario desea recibir las notica-
ciones 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 especicar
:
Figura 9.5: Formulario de suscripcin a un ltro Seleccin de das del
mes.
una expresin de tipo cron en el campo Cron expression, ilustrado
en Figura 9.6. cron es un planicador de procesos utilizado en los
Figura 9.6: Formulario de suscripcin a un ltro Expresin cron.
sistemas operativos UNIX y UNIX-like cuya sintaxis de los cheros
de conguracin, muy conocida, puede ser utilizada por los usuarios
de JIRA para denir suscripciones avanzadas.
La sintaxis de los cheros de conguracin de cron es la siguiente:
segundos
minutos
horas
da del mes
mes
da de la semana
ao
(9.1)
:6
Los campos, separados por espacios, pueden asumir los valores espe-
cicados en Tabla 9.2 teniendo los caracteres especiales el signicado
detallado en Tabla 9.3.
Campo Valores Caracteres especiales
Segundos [0, 59] , - * /
Minutos [0, 59] , - * /
Horas [0, 23] , - * /
Da del mes [1, 31] , - * / ? L W
Mes [1, 12] o [Jan, Dec] , - * /
Da de la semana [1, 7] o [Sun, Sat] , - * / ? L #
Ao [1970, 2099] , - * /
Tabla 9.2: Valores de los campos de una expresin cron de JIRA.
Carcter especial Signicado
* Todos los posibles valores.
, Lista de valores.
- Intervalo de valores.
/ Incremento sobre un valor.
? Ningn valor.
L ltimo posible valor.
W Da de la semana (de lunes a viernes).
# n-esima ocurrencia de un da de la semana.
Tabla 9.3: Signicado de los caracteres especiales de una expresin cron
de JIRA.
Ejemplo 9.2. Para recibir una noticacin cualquier da de la sema-
na a las 10.00 de la maana se puede utilizar la expresin:
0 0 10 ? * *
Ejemplo 9.3. Para recibir una noticacin cualquier da de la se-
mana, cada minuto entre las 10.00 y las 11.00 se puede utilizar la
expresin:
0 * 10 * * ?
:
9.1.2 Cualquier valor
El carcter * se utiliza para asignar cualquier valor vlido a un cam-
po
1
:
. . * . . . .
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 especicar
un valor a uno de los campos das del mes o da de la semana pero
ninguno al otro
2
:
. . . ? . * .
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 campo
3
:
. . 9,12 . . . .
En este caso, se estn asignando al campo hora los valores y 1:.
mana, 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 noticacin 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.
:8
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 campo
4
:
. . 9-12 . . . .
En este caso, se estn asignando al campo hora el intervalo de valo-
res entre y 1: y, por lo tanto, el campo asumir todos los valores
comprendidos entre los extremos del mismo.
na, cada hora entre las 9.00 y las 18.00, se puede utilizar la expresin:
0 0 9-18 * * ?
mana, cada media hora entre las 9.00 y las 18.00, se puede utilizar la
expresin:
0 0,30 9-18 * * ?
na 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.
:
9.1.5 Incremento de un valor
El carcter / se utiliza para especicar 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 inicial
5
:
. . 0/2 . . . .
En este caso, se est asignando al campo hora cualquier valor vlido
obtenido aadiendo el incremento : al valor inicial o, es decir, los
valores 0, 2, 4, . . . , 22.
na, cada 10 minutos, se puede utilizar la expresin:
0 0/10 * * * ?
mana, 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 es-
pecicados
6
en Tabla 9.4.
Formato Signicado n i
L ltimo posible valor.
xL ltimo da a del mes.
LW ltimo da laborable del mes.
Tabla 9.4: Signicado de los caracteres especiales de una expresin cron
de JIRA.
5
Vase nota 1.
6
En Tabla 9.4 los smbolos w y m identican, respetivamente, los campos da
de la semana y da del mes.
:o
El formato bsico con el que se puede utilizar este carcter especial
es
7
:
. . . L . . .
En este caso, se est asignando al campo da del mes el ltimo va-
lor 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 r es un valor vlido para el campo:
en este caso signicar el ltimo da r del mes.
Este carcter especial tambin se puede utilizar con el campo da
del mes en el formato LW: en este caso signicar el ltimo da (entre
lunes y viernes) del mes.
Ejemplo 9.11. Para recibir una noticacin 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 noticacin 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 noticacin 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 especicar la n-esima ocurrencia de un
valor del campo da de la semana
8
:
. . . . . 6#2 .
7
Vase nota 1.
8
Vase nota 1.
:1
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 noticacin 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. :.o y la bsqueda a la que est asociado un feed RSS
puede ser una bsqueda grabada como ltro 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, JI-
RA 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 nece-
sario efectuar las siguientes operaciones:
(i) Utilizar el navegador de incidencias como detallado en ste ca-
ptulo 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 inci-
dencias 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 na-
vegador. Algunos navegadores, como ilustrado en Figura 9.7,
pueden visualizar el feed RSS y facilitar herramientas adiciona-
les tales como un lector de feed RSS.
(iv) Opcionalmente, modicar el valor del parmetro de solicitud
HTTP tempMax. El valor de este parmetro determina el n-
mero mximo de resultados devueltos en el feed RSS y, por
defecto, su valor es 1ooo.
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 noticar el usuario cuando la informacin
::
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 difundi-
dos 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 informa-
cin. 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 informa-
cin condencial y, por lo tanto, el usuario deber autenticarse para
poder acceder a los datos solicitados. Para acceder a la informacin
condencial 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
:
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. Pa-
ra 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 Conuence,
por ejemplo, utiliza este formato para recibir y utilizar informacin
que proviene de JIRA en las pginas de Conuence. Este formato
puede utilizarse si se est utilizando un lector de feeds RSS v. 0.9.2
9
.
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 denicin del for-
mato XML era la necesidad de denir 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
ujos 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 publi-
car los resultados de una bsqueda y poder as proporcionar dicha
direccin a la aplicacin que la utilice.
9
Si 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 na-
vegador.
(iv) Opcionalmente, modicar el valor del parmetro de solicitud
HTTP tempMax. El valor de este parmetro determina el n-
mero mximo de resultados devueltos en el documento XML y,
por defecto, su valor es 1ooo.
(v) Opcionalmente, congurar los campos que sern devueltos en el
documento XML siguiendo las instrucciones detalladas a conti-
nuacin (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 documen-
to recibido, el usuario puede especicar 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 suciente 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 frag-
mentos 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.
:
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 le Microsoft Word y, dependiendo del nave-
gador 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 conguracin 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 re-
portes, ltrados de datos, agregaciones, grcos son solo algunas de
las operaciones que pueden hacerse con Microsoft Excel sobre un con-
junto de datos.
:6
9.6. Visualizar los resultados en un grco
Para exportar los resultados a un documento de Microsoft Excel
(ii) Seleccionar la operacin Excel (All elds) o Excel (Current elds)
en el men Views (6.2.2): la primera operacin permite expor-
tar todos los campos de las incidencias encontradas y la segunda
permite exportar solo los campos congurados en el navegador
de incidencias (vanse ?? y 8.12).
(iii) JIRA generar un le Microsoft Excel y, dependiendo del nave-
gador 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 gene-
rado 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 grcos disponibles,
detallados a continuacin. El usuario que haya generado un grco
tendr adems la posibilidad de grabar el grco en un gadget del
cuadro de mandos de forma muy sencilla.
:
Los tipos de grcos que JIRA ofrece incluyen, entre otros:
(i) Average age. Grco de la edad media de una incidencia sin
resolver (Figura 9.13).
(ii) Created vs. resolved issues. Grco de la diferencia entre in-
cidencias creadas y resueltas. El grco, 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. Grco de barra del tiempo
10
de resolucin
medio de las incidencias (Figura 9.12).
(iv) Pie chart. Grco de torta de las incidencias agrupadas por
cualquier tipo de estadstica (asignatario, estado, prioridad, etc.)
(Figura 9.12).
(v) Recently created. Grco de barra cuya parte verde son las in-
cidencias resueltas y cuya parte roja son las incidencias creadas
y no resueltas (Figura 9.12).
(vi) Time since. Grco 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 grco (Figura 9.15).
Para visualizar los resultados de una bsqueda en un grco, es
(i) En la ventana de resultados del navegador de incidencias, selec-
cionar la operacin Charts en el men Views debajo de la barra
de herramientas, como ilustrado en Figura 9.17.
(ii) Seleccionar el grco que se desea visualizar en la ventana de
seleccin presentada por JIRA.
(iii) Si se desea modicar los parmetros de conguracin del grco
seleccionado, pulsar el control identicado con un engranaje
ilustrado en Figura 9.18, personalizar los parmetros del gr-
co y pulsar el botn Save.
9.6.1 Visualizar los resultados de bsqueda en el cuadro
de mandos
Los grcos 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 tiempo de resolucin medio se mide en das.
:8
Figura 9.10: Grco Agerage age.
Figura 9.11: Grco Created vs. resolved.
:
Figura 9.12: Grco Created vs. resolved.
Figura 9.13: Grco Pie chart.
:6o
Figura 9.14: Grco Recently created.
Figura 9.15: Grco Time since.
:61
Figura 9.16: Navegador de incidencias Tipos de grco.
Figura 9.17: Navegador de incidencias Ver como grco.
:6:
Figura 9.18: Navegador de incidencias Personaliza grco.
ser necesario regenerar el grco 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 grco generado con los resultados de una bsque-
da es necesario efectuar las siguientes operaciones:
(i) Generar el grco siguiendo las instrucciones detalladas en 9.6.
(ii) Pulsar el botn Save to dashboard en la ventana de conguracin
del grco.
(iii) Seleccionar el cuadro de mando en que se desea aadir el gadget
en el campo Select dashboard de la ventana de seleccin del cua-
dro 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 auto-
mticamente 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 ltro aso-
ciado a la bsqueda corriente que JIRA crear conjuntamente
al gadget del cuadro de mando.
:6
Figura 9.19: Grabacin de grco en el cuadro de mando Seleccin
de cuadro de mando.
Figura 9.20: Grabacin de grco en el cuadro de mando Creacin
automtica de un cuadro de mando.
(v) Pulsar el botn Save.
JIRA crear un ltro 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 congurado utilizando las herra-
mientas del cuadro de mando.
:6
10
Generar reportes
La informacin almacenada en un sistema es valiosa si puede ser ex-
plotada. Una herramienta como JIRA va almacenando continuamente
informacin de inters para una organizacin y es fundamental poder
consultarla de forma eciente cuando sea necesario.
En los captulos precedentes se ha detallado como la funcionalidad
de bsqueda de JIRA proporciona una herramienta sosticada 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 grcos. 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.
:6
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.
:66
10.1. Workload pie chart
Nombre Descripcin
Workload pie
chart
Carga de trabajo media de los usuarios asignados
a las incidencias de un proyecto o devueltas por
un ltro.
User workload Carga de trabajo de un usuario y tiempo estima-
do para la nalizacin de los trabajos.
Version workload Trabajo a nalizar, para usuarios y para inciden-
cias, antes de que nalice una versin.
Version time trac-
king
Tiempo estimado para la nalizacin de los tra-
bajos de una versin, calculado utilizando regis-
tros de trabajos y estimaciones de tiempo de tra-
bajo requerido de las incidencias.
Single level group
by
Resultados de un ltro, agrupados por un campo
a eleccin del usuario.
Created vs. resol-
ved issues
Nmero de incidencias creadas contra nmero de
incidencias resueltas en un intervalo de tiempo
especicado.
Resolution time Tiempo medio de resolucin de las incidencias.
Pie chart Resultados de un ltro o de un proyecto, agrupa-
dos por un campo a eleccin del usuario, en un
grco de torta.
Average age Edad media de las incidencias (en das).
Recently created
issues
Frecuencia de creacin de las incidencias.
Time since issues Nmero de incidencias que tienen un campo de
tipo fecha, escogido por el usuario, igual a la fe-
cha 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 in-
cidencias sobre el cual se efecta el clculo puede ser el conjunto de
incidencias de un entero proyecto o las incidencias devueltas por un
ltro 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].
:6
Para generar un reporte de este tipo es necesario efectuar las si-
guientes 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 conguracin del reporte (Figura 10.3), selec-
cionar el proyecto o el ltro que proporciona los datos al mismo
seleccionando el enlace Select lter or project. . . a la derecha
del campo Project or saved lter. Aparecer la ventana de se-
Figura 10.3: Workload pie chart Conguracin.
leccin de proyecto o ltro (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 ltro.
(iv) Seleccionar el campo utilizado para agregar los datos en el gr-
co de torta utilizando el men desplegable del campo Statistic
type. Por defecto el campo seleccionado es Assignee.
:68
10.1. Workload pie chart
(v) Seleccionar la estimacin de tiempo a utilizar en el men desple-
gable del campo Time eld 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 grco 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
:6
indicado durante la conguracin 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 nalizacin 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 conguracin del reporte (Figura 10.6), se-
leccionar el usuario del que se desea obtener el reporte introdu-
ciendo su nombre en el campo User o buscndolo a travs del
buscador de usuarios al que se accede seleccionando el control
identicado por el icono ( ) situado a la derecha del mismo
campo.
Figura 10.6: User workload Conguracin.
(iv) Seleccionar el botn Next para generar el reporte.
Un ejemplo de reporte de este tipo, generado para el usuario enri-
co, 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
:o
10.3. Version workload
Figura 10.7: Report User workload.
uno de los proyectos indicados (segunda columna); en la ltima co-
lumna 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 nalizar, para usua-
rios y para incidencias, antes de que nalice una versin de un pro-
yecto.
del proyecto.
(iii) Congurar el reporte en la ventana de conguracin del repor-
te (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 unesti-
mated issues si se desea incluir en el reporte las incidencias para
las cuales no exista una estimacin de tiempo restante para la
nalizacin.
(vi) Seleccionar en el men desplegable del campo Sub-task inclusion
qu tipo de sub-tareas se desean incluir en el reporte:
:1
Figura 10.8: Version workload Conguracin.
a) Seleccionar el valor Only including sub-tasks with the se-
lected 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 ver-
sion set para incluir en el reporte las sub-tareas que ten-
gan 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.
::
10.4. Time tracking
trabajo que queda por efectuar desglosada por usuario y tipo de inci-
dencia. 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 nali-
zacin 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 nalizar a tiempo o en
retraso, respeto a la estimacin original.
del proyecto.
(iii) Congurar el reporte en la ventana de conguracin del reporte
(Figura 10.10) siguiendo las instrucciones que se detallan a
continuacin.
Figura 10.10: Time tracking Conguracin.
(iv) Seleccionar en el men desplegable del campo Fix version la
versin del proyecto para la cual se desea generar el reporte:
:
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 rst para ordenar las
incidencias con estimacin de tiempo restante descendien-
te.
b) Seleccionar Most completed issues rst para ordenar las
incidencias con estimacin de tiempo restante ascendiente.
(vi) Seleccionar en el men desplegable del campo Issues cuales in-
cidencias incluir en el reporte:
a) Seleccionar All para incluir todas las incidencias de la ver-
sin 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 se-
lected 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 ver-
sion set para incluir en el reporte las sub-tareas que ten-
gan 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 t
f
del tiempo necesario
para nalizar la incidencia.
(ii) Estimated time remaining: la estimacin actual t
a
del tiempo
necesario para nalizar la incidencia.
:
10.4. Time tracking
Figura 10.11: Report Time tracking.
(iii) Time spent: la cantidad de tiempo t
s
trabajado en la incidencia.
(iv) Accuracy: la exactitud de la estimacin original comparada con
la estimacin actual calculada como
o
t
= t
f
(t
s
+ t
a
) (10.1)
Si o
t
es o
t
< 0, la incidencia est en retraso con la estimacin,
mientras que si o
t
0 la incidencia est respetando la estima-
cin inicial.
Si las sub-tareas estn habilitadas en la plataforma, cada una de
las 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 / tiene un con-
junto de n sub-tareas /
i
: i [1, n], i N, el valor agregado para
un campo r cualquiera de los campos indicados en precedencia ser:
r(/) =
n
1
r(/
i
) (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 represen-
tacin grca del estado de progreso y exactitud de las estimaciones
:
Figura 10.12: Report Time tracking Barras de resumen.
para la versin seleccionada (Figura 10.12). El grco 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 completn-
dose 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 ltro 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 planicadas
para solucionarse en una versin del proyecto. Para generar este
reporte, el jefe de proyecto podr crear un ltro que devuelva las
incidencias buscadas:
project=... and component=... and version=... and status=open
:6
10.6. Created vs. resolved issues
Para agrupar los resultados del ltro por asignatario, el usuario
podr congurar un reporte de tipo Single level group by para que
utilice el ltro en cuestin y agrupe las incidencias utilizando el campo
Assignee.
del proyecto.
continuacin.
Figura 10.13: Single level group by Conguracin.
(iv) Seleccionar el ltro a utilizarse como fuente de datos del re-
porte utilizando la ventana de seleccin de ltros que aparece
seleccionando el enlace Select lter. . . 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, congurado agregando las
incidencias por el campo Assignee, est ilustrado en Figura 10.14.
En el ltro pueden verse las incidencias devueltas por el ltro 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 ltro o
:
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 ltro o el proyecto asociado al reporte utilizando
la ventana de seleccin de ltros y proyectos a la que se acce-
de utilizando el enlace Select lter or project. . . en el campo
Project or saved lter.
(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 grco. El
reporte utilizar los datos procedentes de las incidencias creadas
:8
10.6. Created vs. resolved issues
Figura 10.15: Created vs. resolved Conguracin.
Nombre Descripcin
Hourly Intervalo de una hora.
Daily Intervalo de un da.
Weekly Intervalo de una semana.
Monthly Intervalo de un mes.
Quarterly Intervalo de meses.
Yearly Intervalo de un ao.
Tabla 10.2: Reporte Intervalos temporales.
o modicadas en el intervalo temporal [t
0
n, t
0
] siendo t
0
la
fecha actual de generacin del grco.
(vii) Seleccionar en el men desplegable del campo Cumulative to-
tals? si los datos del reporte deben ser cumulativos o invididua-
les.
(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 grco.
(ix) Seleccionar el botn Next para generar el reporte.
Un ejemplo de reporte de este tipo, generado utilizando los par-
metros:
Period = Daily
Days previously = 30
(10.3)
:
est ilustrado en Figura 10.16 y 10.17.
Figura 10.16: Report Created vs. Resolved Grco.
Las areas verdes del grco representan los intervalos de tiempo
en los cuales el nmero de incidencias resueltas i
r
, ha sido mayor que
el nmero de incidencias creadas i
c
:i
r
i
c
. Las areas rojas, al revs,
representan los intervalos de tiempo en los cuales i
r
< i
c
.
El mismo conjunto de datos se ha utilizado para generar el si-
guiente reporte, utilizando los siguientes parmetros:
Period = Weekly
(10.4)
Como puede verse en Figura 10.18, los datos diarios del grco
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
:8o
10.7. Resolution time
Figura 10.17: Report Created vs. Resolved Tabla de datos.
suma y que las areas coloreadas en el primer grco se reejan en las
areas coloreadas en el mismo color en el segundo grco.
10.7 Resolution time
El reporte Resolution time resume el tiempo medio que se ha reque-
rido para resolver las incidencias, calculado en intervalos de longitud
especicada por el usuario. El conjunto de incidencias analizadas en
este tipo de reporte puede proceder tanto de un ltro como de un
entero proyecto.
del proyecto.
continuacin.
:81
Figura 10.18: Report Created vs. Resolved Grco.
Figura 10.19: Resolution time Conguracin.
:8:
10.8. Pie chart
0
n, t
0
] siendo t
0
la
metros:
Period = Daily
(10.5)
En el grco de barras del reporte puede verse el tiempo medio de
resolucin, calculado sobre el intervalo especicado, representado por
la altura j de las barras. En la tabla de datos pueden apreciarse los
mismos datos en forma numrica: la tabla tiene o registros, como
especicado en el parmetro Days previously y la media del tiempo
de resolucin se ha calculado en base diaria, como especicado 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 grca en un grco 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 planicadas para solucionarse en una versin del
proyecto. En este caso, sin embargo, el jefe de proyecto quiere ilustrar
los resultados en un grco de tarta.
:8
Figura 10.20: Report Resolution time Grco.
Para agrupar los resultados del ltro por asignatario, el usuario
podr congurar un reporte de tipo Pie chart para que utilice el ltro
en cuestin y agrupe las incidencias utilizando el campo Assignee.
del proyecto.
continuacin.
(iv) Seleccionar el ltro o el proyecto a utilizarse como fuente de
datos del reporte utilizando la ventana de seleccin de ltros
y proyectos que aparece seleccionando el enlace Select lter or
project. . . en el campo Project or saved lter.
:8
10.8. Pie chart
Figura 10.21: Report Resolution time Tabla de datos.
Figura 10.22: Pie chart Conguracin.
:8
(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, congurado agregando las
incidencias por el campo Assignee, est ilustrado en Figura 10.23 y
10.24.
Figura 10.23: Report Pie chart Grco.
Figura 10.24: Report Pie chart Tabla de datos.
Como puede observarse, el grco de torta ilustra el porcentaje
de incidencias que componen cada uno de los conjuntos obtenidos
agregando las incidencias por el campo especicado. En la tabla de
datos, se detallan de forma numrica los datos ilustrados en el grco.
:86
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 Conguracin.
0
n, t
0
] siendo t
0
la
:8
metros:

Period = Daily
(10.6)
Figura 10.26: Report Average age Grco.
En el grco del reporte puede verse una barra por cada intervalo
especicado 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
:88
10.10. Recently created issues
Figura 10.27: Report Average age Tabla de datos.
conjunto de incidencias devueltas por un ltro o un proyecto y un
intervalo de tiempo escogido por el usuario.
del proyecto.
continuacin.
:8
Figura 10.28: Recently created issues Conguracin.
0
n, t
0
] siendo t
0
la
metros:

Period = Daily
(10.7)
especicado 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 inciden-
cias 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 indica-
da. En conjunto de incidencias analizado en el reporte puede proceder
de un ltro o de un proyecto escogido por el usuario.
:o
10.11. Time Since Issues Report
Figura 10.29: Report Recently created issues Grco.
del proyecto.
continuacin.
(v) Seleccionar en el men desplegable del campo Date eld el cam-
po 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
:1
Figura 10.30: Report Recently created issues Tabla de datos.
Figura 10.31: Time since issues Conguracin.
::
10.11. Time Since Issues Report
0
n, t
0
] siendo t
0
la
(viii) Seleccionar en el men desplegable del campo Cumulative to-
tals? si los totales deben ser cumulativos o individuales.
(ix) Seleccionar el botn Next para generar el reporte.
metros:

Period = Daily
(10.8)
Figura 10.32: Report Time since issues Grco.
especicado por el usuario cuya altura indica el nmero de incidencias
cuyo campo especicado es igual a la fecha del intervalo correspon-
diente. En la tabla de datos del reporte pueden verse los mismos
datos en forma numrica.
:
Figura 10.33: Report Time since issues Tabla de datos.
10.12 Cach de los navegadores
Dependiendo de la conguracin 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, congurar la
cach de forma que compruebe de forma automtica si existe una
versin actualizada para una pgina presente en la cach.
:
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 conguracin 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 co-
mo 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 especcas de
proyecto, o incluso los ltros, 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 necesi-
dad: 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 ltros: de esta forma el usuario puede denir de forma sen-
cilla la bsqueda de los datos que le interesan (como explicado en 6 y
posteriores), grabarla para reutilizarla y compartirla con otros usua-
rios e utilizar los gadgets para agregar y visualizar esta informacin
en ventanas dedicadas.
Un usuario podr denir tantos cuadros de mandos como necesite
e, incluso, compartirlos con otros usuarios. Los cuadros de mandos,
por lo tanto, son ventanas de reporting exible y fcil de utilizar que
pueden considerarse tambin activos de la plataforma: los jefes de
:
11. Gestionar los cuadros de mandos
proyectos de proyectos distintos podrn, por ejemplo, compartir un
cuadro de mando que dena la estructura de la informacin que
necesitan. La exibilidad de los ltros 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 procedi-
miento 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 exibilidad. 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 APIs
1
que en un principio fue pro-
mocionado por Google y otras empresas con el n 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 proporcio-
nando al usuario una forma efectiva y sencilla de poder personalizar,
de acuerdo a sus necesidades y a sus gustos, las ventanas de las apli-
caciones. 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 con-
gurar 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, siem-
pre 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 apli-
caciones que utilizan.
1
Application Programming Interfaces (Interfaces de Programacin de Aplica-
cin).
:6
11.1. Contenedores de gadgets OpenSocial
Figura 11.1: Cuadro de mandos vaco.
Figura 11.2: Cuadro de mandos Disponer un gadget.
:
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 ltros, pueden:
(i) Crearse.
(ii) Compartirse.
(iii) Buscarse.
(iv) Marcarse como favoritos.
Los usuarios pueden utilizar la ventana de gestin de cuadros de man-
dos 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.
:8
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 co-
nectado. Las operaciones disponibles en esta ventana estn de-
talladas 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 fun-
cionalidad 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 ltros, pueden
marcarse como favoritos. Los cuadros de mandos favoritos se propo-
nen 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 identicados con un icono
estrella amarilla ( ). Seleccionando este control se puede quitar un
cuadro de mando de la lista de favoritos. JIRA avisar el usuario
:
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: Conrmacin 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 conrmacin
(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
favoritos
2
y seleccionar el control identicado 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 modicados
sino por el administrador de JIRA, pueden crear cuadros de mandos
adicionales que pueden congurarse a placer.
2
En las siguientes secciones se detallarn varios mecanismos proporcionados
por JIRA para encontrar un cuadro de mando.
oo
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 conti-
nuacin.
Independientemente de como se haya creado el cuadro de mandos, el
usuario podr modicarlo 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 ma-
queta 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, identicado con el icono estrella amarilla
( ), como explicado en 11.2.1.
o1
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, identicado
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) Conrmar la creacin del cuadro de mandos seleccionando el
o:
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 modicaciones 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 co-
piar 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 formula-
rio de creacin ser valorizado con el cuadro escogido. El usuario
podr seguir congurando 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 cua-
dro de mandos pueden modicarse a posteriori utilizando la ventana
de modicacin de cuadro de mandos. Para acceder a la ventana de
modicacin es necesario seleccionar la operacin Edit del cuadro de
mandos a modicar en una de las ventanas de gestin, como ilustra-
do en Figura 11.10. Seleccionando esta operacin, el usuario ser
llevado al formulario de modicacin de cuadro de mandos, ilustrada
o
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 modicacin de cuadros de mandos
detalladas en 11.2.3, el usuario podr modicar 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 ges-
tin de cuadros de mandos, como ilustrado en Figura 11.12. Despus
de haber seleccionado esta operacin, JIRA pedir conrmacin al
usuario con una ventana parecida a la ilustrada en Figura 11.13.
Despus de haber conrmado la operacin, JIRA proceder a la eli-
minacin del cuadro seleccionado.
o
11.3. Bsqueda de cuadro de mandos
Delete
Figura 11.13: Ventana de conrmacin de eliminacin de cuadro de
mandos
11.3 Bsqueda de cuadro de mandos
La ventana de bsqueda de cuadro de mandos, ilustrada en Figu-
ra 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 compar-
tido.
Para buscar un cuadro de mandos es necesario efectuar las siguien-
tes 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
o
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 identicado 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 for-
mulario 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
o6
11.3. Bsqueda de cuadro de mandos
lista de favoritos utilizando el procedimiento descrito en 11.2.1.
o
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 man-
dos, como explicado en 12.2.
(iii) Tools, un men desplegable (Figura 12.2) que ofrece opera-
ciones 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
o
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
1o
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 selec-
cionada.
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 admi-
nistrador de la plataforma puede aadir gadgets adicionales y que, por
la naturaleza y la exibilidad proporcionada por el estndar Open-
Social, 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
11
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 bs-
queda 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 nalizar 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 fuen-
te de datos para proporcionar informacin al usuario, necesitan ser
congurados despus de haberlos aadido a un cuadro de mandos. El
proceso de conguracin es especco de cada gadget y a continua-
cin (12.7 y sucesivas) se detallar el proceso de conguracin de los
gadgets distribuidos con JIRA.
1:
12.4. Operaciones sobre un gadget en un cuadro de mandos
12.4 Operaciones sobre un gadget en un cuadro de man-
dos
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 ilus-
trado en Figura 12.6, permite efectuas operaciones comunes sobre
un gadget:
(i) Cambiar el tamao del gadget.
1
(ii) Cambiar el color del gadget, escogindolo de una lista de colores
ofrecidos por JIRA.
(iii) Eliminar el gadget.
(iv) Congurar 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 suciente arras-
trar 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
1
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 se-
leccionar la operacin Delete del men de operaciones del gadget,
como descrito en 12.4. JIRA pedir conrmacin al usuario, en una
ventana parecida a la que se ilustra en Figura 12.8, y si el usuario
conrma la operacin pulsando el botn Ok JIRA eliminar el gadget
seleccionado del cuadro de mandos.
Figura 12.8: Ventana de conrmacin 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 Descripcin
Activity stream Resumen de la actividad reciente.
Administration Enlaces rpidos a funciones administrativas.
Assigned to me Incidencias abiertas en cualquier proyecto
asignadas al usuario conectado.
Average age Grco de barras del nmero medio de das
en los cuales una incidencia se ha quedado
abierta.
1
Gadget Descripcin
Bamboo charts
Grcos y estadsticas de una instancia de

Bamboo.
Bamboo plan sum-
mary chart
Resumen grco de un plan de construccin

de Bamboo.
Bamboo plans
Resumen de los planes de una instancia de

Bamboo y de sus estados.
Bugzilla ID search Bsqueda por ID de una incidencia en una
instancia de Bugzilla.
Calendar
Fechas de caducidad de incidencias y versio-

nes en un calendario.
Clover coverage
Cobertura de Clover de planes de una instan-

cia de Bamboo.
Created vs. resolved Grco de diferencias de las incidencias crea-
das y resueltas en un intervalo de tiempo.
Crucible charts
Resmenes estadsticos grcos de las revi-

siones de Crucible.
Favourite lter Lista de los ltros favoritos del usuario co-
nectado.
Filter result Resultados de un ltro.
FishEye charts
Grcos de estadsticas sobre un repositorio

de FishEye.
FishEye recent chan-
gesets
Resumen de los cambios recientes en un re-

positorio de FishEye.
In progress Incidencias en progreso y asignadas al usua-
rio conectado.
Introduction Mensaje de bienvenida congurable.
Issue statistics Estadsticas sobre los resultados de un ltro
por el campo especicado.
JIRA: news Noticias recientes sobre Atlassian JIRA.
Pie chart Grco de torta de los resultados de un ltro
o las incidencias de un proyecto agrupadas
por el campo especicado.
Projects Informacin y ltros relacionados con el pro-
yecto especicado.
Quick links Enlaces tiles a incidencias asignadas al
usuario conectado.
Recently created is-
sues
Grco de barras de la frecuencia de creacin
y resolucin de las incidencias.
Resolution time Grco de barras del tiempo medio de reso-
lucin de las incidencias.
Road map Resumen del road map de versiones a entre-
gar y del trabajo a realizar por cada versin.
16
12.8. Activity stream gadget
Gadget Descripcin
Text
Fragmento HTML congurable.

Time since issues Grco de barras del nmero de incidencias
cuyo campo de tipo fecha elegido cumpla el
criterio escogido.
Two dimensional lter
statistics
Datos estadsticos sobre el ltro escogido en
forma tabular.
Voted Incidencias votadas por el usuario conectado.
Watched Incidencias observadas por el usuario conec-
tado.
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 acti-
vidad reciente en un grupo de proyectos, opcionalmente ltrada 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 congurar este gadget es necesario efectuar las siguientes
operaciones:
(i) Acceder a la pantalla de conguracin del gadget, ilustrada en
Figura 12.9.
(ii) Seleccionar los proyectos cuya actividad se desea observar selec-
cionndolos en la lista de seleccin mltiple del control Projects.
(iii) Opcionalmente, seleccionar los usuarios con los cuales se desea
ltrar la lista de resultados introduciendo sus nombres, separa-
dos 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) Conrmar la conguracin pulsando el botn Save.
1
Figura 12.9: Gadget Activity stream Conguracin
Despus de haber congurado 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 adminis-
trativas ms comunes. Debido a la naturaleza de las operaciones pro-
porcionadas, 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 conguracin y un ejemplo
puede verse ilustrado en Figura 12.11.
18
12.9. Administration gadget
Figura 12.10: Gadget Activity stream
Figura 12.11: Gadget Administration
1
12.10 Assigned to me gadget
El gadget Assigned to me proporciona la lista de incidencias asig-
nadas al usuario corriente y las columnas visualizadas en la lista de
resultados pueden ser conguradas 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) Conrmar la conguracin pulsando el botn Save.
:o
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 grco de la edad media
(en das) de las incidencias no resueltas, en el proyecto o en el ltro
especicado, en los instantes especicados.
operaciones:
Figura 12.14.
(ii) Seleccionar el proyecto o el ltro a utilizarse como fuente de
datos introduciendo su nombre en el control Project or saved
lter o seleccionndolo en la ventana de seleccin de ltros y
proyectos a la que se accede seleccionando el control Advanced
search.
:1
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) Conrmar la conguracin pulsando el botn Save.
::
12.11. Average age chart gadget
Figura 12.15: Gadget Average age chart
:
13
Gestionar el perl del usuario
El perl 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 especicar 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 conguracin de inters muy comn
que pueden establecerse a nivel de perl de usuario son:
(i) El tamao de pgina.
(ii) El idioma del interfaz grco.
(iii) El huso horario utilizado en la actualidad.
(iv) El tipo de formato de email que se desean recibir.
(v) Las columnas visualizadas por defecto en los navegadores de
incidencia.
Para acceder al perl del usuario, es necesario seleccionar el propio
nombre de usuario en la barra de herramientas de JIRA o el elemento
Prole en ese mismo men desplegable (como puede verse en Figura
13.1):
La ventana del perl de usuario (Figura 13.2), contiene algunos
paneles, sobre los cuales destacan los siguiente
1
:
(i) Details: donde puede consultarse un resumen de los detalles del
usuario.
1
Los paneles visibles en la ventana del perl de usuario pueden depender de
las caractersticas de la instalacin de la plataforma y de la informacin presente
por cada uno de los usuarios.
:
13. Gestionar el perfil del usuario
Figura 13.1: Barra de herramientas Perl de Usuario
(ii) Preferences: un conjunto de conguraciones y personalizaciones
de la plataforma.
(iii) Activity Stream: el ujo de actividad del usuario en cuestin.
Figura 13.2: Perl de Usuario
Para modicar 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
modicables.
:6
13.1. Modicar los detalles del usuario
13.1 Modificar los detalles del usuario
En el panel Details es posible modicar los siguientes parmetros:
(i) El avatar del usuario.
(ii) El nombre completo del usuario.
(iii) La direccin email del usuario.
(iv) La contrasea del usuario.
Para modicar 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), modicar los parmetros que se desean modicar utili-
zando los campos correspondientes.
Figura 13.3: Perl de usuario Edicin de los detalles de usuario
13.1.1 Modificar el avatar del usuario
Para modicar el avatar del usuario, es necesario efectuar las siguien-
tes 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.
:
Figura 13.4: Perl de usuario Edicin del avatar del usuario
(iii) En la ventana de edicin del avatar (Figura 13.4) puede se-
leccionarse a) un avatar entre los distribuidos con JIRA, dispo-
nibles en la pestaa Built-in; b) un avatar entre todos los dis-
ponibles en la plataforma, disponibles en la pestaa All ; c) un
avatar entre los subidos por el usuario, disponibles en la pes-
taa Custom. Para seleccionar un avatar entre los avatares
existentes, es necesario seleccionarlo con un click del mouse.
(iv) Si se preere 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, seleccio-
nar 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 modicarse 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 modicarse di-
:8
13.1. Modicar los detalles del usuario
Figura 13.5: Perl de usuario Edicin del avatar del usuario
rectamente seleccionando el enlace Change Password del campo Pass-
word 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 Conrm
Password.
(iv) Conrmar la operacin pulsando el botn Update.
Figura 13.6: Perl de usuario Cambio de contrasea
:
13.2 Modificar las preferencias del usuario
En el panel Preferences pueden cambiarse los siguientes parmetros
de conguracin del usuario:
(i) Page Size (Tamao de pgina): el nmero de incidencias visua-
lizadas 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 usua-
rio recibe noticaciones sobre sus propios cambios.
(vi) Sharing (Intercambio): valor por defecto de la opcin de inter-
cambio de ltros 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 visi-
bles 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 modicacin de preferencias (Figura 13.7) accesible
seleccionando el icono de edicin ( ).
13.2.1 Cambiar las columnas del navegador de inciden-
cias
Las columnas que por defecto se utilizan en el navegador de inciden-
cias se establecen utilizando las siguientes opciones:
(i) Las columnas especicadas en el perl del usuario conectado, si
existen.
(ii) Las columnas especicadas por el administrador a nivel de pla-
taforma.
Cada usuario, por lo tanto, puede personalizar el aspecto del navega-
dor de incidencias para que se utilicen, por defecto, las columnas que
ms le interesen.
Para modicar las columnas que el navegador de incidencias uti-
lizar por defecto, es necesario efectuar las siguientes operaciones:
o
13.2. Modicar las preferencias del usuario
Figura 13.7: Perl de usuario Modicacin de las preferencias
(i) Seleccionar el enlace View Navigator Columns en el campo Na-
vigator Columns.
(ii) Seguir el procedimiento ya ilustrado en 6.3.
1
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>
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:
6
<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:
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>
8
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>
B
Campos y funciones JQL
Este captulo es un captulo de referencia sobre los aspectos del len-
guaje 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 so-
portados por cada uno de los campos. La mayora de las caractersti-
cas 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 ltrados tanto
por nombre como por identicador. Los identicadores son coorde-
nadas nicas, generalmente numricas, que JIRA establece al mo-
mento de la creacin de una entidad y no cambiarn nunca a lo
largo de la vida de la misma. Los nombres, sin embargo, son mne-
mnicos asignados por los administradores del proyecto y pueden
cambiarse en cualquier momento.
Durante la edicin de consultas que utilicen campos con esta ca-
racterstica, es aconsejable utilizar el identicador en lugar del nombre
siempre que se pueda. Debido a la volatilidad de los nombres, las
1
B. Campos y funciones JQL
consultas que utilicen este dato son frgiles y susceptibles a invalidar-
se con el paso del tiempo. Si, adems, se decide grabar una consulta
y almacenarla como ltro, es todava ms importante utilizar par-
metros que no estn susceptibles a variaciones ya que, con el paso del
tiempo, una modicacin en un nombre podra invalidar cualquier
ltro que est utilizando este ltimo como valor de un campo.
La utilizacin de identicadores en lugar de nombres aporta ade-
ms otra ventaja. Los identicadores son coordenadas nicas a nivel
global : ninguna entidad de JIRA, en cualquier proyecto, podr ser
asignada un identicador 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 precau-
ciones
1
, 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) Versin
(ii) Componente
(iii) Filtro
(iv) Nivel de seguridad
(v) Prioridad
(vi) Resolucin
(vii) Estado
(viii) 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 de-
termina 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 ltrar de forma explcita la lista de proyectos en la que se est
efectuando la bsqueda.
:
B.1. Campos
Tipo Smbulo Clave/Valor
Versin v
Usuario u
Categora l
Texto t
Componente c
Fecha f
Filtro x
Incidencia i
Nivel de seguridad s
Duracin d
Prioridad o
Proyecto p
Resolucin r
Estado e
Tipo de incidencia y
Nmero n
Cascading option 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 identicador/nombre durante la evaluacin de las consul-
tas. 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) = y ,=, indicados con el smbulo =.
(ii) y !, indicados con el smbulo .
(iii) , , < y , indicados con el smbulo .
(iv) is, is not, indicados con el smbulo .
(v) in, not in, indicados con el smbulo .

Si un campo soporta un operador entonces soportar tambin el ope-
rador 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 denidos en Tabla B.1.
tipo =
affectedVersion v
assignee u
category l
comment t
component c
created f
description t
due f
environment t
filter x
fixVersion v
issueKey i
level s
originalEstimate d
parent i
priority o
project p
remainingEstimate d
reporter u
resolution r
resolved f
status e
summary t
text t
type y
timeSpent d
updated f
voter u
votes n
watcher u
workRatio 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:
B.1. Campos
(i) Numricos: los campos de tipo nmero o fecha soportarn re-
laciones 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 funciona-
lidades 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.
tipo =
affectedVersion v
fixVersion v
releasedVersions()
unreleasedVersions()
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 identicador de versin en las bsquedas, espe-
cialmente cuando las bsquedas se graban en ltros. De esta forma,
siendo ste un valor nico que no puede cambiarse, los ltros existen-
tes no se vern afectados por eventuales operaciones de renombrado
de las versiones de un proyecto.

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 identicados es 1oo, ser necesario utilizar la siguiente propo-
sicin:
affectedVersion = 10350
B.1.5 Campos de tipo usuario
Los campos de tipo usuario soportan los operadores y las funciones
tipo =
assignee u
reporter u
voter u
watcher u
currentUsers()
membersOf()
usuario.
El valor especicado para un campo de tipo usuario se comparar
con los atributos nombre, identicado y direccin de correo electr-
nico de los usuarios de JIRA y se devolvern aquellas incidencias
para las cuales al menos uno de estos atributos satisfaga el criterio
especicado.
Cuando se evalen proposiciones que utilicen los campos voter y
watcher se podr acceder exclusivamente a los valores para los cuales
6
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 especicada, 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
tipo =
category l

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 bs-
quedas 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

tipo =
comment t
description t
environment t
summary t
text 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) Ttulo.
(ii) Descripcin.
(iii) Entorno.
(iv) Comentarios.
(v) 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
8
B.1. Campos
text ~ "pago de factura"
B.1.8 Campos de tipo componente
Los campos de tipo componente soportan los operadores y las funcio-
nes detalladas en Tabla B.8.
tipo =
component c
componentsLeadByUser()
componente.
Como explicado en B.1.1, el valor especicado para un campo de
tipo componente puede ser tanto el nombre como el identicador del
componente. Es aconsejable utilizar el identicador del componen-
te en lugar del nombre ya que el primero es un identicador 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 compo-
nente, 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 compo-
nente cuyo identicador es :ooo, 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:

tipo =
created f
due f
resolved f
updated f
currentLogin()
lastLogin()
now()
Tabla B.9: Operadores y funciones soportados por campos de tipo fecha.
(i) "yyyy/MM/dd HH:mm".
(ii) "yyyy-MM-dd HH:mm".
(iii) "yyyy/MM/dd".
(iv) "yyyy-MM-dd".
(v) "xw yd zh tm".
Los primeros formatos se utilizan para especicar una fecha abso-
luta mientras que el ltimo formato se utiliza para indicar una fecha
relativa.
En el formato de campo para fechas relativas, los coecientes 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 des-
pus del da o6/o/:o1o (6 de Septiembre del :o1o), 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 actua-
lizadas en las ltimas semanas, ser necesario utilizar la siguiente
proposicin:
updated < "-3w"
o
B.1. Campos
B.1.10 Campos de tipo filtro
Los campos de tipo ltro soportan los operadores y las funciones
tipo =
filter x

ltro.
El campo JQL filter no es un atributo de las incidencias de JIRA
y proporciona un mecanismo para acotar las incidencias ltradas a
los resultados de un ltro existente.
Como explicado en B.1.1, es aconsejable utilizar el identicador
del ltro en lugar del nombre ya que el primero es un identicador
nico, generado al momento de la creacin del ltro, que no puede
cambiarse a lo largo de su vida. El nombre de un ltro, 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 especique en la con-
sulta (con el operador order by) tendr precedencia sobre el
ordenamiento especicado en el ltro.
(ii) No puede ejecutarse una consulta que genere un bucle innito,
por ejemplo utilizando un ltro que a su vez haga referencia al
ltro corriente.
Ejemplo B.11. Para buscar las incidencias devueltas por el ltro
con identicador 1:ooo 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 ltro
llamado rdenes impagados, ser necesario utilizar la siguiente pro-
posicin:
1
filter = "rdenes impagados"
Ntese que, en este caso, se est utilizando el nombre de un ltro en
lugar de su identicador 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.
tipo =
issueKey i
issueHistory()
linkedIssues()
votedIssues()
watchedIssues()
incidencia.
tipo =
parent i

incidencia.
Ejemplo B.13. Para buscar la incidencia con identicador JGD-1,
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
:
B.1. Campos
tipo =
level s

nivel de seguridad.
identicador 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 Res-
ponsables 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
tipo =
originalEstimate d
remainingEstimate d
timeSpent d

duracin.
El formato de los valores aceptados para un campo de tipo dura-
cin es:
(i) "xw yd zh tm".
Los coecientes 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.
B.1.14 Campos de tipo prioridad
Los campos de tipo prioridad soportan los operadores y las funciones
tipo =
priority o
currentLogin()
lastLogin()
now()
prioridad.
de la prioridad en lugar del nombre ya que el primero es un identi-
cador 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 tan-
to, 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 ltrar las incidencias por proyecto y el
valor utilizado en la proposicin ser comparado con los atributos
nombre de proyecto, clave de proyecto e identicador de proyecto: las
incidencias que pertenezcan a un proyecto que satisfaga al menos uno
de dichos atributos sern devueltas como resultado.
B.1. Campos
tipo =
project p
projectsLeadByUser()
projectsWhereUserHasPermission()
projectsWhereUserHasRole()
proyecto.
Ejemplo B.16. Para buscar las incidencia que pertenezcan al pro-
yecto que se llame JIRA Guide, ser necesario utilizar la siguiente
proposicin:
project = "JIRA Guide"
Ejemplo B.17. Para buscar las incidencia que pertenezcan al pro-
yecto cuya clave sea JRAGD, ser necesario utilizar la siguiente pro-
posicin:
project = "JRAGD"
B.1.16 Campos de tipo resolucin
Los campos de tipo resolucin soportan los operadores y las funciones
tipo =
resolution r

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

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 resuel-
tas 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
tipo =
status e

estado.
Como explicado en B.1.1, el valor especicado para un campo
de tipo estado puede ser tanto el nombre como el identicador del
estado. Es aconsejable utilizar el identicador de estado en lugar
del nombre ya que el primero es un identicador 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:
6
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.
tipo =
type y
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 identica-
dor del tipo de incidencia. Es aconsejable utilizar el identicador de
tipo de incidencia en lugar del nombre ya que el primero es un identi-
cador 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 inci-
dencia, 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 ne-
cesario utilizar la siguiente proposicin:
type = Factura

tipo =
votes n
workRatio n

nmero.
B.1.19 Campos de tipo nmero
Los campos de tipo nmero soportan los operadores y las funciones
El campo votes permite ltrar las incidencias utilizando el nmero
usuarios que hayan votado la incidencia.
El campo work ratio permite ltrar las incidencia utilizando el por-
centaje de trabajo, n, denido como relacin entre trabajo realizado,
n
r
, y trabajo estimado total, n
t
:
n =
n
r
n
t
100 (B.1)
B.2 Funciones
JIRA ofrece un conjunto de funciones JQL que pueden utilizarse en
las consultas en lugar de un valor. Las funcionen responden a la ne-
cesidad 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 pa-
rmetros 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, ade-
ms, devuelven valores de los parmetros de conguracin 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 deter-
minar los valores por los que se desean ltrar los campos
2
y, despus,
efectuar la consulta con los valores adecuados.
2
Ya sea a travs de otra consulta o examinando directamente la conguracin
de JIRA y sus proyectos.
8
B.2. Funciones
Sin funciones no podran compartirse, por ejemplo, consultas tan
sencillas como incidencias abiertas por el usuario que efecta la con-
sulta. En falta de una funcin (currentUser()) que devuelva di-
nmicamente el nombre del usuario actualmente conectado, cada
usuario debera remplazar el valor del campo assignee en la consul-
ta:
assignee = enrico ...
De esta forma, sera materialmente imposible grabar esta consulta en
un ltro y compartirlo con otros usuarios ya que, cada uno de ellos,
debera modicar la misma y guardarla en otro ltro.
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(.,.) co
componentsLeadByUser(.) c
currentLogin() f
currentUser() u
issueHistory() i
lastLogin() f
linkedIssues(.,.) i
membersOf(.) u
now() f
projectsLeadByUser(.) p
projectsWhereUserHasPermission(.) p
projectsWhereUserHasRole(.) p
releasedVersions(.) v
standardIssueTypes() y
subtaskIssueTypes() y
unreleasedVersions(.) v
votedIssues() i
watchedIssues() i
Tabla B.21: Funciones JQL soportados por tipo de campo de campo y
clase de operador.

En la primera columna de la tabla se indica el nombre de la fun-
cin. 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 so-
portados 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 ltrar las inciden-
tipo =
cascadeOption(.,.) co
Tabla B.22: Tipo de campo de campo y clase de operador soportada por
cascadeOption.
6o
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 identica la opcin de primer nivel contra
la cual hay que ltrar el campo de las incidencias.
(ii) El segundo parmetro, un parmetro opcional, identica la op-
cin de segundo nivel contra la cual hay que ltrar 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 denido un campo personalizado de tipo
cascading option, llamado provincia, para ltrar aquellas incidencias
cuyo campo sea la pareja (Espaa, Madrid), ser necesario efectuar
provincia in cascadeOption("Espaa", "Madrid")
Ejemplo B.26. Si se ha denido el mismo campo personalizado des-
crito en el ejemplo B.25, para ltrar aquellas incidencias cuyo campo
sea la pareja (Espaa, ), es decir, en el cual el valor de primer ni-
vel 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 denido el mismo campo personalizado des-
crito en el ejemplo B.25, para ltrar aquellas incidencias cuyo campo
est vaco (en ambos niveles), ser necesario efectuar utilizar la si-
guiente proposicin:
provincia in cascadeOption(none)
61
tipo =
componentsLeadByUser(.) c
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 ltrar las
incidencias por un campo de tipo componente utilizando el conjunto
de componentes cuyo lder sea el usuario especicado por parmetro.
La funcin acepta un parmetros:
(i) El primer parmetro, opcional, identica el usuario lder de los
componentes que se desean buscar. En el caso en que no se es-
pecicare 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 au-
tenticado en JIRA, as como en el caso en que se pretenda grabar
la consulta en un ltro que pueda ser utilizado por un usuario no
autenticado, el parmetro debe ser especicado.
Ejemplo B.28. Para ltrar aquellas incidencias cuyo campo component
contenga un componente liderado por el usuario enrico, ser necesario
component in componentsLeadByUser(enrico)
Ejemplo B.29. Para ltrar 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()
6:
B.2. Funciones
tipo =
currentLogin() f
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 correspon-
diente 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 ltrar aquellas incidencias que se han creado
despus de que el usuario haya hecho login, ser necesario efectuar
created > currentLogin()
Ejemplo B.31. Para ltrar aquellas incidencias que se han actualiza-
do despus de que el usuario haya hecho login, ser necesario efectuar
updated > currentLogin()
Ejemplo B.32. Para ltrar 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 actual-
mente conectado a la plataforma.
6
tipo =
currentUser() u
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 ltro que pueda
ser utilizado por un usuario no autenticado, no hay que utilizar esta
funcin.
Ejemplo B.33. Para ltrar aquellas incidencias asignadas al usuario
que est efectuando la consulta, ser necesario efectuar utilizar la
assignee = currentUser()
Ejemplo B.34. Para ltrar 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 inci-
tipo =
issueHistory() i
issueHistory.
dencias que estn en la historia reciente del usuario, es decir, aquellas
incidencias que el usuario haya utilizado recientemente.
6
B.2. Funciones
Si el usuario est autenticado en la plataforma, JIRA devolver
las ltimas o 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 utili-
zadas en la sesin de navegacin corriente.
Ejemplo B.35. Para ltrar aquellas incidencias asignadas al usua-
rio que est efectuando la consulta y que hayan sido utilizadas re-
cientemente 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-
tipo =
lastLogin() f
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 ltrar aquellas incidencias que se han resuelto
despus de la precedente sesin de usuario, ser necesario efectuar
resolved > lastLogin()
6
tipo =
linkedIssues(.,.) i
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 in-
cidencias con las cuales la incidencia especicada 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 case-
sensitive.
Ejemplo B.37. Para ltrar aquellas incidencias que tengan un en-
lace con la incidencia JRAGD-1, ser necesario efectuar utilizar la
issue in linkedIssues(JRAGD-1)
Ejemplo B.38. Para ltrar 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 especicado por parmetro. Los
parmetros aceptados por la funcin son los siguientes:
66
B.2. Funciones
tipo =
membersOf(.) u
membersOf.
(i) El grupo del cual se quieren encontrar los usuarios.
Ejemplo B.39. Para ltrar 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
tipo =
now() f
now.
instante en que se est evaluando la funcin.
Ejemplo B.40. Para ltrar aquellas incidencias que hayan venci-
do 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 ope-
radores detallados en Tabla B.31. Esta funcin devuelve el conjunto
de proyectos liderados por el usuario especicado por parmetro. Los
parmetros aceptados por la funcin son los siguientes:
6
tipo =
projectsLeadByUser(.) p
projectsLeadByUser.
(i) El primer parmetro, opcional, es el usuario del cual se quieren
buscar los proyectos liderados. Si no se especica 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 especicado. En este caso, por lo tanto, as
como en el caso en que se pretenda grabar la consulta en un ltro
que pueda ser utilizado por un usuario no autenticado, no hay que
utilizar esta funcin sin especicar el parmetro.
Ejemplo B.41. Para ltrar 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 ltrar 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 especicado por parmetro. Los parmetros aceptados por
la funcin son los siguientes:
68
B.2. Funciones
tipo =
projectsWhereUserHasPermission(.) p
projectsWhereUserHasPermission.
(i) El primer parmetro es el permiso que tiene que tener el usua-
rio en los proyectos especicados. 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(.) p
projectsWhereUserHasRole.
conjunto de proyectos en los cuales el el usuario posee el rol especi-
cado 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 especicados.
6
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 opera-
dores detallados en Tabla B.34. Esta funcin devuelve el conjunto
tipo =
releasedVersions(.) v
releasedVersions.
de versiones entregadas en el proyecto especicado 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 proyec-
to.
Ejemplo B.45. Para ltrar aquellas incidencias cuyo atributo re-
suelta en versin sea una versin entregada de cualquier proyecto,
fixVersion in releasedVersions()
suelta en versin sea una versin entregada del proyecto JRAGD,
o
B.2. Funciones
fixVersion in releasedVersions(JRAGD)
B.2.14 Funcin standardIssueTypes
La funcin standardIssueTypes soporta el tipo de campo y los ope-
tipo =
standardIssueTypes.
de tipos de incidencias de primer nivel, eso es, tipos de incidencias
que no corresponden a sub-tareas.
Ejemplo B.47. Para ltrar aquellas incidencias que no sean sub-
tareas, 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 ope-
tipo =
subtaskIssueTypes.
de tipos de incidencias de segundo nivel, eso es, tipos de incidencias
que corresponden a sub-tareas.
Ejemplo B.48. Para ltrar aquellas incidencias que sean sub-tareas,
1
issuetype in subtaskIssueTypes()
B.2.16 Funcin unreleasedVersions
La funcin unreleasedVersions soporta el tipo de campo y los ope-
tipo =
unreleasedVersions(.) v
unreleasedVersions.
de versiones por entregar en el proyecto especicado 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 pro-
yecto.
suelta en versin sea una versin no entregada de cualquier proyecto,
fixVersion in unreleasedVersions()
suelta en versin sea una versin no entregada del proyecto JRAGD,
fixVersion in unreleasedVersions(JRAGD)
:
B.2. Funciones
tipo =
votedIssues() i
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 ltrar aquellas incidencias que hayan sido vo-
tadas 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() i
watchedIssues.
estn siendo observadas por el usuario que efecta la consulta.
autenticado, esta funcin no puede ser utilizada.

Ejemplo B.52. Para ltrar aquellas incidencias que estn siendo ob-
servadas 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.
B.3. Palabras reservadas

abort decimal goto modify rows
access declare grant modulo select
add decrement greater more session
after default group multiply set
alias defaults having next share
all dene identied noaudit size
alter delete if not sqrt
and delimiter immediate notin start
any desc in nowait strict
as dierence increment null string
asc distinct index number subtract
audit divide initial object sum
avg do inner of synonym
before double inout on table
begin drop input option then
between else insert or to
boolean empty int order trans
break encoding integer outer transaction
by end intersect output trigger
byte equals intersection power true
catch escape into previous uid
cf exclusive is prior union
char exec isempty privileges unique
character execute isnull public update
check exists join raise user
checkpoint explain last raw validate
collate false left remainder values
collation fetch less rename view
column le like resource when
commit eld limit return whenever
connect rst lock returns where
continue oat long revoke while
count for max right with
create from min row
current function minus rowid
date go mode rownum
Tabla B.40: Palabras JQL reservadas.
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 .
(iii) Se actualizaron algunos pantallazos para reejar algunas mejo-
ras introducidas en JIRA .
(iv) Se actualiz la seccin 3.3 para contemplar la nueva barra de
herramientas de administracin introducida en JIRA .
(v) Se actualiz la seccin 4 para reejar las mejoras introducidas
en JIRA .
(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 Conuence.
(viii) Se aadi la seccin 5.19.3 para detallar el procedimiento de
creacin de enlaces entre incidencias y recursos identicados 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.
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 modicadora, 45
ventanas de incidencias, 47
Atlassian SDK, 5
Attach screenshot, vase Cap-
turas 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
ndice alfabtico
por importancia, 175
por proximidad, 174
trmino, 172
exportacin, 231
exportar a Microsoft Ex-
cel, 246
exportar a Microsoft Word,
245
exportar a XML, 244
feed RSS, 242
ordenar, 163
permalink, 162
por atributos de inciden-
cia, 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
por reporter, 179
por resolucin, 180
por tipo, 180
por versin, 181
por versin de resolucin,
181
vencidas, 179
simple, 147, 148
modicar, 158
Bamboo
builds, 63, 68
Bamboo charts
gadget, vase Gadget
Bamboo plan summary chart
gadget, vase Gadget
Bamboo plans
gadget, vase Gadget
Beneciencia, 9
Browse project
permiso, 88
Browse projects
permiso, 113
Bugzilla ID search
gadget, vase Gadget
Bulk change
permiso, 131
Bulk operation, vase Opera-
cin 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
8o
ndice alfabtico
eliminacin, 89
modicacin, 89
visibilidad, 88
Comment issue
permiso, 139
Componentes, vase Proyecto
Conguracin de campos, 6, 90
Contrasea, vase Usuario
Control de horario, vase Re-
gistro 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
modicar, 293
mover un gadget, 304
operaciones, 299
operaciones sobre un gad-
get, 303
Dashboard, vase Cuadro de man-
dos
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 reso-
lucin
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 noticacin, 144
Esquema de pantallas
por tipo de incidencia, 120
Esquemas, 7, 28
Etiqueta
crear, 114
eliminar, 116
Favourite lter
gadget, vase Gadget
Fecha de resolucin, 106
Feed RSS
bsqueda, vase Bsque-
da
Ficheros adjuntos, 82, 101
JAR
navegar, 84
81
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
modicar, 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
Calendar, 305
Clover coverage, 305
Created vs. resolved, 305
Crucible charts, 305
Favourite lter, 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 lter sta-
tistics, 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
8:
ndice alfabtico
enlace, 100, 102
gestionar, 105
etiqueta, vase Etiqueta
mover a otro proyecto, 127
navegar a, 178
planicar, 106
prioridad, 21
registro histrico de cam-
bios, 141
resolucin, 23
tipo, vase Tipo de inci-
dencia
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
8
ndice alfabtico
votes, 348
watcher, 336
workRatio, 348
tipo categora, 337
tipo componente, 339
tipo duracin, 343
tipo estado, 346
tipo fecha, 339
tipo ltro, 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
projectsWhereUserHas-
Permission, 358
releasedVersions, 360
standardIssueTypes, 361
subtaskIssueTypes, 361
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 Ata-
jos 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
8
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
congurar 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
modicacin, 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
Perl de usuario, vase Usua-
rio
Perl 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 Lengua-
je de bsqueda
Quick links
gadget, vase Gadget
Recently created issues
8
ndice alfabtico
gadget, vase Gadget
Registro de trabajo, 117
crear, 120
crear en transicin de u-
jo de trabajo, 123
eliminar, 125
estimacin, 119
modicar, 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
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 lter statis-
tics
gadget, vase Gadget
Usuario
avatar, 317
modicar, 317
contrasea, 317
modicar, 318
email, 317
nombre completo, 317
perl, 315
Version-picker
tipo de campo, 136
Versiones, vase Proyecto
View voters and watchers
permiso, 145, 337
Voted
gadget, vase Gadget
Watch, vase Incidencias
86
ndice alfabtico
Watched
gadget, vase Gadget
Wiki markup, 88
Wiki-style renderer, vase Ren-
derers
WordPress, 184
Work logged on issue
evento, 33
Work started on issue
evento, 33
Work stopped on issue
evento, 33
Workow, vase Flujo de tra-
bajo
8
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 aect 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?.
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?.
Questions#When_are_publicity_rights_relevant.3F
8
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+Documen-
tation
[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+Su-
pport+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, Ocial VeriSign Home Page.
http://www.verisign.com/
[19] Thawte, Ocial 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/
o
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-sola-
ris-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
1

Jira User Guide 1.01

Diunggah oleh

Informasi Dokumen

Hak Cipta

Format Tersedia

Bagikan dokumen Ini

Bagikan atau Tanam Dokumen

Opsi Berbagi

Apakah menurut Anda dokumen ini bermanfaat?

Apakah konten ini tidak pantas?

Hak Cipta:

Format Tersedia

Jira User Guide 1.01

Diunggah oleh

Hak Cipta:

Format Tersedia

Enrico M.

1.2. Los cuadros de mandos

3.4. Atajos de teclado

5.1. Creacin de una incidencia

en la cabecera de la columna, que indicar los valores agregados

Grcos y estadsticas de una instancia de

Resumen grco de un plan de construccin

Resumen de los planes de una instancia de

Fechas de caducidad de incidencias y versio-

Cobertura de Clover de planes de una instan-

Resmenes estadsticos grcos de las revi-

Grcos de estadsticas sobre un repositorio

Resumen de los cambios recientes en un re-

Fragmento HTML congurable.

A. Documento XML de bsqueda

A. Documento XML de bsqueda

B. Campos y funciones JQL

B. Campos y funciones JQL

Tabla B.6: Operadores y funciones soportados por campos de tipo

B. Campos y funciones JQL

Tabla B.7: Operadores y funciones soportados por campos de tipo texto.

B. Campos y funciones JQL

Tabla B.10: Operadores y funciones soportados por campos de tipo

Tabla B.12: Operadores y funciones soportados por campos de tipo

Tabla B.13: Operadores y funciones soportados por campos de tipo

Tabla B.14: Operadores y funciones soportados por campos de tipo

B. Campos y funciones JQL

Tabla B.17: Operadores y funciones soportados por campos de tipo

B. Campos y funciones JQL

Tabla B.18: Operadores y funciones soportados por campos de tipo

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

B. Campos y funciones JQL

Tabla B.20: Operadores y funciones soportados por campos de tipo

B. Campos y funciones JQL

B. Campos y funciones JQL

B.3. Palabras reservadas

Anda mungkin juga menyukai