Filtros, JQL e Dashboards no Jira para Acompanhamento de Testes

Por que filtros, JQL e dashboards são essenciais no acompanhamento de testes

No Jira, filtros são pesquisas salvas. Eles permitem que QA e time consultem rapidamente listas de issues com um objetivo específico (por exemplo: “pronto para testar”, “reteste pendente”, “bugs abertos na versão X”). O filtro é construído com JQL (Jira Query Language), uma linguagem de consulta que combina campos (project, status, fixVersion etc.) com operadores ( =, !=, IN, NOT IN, IS EMPTY, ORDER BY ).

Já os dashboards são painéis que exibem gadgets (widgets) baseados em filtros. A ideia é transformar perguntas recorrentes do dia a dia em visualizações rápidas: “o que eu testo hoje?”, “quantos bugs estão abertos por versão?”, “o que está bloqueado?”, “quais itens estão sem teste vinculado?”.

JQL básico: campos mais usados no dia a dia de QA

project

Restringe a busca a um projeto.

project = ABC

issuetype

Filtra pelo tipo de issue (ex.: Story, Bug, Task, Test). Use os nomes exatamente como aparecem no Jira.

project = ABC AND issuetype = Bug

status

Filtra pelo status do fluxo (ex.: To Do, In Progress, Ready for Test, Done). Também depende do nome configurado no seu Jira.

Continue em nosso aplicativo e ...

• Ouça o áudio com a tela desligada
• Ganhe Certificado após a conclusão
• + de 5000 cursos para você explorar!

ou continue lendo abaixo...

Baixar o aplicativo

project = ABC AND status = "Ready for Test"

fixVersion

Filtra pela versão alvo (release) associada à issue. Útil para organizar testes e bugs por entrega.

project = ABC AND fixVersion = "1.8.0"

labels

Filtra por etiquetas (tags) usadas para categorizar (ex.: regression, smoke, mobile).

project = ABC AND labels = regression

assignee

Filtra por responsável. Para “eu”, use currentUser().

project = ABC AND assignee = currentUser()

updated

Filtra por data de última atualização. Útil para “o que mudou recentemente”.

project = ABC AND updated >= -7d

Combinações comuns e ordenação

Use AND para combinar condições, OR para alternativas, e ORDER BY para ordenar.

project = ABC AND issuetype = Bug AND status != Done ORDER BY priority DESC, updated DESC

Passo a passo: criando e salvando um filtro no Jira

1. Abra Filters > Advanced issue search (ou “Pesquisa avançada”).

2. Digite a JQL no campo de busca (modo avançado). Comece simples: project = ABC.

3. Refine adicionando condições (tipo, status, versão, responsável, labels, datas).

4. Valide o resultado: confira se a lista retornada responde à pergunta do filtro.

5. Clique em Save as (Salvar como) e dê um nome padronizado (ver boas práticas abaixo).

6. Configure permissões do filtro (quem pode ver). Para uso do time, prefira compartilhar com um grupo (ex.: “QA”, “Squad X”) ou com o projeto.

7. (Opcional) Marque como favorito para facilitar uso em gadgets e no menu de filtros.

Boas práticas de nomenclatura e organização de filtros

Filtros viram “ativos” do time. Sem padrão, rapidamente ficam difíceis de encontrar e manter. Uma convenção simples ajuda muito.

Padrão recomendado de nome

Use um formato consistente, por exemplo:

• [QA] [ABC] Pronto para Teste

• [QA] [ABC] Reteste Pendente

• [QA] [ABC] Bugs Abertos por Versão (fixVersion)

• [QA] [ABC] Bloqueados

• [QA] [ABC] Histórias sem Teste Vinculado

• [QA] [ABC] Bugs sem Evidência

Dicas práticas

• Prefixo por área: [QA] ajuda a separar de filtros de Dev/PO.

• Inclua o projeto: útil quando você atua em múltiplos projetos.

• Evite nomes genéricos: “Bugs abertos” é pouco informativo; prefira “Bugs abertos (não Done) por fixVersion”.

• Documente a intenção: no campo de descrição do filtro, escreva “Para daily de QA” / “Para relatório semanal” e regras importantes.

• Evite duplicidade: antes de criar, pesquise por filtros similares no time.

Filtros JQL prontos para o dia a dia de QA (com exemplos)

Os exemplos abaixo assumem nomes comuns de tipos e status. Ajuste status, issuetype e nomes de versão conforme seu Jira.

1) Itens prontos para teste

Objetivo: listar o backlog de validação do QA.

project = ABC AND status = "Ready for Test" ORDER BY updated DESC

Variações úteis:

• Somente do QA logado (se o time atribui ao QA):

  project = ABC AND status = "Ready for Test" AND assignee = currentUser() ORDER BY updated DESC

• Por versão:

  project = ABC AND status = "Ready for Test" AND fixVersion = "1.8.0" ORDER BY updated DESC

2) Retestes pendentes

Objetivo: encontrar itens que voltaram para QA após correção.

