JWT is a text specialist!
Texts can be provided as fixed values - or literals - in the format described in the table below or they can be retrieved by using field codes.
Fixed values
Texts can be added to any expression as fixed values. How texts are being interpreted depend on the Parsing modes. Usually texts are enclosed by quotes "".
|
Input |
Description |
Example |
|---|---|---|
|
Valid text values |
A simple text can be added enclosed by quotes unless you are using the Basic text mode. In this case you do not need quotes. |
|
|
Concatenated text values |
You can concatenate texts with the + operator. This is useful when text fragments are separated by field codes or parser functions. |
Bash
Bash
|
|
Escape character \ |
This character can precede any of the following characters: ", \, n, r, t, f and b in order to invoke an alternative interpretation. |
Bash
|
Variable values (field values)
Text values of text data type fields can be inserted in any expression as text field codes using the following notation %{...somefield} - e.g %{issue.summary}.
Any field type or data type can be transformed to text, so any field can be referenced as a text-string value using the following notation: %{issue.somefield}.
If a field has no value ( null), an empty text will be returned.
Cascading Select fields are treated as text fields, where i is the index that represents the level to be accessed. ( i = 0 is used for base level) are notated as %{issue.somefield.i}
🗃️ Available functions
| Function | Short description | Output |
|---|---|---|
| findReplaceFirst() |
Replaces the first occurrence of a given substring with the given replacement. |
text |
| priority() |
Returns the name of the priority with a given ID. |
text |
| project() |
Returns the name of the project with a given ID. |
text |
| substring() |
Returns a specific part of a text. |
text |
| escapeHTML() |
Replaces special characters with HTML entities. |
text |
| status() |
Returns a status name. |
text |
| similarity() |
Calculates the similarity between two texts. |
number |
| replaceAll() |
Replaces all substrings matching a regular expression with a given replacement. |
text |
| findPatternIgnoreCase() |
Returns all substrings matching a given regular expression, ignoring the case. |
text list |
| toLowerCase() |
Converts a given text with all its characters lower case. |
text |
| trim() |
Removes leading and trailing blanks (white spaces and tabs) from a text. |
text |
| findModify() |
Replaces specific substrings matching a given regular expression. |
text |
| length() |
Returns the length any given text. |
number |
| capitalizeWordsFully() |
Capitalizes an entire text. |
text |
| getFromJSON() |
Returns the result of a given JMESPath which is applied to a JSON |
text |
| replaceFirst() |
Replaces the first substring matching a given regular expression with a given replacement. |
text |
| resolution() |
Returns the name of the resolution with a given ID. |
text |
| findReplaceAll() |
Replaces all occurrences of a given substring with the given replacement. |
text |
| findReplaceAllIgnoreCase() |
Replaces all occurrences of a given substring with a given replacement, ignoring the case. |
text |
| option() |
Returns the name of a custom field option. |
text |
| findPattern() |
Returns all substrings matching a given regular expression. |
text list |
| capitalizeWords() |
Capitalizes a text, only updating the first letters. |
text |
| htmlToTxt() |
Removes all HTML tags. |
text |
| issueType() |
Returns the name of the issue type with a given ID |
text |
| toUpperCase() |
Converts a given text with all characters to upper case. |
text |
| unescapeHTML() |
Replaces HTML escapes with their corresponding Unicode characters. |
text |
| findReplaceFirstIgnoreCase() |
Replaces the first occurrence of a given substring with the given replacement, ignoring the case. |
text |
| matches() |
Checks, if the given text matches the provided regular expression. |
boolean |
| wikiToHTML() |
Converts rich text wiki content to HTML. |
text |
| issueSecurityLevel() |
Returns the name of the issue security level with a given ID. |
text |