The general parsing mode is a powerful mode where you can write free text, insert field codes and use JWT expression parser functions anywhere in your text.
Field codes will be replaced at runtime with the corresponding field values of the issue currently being processed.
The general mode is generally the preferred mode if you want to set or update values (from fields to issue types) based on a parser expression. It is currently only available when configuring Post functions.
The general mode always returns a text. In case the output is used as an input for a number (especially date) parameter or as an issue list, JWT for Jira Cloud internally converts the data type.
Example expressions
Parser expression | Description |
---|---|
This is the issue summary: %{issue.summary} | This example might return: This is the issue summary: JWT 3.0 wording update |
%{"This is the issue summary: " + %{issue.summary} + " and the assignee mail is: " + userEmail(%{issue.assignee.email}) | This example might return: This is the issue summary: JWT 3.0 wording update and the assignee email is: a.grant@test.com |
JWT expression parser functions as well as field codes have to be enclosed by %{...}
. When you are nesting functions, only one %{...}
is necessary.
Within functions, texts have to be written in quotation marks.
Quotes (") within a quoted text have to be escaped (e.g. "This is a \"quoted\" text" will result in This is a "quoted" text).
%{
generally indicates the use of a field code or JWT expression parser functions. If you want to use this combination of characters in your free text, they need to be escaped by "\":
You want to use these characters as free text... | ... you need to to write this |
---|---|
%{ | \%\{ |
The operators, their meaning and the applicable data types you can use them with are listed below. A comparison always returns a BOOLEAN value. The table below lists all logical operators that can be used for linking logical terms in an expression. They take logical terms (which return BOOLEAN values) as operands and can thus be built using: Logical operators can only be used in logical expressions in the Logical mode or in combination with the conditional operator. The conditional operator, ?-operator, is a powerful one to construct conditional expressions. It basically allows you to construct the following expression: IF logical_expression Comparison operators
Logical operators
Conditional operator
true
THEN term_1 ELSE term_2.<logical_expression> ? <term_1> : <term_2>