变更日志

ONLYOFFICE文档服务器API的更改列表。

版本 8.0

• 在浏览器向服务器的请求中添加了 WOPISrc 查询参数。
• 向转化请求添加了watermark字段。
• 在 documentType 参数中添加了 pdf 文档类型。
• 向回调处理程序添加了 formsdataurl 参数。
• 向 events.onRequestUsers 事件添加了 data.id 参数。
• 将users.image字段添加到setUsers方法中。
• 向 setUsers 方法和events.onRequestUsers 事件。
• 在 editorConfig.user 参数中添加了image字段。
• 添加了 editorConfig.customization.mobileForceView 参数。
• 将link字段添加到data对象，该对象发送到events.onRequestReferenceData 事件。

版本 7.5

• 为回调处理程序的forcesavetype参数添加了类型3。
• 添加了 editorConfig.customization.submitForm 参数。
• events.onRequestMailMergeRecipients 事件已弃用，请使用 events.onRequestSelectSpreadsheet 事件。
• setMailMergeRecipients 方法已弃用，请使用 setRequestedSpreadsheet 方法。
• 添加了 setReferenceSource 方法。
• 添加了 events.onRequestReferenceSource 事件。
• 向 Conversion API 添加了 -9 错误代码。
• 在 document.referenceData 参数中添加了key字段。
• events.onRequestCompareFile 事件已弃用，请使用 events.onRequestSelectDocument 事件。
• setRevisedFile 方法已弃用，请使用 setRequestedDocument 方法。
• 添加了 events.onRequestOpen 事件。
• 添加了 deleteForgotten、 getForgotten 和 getForgottenList 命令。

ONLYOFFICE 文档服务器 API 的更改列表。

版本 7.4

• 添加了打开 dps、dpt、et、ett、mhtml、stw、sxc、sxi、sxw、wps、wpt 格式的功能。
• 在 setUsers 方法中添加了 users.id 字段。
• 在 setUsers 方法和events.onRequestUsers 事件中添加了 c 参数。

7.3 版

• 添加了 WOPI 转换 API。
• 添加了 setReferenceData 方法。
• 添加了 events.onRequestReferenceData 事件。
• 添加了 document.referenceData 参数。
• 向 CheckFileInfo WOPI 操作添加了 UserCanNotWriteRelative 属性。
• 添加了编辑二进制文档格式的方案。
• 向 WOPI 发现添加了convert 操作。
• 添加了 PutRelativeFile WOPI 操作。

7.2 版

• 添加了 editorConfig.customization.integrationMode 参数。
• 将theme-contrast-dark主题id添加到editorConfig.customization.uiTheme参数中。
• 将phone字段添加到editorConfig.customization.customer参数中。
• 向许可证响应添加connections_view、users_view_count和users_view。
• 在文本文档、电子表格和演示文稿编辑器中添加了实时查看器模式。
• 将embedview操作添加到wopi发现中。
• The services.CoAuthoring.secret.browser.string parameter is deprecated, please use the services.CoAuthoring.secret.inbox.string parameter instead.

7.1 版

• 用于启用 正文中令牌 的 services.CoAuthoring.token.inbox.inBody 和 services.CoAuthoring.token.outbox.inBody 参数已经弃用。
• 在 PutFile WOPI 操作中添加了 X-LOOL-WOPI-IsModifiedByUser、 X-LOOL-WOPI-IsAutosave 和 X-LOOL-WOPI-IsExitSave 请求标头，以区分文档保存的类型。
• editorConfig.customization.chat 参数已弃用，请改用 document.permissions.chat 参数。
• 添加了从 dps, dpt, et, ett, htm, mhtml, stw, sxc, sxi, sxw, wps, wpt, xlsb, xml 格式转换的功能。
• 添加了打开 xlsb 格式的功能。
• 初始化配置 signature 中的参数列表已得到严格规范。
• editorConfig.customization.spellcheck 字段已弃用，请改用 editorConfig.customization.features.spellcheck 字段。
• 添加了 editorConfig.customization.features 参数部分。
• 在转换请求中添加了 documentLayout 参数。
• 在转换请求中添加了 documentRenderer 参数。
• 添加了从 pdf/xps/oxps 格式到 docx的转换。
• 添加了 document.permissions.userInfoGroups 参数。
• 添加了从 djvu 格式到 pdf 的转换。
• 添加了对 ppsm、ppsx格式的转换。

7.0 版

