Versions Compared

Key

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


Div
idProductTOC

On this page

Table of Contents
maxLevel2
excludeOn this page
typeflat
separatorpipe

Description

Using the Create Sub-taskSubtask workflow post function will allow you to create one or more Issues when the post function is processed after a workflow transition step. We've streamlined the configuration of this post function by grouping all configuration settings into two steps:

Step 1 - Issue Fields

This configuration screen allows various tabs based on the following tabs:

  • These issue fields allow you to define the contents of one or more fields when an issue is created by this post function. Substitution Variables can then be used to populate fields. Issue Fields have been grouped into

...

  • the following common categories:
    • Basic Fields - includes fields which are most commonly used when creating a new 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

...

  • - These allow you to define the conditions under which you

...

  • can create the Issue.

...

  • This also provides additional configuration options, such as JQL input, the acting user, etc.

Image Added

Example

In this scenario, we will introduce This scenario introduces a new Create Sub-task Subtask workflow post function to a transition step within an existing workflow.

Background

Our scenario will use uses an example ePub workflow that helps teams coordinate the publication of electronic books. While transitioning from the "Open" to "In Draft" steps, we will let us create a new Sub-task Subtask within a specific IT Services project in our Jira instance. This will create creates an Issue (sub-tasksubtask) in the backlog of our Digital Publication team, so their manager can begin forecast and assign resources. 

Steps

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


Isolate the Workflow Transitions (id) for new Create Issue Post Function

Logged into Jira as a workflow administrator:

  1. Navigate to Project Settings → Workflows.
  2. Under the Actions navigation, click on Edit.
  3. Using the editor in "text" mode, click on the link name of the Transitions (id) that you will introduce
    a Create Issue Post function against.




Add Post Function

  1. Select the Post Functions tab
  2. Click on the "Add post function" like (right-hand side of dialog). 

  3. Select the "Create Issue" radio button.
  4. Click the "Add" button listed blow the options.








Define Issue Fields

  1. Within the "Basic Fields" section:
    1. Keep the default Summary as "%parent_summary%", so we inherit the same summary
      as the parent issue.
    2. Set the Description field to "FYI - ePub sub-task subtask workflow initiated"
  2. Navigate to the "Detailed Fields" section:

    1. Under Details: 
      1. Set the Issue Type to "New-Sub-TaskSubtask"  
    2. Under People:
      1. Keep the Reporter as "Current user"
      2. Keep the Assignee as "Parent issue's assignee"
    3. Under Links:
      1. Set the Create links value to "Parent issue key"
      2. Set the Create link type value to "relates"
      3. Set the Create link direction to "Issue key to new issue"
  3. Click on the "Add" button at the bottom of the screen.

View configuration



Publish and Validate Post Function

  1. Click on the "Publish Draft" button to publish changes to your workflow and activate
    the Create Issue post function. 
  2. Backing up your workflow ahead of publishing is always a good idea. However, in this case
    we will simply publish without a backup.
  3. Navigate to your Project in Jira.  In our case, we will navigate to the ePub project.
  4. Create a new Issue and then transition to the step where your new Create Sub-task Subtask post function 
    is configured. In our case, this is the In Draft step.
  5. Search for new Issues within your project. You should see the new Issue automatically created with the values you defined in the previous step.

Explore Configuration Settings

...


Configuration Settings