使用 Power BI 数据连接器连接分析

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

了解如何使用 Power BI 数据连接器在 Power BI 与 Azure DevOps 之间建立无缝连接。 通过此集成，可以从 Azure DevOps 数据中提取有价值的见解，并使用 Analytics 视图在 Power BI 中创建引人注目的报表和仪表板。

Power BI 数据连接器提供与 Azure DevOps Analytics 的直接连接，使你能够执行以下任务：

• 将分析视图导入 Power BI Desktop
• 使用实时 Azure DevOps 数据创建自定义报表
• 为利益干系人生成交互式仪表板
• 跟踪项目指标和团队性能
• 可视化工作项趋势和冲刺进度

先决条件

在将 Power BI 连接到 Azure DevOps Analytics 之前，请确保满足以下要求：

创建新报表并连接到 Azure DevOps

按照以下步骤创建新的 Power BI 报表并建立与 Azure DevOps Analytics 数据的连接：

1. 打开 Power BI Desktop 并创建新报表：

   • 在计算机上启动 Power BI Desktop
   • 如果出现启动屏幕，请选择“获取数据”
   • 如果已在 Power BI Desktop 中，请从功能区中选择主页>获取数据

   

2. 查找 Azure DevOps 连接器：

   • 在“获取数据”对话框中，选择“联机服务”
   • 查找 Azure DevOps 实例
   • 选择适当的连接器，然后选择 “连接”

   如果在联机服务类别中看不到 Azure DevOps 连接器：

   • 确保已安装最新版本的 Power BI Desktop
   • 在“获取数据”对话框顶部的搜索框中搜索“Azure DevOps”
   • 查看 “其他 ”类别（如果不在联机服务中）

   

连接到 Analytics 视图

按照以下步骤连接到 Analytics 视图：

1. 打开 Power BI Desktop。

2. 登录到服务。 首次访问要求你登录并验证凭据。 Power BI Desktop 保存凭据，因此只需登录一次。

   注意

   Azure DevOps 不支持使用开放授权（OAuth）的跨租户方案。 建议 使用服务主体和托管标识。

3. 选择“连接” 。

   

4. 选择获取数据>联机服务，然后对于云服务，选择Azure DevOps（仅限看板）；对于本地服务器，选择Azure DevOps Server（仅限看板）。 选择“连接” 。 分析视图仅支持针对工作项和测试用例的查询。

   

5. 指定用于连接到数据的基本参数。

   

   

   • 集合 URL：输入 Azure DevOps Server 实例所在的托管 URL。 示例 URL 为 https://fabrikam-server/AzureDevOpsServer/fabrikam-collection.
   • 团队项目：仅输入项目名称。 例如，如果 Azure DevOps Server 实例的 URL 为 ，请输入 https://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber。

   重要

   不要将团队名称与项目名称混淆，这是一个常见的错误。 例如，如果使用的 URL 是https://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber-Git/Device，Fabrikam-Fiber-Git 是项目名称，设备是团队名称。

   成功登录后，Power BI 会验证凭据是否具有访问指定项目所需的权限。 有关常见问题的解决方案，请参阅 故障排除。

选择“分析”视图

按照以下步骤选择“分析”视图：

1. 展开 共享视图。 数据连接器提供可用 分析视图的列表。 每个视图都表示一组可以拉取到 Power BI 中的数据。 还可以 创建自定义 Analytics 视图。

   下图显示了默认的分析视图。 视图列表可能因用于创建项目的过程模型而异。 列出的所有视图（除追加“ 今日”的视图外）都提供历史趋势数据。

   

2. 选择 “工作项 - 过去 30 天 ”视图并等待预览加载。 此视图使用筛选器显示项目中所有工作项的最后 30 天历史记录。

   注意

   如果在创建视图时验证视图，则视图应加载。 如果视图未加载，则很可能是因为数据集太大。 返回到 Web 门户中 的“分析视图 ”页，并打开视图进行编辑。 调整筛选器以减小数据集的大小。

   

   注意

   • 根据所选字段数和数据集大小，可以截断导航器中任何所选视图的预览。 仅对预览数据进行截断，不会影响完整数据刷新。
   • 分析视图 不会在服务器上应用使用 Power BI 定义的筛选器。 Power BI 中应用的任何筛选器会将显示的数据限制为最终用户，但不会减少从 Analytics 检索到的数据量。 如果筛选器旨在减小数据集的大小，请通过 自定义视图来应用它。

