Versions Compared

Key

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


UI Text Box
typeinfo

There are multiple parsing modes available in the expression parser. The two most commonly used parsing modes are:

  • Basic: with this simple parsing mode you can write free text and insert field codes with format %{...somefield} or %{...somefield.i} anywhere in your text. These field codes will be replaced at runtime with the corresponding field values of the issue currently being processed.
  • Advanced: with this parsing mode we can do much more complex text composition thanks to the usage of functions for replacing substrings, changing cases, reading fields in linked issues, sub-tasks, JQL selected issues, and much more. It requires the text to be parsed to be written as a string expression respecting the parser syntax.

You can easily switch between parsing modes. The available modes depend on the context!


UI Text Box
typetip

Most functions will accept string values so casting values to string 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
colour
subtle
Yellow
true
title
string
text



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

colour

subtle

Yellow

true
title

string

text

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

colour

subtle

Blue

true
titlenumber
Status

colour

subtle

Grey

true
titledate
Status

colour

subtle

Grey

true
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

colour

subtle

Green

true
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
title

Issue []

text


String List

Field codes

Parser Functions

Status
subtletrue
colourYellow
title

String []

text


Mixed

Field codes

Parser Functions written in three curly braces

Status

colour

subtle

Yellow

true
title

string

text