Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 18

...

...


Panel
bgColor#f5f5f5
titleColor#ffffff
borderWidth0
titleBGColor#000000
titleJSU for Jira Server/Data Center

This is the documentation of JSU for Jira Cloud. If you are using JSU on Jira Server/Data Center,

...

you can find the documentation here.



Info

NOTE: This guide starts from the "Edit Workflow" screen of a chosen project. If you're not sure how to get to this page, follow the onboarding steps first on either: /wiki/spaces/JSUCLOUD/pages/27801900 or /wiki/spaces/JSUCLOUD/pages/1147633753


(tick) Keep your backlog clean by ensuring that parent issues are automatically closed when all of their sub-tasks are completed


↓ Follow the step-by-step guide below to see how to configure this automation in your Jira instance. ↓


Configure the post function

  1. If you haven't already, switch the workflow viewer into "Diagram View" and ensure you are in "Edit Mode". You can enter Edit Mode by selecting the "Edit" option towards the right of your workflow viewer. 

...


  1. Image Added

  2. We want to close parent issues when their' sub-tasks are done, so we need to add the rule specifically to when issues transition to the 
    Status
    colourGreen
    titleDONE
     status. Click on the arrow that points inwards to this status to show the transition rule menu.

    We want to add a post function to this transition, which runs an automation after the issue has been transitioned to the target status. Select "Post Functions" from the list which opens a new tab.

...


  1. Image Added

  2. In the Post Functions table - click "Add post function" to view all available post functions.

...


  1. Image Added

...


  1. Choose "Linked Transition (JSU)" and then click "Add" at the bottom of the screen.

...


  1. Image Added

  2. We want the parent to automatically close when the last sub-task is closed, so let's set

...

  1. "Trigger transition on all issues related as" to "Parent / Sub-Task > 

...

  1. Parent (Issue in Transition must be Sub-Task)".

...


  1. Image Added

  2. Now, we have to tell JSU which transition and in which workflow we want to transition the parent issue we just selected. As we want to keep this rule simple, we only want this rule to apply to issues in our "JSU" project. So for "Transition", we select the workflow that applies to our JSU project and the "Done" transition. This means any parent issues will be transitioned to 
    Status
    colourGreen
    titleDONE
     as part of the rule we're configuring.

...


  1. Image Added

...


  1. But remember, we only want the parent to be transitioned to 
    Status
    colourGreen
    titleDONE
     if ALL of its sub-tasks are also 
    Status
    colourGreen
    titleDONE
    . To configure this, for "

...

  1. All other sibling issues (for example linking to the target with the same link type) must have one of the following statuses" we're going to set this as "Done".

...


  1. Image Added

  2. The remaining fields are optional. For your reference though we can talk about how you might want to use the remaining fields. If you're happy as is, feel free to proceed to Step #9.
    1. Resolution - If you would like to add a resolution to the parent issue after the post function closes it, you can define which resolution to choose in this field.
    2. Perform as user - In Jira Cloud, all "actions" both manual and automated, must be performed by a registered Atlassian account. If you'd like JSU to impersonate another user to run its automation, you can choose that user here. It's important to note that the impersonated user must have the right account privileges to perform the action. If you're not sure, just leave this field blank. Leaving the field blank means the automation will be run as the "JSU add-on user" which has elevated privileges and can perform most functions.
    3. Copy field - If you'd like to add more information to the parent issue as part of the automation, you can describe what information you'd like to add here.

...



  1. Now you're ready to save your new post function. To do this, click "Add" at the bottom of the page.

    Image Added

  2. You can now see a summary of all your post functions applied to this transition. To confirm this new workflow and test it out, you need to publish it. At the top of the screen click "Publish Draft" and then either "Yes" or "No" if you'd like to save a backup of the workflow before our changes are applied, followed by "Publish" again. 

...


  1. Image Added

Test the post function in the workflow

Now we can go test the post function in action!

  1. Head to an open issue that has one or more open sub-tasks within it.

...


  1. Image Added

  2. Now proceed to transition all of the subtasks to 
    Status
    colourGreen
    titledone
    .

...


  1. Image Added

  2. Now refresh/reload the parent issue. You'll notice that it has now also been transitioned to 
    Status
    colourGreen
    titledone
     - which means our post function has worked as expected!

...


  1. Image Added

  2. Congratulations! You've just configured your very own automation! (star)

Feel free to continue exploring other use cases for this

...

Post-Function, such as "Close parent Epic when all the issues within the Epic are done" and more!


Need more information or help? Get in touch!