3. 选中“ 故事 - 过去 30 天 ”视图旁边的复选框，然后选择“ 加载”。 等待数据加载。 通过表名称下显示的状态消息监视其进度。 有关常见问题的解决方案，请参阅 故障排除。

   

4. 查看数据模型。 在模型加载时，请查看 Power BI 数据连接器的数据集设计。

创建报表和仪表板

成功加载 Analytics 数据后，可以创建各种报表和可视化效果：

报表创建入门

1. 浏览数据：查看导入的字段并了解数据结构
2. 规划可视化效果：确定要跟踪的关键指标和 KPI
3. 创建初始报表：从简单的图表开始，逐渐增加复杂性
4. 测试和迭代：使用利益干系人验证报表，并根据需要进行优化

常见报表类型

• 工作项趋势：跟踪一段时间内的 bug 报告、用户情景和功能进度
• 冲刺进度图表：监视冲刺进度和团队速度
• 团队性能指标：分析吞吐量、周期时间和完成率
• 积压工作分析：可视化工作分布和优先级对齐

有关详细示例和模板，请参阅 基于 Analytics 视图的示例报表。

最佳做法

充分利用 Power BI 和分析集成：

性能优化

• 筛选分析视图以仅包含必要的数据
• 使用适当的日期范围来限制数据量
• 定期刷新数据，但避免刷新频率过高
• 考虑符合报表需求的数据刷新计划

报表设计

• 开始简单并逐步添加复杂性
• 跨报表使用一致的格式设置和品牌打造
• 包括指标的上下文和说明
• 使用不同的用户角色进行测试以确保可用性

数据管理

• 记录分析视图及其用途
• 建立数据刷新策略和所有权
• 监视报表使用情况和性能
• 维护安全性和访问控制

Troubleshooting

常见错误情境

Azure DevOps 连接器不可见

问题：无法在 Power BI Desktop 的数据源列表中找到“Azure DevOps”

可能的原因和解决方案：

1. 过时的 Power BI Desktop 版本：

   • 下载并安装 最新版本的 Power BI Desktop
   • 在更高版本中添加了 Azure DevOps 连接器

2. 正在查看错误的类别

   • 首先检查 联机服务 类别
   • 如果未找到，请使用搜索框搜索“Azure DevOps”
   • 尝试查看“其他”类别作为备选方案

3. 区域可用性：

   • 确保 Power BI 区域支持 Azure DevOps 连接器
   • 如果通过组织许可使用 Power BI，请与管理员联系

4. Power BI 许可：

   • 验证是否具有适当的 Power BI 许可
   • 某些连接器的限制可能会根据许可等级而适用。

查询结果超过最大大小

错误消息：“查询结果超出最大大小。 通过应用更多筛选器减少记录数”

原因：分析视图返回超过 250,000 条记录。

解决 方案：

1. 减少分析视图中的时间范围
2. 应用更多筛选器以限制工作项类型或状态
3. 使用多个较小的视图而不是一个大型视图
4. 考虑在更高级别聚合数据

访问被拒绝或身份验证错误

错误消息：“用户未授权”或身份验证失败

可能的原因和解决方案：

• 检查项目权限：验证你是否有权访问 Azure DevOps 项目
• 验证分析权限：确保你具有 Analytics 访问权限
• 查看凭据：与管理员协作处理凭据问题
• Microsoft Entra 身份验证：验证帐户是否已正确配置

禁止分析访问

错误消息：“禁止访问资源”

解决方法：请与项目管理员联系，授予 “查看分析 ”权限。 有关详细信息，请参阅 Analytics 安全性 。

找不到项目

错误消息：“项目'X'不存在或您没有访问它的权限”

常见原因：

• 项目名称不正确：确保使用项目名称，而不是团队名称
• URL 混淆：对于 https://dev.azure.com/fabrikam/MyProject/MyTeam，请使用“MyProject”而不是“MyTeam”
• 缺少权限：验证你是否有权访问指定的项目

读取错误消息

排查 Power BI 数据连接器问题时，请执行以下任务：

1. 查找根本原因：在错误消息中搜索 [DataSource.Error]
2. 忽略包装文本：关注核心错误说明
3. 检查建议的作：错误消息通常包括解决方法步骤
4. 验证先决条件：确保满足所有要求

相关内容

• 了解 Power BI 集成
• 了解 Analytics 视图数据集设计
• 基于 Analytics 视图生成示例报表