...
The data obtained from the placement of these two workflow post functions will appear on the Root Cause Analysis panel within each issue that has attributed a Root Cause Issue.
We feel that allowing you to specify which status transitions will map to the Resolver and Closer fields in the Root Cause Analysis plugin provides the ultimate in flexibility from the simplest to the most complex workflow processes.
...
As a working example, lets go through the Root Cause Analysis workflow configuration process for JIRA Software's Basic Software Development project type and its associated Software Development workflow...
- Start by clicking the Projects drop-down and select Create Project
- Select the Software Basic Software Development project type and click Next
- Click Select on the next screen and enter a Project Name, Key and KeyProject Lead. I'll use Root Cause test with a Test, key RCT, and project lead admin.
- Click Submit to finish project creation.
- You will now be on the project Overview Open Issues page. Click On the side navigation bar, click on the Project Administration cog link near located at the top bottom of the pagescreen.
- On the resulting project Administration page, look for the Workflows section and click on the(edit) icon beside the RCT: Software Development Workflow the Software Simplified Workflow for Project RCT link.
You are now presented with the list of Workflow steps and their valid transitions for the projects workflow.
Analyze the each workflow step and each of the associated transitions to determine which transitions we want the Root Cause Analysis plugin to manage data.
Step Name Transition Track Data for Resolver Track Data for Closer Reasoning To Do StartTo Do When in the To Do status and the To Do transition is triggered, the user has not changed the status of the issue, so we don't care to track anything from this specific transition. " In Progress When in the To Do status and the Start In Progress transition is triggered, the user is just starting work so we don't care to track anything from this specific transition for Root Cause Analysis plugin purposes. '' DoneIn Review When in the To Do status and the Done In Review transition is triggered, the user performing the action is both marking the issue as change completeand verification complete. The Root Cause Analysis plugin will want to gather information from this status transition for both just the Resolver and the Closerat this time. ''" Start ReviewDone When in the To Do status and the Start Review Done transition is triggered, the user performing the action is both marking the issue as change complete and verification complete. The Root Cause Analysis plugin will want to gather information from this status transition for just the Resolver at this time. In Progress Start both the Resolver and the Closer. In Progress To Do When in the In Progress status and the To Do transition is triggered, the user is moving the issue back in the workflow so we don't care to track anything from this specific transition for Root Cause Analysis plugin purposes. " In Progress When in the In Progress status and the In Progress transition is triggered, the user has not changed the status of the issue, so we don't care to track anything from this specific transition. '' In Review When in the In Progress status and the Start the In Review transition is triggered, the user performing the action is marking the issue as change complete. The Root Cause Analysis plugin will want to gather information from this status transition for just the Resolver at this time. '' Done When in the In Progress status and the Done transition is triggered, the user performing the action is both marking the issue as change complete and verification complete. The Root Cause Analysis plugin will want to gather information from this status transition for both the Resolver and the Closer. ''In Review To Do When in the In ProgressReview status and the To Do transition is triggered, the user is moving the issue back in the workflow so we don't care to track anything from this specific transition for Root Cause Analysis plugin purposes. Done" ReopenIn Progress When in the Done In Review status and the Reopen In Progress transition is triggered, the user is moving the issue back in the workflow just starting work so we don't care to ever track anything from this specific transition for Root Cause Analysis plugin purposes. '' Reopen and start progress" In Review When in the Done In Review status and the Reopen and start progress In Review transition is triggered, the user is moving has not changed the status of the issue back in the workflow , so we don't care to ever track anything from this specific transition for transition. " Done When in the In Review status and the Done transition is triggered, the user performing the action is marking the issue as verification complete. The Root Cause Analysis plugin purposeswill want to gather information from this status transition for just the Closer. '' Reopen and start reviewDone To Do When in the Done status and the Reopen and start review To Do transition is triggered, the user is moving the issue back in the workflow so we don't care to ever track anything from this specific transition for Root Cause Analysis plugin purposes. '' In Reviewprogress Done When in the In Review Done status and the Done In Progress transition is triggered,the user performing the action is marking the issue as verification complete. The Root Cause Analysis plugin will want to gather information from this status transition for just the Closermoving the issue back in the workflow so we don't care to ever track anything from this specific transition for Root Cause Analysis plugin purposes. '' Restart ProgressIn review When in the In Review Done status and theRestart Progress In Review transition is triggered, the user is just starting work moving the issue back in the workflow so we don't care to ever track anything from this specific transition for Root Cause Analysis plugin purposes. ''" To DoDone When in the In ReviewDone status and the To Do Done transition is triggered, the user is moving has not changed the status of the issue back in the workflow, so we don't care to track anything from this specific transition for Root Cause Analysis plugin purposes. Based on the analysis above, we will need to add workflow post functions to five different transitions. Moving down the list from the top, lets add our post functions to the Done transition within the To Do step.
- Click on the Done link in the To Do row under the Transitions column.
- Click on the Post Functions tab. You now see the list of existing post functions for the transition.
- Click the Add post function link on the right hand side of the page. You are then presented with a list of available workflow post functions.
- Select Root Cause Analysis Resolver Saver and click Add
- The next screen is a generic configuration screen for post functions. There are no configurable options for the two Root Cause Analysis Post Functions. Click the Add button.
- You will now see the new post function appear at the top of the list of existing post functions for the transition.
- Repeat steps #12 through #15 to add the Root Cause Analysis Closer Saver post function to this transition.
- Click the RCT: Software Development Simplified Workflow for Project RCT (Draft) link (near the centre of the page, and will differ depending on the name of your workflow) to go back to the workflow table.
- Repeat steps above (from #10) for each of the other four status transitions determined from our analysis in the table above:
- Click on the Start In Review link in the To Do row under the Transitions column. Only add the Root Cause Analysis Resolver Saver post function.
- Click on the Start In Review link in the In Progress row under the Transitions column. Only add the Root Cause Analysis Resolver Saver post function.
- Click on the Done link in the In Progress row under the Transitions column. Add both the Root Cause Analysis Resolver Saver and the Root Cause Analysis Closer Saver post functions.
- Click on the Done link in the In Review row under the Transitions column. Only add the Root Cause Analysis Closer Saver post function.
- In order to save the changes you have made to the workflow. Click on the Publish Draft button. You can review the workflow first to ensure everything is correct before publishing.
- You will be prompted to save a backup copy of the original workflow before your changes. Do so if you wish.
- Click the Publish button.
...