Pesquisa avançada

Esta página descreve informações sobre funções utilizadas para pesquisa avançada.

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. Em uma cláusula, uma função é precedida por um operador, que, por sua vez, é precedido por um campo. 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.

A menos que especificado na consulta da pesquisa, as pesquisas em JQL não retornam campos vazios nos resultados. Para incluir campos vazios (por exemplo, pendências não atribuídas) ao pesquisar pendências não atribuídas ao usuário atual, insira (assignee != currentUser() OR assignee is EMPTY) para incluir pendências não atribuídas na lista de resultados.

approved()

Aplicável somente se o JIRA Service Desk estiver instalado e licenciado.

Função usada para pesquisar pendências que exigiram aprovação e cuja decisão final foi aprovada.

Sintaxe	approved()
Campos com suporte	Campos personalizados do tipo Aprovação
Operadores com suporte	=
Operadores sem suporte	`~ , != , !~ ,` > , >= , < , <= `IS , IS NOT , IN , NOT IN ,` `WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED`
Exemplos	Encontrar todas as pendências aprovadas: `approval = approved()`

Sintaxe	approver(user,user)
Campos com suporte	Campos personalizados do tipo Aprovação
Operadores com suporte	=
Operadores sem suporte	`~ , != , !~ , > , >= , < , <= IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED`
Exemplos	Encontrar pendências que exijam ou exigiram a aprovação de John Smith: `approval = approver(jsmith)` Encontrar pendências que exijam ou exigiram a aprovação de John Smith ou Sarah Kahn:`approval = approver(jsmith,skhan)`

Sintaxe	cascadeOption(parentOption) cascadeOption(parentOption,childOption)
Campos com suporte	Campos personalizados do tipo "seleção em cascata"
Operadores com suporte	`IN , NOT IN`
Operadores sem suporte	`= , != , ~ , !~ , > , >= , < , <= IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED`
Exemplos	Encontrar pendências em que o campo personalizado "Location" (Local) tem o valor "USA" (EUA) para o primeiro nível e "New York" (Nova Iorque) para o segundo nível: `location in cascadeOption("USA","New York")` Encontrar pendências em que o campo personalizado "Location" (Local) tem o valor "USA" (EUA) para o primeiro nível e qualquer valor (ou nenhum valor) para o segundo nível: `location in cascadeOption(` `"USA"` `)` Encontrar pendências em que o campo personalizado "Location" (Local) tem o valor "USA" (EUA) para o primeiro nível e nenhum valor para o segundo nível: `location in cascadeOption(` `"USA"` `,none)` Encontrar pendências em que o campo personalizado "Location" (Local) não tem nenhum valor para o primeiro nível e nenhum valor para o segundo nível: `location in cascadeOption(none)` Encontrar pendências em que o campo personalizado "Referrer" (Referenciador) tem o valor "none" (nenhum) para o primeiro nível e "none" (nenhum) para o segundo nível: `referrer in cascadeOption(` `"\"none\""` `,` `"\"none\""` `)` Encontrar pendências em que o campo personalizado "Referrer" (Referenciador) tem o valor "none" (nenhum) para o primeiro nível e nenhum valor para o segundo nível: `referrer in cascadeOption(` `"\"none\""` `,none)`

Sintaxe	closedSprints()
Campos com suporte	Sprint
Operadores com suporte	`IN , NOT IN`
Operadores sem suporte	`= , != , ~ , !~ , > , >= , < , <= IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED`
Exemplos	Encontrar todas as pendências atribuídas a um sprint: `sprint in closedSprints()`

Sintaxe	componentsLeadByUser() componentsLeadByUser(username)
Campos com suporte	Componente
Operadores com suporte	`IN , NOT IN`
Operadores sem suporte	`= , != , ~ , !~ , > , >= , < , <= IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED`
Exemplos	Encontrar pendências abertas nos componentes conduzidos por você: `component in componentsLeadByUser() AND status = Open` Encontrar pendências abertas nos componentes conduzidos por Bill: `component in componentsLeadByUser(bill) AND status = Open`

Sintaxe	currentLogin()
Campos com suporte	Criado, Vencido, Resolvido, Atualizado, campos personalizados do tipo Data/Hora
Operadores com suporte	`= , != , > , >= , < , <=` *`WAS , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED`_{ Only in predicate}
Operadores sem suporte	`~ , !~ IS , IS NOT , IN , NOT IN`
Exemplos	Encontrar pendências que foram criadas durante minha sessão atual: `created > currentLogin()`

