Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Tip

Variables used by post functions versus validators

  • Post functions are more likely to use field variables either from the original issue or parent issue as they represent the already changed values (post transition)

  • Validators are more likely to use the transition variables to access the screen values since the issue field values still represent the former values

Table plus

Variable

Description

Notes

user_id

User id of user that did the transition

user_name

Display name of user that did the transition

entry

Issue key for current entry being processed

now

Current date/time in JIRA complete date/time format or a specific format 

project, parent_project, original_project, entry_project

Project key of the issue

project_id, parent_project_id, original_project_id, entry_project_id

Project id (numeric) of the issue

project_name, parent_project_name, original_project_name, entry_project_name

Project name for the issue

project_category, parent_project_category, original_project_category, entry_project_category

Project category name for the project of the issue

project_lead, parent_project_lead, original_project_lead, entry_project_lead

User id of the project lead.

project_default_security, original_project_default_security, entry_project_default_security

Default issue security level name for the project

project_default_security_id, original_project_default_security_id, entry_project_default_security_id

Default issue security level id for the project

parent_key, original_key, entry_key

Issue key

parent_id, original_id, entry_id

Issue numeric id

parent_summary, original_summary, entry_summary

Summary

parent_description, original_description, entry_description

Description

parent_environment, original_environment, entry_environment

Environment

parent_issuetype, original_issuetype, entry_issuetype

Issue type

parent_status, original_status, entry_status

Issue status

parent_priority, original_priority, entry_priority

Priority

parent_reporter, original_reporter, entry_reporter

Reporter user id

parent_assignee, original_assignee, entry_assignee

Assignee user id

parent_components, original_components, entry_components

Comma separated list of components

parent_component_descriptions, original_component_descriptions, entry_component_descriptions

Comma separated list of component descriptions. Some may be blank.

parent_affected_versions, original_affected_versions, entry_affected_versions

Comma separated list of affected version names

parent_fixed_versions, original_fixed_versions, entry_fixed_versions

Comma separated list of fixed version names

parent_subtasks, original_subtasks, entry_subtasks

Comma separated list of subtask issue keys

parent_duedate, original_duedate, entry_duedate

Due date in JIRA DMY date format or a specific format

Specific format.

parent_created, original_created, entry_created

Created date in JIRA complete date/time format or a specific format 

Specific format.

parent_updated, original_updated, entry_updated

Update date in JIRA complete date/time format or a specific format 

Specific format.

parent_resolution_date, original_resolution_date, entry_resolution_date

Resolution date in JIRA complete date/time format or a specific format 

Specific format.

parent_resolution, original_resolution, entry_resolution

Resolution

parent_labels, original_labels, entry_labels

Blank separated list of labels

parent_labels_comma_separated, original_labels_comma_separated, entry_labels_comma_separated

Comma separated list of labels

parent_watchers, original_watchers, entry_watchers

Comma separated list of watcher user ids

parent_watches, original_watches, entry_watches

Number of watchers of the issue

parent_votes, original_votes, entry_votes

Number of votes for the issue

parent_time_spent, original_time_spent, entry_time_spent

Time spent on the issue in minutes

Note the JIRA timeSpent field returns seconds.

parent_estimate, original_estimate, entry_estimate

Current estimate for the issue in minutes

parent_original_estimate, original_original_estimate, entry_original_estimate

Time spent on the issue in minutes

Note the 2 different meanings of the original word here.

parent_security_level, original_security_level, entry_security_level

Security level name

<field name>

Parent issue's JIRA issue field value

Deprecated but still active, recommend using specific replacements variables for clarity

Examples: components, resolution. See Jira issue field constants.

JIRA defines what information is returned by these fields.

<customfield name>

parent_<customfield name>

Parent issue's custom field value

Recommend using prefix qualified name for clarity

Must be an exact match including case and blanks.

JIRA defines what information is returned by these fields.

<customfield id>

parent_<customfield id>

Parent issue's custom field value

Example: customfield_10010.

JIRA defines what information is returned by these fields.

original_<customfield name>