• 添加了 .docxf 和 .oform 文档格式。
• 添加了与 docxf 格式的双向转换。
• 使用来自同一用户的最后一个标签的 callbackUrl。
• 在 editorConfig.customization.customer 参数中添加了 logoDark 字段。
• 在 editorConfig.customization.logo 参数中添加了 imageDark 字段。
• editorConfig.customization.logo 参数的 imageEmbedded 字段已弃用，请改用 image 字段。
• 为 setHistoryData 方法的 changesUrl 参数指定的文件更改请求添加了签名。
• 添加了 document.permissions.protect 字段。
• 在 onDownloadAs, onRequestRestore 和 onRequestSaveAs 事件中添加了 fileType 参数。
• 添加了通过 insertImage 方法插入多个图像的可能性。
• assemblyFormatAsOrigin 服务器设置默认启用。
• 在转换请求的 outputtype 参数中添加了 ooxml 和 odf 值。
• 向 setHistoryData 方法添加了 fileType 和 previous.fileType 参数。
• 将 filetype 参数添加到 回调处理程序。
• 在转换响应中添加了 fileType 字段。
• 添加了到 docm, dotm, xlsm, xltm, pptm, potm 格式的转换。
• editorConfig.customization.reviewDisplay, editorConfig.customization.showReviewChanges, editorConfig.customization.trackChanges 参数已弃用，请改用 editorConfig.customization.review 参数。
• 添加了 editorConfig.customization.review.hideReviewDisplay 字段。
• 添加了 editorConfig.customization.review.hoverMode 字段。
• 添加了查看电子表格文件的 文档历史记录 的可能性。
• 为 PostMessage WOPI 协议添加了 UI_InsertGraphic 消息。

6.4 版

• 增加了打开 oxps 格式的功能。
• 增加了对 WOPI 协议的支持。
• 将 simple 值添加到 editorConfig.customization.reviewDisplay 参数中。
• 添加了保存在电子表格文件中的 线程评论。
• 添加了 editorConfig.customization.uiTheme 字段。
• 添加了查看演示文件的 文档历史记录 的可能性。
• 添加了 editorConfig.customization.hideNotes 字段。
• 添加了 editorConfig.coEditing 字段。
• 添加了 requestClose 方法。
• 添加了 document.permissions.commentGroups 字段。
• 添加了 events.onPluginsReady 事件。

6.3 版

• 添加了 license 命令。
• 添加了 editorConfig.customization.hideRulers 字段。
• 添加了 editorConfig.customization.anonymous 字段。
• editorConfig.customization.commentAuthorOnly 字段已弃用，请使用 document.permissions.editCommentAuthorOnly 和 document.permissions.deleteCommentAuthorOnly 字段。
• 添加了 setFavorite 方法。
• 将 data.favorite 参数添加到 events.onMetaChange 事件。
• 添加了 document.info.favorite 字段。
• 添加了 document.permissions.reviewGroups 字段。
• 添加了转换为 epub, fb2, html 格式的功能。
• 添加了从 xml 格式转换的功能

6.2 版

• 添加了一个新的 actions.type 字段值（actions.type = 2）。
• 添加了 editorConfig.customization.trackChanges 字段。
• 添加了 editorConfig.customization.toolbarHideFileName 字段。
• 根据 forcesavetype选择 status 6 的 callbackUrl。
• 增加了打开 fb2 格式的功能。

6.1 版

• documentType 参数的 text, spreadsheet 和 presentation 值已弃用，请改用 word, cell 和 slide 值。
• 将 group 字段添加到 editorConfig.user。
• 添加了从 fb2 格式的转换的功能。

6.0 版

• 在 events.onRequestInsertImage 事件中添加了插入类型。
• 添加了 editorConfig.templates 字段。
• 添加了 editorConfig.customization.plugins 字段。
• 添加了 editorConfig.customization.macros 字段。
• 添加了 editorConfig.customization.macrosMode 字段。
• 添加了 events.onRequestCreateNew 事件。
• 添加了 document.permissions.copy 字段。
• document.permissions.rename 字段已弃用，请添加 events.onRequestRename 字段。

5.5 版

• 添加了 editorConfig.customization.spellcheck 字段。
• 添加了转换到 pdfa 格式的功能。
• 添加了 events.onRequestCompareFile 事件。
• 添加了 setRevisedFile 方法。
• methods 参数中的Token。
• document.permissions.changeHistory 字段已弃用，请添加 events.onRequestRestore 字段。
• 添加了 editorConfig.customization.goback.requestClose 字段。
• 添加了 events.onRequestSharingSettings 事件。
• 添加了 editorConfig.customization.unit 字段。
• 添加了 region 字段。
• 添加了 spreadsheetLayout 字段。
• 添加了转换的 输入错误。
• events.onRequestSendNotify 事件和 events.onRequestUsers 事件可以独立设置。
• 添加了 editorConfig.customization.mentionShare 字段。
• 根据 status选择 callbackUrl。
• 添加了 editorConfig.customization.compatibleFeatures 字段。