project = ABC AND status = "Retest" ORDER BY updated DESC

Variação por bugs apenas:

project = ABC AND issuetype = Bug AND status = "Retest" ORDER BY updated DESC

3) Bugs abertos por versão (fixVersion)

Objetivo: acompanhar estabilidade por release e alimentar report rápido.

project = ABC AND issuetype = Bug AND status NOT IN (Done, Closed) AND fixVersion = "1.8.0" ORDER BY priority DESC, updated DESC

Variação para ver todas as versões (sem fixar uma):

project = ABC AND issuetype = Bug AND status NOT IN (Done, Closed) AND fixVersion IS NOT EMPTY ORDER BY fixVersion ASC, priority DESC

4) Itens bloqueados

Objetivo: identificar impedimentos que travam teste/entrega.

Se o seu Jira usa um status específico:

project = ABC AND status = Blocked ORDER BY updated DESC

Se o bloqueio é controlado por label:

project = ABC AND labels = blocked ORDER BY updated DESC

Se o bloqueio é controlado por um campo/flag diferente (ex.: “Impediment”), adapte para o nome do campo disponível no seu Jira.

5) Histórias sem teste vinculado

Objetivo: encontrar gaps de rastreabilidade (histórias que deveriam ter teste relacionado).

Este filtro depende do mecanismo de vínculo usado no seu Jira (issue links). Em muitos ambientes, funciona com issueLinkType e uma relação do tipo “tests”/“is tested by”. Exemplos comuns:

• Quando existe um tipo de link “is tested by” (história é testada por um Test):

  project = ABC AND issuetype IN (Story) AND issueLinkType != "is tested by"

• Quando o Jira não permite essa expressão diretamente, uma alternativa é usar um campo dedicado (ex.: “Test Case”/“Test Plan”) ou label obrigatória. Exemplo com label:

  project = ABC AND issuetype = Story AND labels != has_test

Recomendação prática: valide com o administrador quais tipos de link existem e qual o nome exato do link de teste. Se o seu Jira não suportar a consulta de links como esperado, padronize um campo/label para indicar “teste vinculado” e use isso como base do filtro.

6) Bugs sem evidência

Objetivo: identificar bugs que precisam de evidência mínima (ex.: print, vídeo, log) antes de seguir na triagem.

Como “evidência” pode estar em anexos, comentários ou campos, a forma mais confiável é ter um campo ou label que marque evidência (ex.: label evidence_attached ou campo “Evidência” preenchido). Exemplos:

• Por label ausente (quando o processo adiciona evidence_attached ao anexar evidência):

  project = ABC AND issuetype = Bug AND status NOT IN (Done, Closed) AND labels != evidence_attached ORDER BY updated DESC

• Por campo vazio (ex.: campo custom “Evidence Link”):

  project = ABC AND issuetype = Bug AND status NOT IN (Done, Closed) AND "Evidence Link" IS EMPTY ORDER BY updated DESC

Observação: JQL padrão não consegue, em muitos casos, garantir “sem anexo” ou “sem comentário” sem recursos adicionais. Por isso, para auditoria e consistência, prefira um campo/label que indique evidência e torne-o parte do fluxo de QA.

Montando dashboards simples para relatórios rápidos ao time

Um dashboard bom para QA responde perguntas recorrentes em menos de 1 minuto. A estratégia é: 1) criar filtros (as listas acima) e 2) transformar em gadgets com contagens, listas e gráficos.

Passo a passo: criar um dashboard

1. Vá em Dashboards > Create dashboard.

2. Nomeie com padrão (ex.: [QA] [ABC] Acompanhamento de Testes).

3. Defina o compartilhamento (time/squad/projeto).

4. Clique em Add gadget e selecione gadgets baseados em filtros.

5. Para cada gadget, selecione o filtro correspondente e ajuste colunas/limites conforme necessário.

Gadgets recomendados e como usar

Exemplo de dashboard mínimo (QA diário)

• Gadget 1 (Filter Results): “Itens prontos para teste” (top 20, ordenado por updated DESC).

• Gadget 2 (Filter Results): “Retestes pendentes” (top 20).

• Gadget 3 (Issue Statistics): “Bugs abertos por status” (para enxergar gargalos).

• Gadget 4 (Two Dimensional Statistics): “Bugs abertos: fixVersion x priority” (para orientar foco).

• Gadget 5 (Filter Results): “Bloqueados” (para levantar impedimentos na daily).

Dicas para dashboards que o time realmente usa

• Evite excesso de gadgets: 5 a 8 costuma ser suficiente para operação diária.

• Nomeie gadgets com a pergunta: “O que testar hoje?”, “O que está bloqueado?”, “Bugs abertos por versão”.

• Padronize colunas nas listas: Key, Summary, Status, Priority, Fix Version, Assignee.

• Use filtros por versão quando o objetivo for release report; use filtros gerais para operação contínua.

• Revise filtros periodicamente: status renomeado, novos tipos de issue, mudanças de processo podem quebrar a intenção do dashboard.