Versions Compared

Key

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

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 the Substitution Variablesvariables %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).

...

  • 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 & Attachmentsattachments - 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:

...

  • HELP - Provides quick links to additional documentation.

Refer to Tutorials for examples.

Tip
  • 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.
Info
titleRestrictions 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. 

Steps

Publish and view post function

Click the Publish Draft button to publish changes to your workflow and activate the Update Issue post function. Backing up your workflow ahead of publishing is always a good idea
  • .
Table plus
border0
heading0
multiplefalse
enableHeadingAttributesfalse
columnAttributesstyle="border:0;width=5%;",style="border:0;width=65%;",style="border:0;width=30%;max-width=30% !important;"
idsteps_table
enableSortingfalse
enableHighlightingfalse

Select Post Function

  1. Click the Add Post Function button in the Post Functions section of the workflow transition you want to add post function to.
  2. Find and select the Update Issues in the list.
  3. Click the Add button to add details to the post function.

Add Details to Update Issues

  1. Enter "HOT:%original_summary%" in the Summary field.
  2. Select the Detailed Fields tab.
  3. Perform the following:
    1. Select "Original key" from the available option in the Issues to Update field.
    2. Enter "HOT:%original_labels%" in the Labels field.
    3. Retain "Same" in the Resolution and Reporter fields respectively.
  4. Select the Conditions & Configuration tab under OPTIONAL RULES.
  5. Perform the following:
    1. Enter "%original_priority%" and "Blocker" in the Condition 1 and corresponding Regular expression pattern fields respectively.
    2. Enter "%original_components%" and ".+" in the Condition 2 and corresponding Regular expression pattern fields respectively.
  6. Click the Add button to save the values.

Image Removed