Div |
---|
|
On this page Table of Contents |
---|
maxLevel | 2 |
---|
exclude | On this page |
---|
type | flat |
---|
separator | pipe |
---|
|
|
...
Using the Create Sub-task workflow post function will allow allows you to create one or more sub-tasks when the post function is processed after a workflow transition step. We've streamlined the The configuration of this post function is streamlined by grouping all configuration settings into various tabs for easy access:
- ISSUE FIELDS - These issue fields allow Allow you to define the contents of one or more fields when an sub-task is created 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 creating a new sub-task in Jira.
- Detailed Fields - includes details associated with the sub-task, people involved, and dates.
- Links - includes details of sub-task 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 create the sub-task(s). Optional Rules are grouped into the following category:
- Conditions & Configuration - Define one or more conditions for when to create the sub-tasks(s), use JQL to define substitution variables to be used to populate other fields, as well as set the acting user for the sub-task creation.
- HELP - Provides quick links to additional documentation
Example
This scenario introduces a new Create Sub-task workflow post function to a transition step within an existing workflow.
Background
Our 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 our Jira instance. This creates a sub-task issue in the backlog of our Digital Publication team, so their manager can begin to forecast and assign resources.
Steps
Table plus |
---|
border | 0 |
---|
heading | 0 |
---|
multiple | false |
---|
enableHeadingAttributes | false |
---|
columnAttributes | style="border:0;width=5%;",style="border:0;width=65%;",style="border:0;width=30%;max-width=30% !important;" |
---|
id | steps_table |
---|
enableSorting | false |
---|
enableHighlighting | false |
---|
|
| Isolate the Workflow Transitions (id) for new Create Issue Sub-task Post FunctionLogged into Jira as a workflow administrator: - Navigate to Project Settings → Workflows.
- Under Click the respective Edit link of the required Scheme, in the Actions navigation, click Editcolumn.
- Using the editor in "text" mode, click the Click the link name of the Transitions (id) that you will introduce a Create Issue Post function against.
Image Removed- for which you want to add a 'Create Sub-task' post function.
| Image Added |
| | Add Post Function- Select the Post Functions tab
Click the "Add post function" like (right-hand side link on the top right corner of dialog). - Select the "Create Sub-task " radio button.
- Click the "Add" button listed below the options.
| Image RemovedImage Added
|
| | Define Issue Fields- Within Select the "Basic Fields" section tab:
- Keep Retain the default Summary as "%parent_summary%", so we inherit the same summary as the parent issue.
- Set the Description field to Enter "FYI - ePub sub-task workflow initiated" in the Description field.
Navigate to the "Detailed Fields" section tab: Within the the details: Set the Issue type to Select "Sub-task" as Issue type- Under People:
- Keep the Reporter as Select "Current user" Keep the Assignee as as Reporter
- Select "Parent issue's assignee" as Assignee
- Navigate to the "Links" section tab:
- Set the Create link value to Select "Parent issue key" Set as the Create link type value to "Relates"Set value
- Select "relates" as the Create link direction to type value
- Select "Issue key to new issue" as Create link direction
- Click the "Add" button at the bottom of the screen.
| Image RemovedImage Added View configuration Image RemovedImage Added
|
| | Publish and Validate Post Function- Click the "Publish Draft" button to publish changes to your workflow and activate the Create Sub-task post function. Backing Backing up your workflow ahead of publishing is always a good idea. However, in this case we will , simply publish without a backup.
- Navigate to your Project in Jira. In our case, we will navigate to the ePub project.
- Create a new Issue issue and then transition to the step where your new Create Sub-task post function is configured. In our case, this is the In Draft step.
- Search for new sub-tasks within your project. You should see the new sub-task automatically created with the values you defined in the previous step.
| Image RemovedImage Added |
|
Configuration Settings