Page History

Versions Compared

Old Version 15

changes.mady.by.user Christian Czaia

Saved on Nov 16, 2020

compared with

New Version Current

changes.mady.by.user Nicolas Werle

Saved on May 14, 2024

Key

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

Content Layout Macro

Image Removed

UI Text Box

size	medium
type	info

The JWT expression parser is the brain of JWT. It provides JWT provides a huge set of functionalities to read and manipulate and manipulate data from Jira issues, users, projects, and more.

The main point of contact with the expression parser for the end user is the "expressions" that are being evaluated by the expression parser are composed and tested in 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

title	What is an expression?

Expressions are a fundamental concept within Jira Workflow Toolbox: every input into the JWT expression editor is considered an expression and will be interpreted by the JWT expression parser against the selected parsing mode. They are used in workflow functions, automation rules, and calculated fields.

Expressions range from simple text, e.g. Hello world!, over mathematical calculation, e.g. 3 + 4, to the extensive usage of expression parser functions, and beyond.

Image Removed

UI Button

color	turquoise
newWindow	true
icon	info
title	Read more
url	https://apps.decadis.net/x/5wCdAQ

UI Expand

title	Syntax check

Multimedia

name	jwt-syntax-check

.mp4
width	800

Jona Ittermann Bitte einen neuen Screencast

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.
Click on the syntax check button to review your expression.

Output

Description

Valid expression: The parser expression entered is valid.

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

Check your selected Parsing mode
Try an example configuration from the right hand side of the configuration interface

UI Expand

title	Parsing mode selector

Excerpt Include

	Parsing modes
	Parsing modes
nopanel	true

Read more about all available parsing modes.

UI Expand

title	Field 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.

JWT expressions

Jira expressions

Center

Multimedia

name	parser-field-jwt-expression.mp4
width	300
height	300

Center

Multimedia

name	parser-field-jira-expression.mp4
width	300
height	300

Image RemovedA few basic examplesField 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

Depending on the parsing mode, numeric fields (including dates) can be either inserted as text or a number.

Image Added

UI Expand

title	Example injector

Image RemovedImage 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

title	Run button

Image Removed

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

Select an issue as the current issue
Click on Run

Image Removed

The result of the expression is displayed. For more detailed test scenarios, please have a look at: Test your expression.

Excerpt Include

	Test your expression
	Test your expression
nopanel	true

700

UI Expand

title	Handbook

Multimedia

name

parser-field-parser-handbook.mp4

width

Help is just a one 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 toParsing modes and , and JWT expression parser functions. In case you have selected theJira expression mode, the documentation will be opened in a new browser window.

Multimedia

name	jwt-parser-handbook.mp4
width	800

UI Expand

title	Expression area

This is where you can enter the magic happens. Enter a plain text and optionally use , Field codes and functions belonging to the selected parsing mode. , and JWT expression parser functions.

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

Multimedia

name	jwt-expression-area.mp4
width	800

A powerful feature of the editing area is auto-completion.

Pressing <CTRL> + <space> will show

UI Text Box

type	tip

Head over to the Use case library to see what's possible with the power of the JWT expression editor.

UI Expand

title	Auto-complete

Tech tip: Auto-complete

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

Simply press <CTRL> + <space> to get a searchable list of JWT expression parser functions

and

and available field codes.

Image Added

In case you have selected the Jira expression mode, only the list of field codes will be shown.700

UI Text Box

type	tip

Multimedia

name

parser-field-auto-complete.mp4

width

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

Excerpt Include

	DECADIS:Contact support
	DECADIS:Contact support
nopanel	true

Page properties

hidden	true

Tech review

Status

colour	Green
title	done

Style guide

Status

colour	Green
title	done

Page status

Status

colour	Green
title	done

Status

title	todo

Status

colour	Yellow
title	Ready for review

Status

colour	Green
title	done

Status

colour	Red
title	flagged

Content

Space Tools

Page History

Versions Compared

Old Version 15

New Version Current

Key