如何把power bi嵌入到web应用中

如何将Power BI嵌入到Web应用中：获取嵌入令牌、生成报表、使用Power BI API、配置身份验证

将Power BI嵌入到Web应用中可以通过获取嵌入令牌、生成报表、使用Power BI API、配置身份验证等步骤来实现。获取嵌入令牌是关键的一步，通过它可以确保只有授权用户才能访问嵌入的报表和仪表板。详细介绍如下：

获取嵌入令牌是嵌入过程中的关键步骤之一，因为它确保了嵌入内容的安全性。嵌入令牌的生成可以通过Power BI API完成，这需要先获取Azure Active Directory (Azure AD)的应用程序ID和密钥，用于身份验证。然后，通过调用Power BI的REST API获取嵌入令牌，这个令牌将包含用户的权限信息，用于决定用户能访问哪些报表和数据。

一、获取嵌入令牌

获取嵌入令牌的步骤主要包括注册Azure AD应用、获取应用ID和密钥、并通过Power BI API生成嵌入令牌。

1. 注册Azure AD应用

在Azure门户中注册一个新的Azure AD应用。这一步的目的是为了获取应用程序ID和密钥，这些将用于后续的身份验证和获取嵌入令牌。

登录到Azure门户。
导航到“Azure Active Directory”。
选择“应用注册”，然后点击“新注册”。
填写应用的名称，并选择支持的账户类型。
在重定向URI中填写适当的URI（例如，http://localhost:3000）。
点击“注册”按钮。

2. 获取应用ID和密钥

注册应用后，需要获取应用程序ID和客户端密钥。

在应用注册成功页面，记下应用程序（客户端）ID。
导航到“证书和密钥”。
点击“新客户端密钥”，填写描述并选择过期时间，然后点击“添加”。
记下生成的客户端密钥。

3. 生成嵌入令牌

使用Azure AD应用的应用程序ID和密钥，通过Power BI API生成嵌入令牌。

使用Azure AD应用的应用程序ID和客户端密钥获取访问令牌。
使用访问令牌调用Power BI的REST API获取嵌入令牌。

二、生成报表

在Power BI中生成报表，并获取报表的ID和组ID，这些信息将在嵌入报表时使用。

1. 创建报表

登录到Power BI服务。
上传数据集并创建报表。
保存并发布报表。

2. 获取报表ID和组ID

在Power BI服务中找到目标报表。
记下报表的ID和所在工作区的组ID。

三、使用Power BI API

使用Power BI的JavaScript API将生成的报表嵌入到Web应用中。

1. 引入Power BI JavaScript SDK

在Web应用中引入Power BI的JavaScript SDK。

<script src="https://cdnjs.cloudflare.com/ajax/libs/powerbi-client/2.13.0/powerbi.min.js"></script>

2. 嵌入报表

使用JavaScript代码将报表嵌入到Web应用的指定位置。

const models = window['powerbi-client'].models;
const embedUrl = "https://app.powerbi.com/reportEmbed?reportId=<REPORT_ID>&groupId=<GROUP_ID>";
// 配置嵌入报表的参数
const embedConfig = {
  type: 'report',
  id: '<REPORT_ID>',
  embedUrl: embedUrl,
  accessToken: '<EMBED_TOKEN>',
  tokenType: models.TokenType.Embed,
  settings: {
    filterPaneEnabled: false,
    navContentPaneEnabled: false
  }
};
// 获取报表容器的DOM元素
const reportContainer = document.getElementById('reportContainer');
// 嵌入报表
powerbi.embed(reportContainer, embedConfig);

四、配置身份验证

确保只有授权用户能够访问嵌入的报表和仪表板。

1. 实现OAuth2.0身份验证

使用OAuth2.0协议来实现用户身份验证和授权。

在Azure AD中配置重定向URI和权限。
使用OAuth2.0库（例如，OAuth.js）来实现身份验证流程。

2. 验证用户权限

在生成嵌入令牌时，验证用户的权限，确保只有有权限的用户才能访问报表。

五、最佳实践和注意事项

在将Power BI嵌入到Web应用中时，遵循以下最佳实践和注意事项，确保嵌入过程的顺利进行。

1. 安全性

确保嵌入令牌的安全性，避免令牌泄露。可以通过服务器端生成嵌入令牌，并将令牌传递到客户端。

2. 性能优化

优化嵌入报表的性能。可以通过禁用不必要的功能（例如，过滤器面板和导航面板）来提高加载速度。

3. 用户体验

提供良好的用户体验。确保嵌入报表的布局和样式与Web应用的整体设计一致。

通过上述步骤和最佳实践，可以将Power BI顺利嵌入到Web应用中，为用户提供强大的数据分析和可视化功能。在实现过程中，推荐使用研发项目管理系统PingCode和通用项目协作软件Worktile来进行项目管理和团队协作。这些工具可以帮助团队高效地管理开发进程和协作，提高项目的成功率。