Sintaxe	currentUser()
Campos com suporte	Responsável, Relator, Votante, Seguidor, campos personalizados do tipo Usuário
Operadores com suporte	`= , !=`
Operadores sem suporte	`~ , !~ , > , >= , < , <= IS , IS NOT , IN , NOT IN , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED`
Exemplos	Encontrar pendências atribuídas a mim: `assignee = currentUser()` Encontrar pendências relatadas a mim, mas não atribuídas a mim: reporter = currentUser() AND (assignee != currentUser() OR assignee is EMPTY)

Sintaxe	earliestUnreleasedVersion(project)
Campos com suporte	VersãoAfetada, VersãoCorrigida, campos personalizados do tipo Versão
Operadores com suporte	`IN , NOT IN`
Operadores sem suporte	`= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED`
Exemplos	Encontrar pendências cuja versão corrigida seja a versão não liberada mais recente do projeto ABC: `fixVersion = earliestUnreleasedVersion(ABC)` Encontrar pendências relacionadas à versão não liberada mais recente do projeto ABC: `affectedVersion = earliestUnreleasedVersion(ABC) or fixVersion = earliestUnreleasedVersion(ABC)`

Sintaxe	endOfDay() endOfDay("inc") _{em que inc é um incremento opcional de (+/-)nn(y\|M\|w\|d\|h\|m). Se o qualificador de unidade de tempo for omitido, ele assumirá como padrão o período natural da função, por exemplo, endOfDay("+1") é o mesmo que endOfDay("+1d"). Se o sinal de adição/subtração (+/-) for omitido, o sinal de adição será presumido.}
Campos com suporte	Criado, Vencido, Resolvido, Atualizado, campos personalizados do tipo Data/Hora
Operadores com suporte	`= , != , > , >= , < , <=` *`WAS , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED`_{ Only in predicate}
Operadores sem suporte	`~ , !~ IS , IS NOT , IN , NOT IN`
Exemplos	Encontrar pendências que vencem ao final do dia de hoje: `due < endOfDay()` Encontrar pendências que vencem ao final do dia de amanhã: `due < endOfDay("+1")`

Sintaxe	endOfMonth() endOfMonth("inc") _{em que inc é um incremento opcional de (+/-)nn(y\|M\|w\|d\|h\|m). Se o qualificador de unidade de tempo for omitido, ele assumirá como padrão o período natural da função, por exemplo, endOfMonth("+1") é o mesmo que endOfMonth("+1M"). Se o sinal de adição/subtração (+/-) for omitido, o sinal de adição será presumido.}
Campos com suporte	Criado, Vencido, Resolvido, Atualizado, campos personalizados do tipo Data/Hora
Operadores com suporte	`= , != , > , >= , < , <=` *`WAS , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED`_{ Only in predicate}
Operadores sem suporte	`~ , !~ IS , IS NOT , IN , NOT IN`
Exemplos	Encontrar pendências que vencem ao final deste mês: `due < endOfMonth()` Encontrar pendências que vencem ao final do próximo mês: `due < endOfMonth("+1")` Encontrar pendências que vencem até o dia 15 do próximo mês: `due < endOfMonth("+15d")`

Sintaxe	endOfWeek() endOfWeek("inc") _{em que inc é um incremento opcional de (+/-)nn(y\|M\|w\|d\|h\|m). Se o qualificador de unidade de tempo for omitido, ele assumirá como padrão o período natural da função, por exemplo, endOfWeek("+1") é o mesmo que endOfWeek("+1w"). Se o sinal de adição/subtração (+/-) for omitido, o sinal de adição será presumido.}
Campos com suporte	Criado, Vencido, Resolvido, Atualizado, campos personalizados do tipo Data/Hora
Operadores com suporte	`= , != , > , >= , < , <=` *`WAS , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED`_{ Only in predicate}
Operadores sem suporte	`~ , !~ IS , IS NOT , IN , NOT IN`
Exemplos	Encontrar pendências que vencem ao final desta semana: `due < endOfWeek()` Encontrar pendências que vencem ao final da próxima semana: `due < endOfWeek("+1")`

