JIRA SOFTWARE

Contents
Crear y configurar la base de datos MySQL .......................................................................................... 3
Instalacin de Jira ................................................................................................................................. 4
Configurar Jira ...................................................................................................................................... 5
Propiedades de conjunto de la aplicacin ............................................................................................ 6
Crea tu cuenta de administrador .................................................................................................... 6
Configurar notificaciones por correo electrnico ........................................................................... 6
Ir a URL de Jira ................................................................................................................................. 6
Conceptos bsicos de Jira ..................................................................................................................... 7
Project ............................................................................................................................................. 7
Issue ................................................................................................................................................ 8
Component...................................................................................................................................... 8
Workflow ......................................................................................................................................... 9
Flujo de trabajo de Jira ....................................................................................................................... 10
Grupos en Jira.................................................................................................................................... 10
Grupos predeterminados JIRA ............................................................................................................ 11
Crear un usuario en JIRA .................................................................................................................... 13
Invitar a usuarios a JIRA ...................................................................................................................... 14
Desactivar un usuario ......................................................................................................................... 15
Eliminar un usuario ............................................................................................................................ 17
Conectarse al sistema ....................................................................................................................... 19
Creacin de issues ............................................................................................................................. 20
Trabajando con issues ....................................................................................................................... 22
Bsqueda de issues y gestin de filtros ............................................................................................ 24
Bsqueda avanzada en Jira ............................................................................................................... 26
Qu es una bsqueda avanzada? ................................................................................................ 26
Como realizar una bsqueda avanzada ........................................................................................ 26
 Uso de la funcin de autocompletado .......................................................................................... 27
Cambio entre la bsqueda "avanzada" y la "simple" .................................................................... 27
Configuracin de la precedencia de los operadores ..................................................................... 27
Palabras clave ................................................................................................................................ 28
Listado de palabras clave .............................................................................................................. 28
Operadores.................................................................................................................................... 28
Listado de Operadores .................................................................................................................. 29
Refencia de Campos ...................................................................................................................... 29
Listado de campos ......................................................................................................................... 29
Proyectos en JIRA .............................................................................................................................. 31
Cuadros de Mando ............................................................................................................................ 32
Administracin .............................................................................................................................. 32
Nuevo cuadro de mando ....................................................................................................... 33
Configuracin de los gadgets ............................................................................................................ 34
Indices ........................................................................................................................................... 36
 Crear y configurar la base de datos MySQL

1. Crear un usuario de base de datos, que se conectar a JIRA (p. ej. jiradbuser).
Recuerde este nombre de usuario de base de datos , ya que se utilizar para configurar
la conexin de JIRA a esta base de datos en posteriores pasos.

CREATE USER 'jiradbuser'@'localhost' IDENTIFIED BY ''toor

La parte de nombre de host de la cuenta, si se omite, por defecto es '%'.

1. Crear una base de datos de JIRA (por ejemplo, jiradb). La base de datos debe tener un
conjunto de caracteres de UTF8. Escriba el siguiente comando desde dentro del cliente de
MySQL comando.
Recuerde este nombre de la base de datos , ya que se utilizar para configurar la conexin
de JIRA a esta base de datos en posteriores pasos.

create database jiradb CHARACTER SET utf8 COLLATE utf8_bin;

Conceder permisos:

GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,REFERENCES,ALTER,INDEX on
localhost.* TO 'jiradb'@'localhost' IDENTIFIED BY 'toor';

FLUSH PRIVILEGES;

Editar el /etc/mysql/my.cnf

Cambiar: max_allowed_packet = 256M

Descargar la versin de conector recomendado (5.1)

https://dev.mysql.com/downloads/File/?ID=472650

Descargar Jira:

https://www.atlassian.com/software/JIRA/download
 Ejecutar Jira

chmod + x atlassian-jira-software-X.X.X-x64.bin

sudo./atlassian-jira-software-X.X.X-x64.bin

Instalacin de Jira

Tipo de instalacin elegir opcin 2 (personalizada) para el control de la instalacin.

Directorio de destino esto es donde se instalar JIRA. (/ app/atlassian/jira)

Directorio de hogar esto es donde se almacenarn datos JIRA como registros, ndices y
archivos. (/ app/atlassian/aplicaciones y datos)

