教程：将 Power BI 内容嵌入到适用于国家/地区云的应用程序

了解如何将分析内容嵌入 国家/地区云的业务流程应用程序中。 将 Power BI .NET SDK 与 Power BI JavaScript API 配合使用，将报表、仪表板或磁贴嵌入 Web 应用程序中。

Power BI 支持以下国家/地区云：

• Power BI for 中国云

若要开始本演练，需要一个 Power BI 帐户。 如果没有设置帐户，则根据国家/地区类型，可以选择正确的国家/地区云。 注册 Power BI for China 云帐户。

若要将仪表板集成到 Web 应用中，请使用 Power BI API 和 Microsoft Entra 授权 访问令牌 来获取仪表板。 使用嵌入令牌加载仪表板。 Power BI API 提供对特定 Power BI 资源的编程访问。 有关详细信息，请参阅 Power BI REST API、Power BI .NET SDK 和 Power BI JavaScript API。

下载示例

本文介绍 GitHub 上 “应用拥有数据”示例 的代码。 为便于按照本教程操作，请下载示例。 我们使用的是目录 .NET Framework/Embed for your customers 。

• Power BI for China 云参数

  1. 在 Web.config 文件中，更新 applicationId （本机应用 applicationId）、 workspaceId用户名（主用户）和密码。

  2. 接下来，添加 Power BI for China 云参数，如下所示。

     <add key="authorityUrl" value="https://login.chinacloudapi.cn/organizations/" />
     <add key="scopeBase" value="https://analysis.chinacloudapi.cn/powerbi/api/.default" />
     <add key="urlPowerBiServiceApiRoot" value="https://api.powerbi.cn/" />
     

步骤 1 - 在 Microsoft Entra ID 中注册应用

使用 Microsoft Entra ID 注册应用程序以调用 REST API。 有关详细信息，请参阅 注册 Microsoft Entra 应用以嵌入 Power BI 内容。 由于存在不同的国家/地区云关联，因此有不同的 URL 来注册应用程序。

• Power BI 中国云 - https://app.powerbi.cn/apps

如果下载了客户示例的Embedding，则可以使用您获得的applicationId，以便示例可以向 Microsoft Entra ID 进行身份验证。 若要配置示例，请更改 applicationIdweb.config 文件中的内容。

步骤 2 - 从 Microsoft Entra ID 获取访问令牌

在应用程序中，需要从 Microsoft Entra ID 获取访问令牌，然后才能调用 Power BI REST API。 有关详细信息，请参阅 “对用户进行身份验证”，并获取 Power BI 应用的 Microsoft Entra 访问令牌。 由于存在不同的国家/地区云关联，因此有不同的 URL 来获取应用程序的访问令牌。

• Power BI 中国云服务 - https://login.chinacloudapi.cn

可以在 Controllers\HomeController.cs 文件中每个内容项任务中查看这些访问令牌的示例。

步骤 3 - 嵌入内容

有了访问令牌后，可以像在任何其他平台上一样继续嵌入。

• 为客户嵌入内容
• 为组织嵌入内容

相关内容

• 嵌入给客户的示例
• Power BI JavaScript API

更多问题？ 在 Power BI 社区提问