Sintaxe	endOfYear() endOfYear("inc") _{em que inc é um incremento opcional de (+/-)nn(y\|M\|w\|d\|h\|m). Se o qualificador de unidade de tempo for omitido, ele assumirá como padrão o período natural da função, por exemplo, endOfYear("+1") é o mesmo que endOfYear("+1y"). Se o sinal de adição/subtração (+/-) for omitido, o sinal de adição será presumido.}
Campos com suporte	Criado, Vencido, Resolvido, Atualizado, campos personalizados do tipo Data/Hora
Operadores com suporte	`= , != , > , >= , < , <=` *`WAS , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED`_{ Only in predicate}
Operadores sem suporte	`~ , !~ IS , IS NOT , IN , NOT IN`
Exemplos	Encontrar pendências que vencem ao final deste ano: `due < endOfYear()` Encontrar pendências que vencem ao final de março do próximo ano: `due < endOfYear("+3M")`

Sintaxe	issueHistory()
Campos com suporte	Pendência
Operadores com suporte	`IN , NOT IN`
Operadores sem suporte	`= , != , ~ , !~ , > , >= , < , <=``IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED`
Exemplos	Encontrar pendências visualizadas recentemente e atribuídas a mim: `issue in issueHistory() AND assignee = currentUser()`

Sintaxe	issuesWithRemoteLinksByGlobalId()
Campos com suporte	Pendência
Operadores com suporte	`IN , NOT IN`
Operadores sem suporte	`= , != , ~ , !~ , > , >= , < , <=``IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED`
Exemplos	Encontrar pendências vinculadas a ligações remotas que têm o ID global "abc": `issue in issuesWithRemoteLinksByGlobalId(abc)` Encontrar pendências vinculadas a ligações remotas que têm o ID global "abc" ou "def": `issue in issuesWithRemoteLinksByGlobalId(abc, def)`

Sintaxe	lastLogin()
Campos com suporte	Criado. Atrasado, Resolvido, Atualizado, campos personalizados do tipo Data/hora
Operadores com suporte	`= , != , > , >= , < , <=` *`WAS , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED`_{ Only in predicate}
Operadores sem suporte	`~ , !~` `IS , IS NOT , IN , NOT IN`
Exemplos	Encontrar pendências que foram criadas durante minha última sessão: `created > lastLogin()`

Sintaxe	latestReleasedVersion(project)
Campos com suporte	VersãoAfetada, VersãoCorrigida, campos personalizados do tipo Versão
Operadores com suporte	`= , !=`
Operadores sem suporte	`~ , !~ , > , >= , < , <=` `IS , IS NOT , IN , NOT IN,` `WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED`
Exemplos	Encontrar pendências cuja versão corrigida seja a última versão liberada do projeto ABC: `fixVersion = latestReleasedVersion(ABC)` Encontrar pendências relacionadas à última versão liberada do projeto ABC: `affectedVersion = latestReleasedVersion(ABC) or fixVersion = latestReleasedVersion(ABC)`

Sintaxe	linkedIssues(issueKey) linkedIssues(issueKey,linkType)
Campos com suporte	Pendência
Operadores com suporte	`IN , NOT IN`
Operadores sem suporte	`= , != , ~ , !~ , > , >= , < , <=``IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED`
Exemplos	Encontrar pendências ligadas a uma pendência específica: `issue in linkedIssues(ABC-123)` Encontrar pendências ligadas a uma pendência específica por meio de um tipo específico de ligação: `issue in linkedIssues(ABC-123,"is duplicated by")`

Sintaxe	membersOf（グループ）
Campos com suporte	Responsável, Relator, Votante, Seguidor, campos personalizados do tipo Usuário
Operadores com suporte	`IN , NOT IN`
Operadores sem suporte	`= , != , ~ , !~ , > , >= , < , <=``IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED`
Exemplos	Encontrar pendências em que o Responsável seja um membro do grupo "jira-administrators": `assignee in membersOf("jira-administrators")` Pesquisar vários grupos e um usuário específico: `reporter in membersOf("jira-administators") or reporter in membersOf("jira-core-users") or reporter=jsmith` Pesquisar um grupo em particular, mas excluir um ou mais membros em particular: `assignee in membersOf(QA) and assignee not in ("John Smith","Jill Jones")` Excluir membros de um grupo em particular: `assignee not in membersOf(QA)`

Sintaxe	myApproval()
Campos com suporte	Campos personalizados do tipo Aprovação
Operadores com suporte	=
Operadores sem suporte	`~ , != , !~ ,` > , >= , < , <= `IS , IS NOT , IN , NOT IN ,` `WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED`
Exemplos	Encontrar todas as pendências que exijam ou exigiram a minha aprovação `approval = myApproval()`

