Skip to content

Commit 893b22f

Browse files
committed
Merged main into live
2 parents 2e3f8e6 + 0b07541 commit 893b22f

20 files changed

+185
-590
lines changed

.openpublishing.redirection.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7186,6 +7186,10 @@
71867186
{
71877187
"source_path": "docs/organizations/accounts/get-list-of-organizations-connected-to-azure-active-directory.md",
71887188
"redirect_url": "/azure/devops/organizations/accounts/get-list-of-organizations-connected-to-microsoft-entra-id"
7189+
},
7190+
{
7191+
"source_path": "docs/boards/backlogs/set-up-your-backlog.md",
7192+
"redirect_url": "/azure/devops/boards/backlogs/create-your-backlog"
71897193
}
71907194
]
71917195
}

docs/boards/backlogs/configure-your-backlog-view.md

Lines changed: 82 additions & 114 deletions
Large diffs are not rendered by default.

docs/boards/backlogs/create-your-backlog.md

Lines changed: 67 additions & 140 deletions
Large diffs are not rendered by default.

docs/boards/backlogs/display-rollup.md

Lines changed: 20 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,37 @@
11
---
22
title: Display rollup columns to show progress, counts, or totals in Azure Boards
33
titleSuffix: Azure Boards
4-
description: Learn how to add or remove the rollup column displays that show progress or totals of hierarchical items in Azure Boards.
4+
description: Learn how to add rollup columns that automatically sum child work item values to display progress bars, counts, and totals on parent items in Azure Boards.
55
ms.service: azure-devops-boards
66
ms.topic: how-to
77
ms.author: chcomley
88
author: chcomley
99
ai-usage: ai-assisted
10-
monikerRange: '>= azure-devops-2020'
11-
ms.date: 09/16/2024
10+
monikerRange: '<= azure-devops'
11+
ms.date: 07/01/2025
12+
# customer intent: As a team member, I want to display rollup columns that automatically sum child work item values so that I can track progress, counts, and totals across my backlog hierarchy.
1213
---
1314

1415
# Display rollup progress or totals in Azure Boards
1516

16-
[!INCLUDE [version-gt-eq-2020](../../includes/version-gt-eq-2020.md)]
17+
[!INCLUDE [version-lt-eq-azure-devops](../../includes/version-lt-eq-azure-devops.md)]
1718

18-
This article provides an overview of rollup functionality in Azure DevOps, explaining how rollup sums values of select fields for all child work items of a parent. Rollup is commonly used for estimated or completed work, effort, size, or story points. However, rollup of Effort, Story Points, or Size fields across product and portfolio backlogs isn't supported. This article also guides you through the steps to implement rollup functionality in various contexts such as product and portfolio backlogs, sprint Planning pane, sprint backlogs, and taskboards.
19-
20-
In the following example, **Progress by Work Items** displays progress bars for parent work items based on the percentage of closed descendant items. For Epics, descendant items include all child Features and their child or grandchild work items. For Features, descendant items include all child User Stories and their child work items.
19+
Rollup automatically sums child work item values to display totals on parent items. Use it to track work estimates, effort, size, or story points across your backlog hierarchy. Learn how to add rollup columns to backlogs, sprint planning, and taskboards.
2120

2221
> [!IMPORTANT]
23-
> - Rollup data supports progress bars, counts of work items, and sums of numeric fields within a project. Child items linked to a different project aren't included in the parent rollup calculations.
24-
> - Links to test cases or test artifacts aren't included in rollup calculations, as these items are linked using test-specific link types.
22+
> - Rollup supports progress bars, work item counts, and numeric field sums within a project only
23+
> - Cross-project child items and test case links aren't included in rollup calculations
24+
> - Rollup of Effort, Story Points, or Size fields isn't supported across product and portfolio backlogs
25+
26+
In the following example, **Progress by Work Items** shows progress bars based on the percentage of closed descendant items. For Epics, this includes all child Features and their descendants. For Features, this includes all child User Stories and their descendants.
27+
2528
> [!div class="mx-imgBorder"]
2629
> ![Screenshot of Progress bars showing rollup by work items.](media/rollup/progress-by-work-items.png)
2730
2831
::: moniker range="azure-devops"
2932

