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 41

changes.mady.by.user Christian Czaia

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


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 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 the JWT expression parser will evaluate.

No, that's not a nice layout - but just as a hint that an overview of the expression editor (including hints to the different features) right at the top of the page would be a good idea 

Image Removed

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 expression entered is valid.

Image Added

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 selectionselector

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 the that lists all available field codes. The fields, or their values, will be be replaced with real actual values at runtime.

The available fields and their notation depends depend on the selected Parsing modesmode. 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. 

Field codes (

Learn more about field codes!

JWT expressions
)
Field codes (
Jira expressions
)
JWT expressions


Center

Multimedia

Jira expressions

nameparser-field-jwt-expression.mp4
width300
height300



Center

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

Screencast about field code injectorScreencast about field code injector and different notation




A few basic examples

Field nameField code (JWT expression)

Field code (Jira expressionexpressions)

Summary

%{issue.summary}

issue.summary

Description

%{issue.description}

issue.description

Assignee

%{issue.assignee}

issue.assignee.accountId

Reporter

%{parent.reporter}

issue.parent.reporter.accountId



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

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

    UI Expand
    titleExpression editing area

    This is where you can enter a plain text and optionally use Field codes and JWT expression parser functions.

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

    UI Text Box
    typetip

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

    Pressing <CTRL> + <space> will show a searchable list ofJWT expression parser functions and available field codes.

    Screencast

    Image Removed

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

    Example 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
    titleSyntax check

    Image Removed

    1. As you type in your expression the parser 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 Removed

    		Valid expression: The parser expression entered is valid.

    Image Removed


    UI Expand
    titleThe run Run button

    Image RemovedImage Added

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

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

    Image RemovedImage Added

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


    UI Expand
    titleIn-line handbookHandbook

    Multimedia
    nameparser-field-parser-handbook.mp4
    width700

    Image Removed

    Screencast

    Help is just a click away. If you click on the Help button, an in-app 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
    titleBuilt-in examplesExpression area

    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

    Image Removed

    Screencast

    Need inspiration? Each workflow function 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

    .



    Excerpt Include
    DECADIS:Contact support
    DECADIS:Contact support
    nopaneltrue