# 在 SharePoint Online 中嵌入Power BI报表网页部件——完整操作指南

> 作者：吉祥法师

## 一、核心功能概述

Power BI报表网页部件（Power BI Report Web Part）为SharePoint Online用户提供了一种强大而灵活的内容集成方案。通过这一功能，企业可以将交互式的Power BI报表和可视化对象直接嵌入到SharePoint Online的现代页面中，无需在多个系统间来回切换，即可实现数据洞察的高效共享与协同工作。

使用SharePoint Online中的“嵌入”选项时，所嵌入的报表和可视化内容会严格遵守所有项目权限，并通过行级安全性（Row-Level Security, RLS）确保数据安全。这意味着每位用户仅能查看其被授权访问的数据范围，为构建安全可靠的内部门户提供了坚实保障。企业可以借此机会，将关键的绩效指标、运营数据看板以及管理层驾驶舱等内容集成到统一的办公平台上，实现信息的集中化管理和分发。

## 二、环境准备与前置要求

在正式开始嵌入报表之前，需要进行全面且细致的准备工作。确保满足以下各项前置条件，是顺利完成嵌入工作的基础：

### 2.1 页面环境要求
Power BI网页部件仅支持SharePoint Online的**现代页面（Modern Pages）**。用户需要确认所使用的站点页面已正确配置为现代页面形式，传统经典页面无法使用此网页部件。

### 2.2 用户许可与登录要求
使用嵌入报表的用户，必须先登录Power BI服务以激活其Power BI许可证。尚未激活许可证的用户，在访问嵌入了报表的SharePoint页面时，会看到相关的提示或无法正常加载内容。

### 2.3 许可证类型详解
许可证的配置涉及多方面的因素，具体需要依据企业的部署场景来决定：

| 使用场景 | 许可证要求 | 详细说明 |
|---------|-----------|---------|
| **面向组织嵌入（用户拥有数据）** | F64或更高SKU；或Pro/PPU许可证 | 若使用SKU低于F64，则每个查看嵌入内容的用户都必须拥有Pro或PPU许可证 |
| **面向客户嵌入（应用程序拥有数据）** | 终端用户无需许可证 | 由应用负责数据处理，最终用户不需要单独授权 |
| **网页部件创建者** | 必须持有Pro或PPU许可证 | 用于创建工作区的报表并配置嵌入相关选项 |

### 2.4 特殊环境支持
值得特别关注的是，**SharePoint嵌入功能已扩展支持气隙环境（Air Gap Environments）**。这意味着在高安全性或隔离网络环境下的企业部署，也可以充分利用此功能进行数据呈现与分享。

## 三、嵌入报表与可视化内容的详细流程

将Power BI内容嵌入到SharePoint Online的操作方式灵活多样，用户既可以直接浏览工作区进行选择，也可以使用报表的专属URL进行精准定位。以下将全面解析具体实施步骤。

### 3.1 在SharePoint Online页面中添加Power BI网页部件

要将报表集成至页面中，请依次执行以下具体步骤：

**第一步：打开或创建目标页面**
在SharePoint Online中，打开需要编辑的目标页面，点击右上角的“编辑（Edit）”按钮进入页面编辑模式。如需创建全新页面，可选择“页面（Pages）”-“+ 新建（+ New）”-“站点页面（Site Page）”来创建一个新的现代站点页面。

**第二步：添加Power BI网页部件**
在页面编辑状态下，点击“新（New）”下拉菜单中的“+”，在弹出窗口的“数据分析（Data Analysis）”分组下，选择“Power BI”网页部件。

**第三步：添加内容**
成功添加“Power BI”网页部件后，点击部件内部的“添加内容（Add content）”按钮，由此启动内容选择流程。

### 3.2 方法一：通过URL选定报表

**获取报表URL**：
1. 在Power BI服务中打开需要嵌入的报表。
2. 点击顶部菜单“文件（File）”，在下拉菜单中选择“嵌入报表（Embed report）”，并点击“SharePoint Online（SharePoint Online）”选项。
3. 在弹出的对话框中，复制系统生成的报表URL。

**粘贴URL到部件**：
返回SharePoint页面，将该URL直接粘贴到Power BI网页部件的内容菜单栏中。