Puertos TCP estos son el puerto HTTP de JIRAA. Mantener con el valor predeterminado
a menos que se est ejecutando otra aplicacin en el mismo puesrto (seleccione por defecto
si no tiene otros servidores en los puertos 8080(HTTP)/8005(Control))

Instalar como servicio esta opcin slo est disponible si ejecutaste al instalador como
sudo. (No, para iniciar servicio de jira manualmente en la carpeta bin )

Sudo ./start-jira.sh

Sudo ./stop-jira.sh

Copiar el conector MySQL en la carpeta lib de Jira /app/atlassian/jira/lib

Reiniciar JIRA / servicio JIRA.
Configurar Jira

Elegir configuracin personalizada.

Start service mysql

Configuracin de la base de datos:

usuario: jiradbuser

base de datos: jiradb

Pass: toor

host: localhost

Puerto: 3306

Haga clic en siguiente y espere mientras se genera el ERD

 Propiedades de conjunto de la aplicacin

1. Darle un nombre a tu sitio JIRA.

2. Elije si quieres que Jira sea privado o si cualquier persona puede inscribirse. Usted puede
cambiar esto ms adelante.

3. Introduzca su URL base - esta es la direccin que la gente usar para acceder a su sitio JIRA.

Entrar en licencia

Crear cuenta de Atlassian

Seleccione generar licencia try en Jira.

Crea tu cuenta de administrador

Ingrese datos de la cuenta Administrador. Puede agregar ms administradores despus de
la configuracin es completa.

Configurar notificaciones por correo electrnico

Ingrese datos de su servidor de correo. Esto permitir que JIRA a enviar notificaciones
cuando cambian los temas.

Seleccionar ms adelante.

Ir a URL de Jira
Localhost:8080
Conceptos bsicos de Jira

1. Issues

2. Projects

3. Components

4. Workflows

Project:
Un proyecto de Jira es una coleccin de issues.

Cada issue pertenece a un proyecto

Cada proyecto se identifica por un nombre y una clave

La clave del proyecto se anexa a cada issue y es asociada al proyecto

Ejemplo

o Nombre del proyecto: sitio web de medios sociales

o Clave del proyecto: SM

o Tema: SM_24 agregar un nuevo amigo

Issue:
Issue es un bloque de construccin del proyecto.

Es el bloque ms bsico.

Dependiendo de cmo su organizacin utiliza Jira, podra representar un Issue:

o Un error de Software.

o Una tarea del proyecto.

o Un ticket de mesa de ayuda.

o Un entorno de produccin.

o Una solicitud del cliente.

Component:
Los componentes son secciones de un proyecto.

Se utilizan para agrupar temas dentro de un proyecto en partes ms pequeas.

Es decir: Algunos de los componentes ms comunes son DB, servidor, interfaz de

usuario, error. Crear temas de numerosas manifestaciones en el proyecto y
entonces empezar a agrupar en diferentes componentes. As es ms fcil identificar
qu cuestiones pertenecen a los componentes.
Workflow:
Un flujo de trabajo de Jira es el conjunto de los Estados y las transiciones que
atraviesa un problema durante su ciclo de vida.

Flujos de trabajo tpicamente representan procesos de negocio.

JIRA viene con flujo de trabajo predeterminado y puede ser personalizado para
adaptarse a su organizacin.

Estado posible Transicin

Abierto Inicio curso

En progreso Detener el progreso

Resuelto Resolver

Cerrado Volver a abrir

Volver a abrir Resolucin y cierre

 Flujo de trabajo de Jira

Nota: La diferencia entre cerrado y resuelto. Cerrada significa que ests

completamente satisfecho con ella y est listo para ser lanzado. Resuelto significa
que se resolvi el error y el equipo de control de calidad puede testear. Una vez que
el revisor est completamente satisfecho entonces lo promueve a resuelto.

Grupos en Jira

Un grupo de JIRA es una manera conveniente de administrar una coleccin de

usuarios. Puede utilizar grupos en JIRA para:

Permite el acceso a la aplicacin.

Conceder permisos globales o accesos especficos al proyecto.

Recibir notificaciones por correo electrnico.

Acceso a cuadros de mando.

Condiciones de flujo de trabajo de referencia.

Se integran con funciones del proyecto.

Grupos predeterminados JIRA

Dos grupos se crean automticamente al instalar JIRA por primera vez: el grupo de
administradores de jira y grupo de un usuario asociado a la aplicacin.

