启用自动保存与强制保存功能

在DzzOffice中，用户经常遇到通过OnlyOffice编辑文档后，下载的内容却是空白的问题。这通常是因为OnlyOffice的保存机制导致的。具体来说，OnlyOffice在编辑过程中会将内容缓存到其服务器上，并不是直接保存到DzzOffice中。只有当OnlyOffice执行回调处理程序时，才会将更新后的内容传回DzzOffice进行保存。

DzzOffice与OnlyOffice的集成

DzzOffice通过安装OnlyOffice插件来实现与OnlyOffice的集成

用户可以在DzzOffice中直接通过OnlyOffice插件打开和编辑文档。

文档传递与保存流程

当用户在DzzOffice中通过OnlyOffice插件打开文档时，文档会通过API从DzzOffice传递到OnlyOffice。

在编辑过程中，OnlyOffice会将编辑的内容缓存到其服务器上。

只有当OnlyOffice执行回调程序时（通常是在用户完成编辑并关闭文档时），才会将更新后的文档内容传回DzzOffice进行保存。

问题所在

如果用户在编辑过程中没有正确触发回调程序（例如，直接关闭浏览器或遇到其他问题导致回调未执行），则OnlyOffice服务器上的缓存内容不会传回DzzOffice，导致下载的文档内容是空白的。

解决方案：启用自动保存与强制保存功能

为了解决上述问题，可以启用OnlyOffice的自动保存与强制保存功能，以确保文档内容能够及时、准确地保存到DzzOffice中。

ONLYOFFICE 保存机制概述

ONLYOFFICE 提供了两种关键的保存机制来保护用户编辑的文档安全：自动保存和强制保存（forcesave）。

自动保存

功能描述：自动保存机制在用户编辑文档时自动将更改内容发送到文件服务器并保存到编辑器的缓存中。这种机制无需用户干预，能够显著减少因意外情况（如系统崩溃、浏览器关闭等）导致的数据丢失。
重要性：对于提高用户体验和数据安全性至关重要，因为它在用户未手动保存的情况下也能保护数据。

强制保存（forcesave）

功能描述：强制保存是一种更为严格的保存机制，它直接将编辑器缓存中的文档内容发送到存储位置进行持久化存储。这通常用于确保文档在关键时刻（如系统即将崩溃或用户即将离开编辑页面）的完整性。
重要性：作为重要的安全措施，强制保存能够防止数据丢失和损坏，特别是在处理重要文档时。

强制保存的作用

保护文档的完整性：确保文档在编辑过程中不会因意外情况而丢失或损坏。

提高安全性：在处理敏感或重要文档时，强制保存能显著提升数据安全性。

绕过常规保存限制：在常规保存操作失败或不可用时，强制保存提供了一种可靠的替代方案。

强制保存使用流程

编辑文档：对文档进行必要的编辑和修改（用户没有对文档进行任何更改时是不会保存到Dzz上的）。

尝试正常保存：使用编辑器的保存功能（如点击保存按钮或使用快捷键）。

触发强制保存：如果正常保存失败或需要确保数据立即安全，可以尝试关闭文档或使用单击保存强制保存文档（通过编辑器配置和插件设置，确保强制保存功能已启用）。

确认保存：在关闭文档或浏览器之前，系统会提示是否保存更改。选择保存选项以确认。

数据传递：强制保存的内容会通过预设的回调程序（Callback）机制发送到Dzz系统进行存储。

如何启用自动保存与强制保存

基础设置（插件设置）

登录Dzz管理后台，在应用市场中找到onlyoffice 编辑插件设置，一键启用自动保存和强制保存功能。
这样，每次用户点击“保存”按钮时，都会触发强制保存。

高级设置（编辑器配置）

对于需要更高级别控制的用户，可以通过编辑器的配置文件来启用强制保存。
在编辑器的配置文件中，设置editorConfig.customization.forcesave为true（注意：此路径和设置可能因ONLYOFFICE版本和部署方式而异，请参考官方文档）。
这样，每次到了强制保存的时间间隔时，都会触发强制保存。

配置文件调整与性能平衡

在Linux或Windows服务器上，您还可以进一步调整ONLYOFFICE的配置文件（如default.json），以启用重复强制保存并设置适当的时间间隔。
配置文件位置：
Linux: /etc/onlyoffice/documentserver/default.json
Windows: %ProgramFiles%\ONLYOFFICE\DocumentServer\config\default.json
或
Linux: /etc/onlyoffice/documentserver/local.json
Windows:%ProgramFiles%\ONLYOFFICE\DocumentServer\configlocal.json
相关参数：
services.CoAuthoring.autoAssembly.enable：启用或禁用重复强制保存功能。
services.CoAuthoring.autoAssembly.interval：设置重复强制保存的时间间隔（以分钟为单位）。
示例default.json配置：

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

注意事项

启用强制保存和配置重试策略时，请考虑其对服务器性能和负载的潜在影响。
修改配置文件后需要重启服务生效（建议重启系统）。
定期检查服务器和 ONLYOFFICE 文档服务器的日志，以确保所有保存操作都按预期执行。
在部署到生产环境之前，在测试环境中充分测试这些配置和机制。

启用自动保存与强制保存功能

解决方案：启用自动保存与强制保存功能#

ONLYOFFICE 保存机制概述#

自动保存#

强制保存（forcesave）#

强制保存的作用#

强制保存使用流程#

如何启用自动保存与强制保存#

基础设置（插件设置）#

高级设置（编辑器配置）#

配置文件调整与性能平衡#

注意事项#