Versions Compared

Key

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

On this page

Table of Contentsexclude(On this page).*typeflatseparatorpipe

Content Layout Macro


UI Text Box
sizemedium
typeinfo

The parser expression editor saves you time by checking your expression before adding it to a post function, validator, or condition.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 will be evaluated on runtime.

 

Image Added



UI Expand
titleSyntax check

Multimedia
nameparser-field-parser-error.mp4
width700

Parser check

info

Info
iconfalse

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

Image Removed: Parsing error i.e. The parser expression entered is not valid and you can do the following to fix the issue:

Check your expression

Expand
titlemore info...
UI Text Box
type

  1. As you type in your expression the
parser
  1. syntax check button is synchronized with your expression and you can see if
it
  1. your expression is valid or not
so far
  1. .
  2. Click on the
parser
  1. syntax check button to review your expression.
  • Check your selected parsing mode
  • Try an example by clicking on the example button
    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
    Parser



    UI Expand
    titleParsing mode selector
    Info
    iconfalse

    The following parsing modes are available:

    • General - i.e. for adding a comment
    • Logical - works with conditions
    • Jira expression - works for every parameter

    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,

    Info
    iconfalse

    By clicking on the play button, a test expression field is displayed under your expression, then do the following:

    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 functionsIn 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