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
oraffects_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 |
---|---|---|---|
Affects Version/s |
| Array<Version> | |
Assignee |
| User | |
Components |
| Array<Component> | |
Created |
| Number (Date/Time) | |
Creator |
| User | |
Description |
| Text | |
Due Date |
| Number (Date) | |
Environment |
| Text | |
Epic | epic | Text | Works for company-managed and team-managed projects |
Epic Link |
| Text | Only works in company-managed projects |
Fix Version/s |
| Array<Version> | Can also use: versions |
Key |
| Text | Can also use: issueKey |
Issue ID |
| Number | |
Issue Type |
| Issue Type | |
Labels |
| Array<String> | |
Last Comment | lastComment | Last Comment | |
Original Estimate |
| Number (Duration) | |
Priority |
| Text | |
Project |
| Project | |
Remaining Estimate |
| Number (Duration) | |
Reporter |
| User | |
Resolution |
| Text | |
Resolved |
| Number (Date/Time) | Can also use: resolutionDate |
Sprint |
| Sprint | |
Status |
| Status | |
Status Category |
| Text | |
Summary |
| Text | |
Time Spent |
| Number (Duration) | |
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 |
---|---|---|
itemid | Text | Returns the item type plus the item ID. Ex. "issue/10800" |
itemType | Text | Returns the item type: issue, project, user, folder, etc. |
| Number (Integer) | Returns the level of the item within the structure's hierarchy. Can also use: depth |
| Number (Boolean) | Returns a '1' if the issue is Done; otherwise, '0' |