Page History
Introduction
The Automation Toolbox for Jira Expression Parser expression parser provides over 200 functions functions and operators to read, manipulate and filter data from Jira issues, users, groups, projects and more.
Among othersthe long list of functionalities, the parser functions support setting and/or updating field values, issue filtering, date and time calculations, string manipulation and execute mathematical operations. An extensive set of operators provide the ability to write conditional functions, do validations with corresponding error texts, mathematical operations, and comparison expressionsthe 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:
- extended accessibility to
- issue
- system
- project
- version
- component
- and user data through the use of Virtual Fields
- an extensive set of operators and functions to
- read
- filter
- extract
- manipulate
- write
- update related data
Virtual Fields / Field Codes
...
Field codes and usage
Excerpt Include | ||||
---|---|---|---|---|
|
Automation Toolbox for Jira provides a set of special fields called virtual fields, making almost all properties of issues, projects and users accessible to every feature in the app.
Virtual fields may be read and written by Automation Toolbox for Jira in the same way ordinary custom fields are.
Virtual fields and their associated field codes, were created to
- provide data accessibility beyond the scope of normal Jira workflow processing
...
- insure data integrity throughout their use.
In Automation Toolbox for Jira In ATJ you can use Virtual Fields virtual fields by searching for and picking their associated Field Codes field codes in the dropdowns dropdown menus provided wherever a parser expression can be inserted.
Please see the pages covering Field Codes and Usage and Virtual Fields for more detailed descriptions.
Below are a few examples of Field Codes. The full list of field codes is available here.
Sample string field codes (always preceded by a % sign)
...
Multimedia | ||||
---|---|---|---|---|
|
All comprehensive overview of all available virtual fields can be found here.
Expand | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||
|
...
|
...
|
...
|
Sample number field codes
- {issue.dueDate}
- {issue.createdDate}
- {issue.votes}
- {parent.dueDate}
...
|
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.
...