Page History
Panel | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
On this page
|
UI Text Box | ||||
---|---|---|---|---|
| ||||
One of the most important features of JWT is the easy accessibility to Jira data stored in system fields, custom fields and a significant number of other virtual fields that are made available by the JWT implementation. You can access, validate, do mathematical calculations and manipulate the values found in these fields through the use of field codes . A field code is a unique identifier (key) that can be used in any JWT expression editor. At the same time a field code is a safety feature that makes your expressions immune to custom field renaming. |
Overview
Field codes will be automatically added to your expression when you insert them anywhere using the expression parser field code injector.
Field codes for Jira standard or system fields will display the attribute in a legible form like %{issue.summary}
.
All custom fields will be notated like %{issue.cfnnnnn}
where nnnnn
contains the Jira custom field ID.
Once an expression has been saved, the real name will be displayed in the configuration element.
UI Text Box | ||
---|---|---|
| ||
The purpose of using the |
Jona Ittermann SCREENCAST, but a better one
Potentially with text / like the getting started video?
- This is a text
- This is a number
- This is a value from the parent....
Multimedia | ||||||
---|---|---|---|---|---|---|
|
Field code notation
Depending on the context in which they are being used, field codes will contain a prefix following this notation : {origin.field}
What is a context?
A context basically determines where JWT will pull data from. Available contexts (or origins
) in JWT are:
Context | Example | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
issue |
| The field value will be retrieved from the issue that currently being processed by a workflow function or automation rule.
| ||||||||||
parent |
| The field value will be retrieved from the parent of the issue that is processed by a workflow post function or an automation rule.
| ||||||||||
seed |
| The field value will be retrieved from the element currently being processed by a workflow function or automation rule that is capable of analyzing multiple elements (e.g. Create issue post function or the Create issue action). Elements can be:
depending in your configuration. Read more about Seeds. | ||||||||||
function |
| The field value will be retrieved from issue(s) returned by some JWT expression parser functions. Mostly these are functions that return an issue list (e.g. subtasks()).
| ||||||||||
created.parent |
| The field value will be retrieved from the new parent issue of a sub-tasks being created in a workflow post function.
|
UI Expand | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
An issue is tied to a workflow. This is why most field codes in JWT workflow functions have their issue context. Automation rules are not tied to individual issues. This is why sometimes it is necessary to define their context separately. These additional contexts are available for automation rules:
The prefix is a referential part of the field code and will be inserted into the expression whenever you select a field from a dropdown list (as shown below).
Find a full list of automation-only field code here: Field codes (automation-only) |
UI Expand | |||||
---|---|---|---|---|---|
| |||||
Field codes must always be enclosed by curly brackets {} but if they are used for text-strings, the brackets must be preceded by a percent sign % .
|
Available field codes
Check out the following pages to familiarize yourself with the different types of field codes.
UI Children | ||
---|---|---|
|
Search | ||||
---|---|---|---|---|
|
Page properties report | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Page properties | ||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||
|
Excerpt Include | ||||||
---|---|---|---|---|---|---|
|