Missing Done Issues in Advanced Roadmaps Plan - Jira Data Center

Summary

Some issues in a DONE status (status in which category is DONE) are missing an advanced roadmap plan, while they are visible from the board linked to the plan.

Example

• The SCRUM-14 issue is in the Done status (green-colored status):

  

• This issue is shown in the Board that is linked to the plan:

  

• However, this issue is missing from the plan:

  

Environment

Jira Software Data Center on any version from 8.0.0

Diagnosis

Empty Resolution field

• The issue that is missing is in a "green" status (status from the 'Done' category), but does not have a resolution set (the resolution field is set to unresolved)

• A way to find issues from the board that are missing from the plan because the resolution field is empty is to use the following JQL query:

  <Board_filter_JQL_Query> AND statusCategory = done AND resolution is empty

Empty Resolved Date

• The issue that is missing is in a "green" status (status from the 'Done' category), has a resolution set (the resolution field is set to a value), but has no resolution date (the Resolved field is missing from the Dates panel)

  

• Normally, if an issue is "correctly" resolved ( for example, via a workflow transition), both the Resolution field and the Resolved date field should have non-empty values

• A way to find issues from the board that are missing from the plan because the Resolved field is missing from the Dates panel is to use the following JQL query:

  <Board_filter_JQL_Query> AND statusCategory = done AND resolution is not empty AND resolutiondate is empty

Cause

Empty Resolution field

If an issue is in a status that is categorized as "Done" while the Resolution field is not set, such an issue will not appear in the plan view.

This behavior is expected by design, and there is an open feature request meant to change this behavior, which is tracked in the public ticket linked below:

• JSWSERVER-25116 - Plan should use Issue Resolution rather than Issue Status Category to determine when to remove issues

Empty Resolved Date

If an issue is in a status that is categorized as "Done" while the Resolution field is set but the Resolved field is empty, such an issue will not appear in the plan view.

This situation may happen if the Resolution field was set without using a workflow transition, but instead the Resolution field was set:

• Manually via an inline edit in the Jira issue view page (this is possible if the Resolution field was added to the Edit Issue screen, which we highly recommend against)

• Or by an automation rule using the Edit Issue action

  • If the Edit Issue action is used to set the Resolution Field, the Resolved date field will not be set

  • This behavior is tracked in the automation bug JIRAAUTOSERVER-960 - Setting resolution field as an edit issue action does not set the resolved date of issue

• Or via a custom script (for example, from a 3rd party app)

Solution

Empty Resolution field

Option 1: Add a post function to set the 'Resolution' field during a workflow transition

Modify the workflow transition that transitions to the completed status to automatically set the resolution field to a non-empty value by using the post-function Update Issue Field, and make sure to publish the workflow change.

Post-function details:

Post-function placement:

This workflow change will ensure that the resolution field is set the next time an issue is transitioned to that Done status, and therefore, the issue will show in the plan view.

For issues that have already been transitioned to that status prior to the workflow change, you can transition these issues to a different status, and then transition them back to that status in order to set their resolution field.

Option 2: Adding a Dark Feature to allow 'Unresolved' issues to be shown on Plans

If modifying the workflow is not an option, you can instead enable a dark feature to allow the plan view to show issues in a Done status without the resolution set.

Important note about this dark feature:

• This dark feature will only help with issues having an Empty Resolution Field

• This dark feature will have no impact on issues with an Empty Resolution Date

Here are the steps to enable this dark feature:

1. Log in as a Jira Admin

2. Go to the URL <Jira_BASE_URL>/secure/SiteDarkFeatures!default.jspa

3. Add the following dark feature

   com.atlassian.portfolio.issueloading.includeUnresolvedCompleted

4. Make sure that the dark feature is listed on the page

Empty Resolved Date

• If you use a Script to set an issue's Resolution field, you will need to fix the script to ensure that the Resolved Date field is also set. Please note that such customization falls outside of Atlassian Support Offerings.

• If you use a rule from Automation for Jira to set the Resolution Field, you will need to set the Resolution field in the Transition Issue action instead of in the Edit Issue action, as illustrated below:

  

• Further, Option 1 (Add a post function to set the 'Resolution' field during a workflow transition) for the Empty Resolution Field can be applied here as well. Setting the Resolution field via a workflow transition will ensure that the Resolved Date field is set.