You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This article shows you how to display the Stories CFD for a specified team. An example is shown in the following image.
18
+
This article shows you how to display the Stories CFD for a specified team. This data is also available through the built-in chart and dashboard widget. To learn more about these options, see [View and configure a Cumulative Flow Diagram](../dashboards/cumulative-flow.md).
An example is shown in the following image that shows a count of user stories over time in the *Researching*, *Committed*, *In Progress*, and *In Review* states. Hovering over a date provides information on data for that date.
21
+
22
+
:::image type="content" source="media/reports-boards/cfd-stacked-area-chart-sorted.png" alt-text="Screenshot of Power BI Cumulative Flow stacked area chart report, columns sorted in Kanban board column order.":::
23
+
24
+
To learn more about cumulative flow, see [Cumulative flow, lead time, and cycle time guidance](../dashboards/cumulative-flow-cycle-lead-time-guidance.md) and [Cumulative flow, lead time, and cycle time guidance](../dashboards/cumulative-flow-cycle-lead-time-guidance.md).
Queries in this section support returning cumulative flow data for User Stories. These queries specify the `WorkItemBoardSnapshot` entity set as they return data calculated for the Kanban board over time.
@@ -92,55 +101,55 @@ The following table describes each part of the query.
92
101
`$apply=filter(`
93
102
:::column-end:::
94
103
:::column span="1":::
95
-
Start filter()
104
+
Start `filter()` clause.
96
105
:::column-end:::
97
106
:::row-end:::
98
107
:::row:::
99
108
:::column span="1":::
100
109
`Team/TeamName eq '{teamname}'`
101
110
:::column-end:::
102
111
:::column span="1":::
103
-
Return items for a specific team
112
+
Return items for a specific team.
104
113
:::column-end:::
105
114
:::row-end:::
106
115
:::row:::
107
116
:::column span="1":::
108
117
`and BoardName eq 'Stories'`
109
118
:::column-end:::
110
119
:::column span="1":::
111
-
Return items on the 'Stories' backlog. You can specify other backlog names, such as 'Epics', and 'Features'
120
+
Return items on the **Stories** backlog. You can specify other backlog names, such as **Epics** or **Features**. Specify the backlog level that corresponds to the process selected for your project.
112
121
:::column-end:::
113
122
:::row-end:::
114
123
:::row:::
115
124
:::column span="1":::
116
125
`and DateValue ge {startdate}`
117
126
:::column-end:::
118
127
:::column span="1":::
119
-
Start CFD on or after the specified date. Example: **2019-04-01Z** represents 2019-April-01 2019-July-01
128
+
Return data on or after the specified date, for example, **2022-04-01Z** represents 2022-April-01 2019-July-01.
Group by DateValue (used for trending), ColumnName, and any other fields you want to report on. Here we include LaneName to enabling filtering by LaneName
152
+
Group by `DateValue` (used for trending), `ColumnName`, and any other properties you want to report on. Here we include `LaneName` to enabling filtering by swimlanes.
144
153
:::column-end:::
145
154
:::row-end:::
146
155
:::row:::
@@ -156,50 +165,49 @@ The following table describes each part of the query.
From the Power Query Editor, choose the query with the data you want to transform. For a CFD chart, you'll want to
180
+
expand columns such as `Area`, `Iteration`, and `AssignedTo`.
181
+
To learn how, see the following sections in [Transform Analytics data to generate Power BI reports, Expand columns](transform-analytics-data-report-generation.md#expand-columns).
In the follow example, the query was renamed to *CFD*, but no columns were renamed.
173
186
174
-
## Create the report
187
+
1. In Power BI, choose the **Stacked area** chart under **Visualizations** and select the fields as shown in the following image.
175
188
176
-
Power BI shows you the fields you can report on.
189
+
:::image type="content" source="media/reports-boards/cfd-visualizations.png" alt-text="Screenshot of Power BI Visualizations and Fields selections for CFD chart report. ":::
190
+
191
+
1. Add `DateValue` to **Axis** and then right-click `DateValue` and select `DateValue`, rather than `Date Hierarchy`.
177
192
178
-
> [!NOTE]
179
-
> The example below assumes that no one renamed any columns.
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*.
183
198
184
-
For a simple report, do the following steps:
199
+
:::image type="content" source="media/reports-boards/cfd-columnname-filters.png" alt-text="Screenshot of Power BI Filters for ColumnName. ":::
185
200
186
-
1. Select Power BI Visualization **Stacked Area Chart**.
187
-
1. Add the field "DateValue" to **Axis**
188
-
- Right-click "DateValue" and select "DateValue", rather than Date Hierarchy
189
-
1. Add the field "ColumnName" to **Legend**
190
-
1. Add the field "Count" to **Values**
191
-
1. On the Filter for "ColumnName", select only the values you want to appear on the chart. For example, you may want to unselect "New" and "Done"
192
201
193
-
The example report:
202
+
The example report displays the columns in alphabetic order.
:::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.":::
197
205
198
-
### Sorting columns in correct order
206
+
### Sort columns in progressive order
199
207
200
-
The above sample will display columns in alphabetical order. To sort the columns in the order specific on the board, do the following steps:
208
+
To sort the chart columns in the order specific on the board, do the following steps:
201
209
202
-
1. Use the query below to create a new query in Power BI. When done, rename the query to "ColumnOrder"
210
+
1. Use the query below to create a new query in Power BI. When done, rename the query to *ColumnOrder*.
1. Once back in Power BI, expand ColumnOrder query and select ColumnName.
240
-
1. Select **Modeling** menu.
241
-
1. Select **Sort by Column** and choose "ColumnOrder".
242
-
1. Select **Manage Relationships** and ensure there's a relationship between "CFD.ColumnName" and "ColumnOrder.ColumnName".
243
-
- It's likely that the relationship was autodetected.
244
-
1. In the report created above, add "ColumnOrder.ColumnName" to **Legend**, replacing "CFD.ColumnName".
247
+
1. In Power BI, expand the *ColumnOrder* query and select `ColumnName`.
245
248
246
-
The report will now be sorted by correct column order:
249
+
1. Select **Column Tools** and then **Sort by Column** and choose `ColumnOrder`.
250
+
:::image type="content" source="media/reports-boards/cfd-sort-by-column.png" alt-text="Screenshot of Power BI Column Tools, Sort by Column selection.":::
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.
250
253
251
-
> [!NOTE]
252
-
> If any work items were in a column that has since been deleted, they will appear as "Blank" in the above report.
254
+
:::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"":::
253
255
254
-
### Pull in data from multiple teams
256
+
1. In the report created above, in the **Legend**, replace `CFD.ColumnName` with `ColumnOrder.ColumnName` to **Legend**.
255
257
256
-
If you're pulling data in from multiple teams to aggregate across teams, you must ensure every team in the report has exactly the same set of columns on their boards. Otherwise, you're pulling in varying columns from every team. It's also a good idea to add a **Slicer** Visualization to your report, with Team.TeamName as a field. This step allows quick filter of the report by team.
258
+
The report refreshes with columns sorted in the same order used by the Kanban board.
257
259
260
+
:::image type="content" source="media/reports-boards/cfd-stacked-area-chart-sorted.png" alt-text="Screenshot of Sample Power BI Cumulative Flow stacked area chart report, columns sorted in Kanban board column order.":::
258
261
259
-
## Full list of sample reports
260
262
261
-
[!INCLUDE [temp](includes/sample-fulllist.md)]
263
+
> [!NOTE]
264
+
> If any work items were in a column that has since been deleted, they will appear as "Blank" in the above report.
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).
Lead time and cycle time indicate how long it takes for work to flow through a team's development pipeline. Lead time measures the total time elapsed from the creation of work items to their completion. Cycle time measures the time it takes for a team to complete work items once they begin actively working on them.You can create lead time and cycle charts using the queries provided in this article.
18
+
You can create lead time and cycle charts using the queries provided in this article. Lead time and cycle time indicate how long it takes for work to flow through a team's development pipeline. Lead time measures the total time elapsed from the creation of work items to their completion. Cycle time measures the time it takes for a team to complete work items once they begin actively working on them.
19
19
20
-
The following image shows an example for average lead time.
20
+
The following image shows an example for average lead time broken down by priority assignments made to the user stories.
21
21
22
-
:::image type="content" source="media/media/odatapowerbi-leadcycle-report.png" alt-text="Screenshot of Power BI Lead Cycle Time trend chart report.":::
22
+
:::image type="content" source="media/reports-boards/lead-time-trend-chart.png" alt-text="Screenshot of Power BI Lead Cycle Time trend chart report.":::
23
23
24
-
25
-
To learn more about lead time and cycle time, see [Cumulative flow, lead time, and cycle time guidance](../dashboards/cumulative-flow-cycle-lead-time-guidance.md) and [Cumulative flow, lead time, and cycle time guidance](../dashboards/cumulative-flow-cycle-lead-time-guidance.md).
24
+
To learn more about lead and cycle time, see [Lead Time and Cycle Time widgets](../dashboards/cycle-time-and-lead-time.md) and [Cumulative flow, lead time, and cycle time guidance](../dashboards/cumulative-flow-cycle-lead-time-guidance.md).
@@ -31,7 +30,7 @@ To learn more about lead time and cycle time, see [Cumulative flow, lead time, a
31
30
32
31
## Sample queries
33
32
34
-
Queries in this section support returning lead and cycle time data for completed User Stories. You can query by area path or team name(s).
33
+
Queries in this section support returning lead and cycle time data for completed User Stories. You can query by area path or team name(s). All of these queries specify the `WorkItems` entity set as they return data calculated for each work item by the Analytics service.
-`{project}` - Your team project name, or omit "/{project}" entirely, for a cross-project query
83
82
-`{areapath}` - Your Area Path. Example format: `Project\Level1\Level2`
84
-
-`{startdate}` - Start your report for items completed on/after a given date. Format: YYYY-MM-DDZ. Example: `2022-04-01Z` represents 2022-April-01. Don't enclose in quotes.
83
+
-`{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.
85
84
86
85
87
86
### Query breakdown
@@ -96,6 +95,7 @@ The following table describes each part of the query.
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).
199
+
[!INCLUDE [temp](includes/rename-query.md)]
204
200
205
201
## Transform data in Power BI
206
202
@@ -216,9 +212,9 @@ To learn how, see the following sections in [Transform Analytics data to generat
216
212
-[Transform a column data type](transform-analytics-data-report-generation.md#transform-data-type).
217
213
218
214
219
-
## Create the Line chart report
215
+
## Create the trend chart
220
216
221
-
The follow example assumes the query was renamed to LeadCycleTime and no one renamed any columns.
217
+
In the follow example, the query was renamed to *LeadCycleTime*, but no columns were renamed.
222
218
223
219
1. In Power BI, choose the **Line chart** report under **Visualizations** and select the fields as shown in the following image.
224
220
@@ -231,7 +227,7 @@ The follow example assumes the query was renamed to LeadCycleTime and no one ren
231
227
1. Add `Priority` to **Legend**.
232
228
233
229
234
-
The example report displays:
230
+
The example report displays. Note as you hover over any area in the report, additional data is shown.
235
231
236
232
:::image type="content" source="media/reports-boards/lead-time-trend-chart.png" alt-text="Screenshot of Sample Power BI Lead Cycle Time trend chart report.":::
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).
0 commit comments