Grupo Aplicacin Descripcin Uso

administradores Todos Contiene quienes son Los miembros deben

los
de Jira administradores del sistema limitarse a unos pocos
JIRA. De forma administradores de
predeterminada, este grupo: JIRA o super usuarios.

Es un miembro de la funcin Proporciona acceso

del proyecto de los ilimitado.
administradores
Recomienda nunca
Cuenta con borrar o modificar
los Administradores de la permisos a este grupo
JIRA y los permisos de Los porque limitara el
administradores del sistema acceso a la instancia
JIRA mundiales. JIRA.
usuarios de la Ncleo De forma predeterminada,
base de Jira JIRA estos grupos tienen el permiso
de Buscar usuarios, Crear
filtro y Gestionar
suscripciones de filtro de
grupo.
Grupos de usuario
opcional.
Puede ser til si la
instancia JIRA tiene
muy pocos usuarios
que requieren acceso
genrico y estndar.

Puede suprimirse si la
instancia JIRA
requiere acceso
granular, especfico
para los grupos
individuales de los
usuarios.

JIRA-usuarios Software De forma predeterminada, Grupos de usuario

JIRA estos grupos tienen los opcional.
permisos de Buscar
Puede ser til si la
usuarios, Crear filtro,
instancia JIRA tiene
cambios a granel y Gestionar
muy pocos usuarios
suscripciones de filtro de
que requieren acceso
grupo.
genrico y estndar.

Puede suprimirse si la
instancia JIRA
requiere acceso
granular, especfico
para los grupos
individuales de los
usuarios.

JIRA- Servicio De forma predeterminada, Grupos de usuario

servicedesk- de Jira estos grupos tienen permisos opcional.
usuarios para Buscar usuarios, Crear
Puede ser til si la
filtro, cambio a
instancia JIRA tiene
granel y Gestionar
muy pocos usuarios
suscripciones de filtro de
que requieren acceso
grupo.
genrico y estndar.
 Puede suprimirse si la
instancia JIRA
requiere acceso
granular, especfico
para los grupos
individuales de los
usuarios.

Crear un usuario en JIRA

Crear un usuario directamente en JIRA si tiene un equipo pequeo. Considerar la

administracin de usuarios externos (LDAP o Active Directory) si usted tiene un numero
extenso de usuarios.

1. Vaya a configuracin.

2. Seleccione gestin de usuarios

3. En el explorador, haga clic en crear usuario.

4. Introduzca el nombre de usuario, contrasea, nombre completo y direccin de

correo electrnico.

5. Opcionalmente, seleccione la casilla de correo electrnico de notificacin enviar

para enviar el usuario y el correo electrnico que contiene:

o Su nombre de inicio de sesin

o Un enlace desde el que establecer su contrasea (vlido para 24 horas)

6. Si tienes ms de una solicitud de Jira instalada, necesitar seleccionar la aplicacin

de JIRA para dar al usuario acceso a.

7. Haga clic en el botn crear.

Invitar a usuarios a JIRA

Usted puede invitar a usuarios a JIRA a travs de correo electrnico.

Nota: El servidor de correo SMTP de JIRA se debe configurar para enviar notificaciones
antes de que usted puede invitar a los usuarios por correo electrnico.

No puede invitar a los usuarios mediante el envo de una invitacin a una lista de distribucin

1. Abrir el navegador del usuario y haga clic en los usuarios de la invitacin.

2. Introduzca las direcciones de correo electrnico de los usuarios que desea

invitar. Aadir a varios usuarios separando las direcciones de correo electrnico con
una coma.

3. Haga clic en el botn Enviar para enviar las invitaciones.

o Cada invitacin puede utilizarse para crear un usuario en la direccin de

correo electrnico que fue enviado a y puede ser utilizado una vez.

o Cada invitacin expirar siete das despus del da que se envi.

o El nmero de licencias de usuario no ser afectado hasta que el usuario

acepten la invitacin y se crean los usuarios.
Tiene un usuario que ya no necesita acceder a JIRA?

En lugar de eliminar un usuario, se recomienda desactivar su cuenta. Desactivar cuenta de

usuario impide que la cuenta sea utilizada, pero conservar la historia del usuario de la
actividad.

Desactivar un usuario

Los administradores JIRA pueden desactivar un usuario JIRA, que deshabilita el acceso del
usuario a JIRA. Esto evita la necesidad de un administrador JIRA a eliminar la cuenta del
usuario del sistema.

