🚀 JWT 3.0 is out 🚀 

The app was completely overhauled, and so was the documentation: Jira Workflow Toolbox (Server/Data Center) Home

The page you are viewing is still valid for all app versions prior to 3.0.

This function has been renamed with the JWT 3.0 release. 

Find the new documentation at:

Logical condition

Logical validator

On this page


Purpose

These condition and validator are among the most versatile tools in JIRA Workflow Toolbox, thanks to a powerful parser for boolean expressions. They allow writing complex conditions based on the value of one or more field values, using simple logic syntax with comparison operators and logical connectives ANDOR and NOT.

Logical expressions can contain NumericDate-Time and Text-String terms. Field values of most types can be referenced, including Cascading Select and Multi-Cascading Select. You can also introduce literal values (numbers, text strings, Dates-Time, logical values (true, false) and null).

A comprehensive set of functions and macros is available to operate on Date-Time, Number and Text-String terms.

The only difference between Boolean condition with math, date-time or text-string terms and Boolean validator with math, date-time or text-string terms, is that condition hides the transition where is inserted when the logical expression returns "false", and validator shows a custom message. In most cases the use of the validator is preferable than condition, since you can inform the user about the reason why he cannot execute the transition.



Example: Validate that there are still 2 days left to due date

In this example we implement a validation for checking that "Due date" has value at least 2 days greater than current date and time.

Note that:

  • {00012} is code for numeric value of "Due date"
  • {00057} is code for numeric value of "Current date and time"

Boolean condition with math, date-time or text-string terms and Boolean validator with math, date-time or text-string terms make use of the plugin's Expression Parser.

Collection of Boolean Expressions Examples



Usage Examples