Pesquisa avançada
A pesquisa avançada permite criar consultas estruturadas usando JQL (JIRA Query Language) para pesquisar pendências. É possível especificar critérios que não podem ser definidos nas pesquisas rápida ou básica (por exemplo, cláusula ORDER BY).
- Se os critérios de pesquisa não forem complexos, poderá ser feita uma pesquisa rápida em vez de avançada.
- Se você não estiver familiarizado com JQL (JIRA Query Language), pode usar a pesquisa básica em vez da avançada.
Observe que a JQL não é uma linguagem de consulta de banco de dados, embora use sintaxe semelhante a SQL.
Captura de tela: Pesquisa avançada
Nesta página:
Pesquisa avançada
- Acesse Pendências (no cabeçalho) > Pesquisar pendências.
- Se já houver critérios de pesquisa, clique no botão Novo filtro para redefini-los.
Se for mostrada a pesquisa básica em vez da avançada, clique em Avançada (ao lado do ícone
).
Insira sua consulta em JQL. Conforme você digita, o JIRA oferecerá uma lista de sugestões de preenchimento automático conforme o contexto da consulta. Observe que as sugestões de preenchimento automático incluem apenas as 15 primeiras correspondências, exibidas em ordem alfabética, assim, poderá ser necessário inserir mais texto se você não conseguir encontrar uma correspondência.
- Pressione Enter ou clique em para executar a consulta. Os resultados de pesquisa serão exibidos no navegador de pendências.
Para entender a pesquisa avançada
Leia os tópicos a seguir para saber como aproveitar todos os benefícios da pesquisa avançada:
Construir consultas em JQL
Uma consulta simples em JQL (também conhecida como "cláusula") consiste em um campo, seguido por um operador, seguido, por sua vez, por um ou mais valores ou funções. Por exemplo:
project = "TEST"Essa consulta encontrará todas as pendências no projeto "TEST". Ela usa o campo "projeto", o operador EQUALS e o valor "TEST".
Este é o exemplo de uma consulta mais complexa:
project = "TEST" AND assignee = currentuser()Essa consulta encontrará todas as pendências no projeto "TEST" em que o responsável é o usuário conectado no momento. Ela usa o campo "projeto", o operador EQUALS, o valor "TEST", a palavra-chave "AND" e a função "currentuser()".
Para obter informações sobre campos, operadores, palavras-chave e funções, consulte a seção Referência abaixo.
Configurar a precedência dos operadores
É possível usar parênteses em instruções em JQL complexas para impor a precedência dos operadores.
Por exemplo, se você quiser encontrar todas as pendências resolvidas no projeto "SysAdmin", bem como todas as pendências (qualquer status, qualquer projeto) atualmente atribuídas ao administrador do sistema (bobsmith), você poderá usar parênteses para impor a precedência dos operadores boolianos na consulta, ou seja:
(status=resolved AND project=SysAdmin) OR assignee=bobsmithObserve que, se você não usar parênteses, a instrução será avaliada da esquerda para a direita.
Também é possível usar parênteses para agrupar cláusulas a fim de aplicar o operador NOT ao grupo.
Palavras e caracteres restritos
Caracteres reservados
A JQL tem uma lista de caracteres reservados:
space (" ") | + | . | , | ; | ? | | | * | / | % | ^ | $ | # | @ | [ | ] |
Se você deseja usar esses caracteres em consultas, precisa:
- colocá-los entre aspas [simples (
') ou duplas (")];
e, se você estiver pesquisando um campo de texto e o caractere estiver na lista de caracteres reservados para as pesquisas de texto, você deve - usar duas contrabarras antes desses caracteres.
Por exemplo:
version = "[example]"
summary ~ "\\[example\\]"
Palavras reservadas
A JQL também tem uma lista de palavras reservadas. Essas palavras precisam ficar entre aspas (simples ou duplas) quando utilizadas em consultas.
Observação para os administradores do JIRA: essa lista está embutida em código no arquivo JqlStringSupportImpl.java.
Realizar pesquisas de texto
É possível usar as funcionalidades de pesquisa de texto do Lucene ao realizar pesquisas nos seguintes campos usando o operador CONTAINS:
Resumo, Descrição, Ambiente, Comentários, campos personalizados que usam a "Busca por texto sem restrição de caracteres" (ou seja, campos personalizados dos seguintes tipos de campo personalizado integrados: Campo de texto sem restrição de caracteres, Campo de texto, Campo de texto somente leitura).
Para obter mais informações, consulte Pesquisar sintaxe para campos de texto.
Referência
| Descrição | Referência | |
|---|---|---|
| Campos | Um campo na JQL é uma palavra que representa um campo do JIRA (ou um campo personalizado que já foi definido no JIRA). | |
| Operadores | Um operador em JQL é composto por um ou mais símbolos ou palavras que comparam o valor de um campo à esquerda do operador com um ou mais valores (ou funções) à direita do operador, de modo que apenas resultados verdadeiros sejam recuperados pela cláusula. Alguns operadores podem usar a palavra-chave NOT. | |
| Palavras-chave | Uma palavra-chave na JQL é uma palavra ou frase que faz uma das seguintes ações (ou é um dos resultados dessas ações):
| |
| Funções | Uma função em JQL aparece como uma palavra seguida por parênteses, que pode conter um ou mais valores explícitos ou campos do JIRA. Uma função executa um cálculo em dados específicos do JIRA ou no conteúdo da função entre parênteses, de modo que apenas resultados verdadeiros são recuperados pela função e, então, novamente pela cláusula em que a função é utilizada. |
Executar uma pesquisa salva
Pesquisas salvas (também conhecidas como Salvar a pesquisa como um filtro) são mostradas no painel esquerdo ao usar a pesquisa avançada. Se o painel esquerdo não estiver aparecendo, passe o cursor do mouse sobre a lateral esquerda da tela para exibi-lo.
Para executar um filtro, por exemplo, Minhas pendências abertas, basta clicar nele. A JQL para a pesquisa avançada será definida, e os resultados da pesquisa serão exibidos.
Próximos passos
Leia os seguintes tópicos relacionados:
- Pesquisar pendências
- Pesquisa básica
- Search syntax for text fields (Sintaxe de pesquisa para campos de texto)
- JQL: The most flexible way to search JIRA (A maneira mais flexível de pesquisar no JIRA), no blog da Atlassian
- Salvar a pesquisa como um filtro
- Working with search results(Como trabalhar com resultados de pesquisa) — saiba como usar o navegador de pendências, exportar os resultados de pesquisa, modificar pendências em massa e compartilhar os resultados da pesquisa.