Get started

Use case library

JWT expression editor

JWT expression parser functions

JWT remote actions

Cloud migration hub

Additional product info

Supported list types

Number list

This function returns the numeric reference value of a given text. 

If this textKey does not exist in the textList, the function returns the last value of the referenceNumberList, if the referenceNumberList has one value more than the textList, otherwise NULL

Syntax
getMatchingValue(textKey, textList, referenceNumberList) #Output: Number
Examples
Parser expressionDescription
%{getMatchingValue(%{issue.priority}, ["High", "Medium", "Low"], [3, 2, 1])}

This example returns the correct number depending on the current priority.

This example could be used e.g. in the Update fields post function to set a specific field depending on the current priority.

%{getMatchingValue("Critical", ["Normal", "High", "Critical"], [1, 5, 20])}

This example returns:

20

%{getMatchingValue("None", ["Normal", "High", "Critical"], [1, 5, 20, 0])}

This example returns 

0

The textKey "None" is not available in the textList, so the last value of the referenceNumberList is returned (it has one more value than the textList).

%{getMatchingValue("Three", ["One", "Two", "Three", "Four", "Five"], [1, 1+1, 3*1, 4, 4+1])}

This example returns:

3

Additional information

Parameters used in this function

ParameterInput (data type)Description
textKey

TEXT

A text that exists in the textList.
textList

TEXT LIST

Any given text list.
referenceNumberList

NUMBER LIST

Any given number list.
Output

This function returns a NUMBER


Variant with a numberKey and two number lists.

Syntax
getMatchingValue(numberKey, numberList, referenceNumberList) #Output: Number
Examples
Parser expressionDescription
%{getMatchingValue(5, [1, 3, 5, 7, 9], [1, 1+1, 3*1, 4, 4+1])}

This example returns:

3

%{getMatchingValue(3, [1, 5, 7, 9], [1, 2, 3, 4, 99])}

This example returns:

99

The numberKey 3 is not available in the numberList, so the last value of the referenceNumberList is returned (it has one more value than the numberList).

Additional information

Parameters used in this function

ParameterInput (data type)Description
numberKey

NUMBER

A number that exists in the numberList.
numberList

NUMBER LIST

Any given number list.
referenceNumberList

NUMBER LIST

Any given number list.
Output

This function returns a NUMBER

 


Text list

This function returns the text reference value of a given text. 

If this textKey does not exist in the textList, the function returns the last value of the referenceTextList, if the referenceTextList has one value more than the textList, otherwise an empty text.

Syntax
getMatchingValue(textKey, textList, referenceTextList) #Output: Text
Examples
Parser expressionDescription
%{getMatchingValue("Spain", ["USA", "UK", "France", "Spain", "Germany"], ["Washington", "London", "Paris", "Madrid", "Berlin"])}

This example returns:

"Madrid" 

%{getMatchingValue(%{issue.issueType}, ["Task", "Sub-Task", "Story"], ["This is the description for a Task.", "Description for a Sub-Task", "Here comes the Story."])}

This example returns the correct description depending on the current issue type.

This could be used e.g. in the Create issue or Update fields post function to set the description depending on the selected issue type.

Additional information

Parameters used in this function

ParameterInput (data type)Description
textKey

TEXT

A text that exists in the textList.
textList

TEXT LIST

Any given text list.
referenceTextList

TEXT LIST

Any given text list.
Output

This function returns a TEXT


Variant with a number list.

Syntax
getMatchingValue(numberKey, numberList, referenceTextList) #Output: Text
Examples
Parser expressionDescription
%{getMatchingValue(8, [2, 4, 6, 8, 10], ["Washington", "London", "Paris", "Madrid", "Berlin"])}

This example returns:

"Madrid"

Additional information

Parameters used in this function

ParameterInput (data type)Description
numberKey

NUMBER

A number that exists in the numberList.
numberList

NUMBER LIST

Any given number list.
referenceTextList

TEXT LIST

Any given text list.
Output

This function returns a TEXT

Use cases and examples

Use caseJWT featureWorkflow functionParser functionsLabel
Create a sub-task for each component

Create issue

toStringList() getMatchingValue()