Esta caracterstica es til cuando un usuario JIRA deja la organizacin o cambia

departamentos porque su historia de la actividad JIRA se conserva en el sistema. Si un
usuario con una cuenta desactivada de JIRA necesita acceder otra vez en algn momento
en el futuro, puede reactivarse fcilmente su cuenta de usuario JIRA.

1. Vaya a configuracin

2. Administracin de usuarios y encontrar el usuario en la lista de usuarios

3. Haga clic en Editar operaciones

4. Desactive la casilla de verificacin activo

5. Seleccione la actualizacin para confirmar el cambio

6. El usuario aparecer en la lista de usuarios con un tachado su nombre de usuario y

nombre completo '(inactivo)'.

Nota

Si la instancia JIRA est configurada para utilizar un directorio de usuario externo

de multitud de Atlassian, el usuario se desactivar en JIRA si se desactivan en el
servidor.
 JIRA desactivara los usuarios que estn configurados y desactivados o
deshabilitados en un Microsoft Active Directory o un directorio de usuarios basado
en LDAP, a excepcin de los usuarios JIRA configurados en 'delegar autenticacin
LDAP'.

Cuando se desactiva un usuario, ese usuario:

Ya no ser capaz de iniciar sesin en JIRA.

No cuenta para tu lmite de licencia de usuario JIRA.

No puede ser asignado a issues o aadido como un vigilante a issues cada vez que
sean creadas o editadas. Sin embargo:

o Un usuario que fue asignado y estaba viendo o haba reportado problemas

en JIRA antes de que su cuenta haya sido desactivada, todava aparece
como el cesionario respectivo vigilante y ponente de los temas. Esta
situacin permanece hasta que otro usuario se especifica como el cesionario
o el reportero.

o Un usuario que votaron sobre cualquier problema en JIRA antes de que su

cuenta es desactivada continuar apareciendo como un votante sobre estos
temas.

Continuar apareciendo en la interfaz de usuario JIRA con '(inactivo)' aparece

despus del nombre.

Puedan utilizarse para filtrar temas en una consulta de bsqueda JIRA.

No recibir ninguna notificaciones por correo electrnico de JIRA, aunque continan

siendo el cesionario, reportero o vigilante de las cuestiones
 Eliminar un usuario

1. Vaya a configuracin

2. Ir a administracin de usuarios y encontrar el usuario en la lista de usuarios.

3. Haga clic en el enlace de cancelacin en la columna de operaciones.

La pantalla de confirmacin que sigue un resumen cualquier implicacin de que el usuario
en el sistema, mostrando temas actuales asignados a y divulgado por ese usuario,
etcetera. Estas conexiones entre otras partes del sistema y el usuario pueden impedir la
eliminacin de ese usuario.

4. Tomar cualquier accin necesaria para disociar el usuario con JIRA. El mensaje de error le
dar instrucciones exactas pero estos pueden incluir:

o Reasignar cualquier problema asignada al usuario.

o Edicin de bulto lo creado por el usuario y cambia el 'reportero' a otra persona. Usted tambin
necesitar permitir la edicin de temas cerrados si algunos de los temas el usuario creado
se cierran y no desea abrirlas.

o Cambiar el propietario de comparte paneles propiedad del usuario.

o Cambiar el proyecto de llevar para cualquier proyecto donde el usuario es un plomo.

5. Si no existen problemas asignada, o registrados por el usuario y el usuario no ha comentado

sobre los problemas, la pantalla de confirmacin mostrar un botn Eliminar. Haga clic para
eliminar el usuario

Antes de eliminar, tenga en cuenta que:

No se puede eliminar un usuario en JIRA si utiliza Administracin de usuario externo (sin

embargo, puede desactivar el usuario. Consulte las instrucciones de arriba).

No se puede eliminar un usuario de JIRA si tienen:

o informado o se le han asignado problemas.

o coment en problemas.
 Los filtros y los paneles de un usuario se eliminarn cuando el usuario se borra, incluso si
los filtros o cuadros de mando son compartidos con otros usuarios.

Todas las cuestiones que han sido reportadas por o asignadas al usuario que est intentando
eliminar, son respectivamente enlazados a una lista de los temas individuales en el
navegador en cuestin.

Tipo de Descripcin
problema

