Pesquisa avançada – referência de palavras-chave

Essa página descreve informações sobre palavras-chave que são usadas para pesquisa avançada. Consulte Pesquisa avançada.

Uma palavra-chave na JQL é uma palavra ou frase que faz uma das seguintes ações (ou é um dos resultados dessas ações):

  • une duas ou mais cláusulas para formar uma consulta em JQL complexa
  • altera a lógica de uma ou mais cláusulas
  • altera a lógica dos operadores
  • tem uma definição explícita em uma consulta em JQL
  • realiza uma função específica que altera os resultados de uma consulta em JQL

Lista de palavras-chave:

AND

Palavra-chave usada para combinar várias cláusulas e permitir o refinamento da pesquisa.

Observe que é possível usar parênteses para controlar a ordem de execução das cláusulas.

Exemplos
  • Encontrar todas as pendências abertas no projeto "New office" (Novo escritório):

    project = "New office" and status = "open"
  • Encontrar todas as pendências urgentes em aberto atribuídas a jsmith:

    status = open and priority = urgent and assignee = jsmith
  • Encontrar todas as pendências em um projeto em particular não atribuídas a jsmith:

    project = JRA and assignee != jsmith
  • Encontrar todas as pendências para uma versão específica que consista em números de versão diferentes em vários projetos:

    project in (JRA,CONF) and fixVersion = "3.14"
  • Encontrar todas as pendências em que nem o relator nem o responsável seja Jack, Jill nem John:

    reporter not in (Jack,Jill,John) and assignee not in (Jack,Jill,John)

^ topo da página

OR

Palavra-chave usada para combinar várias cláusulas e permitir a expansão da pesquisa.

Observe que é possível usar parênteses para controlar a ordem de execução das cláusulas.

(Nota: consulte também IN, que pode ser uma maneira mais conveniente de pesquisar diversos valores em um campo.)

Exemplos
  • Encontrar todas as pendências criadas por jsmith ou jbrown:

    reporter = jsmith or reporter = jbrown
  • Encontrar todas as pendências atrasadas ou sem data de vencimento definida:

    duedate < now() or duedate is empty

^ topo da página

NOT

Palavra-chave usada para negar cláusulas individuais ou uma consulta em JQL complexa (uma consulta composta por mais de uma cláusula) usando parênteses, permitindo o refinamento da pesquisa.

(Nota: consulte também NOT EQUALS ("!="), DOES NOT CONTAIN ("!~"), NOT IN e IS NOT.)

Exemplos
  • Encontrar todas as pendências atribuídas a qualquer usuário, exceto jsmith:

    not assignee = jsmith
  • Encontrar todas as pendências que não foram criadas por jsmith nem jbrown:

    not (reporter = jsmith or reporter = jbrown)

^ topo da página

EMPTY

Palavra-chave usada para pesquisar pendências em que um determinado campo não tem um valor especificado. Consulte também NULL.

Observe que a palavra-chave EMPTY pode ser utilizada apenas com campos que têm suporte para os operadores IS e IS NOT. Para ver os operadores suportados pelo campo, consulte a referência do campo individual.

Exemplos
  • Encontrar todas as pendências sem data de vencimento:

    duedate = empty

    ou

    duedate is empty

^ topo da página

NULL

Palavra-chave usada para pesquisar pendências em que um determinado campo não tem um valor especificado. Consulte também EMPTY.

Observe que a palavra-chave NULL pode ser utilizada apenas com campos que têm suporte para os operadores IS e IS NOT. Para ver os operadores suportados pelo campo, consulte a referência do campo individual.

Exemplos
  • Encontrar todas as pendências sem data de vencimento:

    duedate = null

    ou

    duedate is null

^ topo da página

ORDER BY

Palavra-chave usada para especificar os campos cujos valores serão usados para classificar os resultados da pesquisa.

Por padrão, a ordem de classificação do próprio campo será utilizada. Você pode substituir a ordem de classificação especificando uma ordem crescente ("asc") ou decrescente ("desc").

Exemplos
  • Encontrar todas as pendências sem uma data de vencimento, classificadas por data de criação:

    duedate = empty order by created 
  • Encontrar todas as pendências sem uma data de vencimento, classificadas por data de criação e, em seguida, por prioridade (maior à menor):

    duedate = empty order by created, priority desc
  • Encontrar todas as pendências sem uma data de vencimento, classificadas por data de criação e, então por prioridade (menor à maior):

    duedate = empty order by created, priority asc

Ao classificar por Componentes ou Versões, as pendências retornadas serão listadas primeiro por Projeto e, somente depois, pela ordem natural do campo (consulte JRA-31113).

^ topo da página

Last modified on Jul 25, 2017

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.