Folha de consulta da JQL

Use esta folha da JQL como guia para dominar a Linguagem de Consulta do Jira para pesquisa e filtragem avançadas na ferramenta de gerenciamento de projetos da Atlassian.

Introdução à Linguagem de Consulta do Jira (JQL)

A JQL é uma poderosa linguagem de pesquisa projetada para o Jira que permite aos usuários criar consultas complexas para rastreamento de problemas, filtragem avançada e geração de relatórios. A flexibilidade da JQL no Jira ajuda gerentes de projeto e equipes ágeis a navegar por grandes conjuntos de dados.

Baixe o Jira grátis

Estrutura básica de consultas de JQL

Uma típica consulta de JQL consiste nos seguintes componentes:

Campo: os campos de JQL representam diferentes tipos de informações, como prioridade, versão corrigida ou tipo de item.
Operador: os operadores são a base da consulta. Eles relacionam o campo com o valor, e alguns exemplos comuns incluem igual a (=), diferente de (!=) e menor que (<).
Valor e função: os valores são os pontos de dados específicos que você busca. As funções JQL realizam cálculos ou retornam resultados dinâmicos.
Palavras-chave: palavras-chave de JQL são palavras especiais com significados predefinidos, como AND e OR. Elas são usadas para elaborar consultas mais complexas.

Exemplo: projeto = “Campanha de marketing” AND status = “Em progresso”

Essa estrutura permite que os usuários formulem com rapidez consultas direcionadas a itens ou grupos específicos no Jira.

Operadores comuns de JQL

Compreender os operadores de JQL é crucial para a criação de consultas eficazes. Eles são a base da JQL e, assim, os usuários podem fazer pesquisas precisas e filtrar grandes quantidades de dados para encontrar o que precisam. São operadores comuns na JQL:

=: correspondência exata. Exemplo: Projeto = “Campanha de marketing”. Vai retornar todos os itens pertencentes ao projeto “Campanha de marketing”.
!=: sem correspondência. Exemplo: assignee != currentUser( ). Vai encontrar todos os itens não atribuídos ao usuário atual para ajudar a identificar tarefas que podem precisar da atenção de outras pessoas.
AND: combina várias condições (todas devem ser verdadeiras). Exemplo: priority = High AND status = Open. Vai retornar somente os itens de alta prioridade com status aberto, o que é útil para identificar tarefas críticas que precisam de atenção imediata.
OR: combina várias condições (pelo menos uma deve ser verdadeira). Exemplo: component = “User Interface” OR component = “API”. Vai encontrar itens relacionados à interface do usuário ou aos componentes da API, assim você pode visualizar trabalhos relacionados em diferentes partes do sistema.
IN: corresponde a qualquer valor em uma lista especificada. Exemplo: status IN (“In Progress”, “Under Review”, “Testing”). Vai retornar todos os itens em qualquer um desses três status, o que é uma maneira rápida de ver todos os itens de trabalho ativos.

Principais funções JQL e como elas podem ser usadas

As funções JQL aprimoram os recursos de consulta ao permitir que os usuários realizem operações mais complexas, classifiquem os resultados e filtrem com base em critérios dinâmicos. Essas funções incluem:

ORDER BY: classifica os resultados. Exemplo: project = “Marketing” ORDER BY created DESC. Vai retornar todos os itens no projeto de marketing classificados por data de criação, da mais recente à mais antiga, para que você logo identifique as tarefas mais recentes.
WAS: encontra itens que estavam em um determinado estado. Exemplo: status WAS “Resolved” AND status = “Open”. Vai encontrar todos os itens resolvidos, mas que já foram reabertos, assim você consegue monitorar itens recorrentes.
CHANGED: identifica itens modificados dentro de um período de tempo. Exemplo: status CHANGED AFTER -1w. Vai retornar todos os itens que tiveram os status alterados na última semana, o que ajuda a revisar o progresso ou as mudanças recentes em seu projeto.
MEMBERSOF: filtra por associação ao grupo. Exemplo: assignee IN MEMBERSOF(“developer”). Vai encontrar todos os itens atribuídos a qualquer pessoa no grupo “developers”, assim você pode ver a carga de trabalho da equipe toda.

Exemplos de JQL para casos de uso comuns do Jira

Confira algumas formas de uso da JQL no Jira.

Encontrar todos os itens de alta prioridade atribuídos a você: priority = High AND assignee = currentUser()
Listar itens atrasados em um projeto específico: project = “Customer Support” AND duedate < now() AND status != Closed
Mostrar itens recém-criados: created >= -7d ORDER BY created DES

Técnicas avançadas da JQL

Use a pesquisa avançada com a JQL para ter campos personalizados e fazer consultas complexas.

Campos personalizados: “Custom Field Name” ~ “search term”. Use a JQL para pesquisar em campos personalizados, assim as consultas são mais customizadas e específicas, com base na estrutura de dados exclusiva da sua empresa.
Subconsultas: project IN subTaskIssueTypes() AND assignee = currentUser(). Use a JQL para criar consultas aninhadas, assim você pode filtrar itens com base nos resultados de outra consulta, o que é útil para os relacionamentos hierárquicos complexos nos seus projetos.
Tipos de item específicos: issuetype = Epic AND status != Done. Use a JQL para identificar tipos específicos de itens e os status deles. Dessa forma, você pode acompanhar e gerenciar categorias específicas de trabalho em seus projetos.

Como ser especialista em JQL

Com esta folha de consulta da Atlassian, você consegue usar a pesquisa avançada com a JQL e aprimorar suas habilidades de gerenciamento de projetos.

Dominar a JQL permite que você obtenha insights importantes do projeto e responda a perguntas cruciais e relevantes para sua equipe. Os três tipos de pesquisa no Jira (rápida, básica e avançada) ajudam você a encontrar informações essenciais sobre os projetos. Além disso, os resultados da consulta podem ser salvos e usados como filtros e visualizações no Jira, incluindo quadros.

Quer saber mais sobre a flexibilidade da JQL no Jira?

Baixe o Jira grátis

Folha de consulta da JQL

Introdução à Linguagem de Consulta do Jira (JQL)

Estrutura básica de consultas de JQL

Operadores comuns de JQL

Principais funções JQL e como elas podem ser usadas

Exemplos de JQL para casos de uso comuns do Jira

Técnicas avançadas da JQL

Como ser especialista em JQL

produtos

Recursos

Saiba mais