借助 Power BI 发布到 Web 选项,可以轻松地在博客文章、网站、电子邮件或社交媒体中嵌入交互式 Power BI 内容。 还可以轻松编辑、更新、刷新或停止共享已发布的视觉对象。
警告
使用发布到 Web 时,Internet 上的任何人都可以查看您发布的报表或视觉对象。 查看无需身份验证。 它包括查看报表聚合的详细级别数据。 发布报表前,请确保可以公开共享数据和可视化效果。 请勿发布机密或专有信息。 如果有任何疑问,请在发布前查看组织策略。
注释
可以在内部门户或网站中安全地嵌入内容。 使用 嵌入 或 在 SharePoint Online 中嵌入 选项。 这些选项可确保用户在查看内部数据时强制实施所有权限和数据安全性。
先决条件
- 需要Microsoft Power BI 许可证才能从“我的工作区”发布到 Web。
- 需要Microsoft Power BI Pro 或 Premium Per User 许可证才能从工作区发布到 Web。
- 发布到 Web 可用于可在“我的工作区”和工作区中编辑的报表。
- 它不适用于与你共享的报表,也不可用于依赖行级别安全性来保护数据的报表。
- 报表查看器不需要是 Power BI 用户。
有关不支持发布到 Web 的情况的完整列表,请参阅下面的 “注意事项和限制 ”部分。
使用发布到 Web 创建嵌入代码
请按照以下步骤使用发布到网页功能。 在发布到 Web 之前,请查看本文前面的 警告 。
在可以编辑的工作区中打开报表,然后选择“文件>嵌入报表>发布到 Web”(公共)。
如果 Power BI 管理员不允许你创建嵌入代码,则可能需要与他们联系。
有关查找可在组织中启用“发布到 Web”的人员的帮助,请参阅本文后面的 “如何查找 Power BI 管理员 ”。
查看对话框内容,然后选择“ 创建嵌入代码”。
仔细检查此处显示的警告,并确认数据适合嵌入公共网站。 如果是,请选择“ 发布”。
在 “成功 ”对话框中,你将看到报表的外观预览。 选择大小和默认页。
还可以添加 占位符 图像,使网页加载速度更快。 使用占位符图像时,在 Web 上查看报表的人员会看到“ 查看交互式内容 ”按钮,用户可以选择该按钮来查看报表本身。
首先进行这些更改。 然后复制链接以通过电子邮件发送,或复制 HTML 以粘贴到网站中。 可以在 iFrame 等代码中嵌入它,或将其直接粘贴到网页或博客中。
如果之前为报表创建了嵌入代码并选择“ 发布到 Web”,则不会在步骤 2-4 中看到对话框。 而是会看到“ 嵌入代码 ”对话框。
只能为每个报表创建一个嵌入代码。
视图模式的提示
在博客文章中嵌入内容时,通常需要将其适应特定的屏幕大小。 可以根据需要调整 iFrame 标记中的高度和宽度。 但是,需要确保报表适合给定的 iFrame 区域,因此在编辑报表时设置适当的视图模式。
下表提供有关视图模式的指南,以及嵌入时显示方式。
查看模式 | 嵌入时的外观 |
---|---|
![]() |
适合页面 将根据报表的页面高度和宽度调整。 如果将页面设置为 动态 比率(如 16:9 或 4:3),则内容将缩放以适应 iFrame。 嵌入到 iFrame 中时,使用 Fit to page 可能会导致 信箱格式:在内容缩放以适应 iFrame 后,iFrame 区域中会显示灰色背景。 若要减少信箱模式,请适当设置 iFrame 的高度和宽度。 |
![]() |
实际大小 确保报表保留在报表页面上设置的大小。 这可能会导致滚动条显示在 iFrame 中。 设置 iFrame 高度和宽度以避免滚动条。 |
![]() |
适应宽度 可确保内容填充 iFrame 的水平区域。 仍显示边框,但内容缩放以使用所有可用的水平空间。 |
iFrame 高度和宽度的建议
发布到 Web 的嵌入代码如下所示:
您可以根据自己的需要手动调整宽度和高度,以确保它准确适合嵌入页面。
若要实现更完美的拟合,可以尝试将 56 像素添加到 iFrame 的高度,以适应底部条形图的当前大小。 如果报表页使用动态大小,下表提供了一些尺寸,你可以使用这些尺寸来实现适配,而无需留边。
比率 | 尺寸 | 维度(宽度 x 高度) |
---|---|---|
16:9 | 小型 | 640 x 416 像素 |
16:9 | 中等 | 800 x 506 像素 |
16:9 | 大 | 960 x 596 像素 |
4:3 | 小型 | 640 x 536 像素 |
4:3 | 中等 | 800 x 656 像素 |
4:3 | 大 | 960 x 776 像素 |
管理嵌入代码
创建发布到 Web 嵌入代码后,可以从 Power BI 中的 “设置” 菜单管理代码。 管理嵌入代码包括删除代码的目标视觉对象或报表(呈现嵌入代码不可用)或获取嵌入代码的功能。
若要管理发布到 Web 嵌入代码,请打开报表所在的工作区,选择 “设置” 齿轮,然后选择“ 管理嵌入代码”。
在该工作区中,报表的嵌入代码会显示出来。
可以检索或删除嵌入代码。 删除它可禁用指向该报表或视觉对象的任何链接。
如果选择 “删除”,系统会要求你进行确认。
报表更新和数据刷新
创建发布到 Web 的嵌入代码并共享后,报表会更新您所做的任何更改。 嵌入代码链接立即处于活动状态。 打开链接的任何人都可以查看它。 数据在检索数据后缓存 1 小时。 对于需要频繁刷新的数据,我们不建议使用“发布到 Web”。 若要了解详细信息,请参阅本文后面的“ 工作原理 ”部分。
数据刷新
数据刷新会自动反映在嵌入的报表或视觉对象中。 在 Power BI 服务中为导入数据模型刷新数据时,该服务会清除数据缓存,从而快速更新数据。 若要禁用自动刷新,请在报表使用的语义模型的计划中选择 不刷新。
大量使用
当报表在短时间内收到过多的查询时,可能会出现使用负荷过重的情况。 用户在高使用量期间无法查看或与报表交互,直到高使用量结束。
建议为报表设置占位符图像。 如果出现大量使用情况,用户会看到占位符图像。
为了帮助避免大量使用体验,请限制报表可以生成的不同查询数以及数据刷新的频率。 有关简化报表的提示,请参阅 Power BI 优化指南 。
Power BI 视觉效果
Power BI 可视化组件支持发布到 Web。 使用“发布到 Web”时,共享已发布视觉对象的用户无需启用 Power BI 视觉对象即可查看报表。
了解嵌入代码状态列
注释
请经常查看您已发布的嵌入代码。 删除不再需要公开提供的任何内容。
“管理嵌入代码”页包含状态列。 默认情况下,嵌入 代码处于活动状态,但也可能是下面列出的状态之一。
状态 | DESCRIPTION |
---|---|
积极 | 报表可供 Internet 用户查看和交互。 |
被阻止 | 报表内容违反了 Power BI 服务条款。 Microsoft已阻止它。 如果你认为内容被错误阻止,请联系支持人员。 |
不支持 | 报表的语义模型使用行级安全性或其他不支持的配置。 请参阅“注意事项和模仿”部分以获取完整列表。 |
侵犯 | 嵌入代码位于定义的租户策略之外。 创建嵌入代码后,通常会出现这种状态,因为更改了“发布到 Web”租户设置,将拥有嵌入代码的用户排除在外。 如果已禁用租户设置,或者不再允许用户创建嵌入代码,则现有嵌入代码将显示 “侵权 ”状态。 有关详细信息,请参阅本文中的 “查找 Power BI 管理员 ”部分。 |
报告有关发布到 Web 内容的问题
若要报告与发布到嵌入在网站或博客中的 Web 内容相关的问题,请选择“发布到 Web 报表”底部栏中的“共享”图标,然后在“共享”对话框中选择“标志”图标。
你被要求发送电子邮件,向 Microsoft 解释你的担忧。 Microsoft根据 Power BI 服务条款 评估内容,并采取适当的措施。
工作原理(技术详细信息)
使用“发布到 Web”创建嵌入代码时,报表对 Internet 用户可见。 它已公开发布,因此你可以期待查看者将来通过社交媒体轻松共享报告。 用户可以通过打开公共的直接链接或查看嵌入在网页或博客中的报表来访问报告。 与它们一样,Power BI 会缓存报表定义和查看报表所需的查询结果。 此缓存可确保成千上万的并发用户可以查看报表,而不会影响性能。
数据在检索数据后缓存 1 小时。 如果更新报表定义(例如,如果更改其视图模式)或刷新报表数据,则更改可能需要一些时间才能反映在用户查看的报表版本中。 当导入数据模型发生数据刷新时,服务将清除缓存的数据并检索新数据。 在大多数情况下,数据与数据导入几乎同时更新。 但是,对于具有许多不同查询的报表,可能需要一些时间来更新。 由于每个元素和数据值都单独缓存,因此当发生数据更新时,用户可能会看到当前值和以前的值混合。 因此,我们建议提前准备工作,并仅在对设置感到满意时生成发布到 Web 的嵌入代码。 如果数据将刷新,请将刷新次数降至最低,并在空闲时间执行刷新。 对于需要频繁刷新的数据,我们不建议使用“发布到 Web”。
查找 Power BI 管理员
Power BI 管理门户具有可控制谁可以发布到 Web 的设置。 请与组织的 Power BI 管理员 协作,在管理门户中更改 “发布到 Web 租户”设置 。
对于注册 Power BI 的小型组织或个人,你可能还没有 Power BI 管理员。 请按照我们的 管理员接管步骤。 一旦你有了 Power BI 管理员,他们就可以为你启用嵌入代码。
已建立的组织通常已有 Power BI 管理员。 Microsoft Entra ID 中具有 Fabric 管理员角色的用户可以充当 Power BI 管理员。
你需要在组织中找到其中一个人员,并要求他们更新管理门户中的“发布到 Web 租户”设置。
注意事项和限制
Power BI 服务中绝大多数数据源和报表都支持发布到 Web。 但是,目前以下类型的报告 不支持 发布到 Web,也不可用:
- 应用行级安全性的报表。
- 使用 DirectQuery 连接到数据的报表。 请改用复合模式或导入模式进行连接。 了解 模式之间的差异。
- 使用任何实时连接数据源的报表,包括本地托管的 Analysis Services 表格模型、Analysis Services 多维模型以及 Azure Analysis Services。
- 报表使用存储在与其不同工作区中的共享语义模型。
- 共享和认证的语义模型。
- 直接或通过应用共享的报表。
- 你不是编辑成员的工作区中的报表。
- “发布到 Web 报表”中当前不支持“R”和 Python 视觉对象。
- 从已发布到 Web 的报表中导出的图形数据。
- Power BI 视觉对象功能的问与答。
- 包含报表级 DAX 度量值的报表。
- 单一登录数据查询模型,包括 Power BI 语义模型或 Azure Analysis Services 上的复合模型。
- 保护机密或专有信息。
- 嵌入选项提供的自动身份验证功能不适用于 Power BI JavaScript API。 对于 Power BI JavaScript API,请使用 用户拥有数据 方法来嵌入。
- 管理员可以阻止公共互联网访问,具体方法详见 专用链接以实现对 Fabric 的安全访问。 在这种情况下,您租户在 Power BI 管理门户中的“发布到 Web”选项将显示为灰色,不可用。
- 自定义视觉对象的许可证强制执行。
- 当组织针对未认证视觉对象的全局租户开关处于开启状态时,组织商店中的未认证视觉对象会被激活。
- 当组织的全局租户切换不允许使用 Power BI SDK 创建的可视化时,从组织存储中获取的公共可视化。
- 创建嵌入代码的用户需要保持对报表的访问权限,以便嵌入代码正常工作。 这包括根据工作区的要求,需要提供 Pro 或高级每用户许可。
- 移动布局视图。
- 分页报表。
- 多语言报表。
相关内容
更多问题? 尝试参与 Power BI 社区