# 将易企办附件归档到 SharePoint

从下载的 YCS 文件导入易企办自定义服务。绑定目标 Microsoft Graph 的 OAuth HTTP 连接，再在测试流程中传入文件变量、目标文档库和重名策略。服务处理一个或多个文件，并返回归档目录和逐文件结果。

## 输入和连接

| 配置 ID | 类型 | 用途 |
| --- | --- | --- |
| `documentFiles` | 文件 | 一个文件或含多个附件的文件变量。 |
| `siteUrl` | 文本 | 目标 SharePoint 站点的 HTTPS 地址。 |
| `libraryNameOrId` | 文本 | 文档库的显示名称或 Graph drive ID。 |
| `folderPath` | 文本 | 相对于文档库根目录的路径。留空写入根目录，指定多级目录时可逐级创建。 |
| `conflictBehavior` | 文本 | 同名文件处理规则，默认 `fail`。 |
| `sharePointConnection` | OAuth HTTP 连接 | 可按场景读取文档库、创建文件夹并写入文件的受管连接。 |

全球版站点使用全球版 Microsoft Graph。世纪互联的 `.sharepoint.cn` 站点使用中国区 Microsoft Graph。请配置与站点所属云匹配的连接。

## 重名策略

| 值 | 结果 |
| --- | --- |
| `fail` | 此文件记为失败，继续处理其余文件。 |
| `replace` | 替换同名文件，历史版本按文档库规则保存。 |
| `rename` | 由 SharePoint 自动分配新文件名，保留两个文件。 |
| `skip` | 保留已有文件，结果中记为跳过。 |

## 输出

- `archived` 表示没有文件处理失败。选择跳过时，还需要看 `skippedCount` 确认新文件是否上传。
- `uploadedCount`、`skippedCount`、`failedCount` 分别记录上传、跳过和失败数量。
- `archiveFolderWebUrl` 返回归档目录链接。
- `archiveResultsJson` 返回逐文件的原文件名、实际文件名、链接及状态。成功、替换、重命名、跳过和失败可分别在后续节点处理。

## 测试

先用一份样例报价文件和测试文档库验证上传。再准备有同名文件的目录，分别测试四种策略、空目录和多级目录，核对归档结果回写。此模板使用 Graph 简单上传接口，单文件需符合 250 MB 上限和目标环境的其他限制。正式使用前，请在目标易企办和 SharePoint 租户中验证连接、站点权限及工作流调用。