Versions Compared

Key

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

...

Section


Column

Variables

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
base_urlBase URL
user_idUser id of user that is considered to be doing the action
user_keyUser key of user that is considered to be doing the action
user_nameDisplay name of user that is considered to be doing the action
nowCurrent date/time on the Jira server in Jira complete date/time format or a specific format 
parent_project, original_projectProject key of the issue
parent_project_id, original_project_idProject id (numeric) of the issue
project_name, parent_project_name, original_project_nameProject name for the issue

project_category, parent_project_category, original_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_leadUser id of the project lead.

parent_key, original_key

Issue key
parent_id, original_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_versions, parent_affects_versions, original_affects_versions

Comma separated list of affected version names

parent_fixed_versions, original_fixed_versions, parent_fix_versions, original_fix_versions

Comma separated list of fixed version names
parent_subtasks, original_subtasksComma separated list of subtask issue keys
parent_issuelinks, original_issuelinksComma separated list of issue keys for links (not subtasks) to/from the issue
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_voters, original_votersComma separated list of voter user ids
parent_votes, original_votesNumber of votes for the issue
parent_time_spent, original_time_spentTime spent on the issue in minutesNote the JIRA timeSpent field returns seconds. Since 9.3.
parent_estimate, original_estimateCurrent estimate for the issue in minutesSince 9.3.
parent_original_estimate, original_original_estimate Time spent on the issue in minutesNote the 2 different meanings of the original word here (smile). Since 9.3.
parent_security_level, original_security_levelSecurity level name
parent_issue_restriction, orginal_issue_restrictionIssue restriction for nextgen (simplified) project issuesSince 9.4.

parent_<customfield name>

Parent issue's custom field value

Must be an exact match including case and blanks.

parent_<customfield id>

Parent issue's custom field value

Example: parent_customfield_10010.

original_<customfield name>

Original issue's custom field value

Similar to above.

original_<customfield id>

Original issue's custom field value

Similar to above.

Example: original_customfield_10010.

jql_result_countNumber of issues returned by the last getIssueList action using '–options cacheJqlResult'Since 9.4.
jql_result_listComma separated list of issue keys returned by the last getIssueList action using '–options cacheJqlResult'Since 9.4.
jql_result_nThe issue key for the nth issue returned by the last getIssueList action using '–options cacheJqlResult' where n is a numberSince 9.4.
group_<group name> Comma separated list of user ids (account ids for Cloud) for members in the groupExample: group_jira-users. Since 9.3.
role_<role name> Comma separated list of user ids (account ids for Cloud) for users that are role actors or members of group role actors for the project of the original issueExample: role_developers. Since 9.3.

function_<function name>(<parameters>)

Functions that derive useful text values that can be used as substitution variables. 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%)%

Notes

  • Field for fieldValue can be field name, custom field id, or id. 
  • Valid requests for versionInfo are: startDate, releaseDate, released, id.

Open an improvement request if you have similar needs.

Example: function_earliestUnreleasedVersion(%project%)

Since 9.6



Fields with ids

Some user fields like reporter, assignee, and lead and user custom fields returns the user's server user id or cloud display name by default. Similarly, some other fields like version fields, component, and some custom fields are internally based on option ids. In some cases, it is more desirable or even required to use the id for some operations. To enable getting id values instead of text values for a substitution field, we have a convention to use a _id postfix to the substitution variable.

Examples

  • ..._reporter_id - will return the reporter's unique id (user key for server, accountId for cloud)
  • ..._assignee_id - will return the assignees's unique id (user key for server, accountId for cloud)
  • group_jira-users_id - will return a list of group members unique ids (user key for server, accountId for cloud)
  • role_Developers_id - will return a list of group members unique ids (user key for server, accountId for cloud)
  • ..._voters_id - will return a list of unique id (user key for server, accountId for cloud) for voters


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 2016-05-28.


...