Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Page properties
hiddentrue
Tech review

Status
colourGreen
titledone

Style guide

Status
colourGreen
titledone

Page status

Status
colourGreen
titledone

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

UI Text Box
sizemedium
typeinfo

The logical parsing mode is used to construct logical expressions that will always return or accept .

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
subtletrue
titleboolean
values: true or false

It comes with defined syntax that allows you to write JWT expression parser functions.

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

Image Added

Image ModifiedExample expressions

Parser expressionDescription
Code Block
linenumberstrue
3 < 5

This example returns:

true

Code Block
linenumberstrue
3 > 5

This example returns:

false

Code Blocklinenumberstrue

"It is Monday"

This example returns:

true if it is actually Monday, false otherwise


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


Parser expressionDescription
Code Block
linenumberstrue
"It
3 
is
< 
Monday"
5 AND 
"It
7 
is
> 
Sunday"
5

This example returns:

false

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

true

Code Block
linenumberstrue
"It is Monday" OR "It is Sunday"
%{issue.assignee} = %{issue.reporter}

This example returns:

true if

it is either Monday or Sunday

the current assignee has also reported the issuefalse otherwise

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

Image RemovedBasic elements

The table below lists all simple elements or operands that can be used in a logical expression. number
Excerpt
UI Expand
title
All elements that can be used in a logical expression
Additional examples
Parser expression
Element
Description
Example
Code Block
Output
linenumbers
status
true
subtletrue
titleboolean
A boolean value of true or false
true, TRUE, false, FALSE

Status
subtletrue
titleboolean

Status
subtletrue
titletext
A quoted text or a text field code.
"This is a text"

Status
subtletrue
titleText

Status
subtletrue
titleText 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}]

Status
subtletrue
titleText list

Status
subtletrue
titlenumber

A numeric value or a numeric field code.
3

Status
colourBlue
titlenumber

Status
subtletrue
titlenumber 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
subtletrue
titlenull

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

Status
subtletrue
titlenull

Status
subtletrue
titletime period

A specific time period: from SECOND to YEAR (in capital letters) in milliseconds
MINUTE, DAY, WEEK, MONTH

Status
colourBlue
titlenumber

Status
subtletrue
titleweekday

The weekdays in capital letters (MONDAY-SUNDAY) - internally  represented by a number 
TUESDAY
Status
colourBlue
title
false
Simply returns false. You can use this expression for "switching off" a specific post function.
Code Block
linenumberstrue
{parent.votes} > 5

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

Code Block
linenumberstrue
%{issue.assignee} = %{issue.project.lead} and %{issue.issueType} = "Bug"
Code Block
linenumberstrue
(%{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
linenumberstrue
%{issue.assignee} = null

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

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

Code Block
linenumberstrue
%{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
linenumberstrue
%{issue.issueType} = "Bug" IMPLIES %{issue.versions} != null

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

Code Block
linenumberstrue
%{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
linenumberstrue
%{issue.labels} ~ ["Blocker", "Critical", "Major"]

Returns true if Labels (which is a field holding a

Status
subtletrue
title

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

Status
colourBlue
titlenumber

Excerpt IncludeOperatorsOperatorsnopaneltrue

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

Excerpt Include
Operators
Operators
nopaneltrue


Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue

Page properties
hiddentrue
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
hiddenStatus
Tech review

Status
titletodo

Style guide

Status
titletodo

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
StatuscolourRedtitleflagged

Short descriptionCompose logical expressions using field codes and JWT expression parser functions.
Supported elements
Output

Status
subtletrue
titletext

Page properties
hiddentrue

boolean