Products

See all

Resources

Pesquisa avançada – referência de operadores

Pesquisa avançada

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Essa página descreve informações sobre operadores usados em pesquisas avançadas.

Um operador em JQL é um ou mais símbolos ou palavras que comparam o valor de um campo à esquerda deste operador com um ou mais valores (ou funções) à direita deste operador, de modo que a cláusula recupere apenas resultados verdadeiros. Alguns operadores podem usar a palavra-chave NOT.

EQUALS: =

O operador "=" é usado para pesquisar pendências em que o valor do campo especificado corresponde exatamente ao valor especificado. (Nota: não pode ser utilizado com campos de texto. Consulte as informações sobre o operador CONTAINS em vez disso.)

Para encontrar pendências em que o valor de um campo especificado corresponda exatamente a diversos valores, use várias instruções "=" com o operador AND.

Exemplos

Encontrar todas as pendências criadas por jsmith:
```
reporter = jsmith
```
Encontrar todas as pendências criadas por John Smith:
```
reporter = "John Smith"
```

^{^topo da página}

Lista de operadores:

NOT EQUALS: !=

O operador "!=" é usado para pesquisar pendências em que o valor do campo especificado não corresponde ao valor especificado. (Nota: não pode ser utilizado com campos de texto. Consulte as informações sobre o operador DOES NOT MATCH ("!~") em vez disso.)

Observe que digitar field != value é o mesmo que digitar NOT field = value, e que field != EMPTY é o mesmo que field IS_NOT EMPTY.

O operador "!=" não fará a correspondência com um campo que não tenha valor (ou seja, um campo que esteja vazio). Por exemplo, component != fred localizará apenas as pendências que têm um componente e cujo componente não seja "fred". Para encontrar pendências que têm um componente diferente de "fred" ou que não têm componente algum, digite: component != fred or component is empty.

Exemplos

Encontrar todas as pendências atribuídas a qualquer usuário, exceto jsmith:
```
not assignee = jsmith
```
ou:
```
assignee != jsmith
```
Encontrar todas as pendências não atribuídas a jsmith:
```
assignee != jsmith or assignee is empty
```
Encontrar todas as pendências relatadas por mim, mas não atribuídas a mim:
```
reporter = currentUser() and assignee != currentUser()
```
Encontrar todas as pendências em que o Relator ou o Responsável seja qualquer usuário, exceto John Smith:
```
assignee != "John Smith" or reporter != "John Smith"
```
Encontrar todas as pendências não atribuídas:
```
assignee is not empty
```
ou
```
assignee != null
```

^{^topo da página}

GREATER THAN: >

O operador ">" é usado para pesquisar pendências em que o valor do campo especificado é maior que o valor especificado.

Observe que o operador ">" somente pode ser utilizado com campos que tenham suporte para ordenação (por exemplo, campos de data e campos de versão), e que não pode ser utilizado com campos de texto. Para ver os operadores suportados por um campo, consulte a referência do campo individual.

Exemplos

Encontrar todas as pendências com mais de quatro votos:
```
votes > 4
```
Encontrar todas as pendências vencidas:
```
duedate < now() and resolution is empty
```
Encontrar todas as pendências em que a prioridade é superior a "Normal":
```
priority > normal
```

^{^topo da página}

GREATER THAN EQUALS: >=

O operador ">=" é usado para pesquisar pendências em que o valor do campo especificado é superior ou igual ao valor especificado.

Observe que o operador ">=" somente pode ser utilizado com campos que tenham suporte para ordenação (por exemplo, campos de data e campos de versão), e que não pode ser utilizado com campos de texto. Para ver os operadores suportados por um campo, consulte a referência do campo individual.

Exemplos

Encontrar todas as pendências com quatro votos ou mais:
```
votes >= 4
```
Encontrar todas as pendências que vencem em 31/12/2008 ou depois:
```
duedate >= "2008/12/31"
```
Encontrar todas as pendências criadas nos últimos cinco dias:
```
created >= "-5d"
```

^{^topo da página}

LESS THAN: <

O operador "<" é usado para pesquisar pendências em que o valor do campo especificado é inferior ao valor especificado.

Observe que o operador "<" somente pode ser utilizado com campos que tenham suporte para ordenação (por exemplo, campos de data e campos de versão), e não pode ser utilizado com campos de texto. Para ver os operadores suportados por um campo, consulte a referência do campo individual.

