ONLYOFFICE主动保存API，把丢数据的锅甩给浏览器

在企业数字化系统中，Excel 在线编辑已经成为 OA、ERP、预算管理、经营分析、项目管理等场景中的基础能力。

很多企业在集成 ONLYOFFICE 后，会遇到一个容易被忽视但实际影响很大的问题：

用户明明已经输入了数据，但关闭页面后，最后输入的内容却没有保存下来。

尤其是在表格编辑场景下，这种情况比 Word 文档更容易出现。

近期，我们基于 ONLYOFFICE 9版本为客户完成了一项定制功能：

Excel 主动保存接口（Request Save API）

用于解决用户仍处于单元格编辑状态时，业务系统主动触发保存的问题。

本文将结合实际业务场景介绍该能力的设计背景和应用价值。

一个非常常见的业务场景

假设用户正在填写一张预算表。

用户点击某个单元格后输入：

10000

此时光标仍停留在当前单元格中。

用户认为：

我已经输入完成了。

但实际上对于浏览器中的 Excel 编辑器来说：

当前内容可能仍处于编辑状态，还没有正式提交到文档模型。

如果这时候用户：

• 点击业务系统“关闭”按钮
• 点击“返回列表”
• 点击“退出编辑”
• 切换到其他业务页面

业务系统可能会立即关闭当前编辑页面。

最终导致：

最后输入的数据没有被保存。

为什么会出现这种情况？

这是 Web 版 Office 编辑器的正常工作机制。

无论是 ONLYOFFICE 还是其他在线表格产品，在单元格编辑过程中通常会经历两个阶段：

第一阶段：用户输入

用户正在输入内容：

123456

此时内容存在于编辑器输入状态中。

第二阶段：提交编辑结果

只有当发生以下动作时：

• Enter
• Tab
• 点击其它单元格
• 单元格失焦
• 编辑器内部提交操作

数据才会进入文档模型。

随后才能参与：

• 协同编辑
• 历史记录
• 自动保存
• 服务端保存

因此：

“用户看见已经输入” ≠ “文档已经保存”。

这也是很多业务系统误认为已经保存成功的根源。

客户面临的实际问题

客户的业务系统中存在大量表格填报场景。

例如：

预算填报

用户填写预算金额后直接关闭页面。

项目管理

用户录入项目进度后返回列表。

ERP 数据录入

用户修改库存数量后退出当前页面。

经营分析报表

用户录入统计数据后切换业务菜单。

这些场景都有一个共同特点：

用户习惯通过业务系统按钮离开页面，而不是先点击 ONLYOFFICE 的保存按钮。

因此客户希望：

在关闭文档之前，由业务系统主动触发一次保存。

即：

docEditor.requestSave();

然后再执行关闭操作。

ONLYOFFICE 原生能力的限制

在需求分析过程中，我们首先调研了 ONLYOFFICE 官方提供的能力。

现有公开 API 支持：

• 获取文档信息
• 执行部分编辑命令
• 强制保存（Force Save）
• 回调通知

但并没有直接提供：

“将当前未失焦单元格内容提交并保存”的标准接口。

换句话说：

如果用户仍处于单元格输入状态，

正在输入 ↓ 未提交 ↓ 调用保存

保存动作未必能够获取到最新输入内容。

因此需要通过定制开发实现。

定制能力设计

本次定制目标非常明确：

让业务系统能够主动发起一次完整保存流程。

最终提供统一接口：

docEditor.requestSave();

业务系统无需关心内部实现细节。

调用后系统自动完成：

1. 提交当前编辑状态

将当前单元格中的输入内容提交到表格数据模型。

即使用户没有离开当前单元格。

2. 触发文档保存

调用 ONLYOFFICE 原有保存机制。

包括：

• 自动保存链路
• Force Save 机制
• 文档状态同步

3. 触发回调

按照原有 Callback 机制：

{ "status": 2, "url": "..." }

将最新文档回传至业务系统。

业务系统无需修改现有存储逻辑。

典型使用方式

场景一：关闭按钮

async function closeDocument() { await docEditor.requestSave(); closeWindow(); }

用户点击：

关闭

系统先保存。

保存完成后再关闭页面。

场景二：返回列表

async function backToList() { await docEditor.requestSave(); location.href="/list"; }

保证最新修改已经进入服务器。

场景三：业务系统统一保存

很多企业会保留自己的保存按钮：

saveBtn.onclick = async () => { await docEditor.requestSave(); };

实现业务系统与 ONLYOFFICE 的统一保存体验。

这并不等于“任何情况下都不会丢数据”

这里需要特别说明一个技术边界。

浏览器环境存在天然限制。

例如：

• 浏览器崩溃
• 标签页被强制关闭
• 电脑断电
• 网络中断
• 页面刷新
• 进程被结束

这些场景下：

保存动作可能尚未执行完成。

因此任何 Web Office 产品都无法承诺：

浏览器关闭时 100% 保存成功。

本次定制能力的定位是：

提升业务系统主动关闭、主动退出场景下的数据保存成功率。

而不是绕过浏览器机制实现绝对可靠保存。

为企业系统带来的价值

降低数据丢失风险

避免最后一个单元格的数据因未失焦而丢失。

提升用户体验

用户无需记住：

• 点击保存
• 按 Ctrl+S
• 先切换单元格

系统自动完成保存。

与业务流程深度融合

业务系统能够控制：

• 保存
• 关闭
• 返回
• 提交审批

形成统一流程。

降低培训成本

符合大多数用户的使用习惯：

输入完成 → 点击关闭

而不是：

输入完成 → 点击其它单元格 → 保存 → 再关闭

总结

在在线表格场景中，用户看到的数据并不一定已经进入文档保存状态。

特别是在：

• OA 表单
• ERP 数据录入
• 预算填报
• 项目管理
• 经营分析

等业务场景下，用户经常会在单元格仍处于编辑状态时直接退出页面。

基于 ONLYOFFICE 9.3 的这项定制开发，通过新增：

docEditor.requestSave();

主动保存接口，实现了：

• 当前编辑状态提交
• 单元格未失焦数据保存
• 原有保存流程触发
• Callback 回传业务系统

帮助业务系统在关闭文档前主动完成保存动作，显著降低因用户操作习惯导致的数据丢失风险。

对于深度集成 ONLYOFFICE 的企业系统而言，这类能力虽然看似细节，却往往直接决定最终用户对在线文档系统的使用体验。

相关资源

OnlyOffice最新版本镜像：

https://onlyoffice.moqisoft.com/docs/install/docker

版本介绍：

https://onlyoffice.moqisoft.com/docs/product/summary

技术交流：183026419（QQ群 ）