3033
> [!NOTE]
31-
> You can view rollup progress in the new version of Delivery Plans, now available in public preview for Azure Boards. This feature is integrated into Azure Boards and is no longer an extension. To enable it, see [Manage or enable features](../../project/navigation/preview-features.md) and turn on **New Delivery Plans Experience**. For more information, see [Review team Delivery Plans](../plans/review-team-plans.md).
34+
> Rollup progress is available in the new Delivery Plans (public preview). Enable **New Delivery Plans Experience** in [preview features](../../project/navigation/preview-features.md). For more information, see [Review team Delivery Plans](../plans/review-team-plans.md).
3235
3336
::: moniker-end
3437

@@ -97,15 +100,16 @@ Each user can customize their column options, and these settings persist across
97100

98101
Open a portfolio backlog and select **In Progress Items** and **Completed Child Items**. This allows you to compare the State value of items with the rollup value.
99102

100-
![Screenshot shows opening column options.](media/rollup/view-in-progress-and-completed-items.png)
103+
> [!div class="mx-imgBorder"]
104+
> ![Screenshot shows opening column options.](media/rollup/view-in-progress-and-completed-items.png)
101105
102106
2. Select **Column options**, or select the :::image type="icon" source="../../media/icons/actions-icon.png" border="false"::: actions icon and then select **Column options**.
103107

104108
> [!div class="mx-imgBorder"]
105109
> ![Choose Column options and then select Column options.](media/rollup/open-column-options.png)
106110
107111
> [!TIP]
108-
> The Column options you select apply to the chosen backlog level and will persist across your sessions until you change them.
112+
> The Column options you select apply to the chosen backlog level and persists across your sessions until you change them.
109113
110114
## Add a rollup column
111115

@@ -114,8 +118,7 @@ Each user can customize their column options, and these settings persist across
114118
> [!div class="mx-imgBorder"]
115119
> ![Screenshot of Column options dialog.](media/rollup/add-rollup-column-from-quick-list.png)
116120
117-
> [!NOTE]
118-
> The menu options vary based on the process chosen for your project, the selected backlog level, and whether the **Show parents** view option is enabled.
121+
The menu options vary based on the process chosen for your project, the selected backlog level, and whether the **Show parents** view option is enabled.
119122

120123
For example, the following image shows that the Count of Tasks for the parent user stories is 2 and 4, respectively. The Count of Tasks for the parent Feature and Epic is 6.
121124

@@ -167,14 +170,14 @@ Use the following methods to get rollup data:
167170

168171
## Analytics, latency, and error states
169172

170-
Rollup data gets calculated from the Analytics service. When dealing with a large amount of data, you might experience some latency in displaying rollup. Hover over the :::image type="icon" source="../../media/icons/rollup.png" border="false"::: rollup icon to determine the state of the data.
173+
Rollup data is calculated from the Analytics service. Large datasets may cause display latency. Hover over the :::image type="icon" source="../../media/icons/rollup.png" border="false"::: rollup icon to check data status.
171174

172-
If an error occurs in retrieving rollup data, you see an :::image type="icon" source="../../media/icons/info.png" border="false"::: info icon and empty rows. Errors indicate when the Analytics data was last updated, meaning the Analytics services are still processing changes that might affect rollup calculations. Once the Analytics data is up to date, the rollup columns refresh with the latest data.
175+
Errors appear as an :::image type="icon" source="../../media/icons/info.png" border="false"::: info icon with empty rows, indicating the Analytics service is still processing recent changes. Rollup columns refresh automatically once processing completes.
173176

