Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

Tip
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

Excerpt Include
Field Codes and Usage
Field Codes and Usage
nopaneltrue

Virtual fields

Excerpt Include
Virtual fields
Virtual fields
nopaneltrue

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


Expand
titleClick here to expand for a few examples...


Field NameField code

Value

Summary
%{issue.summary}

Issue Summary as 

Status
colourYellow
titleString

Description
%{issue.description}

Issue Description as 

Status
colourYellow
titleString

Assignee
%{issue.assignee}

User name of the Assignee as 

Status
colourYellow
titleString

Parent's assignee
%{parent.assignee}

User name of the parent's Assignee as 

Status
colourYellow
titleString
 

Number of votes received
%{issue.votes}

Status
colourBlue
titlenumber
 of votes received by the issue.



Info
titleRemember

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


Parsing modes

Note

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.

Excerpt Include
Parsing modes
Parsing modes
nopaneltrue


Functions and operators

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

Functions

Children Display
pageExpression parser 201 - All 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:


Div
styleline-height: 150%;
idtocContainer
classtocContainer


Panel
borderColor#333f48
bgColor#FFFFFF
titleColor#eeeeee
borderWidth1
titleBGColor#333f48
borderStylesolid
titleOn this page

Table of Contents
maxLevel2
indent20px
classp