Close

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.


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

¿Quieres saber más sobre la flexibilidad de JQL en Jira?