Get started

Use case library

JWT expression editor

JWT expression parser functions

JWT remote actions

Cloud migration hub

Additional product info

Versions Compared

Old Version 12

changes.mady.by.user Iheb Kharab

Saved on

compared with

New Version Current

changes.mady.by.user Ute Masermann

Saved on

Key

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

Content Layout Macro


Panel

On this page

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

UI Text Box
sizemedium
typeinfo

The JWT for Jira Cloud expression parser provides a huge set of functionalities to read and manipulate data from Jira issues, users, projects and more.

The main point of contact with the expression

editor saves you time by checking your expression before adding it to a post function, validator, or condition.

Image Removed

parser for the end user is the JWT expression editor.

Depending on what you are doing, you will be presented with different options and functionalities, but in the end it always comes down to writing an expression, which will be evaluated on runtime.

 

Image Added



UI Expand
titleSyntax check

Multimedia
nameparser-field-parser-error.mp4
width700

  1. As you type in your expression the syntax check button is synchronized with your expression and you can see if your expression is valid or not.
  2. Click on the syntax check button to review your expression.
OutputDescription

Image Added

Valid expression: The

Parser check

Info
iconfalse
Image Removed: Valid parsing i.e. The
parser expression entered is valid
for usage
.
Image Removed:

Image Added

Parsing error

i.e.

: The parser expression entered is not valid and you can do the following to fix the issue:

  • Check your
expression, your selected parsing mode, and try againTry an example by clicking on the example button
  • selected Parsing mode
  • Try an example configuration from the right hand side of the configuration interface
Parser



UI Expand
titleParsing mode selector
Info
iconfalse

The following parsing modes are available:

  • General - i.e. for adding a comment, usually this works with text fields
  • Logical - works with conditions
  • Jira expression -

Field injector

Info
iconfalse
Add a field to insert the desired field values automatically.

Example selector

Info
iconfalse

Insert the parser expression content directly from one of the built-in examples.

Test button

Excerpt Include
Parsing modes
Parsing modes
nopaneltrue

Read more about all available parsing modes.


UI Expand
titleField code injector


Excerpt

The field code injector is a dynamic select list that lists all available field codes. The fields, or their values, will be be replaced with actual values at runtime.

The available fields and their notation depend on the selected Parsing mode. Custom fields are shown if they are defined for a global context or if the "Jira Workflow Toolbox Cloud" user has browse permissions for the respective project. 

Learn more about field codes!

JWT expressionsJira expressions


Center

Multimedia
nameparser-field-jwt-expression.mp4
width300
height300



Center

Multimedia
nameparser-field-jira-expression.mp4
width300
height300




Image AddedA few basic examples

Field nameField code (JWT expression)

Field code (Jira expressions)

Summary

%{issue.summary}

issue.summary

Description

%{issue.description}

issue.description

Assignee

%{issue.assignee}

issue.assignee.accountId

Reporter

%{parent.reporter}

issue.parent.reporter.accountId



UI Expand
titleExample injector

Image Added

Need inspiration? Each parsing mode comes with built-in example expressions. If you choose an example from the dropdown menu, the expression will be automatically added to the editing area of the expression editor.


UI Expand
titleRun button

Image Added

By clicking on the run button, a test expression panel is displayed under your expression. To test your expression, do the following:

Info
iconfalse

By clicking on the play button, a test expression field is displayed under your expression.

  1. Select an issue as the current issue
  2. Click on Evaluate Run

Image Added

A The result preview of the expression is displayed.

Help button

Info
iconfalse

By clicking on the help button (question) the Expression parser handbook is displayed and you can go through the basics of an expression parser and the function library.

Input field

. For more detailed test scenarios, please have a look at: Test your expression.


UI Expand
titleHandbook

Multimedia
nameparser-field-parser-handbook.mp4
width700

Help is just a click away. If you click on the Help button, an in-line handbook will pop up, which provides information about almost any feature of JWT for Jira Cloud - from field codes, to Parsing modes and JWT expression parser functions. In case you have selected the Jira expression mode, the documentation will be opened in a new browser window.


UI Expand
titleExpression area
Info
iconfalse

This is where you can enter a plain text and optionally use Field codes and functions belonging to the selected parsing mode. 

Which options you will actually have depend on the selected Parsing mode.

Multimedia
nameparser-field-auto-complete.mp4
width700


UI Expand
titleAuto-complete

Tech tip: Auto-complete

The expression editor comes with a built-in auto-complete feature. 

Simply press <CTRL> + <space> and get a searchable list of JWT expression parser functions and available field codes.

Image Added

UI Text Box
typetip

Highlighting makes it easy to recognize essential parts of the expression.



Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue