The Work Tree (Bottom-Up View from Story) report provides an overview of progress on all work items in a selected PI, as well as a drill-down hierarchy of progress at each work item level. Release train engineers and portfolio managers can use this report to track progress of all work items in a PI. This report is generated by selecting a target PI and program.
- Use and configure the report
- Values displayed in the report
- How to interpret this report
Use and configure the report
The Work Tree report shows work filtered by one or more programs or portfolios, and one or more program increments. If you have not selected a program increment in the Configuration bar at the top of the page, a Program Increment dropdown displays.
You can use the work item expandable hierarchy without a selection in this dropdown. Select a PI in order to display dashboard for a program/portfolio and PI combination.
You can also change the type of Work Tree report you’re viewing through the Tree View dropdown:
Dashboard and expandable list
When one or more PIs are selected through the Configuration bar or the page’s dropdown, a dashboard displays for each PI. Click the plus sign to the left of a dashboard to access the expandable hierarchy of work items.
Each program selected displays as a section below the dashboard. Click the plus sign to the left of a program section to expand the list of work items. Epics will display as the top-level item in this view, as well as stand-alone features. You can then select plus signs on the left of each work item row to see child work items.
In the Work Tree, epics are ordered based on their program by PI rank. All child items are ordered based on the rank under their parent and this order matches the order set in the backlog. For example, capabilities and features are ordered here as they are under an epic in the backlog.
The Orphan Stories section displays any stories assigned to the PI that are not parented by a feature. When expanding the Orphan Stories section, the story progress meter changes and shows the overall progress of stories in the section.
You can use the Extra Configs button in the top-right corner to filter the work items displayed on the page by fields such as Theme, Epic, or Category.
Switch on the Show Health toggle to display the Health icons on epics inside the expandable hierarchy section.
Enter Health status
You can enter notes about an epic's perceived health by selecting the Health icons from an epic's row in the expandable hierarchy section. This will open a window where you can select from Red, Yellow, or Green color options and enter explanations for status for multiple health categories.
After you select Save & Close, the icons in the row will update their colors according to your selections. These icons also display on Status Reports that support epics.
Chart reset and legend
Select the Reset Charts button in the upper-right corner of the report to reset your view. This will clear all selections made in the Program Increment dropdown and restore any hidden entries in Dashboard sections.
Select the Legend icon to see descriptions for the color displayed as a dot on the icon next to each work item inside the expandable hierarchy section.
Data on this report can also be shared by creating a screenshot using the Capture button from the top-right corner of the page. This will create an image in a new browser tab.
Values displayed in the report
- Plus icon: Select this icon to display the expandable drill-down list of work items for programs selected in the Configuration bar.
- PI name: Select this link to open the PI’s Details panel.
- Days Left: Days remaining in the program increment, calculated between the current day and the end of the PI, not including weekends.
- % Story Points Accepted: Percentage of story points tied to the selected PI that are accepted.
- Epic Progress: The percentage of epics in the PI that are accepted.
- Capability Progress: The percentage of capabilities related to epics in the PI that are accepted.
- Feature Progress: The percentage of features in the PI that are accepted.
- Story Progress: The percentage of stories in the PI that are accepted; also shows the count of stories accepted. This includes points from stories that are assigned to the selected program and are related to an epic or a capability assigned to the selected PI. If a story is not assigned to the selected program, its points are not included in the calculations.
- Task Progress: The percentage of tasks in the PI that are accepted; also shows the count of accepted tasks.
- X icon: Select this icon to hide a section inside the dashboard. You can use the Reset Charts button at the top of the report to restore the view.
Expandable hierarchy of work items
- Plus icon: Select to expand the item’s row and display child work items.
- Work item icon: Indicates the type of work item in the row. Epics, capabilities, features, and stories each have a different icon. A colored dot displays in the top-right corner of each icon, indicating status. Select the Legend button at the top of the report for a description of what each color represents.
- Other icons: Various icons can be displayed to the left or right of a work item’s name:
- Plus sign : Indicates that an epic or feature is multi-program.
- Hierarchy icon : Indicates that the work item is assigned to a program different than the section being viewed.
- Links icon : Indicates that work item links exist. The icon with a left arrow indicates the item has one or more predecessors, while an icon with a left arrow indicates the item has one or more successors. Select the work item to open its Details panel, and select the View the Predecessors and Successors button from the Links tab to view the relationships between predecessors and successors. A predecessor is a work item that must be completed before the work item it is linked to. A successor is a work item that must be completed after the work item it is linked to.
- Chat icon : Displays only on stories. Select this icon to launch the Discussion window for a story, where you can enter a new post.
- Question mark : Displays when a work item is assigned to a different program increment than the one selected in the Configuration bar or page filters. These items are not included in counts in the dashboard section.
- Tag icon : Displays on features when tags are present. Hover on the icon to display the tag names.
- Work Item Name: The name of the work item; select a name to open the item’s Details panel. If an item is blocked, the text will display in red.
- Health: Epic health; click the group of icons to update the health status. The column is displayed when the Show Health toggle found in Extra Configs is switched on.
- Points: The sum of effort points from child stories.
- Items: A count of direct child items for the work item.
- Program progress: A roll-up of all story points associated with the program and PI.
- Work item progress: The percentage of story effort points accepted for the work item; the value is a roll-up of all points tied to the work item. Note that if a story does not have child tasks, the progress bar will show a percentage complete based on the status of the story.
How to interpret this report
The ideal dashboard has very little lag between story and task progress, with features not far behind. It is not unusual for epics to lag behind even further, because epics can span across multiple PIs. Pay particular attention to features to make sure they are not trailing the stories in progress; when feature progress is too far behind story progress, it indicates a prioritization problem for your stories--most likely working on stories for too many features at once. Minimizing the feature work in process allows you to finish individual features before moving on to more stories. In the Backlog, use the Rank Stories by Features option to get a baseline prioritization for stories. A Work in Process Report is also available to help you understand where a bottleneck is impacting feature progress.
Expandable hierarchy of work items
When running a report for multiple programs at once, compare the progress bars to see which programs are lagging behind in completing work items.
Review the progress of epics, features, stories, and tasks, using the drill-down function in the report, to gain insight into which work items are lagging behind or being completed on schedule. From here, you can also access the work items directly to edit if needed, such as splitting features, prioritizing work items, or reducing scope.
Join the Atlassian Community!
The Atlassian Community is a unique, highly collaborative space where customers and Atlassians come together. Ask questions and get answers, start discussions, and collaborate with thousands of other Jira Align customers. Visit the Jira Align Community Collection today.
Need to contact Jira Align Support? Please open a support request.