Skip to main content

Filtrar projects

Use filtros para escolher quais itens aparecem nas exibições do seu projeto.

Você pode personalizar quais itens aparecem nas visualizações usando filtros para os metadados do item, como os destinatários e os rótulos aplicados aos problemas e pelos campos do projeto. Você pode combinar filtros e salvá-los como visualizações. Para obter mais informações, confira "Gerenciar o fluxo".

Para filtrar uma exibição, clique em e comece a digitar os campos e os valores que deseja filtrar. À medida que você digita, serão exibidos os possíveis valores. Você também pode abrir a paleta de comandos do projeto pressionando Command+K (Mac) ou Ctrl+K (Windows/Linux) e digitar "Filtrar por" para escolher os filtros disponíveis.

Captura de tela do "projeto do Mona". Um campo rotulado como "Filtrar por palavra-chave ou por campo" está realçado com um contorno laranja.

No layout da tabela, você pode clicar nos dados de item para filtrar para itens com esse valor. Por exemplo, clique em um responsável para mostrar apenas itens para ele. Para remover o filtro, clique nos dados do item novamente.

O uso de vários filtros funcionará como um filtro AND lógico. Por exemplo, label:bug status:"In progress" retornará itens com o rótulo bug, com o status "Em andamento". Você também pode fornecer vários valores para que o mesmo campo atue como um filtro OR lógico. Por exemplo, label:bug,support retornará itens com os rótulos bug ou support. Os Projects atualmente não dão suporte a filtros OR lógicos em vários campos.

Os mesmos filtros estão disponíveis para gráficos criados usando insights para Projects, permitindo que você filtre os dados usados para criar seus gráficos. Para obter mais informações, confira "Sobre insights para Projects".

Quando você filtrar uma exibição e adicionar um item, os metadados filtrados serão aplicados ao item adicionado. Por exemplo, se você estiver filtrando por status:"In progress" e adicionar um item, o novo item terá o status definido como "Em andamento".

Você pode usar filtros para gerar exibições para fins muito específicos. Por exemplo, você pode usar assignee:@me status:todo last-updated:5days para criar uma exibição de todo o trabalho atribuído ao usuário atual, com o status "todo", que não foi atualizado nos últimos cinco dias. Você pode criar uma exibição de triagem usando um filtro negativo, como no:label no:assignee repo:octocat/game, que mostraria itens sem um rótulo e sem um destinatário localizados no repositório octocat/game.

Filtrar por campos

QualificadorExemplo
assignee:USERNAMEassignee:octocat mostrará os itens atribuídos a @octocat.
label:LABELlabel:bug mostrará os itens com o rótulo "bug" aplicado.
field:VALUEstatus:done mostrará os itens com o campo "status" definido como "concluído".
reviewers:USERNAMEreviewers:octocat mostrará os itens que foram revisados por @octocat.
milestone:"MILESTONE"marco:"versão QA" mostrará os itens atribuídos ao marco "versão QA".

Combinar filtros

Você pode criar filtros para vários campos. A exibição mostrará os itens que correspondem a todos os filtros.

QualificadorExemplo
assignee:USERNAME field:VALUEassignee:octocat priority:1 mostrará os itens atribuídos a @octocat que têm a prioridade 1.

Você também pode filtrar vários valores do mesmo campo. Se você separar os valores com vírgulas, a exibição mostrará os itens que correspondem a qualquer um dos valores fornecidos.

QualificadorExemplo
assignee:USERNAME,USERNAMEassignee:octocat,stevecat mostrará os itens atribuídos a @octocat ou @stevecat.

Para filtrar vários valores do mesmo campo, mas mostrar itens que correspondem a todos os valores fornecidos, você pode repetir o qualificador de cada valor.

QualificadorExemplo
assignee:USERNAME assignee:USERNAMEassignee:octocat assignee:stevecat mostrará os itens atribuídos a @octocat e @stevecat.

