Power BI 使用方案：为组织嵌入内容
备注
本文是 Power BI 实现规划系列文章中的一篇。 本系列着重介绍 Microsoft Fabric 中的 Power BI 体验。 有关该系列的介绍，请参阅 Power BI 实施规划。
此使用方案着重介绍开发人员如何以编程方式在组织的自定义应用程序中嵌入 Power BI 内容。 （开发人员不一定负责创建 Power BI 内容。）当应用程序受众包括有权限和相应许可证来访问组织中的 Power BI 内容的用户时，“为组织嵌入内容”方案适用。 这些用户必须具有组织帐户（包括来宾帐户），这些帐户使用 Microsoft Entra ID 进行身份验证。
注意
在此方案中，Power BI 是软件即服务 (SaaS)。 此嵌入方案有时称为“用户拥有数据”。
方案示意图
下图简要概述了支持为组织嵌入内容的最常见用户操作和 Power BI 组件。
提示
如果想要将方案图嵌入演示文稿、文档或博客文章，或者将其打印为墙上海报，建议下载方案图。 由于它是可缩放矢量图形 (SVG) 图像，因此可以放大或缩小它，而不会造成任何质量损失。
上面的示意图描绘了以下用户操作、工具和功能：
| 项目 | 描述 |
|---|---|
 |
Power BI 内容创建者使用 Power BI Desktop 开发 BI 解决方案。 |
 |
准备就绪后，内容创建者将 Power BI Desktop 文件 (.pbix) 或 Power BI 项目文件 (.pbip) 发布到 Power BI 服务。 |
 |
某些数据源（例如驻留在专用组织网络中的数据源）可能需要本地数据网关或 VNet 网关来进行数据刷新。 |
 |
Power BI 工作区包含准备嵌入的 Power BI 项。 对于非个人工作区，自定义应用程序的用户有权查看（或者创建或修改）Power BI 内容，因为他们属于工作区角色，或者具有方向权限。 |
 |
自定义应用程序会提示应用用户使用 Microsoft Entra ID 进行身份验证。 身份验证成功后，自定义应用程序将缓存 Microsoft Entra 访问令牌。 |
 |
自定义应用程序使用 Microsoft Entra 访问令牌代表应用用户调用 Power BI REST API。 具体而言，应用程序会使用访问令牌来检索有关工作区项的元数据。 元数据包括将内容嵌入自定义应用程序所需的属性。 |
 |
自定义应用程序在 iframe HTML 元素中嵌入特定的 Power BI 项。 应用程序可支持创建和编辑 Power BI 报表，前提是用户有权执行此操作。 |
 |
Power BI 管理员监督和监视 Power BI 服务中的活动。 |
要点
下面是关于以编程方式在组织的自定义应用程序中嵌入 Power BI 内容需要强调的一些要点。
用例
为组织嵌入 Power BI 内容有几个原因。
- 内部商业智能门户：你可能想要创建内部商业智能 (BI) 门户来取代 Power BI 服务。 这样，你可以创建一个自定义应用程序来集成 Power BI 和其他 BI 工具中的内容。
- 内部应用：你可能想要开发一个显示数据可视化效果的 Intranet 应用。 例如，制造部门的 Intranet 站点可显示实时视觉对象，这些视觉对象提供有关生产线的最新信息。
- 自定义日志记录：除了活动日志记录的内容，你可能还想要记录自定义事件，以记录 Power BI 内容的访问和使用。
提示
如果要为组织创建 BI 门户样式，只需将自定义品牌添加到 Power BI 服务即可实现此目的。
无代码嵌入
开发编程解决方案需要技能、时间和精力。 请考虑有一些称为“无代码嵌入”的嵌入技术，非开发人员可使用这些技术在简单的内部门户或网站中嵌入内容。
- 使用 Power BI 报表 Web 部件将 Power BI 报表嵌入 SharePoint Online。
- 使用由 Power BI 生成的安全嵌入代码（或 HTML）在内部 Web 门户中嵌入 Power BI 报表。
- 在 Power Pages 中嵌入 Power BI 报表或仪表板。
- 在 Microsoft Teams 频道或聊天中嵌入报表。
这些技术要求报表使用者属于组织、经过身份验证且有权访问报表。 Power BI 确保在使用者查看报表时强制实施所有权限和数据安全性。 在部分情况下，用户可能会在登录 Power BI 以进行身份验证时遇到麻烦。
可嵌入的内容
为组织嵌入内容时，可嵌入以下 Power BI 内容类型：
- Power BI 报表
- 特定的 Power BI 报表视觉对象
- 分页报表
- Q&A 体验
- 仪表板
- 特定仪表板磁贴
内容所在的位置没有限制。 内容可位于个人工作区或常规工作区中。 重要的是，应用用户有权查看（或者创建或编辑）内容。 例如，可以从应用用户的个人工作区中嵌入内容。
用户可在 Power BI 服务中看到的任何内容都可能嵌入到自定义应用程序中。 如果用户有权创建或编辑内容，则自定义应用可支持此功能（仅限 Power BI 报表）。
身份验证
身份验证流是使用 Microsoft Entra ID 的交互式身份验证。 交互式身份验证意味着应用用户将被要求进行身份验证。 经过身份验证后，Microsoft Entra ID 会返回访问令牌。 自定义应用程序负责缓存访问令牌，以便可用该令牌进行 Power BI REST API 调用，并在 iframe HTML 元素中嵌入内容。 这些调用可代表应用用户检索有关 Power BI 内容的元数据，包括将其嵌入自定义应用程序所需的属性。
许可
为组织嵌入内容不存在特定许可要求。 重要的是，应用用户具有查看（或者创建或编辑）内容的权限和相应的 Power BI 许可证。 当应用的用户仅拥有 Fabric（免费）许可证时，甚至可以嵌入来自个人工作区的内容。
Power BI 客户端 API
通过 Power BI 客户端 API，开发人员可在自定义应用程序和 Power BI 内容之间实现紧密集成。 他们通过使用在浏览器中运行的 JavaScript 或 TypeScript 编写自定义逻辑来开发应用程序。
应用程序可设置和自动执行操作，还可响应用户发起的操作。 此外，还可集成 Power BI 功能，包括导航、筛选器和切片器、菜单操作、布局和书签。
提示
Power BI 嵌入式分析操场是一个有助于学习、探索和试验 Power BI 嵌入式分析的网站。 它包括用于实践的开发人员沙盒，使用包含示例 Power BI 内容或你自己的内容的客户端 API。 代码片段和展示也可供你浏览。
有关详细信息，请参阅什么是 Power BI 嵌入式分析操场？
网关设置
通常，在访问驻留在专用组织网络或虚拟网络中的数据源时需要一个数据网关。 网关的两个作用是刷新导入的数据，或查看查询实时连接或 DirectQuery 语义模型的报表。
系统监督
活动日志记录 Power BI 服务中发生的用户活动。 Power BI 管理员可以使用收集的活动日志数据来执行审核，以帮助他们了解使用模式和采用情况。 记录的事件将消耗方法描述为“为组织嵌入内容”。 目前无法确定是否是在自定义应用程序中的无代码嵌入体验中查看内容的。
相关内容
若要详细了解 Power BI 嵌入式分析，请完成嵌入 Power BI 分析学习路径。
还可完成“Power BI 开发人员的一天”课程。 本课程包括一个自学工具包，指导你完成开发 ASP.NET Core MVC 应用的过程。
有关可帮助你做出 Power BI 实施决策的其他有用方案，请参阅 Power BI 使用方案一文。