API 汇总：ONLYOFFICE 文档最近更新

2025年07月23日作者：Krystal

从更新的自定义选项到 SDK 和 AI 驱动的宏生成，本次更新旨在提升开发效率与创造力。以下是新功能的详细说明。

API 汇总：ONLYOFFICE 文档最新更新

文档集成的新功能

我们发布了 SDK 更新，助您将 ONLYOFFICE 编辑器集成到自有应用和服务中。最新版 Java 和 PHP SDK 增强了格式支持，新增了配置选项，并引入了全新的图表查看器类型。具体更新如下：

Java SDK 1.6.0

Maven Central 上的最新 Java SDK 提供：

新增图表查看器：该 SDK 现在支持初始化在 9.0 版本中引入的 ONLYOFFICE 图表查看器。
新的配置字段：兼容编辑器 9.0 版本，提供更精细的初始化控制。
更新支持格式列表：确保兼容最新的文本文档、电子表格、演示文稿、表单和图表文件类型。
依赖项更新：修复了所有已知漏洞组件，提升安全性和稳定性。

PHP SDK 1.3.0

Packagist 上的最新版本 PHP SDK 支持：

新增图表查看器：开发者可集成图表查看器，适用于流程图、思维导图等。
新增支持查看 .odg 和 .md 文件：扩展了对开放格式和 Markdown 文件的支持。
新增支持编辑 .xlsb 文件：可集成 Excel 二进制工作簿的编辑功能。
新增空白文件模板：支持语言：加泰罗尼亚语 (ca-ES)、捷克语 (cs-CZ)、丹麦语 (da-DK)、匈牙利语 (hu-HU)、印度尼西亚语 (id-ID)、罗马尼亚语 (ro-RO)、阿尔巴尼亚语 (sq-AL)、乌尔都语 (ur-PK)。
最低兼容编辑器 8.0 版本：请将 ONLYOFFICE 文档升级至最新版本以确保完全兼容。

建议所有集成 ONLYOFFICE 编辑器的开发者更新至最新 SDK 版本，以使用新功能并保持与 ONLYOFFICE 文档 8.0 及更高版本的兼容性。

文档 API 新功能

自定义 FAQ ：新增更多常见问题解答，介绍一些冷门技巧：

新增 Office API 示例： 新增多种实用文档模板，满足不同场景需求：

双栏布局：快速创建专业文档（如宣传册、报告）。
横向页面：适用于宽表格和图表展示。
文本水印：自动添加半透明“机密”水印，保障文档安全。
活动邀请函：设计带预设尺寸和个性化信息的邀请函。

插件和宏更新

宏自定义更新： 9.0.3 版本优化了 customization.macros 参数行为。将 macros 设为 false 将彻底禁用宏功能：用户无法运行、添加或编辑宏；“宏”按钮也会从“视图”选项卡隐藏。

const config = {
  editorConfig: {
    customization: {
...
macros: false, 
...

AI 辅助生成宏： AI 集成极大提升了 ONLYOFFICE 宏的开发效率。

自 9.0 版本起，AI 插件可根据文字描述生成宏模板，节省大量手动编写时间。了解更多

API 汇总：ONLYOFFICE 文档最新更新

此外，您可自动将 VBA 代码转换为 ONLYOFFICE 的 JavaScript 宏。

以下是 AI 转换的 VBA 宏示例：

取消合并所有单元格：一键移除所有合并单元格，简化格式调整。
公式转数值：快速将动态公式转为静态数据，确保一致性。
修改单元格值：自动更新指定单元格内容。

查看修改选定单元格值的宏示例：

(function(){
    // Get the active sheet
    var activeSheet = Api.GetActiveSheet();
    
    // Select cell A1
    activeSheet.GetRange("A1").Select();
    
    // Set the value of the selected cell to "Hello World"
    activeSheet.GetRange("A1").SetValue("Hello World");
})();

API 汇总：ONLYOFFICE 文档最新更新

异步计算：添加异步自定义函数以管理函数体内的任何请求。查看计算世界银行指标的示例。 API 汇总：ONLYOFFICE 文档最新更新

新增宏示例：提供更多简化文档流程的新宏示例（附有运行说明），助您减少手动操作，提升效率：

通过合并这些宏，您可以减少手动开销并提高运营效率：

查看设置占位符的代码示例：

(function () {
    let key = "MyKey";
    let placeholderText = "Placeholder";
    let doc = Api.GetDocument();

    doc.GetAllForms()
        .filter(field => field.GetFormType() === "comboBoxForm" && field.GetFormKey() === key)
        .forEach(field => field.SetPlaceholderText(placeholderText));
})();