Exemplos

Encontrar todas as pendências com menos de quatro votos:
```
votes < 4
```

^{^topo da página}

LESS THAN EQUALS: <=

O operador "<=" é usado para pesquisar pendências em que o valor do campo especificado é inferior ou igual ao valor especificado.

Observe que o operador "<=" somente pode ser utilizado com campos que tenham suporte para ordenação (por exemplo, campos de data e campos de versão), e não pode ser utilizado com campos de texto. Para ver os operadores suportados por um campo, consulte a referência do campo individual.

Exemplos

Encontrar todas as pendências com quatro votos ou menos:
```
votes <= 4
```
Encontrar todas as pendências que não foram atualizadas no último mês (30 dias):
```
updated <= "-4w 2d"
```

^{^topo da página}

IN

O operador "IN" é usado para pesquisar pendências em que o valor do campo especificado é um entre os diversos valores especificados. Os valores são especificados como uma lista delimitada por vírgula entre parênteses.

Usar "IN" é equivalente a usar várias instruções EQUALS (=), mas é mais curto e mais conveniente. Ou seja, digitar reporter IN (tom, jane, harry) é o mesmo que digitar reporter = "tom" OR reporter = "jane" OR reporter = "harry".

Exemplos

Encontrar todas as pendências criadas por jsmith ou jjones:
```
reporter in (jsmith,jbrown,jjones)
```
Encontrar todas as pendências em que o Relator ou o Responsável seja Jack ou Jill:
```
reporter in (Jack,Jill) or assignee in (Jack,Jill)
```
Encontrar todas as pendências na versão 3.14 ou 4.2:
```
affectedVersion in ("3.14", "4.2")
```

^{^topo da página}

NOT IN

O operador "NOT IN" é usado para pesquisar pendências em que o valor do campo especificado não é um entre os diversos valores especificados.

Usar "NOT IN" é equivalente a usar várias instruções NOT_EQUALS (!=), mas é mais curto e mais conveniente. Ou seja, digitar reporter NOT IN (tom, jane, harry) é o mesmo que digitar reporter != "tom" AND reporter != "jane" AND reporter != "harry".

O operador "NOT IN" não fará a correspondência com um campo que não tenha valor (ou seja, um campo que esteja vazio). Por exemplo, assignee not in (jack,jill) retornará apenas pendências que tenham um responsável e o responsável não seja "jack" nem "jill". Para encontrar pendências atribuídas a alguém que não seja "jack" nem "jill" ou que não tenham sido atribuídas, digite: assignee not in (jack,jill) or assignee is empty.

Exemplos

Encontrar todas as pendências em que o Responsável seja alguém que não Jack, Jill nem John:
```
assignee not in (Jack,Jill,John)
```
Encontrar todas as pendências em que o Responsável não seja Jack, Jill nem John:
```
assignee not in (Jack,Jill,John) or assignee is empty
```
Encontrar todas as pendências em que a versão corrigida não seja "A", "B", "C" nem "D":
```
FixVersion not in (A, B, C, D)
```
Encontrar todas as pendências em que a versão corrigida não seja "A", "B", "C" nem "D", nem tenha sido especificada:
```
FixVersion not in (A, B, C, D) or FixVersion is empty
```

^{^topo da página}

CONTAINS: ~

O operador "~" é usado para pesquisar pendências em que o valor do campo especificado corresponda ao valor especificado (uma correspondência exata ou aproximada; veja exemplos a seguir). Para uso somente em campos de texto, ou seja:

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 (texto ilimitado)
- Campo de texto (<255 caracteres)
- Campo de texto somente leitura

O "texto" do campo em JQL, como em text ~ "some words", pesquisa um Resumo, uma Descrição, um Ambiente e Comentários de uma pendência. Também pesquisa todos os campos personalizados de texto. Se você tiver muitos campos personalizados, poderá melhorar o desempenho das consultas pesquisando campos específicos, por exemplo,
Summary ~ "some words" OR Description ~ "some words"

Nota: ao usar o operador "~", o valor no lado direito do operador pode ser especificado usando a sintaxe de pesquisa de texto do JIRA.

Exemplos

