Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020
可以使用 Open Data Protocol （OData） 查询生成 Power BI 报表。 对于 Azure DevOps 中的各种服务，示例查询可用于生成许多常用报表。 本文概述了示例报表，并演示如何开始使用它们。
示例报表
以下文章提供了生成示例报表的查询和步骤。
Azure Boards
Azure 测试计划
Azure Pipelines
Azure Pipelines 测试
所有示例报表文章都提供以下部分和信息：
- 示例查询 - 用于将数据拉取到 Power BI 和其他示例查询的 Power BI 查询和原始 OData 查询
- 有关在 Power BI 中转换数据的部分 - 通过展开列或更改列数据类型将数据转换为可报告格式的步骤
- 创建报表 - 从数据创建基本报表的步骤
| 类别 | 要求 |
|---|---|
| 访问级别 |
-
项目成员。 - 至少 基本 访问权限。 |
| 权限 | 默认情况下，项目成员有权查询 Analytics 和创建视图。 有关服务和功能启用和常规数据跟踪活动的其他先决条件的详细信息，请参阅 访问 Analytics 的权限和先决条件。 |
运行 Power BI 查询
若要开始在 Power BI 查询中嵌入 OData 查询，请执行以下步骤。 可以直接将查询粘贴到 Power BI 中的高级编辑器中。
在 Power BI 中，选择“ 获取数据”，然后选择“ 空白查询”。
在 Power BI Power Query 编辑器中，选择 “高级编辑器”。
此时会打开高级编辑器窗口。
将内容替换为示例查询。 有关示例查询，请参阅本文前面列出的链接文章。
将查询中的任何占位符字符串替换为值：
-
{organization}- 组织名称。 -
{project}- 团队项目名称。 对于跨多个项目的查询，请完全省略/{project}。
某些示例查询包含还需要替换的其他占位符，例如以下字符串：
-
{areapath}- 区域路径，格式如下：Project\Level1\Level2 -
{iterationpath}- 迭代路径，格式如下：Project\Level1\Level2 -
{startdate}- 开始趋势报告的日期，格式如下：YYYY-MM-DDZ例如，2025-04-01Z表示 2025 年 4 月 1 日。 不要将日期括在引号中。
-
若要运行查询，请选择“ 完成”。
首次连接到帐户时，Power BI 要求你进行身份验证。 有关详细信息，请参阅 在 Power BI 或 Excel 中输入客户端凭据。
运行原始 OData 查询
除了 Power BI 查询，大多数示例报表还提供 OData 查询。 可以在 Power BI 中使用 OData 查询之前单独修改和测试该查询。 此方法提供更大的灵活性，但它涉及额外的步骤。 有关详细信息，请参阅 使用 Power BI 和 OData 查询连接数据。
有关如何针对 Analytics 数据编写 OData 查询的详细信息，请参阅 示例报表和快速参考索引。