You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »


Status
Tech review

TODO

Style guide

TODO

TODO

READY FOR REVIEW

DONE

FLAGGED

On this page

Overview

Boolean expressions, or logical expressions, will always return or accept one of two distinct BOOLEANvalues: true or false

ExpressionBoolean value
3 < 5true
3 > 5false
"It is Monday"true if it is actually Monday, false otherwise
"It is Sunday"true if it is actually Sunday, false otherwise

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

ExpressionBoolean value
"It is Monday" AND "It is Sunday"false
"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:

  • Basic elements
  • Field codes

  • Operators
  • Expression parser functions

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


Examples of simple logical expressions

Error rendering macro 'excerpt-include'

No link could be created for 'Examples of logical expressions'.

A full list of examples can be found here.



Basic elementsNEEDS TECH REVIEW

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

ElementDescriptionExample

Output value

NEEDS TECH REVIEW

BOOLEAN

A boolean value of true or false
true, TRUE, false, FALSE

BOOLEAN

TEXT

A quoted text or a text field code.
"This is a text"

STRING

TEXT 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 []

NUMBER

A numeric value or a numeric field code.
3

NUMBER

NUMBER 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 []

NULL

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

NULL

TIME PERIOD

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

NUMBER

WEEKDAY

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

NUMBER

MONTH 

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

NUMBER




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?