This document briefs you on how to access the details of issue and transition objects in Jira expressions, such as those available through the issue and transition variables.
Structure of an issue
object
An issue object consists of the issue key and a collection of fields. To know the structure of the issue object (such as those available through the issue
and linkedIssue
variables) returned in Jira expressions:
- Go to the Jira expressions editor
Test the following code against an issue
issue
The result shows the issue structure as a JSON.
Not all data types are supported in Jira expressions. See here to find all the Data types supported in Jira expressions along with their properties and methods.
Access the fields of an issue
To write a Jira expression that accesses the fields of an issue, the easiest way is to use the "Issue Fields" tab in the Jira expressions editor help. Followed by that you can use the "Data Types" tab in the editor to see the properties and methods of the returned value. For example, to access the "Assignee" field of an issue using the Jira expressions:
- Click on "Issue Fields" tab.
- Select the "Assignee" field from the
Select a field;
the help shows you how to access the field, its sub-fields and test the field value. - Click on one of the expressions to insert it into the editor; the help shows you the supported properties and methods of the returned Data Type.
Structure of the transition
variable
The transition
variable describes the current workflow transition. It contains information about the transition that is currently happening and allows to inspect the source and target status. The transition of an issue consists of the following fields:
id
: The transition ID (Number).name
: The transition name (String).from
: The current status of the issue (IssueStatus).to
: The target status of the transition (IssueStatus)hasScreen
: true if there is a screen configured for this transition, false otherwise (Boolean)
Use the "Global Variables" tab of the Jira expressions editor to access the current transition information.