Skip to content

Commit 1c3c1d7

Browse files
committed
Updates to feature progress report
AB#48647: Feature Progress rollup sample Power BI report (Power BI, New, Phase 3) AB#29135: CFD report AB#29140: Cycle time and lead time control charts - Azure DevOps Services
1 parent 2763a93 commit 1c3c1d7

13 files changed

+123
-200
lines changed

docs/report/powerbi/create-quick-report-odataq.md

+3-8
Original file line numberDiff line numberDiff line change
@@ -124,8 +124,7 @@ Power BI shows you the fields you can report on.
124124
> [!NOTE]
125125
> The example below assumes that no one renamed any columns.
126126
127-
> [!div class="mx-imgBorder"]
128-
> ![Sample - Boards Rollup - Fields](media/odatapowerbi-bugtrend-fields.png)
127+
:::image type="content" source="media/reports-boards/bug-trends-selections.png" alt-text="Screenshot of Power BI Visualizations and Fields selections for Bug trends report. ":::
129128
130129
For a simple report, do the following steps:
131130
@@ -138,13 +137,9 @@ For a simple report, do the following steps:
138137
139138
The example report:
140139
141-
> [!div class="mx-imgBorder"]
142-
> ![Sample - Boards Rollup - Report](media/odatapowerbi-bugtrend-report.png)
143-
144-
[!INCLUDE [temp](includes/sample-multipleteams.md)]
145-
146-
<a id="q-a"> </a>
147140
141+
:::image type="content" source="media/odatapowerbi-bugtrend-report.png" alt-text="Screenshot of Sample Bug trends line chart report.":::
142+
148143
## Next steps
149144
150145
> [!div class="nextstepaction"]

docs/report/powerbi/includes/query-filters-work-items.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,6 @@ ms.date: 12/05/2022
77
---
88

99
> [!NOTE]
10-
> To determine available properties for filter or report purposes, see [Metadata reference for Azure Boards](../analytics/entity-reference-boards.md). You can filter your queries or return properties using any of the `Property` values under an `EntityType` or `NavigationPropertyBinding Path` values available with an `EntitySet`. Each `EntitySet` corresponds to an `EntityType`. To learn more about the data type of each value, review the metadata provided for the corresponding `EntityType`.
10+
> To determine available properties for filter or report purposes, see [Metadata reference for Azure Boards](../../analytics/entity-reference-boards.md). You can filter your queries or return properties using any of the `Property` values under an `EntityType` or `NavigationPropertyBinding Path` values available with an `EntitySet`. Each `EntitySet` corresponds to an `EntityType`. To learn more about the data type of each value, review the metadata provided for the corresponding `EntityType`.
1111
1212

Loading
Loading
Loading
Loading

docs/report/powerbi/sample-boards-bugtrend.md

+12-25
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,9 @@ ms.date: 12/08/2022
1515

1616
[!INCLUDE [version-gt-eq-2019](../../includes/version-gt-eq-2019.md)]
1717

18-
This article shows you how to display, for a given set of open Bugs, the number of Bugs in each State, trended over a period of time. The following image shows an example of such a trend.
19-
20-
21-
:::image type="content" source="media/odatapowerbi-bugtrend-report.png" alt-text="Screenshot of Bug trends sample line chart report.":::
18+
Bug trend reports are useful to see how well a team is closing active bugs. This article shows you how to display the number of bugs in a given state over a period of time. The following image shows an example of a bug trends report.
2219

20+
:::image type="content" source="media/reports-boards/bug-trends-report.png" alt-text="Screenshot of Bug trends line chart report.":::
2321

2422

