Las instrucciones de esta página describne como definir y ejecutar una búsqueda de asuntos usando la "Búsqueda avanzada", por encima de la búsqueda rápida, accesible en cualquier pantalla en la zona superior a la derecha, o la búsqueda básica, accesible pulsando en la barra superior Asuntos -> Buscar asuntos
La búsqueda avanzada permite utilizar consultas estructuradas para buscar asuntos de JIRA. Los resultados de búsqueda se muestran en el "Navegador de Asuntos", donde el listado se puede exportar a múltiples formatos () accediendo al submenú "Vistas" arriba a la derecha. También es posible guardar esta consulta como un filtro y suscribirse a esta búsqueda avanzada.
Cuando se realiza una búsqueda avanzada, se está usando el lenguaje de consultas de JIRA (JQL o "JIRA Query Language").
Una consulta simple en JQL (también conocida como una "cláusula" ) consiste en un campo, seguido por un operador, seguido de uno o más valores o funciones. Por ejemplo, la siguiente consulta sencilla encontrará todos los temas en el proyecto de "TEST":
Bloque de código | ||
---|---|---|
| ||
project = "TEST" |
...
...
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 alfabético e incluye las 15 primeras coincidencias. Anotar aquí que las sugerencias de autocompletado no se ofrecen para las funciones.
...
En general, una consulta creada usando una búsqueda simple estará disponible para ser traducida a una "Búsqueda avanzada" (o JQL), y al revés.
De todas formas, una consulta creada usando la "Búsqueda avanzada" podría no estar disponible para su traducción a una búsqueda
However, a query created using 'Advanced Search' may not be able to be translated to 'Simple Search', particular if:
, particularmente si:
(project = JRA OR project = CONF)
is equivalent to this que es equivalente a esta query:(project in (JRA, CONF))
, only the second query will be translated.fixVersion = "4.0"
, without the sin el AND project=JRA
). This is especially tricky with custom fields since they can be configured on a Project/Issue Type basis. The general rule of thumb is
You can use parentheses in complex JQL statements to enforce the precedence of operators.
For example, if you want to find all resolved issues in the SysAdmin project as well as all issues (any status, any project) currently assigned to the system administrator (bobsmith), you can use parentheses to enforce the precedence of the boolean operators in your query, i.e.:
Se puede utilizar paréntesis 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 asunto (cualquier estado, cualquier proyecto) asignadas al administrador del sistema (aperez), puede utilizar paréntesis para hacer cumplir la precedencia de los operadores lógicos en su consulta, p.e.:
(status=resolved AND project=SysAdmin) OR assignee=bobsmith |
Note that if you do not use parentheses, the statement will be evaluated left-to-right.
You can also use parentheses to group clauses, so that you can apply the NOT operator to the group.
A keyword in JQL is a word or phrase that does (or is) any of the following:
aperez |
Anotar que si no se usan paréntesis, la declaración será evaluada de izquierda a derecha.
También se pueden usar paréntesis para agrupar consultas, tal que puedes aplicar el operador NOT al grupo
Una palabra clave en JQL es una palabra o frase que hace (o es) cualquiera de estas:
An operator in JQL is one or more symbols or words which compares the value of a field on its left with one or more values (or functions) on its right, such that only true results are retrieved by the clause. Some operators may use the NOT keyword.
Un operador en JQL es uno o más símbolos o palabras que comparan el valor de un campo en su lado izquierdo con uno o más valores (o funciones) en su lado derecho, de tal manera que sólo los resultados verdaderos son recuperados por la cláusula. Algunos operadores pueden utilizar la palabra clave NOT.
Un campo en JQL es un palabra que representa un campo JIRA (o un campo personalizado que se haya definido). En una cláusula, un campo es seguido por un operador, que a su vez es seguido por uno o más valores (o funciones).
El operador compara el valor del campo con uno o más valores o funciones de la parte derecha, tal que únicamente resultados ciertos o "verdaderos" son devueltos por la cláusula.
Listado de campos
Campo | Traducción | Descripción |
---|---|---|
asignee | Asignado | Usuario de JIRA que tiene asignado el asunto |
category | Categoría | Categoría del proyecto |
comment | Comentario | |
component | Componente | |
created | Fecha de Creación | |
description | Descripción | Campo con la descripción |
due | Fecha de Entrega | |
level | Nivel de Seguridad | |
parent | Asunto Padre | |
priority | Prioridad | |
project | Proyecto | |
reporter | Informador | Usuario de JIRA que abre la incidencia |
resolution | Resolución | |
resolved | Código de resolución | |
status | Estado | |
summary | Resumen | Resumen del asunto |
updated | Fecha de Actualización |