Sintaxe	now()
Campos com suporte	Criado. Atrasado, Resolvido, Atualizado, campos personalizados do tipo Data/hora
Operadores com suporte	`= , != , > , >= , < , <=` *`WAS , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED`_{ Only in predicate}
Operadores sem suporte	`~ , !~` `IS , IS NOT , IN , NOT IN`
Exemplos	Encontrar pendências que estão vencidas: `duedate < now() and status not in (closed, resolved)`

Sintaxe	openSprints()
Campos com suporte	Sprint
Operadores com suporte	`IN , NOT IN`
Operadores sem suporte	`= , != , ~ , !~ , > , >= , < , <= IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED`
Exemplos	Encontrar todas as pendências atribuídas a um sprint que ainda não foi concluído: `sprint in openSprints()`

ページ

Viewport

Confluence

Pesquisa avançada – referência de funções

このページの内容

関連コンテンツ

お困りですか?

approved()

approver()

cascadeOption()

closedSprints()

componentsLeadByUser()

currentLogin()

currentUser()

earliestUnreleasedVersion()

endOfDay()

endOfMonth()

endOfWeek()

endOfYear()

issueHistory()

issuesWithRemoteLinksByGlobalId()

lastLogin()

latestReleasedVersion()

linkedIssues()

membersOf()

myApproval()

myPending()

now()

openSprints()

pending()

pendingBy()

projectsLeadByUser()

projectsWhereUserHasPermission()

projectsWhereUserHasRole()

releasedVersions()

standardIssueTypes()

startOfDay()

startOfMonth()

startOfWeek()

startOfYear()

subtaskIssueTypes()

unreleasedVersions()

votedIssues()

watchedIssues()

関連コンテンツ

Sintaxe	pendingBy(user1,user2)
Campos com suporte	Campos personalizados do tipo Aprovação
Operadores com suporte	=
Operadores sem suporte	`~ , != , !~ ,` > , >= , < , <= `IS , IS NOT , IN , NOT IN ,` `WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED`
Exemplos	Encontrar pendências que exijam a aprovação de John Smith: `approval = pending(jsmith)` Encontrar pendências que exijam a aprovação de John Smith ou Sarah Kahn:`approval = pending(jsmith,skhan)`

Sintaxe	projectsLeadByUser() projectsLeadByUser(username)
Campos com suporte	Projeto
Operadores com suporte	`IN , NOT IN`
Operadores sem suporte	`= , != , ~ , !~ , > , >= , < , <= IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED`
Exemplos	Encontrar pendências abertas nos projetos conduzidos por você: `project in projectsLeadByUser() AND status = Open` Encontrar pendências abertas nos projetos conduzidos por Bill: `project in projectsLeadByUser(bill) AND status = Open`

Sintaxe	projectsWhereUserHasPermission(permission) Para o parâmetro `permission`, é possível especificar uma das permissões descritas em .
Campos com suporte	Projeto
Operadores com suporte	`IN , NOT IN`
Operadores sem suporte	`= , != , ~ , !~ , > , >= , < , <= IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED`
Exemplos	Encontrar pendências abertas em projetos em que você tenha a permissão "Resolver pendências": `project in projectsWhereUserHasPermission("Resolve Issues") AND status = Open`

Sintaxe	projectsWhereUserHasRole(rolename)
Campos com suporte	Projeto
Operadores com suporte	`IN , NOT IN`
Operadores sem suporte	`= , != , ~ , !~ , > , >= , < , <= IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED`
Exemplos	Encontrar pendências abertas em projetos em que você tenha uma função do tipo "Desenvolvedores": `project in projectsWhereUserHasRole("Developers") AND status = Open`

Sintaxe	releasedVersions() releasedVersions(project)
Campos com suporte	VersãoAfetada, VersãoCorrigida, campos personalizados do tipo Versão
Operadores com suporte	`IN , NOT IN`
Operadores sem suporte	`= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED`
Exemplos	Encontrar pendências cuja versão corrigida é uma versão liberada do projeto ABC: `fixVersion in releasedVersions(ABC)` Encontrar pendências relacionadas às versões liberadas do projeto ABC: `(affectedVersion in releasedVersions(ABC)) or (fixVersion in releasedVersions(ABC))`

