面向开发者的 API 更新汇总：ONLYOFFICE 文档 9.1 和协作空间 3.5

欢迎阅读 ONLYOFFICE 最新 API 更新汇总。随着 ONLYOFFICE 文档 9.1 和协作空间 3.5 的发布，我们引入了一系列强大的新功能和改进，旨在为开发者提供更高的灵活性和更高效的工作方式。

本文将带您了解关键更新，从文档中新增的格式支持和自定义选项，到协作空间 SDK 的重大改进。让我们一起探索这些新版本将为您的开发项目带来哪些新变化。

ONLYOFFICE 文档 9.1 版本更新

ONLYOFFICE 文档 9.1 版本带来了一系列 API 增强功能。

新增格式支持和转换

为了扩展文档兼容性，我们新增了对多种格式的支持，并扩展了转换功能：

• 打开 HML 文件；
• 将 PPTX 演示文稿转换为 TXT 格式。

自定义

现在您可以更灵活地调整编辑器的外观。用于设置编辑器主题的 editorConfig.customization.uitheme 参数已支持移动版本，方便你在不同设备上保持统一的界面风格。

我们还更新了 editorConfig.customization.logo.image 的尺寸要求。现在，您可以使用尺寸为 300×20 像素的图像在编辑器标题中显示您的自定义logo。

const config = {  
   editorConfig: {    
     customization: {
      logo: {        
      image: "https://example.com/logo.png",
      ....
      uiTheme: "theme-dark", ...

WOPI 集成

对于使用网页应用程序开放平台接口 (WOPI) 的用户，我们在 CheckFileInfo 操作中引入了 UserCanOnlyComment 属性。此布尔属性允许您指定用户是否仅具有评论权限，从而限制其进行其他编辑。

此外，我们改进了错误处理。如果文档无法通过 WOPI 锁定，现在将以查看器模式打开，并显示相应的错误消息，从而确保更流畅的用户体验。

插件新方法

我们扩展了电子表格和演示文稿的 API，新增了 RemoveOleObject 方法（适用于工作表 / 幻灯片）。此方法允许您使用内部 ID 以编程方式从工作簿或演示文稿中删除 OLE 对象，从而更好地控制嵌入内容。

expression.RemoveOleObject(internalId);

Office API

Office JavaScript API 9.1 版本引入了大量新方法。这些新增功能为程序化文档操作（尤其是在电子表格中）开辟了强大的新可能性。主要扩展领域包括：

• 条件格式：一套全面的条件格式规则管理方法，包括高于平均值、颜色标度、数据条、图标集、前 10 名和唯一值。
• 几何图形和路径：用于处理几何图形、路径和路径命令的新方法，让您可以更精细地控制形状和绘图。
• 自定义 XML：用于与文档中的自定义 XML 部分进行交互的方法。
• 对象和属性管理：用于管理文档属性的新转换方法和工具。
• 高级对象控制：增强了处理节、工作簿、数据透视表、范围和演示文稿的方法。

查看新方法的完整列表

更新的 SDK 和集成示例

为了支持这些更新，我们发布了与文档 9.1 兼容的更新版 Java SDK。它支持新的演示到 TXT 的转换以及 HTML 格式处理。

我们还更新了编辑器连接的测试示例，包括演示文档 9.1 版本格式支持的 Node.js 示例。请在 GitHub 上查看

ONLYOFFICE 协作空间 3.5 更新

协作空间 3.5 带来了一系列重要更新，主要侧重于通过增强 SDK 来提升开发者的能力。

协作空间插件 SDK 2.0.0

新版插件 SDK 引入了多项关键改进，旨在提升安全性和模态对话框功能。

• 增强的文件安全性：为了更好地组织和清晰地定义文件安全设置，我们将文件安全设置移至单独的 FilesSecurity 枚举中。IFileItem 接口现在包含 fileSecurity 和 security 属性。
• 改进的模态对话框：现在，您可以使用 withoutBodyPadding 和 withoutHeaderMargin 属性来创建外观更易于控制的模态对话框。此外，我们还添加了 updateCreateDialogModal 操作，用于动态更新。
• 更智能的创建对话框：ICreateDialog 接口新增了 isAutoFocusOnError、errorText、onError、onChange、isCloseAfterCreate 和 isCreateDisabled 等属性，让您可以更精细地控制用户交互和表单验证。

您也可以在协作空间中体验基于 SDK 2.0.0 的更新系统插件：

• draw.io
• Markdown
• PDF Converter
• Speech-to-Text

协作空间 3.5 API SDK 已更新

为了与协作空间 3.5 版本同步，我们已更新了多种语言的 API SDK。这些 SDK 提供了一种便捷的方式来与协作空间 API 交互，并以编程方式管理文件、用户和房间。

更新后的 SDK 适用于：

• TypeScript：npm 上的@onlyoffice/docspace-api-sdk
• C#：NuGet 上的DocSpace.API.SDK
• Python：PyPI 上的docspace-api-sdk

立即开始构建

ONLYOFFICE 文档和协作空间的最新更新为开发者提供了更丰富、更强大的工具包。从编辑器中更深入的 API 控制和自定义，到更强大的协作空间插件 SDK，这些增强功能旨在帮助您构建更集成、功能更丰富的解决方案。

我们鼓励您查阅更新后的文档，下载最新的 SDK，并在您的项目中开始应用这些新功能。我们期待看到您的作品！

获取面向开发者的最新 ONLYOFFICE 文档：

下载