Power Apps 中的 Power BI 磁贴控件
在应用内显示 Power BI 磁贴的控件。
没有 Power BI？ 注册。
描述
通过在应用内显示 Power BI 磁贴 来利用现有数据分析和报告。 在选项面板的数据选项卡中，设置磁贴的 Workspace、Dashboard 和 Tile 属性，指定要显示的磁贴。
备注
- Power BI 磁贴控件在 GCC High 和 DoD 环境中不可用。
- Power BI 磁贴控件不适用于中国。
- 有关嵌入 Power BI 磁贴时的许可要求，请参阅许可。
共享和安全性
共享包含 Power BI 内容的应用时，不仅要共享应用本身，还必须共享磁贴所在的仪表板。 否则，即使对于打开应用的用户，也不会显示 Power BI 内容。 包含 Power BI 内容的应用遵从该内容的权限。
性能
建议不要在应用内同时加载三个以上的 Power BI 磁贴。 可通过设置 LoadPowerBIContent 属性，控制磁贴加载和卸载。
嵌入选项
不同版本的 API 的嵌入 Power BI 的操作不同。 由于采用了新的 Power BI API 身份验证方案，因此在移动设备上或在其他嵌入方案（Teams 或 SharePoint）中无法访问您的磁贴。
您可以使用 AllowNewAPI 属性来控制 API 版本的使用。 有关详细信息，请参阅关键属性。
| AllowNewAPI 属性值 | 行为 |
|---|---|
| 正确 | 您可以通过从 Power BI 获取嵌入式 URL 并将其设为 TileUrl 值来嵌入仪表板、报表或磁贴。 |
| 错误 | 您可以通过嵌入式 URL 并将其设为 TileUrl 值或使用提供的图形界面来嵌入仪表板磁贴。 |
备注
Power Apps 移动版不支持嵌入 Power BI URL（例如，在 IFrame 中），因为移动播放器不处理对 Power BI URL 请求的身份验证。
筛选
Power BI API 版本之间的筛选操作有所不同。 请参阅下面的相应部分，具体取决于您的控件配置方式。
使用新 API 调用 Power BI 服务时
当 AllowNewAPI 属性设置为“True”时，您将使用新 API 调用 Power BI 服务。 有关详细信息，请参阅使用 URL 中的查询字符串参数筛选报表。
使用原始 API 调用 Power BI 服务时
当 AllowNewAPI 属性设置为“False”时，您将使用原始 API 调用 Power BI 服务。 在这种情况下，通过从应用传递单个参数，可以筛选 Power BI 磁贴中显示的结果。 但是，仅支持字符串值和等于运算符，如果表名称或列名称包含空格，筛选器可能无法正常工作。
要传递单个筛选器值，请修改 TileURL 属性的值，其遵循以下语法：
"https://app.powerbi.com/embed?dashboardId=<DashboardID>&tileId=<TileID>&config=<SomeHash>"
对于该值，追加以下语法：
&$filter=<TableName>/<ColumnName> eq '<Value>'
例如，使用列表框中的值：
"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"
此参数将筛选磁贴起源的报表数据集中的值。 不过，筛选功能具有下列限制：
- 只能应用一个筛选器。
- 仅支持
eq运算符。 - 字段类型必须为字符串。
- 筛选仅可用于固定的可视化磁贴。 对于固定的报表不受支持。
- 无法筛选 R 和 Python 脚本视觉对象。
您可以使用 Power BI 报表中的计算字段将其他值类型转换为字符串，或将多个字段组合在一起。
键属性
AllowNewAPI - 调用 Power BI 服务时是否使用新 API。 将此值设置为 True 将允许使用新 Power BI API（移动和一些嵌入式场景不支持，但允许使用一些更高级的筛选）。 False 将使用原始 API。 默认值为 false。
Dashboard – 磁贴所在的 Power BI 仪表板。
LoadPowerBIContent – 设置为 True 时，加载和显示 Power BI 内容。 设置为 False 时，卸载 Power BI 内容，这将释放内存并优化性能。
PowerBIInteractions - 如果设置为 True，则可以与 Power BI 内容交互，但不会触发 Power Apps OnSelect 事件。 如果设置为 False，则不能与磁贴交互，但是选择磁贴时将触发 Power Apps OnSelect 事件。
Tile – 要显示的 Power BI 磁贴的名称。
Workspace – 磁贴所在的 Power BI 工作区。
其他属性
BorderColor – 控件边框的颜色。
BorderStyle – 控件边框是 Solid、Dashed、Dotted 还是 None。
BorderThickness – 控件边框的粗细。
DisplayMode – 此控件是允许用户输入 (Edit)、仅显示数据 (View)，还是已禁用 (Disabled)。
Height – 控件上边缘和下边缘之间的距离。
OnSelect – 当用户选择控件时要执行的操作。 默认情况下，将打开与磁贴关联的 Power BI 报表。
TileUrl – 从 Power BI 服务请求磁贴所使用的 URL。 若要将查询字符串筛选添加到 URL，请参阅上面的筛选部分。
Visible – 控件显示还是隐藏。
Width – 控件左边缘和右边缘之间的距离。
X – 控件左边缘与其父容器（如果没有父容器—则为屏幕）左边缘之间的距离。
Y – 控件上边缘与其父容器（如果没有父容器—则为屏幕）上边缘之间的距离。
示例
在插入选项卡上，打开图表菜单，然后添加一个 Power BI 磁贴控件。
不知道如何添加和配置控件？
在“选项”面板的Data选项卡中，选择我的工作区以打开Workspace设置。
在仪表板列表中选择仪表板，然后在磁贴列表中选择磁贴。
此控件呈现 Power BI 磁贴。
辅助功能准则
Power BI 磁贴只是 Power BI 内容的容器。 了解如何使用这些 Power BI 辅助功能提示创建可访问的内容。
如果 Power BI 内容没有标题，请考虑使用 标签 控件添加标题，以便为屏幕阅读器提供支持。 可将标签直接置于 Power BI 磁贴前。