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: Configure Custom Issue Type Mapping and Stories of Type Defect

Custom issue types in Jira can be mapped to Jira Align stories of select types.  

 

Mapping Custom Issue Types in Jira Align:

Navigate to Jira Align Admin section > Jira Settings > Custom Issue Types panel > Click Add and input the Name of any Custom Issue Types that you would like to synchronize with a Jira Align Story of the selected Type then select the matching Jira Align Story Type from its corresponding drop-down then click Save.  The selector toggles are used to select and Delete a Custom Issue Type. They do not need to be utilized when adding Custom Issue Types.

image.png

 

Defining Custom Issue Types in Jira Align:

Custom Story Types can be defined by navigating to Jira Align Admin > Platform > Dropdowns Panel > Story Type

 

image.png

 

Custom Issue Type Fields and Filtering

Custom Issue Types that are integrated with Jira Align will sync in the same manner as traditional Jira Stories except that the Jira Align type field on the Story will reflect what Type of Story was integrated.  The fields that sync between Jira and Jira Align on Stories and Custom Issue Types can be found here:

https://agilecrafthelp.zendesk.com/hc/en-us/articles/115000088393-10X-Jira-Data-Synchronization

Stories can be filtered in the Jira Align Stories Grid base off of the Type field as show below.

image.png

Stories of Type Defect

The Jira Align Defect has a separate Backlog than Jira Align Stories meaning that Jira Align Defects cannot be linked to Jira Align Features (Jira Epics) or have their Story Points vertically aggregate to the Enterprise Level.  More information can be read on the Jira Align defect here:

https://agilecrafthelp.zendesk.com/hc/en-us/articles/115002421607-10X-Create-Defects

Some organizations would rather be able to Link their Jira Bugs to Jira Epics and synchronize Story Points on Bugs from Jira to Jira Align so it makes more sense for them to sync Jira Bugs to Jira Align Stories of Type Defect instead of the native Jira Align Defect.  

If syncing the Jira Bug to the Jira Align Defect these fields should be populated under Jira Align Admin > Jira Settings > Jira Setup

image.png

If syncing the Jira Bug to the Jira Align Story of Type Defect the above fields should be left blank and the following fields should be populated under Jira Align Admin > Jira Settings > Custom Issue Types

image.png

The Jira Align Story of Type Defect will function as a normal Jira Align Story outside of having a Type Defect. If you original setup the connector to sync Jira Bugs to Jira Align Defects and wish to convert to Story of Type Defects you can null out the Bug to Defect mapping and populate the Custom Issue Type mapping then run a custom JQL to update all data.  Information on custom JQLs can be found here: 

https://community.atlassian.com/t5/Jira-Align-articles/Jira-and-Jira-Align-Integration-Jira-Query-Language-JQL-Best/ba-p/1260051

9 comments

Hello, thank you for the article! Wanted to let you know that I am unable to see the photos attached to this article.

missing photo.JPG

Like # people like this
Tim Keyes Atlassian Team Jan 06, 2020

Hi Esme,


Thank you for the note.  Can you please check again.  I have removed and readded the images.

 

Respectfully,

Tim Keyes

Like Shawn Kessler likes this

Hi Tim, 

I checked again and I am still unable to view the images.

Thanks,

Esmé

Tim Keyes Atlassian Team Jan 06, 2020

Hi Esme,

 

Can you please verify if you can see them now?

I was originally hosting the images internally on the Atlassian Network and have made them public through public hosting. 

Thank you for the assistance, it is greatly appreciated!


Respectfully,
Tim Keyes  

Like # people like this

Hi Tim,

Yes, I am able to see them now! 

Thanks,

Esmé

Peter Jessen Community Leader Jan 07, 2020

Hi @Tim Keyes,

Nicely written article. Of course, I didn't see it until after I wrote up this related one.

Cheers,
Peter

Like # people like this
FUN MAN ANDY Community Leader Jan 09, 2020

@Peter Jessen Never a bad thing to have as MUCH knowledge from different perspectives on Community. Nice job!! And great knowledge share! #KUDOS

Like # people like this

@Tim Keyes , how does align handle the resolution field in JIRA? I did not see even a reference to it.

Hi Reza,

Thank you for the question. 

Jira Align will treat the resolution differently for defects and stories.

Additional information can be found in this article:

https://community.atlassian.com/t5/Jira-Align-articles/How-to-Configure-State-Mappings-between-Jira-Software-and-Jira/ba-p/1253519

  • If a bug in Jira Software is in any status other than Resolved, the defect's status will be Open in Jira Align.
  • If a bug's Resolution is set to Done in Jira Software, the Defect will be set to Closed in Jira Align.
  • The Accepted state for stories is not configured on this panel, as the Accepted status from Jira Software to Jira Align is based off of the Accepted Date field.  The Accepted Date field is configured in the Jira Align Administration > Jira Settings > Jira Setup tab in the Custom Fields section.
  • A combination of Done + Resolution states in Jira Software is required in order to transition a story's state to Accepted in Jira Align.

Please let us know if you have any additional questions.

Cheers!
Tim

Comment

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

Virtual/Remote PI Planning Best Practices and FAQ Table of Contents

Due to recent challenges of most companies having to move to virtual and remote PI planning events, the Jira Align Solutions Architects wanted to start to capture some best practices and FAQ Table of...

3,578 views 3 31
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