文章目录
文章目录
本文目录
本文目录

石墨办公文档中台私有部署能嵌进 OA 吗?三类接入方式与验收要点

石墨办公 + AI

能。石墨办公文档中台私有部署通过 JSSDK、JSAPI、服务端 API 和事件回调嵌入 OA、ERP、CRM。说明三类接入方式、双方职责分工、PoC 五项验收与计费方式。

能。石墨办公文档中台私有部署(以下简称文档中台)通过 JSSDK、JSAPI、服务端 API 和事件回调,把在线预览、编辑、格式转换和多人协作嵌入 OA、ERP、CRM、门户等已有系统。它不替代业务系统的入口和流程:用户、文件、权限与审批仍由接入方掌握,文档中台负责“文件打开以后”的能力。

所以评估重点不是“能不能嵌”,而是三件事:前端怎么嵌、后端怎么取放文件、业务流程怎么接住文档事件。本文是面向 OA 嵌入的速查,重点放在接入方式、PoC 验收和计费;从附件预览到协同闭环的完整接入过程,可以参考业务系统如何接入 Shimo Office SDK。

三层结构:最上层是 OA、ERP、CRM 等业务系统;中间是三类接入方式,前端嵌入使用 JSSDK 和 JSAPI,后端使用服务端 API 处理内容与文件,事件回调把文档动作通知业务流程;最下层是部署在企业环境中的石墨办公文档中台私有部署。
原创示意:业务系统通过三类方式调用文档中台,权限与流程仍归业务系统。

三类接入方式

前端嵌入:JSSDK 与 JSAPI

在 OA 的审批页、合同详情页里直接打开文档编辑器,用户不必下载文件、切换到本地 Office。JSAPI 让业务页面可以调用编辑器提供的操作接口,具体接口以开发文档为准。适合“在系统里在线看、在线改”的场景。

后端调用:服务端 API

业务系统在服务端创建文档、导入导出文件、读取内容或做格式转换,例如把审批通过的合同批量转成版式文件归档。文档中台提供高保真格式转换,也支持 OFD 格式。

流程联动:事件回调

文档相关事件和安全事件通过回调通知业务系统,用来完成流程联动与结果通知,具体事件类型以开发文档为准。安全事件回调可以让业务系统在事件触发时及时联动响应。

谁负责什么

文档中台与接入方的职责分工
事项石墨办公文档中台私有部署提供接入方负责
身份与权限托管或复用企业既有权限体系,提供文字水印、权限接口与安全事件回调决定谁能看、谁能改,设计身份映射
业务入口可嵌入的编辑器与预览能力在哪个页面、哪个流程节点打开文档
文件存储与流转文档存储、版本与格式处理文件与业务单据的对应关系
异常处理接口错误与事件通知超时、重试、失败后的业务补偿

官网的说法很直接:接入方仍需设计身份、权限、业务入口、事件通知和异常处理。把这张分工表写进技术方案,能避免上线后才发现“谁来处理失败重试”无人认领。

PoC 时验收这五项

  1. 用 3–5 份真实业务文件(含表格、公文版式)在嵌入页面打开、编辑、保存,核对格式还原。
  2. 用两个不同权限的账号访问同一份文件,确认只读、编辑、下载权限与业务系统一致。
  3. 模拟多人同时编辑同一份文件,确认协作和冲突表现符合预期。
  4. 触发开发文档列出的典型事件,确认回调按时到达,业务流程能正确推进。
  5. 按业务系统中的文档操作与峰值并发估算容量,不要用员工总数代替并发需求;可用并发计算器辅助评估,并发、延迟和复杂文件表现以 PoC 结果为准。

费用怎么算

文档中台私有部署按并发计费:商业版 ¥1000 / 并发 / 年,30 并发起售,含 5 个应用接入,新增应用另计;也可以先用 30 天、30 并发的试用版完成 PoC。详见文档中台定价。

如果员工同时需要统一的协作入口,可以把文档中台与办公套件私有部署组合建设。准备好要接入的系统清单、典型文件和预计并发后,预约演示确认接入路径与 PoC 范围。

在企业文档中验证

需要在自己的环境中验证时,可先了解私有化部署方案,再确定试用范围与验收要求。