2523
[!INCLUDE [temp](includes/sample-required-reading.md)]
@@ -86,7 +84,7 @@ https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/Wor
8684
- `{organization}` - Your organization name
8785
- `{project}` - Your team project name, or omit "/{project}" entirely, for a cross-project query
8886
- `{areapath}` - Your Area Path. Example format: `Project\Level1\Level2`
89-
- `{startdate}` - The date to start your trend report. Format: YYYY-MM-DDZ. Example: `2019-04-01Z` represents 2019-April-01. Don't enclose in quotes.
87+
- `{startdate}` - Start your report for items completed on or after a given date with the format: `YYYY-MM-DDZ`. For example: `2022-04-01Z` represents 2022-April-01. Don't enclose in quotes.
9088

9189
<!--- How specify the end date? -->
9290

@@ -186,7 +184,7 @@ The following table describes each part of the query.
186184

187185

188186

189-
### Bug trends filtered by Teams
187+
### Bug trend filtered by Teams
190188

191189
You can query for bug trends by team name rather than Area Path.
192190

@@ -283,7 +281,7 @@ https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/Wor
283281

284282
<a id="weekly-snapshots" />
285283

286-
### Bug trends with a snapshot on the first of every month
284+
### Bug trend with a snapshot on the first of every month
287285

288286
Using a monthly snapshot reduces the amount of data pulled into Power BI, and increases query performance.
289287

@@ -336,50 +334,39 @@ https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/Wor
336334
[!INCLUDE [temp](includes/rename-query.md)]
337335

338336

339-
## Transform data in Power BI
340-
341-
342-
343-
### Expand columns in Power BI
337+
## Expand columns in Power BI
344338

345339
Expand the `Area/AreaPath)` and `Iteration/IterationPath` columns. Expanding the columns flattens the record into specific fields. To learn how, see [Transform Analytics data to generate Power BI reports](transform-analytics-data-report-generation.md).
346340

347341

348-
### (Optional) Rename fields
342+
## (Optional) Rename fields
349343

