Versions Compared

Key

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

...

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 

Since 1.3.

project, parent_project, original_project, entry_project

Project key of the issueQualified entries since 1.2.

project_id, parent_project_id, original_project_id, entry_project_id

Project id (numeric) of the issue

Since 1.4.

project_name, parent_project_name, original_project_name, entry_project_name

Project name for the issue

Since 2.3.

project_category, parent_project_category, original_project_category, entry_project_category

Project category name for the project of the issue

Qualified entries since 1.2.

project_lead, parent_project_lead, original_project_lead, entry_project_lead

User id of the project lead.

Since 1.2.

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 idSince 1.3.

parent_summary, original_summary, entry_summary

Summary


parent_description, original_description, entry_description

Description


parent_environment, original_environment, entry_environment

Environment

Since 1.1.

parent_issuetype, original_issuetype, entry_issuetype

Issue type


parent_status, original_status, entry_status

Issue status

Since 1.1.

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

Since 1.1.

parent_component_descriptions, original_component_descriptions, entry_component_descriptions

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

Since 2.2

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 keysSince 1.1.

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

ResolutionSince 1.1

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

Since 1.1.

parent_votes, original_votes, entry_votes

Number of votes for the issue

Since 1.1.

parent_time_spent, original_time_spent, entry_time_spent

Time spent on the issue in minutes

Since 1.1. Note the JIRA timeSpent field returns seconds.

parent_estimate, original_estimate, entry_estimate

Current estimate for the issue in minutesSince 1.1.

parent_original_estimate, original_original_estimate, entry_original_estimate

Time spent on the issue in minutes

Since 1.1. Note the 2 different meanings of the original word here (smile).

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 supportSince 1.2.

transition_user_name

Actual transition user name even if using acting support

Since 1.2.

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.


Since 1.3.

Examples:

  • org.swift.jira.cot.last_created_key

  • org.swift.jira.cot.last_created_non_subtask_key(2.0)

  • 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%)%



Since 1.1.

  • Version id is since 1.4

  • Field value is since 1.6

  • List since 1.7

  • FindReplace since 2.0

  • UserName since 2.1

  • VersionInfo since 2.1

  • GroupMemberList since 2.1

  • ComponentLead since 2.2

  • LinkedIssues since 2.7

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.Since 1.1.

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.


...