...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
Excerpt |
---|
A variable looks up a value from the template context. This documents details on the variables available in JMWE and how to create custom variables. |
If you want to insert the value of a variable in your template, you can use the following syntax: {{ myVar }}
.
...
This looks up for the myVar
variable from the context and displays it. Variable names can have dots in them which look up properties, just like in javascript.
On this page:
Table of Contents |
---|
Variables available in JMWE
JMWE makes the issue, transition, linkedIssue, parentIssue, now
and currentUser
variables available to templates. You can access their properties using "." or "[ ]". For example, you can access the current issue key using {{issue.key}}
.
issue variable
The issue
variable is used to insert data of the issue being transitioned. You can access the issue data by looking up at its properties.
For example:
{{issue.fields.labels}}
returns an array of label values, e.g. [ "1","2" ]
{{issue.fields.reporter.accountId}}
returns the accountId
of the reporter, e.g. carter
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
transition variable
The transition
variable is used to insert information of the transition being executed.
For example:
{{transition.transitionName}}
returns the name of the transition, e.g. Start Progress
{{transition.to_status}}
returns the status of the transition, e.g. In Progress
Expand | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
|
newIssueKey
The
...
newIssueKey
variable holds the key of the newly created issue. This is applicable only
...
in the Create/Clone issue post-function.
For example:
{{newIssueKey}}
returns the key of the newly created issue.
Issue {{newIssueKey}} has been created.
linkedIssue variable
The linkedIssue
variable, which is only available from post-functions that work on linked issues, is used to insert data of the linked issue being processed by the post-function.
For example:
{{linkedIssue.fields.description}}
returns the description of the linked issue being processed.
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
parentIssue variable
The parentIssue
variable, which is only available from post-functions that work on the parent issue, is used to insert data of the parent issue being processed by the post-function.
For example:
{{parentIssue.fields.priority.name}}
returns the priority of the parent issue being processed.
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
currentUser variable
The currentUser
variable is used to insert information about the current user, i.e. the user triggering the transition. Only one property of the current user is available: accountId. To set a user-type field (such as Assignee, Reporter, or any custom User-picker field), use the accountId property.
For example:
{{currentUser.accountId}}
returns the accountId of the user triggering the transition, e.g. accountId:5ca5b1469a000c1180956957.
Use this to set a user-type field (such as Assignee, Reporter, or any custom User-picker field)
now variable
The now
variable is used to insert the current date and time. This is useful to save a transition's execution date/time in a custom field.
For example:
{{now}}
returns the current date and time, e.g. 2016-09-30T13:57:23.608Z
nowObj
The nowObj variable represents
...
...
Variables used in Nunjucks templates#now as a Moment.js object.
{{ nowObj | date }}
returns current date as a date Object
{{ issue.fields.duedate | date('clone') <= nowObj }}
returns true
if the ticket is overdue.
User-defined variables
In addition to the above variables, you can also create your own variables within the template using the set Nunjucks tag.
For example:
{% set x = "High" %}
sets the value of the variable x to High. You can also set the variable to an object. For example: {% set assignee = issue.fields.assignee %}