5.4 版

• 添加了 editorConfig.region 字段。
• document.info.created 字段已弃用，请改用 document.info.uploaded 字段。
• document.info.author 字段已弃用，请改用 document.info.owner 字段。
• events.onReady 事件被移除。
• editorConfig.user 对象中的 firstname 和 lastname 字段被删除。
• 添加了 events.onRequestSaveAs 事件。
• 添加了 events.onRequestInsertImage 事件。
• 添加了 insertImage 方法。
• 添加了 events.onRequestMailMergeRecipients 事件。
• 添加了 setMailMergeRecipients 方法。
• 添加了 setSharingSettings 方法。
• 添加了 events.onRequestUsers 事件。
• 添加了 setUsers 方法。
• 添加了 events.onRequestSendNotify 事件。

5.3 版

• 添加了 转换 到OOXML（dotx、 xltx、potx）和 ODF（ott、ots、otp）模板的功能
• 添加了 editorConfig.customization.reviewDisplay 字段。
• editorConfig.customization.commentAuthorOnly 字段现在也用于限制评论删除。
• 添加了 editorConfig.customization.compactHeader 字段。
• 添加了 editorConfig.customization.hideRightMenu 字段。
• 添加了 editorConfig.customization.toolbarNoTabs 字段。
• 为受密码保护的文档添加了 转换错误。
• 添加了 editorConfig.actionLink 字段。
• 添加了 setActionLink 方法。
• 添加了 events.onMakeActionLink 事件。

5.2 版

• 请求 正文 参数中的令牌。
• document.permissions.comment 适用于所有类型的编辑器。
• 添加了 document.permissions.fillForms 字段。
• 添加了 editorConfig.customization.help 字段。
• 添加了使 editorConfig.customization.logo 不可点击的可能性。
• 为转换的 aspect 字段添加值 2。

5.1 版

• 在 downloadAs 方法中添加了 format 参数。
• 添加了 document.permissions.modifyContentControl 字段。
• 添加了 OpenDocument Template 格式的转换。
• 添加了 events.onRequestClose 事件。
• 添加了 editorConfig.customization.goback.blank 字段。

5.0 版

• 添加了 document.permissions.modifyFilter 字段。
• 添加了启用宏的文档、文档模板和平面文档 格式的转换。
• events.onReady 事件已弃用，请改用 events.onAppReady 事件。
• 添加了 events.onDocumentReady 事件。
• 添加了 editorConfig.plugins.autostart 字段。
• 添加了 events.onWarning 事件。
• 添加了 文档生成器服务。

4.4 版

• 更改了 showMessage 方法。
• 添加了转换到 odp 格式的功能。
• 添加了 document.permissions.comment 字段。
• 添加了 document.permissions.changeHistory 字段。
• 添加了 events.onRequestRestore 事件。
• 添加了 document.permissions.rename 字段。
• 添加了 events.onRequestRename 事件。
• 添加了 meta 命令。
• 添加了 events.onMetaChange 事件。
• 更改了 最后一个加入共同编辑的用户 对 callbackUrl 的使用。
• 添加了 editorConfig.location 字段。

4.3 版

• 添加了 destroyEditor 方法。
• 从插件连接模式中删除了 editorConfig.plugins.url 字段。
• 添加了 editorConfig.customization.commentAuthorOnly 字段。
• 添加了 editorConfig.customization.forcesave 字段。
• 添加了 editorConfig.customization.showReviewChanges 字段。
• 强制保存文件时，在回调处理程序请求中添加了 forcesavetype 字段。
• 为文档转换服务的添加了 JSON 格式响应。

4.2 版

• firstname 和 lastname 字段已弃用，请改用 name 字段。
• 添加了在开源版本中为 editorConfig.customization.chat 和 editorConfig.customization.comments 指定值的可能性。
• 添加了 editorConfig.customization.compactToolbar 字段。
• 添加了 editorConfig.customization.zoom 字段。
• 添加了 editorConfig.customization.autosave 字段。
• changeshistory 字段已删除，请改用 history 字段。
• 更改了 setHistoryData 方法。
• 在 文档转换服务中添加了将文件转换为 缩略图 的可能性。
• POST 请求现在用于与 文档命令服务 和 文档转换服务的交互。
• 添加了 version 命令。
• 添加了编辑器打开和传入传出请求的 signature。