Sintaxe	startOfDay() startOfDay("inc") _{em que inc é um incremento opcional de (+/-)nn(y\|M\|w\|d\|h\|m). Se o qualificador de unidade de tempo for omitido, ele assumirá como padrão o período natural da função, por exemplo, startOfDay("+1") é o mesmo que startOfDay("+1d"). Se o sinal de adição/subtração (+/-) for omitido, o sinal de adição será presumido.}
Campos com suporte	Criado, Vencido, Resolvido, Atualizado, campos personalizados do tipo Data/Hora
Operadores com suporte	`= , != , > , >= , < , <=` *`WAS , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED`_{ Only in predicate}
Operadores sem suporte	`~ , !~ IS , IS NOT , IN , NOT IN`
Exemplos	Encontrar novas pendências criadas desde o início do dia de hoje: `created > startOfDay()` Encontrar novas pendências criadas desde o início do dia de ontem: `created > startOfDay("-1")` Encontrar novas pendências criadas nos últimos três dias: `created > startOfDay("-3d")`

Sintaxe	startOfMonth() startOfMonth("inc") _{em que inc é um incremento opcional de (+/-)nn(y\|M\|w\|d\|h\|m). Se o qualificador de unidade de tempo for omitido, ele assumirá como padrão o período natural da função, por exemplo, startOfMonth("+1") é o mesmo que startOfMonth("+1M"). Se o sinal de adição/subtração (+/-) for omitido, o sinal de adição será presumido.}
Campos com suporte	Criado, Vencido, Resolvido, Atualizado, campos personalizados do tipo Data/Hora
Operadores com suporte	`= , != , > , >= , < , <=` *`WAS , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED`_{ Only in predicate}
Operadores sem suporte	`~ , !~ IS , IS NOT , IN , NOT IN`
Exemplos	Encontrar novas pendências criadas desde o início deste mês: `created > startOfMonth()` Encontrar novas pendências criadas desde o início do mês passado: `created > startOfMonth("-1")` Encontrar novas pendências criadas desde o dia 15 deste mês: `created > startOfMonth("+14d")`

Sintaxe	startOfWeek() startOfWeek("inc") _{em que inc é um incremento opcional de (+/-)nn(y\|M\|w\|d\|h\|m). Se o qualificador de unidade de tempo for omitido, ele assumirá como padrão o período natural da função, por exemplo, startOfWeek("+1") é o mesmo que startOfWeek("+1w"). Se o sinal de adição/subtração (+/-) for omitido, o sinal de adição será presumido.}
Campos com suporte	Criado, Vencido, Resolvido, Atualizado, campos personalizados do tipo Data/Hora
Operadores com suporte	`= , != , > , >= , < , <=` *`WAS , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED`_{ Only in predicate}
Operadores sem suporte	`~ , !~ IS , IS NOT , IN , NOT IN`
Exemplos	Encontrar novas pendências desde o início desta semana: `created > startOfWeek()` Encontrar novas pendências desde o início da semana passada: `created > startOfWeek("-1")`

Sintaxe	startOfYear() startOfYear("inc") _{em que inc é um incremento opcional de (+/-)nn(y\|M\|w\|d\|h\|m). Se o qualificador de unidade de tempo for omitido, ele assumirá como padrão o período natural da função, por exemplo, endOfYear("+1") é o mesmo que endOfYear("+1y"). Se o sinal de adição/subtração (+/-) for omitido, o sinal de adição será presumido.}
Campos com suporte	Criado, Vencido, Resolvido, Atualizado, campos personalizados do tipo Data/Hora
Operadores com suporte	`= , != , > , >= , < , <=` *`WAS , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED`_{ Only in predicate}
Operadores sem suporte	`~ , !~ IS , IS NOT , IN , NOT IN`
Exemplos	Encontrar novas pendências desde o início deste ano: `created > startOfYear()` Encontrar novas pendências desde o início do ano passado: `created > startOfYear("-1")`

Sintaxe	unreleasedVersions() unreleasedVersions(project)
Campos com suporte	VersãoAfetada, VersãoCorrigida, campos personalizados do tipo Versão
Operadores com suporte	`IN , NOT IN`
Operadores sem suporte	`= , != , ~ , !~ , > , >= , < , <=``IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED`
Exemplos	Encontrar pendências cuja versão corrigida seja uma versão não liberada do projeto ABC: `fixVersion in unreleasedVersions(ABC)` Encontrar pendências relacionadas às versões não liberadas do projeto ABC: `affectedVersion in unreleasedVersions(ABC)`