製品

すべて表示

リソース

Pesquisa avançada – referência de operadores

Pesquisa avançada

このページの内容

お困りですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問

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 "日付"
```
```
BEFORE "日付"
```
```
BY "ユーザー名"
```
```
DURING ("日付1","日付2")
```
```
ON "日付"
```
```
FROM "古い値"
```
```
TO "新しい値"
```

(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}

最終更新日 2017 年 7 月 25 日

この内容はお役に立ちましたか?

はいこの記事についてのフィードバックを送信する

Powered by Confluence and Scroll Viewport.