Esta página proporciona información sobre la sintaxis para buscar campos de texto, que se puede realizar en la búsqueda rápida, búsqueda básica y búsqueda avanzada.
Las búsquedas de texto se pueden realizar en la búsqueda avanzada cuando se utiliza el operador CONTAINS (~), por ejemplo resumen ~ "ventanas *". También podemos realizar en búsqueda rápida y búsqueda básica cuando se busca en campos admitidos.
Agradecimientos: Jira utiliza Apache Lucene para la indexación de texto, que proporciona un lenguaje de consulta enriquecido. Gran parte de esta página se deriva de la página de sintaxis del analizador de consultas de la documentación de Lucene.
Términos de consulta
Una consulta se divide en términos y operadores. Existen dos tipos de términos: términos únicos y frases.
- Un término único es una única palabra, como "prueba" o "hola".
- Una frase es un grupo de palabras entre comillas dobles, como "hola muñeca".
Se pueden combinar varios términos junto con operadores booleanos para formar una consulta más compleja. Si combinamos varios términos sin especificar ningún operador booleano, se unirán mediante operadores AND.
Nota: Todos los términos de consulta en Jira no distinguen entre mayúsculas y minúsculas.
Modificadores de término
JIRA permite la modificación de términos de consulta para proporcionar una amplia gama de opciones de búsqueda.
Búsquedas exactas (frases)
Para encontrar coincidencias exactas para frases, por ejemplo, Jira Software, debemos incluir toda la frase entre comillas ("). De lo contrario, la búsqueda devolverá todos los problemas que contengan ambas palabras sin ningún orden en particular; esto incluiría Jira Software, ¡pero también Jira es el mejor software!.
Si estamos utilizando la búsqueda avanzada, también debe escapar de cada una de las comillas con una barra invertida (\). Para obtener más detalles, consultar los ejemplos que continuan o buscar nuestro campo en https://confluence.atlassian.com/display/SERVICEDESKSERVER047/Advanced+searching+-+fields+reference
Ejemplos:
Búsqueda básica: encontrar todos los problemas que contengan la frase Jira Software:
Escribiremos "Jira Software" en el campo de búsqueda
Búsqueda avanzada: encontrar todos los números que contengan las palabras Jira y Software, sin ningún orden en particular.
text ~ "Jira Software"
Búsqueda avanzada: encontrar todas las solicitudes que contengan la frase Jira Software.
text ~ "\"Jira Software\""
Búsqueda avanzada: encontrar todas las solicitudes que contengan la URL https://atlassian.com:
text ~ "\"https://atlassian.com\""
Como podemos ver en los dos ejemplos anteriores, la consulta contien dos pares de comillas. Los externos son necesarios para cumplir con las reglas de JQL y no están relacionados con nuestra consulta de búsqueda. Jira agregaría automáticamente el mismo par de comillas en la búsqueda básica después de ejecutar la búsqueda.
Utilizar caracteres epeciales para crear frases
En versiones anteriores de Jira, podía utilizar algunos caracterres especiales para combinar términos en frases, por ejemplo Jira+Software o Jira/Software. Este ya no es el caso, ya que el mecanismo de búsqueda ha cambiado y se ignoran los caracteres especiales que rodean los términos.
Búsquedas con comodines: ? y *
Jira admite búsquedas con comodines de uno o varios caracteres.
Para realizar una búsqueda con comodines de un solo carácter, utilizaremos el símbolo "?".
Para realizar una búsqueda con comodines de varios caracteres, utilizaremos el símbolo "*".
Los caracteres comodín deben incluirse entre comillas, ya que son caracteres reservados en la búsqueda avanzada.
Ejemplo: resumen ~ "cha? ky che *"
La búsqueda con comodines de un solo carácter busca términos que coincidan con el caráter reemplazado. Por ejemplo, para buscar "text" o "test", podemos utilizar la búsqueda
te?t
Las búsquedas con comodines de varios caracteres buscan 0 o más caracteres. Por ejemplo, para buscar Windows, Win95 o WindowsNT, podemos utilizar la búsqueda:
win*
También podemos utilizar las búsquedas con comodines en medio de un término. Por ejemplo, para buscar Win95 o Windows95, podemos utilizar la búsqueda:
wi*95
No podemos utilizar un * o el símbolo ? como el primer carácter de una búsqueda.
Búsquedas difusas: ~
Jira admite búsquedas difusas. Para hacer una búsqueda aproximada, utilizamos el símbolo de tilde "~", al final de un término de una sola palabra. Por ejemplo, para buscar un término similar en ortografía a "roam", utilizaremos la búsqueda aproximada:
roam~
Esta búsqueda encontrará términos como foam y roams.
Nota: Los términos encontrados por la búsqueda aproximada obtendrán automáticamente un factor de aumento de 0.2.
Búsqueda de prefijos y sufijos
Jira apoya la búsqueda de partes de las palabras. Para realizar dicha búsqueda, incluya un prefijo o sufijo de la palabra o frase que está buscando. Por ejemplo, para buscar un problema de MagicBox, podemos utilizar cualquiera de los dos patrones de búsqueda:
| Buscar prefijos | Buscar sufijos |
|---|---|
|
|
Búsquedas de proximidad
Jira apoya la búsqueda de palabras que estén a una distancia específica. Para hacer una búsqueda de proximidad, utilizaremos el símbolo de tilde "~", al final de una frase. Por ejemplo, para buscar "atlassian" y "Jira" con 10 palabras entre sí en un documento, utilizaremos la búsqueda:
"atlassian Jira"~10
Impulsar un término: ^
Jira nos proporciona el nivel de relevancia de los documentos coincidentes según los términos encontrados. Para potenciar un término, utilizaremos el símbolo de intercalación "^" con un factor de potenciación (un número) al final del término que está buscando. Cuanto mayor sea el factor de impulso, más relevante será el término.
El impulso le permite controlar la relevancia de un documento aumentando su plazo. Por ejemplo, si estamos buscando
atlassian Jira
y deseamos que el término "atlassian" sea más relevante, aumentaremos utilizando el símbolo ^ junto con el factor de aumento al lado del término. Escribiríamos
atlassian^4 Jira
Esto hará que los documentos con el término Atlassian parezcan más relevantes. También podemos mejorar los términos de frases, como en el ejemplo:
"atlassian Jira"^4 querying
Por defecto, el factor de impulso es 1. Aunque el factor de impulso debe ser positivo, puede ser menor que uno (es decir, 0,2).
Operadores booleanos
Los operadores booleanos permiten combinar términos a través de operadores lógicos. Jira admite AND, "+", OR, NOT y "-" como operadores booleanos.
OR
El operador OR es el operador de conjunción predeterminado. Esto significa que si no hay un operador booleano entre dos términos, se utiliza el operador OR. El operador OR vincula dos términos y busca un documento coincidente si alguno de los términos existe en un documento. Esto es equivalente a una unión usando conjuntos. El símbolo || se puede utilizar en lugar de la palabra OR.
Para buscar documentos que contengan "atlassian Jira" o simplemente "confluence", utilizaremos la consulta:
"atlassian Jira" || confluence
o
"atlassian Jira" OR confluence
AND
El operador AND hace coincidir documentos donde ambos términos existen en cualquier parte del texto de un único documento. Esto es equivalente a una intersección usando conjuntos. El símbollo && puede utilizarse en lugar de la palabra AND.
Para buscar documentos que contengan "atlassian Jira" y "seguimiento de problemas", utilizaremos la consulta:
"atlassian Jira" AND "seguimiento de problemas"
Término requerido: +
El operador "+" o requerido requiere que el término después del símbolo "+" exista en algún lugar del campo de un solo documento.
Para buscar documentos que deben contener "Jira" y pueden contener "atlassian", utilizaremos la consulta:
+Jira atlassian
NOT
El operador NOT excluye los documentos que contienen el término después de NOT. Esto es equivalente a una diferencia utilizando conjuntos. El símbolo ! se puede utilizar en lugar de la palabra NOT.
Para buscar documentos que contengan "atlassian Jira" pero no "japón", utilizaremos la consulta:
"atlassian Jira" NOT "japón"
Nota: El operador NOT no se puede utilizar con un solo término. Por ejemplo, la siguiente búsqueda no arrojará resultados:
NOT "atlassian Jira"
El uso del operador NOT en varios campos puede devolver resultados que incluyan el término excluido especificado. Esto se debe al hecho de que la consulta de búsqueda se ejecuta en cada campo a su vez, y el conjunto de resultados para cada campo se combina para formar el conjunto de rsultados final. Por lo tanto, un problema que coincide con la consulta de búsqueda según un campo, pero falla en otro campo, se incluirá en el conjunto de resultados de búsqueda.
Término excluido: -
El operador "-" o prohibir excluye los documentos que contienen el término después del símbolo "-".
Para buscar documentos que contengan "atlassian Jira" pero no "japón", utilizaremos la consulta:
"atlassian Jira" -japan
Agrupamiento
Jira admite el uso de paréntesis para agrupar cláusulas para formar subconsultas. Esto puede resultar muy útil si deseamos controlar la lógica booleana de una consulta.
Para buscar bugs y atlassian o Jira, utilizamos la consulta:
bugs AND (atlassian OR Jira)
Esto elimina cualquier confusión y asegura que los errores deben existir, y puede existir, y puede existir el término atlassian o Jira.
No utilizaremos el carácter de agrupación '(' al comienzo de una consulta de búsqueda, ya que esto dará como resultado un error. Por ejemplo, "(atlassian OR Jira) AND bugs" no funcionará.
Caracteres especiales
Los caracteres especiales no se almacenan en el índice, lo que significa que no podemos buscarlos. El índice solo conserva texto y números, por lo que la búsqueda de "\\ [Jira Software \\]" y "Jira Software" tendrá el mismo efecto: los caracteres especiales de escape ([]) no se incluirán en la búsqueda
En versiones anteriores de Jira, podíamos utilizar caracteres especiales para combinar dos términos separados por una frase, por ejemplo, "Jira + Software" o "Jira/Software". Esto no se aplica a Jira 8.x.
Palabras reservadas
Para mantener el tamaño del índice de búsqueda y el rendimiento de búsqueda óptimos en Jira, las siguientes palabras reservadas en inglés (también conocidas como palabras vacías) se ignoran del índice de búsqueda y, por lo tanto, las funciones de búsqueda de texto de Jira:
"a", "and", "are", "as", "at", "be", "but", "by", "for", "if", "in", "into", "is", "it", "no", "not", "of", "on", "or", "such", "that", "the", "their", "then", "there", "these", "they", "this", "to", "was", "will", "with"
Debemos tener en cuenta que esto a veces puede dar lugar a resultados inesperados. Por ejemplo, suponemos que un problema contiene la frase de texto "VSX fallará" y otro problema contiene la frase "VSX no fallará". Una búsqueda de texto para "VSX fallará" devolverá ambos problemas. Esto se debe a que las palabras serán y no serán parte d ela lista de palabras reservadas.
Su administrador de Jira puede hacer que Jira indexw estas palabras reservadas (para que Jira encuentre problemas en función de la presencia de estas palabras) cambiando el Idioma de indexación a Otro (en [Administración] [Sistema] [Configuración general]).
Derivación de palabras
Dado que JIRA no puede buscar solicitudes que contengan partes de palabras (ver más abajo), la palabra derivación nos permite recuperar solicitudes de una búsqueda basasa en las formas raíz de las palabras en lugar de requerir una coincidencia exacta con formas de estas palabras. La cantidad de solicitudes recuperadas de una búsqueda basada en una palabra derivada suele ser mayor, ya que cualquier otra solicitud que contenga palabras derivadas de la misma raíz también se recuperará en los resultados de la búsqueda.
Por ejemplo, si buscamos solicitudes utilizando el término de consulta 'personalizar' en el campo Asunto, JIRA deriva esta palabra a su forma raíz 'personalizado' y recuperará todas las solicitudes cuyo campo Asunto también contenga cualquier palabra que pueda derivarse de 'personalizado'. De ahí la siguiente consulta:
resumen ~ "personalizar"
recuperará todos los problemas cuyo campo Asunto contenga las siguientes palabras:
- personalizado
- personalizar
- personal
- personalidad
- etc.
El administrador de JIRA puede deshabilitar la derivación de palbras (para que JIRA encuentre problemas basados en coincidencias exactas con palabras) cambiando el Idioma de indexación a Otro (en [Administración] [Sistema] [Configuración general]).
La derivación de palabras se aplica a todos los campos de JIRA (así como a los campos de texto).
Cuando JIRA indexa sus campos, todas las palabras que están derivadas se almacenan en el índice de búsqueda de JIRA solo en forma raíz.
Limitaciones
JIRA no puede buscar solicitudes que contengan partes de palabras, sino solo palabras completas. La excepción a esto son las palabras con raíz.
Esta limitación también se puede superar mediante búsquedas difusas.