How to Automatically Transition a Linked Issue During a Workflow Transition

Create a JIRA project to use with this recipe

In this step, you are going to create a project you will use when creating a standard Story for an Epic. To do this, log on to your JIRA instance as a JIRA Administrator and do the following:

1. From the Projects menu, choose Create Project.
2. In the Select Project Type screen, select Simple Issue Tracking and click Next.
3. The second screen shows the Issue Types that will be used (Task and Sub-task). Click Select.
4. The third screen prompts you to supply a Name and Key for your new JIRA project.
   1. Use Recipe Update On Transition as the Name.
   2. Use RUOT as the Key.
   3. Click Submit to create the project, with you set as its Project Lead.
5. If you click Create and choose Recipe Update On Transition as the Project and Task as the Issue Type, you will see a Create Issue screen like the one shown to the right. Only 3 fields (Project, Issue Type, and Summary) are required, as indicated by the red asterisk next to their field labels. There are 2 optional fields: Priority and Description.

In the next step, you'll create 2 sample issues, so leave the Create Issue screen open.

Image RemovedImage Added

Create 2 sample issues

In this step, you will create 2 sample issues that will be used to test the workflow transition you'll be adding in a later step.

1. On the Create Issue screen, fill in the fields as shown in the first table on the right and then click Create. Take note of the issue key that was created.
2. Click Create again. Then, flll in the fields as shown in the second table on the right and click Create. Take note of the issue key that was created.
3. Go to the first issue you created. and do the following:
   1. From the More menu, choose Link.
   2. Fill in the fields as shown in the screenshot to the right. (Your issue keys might be different, but you should be viewing the first issue while creating a "blocks" link from it to the second issue.)
   3. Click Link to save this link. You should now see the link showing in the "Issue Links" section of the View Issue screen.

Fields for creating the second issue:

Link screen, to link the first issue to the second issue:

Image RemovedImage Added

Create a draft workflow

In this step, you will edit the workflow used by the Recipe Update On Transition project so you can begin the process of adding the Update Transition post function that will create a comment on the linked issue.

1. From the Cog menu ( Image RemovedImage Added) , choose Projects.
2. Click the Recipe Update On Transition link to display the Project Summary page which shows how the project is configured.
3. In the Workflows section of the page, click the pencil icon (Image RemovedImage Added) next to the RUOT: Simple Issue Tracking Workflow link to edit that workflow.
4. Click the Image Removed the Image Added button so that the workflow is shown in Text mode rather than Diagram mode.
5. There are 2 transitions named "Done": one is in the To Do step and the other is in the In Progress step. In the next step, you will be adding a new post function to both of these transitions,.

Add a post function on the Done transitions

In this step, you will add a post function on the two Done transitions.

From the RUOT: Simple Issue Tracking Workflow screen, do the following steps twice, :

• once for the Done transition under the To Do step, and
• again for the Done transition under the In Progress step

• .

1. Click the Post Functions tab to display the post functions. Your screen should look like the first screenshot shown to the right.
2. Click the Add post function link to display the Add Post Function To Transition screen.
3. Select Update issues and then click Add. The Add Parameters To Function screen will be displayed.
4. Set the parameters as shown to the right:
   1. Issues to Update:  This uses the %jql_result_list%substitution variable to indicate that the issue(s) being updated are based on what is returned by the JQL query specified in the JQL Query parameter.
   2. JQL Query: Thisindicates how to identify the issues to act upon. In this example, it is looking for issues that the issue currently being transitioned to Done is blocking. In other words, the current issue has a "blocks" link defined to those other issues.

   3. Comment: This indicates the comment to add to those other issues that will be updated.

      Info
      No other parameters need to be changed. JIRA will ignore any field that does not appear on the transition screen for the Done transition.

5. Click Add to save your changes to the parameters and add the Update Issues post function.

Image Removed

Add Post Function To Transition screen:

Image RemovedImage Added

Post Function parameters:

Configure the post function, part 1

In this step, you will configure the post function you just added to the Create transition so that a standard Story will be created each type a user creates an Epic.

From the Add Parameters To Function screen, do the following: