Versions Compared

Key

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

...

Section


Column

Variables

Some variables are listed on the post function definition screen as an aid when creating definitions. This is a more complete and detailed list and represents the variables available with the most recent version of the add-on. If you need access to additional fields, raise a support request with our support team.

Note the terminology for the meaning of parent and original.

Tip
titleCustom fields

Custom fields are identified by name or id (like customfield_12345). By name is easier to know what it is referring to but by id will survive renaming a custom field.


Table plus


VariableDescriptionNotes
user_idUser id of user that is considered to be doing the transition
user_nameDisplay name of user that is considered to be doing the transition
entryEntry from multiple issues processingExample: How to condition the creation of issues.
nowCurrent date/time in Jira complete date/time format or a specific format 
project, parent_project, original_project, entry_projectProject key of the issue
project_id, parent_project_id, original_project_id, entry_project_idProject id (numeric) of the issue
project_name, parent_project_name, original_project_name, entry_project_nameProject name for the issue

project_category, parent_project_category, original_project_category, entry_project_category

Project category name for the project of the issueBlank if the project does not have a category configured.

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

Issue key
parent_id, original_id, entry_idIssue numeric id
parent_summary, original_summarySummary
parent_description, original_descriptionDescription
parent_environment, original_environmentEnvironment
parent_issuetype, original_issuetypeIssue type
parent_status, original_statusIssue status
parent_priority, original_priorityPriority
parent_reporter, original_reporterReporter user id
parent_assignee, original_assigneeAssignee user id
parent_components, original_componentsComma separated list of components
parent_component_descriptions, original_component_descriptionsComma separated list of component descriptions. Some may be blank.
parent_affected_versions, original_affected_versionsComma separated list of affected version names
parent_fixed_versions, original_fixed_versionsComma separated list of fixed version names
parent_subtasks, original_subtasksComma separated list of sub-task issue keys
parent_duedate, original_duedateDue date in Jira DMY date format or a specific format
parent_created, original_createdCreated date in Jira complete date/time format or a specific format 
parent_updated, original_updatedUpdate date in Jira complete date/time format or a specific format 
parent_resolution, original_resolutionResolution
parent_resolution_date, original_resolution_dateResolution date in Jira complete date/time format or a specific format 
parent_labels, original_labelsBlank separated list of labels
parent_labels_comma_separated, original_labels_comma_separatedComma separated list of labels
parent_watchers, original_watchersComma separated list of watcher user ids
parent_watches, original_watchesNumber of watchers of the issue
parent_votes, original_votesNumber of votes for the issue
parent_time_spent, original_time_spentTime spent on the issue in minutesThe Jira timeSpent field returns seconds.
parent_estimate, original_estimateCurrent estimate for the issue in minutes
parent_original_estimate, original_original_estimateTime spent on the issue in minutesNote the two different meanings of the original word here (smile).
parent_security_level, original_security_levelSecurity level name
<field name>

Parent issue's Jira issue field value

Deprecated but still active, recommend using specific replacements variables instead

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

Jira defines what information is returned by these fields.

<customfield name>

parent_<customfield name> (since 3.4)

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> (since 3.4)

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.

transition_commentComment entered on the transition screen
transition_user_idActual transition user id even if using acting support
transition_user_nameActual transition user name even if using acting support
jql_result_countNumber of issues returned by the query
jql_result_listComma separated list of issue keys returned from the query
jql_result_nThe issue key for the nth issue returned from the query where n is a numberBlank if n is not in range for the issue list.
pattern1_nnth capture group from condition pattern 1Blank if n is not in the range of valid capture groups.
pattern2_nnth capture group from condition pattern 2Blank 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 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 (4.6)
  • org.swift.jira.cot.created_key_list
  • 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 groupExample: group_jira-users.
role_<role name>Comma separated list of user ids for users that are role actors for the project of the original issueExample: 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).


Primarily used for advanced scenarios for multi-issue creation scenarios using entry substitution variable. See How to use a cascade select configuration to provide a value map.

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

function_<function name>(<parameters>)

  • 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
tilteMake sure you use the correct syntax!
titleMake 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. JCLIP workflow functions will 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 will be 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

Configured date format

For date substitution variables, the format of the replacement variable can be specified if the default format is not desirable. The format is specified by a Simple Date Format string enclosed in parenthesis following the substitution variable name. For example: %created(yyyy-MM-dd)% will result in replacement like 2013-05-28.


...