Changelog
ONLYOFFICE 文档 API 的更改列表。
版本 8.3
- 添加了 editorConfig.customization.slidePlayerBackground 参数。
- 添加了 editorConfig.customization.wordHeadingsColor 参数。
- 添加了 editorConfig.customization.mobile.info 参数。
- 添加了 pages, key, numbers 格式的打开方式。
- 添加了 events.onUserActionRequired 事件。
- 添加了 refreshFile 方法。
- 添加了 events.onRequestRefreshFile 事件。
- 如果未为 drop 命令指定 users 参数,则将禁止所有使用指定 key 编辑文档的用户编辑文档。
- editorConfig.customization.submitForm 参数现在可以用作对象。
- editorConfig.customization.compactToolbar 参数现在可用于查看器。
- 添加了 editorConfig.customization.pointerMode 参数。
版本 8.2
- 参数 editorConfig.customization.mobileForceView 已弃用,请改用 editorConfig.customization.mobile 参数.
- 在 WOPI conversion API中新增 Password 和 PasswordToOpen 请求参数。
- editorConfig.region 字段现用于定义所有编辑器类型的默认度量单位。
- editorConfig.location 字段已弃用,请改用 editorConfig.region 字段。
- 在 setRequestedDocument 方法的 c 参数中新增 insert-text 类型的文档选择。
- 命令服务 地址
https://documentserver/coauthoring/CommandService.ashx
已替换为https://documentserver/command
。 - 在 info 命令的响应中新增 users 参数。
- 在 editorConfig.customization.features 参数中新增 tabBackground 字段。
- 在 editorConfig.customization.features 参数中新增 tabStyle 字段。
- 在 editorConfig.customization.logo 参数中新增 imageLight 字段。
- editorConfig.customization.toolbarNoTabs 字段已弃用,请改用 editorConfig.customization.features.tabStyle 和 editorConfig.customization.features.tabBackground 字段。
版本 8.1
- 新增 editorConfig.plugins.options 参数。
- 新增支持将 tif / tiff 图像类型插入 文件。
- 添加了 startFilling 方法。
- 添加了 events.onRequestStartFilling 事件。
- 向 WOPI 主机页面的 form 元素添加了 docs_api_config 参数。
- 向转换请求添加了 pdf 字段。
- 添加了 events.onSubmit 事件。
- docxf 格式已弃用,请使用 pdf 格式创建和编辑表单。
- 将 docxf 和 oform 格式的 documentType 更改为 pdf。
- 将 roles 字段添加到 editorConfig.customization.features 参数。
- 发送时将 shardkey 参数添加到 URL 查询字符串请求到文档命令服务、文档转换服务或文档生成器服务。
- 向 Automation API 添加了 addContextMenuItem, addToolbarMenuItem 和 updateContextMenuItem 方法。
- 向 Conversion API 添加了 -10 错误代码。
- editorConfig.customization.logo 参数现在可用于移动编辑器。
- 向 editorConfig.customization.logo 参数添加了 visible 字段。
- 向 WOPI 发现添加了 formsubmit 操作。
- editorConfig.customization.goback.requestClose 字段已弃用,请使用 editorConfig.customization.close 字段。
- 向 WOPI 添加了 Save Copy As 功能。
- 将 editorConfig.customization.hideRightMenu 参数的默认值更改为 true。
版本 8.0
- 在浏览器向服务器的请求中添加了 WOPISrc 查询参数。
- 向转化请求添加了 watermark 字段。
- 在 documentType 参数中添加了 pdf 文档类型。
- 在 回调处理器 中新增 formsdataurl 参数。
- 向 events.onRequestUsers 事件添加了 data.id 参数。
- 将 users.image 字段添加到 setUsers 方法中。
- 在 setUsers 方法和 events.onRequestUsers 事件中新增 info 操作类型。
- 在 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 error code -9 错误代码。
- 在 setReferenceData 参数中添加了 key 字段。
- events.onRequestCompareFile 事件已弃用,请使用 events.onRequestSelectDocument 事件。
- setRevisedFile 方法已弃用,请使用 setRequestedDocument 方法。
- 添加了 events.onRequestOpen 事件。
- 添加了 deleteForgotten、 getForgotten 和 getForgottenList 命令。
版本 7.4
- 在 WOPI discovery 中新增 mobileView 和 mobileEdit 操作。
- 添加了打开 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 参数。
- 添加了 Connector 类,以与外部的文本文档、电子表格、演示文稿和可填写表单进行交互。
- 将theme-contrast-dark主题id添加到 editorConfig.customization.uiTheme 参数中。
- 将 phone 字段添加到 editorConfig.customization.customer 参数中。
- 向许可证响应添加 connections_view, users_view_count 和 users_view license response。
- 在文本文档、电子表格和演示文稿编辑器中添加了 实时查看器 模式。
- 将embedview 操作添加到wopi发现中。
- services.CoAuthoring.secret.browser.string 参数已弃用,请改用 services.CoAuthoring.secret.inbox.string 参数。
版本 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 参数中。
- 添加了保存在电子表格文件中的 threaded comments 线程评论。
- 添加了 editorConfig.customization.uiTheme 字段。
- 添加了查看演示文件的 文档历史记录 的可能性。
- 添加了 editorConfig.customization.hideNotes 字段。
- 添加了 editorConfig.coEditing 字段。
- 添加了 requestClose 方法。
- 添加了 document.permissions.commentGroups 字段。
- 添加了 events.onPluginsReady 事件。
版本 6.3
- 添加了 license 命令。
- 添加了e 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 字段。
- The document.permissions.rename 字段已弃用,请添加 events.onRequestRename 字段。
版本 5.5
- 转换服务 地址
https://documentserver/ConvertService.ashx
已替换为https://documentserver/converter
。 - 添加了 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 方法。
- 添加了e 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。