Original issue's custom field value

Similar to above.

Useful for sibling create scenarios.

original_<customfield id>

Original issue's custom field value

Similar to above.

Example: original_customfield_10010.

entry_<customfield name>

Entry issue's custom field value

Similar to above.

entry_<customfield id>

Entry issue's custom field value

Similar to above.

Example: original_customfield_10010.

transition_comment

Comment entered on the transition screen

transition_user_id

Actual transition user id even if using acting support

transition_user_name

Actual transition user name even if using acting support

transition_<system field name>

Value entered on transition screen for system fields

Used for validators to get access to fields. Blank if not on transition screen. See Jira issue field constants.

transition_<customfield name>

transition_<customfield id>

Value entered on transition screen for custom fields

Used for validators to get access to fields. Blank if not on transition screen.

jql_result_count

Number of issues returned by the query

jql_result_list

Comma separated list of issue keys returned from the query

jql_result_n

The issue key for the nth issue returned from the query where n is a number

Blank if n is not in range for the issue list.

pattern1_n

nth capture group from condition pattern 1

Blank if n is not in the range of valid capture groups.

pattern2_n

nth capture group from condition pattern 2

Blank if n is not in the range of valid capture groups.

property_<property name>

Transition property. Other transition functions can add transition properties that can be referenced. This provides a way to access those transition properties. You must know the property name.

Examples:

  • org.swift.jira.cot.last_created_key

  • org.swift.jira.cot.last_created_non_subtask_key

  • org.swift.jira.acli.validator_message - result message from last CLI action validator

  • org.swift.jira.acli.function_message - result message from last CLI action post function

group_<group name>

Comma separated list of user ids for members in the group

Example: group_jira-users.

role_<role name>

Comma separated list of user ids for users that are role actors for the project of the original issue

Example: role_developers.

values_<customfield name>

values_<customfield id>

For special use cases only needing access to the field configuration.

Comma separated list of custom field option values in the context of the original issue

Tip

This is for accessing the configuration of the custom field and NOT the values of a custom field for an issue (see custom field value substitution variables mentioned above).

Custom field should be of a type that has option value like multi-select or cascade select. For cascade select fields, it is a list of parent option values.

values_<customfield name>(<value or sub variable>)

values_<customfield id>(<value or sub variable>)

For special use cases only needing access to the field configuration.

Comma separated list of cascade select child option values for the specific parent value provided.

Tip

This is for accessing the configuration of the custom field and NOT the values of a custom field for an issue (see custom field value substitution variables mentioned above).

Examples: values_custom-cascade-select(entry), values_custom-cascade-select(1)

See How to use a cascade select configuration to provide a value map.

function_<function name>(<parameter>)

  • earliestUnreleasedVersion(projectKey)

  • latestReleasedVersion(projectKey)

  • versionId(projectKey, versionName)

  • fieldValue(issueKey, fieldName)

  • list(startNumber, endNumber)

  • findReplace(text, replacement)

  • userName(userId)

  • versionInfo(projectKey, versionName, request, dateFormat)

  • groupMemberList(groupName)

  • componentLead(projectKey, componentName)

  • linkedIssues(issueKey, linkType)

Functions that derive useful text values that can be used as substitution variables. Some are similar to their equivalent JQL function (follow link). The parameter(s) may be a substitution variable.

Tip

Make sure you use the correct syntax!

Set custom field: field: My custom field, value: %function_earliestUnreleasedVersion(%project%)%

Example: function_earliestUnreleasedVersion(%project%)

cli_replace_<name>

Many Atlassian CLI products support setting replacement variables during the running of actions in order to facilitate use in a subsequent actions. Run CLI Actions in Jira workflow functions take these replacement variables from the running of a CLI action and populate the transition properties so they can be available in subsequent functions as substitution variables. Use the prefix and the replacement name from the lists shown on the replacement variables page after running a CLI action function that produces replacement variables.

Example: cli_replace_issue is replaced with the issue key of the last created issue after the createIssue action is run by a CLI action function.

Anchor
configured-date-format
configured-date-format

...