Versions Compared

Key

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

Scenario

Div
classtime

Estimated Time: 8 min

When an issue transitions between a certain step, you would like to create multiple issues, one for each fix version specified within the original issue.

Background

This scenario uses an example ePub workflow that helps teams coordinate the publication of electronic books. We want to add a Create Issue post function that processes when users transition issues from the "In Edit" to "In Composition" steps. Using the "Create multiple issues" feature of Create on Transition, we can provide a Substitution Variable of "%original_fixed_versions%". This allows us to create one issue for each of the fix versions associated with the issue being transitioned. Each issue created contains a link back to the parent issue. In order to better identify which fixed version the issues belong to, we prepend the issue summary with the fix version.

Steps

The following steps demonstrate how to configure Create on Transition using the Create multiple issues feature:

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


Step 1

As a Jira Administrator or Workflow Administrator:

  1. Navigate to your workflow (ePub in this case).
  2. Edit your ePub workflow to create a draft version.
  3. Navigate to the Post Functions tab.
  4. Add the Create Issue post function.




Step 2

ISSUE FIELDS:

  1. Select the Basics Fields tab.
  2. Prepend "%entry% - " to "%parent_summary%" in the Summary field.
  3. Select the Links tab.
  4. Select the following from the respective list of available options:
      • Create Link - "Original issue key"
      • Create link type - "Create on Transition"
      • Create link direction - "New issue to issue key"


Step 3

Configure the Create multiple issues field using a substitution variable.

  1. Select the Conditions & Configuration tab.
  2. Scroll down until you find Create multiple issues.
  3. Enter the "%original_fixed_versions%" substitution variable.
  4. Click the Add button to save your configuration.


Step 4

  1. Remember to publish your workflow. It is always recommend to save a backup
    of the previous workflow when prompted.
  2. Create an issue and assign a set of fixed versions.
  3. Transition the issue to trigger your post function.
  4. Validate that the new issues (one per fixed version) were created in the proper project and that each one contains a link back to the originating issue.


...