强制保存 [force save] 是什么？如何使用它？

发布时间：2024年01月19日

?文章作者：ajun

阅读本文，了解强制保存（force save）的作用、使用方法，以及如何在 ONLYOFFICE 文档编辑器中开启强制保存。

引言

ONLYOFFICE有两种保存机制，一种是自动保存，一种是强制保存。自动保存会将您的更改内容自动发送到文件服务器保存到编辑器缓存中。强制保存会编辑器缓存中的内容直接发送到存储位置进行持久化存储。

强制保存是一种非常重要的安全措施，可以帮助保护文档的完整性，防止数据丢失和损坏。在处理重要文档时，建议定期使用强制保存功能，以确保文档的安全性。

在许多情况下，文档可能会意外丢失或损坏。这时，如果之前已经对文档进行了强制保存，那么就可以避免数据丢失，从而提高了文档的安全性。

force save 的作用？

"force save"是ONLYOFFICE产品的一种强制保存方式，用于强制保存文档或文件的更改。通过使用"force save"，用户可以绕过由于各种原因（如程序崩溃、电力中断、系统故障等），确保其更改被保存并避免数据丢失。

在文档编辑服务中保存文档时（例如，单击“文件”中的“保存”按钮），将文件强制保存的请求添加到回调处理程序中。

force save 使用流程？

1. 首先，对文档进行编辑修改，确保内容已进行必要的更改。

2. 尝试使用正常的保存操作，如点击保存按钮或使用快捷键进行保存。

3. 如果保存操作失败或出现错误提示，可以尝试关闭文档或尝试使用"force save"强制保存文档。

4. 在关闭文档或文件之前，ONLYOFFICE通常会提示您是否保存更改。选择"否"或"取消"选项，以确保您的更改不会丢失。

5. 确认保存操作后，您的更改将被强制保存，并且不会丢失。

6. 强制保存的内容会通过Callback进行传递，进行强制保存。

force save 如何开启？

强制保存一共有3种触发方式，具体可以见下文，更多可以参考官网文档。

方式1：

设置editorConfig.customization.forcesave 参数为true，参数详细见接口文档。

var docEditor = new DocsAPI.DocEditor("placeholder", {
    "editorConfig": {
        "customization": {
            "forcesave": false,
            ...
        },
        ...
    },
    ...
});

方式2：

设置参数 c 为 forcesave 值，将请求发送到文档命令服务：

{
    "c": "forcesave",
    "key": "Khirz6zTPdfd7",
    "userdata": "sample userdata"
}

方式3：

在 default.json 文档服务器配置文件中启用重复强制保存启动：

{
    "services": {
        "CoAuthoring": {
            "autoAssembly": {
                "enable": true,
                "interval": "5m"
            }
        }
    }
}