Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Page properties



Status
Tech review

Status
titletodo

Style guide

Status
titletodo



Status
titletodo

Status
colourGreen
titledone

Status
colourRed
titleflagged


Panel

On this page

Table of Contents
exclude(On this page).*
stylecircle
typeflat
separatorpipe




Overview

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 

UI Text Box
typeinfo

A field code is a unique identifier (key) that can be used in any parser expression. At the same time a field code is a safety feature that makes your expressions immune to custom field renaming

Field codes are available for:

  • readable fields
  • writable fields
  • virtual fields
  • issue, project and user properties



 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:

ContextDescriptionExample
issue

The issue that currently being processed by a workflow function or automation rule.

UI Text Box
typetip

The most commonly used context in JWT.


%{issue.description

The description of the current issue.

parent

The parent of the issue that is processed by a workflow post function or an automation rule.

(warning) Only valid for sub-tasks.

%{parent.summary}

The summary of the parent issue.

seed.issue

Seed issues of the issue that is processed by a workflow post function or an automation rule. More info...

%{seed.issue.summary}

The summary of a seed issue.

issue.project

systemSome data does not have an issue context (e.g. the currently logged in user or the system date and time).

%{system.currentUser}

The current user (e.g. executing the post function).





UI Expand
titleAdditional contexts for automation rules

These additional contexts are available for automation rules:

ContextDescriptionExample
triggerThe issue, user, version, component or project event that triggers the execution of the rule.

%{trigger.issue.description}

The description of the issue triggering the automation rule.

selectorThe issue currently being processed by a selector (e.g. an issue returned by a JQL query).

%{selector.issue.cf10021}

The value of the custom field with the ID 10021 from the issue currently being processed by a selector.


UI Text Box
typeinfo

The additional contexts can be used in combination with the standard contexts (e.g. parent, seed).

Example: %{trigger.parent.summary}



These additional contexts are available for automation rules:

ContextDescriptionExample
triggerThe issue, user, version, component or project event that triggers the execution of the rule.

%{trigger.issue.description}

The description of the issue triggering the automation rule.

selectorThe issue currently being processed by a selector (e.g. an issue returned by a JQL query).

%{selector.issue.cf10021}

The value of the custom field with the ID 10021 from the issue currently being processed by a selector.


UI Text Box
typeinfo

The additional contexts can be used in combination with the standard contexts (e.g. parent, seed).

Example: %{trigger.parent.summary}