Você também pode combinar filtros que correspondem a alguns itens e que correspondem a todos os itens.

QualificadorExemplo
field:VALUE,VALUE assignee:USER assignee:USERlabel:bug,onboarding assignee:octocat assignee:stevecat mostrará os itens que têm rótulos de bug ou de integração, mas que são atribuídos a @octocat e @stevecat.

Negar um filtro

Você pode inverter qualquer filtro, incluindo combinações, prefixando-o com um hífen.

QualificadorExemplo
-assignee:USERNAME-assignee:octocat não mostrará nenhum item atribuído a @octocat.
-field:VALUE-status:done não mostrará nenhum item com o status "concluído".
-field:VALUE,VALUE-priority:1,2 não mostrará nenhum item com a prioridade 1 ou 2.

Filtrar itens que não têm um valor

Você pode usar no: para filtrar itens que não têm um valor

QualificadorExemplo
no:assigneeno:assignee mostrará todos os itens não atribuídos.
no:reviewersno:reviewers mostrará as solicitações de pull que não têm um revisor.
no:FIELDno:priority mostrará os itens com um campo de prioridade vazio.

Você também pode prefixar um hífen para negar esse comportamento e retornar apenas itens que tenham um valor.

QualificadorExemplo
-no:assignee-no:assignee mostrará apenas os itens atribuídos.
-no:FIELD-no:priority mostrará apenas os itens que têm um valor no campo de prioridade.

Filtrar por local do item

Use o qualificador repo para filtrar itens em um repositório específico.

QualificadorExemplo
repo:OWNER/REPOrepositório:octocat/game mostrará os itens no repositório "octocat/game".

Filtrar por estado do item ou o tipo de item

Você pode usar o qualificador is para filtrar tipos específicos de item ou itens em estados específicos.

QualificadorExemplo
is:STATEis:open mostrará problemas e solicitações de pull abertos.
is:closed mostrará problemas e solicitações de pull fechados.
is:merged mostrará todas as solicitações de pull mescladas.
is:TYPEis:issue mostrará apenas problemas.
is:pr mostrará apenas solicitações de pull.
is:draft mostrará problemas e solicitações de pull de rascunho.
is:issue is:open mostrará problemas abertos.

Filtrar por motivo aproximado

Você pode filtrar itens fechados por motivo aproximado.

QualificadorExemplo
reason:CLOSE REASONreason:completed mostrará os itens fechados porque foram concluídos.
reason:"not planned" mostrará os itens fechados com o motivo "não planejado".
reason:reopened mostrará os itens que foram reabertos após um fechamento anterior.

Filtrar pelo momento da última atualização de um item

Você pode usar a sintaxe {number}days para filtrar pelo momento da última atualização dos itens.

QualificadorExemplo
last-updated:NUMBERdayslast-updated:1day mostrará os itens que foram atualizados há um ou dois dias.
last-updated:7days mostrará os itens que foram atualizados há sete ou mais dias.
-last-updated:10days mostrará os itens que foram atualizados nos últimos dez dias.

GitHub marca um problema ou uma solicitação de pull como atualizado quando:

  • Criado
  • Reaberto
  • Editado
  • Comentado
  • Rotulado
  • Os destinatários são atualizados
  • Os marcos são atualizados
  • Transferido para outro repositório

Filtrar campos de número, data e iteração

Você pode usar >, >=, < e <= para comparar os campos de número, data e iteração. As datas devem ser fornecidas no formato YYYY-MM-DD.

QualificadorExemplo
field:>VALUEpriority:>1 mostrará os itens com uma prioridade maior que 1.
field:>=VALUEdate:>=2022-06-01 mostrará os itens com a data "01/06/2022" ou posterior.
field:<VALUEiteration:<"Iteration 5" mostrará os itens com uma iteração anterior à "Iteração 5".
field:<=VALUEpoints:<=10 mostrará os itens com dez pontos ou menos.

