Document toolboxDocument toolbox

This article is for Cloud. Visit Data Center

Predefined Variables

As you write your formula, Structure attempts to map your variables to well-known Jira fields:

  • Variables with the same name as a field are mapped to those fields. For multi-word fields, you can write the words without spaces, or place a _ between each word: affectsVersions or affects_Versions. 

  • Many commonly used variations of field names are mapped to the corresponding field.

  • In addition to Jira fields, some variable names are automatically mapped to common Structure attributes. See Structure Attributes.

When naming variables:

  • Do not include spaces. Omit spaces or use an underscore.

  • Case is ignored (AffectsVersions is the same as affectsversions)

Jira Fields

The following list contains the most commonly used variables that are automatically linked to a Jira field. This is not a complete list.

Jira Field

Standard Variable Name

Type

Notes

Jira Field

Standard Variable Name

Type

Notes

Affects Version/s

affectsVersions

Array<Version>

 

Assignee

assignee

User

 

Components

components

Array<Component>

 

Created

created

Number (Date/Time)

 

Creator

creator

User

 

Description

description

Text

 

Due Date

dueDate

Number (Date)

 

Environment

environment

Text

 

Epic

epic

Text

Works for company-managed and team-managed projects

Epic Link

epicLink

Text

Only works in company-managed projects

Fix Version/s

fixVersions

Array<Version>

Can also use: versions

Key

key

Text

Can also use: issueKey

Issue ID

issueid

Number

 

Issue Type

issueType

Issue Type

 

Labels

labels

Array<String>

 

Last Comment

lastComment

Last Comment

 

Original Estimate

originalEstimate

Number (Duration)

 

Priority

priority

Text

 

Project

project

Project

 

Remaining Estimate

remainingEstimate

Number (Duration)

 

Reporter

reporter

User

 

Resolution

resolution

Text

 

Resolved

resolved

Number (Date/Time)

Can also use: resolutionDate

Sprint

sprint

Sprint

 

Status

status

Status

 

Status Category

statusCategory

Text

 

Summary

summary

Text

 

Time Spent

timeSpent

Number (Duration)

 

Updated

updated

Number (Date/Time)

 

Work Logs (Jira)

jiraWorkLogs

Array<Work Logs (Jira)>

 

Work Logs (Tempo)

tempoWorkLogs

Array<Work Logs (Tempo)>

 

Structure Attributes

The following variables are automatically mapped to Structure attributes.

Variable Name

Type

Results

Variable Name

Type

Results

itemid

Text

Returns the item type plus the item ID. Ex. "issue/10800"

itemType

Text

Returns the item type: issue, project, user, folder, etc.

level

Number (Integer)

Returns the level of the item within the structure's hierarchy. Can also use: depth

done

Number (Boolean)

Returns a '1' if the issue is Done; otherwise, '0'

 

Â