Confluence 集成金蝶云星空解决方案
更新: 10/22/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| Confluence 企业知识库 |  | 金蝶云星空 |
研发、产品与项目部习惯在 Confluence 中沉淀产品规格、BOM 说明、项目交付物、SOP 与制度文件，而这些知识资产与金蝶云星空（物料档案、项目文档、附件中心）长期处于割裂状态：
- 产品资料与 ERP 物料脱节：Confluence 里的产品规格、参数表更新后，ERP 物料档案仍引用旧版，销售报价、采购下单引用错误版本。
- 项目交付物散落知识库：项目里程碑文档、验收报告只在 wiki 里，金蝶项目模块无法关联，交付审计难追溯。
- 制度 / SOP 更新不同步：新制度发布后 ERP 侧流程说明仍是旧版，合规风险高。
- 人工搬运文档：IT 与文控每周手动导出 PDF 再上传 ERP，重复劳动且易遗漏版本。
基于成集云数据集成平台，通过 Confluence Cloud REST API v2 + Webhook，将空间、页面、附件、标签与评论自动同步到金蝶云星空，实现「知识库一处维护、业务系统多方可用」。
解决方案
在成集云中配置 Confluence 连接器（OAuth 2.0 / API Token 鉴权），监听指定空间与标签的页面变更事件（page_created / page_updated / page_removed）。事件触发后，成集云拉取页面正文、版本、附件与标签，按规则映射为金蝶云星空的文档、物料附件或项目文档；同时以 15 分钟增量轮询兜底补漏。反向可配置：金蝶新建客户 / 项目时，自动在 Confluence 生成对应空间与首页，实现双向打通。
业务流程
一、基础资料同步流程
1. 空间与页面同步流程
2. 产品资料与附件同步流程
二、业务单据同步流程
3. 项目交付物同步流程
4. 文档评论与协作同步流程
三、实时触发与反向同步
5. Webhook 实时变更触发流程
6. ERP 主数据新建反向建空间流程
对接说明
一、基础资料同步（Confluence → 金蝶云星空）
| Confluence 对象 | 金蝶云星空目标 | 说明 |
|---|---|---|
| 空间 Space | 文档分类 / 知识库分类 | 按 space key 映射 |
| 页面 Page | 文档（标题 / 正文 HTML / 版本） | 保留 version.number |
| 附件 Attachment | 文档附件 / 物料附件 | 二进制随文档同步 |
| 标签 Label | 文档标签 / 物料分组 | 用于过滤与归类 |
| 用户 User | 员工 / 创建人 | 邮箱匹配 |
二、业务单据同步（Confluence → 金蝶云星空）
- 产品页面（标签 = product）→ 金蝶 物料档案 + 物料文档附件，正文作为规格说明。
- 项目交付物（标签 = project，关联项目号）→ 金蝶 项目文档，挂接到对应项目。
- 制度 / SOP 页面（标签 = policy）→ 金蝶 文档中心并置为「生效」状态，旧版自动归档。
- 评论 Comment → 金蝶 文档评论 / 跟进记录，保留作者与时间。
三、同步规则与过滤条件
- 空间白名单：仅同步指定 space key，避免全量知识库进入 ERP。
- 标签过滤：通过 label（product / project / policy）决定映射目标，避免无关页面同步。
- 增量机制：优先 Webhook 实时触发；并以
version.createdAt/ 15 分钟轮询兜底补偿，防止漏单。 - 版本冲突：金蝶侧以 Confluence 最新
version.number覆盖，保证单一可信版本。 - 安全校验：Webhook 通过
x-atlassian-webhook-signature头做 HMAC-SHA256 验签，拒绝伪造请求。 - 失败重试：接口 429 限流按
Retry-After退避重试，保障最终一致。
业务价值
- 知识资产统一：产品、项目、制度文档一处维护，ERP 多方即时可用，消除版本混乱。
- 交付可追溯：项目交付物自动归档到金蝶项目模块，审计与验收一键调阅。
- 合规一致：新制度发布即同步 ERP，流程说明始终最新。
- 降本增效：文控与 IT 不再手动搬运文档，按周节省数小时重复劳动。
- 双向联动：ERP 主数据新建可反向生成知识库空间，知识沉淀与业务启动同步发生。
接口文档
- Confluence Cloud REST API v2（
https://{site}.atlassian.net/wiki/api/v2），认证支持 OAuth 2.0 或 API Token（邮箱 + Token 的 HTTP Basic）；分页采用 cursor（响应 Link 头），按 Points 配额限流。 - Webhooks：
/wiki/rest/api/webhook，支持page_created/page_updated/page_removed事件，签名头x-atlassian-webhook-signature。 - 金蝶云星空 OpenAPI（物料、文档、项目、附件相关接口）。