Você também pode usar .. para filtrar um intervalo inclusivo. Ao trabalhar com um intervalo, * pode ser fornecido como um operador curinga.

QualificadorExemplo
field:VALUE..VALUEpriority:1..3 mostrará os itens com a prioridade 1, 2 ou 3.
date:2022-01-01..2022-12-31 mostrará os itens do ano 2022.
points:*.. 10 mostrará os itens com qualquer valor de pontos, incluindo 10.
iteration:"Iteration 1..Iteration 4" mostrará os itens em "Iteração 1", "Iteração 2", "Iteração 3" e "Iteração 4".

Filtrar destinatários e revisores usando palavras-chave

Você pode usar a palavra-chave @me para representar a si mesmo em um filtro.

QualificadorExemplo
field:@meassignee:@me mostrará os itens atribuídos ao usuário conectado.
-reviewers:@me mostrará os itens que não foram revisados pelo usuário conectado.

Filtrar campos de iteração e de data usando palavras-chave

Você pode usar as palavras-chave @previous, @current e @next para filtrar iterações relativas à iteração atual. Você também pode usar @today para filtrar o dia atual.

QualificadorExemplo
field:@keyworditeration:@current mostrará os itens atribuídos à iteração atual.
iteration:@next mostrará os itens atribuídos à próxima iteração.
field:@todaydate:@today mostrará os itens com a data definida como o dia atual.

Você também pode usar os intervalos >, >=, <, <=, +, - e .. com palavras-chave.

QualificadorExemplo
field:@keyword..@keyword+niteration:@current..@current+3 mostrará os itens atribuídos à iteração atual e às próximas três iterações.
date:@today..@today+7 mostrará os itens com uma data definida como hoje ou os próximos sete dias.
field:<@keyworditeration:<@current mostrará os itens atribuídos a qualquer iteração antes da iteração atual.
field:>=@keyworddate:>=@today mostrará os itens com uma data definida como hoje ou posterior.

Filtrar por campos de texto

Você pode filtrar por campos de texto específicos ou usar um filtro de texto geral em todos os campos de texto e títulos. Ao filtrar com texto que contém espaços ou caracteres especiais, coloque o texto entre aspas " ou '.

QualificadorExemplo
field:"TEXT"title:"Correção de bug" mostrará itens com títulos que correspondem exatamente a "Correção de bug".
field:TEXTnote:complete mostrará os itens com um campo de texto de anotação que corresponde exatamente a "complete".
TEXTAPI mostrará os itens com "API" no título ou em qualquer outro campo de texto.
field:TEXT TEXTlabel:bug rendering mostrará os itens com o rótulo "bug" e com "rendering" no título ou em qualquer outro campo de texto.

Você também pode usar um * como curinga.

QualificadorExemplo
field:*TEXT*label:*bug* mostrará os itens com um rótulo que contém a palavra "bug".
field:TEXT*title:API* mostrará os itens com um título que começa com "API".
field:*TEXTlabel:*support mostrará os itens com um rótulo que termina com "support".

Filtragem por tipo de problema

Se sua organização usa tipos de problema, você pode filtrar por tipos específicos.

Note

Os tipos de problemas, subproblemas e a pesquisa avançada de problemas estão atualmente em uma aceitação versão prévia pública para organizações. Para saber mais e adicionar sua organização à lista de espera, consulte o "Blog do GitHub".

QualificadorExemplo
type:"ISSUE TYPE"type:"bug" mostrará problemas com o tipo "bug".

Filtragem por problema pai

Você pode filtrar seus subproblemas por problema pai.

Note

Os tipos de problemas, subproblemas e a pesquisa avançada de problemas estão atualmente em uma aceitação versão prévia pública para organizações. Para saber mais e adicionar sua organização à lista de espera, consulte o "Blog do GitHub".

QualificadorExemplo
parent-issue:OWNER/REPO#ISSUE NUMBERparent-issue:octocat/game#4 mostrará problemas com o problema nº4 em octocat/game como seu problema pai.