在 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 数据连接器加载视图。 与工作项查询一样，可以创建仅供使用的视图，也可以与团队中的其他人共享。
注意
如果 Boards 处于禁用状态，则分析视图也会被禁用。 与工作项跟踪关联的所有小组件也会在小组件目录中禁用。 若要重新启用服务，请参阅 打开或关闭 Azure DevOps 服务。
先决条件
- Access：至少是具有基本访问权限的项目的成员。
- 权限： 默认情况下，项目成员有权查询 Analytics 和创建视图。
- 有关服务和功能启用和常规数据跟踪活动的其他先决条件的详细信息，请参阅 访问 Analytics 的权限和先决条件。
打开 Analytics 以访问视图
在 Web 门户中，选择 Boards>Analytics 视图。
如果未看到 Analytics 视图，请检查你是否有权查看 Analytics。 请参阅 访问 Analytics 的权限和先决条件。
浏览视图
如下图所示，在“ 全部 ”页中，可以访问为项目定义的所有 Analytics 视图。 “我的视图 ”是只能使用或编辑的视图。 共享视图 是跨项目共享的视图。 团队中的任何人都可以在 Power BI 中连接和使用共享视图。
若要将视图设为收藏夹，请将鼠标悬停在视图上并选择星形图标： 
收藏的视图将显示在 “收藏夹 ”页面上。
创建自定义视图
若要打开对话框以创建自定义视图，请选择“
新建”视图。 完成每个选项卡中提供的表单，以完全定义用于在 Power BI 中查看的数据的筛选条件。
完成以下步骤以创建自定义视图。
注意
板字段目前无法添加为筛选器或选择来查看。 这些字段包括 板列、 板栏完成和 板通道。 定义功能请求以添加它们 ，即分析视图 - 向视图中可用字段列表添加板列。
为视图命名并选择共享选项
输入视图的名称并提供说明。 若要允许其他人查看和使用“分析”视图，请选择 “共享” 选项。 使用共享视图时，可以设置对谁可以查看、编辑和删除视图的权限，如 管理 Analytics 视图中所述。
指定工作项筛选器
指定筛选器以减少视图返回的结果数。 在“工作项”部分中，可以对工作项字段添加不同的筛选器，以限定数据范围。 有关每个可用字段的说明，请参阅 Azure Boards Analytics 的元数据参考。
提示
确定数据范围以生成快速刷新的报表。 对于大型数据集，刷新未筛选的视图可能会失败。 若要缩小结果范围，请添加正确的筛选器集。 添加的筛选器越多，在 Power BI 中加载和刷新视图的速度就越快。
添加 Teams 或区域路径筛选器
默认情况下，视图包括当前项目中定义的所有团队。 可以专门选择当前项目中的团队，或将组织中定义的其他项目添加到筛选器。
重要
建议每个分析视图限制为 500 个项目。 如果需要 500 多个项目，可以创建其他 Analytics 视图并在视图之间分发项目。
可以更改当前项目的所选团队，或将其他项目添加到筛选器。 还可以从团队筛选更改为区域路径。 下面是按两个 Fabrikam 区域路径筛选的视图。
为积压工作和工作项类型添加筛选器
将数据范围限定为项目中的特定工作项类型。 可以指定积压工作，按与特定积压工作级别关联的工作项类型进行筛选，或添加单独的特定工作项类型。 视图中包含所选类型的工作项。
按字段条件添加筛选器
除了以前的所有筛选条件之外，还可以基于不同的工作项字段添加筛选器。 为添加到工作项查询的字段指定这些字段的方式相同。 如以下示例所示，可以进行筛选以仅显示具有特定“修补程序”标记的高优先级 bug。
有关使用标记的详细信息，请参阅 添加工作项标记以对列表和板进行分类和筛选。
注意
了解筛选器如何应用于历史数据非常重要。 有关详细信息，请参阅 Analytics 中的历史数据表示形式。
选择报表中显示的字段
在下一个选项卡中， “字段”可以添加和删除报表中使用的字段。 选择 “添加” 以添加字段。 若要从全新列表开始，请选择“ 全部删除”。
可以添加通过继承过程添加的任何自定义字段。
注意
不能添加数据类型为纯文本 (长文本) 或 HTML (格式文本) 的字段。 分析中不提供这些字段用于报告。
选择趋势数据选项
在下一个选项卡中， “历史记录”选择用于确定视图中可用的历史记录数据量的选项。
在此示例中，如果你有 10 个工作项并选择每周粒度为 14 天的滚动周期，则视图包含 30 行。 如果在周六刷新，则每个工作项的最后两个星期六有一行，周六的最新数据有一行。
历史记录
对于当前状态的快照，请选择“仅限当前”。 对于趋势图，请按指示选择其他选项之一。
| 选项 | 说明 |
|---|---|
| 仅限当前 | 如果希望快照工作项状态，请选择此选项。 为每个工作项生成与分析数据存储中工作项的最新值匹配的单个行。 |
| 滚动周期 | 选择此选项，并输入要包含在数据集中的当前日期之前的天数。 每次刷新报表时，滑动窗口都会更改。 |
| 日期范围 | 选择此选项并选择要包含在数据集中的特定开始日期和结束日期，或选择 显示 以指定没有固定结束日期的滚动窗口。 选择 显示时，结束日期对应于刷新报表的日期。 如果取消选中，则结束日期始终是结束日期字段中选择的日期。 |
| 所有历史记录 | 选择此选项可包括筛选条件中选择的所有工作项的完整历史记录。 如果你有重要的历史记录，请指定 每周 或 每月 粒度。 |
排除开始日期 之前完成的工作项 - Analytics 存储所有工作项历史记录，包括已关闭工作项的任何修订。 因此，在分析视图中，如果选择滚动期为 14 天，则视图包括此时间段之前关闭的所有工作项的当前修订。
若要排除在特定日期之前完成的工作项，请在历史记录的任何选项下选择相应的框。 它大大减少了加载到 Power BI 中的数据量，并帮助高级计算，例如 处于状态的时间。 对于滚动周期和日期范围，要排除工作项的日期由时间段的开始时间设置。 对于 “仅 当前”和 “所有”历史记录，需要提供该日期。 例如，下图排除在 2024 年 8 月 24 日之前完成的所有工作时间。
粒度
可以选择获取每天、每周或每月每个工作项的快照。 每一行表示基于定义间隔的最新修订的项。
| 选项 | 说明 |
|---|---|
| 每日 | 为每个工作项生成一行，其中显示每天的最新数据。 |
| 每周 | 为每个工作项生成一行，其中显示表示该周的某一天所获取的数据。 该值默认为星期六。 |
| 每月 | 为每个工作项生成一行，显示每月最后一天的数据。 |
注意
- 预览行是基于历史记录和粒度的计算值，可能与 Power BI 不匹配。
- 请务必了解如何将筛选器应用于历史数据。 有关详细信息，请参阅 Analytics 中的历史数据表示形式。
验证并保存视图
最后一步通过针对视图运行测试查询并验证筛选条件来验证视图。 验证时间可能因视图中定义的数据量而异。 例如，包含所有工作项类型的视图，并指定 “所有历史记录 ”需要的时间比仅包含 bug 的视图更耗时，并指定滚动周期为 30 天。
提示
验证视图是一个重要步骤。 验证成功完成后，视图更有可能在 Power BI 中正确加载。 如果验证时间过长，可以调整视图。 添加筛选器或缩小历史记录范围，然后再次验证视图。
查看成功验证后，保存它。 然后，可以在 Power BI 中开始使用它。
如果视图无法成功验证，则会出现一个错误，说明问题并指出可能修复的问题。 尝试更改定义并再次验证视图。 当视图成功验证时，你将获得视图中包括的行计数的估计值。
例如，如果尝试按不再为项目定义的字段进行筛选，则会收到错误。 可以从“工作项筛选器”选项卡中的筛选器中删除该字段，然后再次验证。
有关解决错误的详细信息，请参阅 解决与分析视图关联的错误。
查看视图的筛选条件
在 Analytics 视图中，从 “收藏夹 ”或 “所有 ”页中选择任何视图，以查看视图定义和筛选器的摘要。 选择 “编辑” 以编辑视图。
