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 | ||||||
---|---|---|---|---|---|---|
|
Virtual fields
Excerpt Include | ||||||
---|---|---|---|---|---|---|
|
Tip |
---|
All comprehensive overview of all available virtual fields can be found here. |
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||
|
Info | ||
---|---|---|
| ||
Numeric field codes are only available for number fields, date/time fields and countable virtual fields. |
Functions and Operators
Please use one of the following links for detailed descriptions of functions and operators.
Boolean expressions - Logical and conditional operators
- Numbers, Dates and Times - Mathematical operators
- List 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.
Note |
---|
The available Selectors, Conditions and Actions depend on the selected Trigger. The syntax depends on the parser mode and the context of the rule. Therefore the following table explains the different parsing modes. |
Code Block | ||
---|---|---|
| ||
#basic parsing mode %{trigger.issue.description} Last comment: %{trigger.issue.comment.last} #advanced parsing mode %{trigger.issue.description} + "\nLast comment: \n" + %{trigger.issue.comment.last} |
Parsing modes
Excerpt Include | ||||||
---|---|---|---|---|---|---|
|
Div | |||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||
|