在 Azure DevOps 中创建分析视图

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

可以创建自定义分析视图来定义筛选的数据集和其他条件,以支持 Power BI 报告需求。 自定义视图可让你更灵活地使用筛选条件和加载到 Power BI 报表中的字段。

重要

分析视图仅支持Azure Boards数据 (工作项) 。 分析视图不支持其他数据类型,例如管道。 视图提供工作项的平面列表,不支持工作项层次结构。 目前,我们没有计划更新连接器以支持其他类型的数据。 有关其他方法的信息,请阅读 Power BI 集成概述

可以在 Azure DevOps 的 Web 门户中创建自定义视图,然后使用 Power BI 数据连接or 加载视图。 与工作项查询一样,可以创建仅供使用的视图,也可以与团队中的其他人共享。

注意

如果 Boards 处于禁用状态,则分析视图也会被禁用。 与工作项跟踪关联的所有小组件也会在小组件目录中禁用。 若要重新启用服务,请参阅 打开或关闭 Azure DevOps 服务

先决条件

  • 若要查看 Analytics 数据并查询服务,你需要是具有 基本 访问权限或更高访问权限的项目的成员。 默认情况下,向所有项目成员授予查询 Analytics 和定义 Analytics 视图的权限。
  • 若要了解有关服务和功能启用以及常规数据跟踪活动的其他先决条件,请参阅 访问 Analytics 的权限和先决条件

打开 Analytics 以访问视图

在 Web 门户中,选择 Boards>Analytics 视图。

如果未看到 Analytics 视图,检查有权查看 Analytics。 请参阅 访问 Analytics 的权限和先决条件

展开“Boards”中心并选择“分析”视图的屏幕截图,该视图被红色方块包围。

浏览视图

如下图所示,在“ 全部 ”页中,可以访问为项目定义的所有 Analytics 视图。 “我的视图 ”是只能使用或编辑的视图。 共享视图 是跨项目共享的视图。 团队中的任何人都可以在 Power BI 中连接和使用共享视图。

Analytics 视图目录

注意

默认分析视图列表的标签会有所不同,具体取决于创建团队项目时选择的过程-基本敏捷ScrumCMMI。 但是,除非明确提及,否则可用的基本功能保持不变。

若要收藏视图,请将鼠标悬停在该视图上,然后选择star图标。 收藏的视图显示在 “收藏夹 ”页面上。

创建自定义视图

选择 加号图标“新建视图 ”,打开用于创建自定义视图的对话框。 完成每个选项卡中提供的表单,以完全定义用于在 Power BI 中查看的数据的筛选条件。

完成以下步骤以创建自定义视图。

  1. 命名视图并选择共享选项
  2. 指定工作项筛选器
  3. 选择视图的字段
  4. 选择视图中包含的历史数据量
  5. 验证并保存视图

注意

看板字段(“板栏”、“板栏完成”和“板通道”)目前无法添加作为筛选器或选择进行查看。 定义功能请求以添加它们 ,即分析视图 - 向视图中可用字段列表添加板列

1.为视图命名并选择共享选项

输入视图的名称并提供说明。 若要允许其他人查看和使用“分析”视图,请选择 “共享” 选项。 使用共享视图时,可以设置对谁可以查看、编辑和删除视图的权限,如 管理 Analytics 视图中所述。

分析视图常规

2. 指定工作项筛选器

指定筛选器以减少视图返回的结果数。 在“工作项”部分中,可以对工作项字段添加不同的筛选器,以限定数据范围。 有关每个可用字段的说明,请参阅Azure Boards的实体和属性参考

指定工作项筛选器。

提示

确定数据范围以生成快速刷新的报表。 对于大型数据集,刷新未筛选的视图可能会失败。 若要缩小结果范围,请添加正确的筛选器集。 添加的筛选器越多,在 Power BI 中加载和刷新视图的速度就越快。

  • 添加 Teams 或区域路径筛选器

    默认情况下,视图包括当前项目中定义的所有团队。 可以专门选择当前项目中的团队,或将组织中定义的其他项目添加到筛选器。

    重要

    Microsoft 建议每个分析视图限制为 500 个项目。 如果需要 500 多个项目,可以创建其他 Analytics 视图并在视图之间分发项目。

    可以更改当前项目的所选团队,或将其他项目添加到筛选器。 还可以从团队筛选更改为区域路径。 下面是按两个 Fabrikam 区域路径筛选的视图。

    区域路径选取器示例

  • 为积压工作和工作项类型添加筛选器

    将数据范围限定为项目中的特定工作项类型。 可以指定积压工作,按与特定积压工作级别关联的工作项类型进行筛选,或添加单独的特定工作项类型。 视图中包含所选类型的工作项。

    工作项类型选取器

  • 按字段条件添加筛选器

    除了以前的所有筛选条件之外,还可以基于不同的工作项字段添加筛选器。 指定这些字段的方式与为添加到工作项查询的字段指定方式相同。 如以下示例所示,可以进行筛选以仅显示具有特定“修补程序”标记的高优先级 bug。

    按 Bug、优先级和标记筛选示例

    有关使用标记的详细信息,请参阅 添加工作项标记以对列表和板进行分类和筛选

    注意

    请务必了解如何将筛选器应用于历史数据。 有关详细信息,请参阅 应用于历史数据的筛选器。

