Versions Compared

Key

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

...

  • Root Cause Analysis Resolver Saver - Used to save the JIRA user id as well as the date/time of a particular workflow status transition where the transition is causing an issue to be change complete.
  • Root Cause Analysis Closer Saver - Used to save the JIRA user id as well as the date/time of a particular workflow status transition where the transition is causing an issue to be verification complete.

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. 

Image Added

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.

Example Workflow Configuration

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...

  1. Start by clicking the Projects drop-down and select Create Project

  2. Select the Software Basic Software Development project type and click Next
    Image Removed
    Image Added

  3. 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.
    Image Removed
    Image Added

  4. Click Submit to finish project creation.

  5. You will now be on the project Overview Open Issues page. Click On the side navigation bar, click on the Project Administration cog Image Addedlink near located at the top bottom of the pagescreen.
    Image Removed
    Image Added

  6. 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.
    Image Removed
    Image Added

  7. You are now presented with the list of Workflow steps and their valid transitions for the projects workflow.Image Removed

    Image Added

  8. 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.

    Start
    Step NameTransitionTrack Data for ResolverTrack Data for CloserReasoning
    To DoTo Do(error)(error)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(error)(error)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(tick)(tick)(error)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 complete and 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(tick)(error)(tick)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 ProgressStart both the Resolver and the Closer.
    In ProgressTo Do(error)(error)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(error)(error)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(tick)(error)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(tick)(tick)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 ReviewTo Do(error)(error)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(error)(error)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(error)(error)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(error)(tick)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 reviewDoneTo Do(error)(error)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 ReviewprogressDone(error)(error)(tick)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(error)(error)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(error)(error)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.
  9. 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.

  10. Click on the Done link in the To Do row under the Transitions column.
    Image Removed
    Image Added

  11. Click on the Post Functions tab. You now see the list of existing post functions for the transition.
    Image Removed
    Image Added

  12. 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.
    Image Removed
    Image Added

  13. Select Root Cause Analysis Resolver Saver and click Add

  14. 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.



  15. You will now see the new post function appear at the top of the list of existing post functions for the transition.
    Image Removed
    Image Added

  16. Repeat steps #12 through #15 to add the Root Cause Analysis Closer Saver post function to this transition.

  17. 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.

  18. Repeat steps above (from #10) for each of the other four status transitions determined from our analysis in the table above:

    1. 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.
    2. 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.
    3. 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.
    4. Click on the Done link in the In Review row under the Transitions column. Only add the Root Cause Analysis Closer Saver post function.

  19. 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.



  20. You will be prompted to save a backup copy of the original workflow before your changes. Do so if you wish.
    Image Removed
    Image Added

  21. Click the Publish button.

The workflow is now completely configured to use the Root Cause Analysis plugin to its full potential!

...