Jira Align Sprint mappings for closed sprints show warning "Multiple Jira sprints are mapped to a single Jira Align team sprint"
Summary
When a Jira Project and Board is integrated to a Jira Align (JA) Program and Team, if there is a mismatch between the Sprint Anchors (Sync Dates) in the JA Program Increment (PI) and the dates of the actual sprints in the Backlog of the Jira Board, then this can result in more than one Jira Sprint being mapped to the same JA Sprint.
When this happens a review of Jira Align > Settings > Jira Management > Jira Sprints > choose Board shows a warning triangle against the affected sprints and hovering over this triangle displays the message:
"Multiple Jira sprints are mapped to a single Jira Align team sprint. Make sure only one Jira Sprint is mapped to each team sprint"
This message indicates that there may be reporting issues in JA as stories may be associated to the wrong JA Sprints.
If this condition is then not noticed for some time, resulting in a number of closed sprints (and possibly the current active sprint) being affected, then attempts to use partially automated methods (such as described in Sprint status fails to sync from Jira to Jira Align) may not work, and a fully manual method of correction may be needed.
The problem symptom itself is only seen when using the default Sprint Mapping logic (order based). The problem does not occur when using the newer Sprint Mapping logic (end date based)
Environment
Jira Align
Cause
- Mismatches between Jira Sprint Dates and Jira Align Anchor Dates cause invalid mappings into Jira Align
- Adjustments have been made to either the Jira Sprint Dates or Jira Align Sprints Anchors Dates after the initial mappings have been generated
In both cases, the issue has not been promptly identified / corrected, resulting in problems with Closed sprints going back some time.
Solution
The solution (manual method) can be broken down into 3 key sections (expand below to see the specific details):
Extra information / follow-up
If multiple Teams / Boards and Programs are affected, then repeat the steps as necessary for the other affected areas
To understand which Boards / Teams and are under which Program (and linked to Jira), use the following steps:
- Go to Jira Management > Jira Boards (default tab)
- Click the column heading for Jira Align Program and in the resulting dropdown, pick your Program by adding a checkmark in the box next to it
- Click anywhere in the background of the page page, that is not a link, and the page will refresh based on the selected program
- The resulting list shows all the Jira Boards and Jira Align Teams under that Program
- If the Jira Sprints column also contains a number, then you can click in that number to go directly to the Sprint Mappings for that Board/Team