3.选择要显示在报表中的字段

在下一个选项卡 “字段”中,可以添加和删除报表中使用的字段。 选择 加号图标“添加” 以添加字段。 若要从全新列表开始,请选择“ 全部删除”。

选择字段

可以添加通过继承的过程添加的任何自定义字段。

注意

不能添加数据类型为纯文本 (长文本) 或 HTML (格式文本) 的字段。 分析中不提供这些字段用于报告。

4.选择趋势数据选项

在下一个选项卡 “历史记录”中,选择用于确定从视图中获取多少历史记录数据的选项。

在此示例中,如果你有 10 个工作项并选择每周粒度为 14 天的滚动周期,则视图包含 30 行。 如果在周六刷新,则每个工作项的最后两个星期六有一行,周六的最新数据有一行。

“历史记录”选项卡,选择“历史记录”和“粒度”选项

历史记录

对于当前状态的快照,请选择“仅限当前”。 对于趋势图,请按指示选择其他选项之一。

选项 说明
仅限当前 如果希望快照工作项状态,请选择此选项。 为每个工作项生成与分析数据存储中工作项的最新值匹配的单个行。
滚动周期 选择此选项,并输入要包含在数据集中的当前日期之前的天数。 每次刷新报表时,滑动窗口都会更改。
日期范围 选择此选项并选择要包含在数据集中的特定开始日期和结束日期,或检查“要演示”复选框以指定没有固定结束日期的滚动窗口。 检查演示时,结束日期对应于报表刷新的日期。 如果取消选中,则结束日期始终是结束日期字段中选择的日期。
所有历史记录 选择此选项可包括筛选条件中选择的所有工作项的完整历史记录。 如果有重要的历史记录,请指定每周或每月粒度。

排除已关闭的项 - Analytics 存储所有工作项历史记录,包括已关闭工作项的任何修订。 因此,在分析视图中,如果选择滚动期为 14 天,则视图包括此时间段之前关闭的所有工作项的当前修订。 若要排除在特定日期之前完成的工作项,检查任何历史记录选项下的相应框。 它大大减少了加载到 Power BI 中的数据量,并有助于高级计算(如 状态时间 )提高性能。 对于滚动周期和日期范围,要排除的工作项的日期由周期的开始时间设置。 对于“仅当前历史记录”和“所有历史记录”,需要提供该日期。 例如,下图排除在 5 月 14 日之前完成的所有工作时间。

排除滚动 14 天的工作项

粒度

可以选择获取每天、每周或每月每个工作项的快照。 每一行表示基于定义间隔的最新修订的项。

选项 说明
每日 为每个工作项生成一行,显示每天的最新数据。
每周 为每个工作项生成一行,显示表示星期 (默认为星期六) 的星期几 (每周的数据。
每月 为每个工作项生成一行,显示每月最后一天的数据。

注意

5.验证并保存视图

最后一步通过针对视图运行测试查询并验证筛选条件来验证视图。 验证时间可能因视图中定义的数据量而异。 例如,包含所有工作项类型并指定 “所有历史记录”的视图比仅包含 bug 并指定滚动周期 30 天的视图花费更多时间进行验证。

提示

验证视图是一个重要步骤。 验证成功完成后,视图更有可能在 Power BI 中正确加载。 如果验证时间过长,则可以快速调整视图。 添加筛选器或缩小历史记录范围,然后再次验证视图。

视图成功验证后,保存它。 然后,可以在 Power BI 中开始使用它。

如果视图无法成功验证,则会出现一个错误,说明问题并指出可能修复的问题。 尝试更改定义并再次验证视图。 当视图成功验证时,你将获得视图中包含的行计数的估计。

成功验证

例如,如果尝试按不再为项目定义的字段进行筛选,则会收到错误。 可以轻松地从 “工作项 筛选器”选项卡中的筛选器中删除该字段,然后再次验证。

有关解决错误的详细信息,请参阅 解决与分析视图关联的错误

查看视图的筛选条件

从分析视图的 “收藏夹” 或“ 所有 ”页中选择任意视图,以查看视图定义和筛选器的 摘要 。 选择 “编辑” 链接以编辑视图。

“摘要”面板

后续步骤