Versions Compared

Key

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


UI Text Box
sizemedium
typeinfo

parsing mode determines how the JWT expression parser interprets an expression. 

The available parsing modes depend on the context you are using the expression in. This means for example, that only the Logical mode is available if you configure a conditionalexecution in a workflow post function or that you can only use the Number mode if you want to set a number field using a parser expression.


Multiple available parsing modesPre-configured parsing mode


UI Text Box
typetip

Most functions will accept text values so casting values to text is a very powerful function. Details can be found below in the converting data types section!

Additionally, you can directly transform a field value to text using the following syntax: %{...somefield}



UI Expand
titleParsing modes overview


ModeSupported featuresReturn typeExample
BasicField codes


Status
subtletrue
titletext



The basic parsing mode supports the usage of field codes. Field codes can be used to access issue field values.

Code Block
languagebash
titlesimple text using a field code to read the summary
linenumberstrue
This is the issue summary: %{trigger.issue.summary}


Advanced

Field codes

Parser Functions

Status
subtletrue
titletext

The advanced parsing mode has a defined syntax that allows you to write functions to read and manipulate data from any issue in Jira. Field codes are supported as well as clear text, written in quotation marks.

Code Block
languagebash
titleAdvanced expression to read the issue summary and use a function to get the assignee mail address
linenumberstrue
This is the issue summary:" + %{trigger.issue.summary} + " and the assignee mail is: " + userEmail(%{trigger.issue.assignee})


Math/date-time

Field codes

Parser Functions

Status
subtletrue
titlenumber
Status
subtletrue
titledate
Status
subtletrue
titledate_time

The mathematical and date time parsing mode works like the advanced mode but expect a number as result instead of a string. The resulting number is used to updated numeric or date time fields. In case of date or date time fields the number will be cast to a date.

Code Block
languagebash
titleTime to resolve the issue
linenumberstrue
{trigger.issue.resolutionDate} - {trigger.issue.createdDate}


Logical

Field codes

Parser Functions

Status
subtletrue
titleboolean

The logical parsing mode works like the advanced parsing mode but expression result must return true or false.

Code Block
languagebash
titleCheck if the assignee is equals the reporter
linenumberstrue
{trigger.issue.assignee} = {trigger.issue.reporter}


Issue List

Field codes

Parser Functions

Status
subtletrue
titleissue LIST


String List

Field codes

Parser Functions

Status
subtletrue
titleTEXT LIST


Mixed

Field codes

Parser Functions written in three curly braces

Status
subtletrue
titletext




UI Text Box
typetip

You can write your text in basic mode, and then switch to advanced mode using Automatic parsing mode converter.

The text to be parsed will be automatically rewritten as a string expression. Now, you can simply make the modifications you require, making use of text formatting functions, or inserting math or time expressions where needed.

To update issue fields the parsing result will be cast to the expected value e.g. a user name will be cast to a user to update a user field like the assignee field.



Page properties
hiddentrue


Tech review

Status
titletodo

Style guide

Status
titletodo

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