Create
cancel
Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Next challenges

Recent achievements

  • Global
  • Personal

Recognition

  • Give kudos
  • Received
  • Given

Leaderboard

  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Jira and Jira Align Integration: Story Resolution Transition Best Practices

Best Practice #1:

The transition for the "Done" status of stories must have a Post Function of, "The Resolution of the issue will be set to Done."  This also applies to all custom issue types that are being mapped to a story type in Jira Align on the Custom Issues tab in the Jira connector.

Why:

This is needed to make sure the resolution date is set.  The connector uses the resolution date from Jira to mark the story as accepted in Jira Align.

Action to take:

Perform the following steps in Jira.

1.  Click on the Settings cog

2.  Select Issues

Screen Shot 2020-11-18 at 4.36.39 PM.png

3.  Click on Workflows

4.  Click View on the appropriate workflow

Screen Shot 2020-11-24 at 2.16.22 PM.png

5.  Click on the Done status in the Transition (id) column

Screen Shot 2020-11-24 at 2.20.25 PM.png

6.  Click the Post Functions tab

7.  Ensure there is an option listed for, "The Resolution of the issue will be set to Done."

Screen Shot 2020-11-24 at 2.25.18 PM.png

 

Use these steps if the Post Function isn't listed.

8.  Click Create Draft

Screen Shot 2020-11-24 at 3.22.14 PM.png

9.  Click "Done"

10.  Click the Post Functions tab

11.  Click Add post function

Screen Shot 2020-11-24 at 2.31.18 PM.png12.  Select the radio button for "Update Issue Field"

13.  Click Add

Screen Shot 2020-11-24 at 3.11.32 PM.png

14.  Select "Resolution" from the Issue Field dropdown

15.  Select "Done" from the Field Value dropdown

16.  Click Add

Screen Shot 2020-11-24 at 3.14.28 PM.png

17.  Click Publish Draft

Screen Shot 2020-11-24 at 3.39.36 PM.png

 

Best Practice #2:

The transition for all other statuses of stories in the workflow must have a Post Function of, "The value of field Resolution will be cleared."  This also applies to all custom issue types that are being mapped to a story type in Jira Align on the Custom Issues tab in the Jira connector.

Why:

If the issue is moved from a "Done" status to a previous status, the value in the Resolution needs to be cleared.  Since the connector uses the Resolution Date to mark the story as "Accepted" in Jira Align, if the Resolution is not cleared, the Resolution Date remains.  This will cause the stories to be out of sync between the two tools or the story may revert to a "Done" status in Jira and "Accepted" in Jira Align.

Action to take:

Follow the same steps above but select a non-"Done" status for Step 5.  Then pick up here with Step 7.

7.  Ensure there is an option listed for, "The value of field Resolution will be cleared."Screen Shot 2020-11-24 at 2.40.22 PM.png

 

Use these steps if the Post Function isn't listed.

8.  Click Create Draft

Screen Shot 2020-11-24 at 3.29.30 PM.png

9.  Click on Add post function

Screen Shot 2020-11-24 at 2.31.18 PM.png10.  Select the radio button for "Clear Field Value"

11.  Click Add

Screen Shot 2020-11-24 at 2.32.20 PM.png

12.  Select "Resolution" from the Field dropdown

13.  Click Add

Screen Shot 2020-11-24 at 2.32.44 PM.png

14.  If Post Function is added, click Publish Draft at the top

Screen Shot 2020-11-24 at 2.57.38 PM.png

5 comments

Thanks @Rae Gibbs great article setting out all of the steps.  Jira Align at the story level does not have a story mapping and relies on the resolution date.   Make sure this is true for all Jira Story, Task, defect, custom issue types that get treated as a Jira Align Story (albeit of subtype). 

Like # people like this
Rae Gibbs Atlassian Team Nov 24, 2020

@Richard Wilson Good callout!  I updated the article with that additional info.

Like Richard Wilson likes this
Allan Silva Atlassian Team Nov 30, 2020

Great article, thanks for sharing at such a detailed level.

Like # people like this
Rae Gibbs Atlassian Team Nov 30, 2020

@Allan Silva Thanks!  I struggle with not being an expert in Jira.  I know to tell Jira Admins what they need to do but haven't had the knowledge to provide them with direction on how to do it.  I figured if this helps me, it will probably help others.

Like # people like this

This FAQ suggests that the Jira issue's Resolution field must be set or cleared by workflow post-functions; however, it is possible to prompt the user to specify a particular Resolution via the Resolved Issue Editing Screen.  I have been told that prompting for a Resolution will break the integration between Jira and Jira Align.  Please confirm whether this is the case, or whether it is possible for the Jira user to set a specific Resolution value via the "Resolved issue editing screen".

Comment

Log in or Sign up to comment
TAGS
Community showcase
Published in Jira Align

Best Practices in Jira Align

Hello Jira Align customers! In order to better serve you on your journey with Jira Align, the Community team has worked with the Jira Align team to curate the content in this collection to better s...

946 views 1 13
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you