**实用注意事项**：
- **URL筛选器**：此嵌入方式虽支持URL筛选器功能，但系统目前**不支持自动附加**，用户必须手动将所需筛选器参数添加到URL后面，才能正确应用筛选条件。

### 3.3 方法二：通过浏览工作区选定

如果更倾向于以可视化方式选择内容，可以采用浏览操作：

**选择工作区**：
1. 点击“添加内容”后，选择“浏览工作区（Browse workspaces）”选项。
2. 系统随即会出现“工作区（Workspace）”下拉菜单，选择需要嵌入内容的专属工作区。

**选定报表及页面**：
1. 选定工作区后，从“报表（Report）”下拉菜单中挑选需要嵌入的报表。
2. 若仅希望展示报表中的特定页面，可在“报表页面（Report Page）”下拉菜单中选择指定页面。

**嵌入单个视觉对象**：
如需更加聚焦地向用户展示某一具体数据图表，可开启“嵌入单个视觉对象（Embed a single visual）”切换按钮。启用后，使用“视觉对象（Visual）”下拉菜单选择需嵌入的特定图表或视图。

### 3.4 发布和保存操作

全部设置完毕后，点击页面右上角的“发布更改（Publish changes）”按钮，使所有调整对SharePoint Online的广大用户可见。

## 四、报表访问权限的管理与授予

在SharePoint Online中嵌入Power BI内容，**并不等同于**自动向所有页面用户授予报表的查看权限。必须由报表管理人员在Power BI服务内，明确设置和分配用户对报表内容的查看权限。

### 4.1 权限设置的关键检查

部署嵌入报表前，务必在Power BI服务中全面审查报表的可见范围。确认哪些用户或用户组已列入访问名单，对未授予访问权限的相关人员，补充其查看报表所需的授权。

### 4.2 授权方式一：基于Microsoft 365组进行管理

如果正在利用Microsoft 365组来构建团队站点，可以将指定用户添加为该组成员，具体操作步骤如下：
1. 在Power BI服务中，将目标用户添加为“工作区（Workspace）”的成员。
2. 确认这些用户同样存在于SharePoint Online页面的访问列表中。

### 4.3 授权方式二：通过应用直接共享

这是另一种更为精细和受控的权限管理方式，适用于需要在更大范围内分配访问权限的场景：

**创建应用并安装**：
1. 在Power BI中创建一个工作区，则该工作区应位于**高级容量（Premium capacity）** 之中，这是将应用共享给使用免费许可证用户的基本前提。
2. 在工作区内创建所需要的报表。
3. 发布该应用，并自行完成安装操作。安装应用是必须环节，这样可以确保获取用于嵌入SharePoint的报表URL路径式地址。
4. 所有最终用户也必须安装该应用。为简化流程，可利用Power BI管理门户中的“**自动安装应用**”功能，或在管理门户中启用应用**推送（Pushing Apps）** 功能，由此实现应用的自动预安装。

**提取正确的URL**：
打开已安装的应用，并找到目标报表，从应用内报表中**复制专用嵌入URL**。这个URL地址有别于工作区内的原始报表URL，是嵌入流程中不可忽视的一环，使用错误链接将无法正常显示。

**配置页面与访问权限**：
1. 在SharePoint Online中，创建一个新的团队站点。
2. 将刚复制的应用内报表URL，粘贴至Power BI网页部件的内容框中。
3. 将需要消费数据的成员或其所属用户组，同步添加到SharePoint Online页面以及发布的应用权限列表之中。

**关键校验点**：
用户或组只有同时具备“SharePoint Online页面的访问权”和“该Power BI应用内报表的浏览权”，才能在团队站点上成功看到报表内容。最终用户可直接访问该团队站点，无需跳转其他系统即可查看相关数据报表。

## 五、安全访问与常见错误处理

### 5.1 多重身份验证（MFA）支持说明

若Power BI环境强制要求使用多重身份验证（MFA），用户在访问时可能需要通过手机应用、智能卡等安全设备进行二次验证。一种常见场景是，当用户当前并未通过MFA登录SharePoint Online，而Power BI环境要求验证账户信息时，便会触发验证请求。

**特殊限制提示**：
Power BI不支持与**Microsoft Entra ID 2.0** 结合的多重身份验证，此种情况用户可能会看到错误提示。作为备选方案，用户可使用安全设备重新登录SharePoint Online，或许能够成功加载报表。

