Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

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

 

¿Qué es una búsqueda avanzada?

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":

 

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 ordenación) y la función 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 búsqueda avanzada

  1. Desde el interfaz de JIRA , navegar en "Asuntos" -> "Buscar asuntos". Se mostrará el Navegador de asuntos.
    • Si hay criterios de búsqueda existentes, pulsar sobre el botón "Filtro nuevo" para borrar los criterios de búsqueda.
    • Si se muestra el enlace de "Búsqueda avanzada", pulsar para cambiar.
  2. Teclear la query usando los campos, operadores y valores de campo o funciones.
  3. Pulsar sobre el boton de búsqueda (representado con una lupa) para ejecutar la consulta

 

Usando la función 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 alfabético e incluye las 15 primeras coincidencias. Anotar aquí que las sugerencias de autocompletado no se ofrecen para las funciones.

 

Cambiar entre la búsqueda "avanzada" y la "simple"

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:

  • the query contains an OR operator (note you can have an IN operator and it will be translated, e.g. project in (A, B))
    • i.e. even though this query: (project = JRA OR project = CONF) is equivalent to this query:(project in (JRA, CONF)), only the second query will be translated.
  • the query contains a NOT operator
  • the query contains an EMPTY operator
  • the query contains any of the comparison operators: !=, IS, IS NOT, >, >=, <, <=
  • the query specifies a field and value that is related to a project (e.g. version, component, custom fields) and the project is not explicitly included in the query (e.g.
    fixVersion = "4.0", without the 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
    that if the query cannot be created in the 'Simple Search' form, then if it is created using 'Advanced Search' it will not be able to be translated to 'Simple Search'.

 

 Setting Precedence of Operators

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.:

 

(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.

  Keywords Reference

A keyword in JQL is a word or phrase that does (or is) any of the following:

  • joins two or more clauses together to form a complex JQL query
  • alters the logic of one or more clauses
  • alters the logic of operators
  • has an explicit definition in a JQL query
  • performs a specific function that alters the results of a JQL query.

List of Keywords

 

 

Operators Reference

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.

^^top of topic

List of Operators:

 

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

CampoTraducciónDescripción
asigneeAsignadoUsuario de JIRA que tiene asignado el asunto
categoryCategoríaCategoría del proyecto
commentComentario 
componentComponente 
createdFecha de Creación 
descriptionDescripciónCampo con la descripción
dueFecha de Entrega 
levelNivel de Seguridad 
parentAsunto Padre 
priorityPrioridad 
projectProyecto 
reporterInformadorUsuario de JIRA que abre la incidencia
resolutionResolución 
resolvedCódigo de resolución 
statusEstado 
summaryResumenResumen del asunto
updatedFecha de Actualización 

 

 

  • No labels

0 Comments

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account.