添加 Power BI

您可以在页面上添加 Power BI 组件来在您的门户上显示 Power BI 仪表板和报表。

在开始之前，请阅读 Power BI 访问类型注意事项和常规 Power BI 注意事项，以熟悉重要的 Power BI 条款和 Power Apps 门户的注意事项。

将 Power BI 组件添加到网页：

1. 编辑门户。

2. 选择要添加组件的页面。

3. 选择区域上的可编辑元素。

4. 从屏幕左侧选择 组件 。

5. 从“门户组件”部分，选择  Power BI。 Power BI 占位符将被添加到区域中。

6. 在屏幕右侧的属性窗格中，输入以下信息：

   1. 访问类型：从下拉列表中，选择适合您业务要求的选项。

      

      1. 为您的客户嵌入 - 允许您向外部用户安全地分享 Power BI 仪表板或报表，而无需 Power BI 许可证或 Microsoft Entra 身份验证设置。 此选项使用 Power BI Embedded 服务将 Power BI 仪表板或报表集成到您的门户中。

         备注

         确保 Power BI Embedded 服务已启用，且相应的 Power BI 工作区已选择并与开发者或登录用户共享。

      2. 为您的组织嵌入 - 允许您与通过身份验证的 Microsoft Entra ID 用户安全共享 Power BI 仪表板或报表。

         备注

         确保您已与制作者和目标门户用户共享 Power BI 工作区。

      3. 发布到 Web - 允许您与 Internet 上的任何人共享 Power BI 仪表板或报表。

      有关访问类型的详细信息，请转到 Power BI 访问类型注意事项。

   2. 工作区：从列表中选择 Power BI 工作区。

   3. 选择类型：从列表中选择仪表板或报表类型。

      

      • 仪表板 - 允许您选择仪表板，然后从选定的仪表板中选择要显示在网页上的磁贴。
      • 报表 - 允许您选择报表，然后从报表中选择要显示在网页上的页面。

   4. 应用角色：如果您已在 Power BI 中定义角色并将其分配给报表，则必须在此字段中输入相应角色。

      

      • 可输入多个角色，并以逗号分隔（例如，role_1,role_2）。 有关在 Power BI 中定义角色的详细信息，请转到使用 Power BI 的行级安全性 (RLS)。
        
      • 此选项仅对访问类型为您的客户嵌入可用。

   5. 应用筛选器：允许用户加载包含预筛选值的报表。 用户可以在字段中提供筛选条件。

      

      • 筛选器参数不能带 ?filter='' 前缀。 例如，Table/Field eq 'value'。
        有关详细信息，请转到筛选器参数详细信息。
      • 此选项仅对访问类型为为您的客户嵌入和为您的组织嵌入的报表可用。

   6. 嵌入代码 URL：输入嵌入代码 URL。

      

      • 要了解如何创建和管理嵌入代码，请转到从 Power BI 发布到 Web
      • 此选项仅对访问类型发布到 Web 可用。

Power BI 访问类型注意事项

下表简要说明了 Power BI 访问类型，并列出了 Power Apps 门户的访问类型注意事项。 有关 Power BI 访问类型的详细信息，请转到 Power BI 服务与 Power BI Embedded 之间的差异。

• 为您的客户嵌入：

  • 显示共享给当前登录并启用 Power BI Embedded 服务的用户的工作区列表。

  • 使用 Power BI Embedded 服务。

  • 如果您以前将 Power BI Embedded 服务与 Power Apps 门户一起使用，在选择为您的客户嵌入时，会看到以下错误：

    

    当此消息出现时，请确保先禁用，然后再次启用 Power BI 可视化。

  • 如果您在可以匿名访问的门户页面上添加具有为您的客户嵌入的 Power BI，任何人都可以查看仪表板。 要保护此页面，请阅读 Power Apps 门户中的网页访问控制。

• 为您的组织嵌入：

  • 显示与登录用户共享的工作区列表。
  • 使用 Microsoft Entra 身份验证。

• 发布到 Web：Internet 上的任何人都可以查看您发布的报表或视觉对象。 此选项无需身份验证，并且还可查看报表聚合的详细数据。 发布报表前，请确保可以公开共享数据和可视化效果。 不要发布机密或敏感信息。 在发布前请参阅您的组织的政策。

常规 Power BI 注意事项

• 门户工作室处理 Power BI 工作区时性能可能会下降，原因如下：
  • 与登录用户共享了大量工作区。
  • Power BI 工作区与很多用户共享。
• 处理 Power BI 组件时，门户工作室不支持捕获 Liquid 变量。
• 如果您重置门户并预配新门户，您必须将新门户的门户应用程序 ID 添加到门户 Power BI Embedded 服务 Microsoft Entra 安全组。 有关详细信息，请转到设置 Power BI 集成。
• 如果您在 Power Apps 门户管理中心进行更改，则必须重新加载门户工作室（如果您已将其打开）。
• 将用户添加到 Power BI 仪表板和报表可能需要一些时间才能反映在门户工作室中。
• 不支持连接到不同工作区上的共享数据集的 Power BI 仪表板和报表。
• 不支持分页 Power BI 报表。
• 如果您使用 Power BI 为客户嵌入访问类型为客户提供报表和仪表板，请参阅 powerbi-client JavaScript 库了解高级自定义。
• 如果您使用的是 Power BI 为组织嵌入访问类型，希望隐藏筛选器窗格，请参阅 Power BI 文档中的在阅读模式下隐藏筛选器窗格。

Power BI 性能和优化注意事项

嵌入多个 Power BI 工作区可能需要额外考虑一些事项。 请参阅以下资源了解 Power BI Embedded 的疑难解答、优化和最佳实践：

• Power BI Embedded 应用程序内容呈现疑难解答
• Power BI Embedded 性能最佳实践
• Power BI 优化指南

另请参阅

设置 Power BI 集成
将 Power BI 报表或仪表板添加到门户中的网页
Power Apps 门户工作室
创建和管理网页
WYSIWYG 编辑器