Update team slicer article

AB#53177: Add a team slicer to a Power BI report

Author: KathrynEE

docs/report/powerbi/includes/rename-query.md

@@ -8,7 +8,7 @@ ms.date: 12/08/2022
 
 ## (Optional) Rename query 
 
-You can rename the default query label, *Query1* to something more meaningful by opening the menu for the query and selecting **Rename**.  
+You can rename the default query label, *Query1*, to something more meaningful. Simply enter a new name from the **Query Settings** pane.  
 
 :::image type="content" source="../media/transform-data/rename-query.png" alt-text="Screenshot of Power BI query menu options, rename query. ":::
 

docs/report/powerbi/media/reports-boards/sprint-burndown-clustered-column-chart.png

@@ -96,6 +96,7 @@ The following table describes each part of the query.
    **Description**
    :::column-end:::
 :::row-end:::
+---
 :::row:::
    :::column span="1":::
    `$apply=filter(`

docs/report/powerbi/media/reports-boards/team-slicer-visualizations.png

@@ -38,7 +38,6 @@ The queries in this section show how to generate burndown charts of work items b
 
 ### Burndown of User Stories in an area path from start and end date
 
-
 The following query shows you how to return historical data of User Stories for a release based on work items tagged with a release tag. 
 
 > [!NOTE]  