Error Un problema que impide el funcionamiento del producto.

Historia Peticin de funcionalidad desde la perspectiva del usuario. Recuerde que

un represente de la historia de usuario la funcionalidad bsica que aportar
valor al cliente o usuario. Una historia de usuario no es una especificacin
de requisitos.

pica Gran obra que abarca muchas cuestiones

Tarea Tarea que debe hacerse. Por lo general, representan historias tcnicas.

Sub- Tarea ms pequeas dentro de una obra ms grande

tarea de

Los equipos pueden colaborar en aplicaciones de Jira por romper piezas de trabajo
en temas.
Temas pueden representar tareas, errores de software, solicitudes o cualquier otro
tipo de trabajo del proyecto.

Cada aplicacin Jira viene con tipos de emisin por defecto para satisfacer las
necesidades de sus proyectos y equipos.

Conectarse al sistema
Para acceder al sistema es necesario disponer de un usuario y contrasea vlidos.

Una vez dentro, nos encontraremos con la pantalla principal o cuadro de mandos
del sistema. La pantalla principal de cada usuario es personalizable. Esta alberga
una serie de elementos, conocidos como gadgets, que permiten ver listados,
grficas o enlaces.
Esta ilustracin muestra un ejemplo en el que hay un listado con un filtro de issues.

Adems de este cuadro de mandos, otra parte importante de esta pantalla es la

barra horizontal con el men de opciones de Jira. Dos de las opciones permiten
realizar prcticamente todas las tareas bsicas de la herramienta:

Proyectos: permite escoger un proyecto concreto o ir al listado de proyectos.

Este listado puede ser completo o agrupado por categoras de proyecto.

Issues: permite buscar o crear issues y consultar issues consultados

recientemente. En la primera opcin se puede ver el filtro de bsqueda activo
y acceder a la bsqueda de issues. Adems, se puede acceder de forma
directa a los ltimos issues visitados por el usuario.

Creacin de issues
Existen diversas formas de crear un issue. Las bsicas pueden encontrarse en el
men de Jira.

Una primera consiste en crear issue desde el men de issues

Esto lleva a una pantalla como la que se muestra en la siguiente Ilustracin en la
que podremos elegir para qu proyecto y de qu tipo queremos el isse.

Nos encontraremos con la pantalla de introduccin de datos. Esta pantalla muestra

los campos del issue. Por ello, dependiendo del tipo de issue, podremos
encontrarnos con distintos tipos de pantallas de introduccin de datos.
Los campos obligatorios estn marcados con el smbolo del asterisco *. Una vez
hayamos introducido los datos necesario, al pulsar en el botn de crear, se crear
de forma efectiva el issue.
Existen varias formas ms de crear issue. Por ejemplo, desde la pantalla de
proyectos o incluso clonando issues existentes si se tiene permiso.

Trabajando con issues

El issue se crea con un identificador formado por la clave de proyecto y un contador
(p. ej. GIS-182).

Tanto los issues como los proyectos son enlazables ya que tienen asociada una
URL. Por ello pueden accederse directamente (siempre que estemos registrados en
el sistema) mediante el uso de direcciones tales como:

http://jira.excentia.es/browse/ acronimo_proyecto
http://jira.excentia.es/browse/ identificador_issue

La siguiente ilustracin muestra una vista de un issue. A estas vistas podemos

acceder tanto tras crear un issue como tras hacer clic en un elemento resultado de
una bsqueda o al realizar una bsqueda rpida.

Vista de un issue
La barra de operaciones encima de la parte superior de esta pantalla es un men
de opciones con datos y operaciones a realizar sobre el issue. Mientras que parte
superior muestra la informacin bsica de este, el resto de pgina muestra los
comentarios y el trabajo que se va realizando sobre este.

En la parte superior del listado de comentarios podemos encontrar una serie de

pestaas con los distintos tipos de contenido que se puede aadir en un issue:

Comentarios
Trabajo registrado
Cambios efectuados en el estado
Commits en Subversion (si aplica)
Todo a la vez (en orden cronolgico)

Adems de aadir comentarios, dependiendo de nuestros permisos en el proyecto

podremos clonar el issue, realizar seguimiento (para que se nos avise de cambios
con notificaciones de correo), editarlo, borrarlo, incluir adjuntos, enlazar con otros,
votar al issue, cambiar el issue de proyecto o cambiarlo de estado.

