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

Please use one of the following links for detailed descriptions of functions and operators.

Functions

  • Issue data functions
  • User, Group & Role functions
  • Version functions
  • Field history functions
  • Selectable fields functions
  • Mathematical functions
  • Date-Time functions
  • String functions
  • String list functions
  • Issue list functions
  • Number list functions
  • Cast functions

You can find all functions here.