查看 Analytics 报表或组件背后的 OData 查询

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022

支持多个内置 Analytics 报表和小组件。 可以按照本文中所述的步骤查看用于生成这些报表的 OData 查询。 然后,可以根据需要调整 OData 查询,以使用 Power BI 生成其他报表。

注意

Azure DevOps Services 中所有服务的生产中会自动启用并支持 Analytics 服务。 Power BI 集成和对 Analytics 服务 OData 源的访问已正式发布。 鼓励使用 Analytics OData 数据源并反馈您的意见。

可用数据依赖于版本。 OData API 的最新支持版本是 v2.0,最新的预览版本是 v4.0-preview。 有关详细信息,请参阅 OData API 版本控制

注意

Azure DevOps Server 2020 及更高版本的所有新项目集合在生产环境中都会自动安装并支持 Analytics 服务。 Power BI 集成和对 Analytics 服务 OData 源的访问已正式发布。 鼓励使用 Analytics OData 数据源并反馈您的意见。 如果从 Azure DevOps Server 2019 升级,可以在升级期间安装 Analytics 服务。

可用数据依赖于版本。 OData API 的最新支持版本是 v2.0,最新的预览版本是 v4.0-preview。 有关详细信息,请参阅 OData API 版本控制

有关内置 Analytics 报表和小组件的列表,请参阅关于仪表板、图表、报表、& 小组件基于 Analytics 数据的小组件

先决条件

类别 要求
访问级别 - 项目成员
- 至少具有基本访问权限。
权限 默认情况下,项目成员有权查询 Analytics 和创建视图。 有关服务和功能启用和常规数据跟踪活动的其他先决条件的详细信息,请参阅 访问 Analytics的权限和先决条件。

打开 Analytics 报表

打开你感兴趣的报表。 有关详细信息,请选择下面提供的链接之一。 如果你正在尝试获取与某个小组件相关的 OData 查询,建议创建一个仅显示该小组件的仪表板。

Boards 管道和测试
- 累积流量图(CFD)
- 冲刺燃尽
- 速度图表
- 生成测试结果
- 代码覆盖率
- 发布测试结果
- 跟踪测试要求
- 测试分析
- 测试失败
- 测试影响分析

打开浏览器的开发人员工具

F12 键打开浏览器的开发人员工具。 打开“网络”选项卡,向下滚动以查找具有 OData 查询的条目。 下表列出了所选报表的条目的开始文本。 双击该条目以打开 OData 查询。

报表 条目开头为
周期时间小组件 WorkItems?%24apply=filter
累积流图 BoardLocations?%24apply=filter
冲刺燃尽 BoardLocations?%24apply=filter
速度 Iterations?%24filter=Teams

示例 OData 查询,速度图表

以下语法表示用于设置为显示六个迭代周期的速度图表的 OData 查询。

{
  "@odata.context": "https://analytics.dev.azure.com/fabrikam/677da0fb-b067-4f77-b89b-f32c12bb8617/_odata/v4.0-preview/$metadata#Iterations(IterationSK,IterationName,StartDate,EndDate,IsEnded,IterationPath)",
  "value": [
    {
      "IterationSK": "5b25cc74-aeb3-4f13-8084-1e899d7383b5",
      "IterationName": "06_2022",
      "IterationPath": "FabrikamProject\\CY2022\\06_2022",
      "StartDate": "2022-06-01T00:00:00-07:00",
      "EndDate": "2022-06-30T23:59:59.999-07:00",
      "IsEnded": false
    },
    {
      "IterationSK": "a9219cb0-21c0-48f4-8c88-83d0ae3187db",
      "IterationName": "05_2022",
      "IterationPath": "FabrikamProject\\CY2022\\05_2022",
      "StartDate": "2022-05-01T00:00:00-07:00",
      "EndDate": "2022-05-31T23:59:59.999-07:00",
      "IsEnded": true
    },
    {
      "IterationSK": "8668264f-465d-4d69-b2b5-f5de742447d4",
      "IterationName": "04_2022",
      "IterationPath": "FabrikamProject\\CY2022\\04_2022",
      "StartDate": "2022-04-01T00:00:00-07:00",
      "EndDate": "2022-04-30T23:59:59.999-07:00",
      "IsEnded": true
    },
    {
      "IterationSK": "4933928f-3e08-4cf9-901a-13cc32201944",
      "IterationName": "03_2022",
      "IterationPath": "FabrikamProject\\CY2022\\03_2022",
      "StartDate": "2022-03-01T00:00:00-08:00",
      "EndDate": "2022-03-31T23:59:59.999-07:00",
      "IsEnded": true
    },
    {
      "IterationSK": "a690f087-bd77-42dc-b5aa-f34f64ed67b3",
      "IterationName": "02_2022",
      "IterationPath": "FabrikamProject\\CY2022\\02_2022",
      "StartDate": "2022-02-01T00:00:00-08:00",
      "EndDate": "2022-02-28T23:59:59.999-08:00",
      "IsEnded": true
    },
    {
      "IterationSK": "edae3d3e-4357-4bae-9e25-f01719f48bb7",
      "IterationName": "01_2022",
      "IterationPath": "FabrikamProject\\CY2022\\01_2022",
      "StartDate": "2022-01-01T00:00:00-08:00",
      "EndDate": "2022-01-31T23:59:59.999-08:00",
      "IsEnded": true
    }
  ]
}