采用开发方法嵌入 Power BI 内容

已完成

以下步骤概述了开发人员应当遵循的常规方法,以通过编程方式在新的或现有应用中嵌入 Power BI 内容。

  1. 准备要嵌入 Power BI 内容。
  2. 创建 Microsoft Entra ID 应用注册。
  3. 开发应用嵌入代码。
  4. 使用客户端 API 功能增强用户体验。

首先,需要准备好 Power BI 内容才能嵌入。 要准备内容,请创建 Power BI 工作区并向其发布内容。 可以使用 Power BI Desktop 和 Power BI 服务以传统方式创建和管理内容。 下一单元介绍了准备 Power BI 内容以进行嵌入的过程。

其次,需要在 Microsoft Entra 中创建应用注册。 通过应用注册,Microsoft Entra 可以了解如何颁发令牌,这会授予对服务和资源的访问权限。 可能需要其他 Microsoft Entra 设置,具体取决于应用的嵌入标识。

注意

若要了解如何嵌入标识和应用安全设置,请完成设置权限以嵌入 Power BI 内容模块。

接下来,你将使用嵌入代码开发或扩展应用解决方案。 此过程涉及导入特定的 NuGet 包。 NuGet 包有助于满足服务器端要求,以通过 Microsoft Entra ID 进行身份验证、生成令牌以及发现 Power BI 内容。 Power BI 内容嵌入实际发生在客户端。 客户端 API 操作将特定 Power BI 内容项嵌入至 div 元素中。

注意

若要了解如何开发嵌入逻辑,请完成嵌入 Power BI 内容模块。

客户端 API 的功能远远不止于嵌入 Power BI 内容。 它们支持许多操作,有助于无缝集成和增强内容。 其功能包括:

  • 编程交互 - 例如,应用可以将新筛选器应用于嵌入报表。
  • 可订阅事件 - 图表元素(例如柱形图视觉对象的一列、菜单扩展和按钮)能触发应用可以响应的事件。 例如,当应用用户选择 Power BI 报表中的按钮时,应用可以打开对话框窗口以输入数据并将数据回写至应用数据库。
  • 动态报表布局 - 例如,应用用户可以选择浅色或深色主题报表。
  • 书签交互 - 应用可以应用现有报表书签,也可以创建(并保存)个人书签。
  • 报表视觉对象创建 - 应用允许用户创建报表视觉对象或个性化现有报表视觉对象。

注意

若要了解 Power BI 客户端 API,请完成将内容与 Power BI 客户端 API 集成模块。