API 汇总:ONLYOFFICE 文档最近更新
从更新的自定义选项到 SDK 和 AI 驱动的宏生成,本次更新旨在提升开发效率与创造力。以下是新功能的详细说明。
关于 ONLYOFFICE 文档
ONLYOFFICE 文档是多合一的文档编辑套件,支持文字、表格、幻灯片、PDF和表单的编辑与协作,高度兼容微软Office格式。易于使用和集成,可以在您的网站、平台或系统中高效处理多种类型的文档,实现文件格式间的便捷转换和无缝协作。
文档集成更新
我们发布了 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 插件可根据文字描述生成宏模板,节省大量手动编写时间。了解更多
此外,您可自动将 VBA 代码转换为 ONLYOFFICE 的 JavaScript 宏。
以下是 AI 转换的 VBA 宏示例:
- 取消合并所有单元格:一键移除所有合并单元格,简化格式调整。
- 公式转数值:快速将动态公式转为静态数据,确保一致性。
- 修改单元格值:自动更新指定单元格内容。
查看修改选定单元格值的宏示例:
(function(){// Get the active sheetvar activeSheet = Api.GetActiveSheet();// Select cell A1activeSheet.GetRange("A1").Select();// Set the value of the selected cell to "Hello World"activeSheet.GetRange("A1").SetValue("Hello World");
})();
异步计算:添加异步自定义函数以管理函数体内的任何请求。查看计算世界银行指标的示例。
新增宏示例:提供更多简化文档流程的新宏示例(附有运行说明),助您减少手动操作,提升效率:
通过合并这些宏,您可以减少手动开销并提高运营效率:
- 自动填充字段
- 自动适应文本字段
- 插入计算
- 限制字符数
- 修改列表值
- 移除默认值
- 设置占位符
- 加粗项目符号
- 生成大纲
- 删除重复幻灯片
- 删除幻灯片
- 查找无效邮箱
查看设置占位符的代码示例:
(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));
})();
相关链接
API 文档
开发者版 ONLYOFFICE 协作空间
开发者版 ONLYOFFICE 文档
下载开发者版本