### 5.2 报表加载失败原因分析

如果嵌入到网页部件中的报表或视觉对象无法正常加载，页面会显示相应错误消息。常见原因集中在以下两点：
1. **用户没有报表访问权限**：需由具备权限的人员，对用户在Power BI中进行共享授权操作。
2. **报表或视觉对象已被删除**：原始报表文件在Power BI服务中已被清理，需要检查报表的存在状态。

此时可联系SharePoint页面所有者，协助排查和解决相关故障。

## 六、网页部件的属性设置详解

Power BI网页部件具有多项可调整属性，用以优化最终展现效果：

| 属性 | 功能描述 |
|------|---------|
| **页面名称（Page name）** | 设定网页部件的默认展示页面。若下拉列表为空，可能因报表只有单一页面，或粘贴的URL已包含特定页面名称。移除URL中的报表区段后，才能自由选择展示页面 |
| **显示（Display）** | 决定报表在SharePoint页面中的适配尺寸和排版方式 |
| **显示导航窗格** | 控制是否在嵌入报表中展示页面导航栏 |
| **显示筛选器窗格** | 决定是否在嵌入式报表中显示筛选器区域 |
| **显示操作栏** | 设置是否在嵌入内容的顶部展示操作菜单 |
| **显示移动或电子邮件视图** | 开关此项，用于决定是否允许用户从移动设备或邮件视图中访问内容 |

## 七、嵌入报表中的Copilot功能启用

为了进一步强化嵌入报表的分析交互能力，可以在嵌入对话框中激活“**启用 Copilot（Enable Copilot）**”复选框。此功能具有一定的前提要求：必须激活有效的Copilot租户开关，并且相关工作区必须部署有Power BI Premium或付费Fabric容量。

启用成功后，用户可直接在嵌入报表内部与Copilot进行交互问答，获得更智能化和洞察式的数据分析辅助。操作路径：从“文件（File）”菜单选择“嵌入报表（Embed report）”-“SharePoint Online（SharePoint Online）”，勾选“启用 Copilot”复选框后确认。

## 八、已知问题与局限性全览

任何技术方案都存在特定边界和局限性，Power BI SharePoint嵌入功能也不例外，使用时应当充分了解：

| 问题现象 | 排查与解决方案 |
|---------|---------------|
| 错误码400 “缺少刷新令牌” | 退出SharePoint并彻底关闭所有浏览器窗口，再重新登录；若账号启用MFA，需使用MFA设备登录验证 |
| Azure B2B来宾账户无法加载 | 该嵌入方案不支持Azure B2B来宾账户（无论是个人账户还是组成员） |
| 加载图标循环但报表不可见 | 确认网络连接状态、用户权限，并清除浏览器缓存后重试 |
| 环境切换缺失 | 在查看、更新或添加嵌入报表的流程中，缺乏Power BI环境切换的用户选项 |
| 本地化显示异常 | Power BI本地化支持的语种与SharePoint Online列表不完全一致 |
| Internet Explorer 10不兼容 | IE10存在兼容性问题，建议升级至Microsoft Edge或使用其他受支持的现代浏览器 |
| 经典SharePoint Server不支持 | 该网页部件仅面向SharePoint Online的现代页面，不支持经典模式 |
| 应用内嵌入限制 | 不能直接在嵌入的SharePoint站点内容中访问整个Power BI应用，须先在Power BI服务中打开并登录应用，再返回页面查看相应报表 |
| 图片URL限制 | 受浏览器安全策略限制，来自本地网络（Local Network）的图像URL无法显示 |
| 筛选器手动附加 | URL筛选器虽被支持，但无自动追加功能，各用户需要时需手动设置参数 |

## 九、后续相关操作与延伸资源

为了在组织内部全面发挥这项功能的价值，可参考以下相关操作文档：
- 允许用户创建现代页面
- 在Power BI中发布应用
- 向同事和其他用户共享Power BI报表与仪表板
- Power BI Premium介绍
- 在安全门户或网站中嵌入报表
- 若需更深入交流，建议前往Power BI社区进行提问与讨论。

借助Power BI SharePoint Online嵌入式网页部件的强大能力，企业可快速搭建安全、交互且满足精细化权限控制的数据分析门户，全面提升组织内部的数据驱动效能。