在 Power Pages 中与 Power BI 集成

6 分钟

您可以将 Power BI 报表或仪表板添加到 Power Pages 站点的网页中，以进一步扩展网站，从而打造功能强大的 Web 应用程序。

在将 Power BI 报表添加到 Power Pages 站点之前，您需要在 Power Pages 管理中心中启用 Power BI 可视化或 Power BI Embedded 服务。

Power BI 可视化 - 允许您为匿名访问者嵌入发布到 Web Power BI 报表，或与经过身份验证的 Power BI Microsoft Entra ID 用户共享 Power BI 报表或仪表板（例如，在员工自助服务门户上）。
Power BI Embedded 服务 - 允许您向没有 Power BI 许可证或未设置 Microsoft Entra ID 身份验证的外部用户共享 Power BI 报表或仪表板。此功能使用 Power BI 的新建工作区 功能。有关详细信息，请参阅在 Power BI 中创建工作区。

启用 Power BI 可视化

启用 Power BI 可视化后，Power Pages 制作者可将 Power BI 组件添加到网页，然后设置该组件以显示可在 Web 上发布的 Power BI 报表或仪表板。报表作者需要在 Power BI 仪表板中生成嵌入代码。

使用 Power Pages 设计工作室，您可以将 Power BI 组件添加到网页。本操作会将 Liquid 标记添加到网页，您可以根据自己的特定要求在 Visual Studio Code 编辑器中进一步进行编辑和设置。

参数

powerbi Liquid 标记接受以下参数：

path - Power BI 报表或仪表板的路径。如果 Power BI 报表或仪表板是安全的，您需要提供身份验证类型。

{% powerbi path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}

authentication_type - Power BI 报表或仪表板所需的身份验证类型。对于嵌入式 Power BI 可视化，本参数的有效值为 anonymous 和 aad (Microsoft Entra ID)。默认值为 anonymous。添加 Power BI 报表或仪表板时，请确保将其与经过身份验证的 Microsoft Dataverse Microsoft Entra ID 用户共享。
```
{% powerbi authentication_type:"aad" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}
```

tileid - 显示仪表板的指定磁贴。您需要提供磁贴的 ID。

{% powerbi
   authentication_type:"aad"
   path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/dashboards/00000000-0000-0000-0000-000000000001"
   tileid:"00000000-0000-0000-0000-000000000002"
%}

当制作者在 Power Pages 设计工作室中选择 Power BI 组件时，他们可以使用 Power BI 组件对话框设置参数的值。

您还可以选择应用筛选器，然后指定筛选表达式，从而使用一个或多个值筛选报表。有关详细信息，请参阅通过在 URL 中使用查询字符串参数来筛选报表。

重要提示

匿名报表不支持筛选。

筛选支持动态值，因而非常适合用于显示个性化设置的 Power BI 可视化。您还可使用 capture Liquid 标记创建动态路径并将其保存在变量中，如以下示例所示：

{% capture pbi_path %}https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01?filter=Executives/Executive eq '{{user.id}}'{% endcapture %}
{% powerbi authentication_type:"aad" path:pbi_path %}

在将 Power BI 报表或仪表板添加到 Power Pages 网站上的网页之前，需要将其与所需用户共享。

启用 Power BI Embedded 服务

您还可在 Power Platform 管理中心中启用和设置 Power BI Embedded 服务功能。

启用 Power BI Embedded 服务后，请务必指定可在 Power Platform 管理中心中的网站上使用的 Power BI 工作区。

当您激活 Power BI Embedded 服务时，制作者可以在网页上嵌入 Power BI 报表。本操作会利用 Power BI Embedded 服务的特性和功能，制作者无需在网站上编写相应代码。您需要在 Power BI 中创建工作区并添加适当的报表、仪表板和磁贴。

当您添加嵌入式 Power BI 报表时，指定访问群体是您的客户（外部用户）还是内部员工。员工需要使用 Microsoft Entra ID 来针对网站进行身份验证。在为外部用户添加报表时，请将 authentication_type 的值设置为 powerbiembedded，如以下示例所示：

{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}

您还可以在属性对话框中将访问类型设置为为您的客户嵌入，来设置正确的身份验证类型。

注意

共享 Power BI 需要适当许可。许可要求取决于访问群体和共享方法。

有关设置 Power BI 集成的详细信息，请参阅设置 Power BI 集成。

有关共享和许可要求的详细信息，请参阅共享 Power BI 工作区和共享 Power BI 仪表板和报表。

继续

在 Power Pages 中与 Power BI 集成

启用 Power BI 可视化

参数

启用 Power BI Embedded 服务

反馈