已有 OA 和 ERP，如何接入在线文档预览、编辑和多人协作？
企业已有 OA 和 ERP 后，通常不需要重建一套文档系统。通过文档中台的 API、SDK 和事件回调，可以把预览、在线编辑、多人协作和版本能力嵌入原有流程。无论是 OA 集成在线文档，还是 ERP 在线编辑附件，关键都是让用户、文件、权限、保存和结果回传形成完整业务闭环。
为什么已有 OA 和 ERP，还需要接入在线文档能力？
OA 擅长管理审批、制度、公文和组织流程，ERP 擅长管理采购、销售、库存、财务和生产数据。但是在很多实际业务中，流程和数据最终仍要落到 Word、Excel、PPT、PDF 或 OFD 等文件上。
常见工作方式是：员工从 OA 或 ERP 下载附件，在本地 Office 中修改，再重新上传。多人参与时，还要通过即时通讯或邮件来回传递文件。
这套方式看似简单，却容易出现几个问题：
- 同一份文件产生多个副本，不容易确认哪个是最新版本；
- 文件下载到个人电脑后，数据流转边界变得更复杂；
- 审批意见、文档修改和业务流程分散在不同系统；
- 多人无法围绕同一份内容实时协作；
- 文件修改后需要重新上传，业务状态与文档状态容易脱节；
- 历史版本、评论和修改记录难以统一追溯。
因此，企业真正需要解决的，不是“再增加一个文档工具”，而是让在线文档能力进入 OA、ERP 和其他业务流程。
什么是文档中台？它与独立在线办公平台有什么区别？
文档中台是面向业务系统的文档能力底座。它通过前端 SDK、后端 API 和回调接口，把文档预览、在线编辑、格式转换、多人协作、评论和版本能力嵌入已有系统。
员工仍然从原来的 OA 审批单、ERP 业务单据、合同页面或项目页面进入，不必切换到另一个独立办公入口。
企业既需要统一协作空间，又需要在重点业务中嵌入文档能力时，也可以组合使用两种路线。但两个入口分别承担什么工作，必须提前划分清楚。
OA 和 ERP 接入在线文档，需要跑通哪些环节？
只把编辑器放进页面，并不代表系统已经完成集成。一个可以正式使用的接入方案，至少要跑通以下链路：
业务入口 → 用户身份 → 目标文件 → 操作权限 → 在线预览或编辑 → 多人协作 → 保存与版本 → 事件或结果回传 → 继续原业务流程
石墨文档中台公开的快速接入方案，将参与系统分成三层：
- 业务系统：提供当前用户、目标文件、权限结果和业务流程；
- 企业集成服务：负责参数映射、接口封装、事件接收和异常处理；
- 文档中台：提供在线预览、编辑、格式转换和多人协作能力。
这里最重要的不是技术名词，而是明确责任：谁管理用户，谁保存文件，谁判断权限，谁接收保存结果，出现异常时由哪个系统处理。
第一部分：先确定文件由谁管理
企业接入在线文档时，首先要确认原始文件、协同内容和历史版本分别由哪套系统管理。
对于已有 OA、ERP 的企业，常见目标是继续保留原系统中的业务归属。例如：
- OA 继续管理公文、制度和审批附件；
- ERP 继续管理采购合同、报价单、订单附件和业务报表；
- 文档中台负责提供在线预览、编辑和协作界面；
- 编辑结果、版本状态或相关事件再回到业务系统。
采购和技术评估时，应重点确认：
- 文档中台打开文件时，从哪里读取文件；
- 编辑完成后，文件保存到哪里；
- 是否产生临时文件、转换文件或协同快照；
- 历史版本由业务系统保存，还是由文档中台保存；
- 文件删除、归档和到期清理如何同步；
- 系统替换时，原始文件、版本和元数据能否导出。
如果这些问题没有提前明确，上线后可能出现 OA 一份文件、文档中台又保存一份文件，两边版本无法对应的情况。
第二部分：让用户身份和权限保持一致
员工从 OA 或 ERP 打开一份文件时，文档中台需要知道三个信息：
- 当前用户是谁；
- 当前打开的是哪一份文件；
- 当前用户可以执行什么操作。
不同角色的权限可能完全不同：
- 起草人可以编辑；
- 审批人可以批注或修订；
- 抄送人只能查看；
- 外部协作者只能访问指定版本；
- 财务人员可以填写表格中的指定区域；
- 管理员可以查看审计记录，但不一定可以查看所有业务内容。
石墨文档中台的在线 Demo 展示了按身份动态返回编辑、评论和只读权限的场景，产品页也公开了既有权限复用、水印和安全事件回调能力。
在实际项目中，需要继续验证：
- OA、ERP 的账号和组织信息如何传递；
- 权限由业务系统实时判断，还是同步到文档中台；
- 用户调岗、离职或角色变化后，权限多久生效；
- 禁止下载、复制、打印或外发等策略由谁下发；
- 水印内容是否可以携带用户和业务信息；
- 越权访问、失效链接和接口重放如何处理。
第三部分：区分前端 SDK、后端 API 和回调接口
企业不需要把所有接口都背下来，但要理解三类接口分别解决什么问题。
前端 JS SDK：把文档能力嵌入页面
前端 SDK 主要运行在浏览器页面中，用于加载编辑器、调用界面和内容能力，并监听用户在文档中的操作。
典型用途包括：
- 在 OA 审批页打开文档；
- 在 ERP 单据页预览附件；
- 打开历史版本或评论区域；
- 监听标题、内容或界面状态变化；
- 根据业务需求控制可见功能。
后端 API：在服务器侧管理文件和内容
后端 API 由企业应用后端调用。石墨文档中台当前可访问的官网公开方案披露，后端能力涉及应用管理、用户席位、协同文件、预览文件、导入导出、表格内容、纯文本、评论和历史版本等方向。
典型用途包括：
- 创建、复制或删除协同文件；
- 导入本地 Office 文件；
- 导出处理后的文件；
- 获取文档纯文本；
- 读取或写入表格数据；
- 获取评论、历史和版本信息；
- 查询导入导出任务进度。
应用密钥应保存在企业应用后端，不能写入前端代码。具体接口、请求头、鉴权方式和版本范围，应以项目采用的开发文档为准。
回调接口：让文档中台获得业务上下文
回调接口通常由接入企业实现，再由文档中台调用。它的作用是向原系统获取用户、文件、权限、组织或业务信息，并把事件或处理结果送回业务流程。
典型用途包括：
- 获取当前用户信息；
- 获取文件元信息或下载地址；
- 判断用户是否可以查看、编辑或评论；
- 返回组织和协作者信息；
- 接收保存、权限、安全或协作事件；
- 将错误和状态交给业务系统处理。
前端 SDK、后端 API 和回调接口需要配合使用。只完成页面嵌入，没有打通身份、文件、权限和结果回传，仍然只是一个演示页面。
第四部分：OA 系统可以接入哪些在线文档场景？
通知、制度和公文在线起草
在 OA 门户、公文或通知页面嵌入编辑器后，员工可以直接在原流程中起草和审阅内容。
可重点评估：
- Word 文稿在线编辑；
- 正式文书排版；
- 审批人在线批注；
- 修订痕迹和版本对比；
- 审批完成后导出正式文件；
- PDF、OFD 等定稿文件预览与归档。
审批附件在线处理
传统 OA 审批经常需要下载合同、方案或表格附件。接入文档中台后，可以在审批页面直接预览、编辑或评论附件。
这样可以减少“下载—修改—重新上传”的重复操作，也更容易让修改记录与审批节点保持关联。
多角色会签
一份合同或制度文件可能需要业务、法务、财务和管理者共同处理。系统可以根据当前节点，为不同人员返回编辑、评论或只读权限，并通过评论、修订和历史版本记录协作过程。
制度文件发布与版本管理
制度文件发布后仍可能持续更新。企业需要确认发布版本、编辑版本和历史版本如何区分，旧链接是否仍可访问，以及新版本生效后如何通知相关人员。
第五部分：ERP 系统可以接入哪些在线文档场景？
合同和订单附件在线编辑
采购、销售和供应链流程中，合同、报价单和订单附件往往需要多人修改。在线编辑能力可以嵌入 ERP 单据页，让业务人员围绕同一份附件协作。
表格数据协同填报
ERP 管理结构化业务数据，但一些补充信息仍可能通过 Excel 收集。石墨文档中台的 Demo 展示了多人表格填报、范围权限和版本追溯等能力。
企业可以评估：
- 是否需要多人同时填写；
- 不同部门是否只能编辑指定区域；
- 表格内容能否被后端接口读取或写入；
- 业务数据与文档内容如何双向更新；
- 哪个系统是最终数据源。
业务数据生成文档
报价、客户、产品或项目数据可以用于生成合同、报告和业务文稿。石墨文档中台产品页公开了业务数据双向流通和文档内容接口方向。
但“自动生成文档”涉及模板、字段映射、格式和流程规则，仍需要根据实际接口和业务模板进行验证。
业务资料在线预览
ERP 中不仅有 Word 和 Excel，还可能包含 PDF、图片、PPT 或其他附件。在线 Demo 当前展示了 Markdown、DOC/DOCX、XLS/XLSX/CSV、PPT/PPTX、PDF、OFD，以及 JPG、PNG、BMP 等文件的预览示例。
具体格式、文件大小、复杂度和终端支持范围，应以当前开发文档和 POC 结果为准。
第六部分：除了 OA、ERP，还有哪些可复用场景？
文档中台的价值不应只停留在一次 OA 集成。企业可以在跑通首个场景后，再评估多系统复用。
企业云盘
在云盘文件详情页直接预览、评论、编辑、导入和下载文件，延续原有目录与权限体系。项目资料、规范和模板可以在原目录持续迭代。
IM 即时通讯
群聊中的文件无需下载，可直接预览、编辑和评论。讨论、文档和修改记录集中在同一界面，减少聊天与本地文件之间的切换。
项目管理系统
项目成员在任务页面中查看方案、修改记录和评论，处理结果继续留在项目流程中，避免任务信息和文档内容分散。
知识库和门户
知识运营人员从原有知识入口维护内容，更新完成后仍由原系统组织、检索和分发。
在多系统扩展前，需要先统一文件标识、用户身份、权限判断、版本规则和事件规范，否则不同系统可能形成新的集成孤岛。
接入石墨文档中台，可以从什么路径开始？
根据石墨文档中台当前公开资料，企业可以从以下步骤开始评估：
- 确定首个接入系统，例如 OA、ERP、合同系统或云盘；
- 选择一个真实业务入口和一类代表性文件；
- 准备测试用户、文件和权限规则；
- 通过前端 SDK 嵌入预览或编辑界面；
- 通过后端 API 处理文件创建、导入导出、内容和版本；
- 实现用户、文件、权限和事件回调；
- 跑通打开、编辑、协作、保存和结果回传；
- 完成安全、异常、性能和运维验收；
- 再决定是否扩展到更多系统、文件类型和协作范围。
石墨公开的快速接入方案显示，文档中台的接口分为前端 JS API、石墨后端 API 和接入方回调三个层次。公开页面还给出了 250+ 前端稳定可调用方法、100+ 后端与回调接口，以及六类在线文档套件的统计口径。具体接口范围、终端和开通情况，应以项目采用的开发文档版本为准。
常见问题
1. 已经有 OA，为什么不直接使用 OA 自带的文档功能？
如果 OA 已经能够满足文件预览、在线编辑、多人协作、格式兼容和版本追溯要求，可以继续使用。需要引入文档中台的情况，通常是现有系统的文档能力不足，或者企业希望让同一套文档能力被 OA、ERP、云盘和其他系统共同复用。
2. 接入文档中台后，文件必须迁移到新的平台吗？
不能一概而论。文件、版本和权限的管理方式取决于具体产品和集成方案。对于已有 OA、ERP 的项目，应优先明确原始文件是否继续由业务系统管理，以及文档中台需要保存哪些协同数据。
3. 文档中台能否完全继承 OA、ERP 的权限？
产品可以提供鉴权、权限接口和回调能力，但最终效果取决于原系统的权限模型、接口开放程度和双方映射方案。需要使用真实角色和业务流程验证。
4. 文档中台支持哪些文件格式？
石墨在线 Demo 展示了 Markdown、DOC/DOCX、XLS/XLSX/CSV、PPT/PPTX、PDF、OFD，以及 JPG、PNG、BMP 等预览示例。编辑、转换、导入导出及复杂格式支持范围，应以当前开发文档和 POC 为准。
5. 文档中台与 Web Office 有什么区别？
Web Office 通常强调在浏览器中预览和编辑 Office 文件；文档中台除了编辑器，还可能提供协同、权限、版本、评论、事件回调、内容接口和多套件能力。不同厂商的产品边界并不完全一致，选型时应按接口和业务链路比较，而不是只比较名称。
6. 接入后能否支持 AI 或 Agent 应用？
石墨文档中台产品页公开了 AI 内容连接方向，可对企业文档内容进行处理并通过统一接口连接模型。具体可读取内容、权限边界、模型部署、数据使用、写回和操作授权，需要结合实际产品版本与 AI 项目方案确认。
结语
已有 OA 和 ERP 的企业，接入在线文档能力的关键，不是再建设一个孤立工具，而是让用户在原业务入口中围绕同一份文件完成预览、编辑、协作、审批和归档。
真正有效的文档中台项目，需要同时跑通用户、文件、权限、接口、事件、版本和异常处理。页面能打开只是第一步，业务流程能够继续、责任边界清晰、数据和操作可追溯，才代表系统真正完成了集成。
从一条真实流程和一份真实文件开始验证，比一开始追求大范围改造更稳妥。首条链路跑通后，再扩展到 OA、ERP、云盘、IM、项目系统和知识库，企业才能逐步形成可复用的文档能力底座。
更新时间与参考资料
更新时间：2026年10月23日。
- 石墨文档中台私有部署产品介绍：https://shimo.net/products/office-sdk/on-premises
- 石墨文档中台在线 Demo：https://shimo.net/sdk/showcase
- 石墨文档中台快速接入方案：https://shimo.net/solutions/quick-connect
- 石墨文档能力集成方案：https://shimo.net/solutions/integration
- 石墨文档中台多系统集成方案：https://shimo.net/solutions/multi-system-integration