.png?version=1&modificationDate=1657805719617&cacheVersion=1&api=v2&width=272&height=48)
Description
The Update Issues post function can update one or more issues or sub-tasks. Issues can be explicitly listed or derived from custom fields or JQL query. A common example would be to use a JQL query and the Substitution Variables %jql_result_list%. Regex pattern matching conditions determine whether the issues will be changed or not. The JQL is either run once (default) or once for each issue being updated (when the query contains the %entry% substitution variable).
The configuration of this post function is streamlined by grouping all configuration settings into various tabs for easy access:
- ISSUE FIELDS - Allow you to define the contents of one or more fields when an issue is updated by this post function. Substitution variables can then be used to populate fields. Issue Fields are grouped into the following common categories:
- Basic Fields - Includes fields which are most commonly used when updating an issue in Jira.
- Detailed Fields - Includes details associated with the issue, people involved, dates.
- Links - Includes details of issue links and link types.
- Comments & Attachments - How you want to handle comments and specifics associated with attachments.
- Custom Fields - Controls whether to copy custom fields and allows you to define values for new custom fields.
- OPTIONAL RULES - Allow you to define the additional criteria for when and how to update the issue(s). Optional Rules are grouped into the following category:
Conditions & Configuration - Define one or more conditions for when to update the issue(s), use JQL to define substitution variables to be used to populate other fields, as well as set the acting user for updating the issue.
- HELP - Provides quick links to additional documentation.
- When updating an issue different than the issue being transitioned, fields that you are planning to update must be on the edit issue screen for the user doing the transition (or acting user if specified).
- If you need to update the same issue as that being created on the create issue transition, ensure the post function is placed towards the end of the list of post functions, especially after the update to the database action.
Restrictions when used with the create issue transistion
Only custom fields can be updated on the create issue transition; standard fields cannot be updated on the create issue transition. This is a permanent restriction - see CW-34.
Example
This scenario introduces a new Update issue workflow post function to a transition step within an existing workflow.
Background
This scenario uses an example ePub workflow that helps teams coordinate the publication of electronic books. While transitioning from the "Open" to "In Draft" steps, let us create a new sub-task within a specific IT Services project in the Jira instance. This creates a sub-task issue in the backlog of the Digital Publication team, so their manager can begin to forecast and assign resources.