Encontrar todas as pendências em que Resumo contenha a palavra "win" (ou derivados simples dessa palavra, como "wins"):
```
summary ~ win
```
Encontrar todas as pendências em que o Resumo contenha uma correspondência de curinga para a palavra "win":
```
summary ~ "win*"
```
Encontrar todas as pendências em que o Resumo contenha a palavra "issue" (pendência) e a palavra "collector" (coletor):
```
summary ~ "issue collector"
```
Encontrar todas as pendências em que o Resumo contenha a frase exata "full screen" (tela inteira) (consulte Search syntax for text fields (Sintaxe de pesquisa para campos de texto) para obter detalhes sobre como escapar aspas e outros caracteres especiais):
```
summary ~ "\"full screen\""
```

^{^topo da página}

DOES NOT CONTAIN: !~

O operador "!~" é usado para pesquisar pendências em que o valor do campo especificado não é uma correspondência aproximada para o valor especificado. Para uso somente em campos de texto, ou seja:

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 (texto ilimitado)
- Campo de texto (<255 caracteres)
- Campo de texto somente leitura

O "texto" do campo em JQL, como em text ~ "some words", pesquisa um Resumo, uma Descrição, um Ambiente e Comentários de uma pendência. Também pesquisa todos os campos personalizados de texto. Se você tiver muitos campos personalizados, poderá melhorar o desempenho das consultas pesquisando campos específicos, por exemplo,
Summary ~ "some words" OR Description ~ "some words"

Nota: ao usar o operador "!~", o valor no lado direito do operador pode ser especificado usando a sintaxe de pesquisa de texto do JIRA.

Exemplos

Encontrar todas as pendências em que Resumo não contenha a palavra "run" (ou derivados simples dessa palavra, como "running" ou "ran"):
```
summary !~ run
```

^{^topo da página}

IS

O operador "IS" pode ser utilizado somente com EMPTY ou NULL. Ou seja, é usado para pesquisar pendências em que o campo especificado não tem um valor.

Nem todos os campos são compatíveis com esse operador. Consulte a referência do campo individual para obter detalhes.

Exemplos

Encontrar todas as pendências que não têm Corrigido na versão:
```
fixVersion is empty
```
ou
```
fixVersion is null
```

^{^topo da página}

IS NOT

O operador "IS NOT" pode ser utilizado somente com EMPTY ou NULL. Ou seja, é usado para pesquisar pendências em que o campo especificado tem um valor.

Nem todos os campos são compatíveis com esse operador. Consulte a referência do campo individual para obter detalhes.

Exemplos

Encontrar todas as pendências que têm um voto ou mais:
```
votes is not empty
```
ou
```
votes is not null
```

^{^topo da página}

WAS

O operador "WAS" é usado para encontrar pendências que apresentam ou apresentaram o valor especificado para o campo especificado.

Esse operador tem os seguintes predicados opcionais:

AFTER "date"
BEFORE "date"
BY "username"
DURING ("date1","date2")
ON "date"

Esse operador fará a correspondência com o nome do valor (por exemplo, "Resolvido"), que foi configurado no sistema no momento em que o campo foi alterado. Esse operador também fará a correspondência com o ID de valor associado ao nome do valor, ou seja, tanto com "4" quanto com "Resolvido".

(Nota: esse operador pode ser usado somente com os campos Responsável, Corrigido na Versão, Prioridade, Relator, Resolução e Status.)

Exemplos

Encontrar pendências que apresentam ou apresentaram o status "Em andamento":
```
status WAS "In Progress"
```
Encontrar pendências que foram resolvidas por Joe Smith antes de 2 de fevereiro:
```
status WAS "Resolved" BY jsmith BEFORE "2011/02/02"
```

Encontrar pendências resolvidas por Joe Smith em 2010:

status WAS "Resolved" BY jsmith DURING ("2010/01/01","2011/01/01")

^{^topo da página}

WAS IN

O operador "WAS IN" é usado para encontrar pendências que apresentam ou apresentaram um dos vários valores especificados para o campo especificado. Os valores são especificados como uma lista delimitada por vírgula entre parênteses.

Usar "WAS IN" é equivalente a usar várias instruções WAS, mas é mais curto e mais conveniente. Ou seja, digitar status WAS IN ('Resolved', 'Closed') é o mesmo que digitar status WAS "Resolved" OR status WAS "Closed".

Esse operador tem os seguintes predicados opcionais:

AFTER "date"
BEFORE "date"
BY "username"
DURING ("date1","date2")
ON "date"

