La chuleta de Jira Query Language (JQL)
Jira Query Language (JQL) te permite buscar, filtrar y generar informes sobre incidencias en un espacio de trabajo de Jira utilizando consultas flexibles y potentes para obtener resultados precisos. Es la forma de buscar en Jira cuando no basta con hacer clic en los filtros.
JQL está diseñado para cualquier persona que necesite búsquedas precisas y repetibles en las actividades: gestores de proyectos que extraen un informe de estado, administradores que auditan un backlog o ingenieros que buscan cada error asociado a una publicación específica.
Los 4 bloques de construcción de una consulta JQL
Todas las cláusulas JQL se componen de los mismos cuatro elementos:
Parte | ¿Para qué sirve? | Ejemplo |
Campo | El atributo en el que estás buscando |
|
Operador | Relaciona el campo con un valor |
|
Valor o función | Con qué estás comparando |
|
Palabra clave | Vincula varias cláusulas entre sí |
|
Operadores comunes
Los operadores definen cómo Jira compara un campo con el valor que estás buscando. Úsalos para encontrar coincidencias exactas, combinar condiciones, buscar en una lista de valores o comprobar si un campo está vacío.
Operador | Significado | Ejemplo |
| Coincidencia exacta |
|
| No es igual a |
|
| Combina condiciones, todas deben ser verdaderas |
|
| Combina condiciones, cualquiera puede ser verdadera |
|
| Coincide con cualquier valor de una lista |
|
| Contiene (buscar texto) |
|
| El campo no tiene valor |
|
Funciones clave de JQL y su uso
Las funciones JQL mejoran las capacidades de consulta al permitir a los usuarios realizar operaciones más complejas, ordenar los resultados y filtrar según criterios dinámicos. Estas funciones incluyen:
Función | Descripción | Ejemplo |
| Ordena los resultados por un campo. |
|
| Busca incidencias que estuvieron anteriormente en un estado determinado. |
|
| Identifica incidencias modificadas dentro de un plazo. |
|
| Filtra por pertenencia a un grupo. |
|
Ejemplos de JQL para situaciones habituales de Jira
Estas son algunas formas en que puedes usar JQL en Jira.
Caso práctico | Consulta JQL |
Buscar todas las incidencias de alta prioridad que tengas asignadas |
|
Hacer una lista de incidencias vencidas en un proyecto específico |
|
Mostrar incidencias creadas recientemente |
|
Técnicas avanzadas de JQL
Usa la búsqueda avanzada con JQL para utilizar campos personalizados y consultas complejas.
Técnica | Ejemplo | ¿Cómo se utiliza? |
Uso de campos personalizados |
| Búsqueda en campos personalizados para consultas más específicas. |
Subconsultas |
| Filtra las incidencias en función de los resultados de otra consulta. |
Tipos de incidencia específicos |
| Buscar determinados tipos de incidencias y sus estados. |
Cómo detectar errores antes de realizar una búsqueda
El editor de JQL actual en Jira Cloud está diseñado para detectar problemas a medida que escribes, en lugar de esperar a que lances la búsqueda:
Comprobación de errores: La sintaxis no válida se marca de inmediato, junto con indicaciones para corregirla.
Resaltado de sintaxis: Los campos, operadores, valores y funciones están codificados por colores.
Autocompletar: A medida que escribes, aparecen palabras clave y funciones relevantes.
Edición multilínea: Expande el editor y usa los números de línea para encontrar errores.
Referencias de usuario legibles: Se utilizan nombres y avatares en lugar de ID de cuenta sin procesar.
Depurador de JQL: Cuando una consulta devuelve un error, Rovo sugiere una consulta corregida que puedes revisar y aceptar.
Buscar con Rovo
No necesitas memorizar la sintaxis de JQL anterior para realizar una búsqueda precisa. Rovo, la IA de Atlassian, traduce lo que escribes a JQL automáticamente. Desde la barra de búsqueda de Jira, selecciona Preguntar a Rovo y escribe tu pregunta tal como la dirías. Por ejemplo:
"Find all bugs reported in the mobile app project this month" (Encuentra todos los errores reportados en el proyecto de la aplicación móvil este mes)
Rovo convierte esta entrada en la sintaxis de JQL correspondiente, ejecuta la búsqueda y muestra tanto los resultados como el JQL que se ocupó de generar en segundo plano. Esa última parte es clave: es una forma muy práctica de aprender JQL a través de ejemplos, ya que puedes ver exactamente a qué campos, operadores y funciones se asignó tu pregunta en inglés sencillo. Si una consulta es demasiado compleja para que Rovo la pueda resolver en el modo Básico, cambia automáticamente al modo JQL para dar un resultado más preciso. Puedes volver al modo Básico en cualquier momento desde el menú de acciones adicionales.
Cuándo funciona mejor la búsqueda de Rovo | Cuándo pasar a JQL directamente |
Sabes aproximadamente lo que quieres, pero no conoces los nombres exactos de los campos ni la sintaxis | Necesitas consultas precisas y repetibles para paneles, tableros o filtros guardados |
Buscas usando lenguaje cotidiano y palabras clave de tus elementos de actividad, espacios o tableros | Tu consulta necesita funciones o lógica que no se pueden expresar en lenguaje natural de forma fiable |
Quieres aprender la sintaxis de JQL sobre la marcha | Buscas en un idioma que no es el inglés |
JQL: Preguntas frecuentes
¿Cómo puede ayudarme JQL a encontrar incidencias concretas en Jira?
JQL permite crear consultas personalizadas para filtrar incidencias por campos como assignee (persona asignada), status (estado), project (proyecto) o date (fecha), de modo que puedas localizar rápidamente las incidencias que más te interesan.
¿Puedo guardar y compartir mis consultas JQL con mi equipo?
Puedes guardar tus búsquedas JQL como filtros y compartirlos con los compañeros de equipo, lo que facilita que todo el mundo acceda al mismo conjunto de incidencias.
¿Cuáles son algunos casos prácticos habituales para JQL en la gestión de proyectos?
Los equipos suelen usar JQL para hacer un seguimiento de tareas vencidas, supervisar el progreso del sprint, identificar bloqueos y generar informes que se adapten a su flujo de trabajo.
¿Hay algún consejo para escribir consultas JQL más avanzadas?
Usando operadores, funciones y combinando varios criterios con AND/OR, puedes compilar consultas complejas para el seguimiento detallado de incidencias y la generación de informes.