Get started

Use case library

JWT expression editor

JWT expression parser functions

JWT workflow functions

JWT remote actions

JWT automation rules

JWT calculated fields

JWT calendars

JWT properties

JWT JQL functions

Cloud migration hub

Additional product info

Supported list types

Number list

This function returns the first element of a number list. If the list is empty, the function returns NULL.

Syntax
first(numberList) #Output: Number
Examples
Parser expressionDescription
first([3, 2, 1, 0])

This example returns:

3

Additional information

Parameters used in this function

ParameterInput (data type)Description
numberList

NUMBER LIST

Any given number list.
Output

This function returns a NUMBER


Text list

This function returns the first element of a text list. If the list is empty, the function returns NULL.

Syntax
first(textList) #Output: Text
Examples
Parser expressionDescription
first(["blue", "red", "green"])

This example returns:

blue

Additional information

Parameters used in this function

ParameterInput (data type)Description
textList

TEXT LIST

Any given text list.
Output

This function returns a TEXT


Issue list

The function returns an issue list with the first element of the given issue list. If the issue list is empty, the function returns an empty ISSUE LIST.

Syntax
first(issueList) #Output: Issue list
Examples
Parser expressionDescription
first(subtasks())

This example returns the first sub-task returned by subtasks().

If subtasks() returns [SUB-1, SUB-2, SUB-3], the output will be:

[SUB-1]

Additional information

Parameters used in this function

ParameterInput (data type)Description
issueList

ISSUE LIST

Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).
Output

This function returns an ISSUE LIST


Use cases and examples

Use caseJWT featureWorkflow functionField typeAutomated actionParser functions
Set fix version based on its start and release date

Update or copy field values 

  toString() textOnStringList() unreleasedVersions() startDates() releaseDates() first()
Inherit value from parent in Advanced Roadmaps hierarchy

  

Update field action

fieldValue()

first()

parent()

Copy excerpted value from new comments

  

Update field action

findPattern()

first()


Create a sub-task for every sub-task closed

Create issue

  findReplaceFirst() first() findPattern() toString() sum() toNumber()
Clone epic, tasks and sub-tasks

Create issue

  toString() toStringList() issueKeysToIssueList() replaceFirst() first() fieldValue() textOnStringList() findModify() subtasks() issuesUnderEpic()
Change the assignee to the next evaluator

Update or copy field values

  

first()

toStringList()

Highest ranked custom field value among all linked issues

 Text 

first()

sort()

fieldValue()

linkedIssues()

Creation date of the linked epic

 

Date-time

 

first()

fieldValue()

linkedIssues()