Votar al issue tiene sentido en el contexto de proyectos con mltiples clientes. La

votacin indica un inters especial en priorizar la resolucin del issue.

El cambio de estado depende del flujo de trabajo asignado para el tipo de issue y el
proyecto. Por defecto el flujo permite realizar las transiciones que mostramos en el
diagrama de estados.
Bsqueda de issues y gestin de filtros
Una va para acceder a la bsqueda de issues consiste en seleccionar la opcin de
bsqueda del men de issues tal y como puede observarse:
Esto mostrar una pantalla de bsqueda como la siguiente:

En dicha pantalla podemos acotar los criterios de bsqueda. Al ejecutarla el

resultado de esta aparecer en la pantalla central. Este resultado puede exportarse
a Excel, Word, HTML, etc. eligiendo la opcin correspondiente del desplegable de
tipos de vista.
Otra va de acceso a las bsquedas es usar la bsqueda rpida que aparece en la
parte superior de la pantalla. Esta opcin es lo que se conoce como bsqueda
inteligente ya que permite buscar tanto por palabras sueltas como por
identificadores de issue, derecha de proyecto o buscar issues atrasados.

Todas las bsquedas que realicemos en el sistema pueden guardarse e incluso

compartirse. Una bsqueda guardada es lo que se conoce en Jira como un filtro.
Los filtros pueden ser la base tanto de listados como de grficas. Para crear un filtro,
simplemente hay que almacenar la bsqueda. Existe una gestin de filtros accesible
desde el men de issuesa travs de la opcin del men " issues/Incidencias" ->
"Administracin de filtros".

La siguiente ilustracin muestra como este men de issues permite ejecutar filtros.
Bsqueda avanzada en Jira
Las instrucciones de esta pgina describen como definir y ejecutar una bsqueda
de issues usando la "Bsqueda avanzada", por encima de la bsqueda rpida,
accesible en cualquier pantalla en la zona superior a la derecha, o la bsqueda
bsica, accesible pulsando en la barra superior issues-> Buscar issues

Qu es una bsqueda avanzada?

La bsqueda avanzada permite utilizar consultas estructuradas para buscar issues
de JIRA. Los resultados de bsqueda se muestran en el "Navegador de issues",
donde el listado se puede exportar a mltiples formatos () accediendo al submen
"Vistas" arriba a la derecha. Tambin es posible guardar esta consulta como un
filtro y suscribirse a esta bsqueda avanzada.

Cuando se realiza una bsqueda avanzada, se est usando el lenguaje de consultas

de JIRA (JQL o "JIRA Query Language").

Una consulta simple en JQL (tambin conocida como una "clusula" ) consiste en
un campo, seguido por un operador, seguido de uno o ms valores o funciones.
Por ejemplo, la siguiente consulta sencilla encontrar todos los temas en el proyecto
de "TEST":

project = "TEST"

(Este ejemplo usa el campo Proyecto ("project"), el operado IGUAL y el valor TEST)

Se debe tener en cuenta que no es posible comparar dos campos

JQL proporciona una sintaxis parecida a SQL, tal como el ORDER BY (para la
ordenacin) y la funcin de SQL "ISNULL()". De todas formas, JQL no es un
lenguaje de consultas a bases de datos. Por ejemplo, JQL no dispone de una
sentencia SELECT.

Como realizar una bsqueda avanzada

1. Desde el interfaz de JIRA , navegar en "issues" -> "Buscar issues". Se
mostrar el Navegador de issues.
o Si hay criterios de bsqueda existentes, pulsar sobre el botn "Filtro
nuevo" para borrar los criterios de bsqueda.
o Si se muestra el enlace de "Bsqueda avanzada", pulsar para
cambiar.
 2. Teclear la query usando los campos, operadores y valores de campo o
funciones.
3. Pulsar sobre el boton de bsqueda (representado con una lupa) para ejecutar
la consulta

Uso de la funcin de autocompletado

A la vez que se escribe la consulta, JIRA reconocer el contexto y ofrecer una lista
de sugerencias de "autocompletado" de la siguiente forma:

La lista de sugerencias de autocompletado se muestra por orden alfabtico e incluye

las 15 primeras coincidencias. Anotar aqu que las sugerencias de autocompletado
no se ofrecen para las funciones.

Cambio entre la bsqueda "avanzada" y la "simple"

