能。石墨办公文档中台私有部署(以下简称文档中台)通过 JSSDK、JSAPI、服务端 API 和事件回调,把在线预览、编辑、格式转换和多人协作嵌入 OA、ERP、CRM、门户等已有系统。它不替代业务系统的入口和流程:用户、文件、权限与审批仍由接入方掌握,文档中台负责“文件打开以后”的能力。
所以评估重点不是“能不能嵌”,而是三件事:前端怎么嵌、后端怎么取放文件、业务流程怎么接住文档事件。本文是面向 OA 嵌入的速查,重点放在接入方式、PoC 验收和计费;从附件预览到协同闭环的完整接入过程,可以参考业务系统如何接入 Shimo Office SDK。
三类接入方式
前端嵌入:JSSDK 与 JSAPI
在 OA 的审批页、合同详情页里直接打开文档编辑器,用户不必下载文件、切换到本地 Office。JSAPI 让业务页面可以调用编辑器提供的操作接口,具体接口以开发文档为准。适合“在系统里在线看、在线改”的场景。
后端调用:服务端 API
业务系统在服务端创建文档、导入导出文件、读取内容或做格式转换,例如把审批通过的合同批量转成版式文件归档。文档中台提供高保真格式转换,也支持 OFD 格式。
流程联动:事件回调
文档相关事件和安全事件通过回调通知业务系统,用来完成流程联动与结果通知,具体事件类型以开发文档为准。安全事件回调可以让业务系统在事件触发时及时联动响应。
谁负责什么
| 事项 | 石墨办公文档中台私有部署提供 | 接入方负责 |
|---|---|---|
| 身份与权限 | 托管或复用企业既有权限体系,提供文字水印、权限接口与安全事件回调 | 决定谁能看、谁能改,设计身份映射 |
| 业务入口 | 可嵌入的编辑器与预览能力 | 在哪个页面、哪个流程节点打开文档 |
| 文件存储与流转 | 文档存储、版本与格式处理 | 文件与业务单据的对应关系 |
| 异常处理 | 接口错误与事件通知 | 超时、重试、失败后的业务补偿 |
官网的说法很直接:接入方仍需设计身份、权限、业务入口、事件通知和异常处理。把这张分工表写进技术方案,能避免上线后才发现“谁来处理失败重试”无人认领。
PoC 时验收这五项
- 用 3–5 份真实业务文件(含表格、公文版式)在嵌入页面打开、编辑、保存,核对格式还原。
- 用两个不同权限的账号访问同一份文件,确认只读、编辑、下载权限与业务系统一致。
- 模拟多人同时编辑同一份文件,确认协作和冲突表现符合预期。
- 触发开发文档列出的典型事件,确认回调按时到达,业务流程能正确推进。
- 按业务系统中的文档操作与峰值并发估算容量,不要用员工总数代替并发需求;可用并发计算器辅助评估,并发、延迟和复杂文件表现以 PoC 结果为准。
费用怎么算
文档中台私有部署按并发计费:商业版 ¥1000 / 并发 / 年,30 并发起售,含 5 个应用接入,新增应用另计;也可以先用 30 天、30 并发的试用版完成 PoC。详见文档中台定价。
如果员工同时需要统一的协作入口,可以把文档中台与办公套件私有部署组合建设。准备好要接入的系统清单、典型文件和预计并发后,预约演示确认接入路径与 PoC 范围。
在企业文档中验证
需要在自己的环境中验证时,可先了解私有化部署方案,再确定试用范围与验收要求。