业务系统
创建或存储业务文件，提供当前用户、业务入口与权限结果
01 / 业务挑战
快速接入难，不只是把编辑器放进页面
如果用户、文件、权限和结果回传没有一起跑通，页面能打开也不能代表业务链路已经完成。
核心方案跑通完整接入链路
准备独立演示页，业务入口仍未连接
从现有系统直接进入文档预览或编辑
使用测试账号和样例文件，难以确认业务规则
用当前用户、业务文件和权限结果完成接入
页面打开后没有结果返回，流程仍靠人工确认
协作事件、状态和异常返回原业务系统
只看到产品界面，难以判断正式项目范围
用清晰验收项决定是否扩展文件类型和协作范围
02 / 方案架构
从业务入口到结果回传，一条完整的接入链路
业务系统提供当前用户、目标文件和权限结果，企业集成服务完成参数映射和事件接收，石墨文档中台提供在线文档能力。
业务系统
创建应用
准备测试配置，确认文档类型、接入方式和需要启用的能力。
用户、文件、权限
连接业务上下文
由业务系统提供当前用户、目标文件和权限结果，集成服务负责参数映射。
企业集成服务
嵌入在线能力
在原有页面接入预览或编辑入口，保留业务系统的导航、流程和操作习惯。
石墨文档中台
打开首份真实文档
验证文件打开、权限执行、编辑协作以及事件或结果返回是否符合目标场景。
事件、状态或处理结果回传 · 业务系统
业务系统负责用户、文件、流程、权限和审计决策；企业集成服务是业务方已有或项目中建设的集成层，负责上下文映射、接口封装、事件接收和异常处理；石墨文档中台提供在线预览、编辑与协作能力。企业集成服务的具体建设与运维归属需要在项目评估中确认。
03 / 应用场景
从一个真实业务入口和一份文件开始
围绕具体角色、业务入口、目标文件、处理动作和完成结果，验证首条协作链路。
在 OA 正文或附件中处理文稿
从原流程打开文件，完成起草、审阅或修改后继续办理。
角色业务人员
入口 / 流程OA 正文或附件
文件对象业务文稿
处理动作起草、审阅或修改
完成结果继续办理
在原目录中预览或编辑文件
围绕同一份文件协作，目录归属和权限仍由网盘管理。
角色网盘使用者
入口 / 流程网盘原目录
文件对象目标文件
处理动作在线预览或编辑
完成结果目录与权限仍由网盘管理
在项目页面打开方案与记录
在任务上下文中查看、编辑和评论，处理结果继续留在项目流程。
角色项目成员
入口 / 流程项目页面
文件对象方案与记录
处理动作查看、编辑和评论
完成结果结果留在项目流程
在知识入口维护文档内容
从知识条目进入文档，更新内容后继续由原系统组织和分发。
角色知识运营人员
入口 / 流程知识入口
文件对象知识文档
处理动作更新内容
完成结果原系统继续组织和分发
04 / 核心能力
四项标准能力，支撑首份文档真正上线
每个环节都有对应的接入能力支撑，让首份文档不只打开，还能进入真实业务流程。
开放接口全景
一套开放接口，从页面嵌入延伸到深度业务集成
前端 JS-API、石墨后端 API 和接入方回调分层配合，按场景组合文件、内容、组织权限和事件服务。
前端稳定可调用方法
覆盖选区、内容、样式、评论、版本和套件对象
后端与回调接口
覆盖文件生命周期、组织权限、搜索和事件通知
在线文档套件统一开放
文档、文稿、表格、幻灯片、应用表格和表单
嵌入、界面、内容与套件对象操作
创建、预览、导入导出和内容处理
用户、文件、权限、组织、搜索与事件接收
统计自石墨文档中台开发文档；已排除前端废弃和明确待复测方法。具体范围以实际版本、终端和开通情况为准。
本方案的接口组合
原业务入口保持不变
通过上下文映射和页面嵌入提供预览或编辑。
真实身份和权限得到执行
业务系统提供当前用户、目标文件和权限结果。
目标协作动作可以完成
按本次验证范围打开预览、编辑、评论或多人协作。
结果和异常能够回到业务
协作事件、回调、状态和错误可被业务系统识别与定位。
05 / 方案价值和收益
把一次接入，变成看得见的业务变化
从独立工具走向业务内协作，让员工少切换、文件少流转、责任更清楚。
协作能力融入业务
用户继续从熟悉的业务入口处理文档，不需要切换到独立平台。
From独立工具
To融入既有系统
文件处理留在原流程
预览、编辑和协作围绕同一份业务文件发生，减少下载、修改和重新上传。
From文件副本
To同一份在线内容
接入责任更加清晰
用户、文件、权限、事件和异常分别由明确的系统处理。
From反复确认
To责任清晰
项目投入更可判断
先跑通一条完整链路，再决定文件类型、协作范围和部署规模。
From先做大改造
To先验证核心链路
06 / 产品证明
不同文档类型的在线处理效果
产品截图用于确认 Markdown、Word、Excel 和 PPT 的在线预览与编辑界面；业务入口、身份、权限和结果回传仍需按接入链路单独验收。
结构化内容在线呈现
展示标题、列表、表格和代码等内容结构的在线处理效果。
07 / 评估与咨询
接入评估需要先确认的五项输入
把真实业务输入带入评估，避免把单一的时间数字当成所有场景的交付承诺。
入口与使用对象
确认业务入口、用户范围、组织层级和首批验证人员。
文件与内容范围
明确文件来源、归属、常用格式、大小和处理方式。
权限与安全规则
确认谁做权限决策，以及水印、审计和外发控制要求。
事件与结果回传
确认哪些协作事件需要回到业务系统，并由谁消费。
部署与运行条件
确认网络、资源、高可用、备份和日常运维边界。