Chuleta de JQL
Utiliza esta chuleta de JQL de Jira como guía completa para dominar Jira Query Language y realizar búsquedas y filtros avanzados en la herramienta de gestión de proyectos de Atlassian.
Introducción a Jira Query Language (JQL)
JQL es un potente lenguaje de búsqueda diseñado específicamente para Jira, con el que los usuarios pueden crear consultas complejas para el seguimiento de incidencias, el filtrado avanzado y la elaboración de informes. Con la flexibilidad de JQL en Jira, los gerentes de proyectos y los equipos ágiles pueden navegar fácilmente por grandes conjuntos de datos.
Estructura básica de las consultas de JQL
Una consulta de JQL típica consta de los siguientes componentes:
- Campo: los campos de JQL representan diferentes tipos de información, como la prioridad, la versión corregida o el tipo de incidencia.
- Operador: los operadores son el núcleo de la consulta, ya que relacionan el campo con el valor, con ejemplos comunes como "igual a" (=), "no igual a" (! =) y "menos de" (<).
- Valor y función: los valores son los puntos de datos específicos que estás buscando. Las funciones de JQL realizan cálculos o devuelven resultados dinámicos.
- Palabras clave: las palabras clave de JQL son palabras especiales con significados predefinidos, como AND y OR. Se utilizan para crear consultas más complejas.
Ejemplo: proyecto = "campaña de marketing" AND estado = “en curso”
Esta estructura permite a los usuarios formular rápidamente consultas dirigidas a incidencias o grupos específicos de Jira.
Operadores de JQL comunes
Conocer bien los operadores de JQL es crucial para crear consultas eficaces. Son la columna vertebral de JQL, ya que permiten a los usuarios realizar búsquedas precisas que pueden filtrar grandes cantidades de datos para encontrar exactamente lo que necesitan. Los operadores más comunes en JQL son:
=
: Coincidencia exacta. Ejemplo:Proyecto = "campaña de marketing"
. Esta consulta devolverá todas las incidencias que pertenecen al proyecto "campaña de marketing".!=
: No igual a. Ejemplo:responsable != currentUser( )
. Esta consulta dará como resultado todas las incidencias no asignadas al usuario actual, lo que ayudará a identificar las tareas que podrían necesitar la atención de otros.AND
: Combina varias condiciones (todas deben cumplirse). Ejemplo:prioridad = Alta AND estado = Abierto
. Esta consulta solamente devolverá incidencias de prioridad alta y en estado abierto, lo que ayudará a identificar las tareas críticas que requieren atención inmediata.OR
: Combina varias condiciones (al menos una debe cumplirse). Ejemplo:componente = “Interfaz de usuario” OR componente = “API”
. Esta consulta encontrará incidencias relacionadas con la interfaz de usuario o los componentes de la API, lo que permitirá ver el trabajo relacionado en diferentes partes del sistema.IN
: Busca coincidencias con cualquier valor de una lista específica. Ejemplo:estado IN (“En curso”, “En revisión”, “En prueba”)
. Esta consulta devolverá todas las incidencias en cualquiera de estos tres estados y ofrece una forma rápida de ver todos los elementos de trabajo activos.
Funciones clave de JQL y su uso
Las funciones de 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:
-
ORDER BY
: Ordena los resultados. Ejemplo:proyecto = "Marketing" ORDER BY created DESC
. Esta consulta devolverá todas las incidencias del proyecto de marketing, ordenadas por fecha de creación, de la más reciente a la más antigua, lo que te permitirá identificar las tareas más recientes rápidamente. WAS
: Busca incidencias en un estado en particular. Ejemplo:estado WAS "Resuelto" AND estado = "Abierto"
. Esta consulta encontrará todas las incidencias que se resolvieron, pero que se han vuelto a abrir desde entonces, lo que ayudará a rastrear problemas recurrentes.CHANGED
: Identifica incidencias modificadas dentro de un plazo. Ejemplo:estado CHANGED AFTER -1w.
Esta consulta devolverá todas las incidencias cuyo estado haya cambiado en la última semana, lo que es práctico para revisar el progreso o los cambios recientes en el proyecto.MEMBERSOF
: Filtra por pertenencia a un grupo. Ejemplo:responsable IN MEMBERSOF("desarrolladores")
. Esta consulta encontrará todas las incidencias asignadas a cualquier persona del grupo de desarrolladores, lo que permite ver la carga de trabajo de un equipo.
Ejemplos de JQL para situaciones habituales de Jira
Estas son algunas formas en que puedes usar JQL en Jira.
- Buscar todas las incidencias de alta prioridad que tengas asignadas:
prioridad = Alta AND responsable = currentUser()
- Hacer una lista de incidencias vencidas en un proyecto específico:
proyecto = "Asistencia al cliente" AND duedate < now() AND estado != Cerrado
- Mostrar incidencias creadas recientemente:
created >= -7d ORDER BY created DES
Técnicas avanzadas de JQL
Usa la búsqueda avanzada con JQL para utilizar campos personalizados y consultas complejas.
- Uso de campos personalizados:
"nombre del campo personalizado" ~ "término de búsqueda"
. Usa JQL para buscar en campos personalizados, lo que permite realizar consultas más personalizadas y específicas en función de la estructura de datos única de tu empresa. - Subconsultas:
proyecto IN subTaskIssueTypes() AND responsable = currentUser()
. Usa JQL para crear consultas anidadas, lo que te permitirá filtrar las incidencias en función de los resultados de otra consulta. Esta opción es especialmente útil para las relaciones jerárquicas complejas de tus proyectos. - Tipos de incidencia específicos:
issuetype = Epic AND estado != Completado
. Usa JQL para centrarte en tipos de incidencias concretos y sus estados, lo que te ayuda a rastrear y gestionar categorías específicas de trabajo en tus proyectos.
Domina el uso de JQL
Con esta "chuleta" de JQL de Atlassian, tendrás todo lo que necesitas para navegar por la búsqueda avanzada con JQL y mejorar tus habilidades de gestión de proyectos.
Si dominas el uso de JQL, podrás obtener datos relevantes clave sobre el proyecto y responder a preguntas cruciales relevantes para tu equipo. Hay tres opciones de búsqueda en Jira (rápida, básica y avanzada) que pueden ayudarte a obtener información clave de los proyectos. Además, los resultados de las consultas se pueden guardar y utilizar como filtros y vistas en Jira (incluidos los tableros).