En general, una consulta creada usando una bsqueda simple estar disponible
para ser traducida a una "Bsqueda avanzada" (o JQL), y al revs.

De todas formas, una consulta creada usando la "Bsqueda avanzada" podra no

estar disponible para su traduccin a una bsqueda, particularmente si:

la consulta contiene un operador OR (anotar que se puede tener un operador

IN y ste ser traducido, por ejemplo_ project in (A, B))
o p.e. incluso cuando se tiene una consulta como: (project = JRA OR
project = CONF) que es equivalente a esta query:(project in (JRA,
CONF)), nicamente la secunda consulta ser traducida.
la consulta contiene un operador NOT
la cionsutla contiene un operador EMPTY
la consulta contiene cualquiera de los operadores de comparacin: !=, IS, IS
NOT, >, >=, <, <=
tla consulta especifica un campo y valor que est relacionado con un proyecto
(p.e. version, component, custom fields) y el proyecto no est explicitamente
incluido en la consulta (p.e.
fixVersion = "4.0", sin el AND project=JRA). Esto es especialmente difcil con
los campos personalizados, ya que se pueden configurar en base a un
proyecto / issue tipo. La regla general es que si la consulta no se puede crear
en el formulario 'Bsqueda Simple', entonces si se crea utilizando "Bsqueda
avanzada" no podr ser traducido a "Bsqueda simple".

Configuracin de la precedencia de los operadores

Se puede utilizar parntesis en las declaraciones JQL complejos para hacer cumplir
la precedencia de operadores.
Por ejemplo, si desea buscar todos los problemas resueltos en el proyecto
SysAdmin, as como todos los issue (cualquier estado, cualquier proyecto)
asignadas al administrador del sistema (aperez), puede utilizar parntesis para
hacer cumplir la precedencia de los operadores lgicos en su consulta, p.e.:

(status=resolved AND project=SysAdmin) OR assignee=aperez

Anotar que si no se usan parntesis, la declaracin ser evaluada de izquierda a

derecha.

Tambin se pueden usar parntesis para agrupar consultas, tal que puedes aplicar
el operador NOT al grupo

Palabras clave
Una palabra clave en JQL es una palabra o frase que hace (o es) cualquiera de
estas:

une dos o ms clusulas juntas para formar una consulta JQL compleja
altera la lgica de una o ms clusulas
altera la lgica de los operadores
tiene una definicin explcita en una consulta JQL
realiza una funcin especfica que altera los resultados de una consulta JQL.

Listado de palabras clave

AND
OR
NOT
EMPTY
NULL
ORDER BY

Operadores
Un operador en JQL es uno o ms smbolos o palabras que comparan el valor de
un campo en su lado izquierdo con uno o ms valores (o funciones) en su lado
derecho, de tal manera que slo los resultados verdaderos son recuperados por la
clusula. Algunos operadores pueden utilizar la palabra clave NOT.
Listado de Operadores
EQUALS: =
NOT EQUALS: !=
GREATER THAN: >
GREATER THAN EQUALS: >=
LESS THAN: <
LESS THAN EQUALS: <=
IN
NOT IN
CONTAINS: ~
DOES NOT CONTAIN: !~
IS
IS NOT
WAS
WAS IN
WAS NOT IN
WAS NOT
CHANGED

Refencia de Campos
Un campo en JQL es un palabra que representa un campo JIRA (o un campo
personalizado que se haya definido). En una clusula, un campo es seguido por un
operador, que a su vez es seguido por uno o ms valores (o funciones).

El operador compara el valor del campo con uno o ms valores o funciones de la

parte derecha, tal que nicamente resultados ciertos o "verdaderos" son devueltos
por la clusula.

Listado de campos
Campo Traduccin Descripcin

assignee Asignado Usuario de JIRA que tiene asignado el issue

category Categora Categora del proyecto

comment Comentario

component Componente
created Fecha de Creacin

description Descripcin Campo con la descripcin

due Fecha de Entrega

level Nivel de Seguridad

parent Issue Padre

priority Prioridad

project Proyecto clave o nombre del proyecto

reporter Informador Usuario de JIRA que abre la incidencia

resolution Resolucin Cdigo de resolucin

Estado en el que se encuentra el issue dentro

status Estado
del flujo de trabajo

summary Resumen Resumen del issue

