Introduction

The Automation Toolbox for Jira expression parser provides over 200 functions and operators to read, manipulate and filter data from Jira issues, users, groups, projects and more.

Among the long list of functionalities, the parser functions support setting and/or updating field values, issue filtering, date and time calculations, string manipulation and the execution of mathematical operations.

The expression parser has been in constant development since 2009 when it was first introduced in Jira Workflow Toolbox. Since that time, the expression parser has seen constant development, improvement, and extended functionality.

All full list of supported functions can be found here: Expression parser 201 - All functions


Main Features

The expression parser has two major core functionalities:

  • Extend accessibility to
    • issue
    • system
    • project
    • version
    • component
    • and user data through the use of Virtual Fields 
  • Provide a set of operators and functions to
    • read
    • filter
    • extract
    • manipulate
    • write
    • update related data

Field codes and usage

Virtual fields

All comprehensive overview of all available virtual fields can be found here. 



Field NameField code

Value

Summary
%{issue.summary}

Issue Summary as 

Description
%{issue.description}

Issue Description as 

Assignee
%{issue.assignee}

User name of the Assignee as 

Parent's assignee
%{parent.assignee}

User name of the parent's Assignee as  

Number of votes received
%{issue.votes}

 of votes received by the issue.



Numeric field codes are only available for number fields, date/time fields and countable virtual fields.


Parsing modes

The available Selectors, Conditions and Actions depend on the selected Trigger.

The syntax depends on the parsing mode and the context of the rule. Therefore the following table explains the different parsing modes.


Functions and operators

To use the full power of the expression parser you can use various functions and combine them with operators.

Functions

A comprehensive overview can be found here.

Operators

Different operators can be used in the expression parser. All operators are listed on these pages: