Versions Compared

Key

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

Content Layout Macro

UI Text Box
sizemedium
typeinfo

The JWT expression parser is the brain of JWT.

It provides JWT provides a huge set of functionalities to read and manipulate data from Jira issues, users, projects, and more.

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.






UI Expand
titleWhat 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 functionsautomation 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.

UI Button
colorturquoise
newWindowtrue
iconinfo
titleRead more
urlhttps://apps.decadis.net/x/5wCdAQ


UI Expand
titleSyntax check

Multimedia
namejwt-syntax-check.mp4
width800

  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

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
titleParsing mode selector

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. Depending on the parsing mode, numeric fields (including dates) can be either inserted as text or a number.



UI Expand
titleExample injector

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

Excerpt Include
Test your expression
Test your expression
nopaneltrue



UI Expand
titleHandbook

Help is just 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, from field codes, to Parsing modes, and JWT expression parser functions.

Multimedia
namejwt-parser-handbook.mp4
width800


UI Expand
titleExpression area

This is where the magic happens. Enter a plain text, Field codes, and JWT expression parser functions.

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

Multimedia
namejwt-expression-area.mp4
width800


UI Text Box
typetip

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



UI Expand
titleAuto-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 available field codes.

UI Text Box
typetip

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




Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue


Page properties
hiddentrue


Tech review

Status
colourGreen
titledone

Style guide

Status
colourGreen
titledone

Page status

Status
colourGreen
titledone
 

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged