为 Azure DevOps 创建分析小组件

  • 项目

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

可以生成自己的分析小组件，以在 Azure DevOps 中的仪表板中显示。 github 上的示例小组件演示了：

  • 如何呈现与工作项状态关联的趋势线
  • 如何查询数据集，但用户将通过小组件配置视图进行配置
  • 如何生成小组件并将其发布到 Azure DevOps 市场

利用此信息，你将能够创建自己的 Analytics 小组件。

具有小组件预览的配置视图

注意

Analytics 服务在生产环境中自动启用并支持所有Azure DevOps Services。 Power BI 集成 和对分析服务的 OData 源 的访问权限已正式发布。 我们鼓励你使用它并向我们提供反馈。 可用数据依赖于版本。 支持的最新版本为 v2.0，最新预览版本为 v4.0-preview。 有关详细信息，请参阅 OData API 版本控制。

注意

对于 Azure DevOps Server 2020 及更高版本的所有新项目集合，Analytics 服务在生产环境中自动安装并受支持。 Power BI 集成 和对分析服务的 OData 源 的访问权限已正式发布。 我们鼓励你使用它并向我们提供反馈。 如果从 Azure DevOps Server 2019 升级，则可以在升级期间安装 Analytics 服务。

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

注意

分析服务在 2019 Azure DevOps Server处于预览状态。 可以为项目集合 启用或安装它 。 Power BI 集成 和对分析服务的 OData 源 的访问处于预览状态。 我们鼓励你使用它并向我们提供反馈。

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

先决条件

此示例提供现成的小组件，涵盖仪表板、图表和分析中主题的基础知识。 以下文档提供了此示例中演示的详细信息的更多基础：

  1. 创建 Azure DevOps 小组件扩展，请参阅 小组件扩展示例
  2. 呈现 Azure DevOps 图表控件，参考 添加图表
  3. 从 Analytics 查询 OData

提供配置视图

  1. 运行用于配置视图的 UI 控件所需的简单分析查询。
  2. 使用基于用户操作的更新以及 Analytics 查询中的新数据来管理配置 UI 的状态。
  3. 使用 Typescript 和 React 呈现配置 UI。

在小组件中呈现数据

  1. 以 POST 请求的形式运行用户配置的查询
  2. 解释分析数据以 呈现图表

后续步骤

为了避免示例中过于复杂，我们省略了某些技术和做法，生产小组件当然应该包括这些技术和做法。 github 上的 ui-fabric-react 示例突出显示了执行这些详细信息的生成过程。

  1. JavaScript 捆绑和内容缩小 - 示例中的一组小型松散脚本文件在合并到单个文件中并缩小时可以更快地加载。
  2. 结构 UI 控件 - 结构 UI 控件为React提供了一组丰富的配置 UI 组件。