Get started

Use case library

JWT expression editor

JWT expression parser functions

JWT workflow functions

JWT remote actions

JWT automation rules

JWT calculated fields

JWT calendars

JWT properties

JWT JQL functions

Cloud migration hub

Additional product info

Versions Compared

Old Version 7

changes.mady.by.user Iheb Kharab

Saved on

compared with

New Version Current

changes.mady.by.user Jona Ittermann

Saved on

Key

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


Page properties
hiddentrue
StatusTech review

Status
titletodo

Style guide

Status
colourYellow
titleReady for review

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

Panel

On this page

Table of Contents
exclude(On this page).*
stylecircle
typeflat
separatorpipe

UI Text Box
sizemedium
typeinfo

This condition is used for hiding or blocking a  a transition depending on the result of a JQL query. 


Image AddedConfiguration

ui-text-boxexpand
typetitletipJQL

Enter a JQL query using the JQL mode of the expression editor. The current issue will be matched against the result set of the queryField codes in the format %{nnnnn} can be inserted in the JQL query. It will be replaced by the corresponding field values at JQL execution time. Most of the times you will require to introduce one or more field codes in your JQL query since usually some kind of reference to the current issue (%{00015}), current user (%{00020}), current date (%{00057}), assignee (%{00003}) wants to be made.

UI Text Box
type
note

In this documentation and the condition configuration you will notice the symbol ( * ) next to some parameters, it means that this field is mandatory and shall not be left empty. Fields without the symbol are optional.

Basic configuration*

Below you will find a detailed description of each parameter of the basic configuration for this condition.

JQL*

Info
iconfalse

Enter plain text and optionally use field codes, e.g %{issue.summary}, to insert field values.

UI Text Box
typetip

Test your expression by clicking the play button on the top right of the expression box.

tip

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



UI Expand
titleCondition

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

OptionDescription

Condition*

Info
iconfalse
Select the condition from one of the following options:

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

Upon choosing the third option, the following has to be done:

Expression*

Temporary number 1 - {issue.temporaryNumber1} - returns the number of issues returned by the JQL query. The expression must return a true

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

UI Text Box
typetip
Test your expression by clicking the play button on the top right of the expression box

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 condition will pass, if there are less than 5 unresolved Bugs in the current issue's project.



Choose which user* will be able to execute this post function. By default, it is set to the Current user.
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 validator instead, have a look at the following validator: Validation based on JQL query



Image AddedUse cases and examples

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

Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue


Page properties
hiddentrue



Status
Tech review

Status
colourGreen
titledone

Style guide

Status
colourGreen
titledone

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


Page properties
hiddentrue


Short descriptionEvaluate issues against the output of a JQL query.
Label

Status
colourRed
titlestaff pick