350344
Once you have expanded the columns, you may want to rename one or more fields. For example, you can rename the column `AreaPath` to `Area Path`. To learn how, see [Rename column fields](transform-analytics-data-report-generation.md#rename-column-fields).
351345

352346

353-
### (Optional) Rename query
354-
355-
You can the default query label, *Query1* to something more meaningful. To do so, see [Rename the query](transform-analytics-data-report-generation.md#rename-the-query).
356-
357-
358347
## Create the Line chart report
359348

360349
1. In Power BI, choose the **Line chart** report under **Visualizations** and select the fields as shown in the following image.
361350

362351
:::image type="content" source="media/reports-boards/bug-trends-selections.png" alt-text="Screenshot of Power BI Visualizations and Fields selections for Bug trends report. ":::
363352

364-
1. Add the field "**DateValue**" to **X-axis**.
365-
- Right-click **DateValue** and select **DateValue**, rather than **Date Hierarchy**.
353+
1. Add `DateValue`" to **X-axis**, and right-click `DateValue` and select `DateValue` rather than `Date Hierarchy`.
366354

367-
1. Add the field Count to **Y-axis**.
368-
- Right-click **Count** and ensure **Sum** is selected.
355+
1. Add `Count` to **Y-axis**, and right-click `Count` and ensure **Sum** is selected.
369356

370-
1. Add the State to **Legend**.
357+
1. Add `State` to **Legend**.
371358

372359
The example report displays.
373360

374-
:::image type="content" source="media/odatapowerbi-bugtrend-report.png" alt-text="Screenshot of Sample Bug trends line chart report.":::
361+
:::image type="content" source="media/reports-boards/bug-trends-report.png" alt-text="Screenshot of Sample Bug trends line chart report.":::
375362

376363
### Modify report format visuals
377364

378365
- To modify format elements of the report, choose the **Format your visual** (paintbrush) icon and modify one or more available settings. For example, you can modify the line colors used in the trend chart.
379366

380367
:::image type="content" source="media/reports-boards/bug-trends-change-color.png" alt-text="Screenshot of Power BI Format visual selections for Bug trends report. ":::
381368

382-
To learn more, see [Get started with the formatting pane](/power-bi/visuals/service-getting-started-with-color-formatting-and-axis-properties)
369+
To learn more, see [Get started with the formatting pane](/power-bi/visuals/service-getting-started-with-color-formatting-and-axis-properties).
383370

384371

385372
## Related articles

docs/report/powerbi/sample-boards-cfd.md

+7-7
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ https://analytics.dev.azure.com/{organization}/{project}/_odata/V3.0-preview/Wor
8181
- `{organization}` - Your organization name
8282
- `{project}` - Your team project name, or omit "/{project}" entirely, for a cross-project query
8383
* `{teamname}` - The name of the team to display CFD data
84-
* `{startdate}` - The date to start the CFD chart from. Format: YYYY-MM-DDZ. Example: `2019-04-01Z` represents 2019-April-01. Don't enclose in quotes.
84+
- `{startdate}` - Start your report for items completed on or after a given date with the format: `YYYY-MM-DDZ`. For example: `2022-04-01Z` represents 2022-April-01. Don't enclose in quotes.
8585

8686

8787
### Query breakdown
@@ -191,23 +191,23 @@ In the follow example, the query was renamed to *CFD*, but no columns were renam
191191
1. Add `DateValue` to **Axis** and then right-click `DateValue` and select `DateValue`, rather than `Date Hierarchy`.
192192

193193
1. Add `Count` to **Values**.
194-
2.
194+
195195
1. Add `ColumnName` to **Legend**.
196196

197-
1. In the Filters pane, expand `ColumnName`, and select only the values you want to appear on the chart. For example, you may want to unselect *New*, *Proposed*, *Done*, or *Closed*.
197+
1. In the **Filters** pane, expand `ColumnName`, and select only the values you want to appear on the chart. For example, you may want to unselect *New*, *Proposed*, *Done*, or *Closed*.
198198

199199
:::image type="content" source="media/reports-boards/cfd-columnname-filters.png" alt-text="Screenshot of Power BI Filters for ColumnName. ":::
200200

201201

202-
The example report displays the columns in alphabetic order.
202+
The example report displays the columns in alphabetic order. However, the preferred order is to sort the data according to the Kanban column order, or progressive order.
203203

204204
:::image type="content" source="media/reports-boards/cfd-stacked-area-chart.png" alt-text="Screenshot of Sample Power BI Cumulative Flow stacked area chart report, columns sorted in alphabetic order.":::
205205

206206
### Sort columns in progressive order
207207

208-
To sort the chart columns in the order specific on the board, do the following steps:
208+
To sort the chart columns in the order specific on the Kanban board, do the following steps:
209209

210-
1. Use the query below to create a new query in Power BI. When done, rename the query to *ColumnOrder*.
210+
1. Create a new query in Power BI per the following queries. When done, rename the query to *ColumnOrder*.
211211

212212
#### [Power BI query](#tab/powerbi/)
213213

@@ -249,7 +249,7 @@ https://analytics.dev.azure.com/{organization}/{project}/_odata/V3.0-preview/Boa
249249
1. Select **Column Tools** and then **Sort by Column** and choose `ColumnOrder`.
250250
:::image type="content" source="media/reports-boards/cfd-sort-by-column.png" alt-text="Screenshot of Power BI Column Tools, Sort by Column selection.":::
251251

252-
1. Select the **Modeling** menu, and then select **Manage Relationships**. Ensure there's a relationship between `CFD.ColumnName` and `ColumnOrder.ColumnName`. It's likely that the relationship was autodetected.
252+
1. Select the **Modeling** menu, and then **Manage Relationships**. Ensure there's a relationship between `CFD.ColumnName` and `ColumnOrder.ColumnName`. It's likely that the relationship was autodetected.
253253

254254
:::image type="content" source="media/reports-boards/cfd-manage-relationships-dialog.png" alt-text="Dialog for Manage Relationships showing a relationship between CFD.ColumnName and ColumnOrder.ColumnName":::
255255

0 commit comments

Comments
 (0)