Fecha de
updated ltima fecha en la que el issue fue modificado
Actualizacin
Proyectos en JIRA
Al elegir un proyecto concreto nos encontraremos con una pantalla similar a la que
muestra a continuacin:

Puede observarse que es como un portal con el que acceder a los issues propios
de un proyecto. Desde aqu pueden consultarse filtros o informes relacionados con
los issues de dicho proyecto.

Tambin existen pestaas para acceder a una vista orientada a issues de proyecto
o a una vista orientada a calendario de proyecto:
Si existen, la vista de proyectos es el lugar desde el que gestionar tanto las
versiones como los componentes.

Cuadros de Mando
Los cuadros de mando en Jira permiten obtener informacin personalizada en
tiempo real usando "gadgets" o pequeos componentes visuales, que toman como
origen de datos un filtro de bsqueda y muestran la informacin de una forma
determinada.

Cualquier usuario puede crear y administrar sus propios cuadros de mando, con la
posibilidad de compartirlos (siempre en modo lectura) con otros usuarios.

Administracin
Accesible a travs de "Panel de Mando" -> "Administrar paneles"

En esta pgina se muestran los paneles "favoritos", que se vern en el men

desplegable de "Panel de Mando" y adems se pueden acceder a:

crear un cuadro de mando, pulsando sobre el botn arriba a la derecha

los paneles creados por el usuario
los ms populares (que ms usuarios estn usando)
 un motor de bsqueda que permite seleccionar por propietario, grupo
compartido, etc..

Para aadir un cuadro de mando como "favorito", se debe pulsar sobre la "estrella"
de la izquierda. A partir de este momento aparecer en la lista desplegable de
"Panel de Mando"

Nuevo cuadro de mando

Al crear un cuadro de mando se debe indicar el nombre, plantilla origen (ya que
es posible empezar desde uno ya creado para modificarlo) y con qu grupos de
usuarios se desea compartir (se debe pulsar en "Aadir" para aadir el grupo)

Desde cualquier cuadro de mandos, arriba a la derecha tenemos la opcin

de "Aadir gadget"
 Si el cuadro de mandos ha sido creado por el usuario autenticado, tambin
aparece la opcin de "Editar diseo", que permite cambiar la disposicin de
las columnas de la pgina.

Configuracin de los gadgets

Para insertar un gadget en el cuadro de mando, se debe acceder a "Aadir Gadget"
y pulsar "Aadir ahora" en el que desea incluir. Un avez incluido

Resultados de un Filtro

Por ejemplo, si se elige el gadget "Mostrar Filtros Guardados", que Muestra las
incidencias/resultados para un filtro guardado, el gadget se incluir en la pgina en
modo CONFIGURACION, donde se debe especificar la siguiente informacin:

Filtro guardado: conjunto de issues que el filtro devuelve y que se desea

mostrar. Es un campo autocompletable
Nmero de resultados (o tamao de la pgina)
Campos a mostrar: campos del issues que se desea incluir en el "listado"
Intervalo de actualizacin: se puede configurar el gadget para que se
refresque la informacin peridicamente.

Una vez configurado, pulsando en "Guardar" se muestran los datos.

Los gadget pueden moverse entre la pgina arrastrando la barra superior por la
pantalla.
Grfico de Creados contra Resueltos

Si por ejemplo se quiere obtener una grfica con la progresin de resolucin de

issues sobre los creados, se puede usar el gadget "Grfico de Creados contra
Resueltos" y configurarlo de la siguiente forma:

Proyecto o Filtro Guardado

Perodo: Longitud de los periodos mostrados en el grfico (diario, semanal,
mensual, trimestral o anual)
Das Antes: Das (incluyendo hoy) para mostrar en el grfico.
Totales Acumulados: Progresivamente aadir los totales (1.. 2.. 3), o
mostrar valores individuales (1.. 1.. 1).
Muestra la Tendencia de No Resueltos:Muestra el nmero de issues sin
resolver en el tiempo en un subgrfico (S/No)
Mostrar hitos: Mostrar cundo los hitos se han liberado en el grfico
Intervalo de Actualizacin

Una vez configurado, el grfico se mostrara de una forma parecida a esta:

Indices
La informacin que se muestra en los cuadros de mandos est indexada. Es decir,
no se accede a la base de datos en cada recarga. El ndice se actualiza
automticamente en cada modificacin del issue.