Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


UI Text Box
sizemedium
typeinfo

This validator is used for blocking a transition depending on the result of a JQL query


Configuration

UI Expand
titleJQL

Enter a JQL query using the JQL mode of the expression editor. The current issue will be matched against the result set of the query.

UI Text Box
typetip

It is very common to use field codes inside the JQL query.



UI Expand
titleValidation

Define how the issue should be compared against the result set of the JQL query. You have the following options:

OptionDescription

Current issue belongs to the output of the query

The condition is passed, if the current issue is part of the result set of the JQL query.

Current issue doesn't belong to the output of the query

The condition is passed, if the current issue is not part of the result set of the JQL query.

Number of issues returned by the JQL query satisfies a logical expression

Define a logical expression in Logical mode which must return true or false.

UI Text Box
typetip

The number of issues returned by the query is stored in the Temporary number field 1. This is why this value is automatically added to your logical expression.


Example for a logical expression

JQL queryExpressionDescription


Code Block
project = %{issue.project.key} and type = Bug and resolution is empty



Code Block
{issue.temporaryNumber1} < 5


The validator will pass, if there are less than 5 unresolved Bugs in the current issue's project.



UI Expand
titleValidation options

Include Page
DECADIS:_snip_skip validation
DECADIS:_snip_skip validation


UI Expand
titleError message

Include Page
DECADIS:_snip_error_message_validator
DECADIS:_snip_error_message_validator


UI Expand
iconfalse
titleRun as

Include Page
DECADIS:_snip_runAs_Server_JQL
DECADIS:_snip_runAs_Server_JQL


UI Text Box
typetip

If you want to use this functionality in a condition instead, have a look at the following condition: Condition based on JQL query



Use cases and examples

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Parser functions, Label
cqllabel = "use-case-workflow" and space = currentSpace() and parent = currentContent(ancestor in ("32215802","32213779")


Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue


Page properties
hiddentrue



Status
Tech review

Status
colourGreen
titledone

Style guide

Status
colourYellow
titleReady for review

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged


Page properties
hiddentrue


Short descriptionValidate the current issue against the result of a JQL query.
Label

Status
colourRed
titlestaff pick