显示应用中 Power BI 磁贴的控件。
没有 Power BI？ 注册。
Description
通过在应用中显示 Power BI 磁贴 来利用现有的数据分析和报告。 通过在选项面板的“数据”选项卡中设置其“工作区”、“仪表板”和“磁贴”属性来指定要显示的磁贴。
注释
- Power BI 磁贴控件在 GCC High 和 DoD 环境中不可用。
- Power BI 磁贴控件在中国不可用。
- 有关嵌入 Power BI 磁贴时的许可要求，请参阅 “许可”。
共享和安全性
共享包含 Power BI 内容的应用时，不仅必须共享应用本身，还必须共享磁贴的来源 仪表板 。 否则，即使打开应用的用户也不会显示 Power BI 内容。 包含 Power BI 内容的应用遵循该内容的权限。
Performance
不建议在应用中同时加载三个以上的 Power BI 磁贴。 可以通过设置 LoadPowerBIContent 属性来控制磁贴加载和卸载。
嵌入选项
嵌入在 Power BI API 的版本之间有所不同。 由于新的 Power BI API 身份验证方案，你的磁贴可能无法在移动或其他嵌入式方案中访问（Teams 或 SharePoint）。
可以使用 AllowNewAPI 属性控制 API 版本的使用。 有关详细信息，请参阅 密钥属性。
| AllowNewAPI 属性值 | 行为 |
|---|---|
| True | 可以通过从 Power BI 获取 嵌入 URL 并将其作为 TileUrl 值来嵌入仪表板、报表或磁贴。 |
| 假 | 可以通过 嵌入 URL 并使其成为 TileUrl 值或使用提供的图形界面来嵌入仪表板磁贴。 |
注释
Power Apps 移动应用不支持嵌入 Power BI URL（例如，在 IFrame 中），因为移动播放器不会处理对 Power BI URL 请求进行身份验证。
Filtering
筛选在 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。
仪表板 – 磁贴来自的 Power BI 仪表板。
LoadPowerBIContent – 设置为 True 时，将加载并显示 Power BI 内容。 设置为 False 时，将卸载 Power BI 内容，这会释放内存并优化性能。
PowerBIInteractions - 设置为 True 时，Power BI 内容可以与之交互，但 Power Apps OnSelect 事件不会触发。 设置为 False 时，磁贴无法与之交互，但在选择磁贴时，Power Apps OnSelect 事件将触发。
磁贴 – 要显示的 Power BI 磁贴的名称。
工作区 – 磁贴来自的 Power BI 工作区。
其他属性
BorderColor – 控件边框的颜色。
BorderStyle – 控件的边框是 Solid、 Dashed、 Dotted 还是 None。
BorderThickness – 控件边框的粗细。
DisplayMode – 控件是否允许用户输入（编辑）、仅显示数据（视图）或已禁用（已禁用）。
高度 – 控件的上边缘和下边缘之间的距离。
OnSelect – 当用户选择控件时要执行的作。 默认情况下，与磁贴关联的 Power BI 报表将打开。
TileUrl – 从 Power BI 服务请求磁贴的 URL。 若要将查询字符串筛选添加到 URL，请参阅上面的 筛选 部分。
可见 – 控件是显示还是隐藏。
宽度 – 控件的左边缘和右边缘之间的距离。
X – 控件的左边缘与其父容器的左边缘之间的距离（如果未显示父容器）。
Y – 控件的上边缘与父容器的上边缘之间的距离（屏幕（如果没有父容器）。
Example
在 “插入 ”选项卡上，打开 “图表 ”菜单，然后添加 Power BI 磁贴 控件。
不知道如何 添加和配置控件？
在选项面板的“数据”选项卡上，选择“工作区”设置的“我的工作区”。
在仪表板列表中选择一个仪表板，然后在磁贴列表中选择一个磁贴。
该控件呈现 Power BI 磁贴。
辅助功能指南
Power BI 磁贴只是 Power BI 内容的容器。 了解如何使用这些 Power BI 辅助功能提示创建可访问内容。
如果 Power BI 内容没有标题，请考虑使用 标签 控件添加标题以支持屏幕阅读器。 可以在 Power BI 磁贴之前立即定位标签。