# SharePoint 文档库浏览器

该自定义代码控件用于在易企办页面浏览 SharePoint 文档库。将完整 TSX 源码粘贴进自定义代码控件，配置目标站点和文档库，再绑定拥有读取权限的 OAuth HTTP 连接。

## 参数和连接

| 配置 ID | 类型 | 用途 | 示例 |
| --- | --- | --- | --- |
| `sharePointConnection` | OAuth HTTP 连接 | 绑定目标 Microsoft Graph 云环境的受管连接。 | — |
| `siteUrl` | 变量 | SharePoint 站点的 HTTPS 地址，例如 `https://contoso.sharepoint.com/sites/Procurement`。 | `https://contoso.sharepoint.cn/sites/Procurement` |
| `libraryNameOrId` | 变量 | 文档库显示名称，或 Microsoft Graph 返回的 drive ID。 | `共享文档` |
| `folderPath` | 变量 | 相对于文档库根目录的起始路径，留空时显示根目录。 | `供应商报价/2026` |
| `title` | 文本 | 自定义浏览器标题，例如「采购归档资料」。 | `采购归档资料` |

对于 `.sharepoint.com` 站点，控件使用全球版 Microsoft Graph。对于 `.sharepoint.cn` 站点，控件使用世纪互联运营版 Microsoft Graph。连接的授权端点、资源和租户须与站点所属云一致。凭据由易企办连接管理。

## 配置示例

在采购表单上配置文档库「共享文档」和起始目录「供应商报价/2026」。首次打开时显示该目录的直接子项目。展开文件夹时按需读取其内容，刷新会重新加载当前配置的起始位置。

控件沿用 Graph 的分页，显示文件名称、类型、修改时间和大小。点击「打开」会跳转到 SharePoint，用户在 SharePoint 中仍需具有相应权限。该控件仅用于读取和打开文件。

## 验收

- 用已授权账号测试文档库根目录和已配置的多级起始路径。
- 检查展开、折叠、刷新、空目录和窄屏显示。
- 用包含多页结果的文档库确认分页完整，并核对 SharePoint 的文件访问权限。
- 用缺少站点权限或目录不存在的测试场景确认错误反馈。
- 使用对应云环境的连接验证应用中的实际读取行为。