全部折叠
通常,一旦所有编辑它的用户关闭文档并且延迟时间(大约 10 秒)过去,最终文档版本就会编译。但是这种行为可以被覆盖。为此,可以使用 强制保存 选项。
有几种方法可以启动强制保存:
{ "c": "forcesave", "key": "Khirz6zTPdfd7", "userdata": "sample userdata" }
var docEditor = new DocsAPI.DocEditor("placeholder", { "editorConfig": { "customization": { "forcesave": false, ... }, ... }, ... });
{ "services": { "CoAuthoring": { "autoAssembly": { "enable": true, "interval": "5m" } } } }
根据您需要的强制保存类型,您可以选择正确的实施方式。有关这方面的更多信息,请访问 此页面。
请参阅 保存文件 部分以了解文件保存在文档服务器中是如何工作的,以及保存创建的文档需要什么。
如果打开了不同于 OOXML 格式的文档(.txt 或 .ods),则默认保存 OOXML 格式。
要将打开的文档保存为不同于默认 Office Open XML 的格式,必须将 POST 请求发送到 文档转换服务。
自动保存 选项默认启用。要禁用它,您需要将文档配置中的 editorConfig.customization.autosave 参数设置为 false:
var docEditor = new DocsAPI.DocEditor("placeholder", { "editorConfig": { "customization": { "autosave": false, ... }, ... }, ... });
有关自动保存的更多信息,请参见 此页面。
通常,文档在编辑时不会以编译的形式物理保存到计算机硬盘驱动器中。完成编辑并且处理该文档的所有用户都将其关闭后,该文件将转换为 Office Open XML 格式并保存到磁盘。
之后, 文档编辑服务 通知 文档存储服务 文件已准备好并且可以下载。
编辑结束和转换开始之间的时间在default.json配置文件中的 用services.CoAuthoring.server.savetimeoutdelay参数(默认为5000毫秒或5秒)进行设置,并可以更改:
{ "services": { "CoAuthoring": { "server": { "savetimeoutdelay": 5000 } } } }
有关转换开始延迟的更多信息,请参见 此页面。
为了保持 txt 或 csv 文件的可读性,您可能需要设置最初保存时使用的编码。如果文件中使用了与基本拉丁字母不同的字符(如ä、ö、ü、带重音符号的字母、西里尔字母等),这可能很有用。
为此,将请求正文中设置好参数的 POST 请求发送到 文档转换服务:
{ "codePage": 65001, "filetype": "txt", "key": "Khirz6zTPdfd7", "outputtype": "docx", "title": "Example Document Title.docx", "url": "https://example.com/url-to-example-document.txt" }
有关在转换期间使用代码页的更多信息,请访问 此页面。