174177
> [!div class="mx-imgBorder"]
175178
> ![Screenshot showing Error getting data.](media/rollup/error-getting-data.png)
176179
177-
For more information about the service, see [What is Analytics?](../../report/powerbi/what-is-analytics.md).
180+
For more information, see [What is Analytics?](../../report/powerbi/what-is-analytics.md).
178181

179182
## Change the column order or remove a rollup column
180183

docs/boards/backlogs/filter-backlogs-boards-plans.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ Filter functions are available from all Azure Boards tools: Work items, Boards,
5454

5555
The following table indicates the supported options based on the tool indicated with a ✔️ or is listed.
5656

57-
Backlogs and boards are subject to filters defined for the team as described in [Set up your Backlogs and Boards](set-up-your-backlog.md). Other tools have predefined filters based on the view, query filter clauses, or settings you select.
57+
Backlogs and boards are subject to filters defined for the team as described in [Create and manage your backlog](create-your-backlog.md). Other tools have predefined filters based on the view, query filter clauses, or settings you select.
5858

5959
:::row:::
6060
:::column span="1.5":::
@@ -507,7 +507,7 @@ Along with the standard filter functions summarized in the previous table, the f
507507

508508

509509
**Notes**
510-
1. The **Work items** page is subject to filters based on the [view selected](../work-items/view-add-work-items.md#view-work-items). **Boards** and **Backlogs** are subject to filters defined for the team as described in [Set up your Backlogs and Boards](set-up-your-backlog.md). Completed and In Progress work items get determined based on the state categories assigned to the workflow state as described in [How workflow states and state categories are used in Backlogs and Boards](../work-items/workflow-and-state-categories.md#category-states).
510+
1. The **Work items** page is subject to filters based on the [view selected](../work-items/view-add-work-items.md#view-work-items). **Boards** and **Backlogs** are subject to filters defined for the team. Completed and In Progress work items get determined based on the state categories assigned to the workflow state as described in [How workflow states and state categories are used in Backlogs and Boards](../work-items/workflow-and-state-categories.md#category-states).
511511
2. Grouping is supported through portfolio backlogs and boards, parent-child links, and tree hierarchy. Tree hierarchies are flattened when filtering is applied and reinstated when filtering is cleared.
512512
3. **Backlogs** and **Sprint Backlogs** support reordering. However, when filtering is enabled, reordering isn't supported.
513513
4. **Taskboards** provides a **Group by** function based on **People** or **Stories**.
@@ -753,7 +753,7 @@ For more information, see [Query work item history and discussion fields](../que
753753

754754
## Related articles
755755

756-
- [Set up your Backlogs and Boards](set-up-your-backlog.md)
756+
- [Create and manage you backlog](create-your-backlog.md)
757757
- [About backlogs](backlogs-overview.md#work-with-multi-team-ownership-of-backlog-items)
758758
- [Change column options](set-column-options.md)
759759
- [Display rollup progress or totals](display-rollup.md)

docs/boards/backlogs/manage-issues-impediments.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ Define tasks when you want to create a [checklist of tasks](../boards/add-task-c
6464
::: moniker range="<azure-devops"
6565

6666
> [!NOTE]
67-
> If your project collection uses the On-premises XML process model to customize work tracking, you can enable work item types that you add to the Task Category to appear as a checklist on your product board. To learn how, see [Set up your backlogs and boards, Customize your board checklist items](set-up-your-backlog.md#customize-checklist-2019).
67+
> If your project collection uses the On-premises XML process model to customize work tracking, you can enable work item types that you add to the Task Category to appear as a checklist on your product board.
6868
6969
::: moniker-end
7070

-118 KB
Loading

docs/boards/backlogs/resolve-backlog-reorder-issues.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -156,5 +156,5 @@ A: No, not at this time. You can always check the entire list of items assigned
156156

157157
## Related articles
158158

159-
- [Set up your backlogs and boards](set-up-your-backlog.md)
159+
- [Create and manage your backlog](create-your-backlog.md)
160160
- [Learn about Kanban boards](../boards/kanban-overview.md)

0 commit comments

Comments
 (0)