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

Mapping States, Steps, and Statuses between Jira Align and Jira Software

Objective

Configure Jira Align to allow issue state transitions made in Jira Software to be reflected as desired in Jira Align and vice-versa.

Prerequisites

  • Jira Software integration is in place and issues are syncing with Jira Align bidirectionally

  • Jira Align Value Stream defines Backlog Kanban Process Steps

Background

It is important that Program and Portfolio users of Jira Align and Teams using Jira Software have a consistent view of work item status. For example, your business process may work as follows:

  • Program Team using Jira Align moves a Feature into the “Backlog” column on the Program Backlog Kanban Process Step view to reflect that it is ready for work.

  • Teams using Jira Software see that the corresponding Jira Epic is ready for work and update the Epic status to “Implementing” as they begin their work.

  • The Program Team sees the progress of the Feature through implementation and delivery steps in Jira Align.

  • Jira Align reports roll up results across many Programs using standard Jira Align states that have been automatically updated along the way.

Jira Align offers two ways to manage the state of an issue, both of which can be mapped to corresponding Jira Software issue statuses:

  1. Jira Align State: Default, non-customizable, system-defined statuses

  2. Jira Align Value Stream Process Step: Configurable, user-defined custom steps

 

Screen Shot 2020-04-20 at 7.01.28 AM.png

 

Description

Choose the direction of mapping desired and follow the instructions.

Jira Software Status to Jira Align State
  1. Navigate to Jira Administration>Jira Settings>State Mapping

  2. Select Feature (or another Jira Align issue type that syncs with Jira Software) from the Type dropdown to see a list of statuses in available Jira Projects

  3. Select one of the out of the box Jira Align States from the dropdown for each Jira State that is used

  4. Click Save to cause the Jira Align State to be automatically updated when the Status on the corresponding Jira Software issue is changed

Note: The first Jira Align State, “0 - Pending Approval” for Features and Stories, is the default value. Reset fields to this default value to remove a previously set mapping.

          Screen Shot 2020-04-20 at 7.28.00 AM.png

Jira Align State to Jira Software Status
  1. Navigate to Jira Administration>Jira Settings>Manage Projects

  2. Click State Mapping for the desired Project

  3. Select Feature (or another Jira Align issue type that syncs with Jira Software) from the dropdown to see the list of out of the box Jira Align states
  4. Select one of the Jira States within the selected Jira Project for each Jira Align State
  5. Click Update to cause the Jira Software issue status to be automatically updated when the State on the corresponding Jira Align issue is changed

          Screen Shot 2020-04-20 at 7.31.27 AM.png

Jira Software Status to Jira Align Value Stream (Backlog Kanban Column View) Process Step
  1. Navigate to Jira Administration>Jira Settings>Manage Projects

  2. Click Manage Custom Fields

  3. Select work item hierarchy Level in the first section called Sync Process Steps with Jira States

  4. Select Value Stream which was used to define the Jira Align Process Steps to see a list of statuses available in Jira Projects

  5. Select one of the Process Steps for each Jira Status that is used

  6. Click Update Steps to cause the Process Step of the Jira Align issue to be automatically updated when the corresponding Jira Software Issue is changed

          Screen Shot 2020-04-20 at 7.21.47 AM.png

Jira Align Value Stream (Backlog Kanban Column View) Process Step to Jira Software Status
  1. Navigate to Jira Administration>Jira Settings>Manage Projects
  2. Click State Mapping for the desired Project

  3. Click Process Step
  4. Select Kanban level (e.g. Feature)
  5. For each Process Step, select the corresponding Jira State (Jira Software Status)
  6. Click Update

Note: Currently, this mapping must be enabled with a feature toggle by Jira Align Support or Services.

Note: For all the Projects you configure Jira Align to Jira Developmental Process Step Mapping on you will need to default the Jira Align to Jira State Mapping to "Select One". If you fail to default the Jira Align to Jira State Mappings to "Select One" Statuses between the two applications will become out of sync.

Note: For all of the Programs that will sync Process Steps from Jira Align to Jira the "Developmental Process Step" field will need to be added to the corresponding work item screen under Jira Align Admin > Details Panel Settings.

          Screen Shot 2020-04-20 at 7.34.36 AM.png

Jira Align Value Stream (Backlog Kanban Column View) Process Step to Jira Align State

  1. Navigate to Portfolio>Value Streams

  2. Select the Value Stream to map for which Process Steps have been defined

  3. Click the Map to State toggle

  4. Select the Jira Align State which maps to each Process Step
  5. Click Save to cause the Jira Align State for issues to be automatically updated when the Process Step of the issue is is changed

Note: This mapping is bidirectional and immediate, but only if updated In Jira Align. It has no effect if the Jira Align State or Process Step is modified by another Jira SW state mapping.

          Screen Shot 2020-04-20 at 7.37.15 AM.png

Output and Summary Notes

  • Status updates for issues in Jira Software will be reflected in Jira Align states and process steps and vice-versa.

  • Mapping Jira Align States or Process Steps and Jira Software Statuses in only one direction will result in confusing behavior.
  • When an issue has been resolved in Jira Software, Jira Align updates will no longer have an effect in Jira Software and will be reverted in Jira Align.  The Resolution status must be cleared in Jira if such a change is desired.

  • Update times are dependent upon the “Timer on Jira Issues” that has been configured on the Admin>Jira Settings>Jira Setup page.

Related Materials

0 comments

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

2,661 views 2 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