开发者版 ONLYOFFICE 文档 7.4：API 和文档生成器更新介绍

随着 7.4版本中新功能的发布，我们更新了编辑器、插件和文档生成器的 API。阅读下文了解所有详细信息。

支持更多文件格式

7.4 版本支持更多的文件格式：

• 文档——mhtml、stw、sxw、wps、wpt；
• 电子表格 — et, et, sxc；
• 演示文稿——dps、dpt、sxi。

更多setUsers 方法的参数

setUsers 方法设置要在评论中提及的用户列表或授予编辑特定工作表范围的访问权限。

新增的users.id字段定义了用户的标识。它仅用于在向指定用户授予编辑权限时保护工作表范围。

而新添加的 c 参数定义了来自 onRequestUsers  事件的操作类型。它可以采用以下值之一——提及或保护。

docEditor.setUsers({
    "c": "protect",
    "users": [
        {
            "email": "john@example.com",
            "id": "78e1e841",
            "name": "John Smith"
        },
        {
            "email": "kate@example.com",
            "id": "F89d8069ba2b",
            "name": "Kate Cage"
        },
        ...
    ]
});

绘图

从现在开始，在每个编辑器中都可用绘图功能。

使用 ONLYOFFICE 文档开发者版本，并且具备扩展许可的用户能够通过 editorConfig.customization.layout.toolbar 参数显示或隐藏这个新的绘图选项卡。

自定义字体大小

editorConfig.customization.font 参数中新添加的size字段支持调整按钮、选项卡等界面元素的字体。

请注意：此选项适用于拥有扩展开发人员许可证的用户。

支持中文达梦数据库

新增支持的数据库：中国的达梦。要连接它，请将数据库类型更改为 dameng。例如，对于 Docker，您需要调整DB_TYPE 参数。

其他更新

• useforrequest WOPI IP 过滤器参数更改为 false。
• 用于 WOPI discovery 的mobileView 和 mobileEdit。
• 更新了 node-redis 连接器。

获取最新版本的ONLYOFFICE 文档 开发者版：

立即下载

优化的插件 API

得益于扩展的 API，插件现在可以拥有任意数量的窗口（例如，您可以在单独的窗口中执行自定义脚本）并动态嵌入编辑器的上下文菜单中。它为您提供了更多的自由，并且能在更多场景中使用插件。

这里最突出的例子之一是我们更新的 ChatGPT 插件。从现在开始，它提供了更多有用的功能，例如单词分析、生成图像、文本摘要和关键字、翻译等。了解更多

使用 pluginsmanager （插件管理）服务器实用程序，在需要手动安装时，管理员无需复制文件夹，使用单个命令行即可安装或卸载插件，例如：

pluginsmanager --install zotero

pluginsmanager --install "zotero, chess"

pluginsmanager --uninstall zotero

此外，我们添加了许多用于插件的新事件和方法，包括：

• onContextMenuClick 和 onContextMenuShow 事件；
• GetCurrentSentence 和 GetCurrentWord 方法，用于返回当前句子或单词，还可指定是否返回整个句子/单词或仅返回其部分；
• InstallDeveloperPlugin 方法，通过插件配置的 URL 安装插件；
• GetDocumentLang 方法， 它返回文档语言；
• ResizeWindow 方法， 调整插件模态窗口大小。

完整的插件 API 更新列表

以下为 InstallDeveloperPlugin 方法的代码示例：

window.Asc.plugin.executeMethod ("InstallDeveloperPlugin", ["https://example.com/plugin/config.json"], 
function (result) {
    postMessage (JSON.stringify (result));
});

更新了文档生成器的 API

现在可以在 Chrome 或 Chromium 浏览器（适用于 Windows 和 Linux）中方便地调试 文档生成器 JS core。

此外，在文档生成器 API 中，我们为电子表格 API 添加了许多新的字符、字体和范围方法，以及一些其他方法，包括以下的：

• ApiCharacters/GetFont
• ApiFont/GetColor
• ApiRange/Replace
• ApiBlockLvlSdt/AddCaption
• ApiDocument/InsertTextForm

查看新的文档生成器方法的完整列表。

下载生成器