Skip to content

Commit 1670775

Browse files
committed
add example status queries and charts
1 parent 1bda0a6 commit 1670775

8 files changed

+57
-10
lines changed

docs/boards/queries/example-query-charts.md

Lines changed: 57 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -67,14 +67,14 @@ Tips: Pie charts versus Query count; can quickly see the types of work items
6767

6868
## Maintain backlog hygiene
6969

70-
The following queries can help your team maintain a healthy backlog by ensuring that work is assigned Here are a few tasks to review periodically, usually at the beginning or end of a sprint. Review this list for what makes sense for your team and organization goals.
70+
The following queries can help your team maintain a healthy backlog by ensuring that work is assigned Here are a few tasks to review periodically, usually at the beginning or end of a sprint. Review this list for what makes sense for your team and organization goals. Substitute the Fabrikam Team for your team and add additional filters as needed.
7171

7272
:::row:::
7373
:::column span="1":::
74-
Query focus
74+
**Query focus**
7575
:::column-end:::
7676
:::column span="3":::
77-
Query clause
77+
**Query clauses**
7878
:::column-end:::
7979
:::row-end:::
8080
---
@@ -121,18 +121,65 @@ The following queries can help your team maintain a healthy backlog by ensuring
121121

122122
In the following image, all five query charts appear on a team dashboard. To add query charts to a dashboard, see [Add charts to a dashboard](../../report/dashboards/add-charts-to-dashboard.md#add-a-work-item-query-or-chart)
123123

124+
:::image type="content" source="media/example-queries/dashboard-backlog-hygiene-query-charts.png" alt-text="Screenshot of Dashboard with five query charts added.":::
124125

125-
:::image type="content" source="media/example-queries/dashboard-backlog-hygiene-query-charts.png " alt-text="Screenshot of Dashboard with five query charts added.":::
126126

127+
Alternatively, you can add query tiles that reference the same query and simply show the total count of work items. as shown in the following image. The query tile widget is a 1x1 tile, whereas the smallest query chart dashboard widget is 2x2. To add query tiles to a dashboard, see [Add widgets to a dashboard](../../report/dashboards/add-widget-to-dashboard.md).
127128

129+
:::image type="content" source="media/example-queries/dashboard-backlog-hygiene-query-tiles.png" alt-text="Screenshot of Dashboard with five query tiles added.":::
130+
128131
## Example status charts
129132

130-
- **Planned work**: How much work is represented in the backlog. A query that looks at work in the *New* or *Proposed* category state provides a snapshot of work in the backlog.
131-
- **Active bugs**: Agile teams monitor their bug or technical debt and set goals to maintain the total number under a specific number.
132-
- **Active bugs by assignment**: Monitor bugs assignments across a team to support load balancing.
133-
- Active bugs by state
134-
- **Tagged work items**: Monitor tagged work to ensure the team is meeting specific goals, milestones, or categories of work.
135-
- **Blocked work**: How much work is currently blocked? You can query blocked work using a tag or custom field.
133+
The following table provides some examples of status charts you can create and the queries behind them.
134+
135+
:::row:::
136+
:::column span="1":::
137+
**Query focus**
138+
:::column-end:::
139+
:::column span="3":::
140+
**Query clauses**
141+
:::column-end:::
142+
:::row-end:::
143+
---
144+
:::row:::
145+
:::column span="1":::
146+
**Planned work**: How much work is represented in the backlog. A query that looks at work in the *New* or *Proposed* category state provides a snapshot of work in the backlog.
147+
:::column-end:::
148+
:::column span="3":::
149+
:::image type="content" source="media/example-queries/query-backlog-work.png " alt-text="Screenshot of Query Editor, Backlog work, not closed or removed.":::
150+
:::column-end:::
151+
:::row-end:::
152+
:::row:::
153+
:::column span="1":::
154+
**Active bugs**: Agile teams monitor their bug or technical debt and set goals to maintain the total number under a specific number.
155+
:::image type="content" source="media/example-queries/query-active-bugs.png " alt-text="Screenshot of Query Editor, Active bugs.":::
156+
From this one query, you can create a chart based on assignment or state.
157+
:::image type="content" source="media/example-queries/chart-active-bugs-by-state.png " alt-text="Screenshot of query chart, Active bugs by state.":::
158+
:::image type="content" source="media/example-queries/chart-active-bugs-by-assignment.png " alt-text="Screenshot of query chart, Active bugs by assignment.":::
159+
:::column-end:::
160+
:::row-end:::
161+
:::row:::
162+
:::column span="1":::
163+
**Tagged work items**: Monitor tagged work to ensure the team is meeting specific goals, milestones, or categories of work.
164+
:::image type="content" source="media/example-queries/query-active-work-tagged-across-project.png " alt-text="Screenshot of Query Editor, Active work across projects tagged with Web.":::
165+
:::column-end:::
166+
:::row-end:::
167+
:::row:::
168+
:::column span="1":::
169+
**Blocked work**: How much work is currently blocked? You can query blocked work using a tag or custom field.
170+
:::image type="content" source="media/example-queries/query-active-work-tagged-as-blocked.png " alt-text="Screenshot of Query Editor, Active work tagged as blocked.":::
171+
:::column-end:::
172+
:::row-end:::
173+
174+
175+
<!---TIPS
176+
Not In operator
177+
Area Path
178+
Add a column field to
179+
Query charts are built off the fields used to construct the query or the column options specified for the query
180+
States applicable to your project may differ depending on the process used
181+
182+
-->
136183

137184

138185
## Example trend charts
Loading
Loading
Loading
Loading
Loading
Loading
Loading

0 commit comments

Comments
 (0)