Page History

Versions Compared

Old Version 17

changes.mady.by.user Christian Czaia

Saved on Aug 05, 2020

compared with

New Version Current

changes.mady.by.user Christian Czaia

Saved on Sept 28, 2021

Key

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

Page properties

hidden	true

Tech review

Status

colour	Green
title	done

Style guide

Status

colour	Green
title	done

Page status

Status

colour	Green
title	done

Status

title	todo

Status

colour	Yellow
title	Ready for review

Status

colour	Green
title	done

Status

colour	Red
title	flagged

UI Text Box

size	medium
type	info

The logical parsing mode is mainly used in any conditional execution parameter of workflow post functions or genere.

It comes with defined syntax that allows you to write JWT expression parser functions to read and manipulate data from any issue in Jira.

The advanced text mode supports field codes as well as free text, written in quotation marks "".

Boolean expressions, or logical expressions, will always return or accept Boolean value

used to construct logical expressions.

To construct these logical expressions, you can combine different elements, such as field codes, JWT expression parser functions and operators. The result must always return one of two distinct

Status

subtle	true
title	boolean

values: true or false.

Expand

title	Simple examples

Expression

The main JWT features where you will be using the logical parsing mode are:

Image Added

Image AddedExample expressions

Parser expression Description

Code Block

linenumbers	true

3 < 5

This example returns:

true

Code Block

linenumbers	true

3 > 5

false

Code Block

linenumbers	true

"It is Monday"

true if it is actually Monday, false otherwise

This example returns:

false

Expressions can be combined or linked using operators to construct complex logical comparisons.

Expression

Parser expression

Boolean value

Description

Code Block

linenumbers	true

"It

Monday"

5 AND

"It

Sunday"

false

At least if you are looking at a single time zone.

This example returns:

true

Code Block

linenumbers	true

"It is Monday" OR "It is Sunday"

true if it is either Monday or Sunday, false otherwise

Logical expressions, which can currently be used in the logical parsing mode are built using the following components:

To ease into the logical expressions, we have prepared some examples on how you can construct more or less complex logical expressions.

%{issue.assignee} = %{issue.reporter}

This example returns:

true if the current assignee has also reported the issue, false otherwise

Excerpt

UI Expand

title

Examples of simple logical expressions

Excerpt Include

Examples of logical expressions

nopanel

true

A full list of examples can be found here.

Image RemovedBasic elements

The table below lists all simple elements or operands that can be used in a logical expression.

Status

colour	Red
title	NEEDS TECH REVIEW

UI Expand

title	All elements that can be used in a logical expression

ElementDescriptionExample

Output value

Status

colour	Red
title	NEEDS TECH REVIEW

Status

subtle	true
title	boolean

A boolean value of true or false

true, TRUE, false, FALSE

Status

colour	Green
title	boolean

StatussubtletruetitletextA quoted text or a text field code.

"This is a text"

Status

colour	Yellow
title	string

StatussubtletruetitleText list

Text lists are enclosed by square brackets. Not only literals can be used as elements, but also field codes.

["first element", "second element", %{issue.summary}]

STRING []

Status

subtle	true
title	number

A numeric value or a numeric field code.

Status

colour	Blue
title	number

Statussubtletruetitlenumber list

Number lists are enclosed by square brackets. Not only literals can be used as elements, but also field codes.

[5.1326, 3, 100000001, {issue.labels.length}]

NUMBER []

Status

subtle	true
title	null

A specific value for comparisons if a field or another value is not set or equals null.

null

Status

subtle	true
title	null

Status

subtle	true
title	time period

A specific time period: from SECOND to YEAR (in capital letters) in milliseconds

MINUTE, DAY, WEEK, MONTH

Status

colour	Blue
title	number

Status

subtle	true
title	weekday

The weekdays in capital letters (MONDAY-SUNDAY) - internally represented by a number

TUESDAY

Status

colour	Blue
title	number

Status

subtle	true
title	month

The months in capital letters (JANUARY-DECEMBER) - internally represented by a number

JUNE

Status

colour	Blue
title	number

Excerpt IncludeOperatorsOperatorsnopaneltrue

Additional examples

Parser expression

Description

Code Block

linenumbers	true

false

Simply returns false. You can use this expression for "switching off" a specific post function.

Code Block

linenumbers	true

{parent.votes} > 5

A numerical comparison which returns true if the parent issue has more than 5 votes.

Code Block

linenumbers	true

%{issue.assignee} = %{issue.project.lead} and %{issue.issueType} = "Bug"

Code Block

linenumbers	true

(%{issue.assignee} = %{issue.project.lead}) and (%{issue.issueType} = "Bug")

A logical conjunction which takes two comparisons as operands.

It returns true when the assignee of the issue is the project lead and if it's a Bug.

The second expression has the same meaning but due to use of brackets may be more readable.

Code Block

linenumbers	true

%{issue.assignee} = null

Returns true if the issue does not have an assignee. This expression uses the null value as an operator.

Code Block

linenumbers	true

%{issue.priority} IN ["Blocker", "Critical"]

Code Block

linenumbers	true

%{issue.priority} = "Blocker" OR %{issue.priority} = "Critical"

Returns true if the Priority has the value "Blocker" or "Critical". The first expressions uses a list whereas the second one uses single comparisons connected via the logical operator OR.

Code Block

linenumbers	true

%{issue.issueType} = "Bug" IMPLIES %{issue.versions} != null

Returns true if Affects version/s is set whenever the issue type equals "Bug".

Code Block

linenumbers	true

%{issue.priority} IN ["Blocker", "Critical", "Major"] IMPLIES (%{issue.assignee} != null AND %{issue.duedate} != null)

Returns true if Priority is "Blocker", "Critical" or "Major", the issue is assigned and Due date is set.

Code Block

linenumbers	true

%{issue.labels} ~ ["Blocker", "Critical", "Major"]

Returns true if Labels (which is a field holding a

Status


subtle	true
title	text list

) contains "Blocker", "Critical" or "Major".

Excerpt Include

	Operators
	Operators
nopanel	true

Excerpt Include

	DECADIS:Contact support
	DECADIS:Contact support
nopanel	true

Page properties

hidden	true

Icon	Image Added

Jona Ittermann , Thorsten Letschert : Kleiner Mini-Screencast? Construct a logical expression (e.g. issue.priority = "High" OR xyz) AND count(subtasks()) >= 3 mit kurzer Einblendung der jeweiligen Elemente?

true

Page properties

hidden

Status

Tech review

Status

title	todo

Style guide

Status

title	todo

Status

title	todo

Status

colour	Yellow
title	Ready for review

Status

colour	Green
title	done

StatuscolourRedtitleflagged

Short description

Compose logical expressions using field codes and JWT expression parser functions.

Supported elements

Field codes

JWT expression parser functions

Output

Status


subtle	true
title	text

Page properties

hidden	true

boolean

Content

Space Tools

Versions Compared

Old Version 17

New Version Current

Key

Image AddedExample expressions

Image RemovedBasic elements