Esse operador fará a correspondência com o nome do valor (por exemplo, "Resolvido"), que foi configurado no sistema no momento em que o campo foi alterado. Esse operador também fará a correspondência com o ID de valor associado ao nome do valor, ou seja, tanto com "4" quanto com "Resolvido".

(Nota: esse operador pode ser usado somente com os campos Responsável, Corrigido na Versão, Prioridade, Relator, Resolução e Status.)

Exemplos

Encontrar todas as pendências que apresentam ou apresentaram o status "Resolvido" ou "Em andamento":
```
status WAS IN ("Resolved","In Progress")
```

^{^topo da página}

WAS NOT IN

O operador "WAS NOT IN" é usado para pesquisar pendências em que o valor do campo especificado nunca foi um dos vários valores especificados.

Usar "WAS NOT IN" é equivalente a usar várias instruções WAS_NOT, mas é mais curto e mais conveniente. Ou seja, digitar status WAS NOT IN ("Resolved","In Progress") é o mesmo que digitar status WAS NOT "Resolved" AND status WAS NOT "In Progress".

Esse operador tem os seguintes predicados opcionais:

AFTER "date"
BEFORE "date"
BY "username"
DURING ("date1","date2")
ON "date"

Esse operador fará a correspondência com o nome do valor (por exemplo, "Resolvido"), que foi configurado no sistema no momento em que o campo foi alterado. Esse operador também fará a correspondência com o ID de valor associado ao nome do valor, ou seja, tanto com "4" quanto com "Resolvido".

(Nota: esse operador pode ser utilizado somente com os campos Responsável, Corrigido na Versão, Prioridade, Relator, Resolução e Status.)

Exemplos

Encontrar pendências que nunca apresentaram status "Resolvido" ou "Em andamento":
```
status WAS NOT IN ("Resolved","In Progress")
```
Encontrar pendências que não apresentaram o status "Resolvido" ou "Em andamento" antes de 2 de fevereiro:
```
status WAS NOT IN ("Resolved","In Progress") BEFORE "2011/02/02"
```

^{^topo da página}

WAS NOT

O operador "WAS NOT" é usado para encontrar pendências que nunca apresentaram o valor especificado para o campo especificado.

Esse operador tem os seguintes predicados opcionais:

AFTER "date"
BEFORE "date"
BY "username"
DURING ("date1","date2")
ON "date"

Esse operador fará a correspondência com o nome do valor (por exemplo, "Resolvido"), que foi configurado no sistema no momento em que o campo foi alterado. Esse operador também fará a correspondência com o ID de valor associado ao nome do valor, ou seja, tanto com "4" quanto com "Resolvido".

(Nota: esse operador pode ser usado somente com os campos Responsável, Corrigido na Versão, Prioridade, Relator, Resolução e Status.)

Exemplos

Encontrar pendências que não apresentam e nunca apresentaram o status "Em andamento":
```
status WAS NOT "In Progress"
```
Encontrar pendências que não apresentaram o status "Em andamento" antes de 2 de fevereiro:
```
status WAS NOT "In Progress" BEFORE "2011/02/02"
```

^{^topo da página}

CHANGED

O operador "CHANGED" é utilizado para encontrar pendências que apresentam um valor alterado para o campo especificado.

Esse operador tem os seguintes predicados opcionais:

```
AFTER "date"
```
```
BEFORE "date"
```
```
BY "username"
```
```
DURING ("date1","date2")
```
```
ON "date"
```
```
FROM "oldvalue"
```
```
TO "newvalue"
```

(Nota: esse operador pode ser utilizado somente com os campos Responsável, Corrigido na Versão, Prioridade, Relator, Resolução e Status.)

Exemplos

Encontrar pendências alteradas pelo responsável:
```
assignee CHANGED
```
Encontrar pendências cujo status foi alterado de "Em andamento" para "Aberta":
```
status CHANGED FROM "In Progress" TO "Open"
```
Encontrar pendências cuja prioridade foi alterada pelo usuário "freddo" após o início e antes do término da semana corrente.
```
priority CHANGED BY freddo BEFORE endOfWeek() AFTER startOfWeek()
```

^{^topo da página}

Last modified on Jul 25, 2017

Was this helpful?

Yes Provide feedback about this article

Powered by Confluence and Scroll Viewport.