Power BI Embedded 官方新版示例(2017 年 4 月版)配置步骤

根据官网 Power BI Embedded 示例入门所介绍,由于官方给的 Power BI Embedded 示例(参见 Power BI Embedded - 将报表集成到 Web 应用中)仅适用于国际版 Azure 的环境,若需要在中国区环境中使用,则需要在示例代码中完成以下修改:

Important

本示例中的某些 URL 只能在全球环境中使用。 若要在 Azure 中国区环境中使用它,必须执行一些替换。 例如:在文件 \ProvisionSample\App.config 中将 https://api.powerbi.com 替换为 https://api.powerbi.cn ,将 https://management.azure.com 替换为 https://management.chinacloudapi.cn ,在文件 \ProvisionSample\Program.cs 中将 https://management.core.windows.net 替换为 https://management.core.chinacloudapi.cn ,在文件 \ProvisionSample\ProgramExtensions.cs 中将 https://login.windows.net 替换为 https://login.chinacloudapi.cn 。 有关全球环境与中国区环境中 URL 的差别的详细信息,请参阅 此文

然而 2017 年 4 月份之后,官方给出了新版 Power BI Embedded 示例(以下简称“新版示例”,以区别于之前的“旧版示例”),新版示例考虑到 Power BI 中国版的情况,因此添加了名为 "Cloud Config for Embed" 和 "Cloud Config for Prov" 的两个文件夹,如下所示:

github-1

进入 Cloud Config for Embed 文件夹后,可发现名为 “Power BI operated by 21Vianet in China” 的文件夹,里面的 “Cloud.config” 文件即为针对 Power BI 中国版配置好的 Cloud.config 文件。

github-2 github-3

同理,Cloud Config for Prov 文件夹中也有已配置好的 Cloud.config 文件。

github-4 github-5

因此相对旧版示例而言,新版示例的配置操作有所调整,如下所示:

  1. 将 "\Cloud Config for Embed\Power BI operated by 21Vianet in China" 中的 "Cloud.config" 拷贝覆盖到 "\EmbedSample" 下;

    将 "\Cloud Config for Prov\Power BI operated by 21Vianet in China" 中的 "Cloud.config" 拷贝覆盖到 "\ProvisionSample" 下。

  2. 双击 "PowerBI-embedded.sln",用 Visual Studio 打开;

  3. 选择 "Tools"=>"NuGet Package Manager"=>"Package Manager Console",在命令行界面里输入 Update-Package,更新依赖包;

    error

    更新完成后可能会出现以下报错,这个错误不影响 Sample 使用,只需要重启 Visual Studio 即可。

  4. Visual Studio 重启后,用 Ctrl+h 将 powerbi.com 全局替换为 powerbi.cn,即在 entire solution 范围内进行替换;

    replace

  5. 之后选择 "Build" => "Rebuild Solution" 以重新 Build Solution;

    build-solution

  6. 最后将 Embed Sample 下 Web.config 中的 powerbi:AccessKeypowerbi:WorkspaceCollectionpowerbi:WorkspaceId 的值填好,之后示例便可正常使用了。

    web-config