@@ -415,13 +414,7 @@ Prior to creating the report, you'll need to expand columns that return records
 - `AssignedTo` 
 
 To learn how to expand work items, see [Transform Analytics data to generate Power BI reports](transform-analytics-data-report-generation.md#expand-columns). 
-
-## Power BI transforms
-
-[!INCLUDE [temp](includes/sample-expandcolumns.md)]
-
-[!INCLUDE [temp](includes/sample-finish-query.md)]
-
+ 
 
 ## Create the clustered column chart  
 
@@ -435,7 +428,7 @@ Power BI shows you the fields you can report on.
 
 	:::image type="content" source="media/reports-boards/release-burndown-visualizations.png" alt-text="Screenshot of Power BI Visualizations and Fields selections for Release burndown clustered column chart report. ":::
 
-1. Add the `DateValue` to **X-Axis** and right-click `DateValue` and select `DateValue`, rather than `Date Hierarchy`   
+1. Add `DateValue` to **X-Axis**, right-click and select `DateValue`, rather than `Date Hierarchy`   
 
 1. Add `Count` to **Y-Axis**. 
 

docs/report/powerbi/media/transform-data/rename-query.png

@@ -31,6 +31,8 @@ To learn more about burndown and burnup, and [Burndown and burnup guidance](../d
 
 ## Sample queries
 
+Burndown charts require querying the `WorkItemSnapshot` entity set to get historical data.  
+
 [!INCLUDE [temp](includes/query-filters-work-items.md)]
 
 ### Burndown User Stories for an area path and the current iteration
@@ -264,8 +266,7 @@ https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/Wor
 
 * * *
 
-### Burndown User Stories for all sprints since the start of a year  
-### All Sprints since the beginning of the year
+### Burndown User Stories for all sprints since the start of a year   
 
 You may want to view a burndown of all the sprints in a single report. These queries pulls in sprint burndowns, and their by story points, for all  sprints since the beginning of year 2022.
 
@@ -373,38 +374,32 @@ https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/Wor
 [!INCLUDE [temp](includes/rename-query.md)]
 
 
-## Power BI transforms
-
-[!INCLUDE [temp](includes/sample-expandcolumns.md)]
+## Transform data in Power BI
 
-[!INCLUDE [temp](includes/sample-finish-query.md)]
+Prior to creating the report, you'll need to expand columns that return records containing several fields. In this instance, you'll want to expand the following records: 
+- `Area`
+- `Iteration`
+- `AssignedTo` 
 
+To learn how to expand work items, see [Transform Analytics data to generate Power BI reports](transform-analytics-data-report-generation.md#expand-columns). 
+ 
 
-## Create the report
+## Create the stacked column chart report
 
-1. In Power BI, choose the **Line chart** report under **Visualizations** and select the fields as shown in the following image. 
+1. In Power BI, choose the **Stacked column chart** report under **Visualizations** and select the fields as shown in the following image. 
 
 	:::image type="content" source="media/reports-boards/sprint-burndown-visualizations.png" alt-text="Screenshot of Power BI Visualizations and Fields selections for Sprint Burndown report. ":::
- 
-For a simple report, do the following steps:
 
-1. Select Power BI Visualization **Clustered column chart**. 
-1. Add the field "DateValue" to **Axis**
-    - Right-click "DateValue" and select "DateValue", rather than Date Hierarchy
-1. Add the field "TotalStoryPoints" to **Values**
-1. Add the field "Count" to **Values**
+1. Add `DateValue` to **X-Axis**, right-click and select `DateValue`, rather than `Date Hierarchy`   
 
-The example report, which displays burndown on both Story Points and Count of Stories.
+1. Add `Count` to **Y-Axis**. 
 
+1. Add `State` to **Y-Axis**. 
 
-:::image type="content" source="media/reports-boards/sprint-burndown-clustered-column-chart.png" alt-text="Screenshot of Sample Power BI Sprint burndown clustered column chart report.":::
-
-
- 
+The example report, which displays burndown on both Story Points and Count of Stories.
 
-## Full list of sample reports
 
-[!INCLUDE [temp](includes/sample-fulllist.md)]
+:::image type="content" source="media/reports-boards/sprint-burndown-clustered-column-chart.png" alt-text="Screenshot of Sample Power BI Sprint burndown clustered column chart report.":::
 
 ## Related articles
 

docs/report/powerbi/report - Shortcut.lnk

@@ -8,7 +8,7 @@ ms.author: kaelli
 author: KathrynEE
 ms.topic: sample
 monikerRange: '>= azure-devops-2019'
-ms.date: 10/05/2021
+ms.date: 12/08/2022
 ---
 
 
@@ -30,7 +30,7 @@ Often Power BI reports include data from multiple teams for aggregation and comp
 
 ## Sample queries
 
-You'll need to add another query to your Power BI report. The query below returns the mapping between Teams and Area Paths.
+To use a team slicer in a Power BI report, you'll need to add another query to your Power BI report. The query below returns the mapping between teams and Area Paths.
 
 #### [Power BI query](#tab/powerbi/)
 
@@ -83,6 +83,7 @@ The following table describes each part of the query.
    **Description**
    :::column-end:::
 :::row-end:::
+---
 :::row:::
    :::column span="1":::
    `$filter=startswith(AreaPath, '{areapath}')`
@@ -96,24 +97,23 @@ The following table describes each part of the query.
    `&$select=AreaSK, AreaPath`
    :::column-end:::
    :::column span="1":::
-   Returning Area Path fields, to use for mapping
+   Return Area Path fields, to use for mapping.
    :::column-end:::
 :::row-end:::
 :::row:::
    :::column span="1":::
    `&$expand=Teams($select=TeamName)`
    :::column-end:::
    :::column span="1":::
-   Returning the Team associated with the Area Path
+   Return the team associated with the Area Path.
    :::column-end:::
 :::row-end:::
 
 
-[!INCLUDE [temp](includes/query-filters-work-items.md)]
-
-## Power BI transforms
 
-### Expand the Teams column
+[!INCLUDE [temp](includes/rename-query.md)]
+ 
+##  Expand the Teams column
 
 1. Choose the expand button.
 
@@ -129,79 +129,34 @@ The following table describes each part of the query.
 
     > [!div class="mx-imgBorder"] 
     > ![Table will now contain entity field(s).](media/odatapowerbi-expandteam3.png)
-
-[!INCLUDE [temp](includes/sample-finish-query.md)]
+ 
 
 ## Create a Relationship using "AreaSK"
 
 After selecting Close & Apply, and returning to Power BI, follow these steps:
 
-1. Select **Modeling** menu
-1. Select **Manage Relationships**
+1. From the **Modeling** menus, select **Manage Relationships**.
 1. Create a relationship between your Report query and the Teams query. It's likely that Power BI will autodetect and create the relationship for you. Here's an example of a relationship between the query in the [Open Bugs](sample-boards-openbugs.md) report and the Teams query:
 
     > [!div class="mx-imgBorder"] 
     > ![Example of relationship between queries.](media/odatapowerbi-timeslicer-relationships.png)
     
 ## Add the Team Filter to an existing report
 
-Power BI shows you the fields you can report on. 
-
-> [!NOTE]   
-> The example below assumes that no one renamed any columns. 
-
-> [!div class="mx-imgBorder"] 
-> ![The example assumes that no one renamed any columns.](media/odatapowerbi-timeslicer-fields.png)
+1. On the page you want to add the team filter to, make sure no charts are selected, and then choose **Slicer** from the **Visualizations** pane. 
 
-To add a team filter to the Power BI report, follow these steps:
+	:::image type="content" source="media/reports-boards/team-slicer-visualizations.png" alt-text="Screenshot of Power BI Visualizations and Fields selections for team slicer. ":::
 
-1. Select Visualization **Slicer**
-1. Add the "Team.TeamName" field to **Field**
+1. Add `Team.TeamName` to **Field**.
 
+<!---
 The example below shows the [Open Bugs](sample-boards-openbugs.md) report with a Team filter added. Selecting a team in the slicer filters the results of the Open Bugs report. It will work for any report, as long as its query returns AreaSK.
 
 > [!div class="mx-imgBorder"] 
 > ![Team Slicer report](media/odatapowerbi-timeslicer-report.png)
 
-## Additional queries
-
-You can use the following additional queries to create different but similar reports. You can use these queries with the steps defined above.
-
-### Filter by Teams, rather than Area Path
-
-This query is the same as the one used above, except it filters by Team Name rather than Area Path. 
-
-#### [Power BI query](#tab/powerbi/)
-
-[!INCLUDE [temp](includes/sample-powerbi-query.md)]
-
-```
-let
-   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v1.0/Areas?"
-        &"$filter=(Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) "
-            &"&$select=AreaSK,AreaPath "
-            &"&$expand=Teams($select=TeamName) "
-    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
-in
-    Source
-```
-
-#### [OData query](#tab/odata/)
-
-[!INCLUDE [temp](includes/sample-odata-query.md)]
-
-```
-https://analytics.dev.azure.com/{organization}/{project}/_odata/v1.0/Areas?
-        $filter=(Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname})
-            &$select=AreaSK,AreaPath
-            &$expand=Teams($select=TeamName)
-```
-
-***
-
-## Full list of sample reports
-
-[!INCLUDE [temp](includes/sample-fulllist.md)]
+-->
+ 
 
 ## Related articles
 

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

@@ -87,6 +87,8 @@ items:
     href: transform-analytics-data-report-generation.md
   - name: Create a Power BI report
     href: create-report.md
+  - name: Add a team slicer to a report
+    href: sample-boards-teamslicer.md
 - name: Sample reports, Boards
   items:
   - name: Open bugs
@@ -108,8 +110,6 @@ items:
     displayname: CFD
   - name: Lead/Cycle time
     href: sample-boards-leadcycletime.md
-  - name: Add a team slicer
-    href: sample-boards-teamslicer.md
 - name: Sample reports, Pipelines
   items:
   - name: Outcome summary

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

@@ -186,6 +186,7 @@ For easier reporting, replace nulls with zero by following these steps.
 
 ### Create a percentage complete computed column
 
+Prior to adding the percentage complete column, make sure that you replace all null values in the pivoted state columns.
 1. Select **Add Column** menu.
 1. Select **Custom Column**.
 1. Enter **PercentComplete** for **New column name**.
@@ -197,8 +198,8 @@ For easier reporting, replace nulls with zero by following these steps.
 	:::image type="content" source="media/reports-boards/custom-column-dialog-percent-complete.png" alt-text="Custom Column Dialog, PercentComplete syntax.":::
 
     > [!NOTE]
-    > It is possible you won't have a **Resolved** column, if the work items don't have States mapped to the Resolved State Category. 
-    > If so, then omit "[Resolved]" in the above formula.
+    > It's possible that you won't have a **Resolved** column, if the work items don't have States mapped to the *Resolved* workflow state category. 
+    > If so, omit "[Resolved]" in the above formula.
 
 1. Press **OK**.
 1. Select **Transform** menu.