开发人员 ONLYOFFICE 文档 v7.3：API 与文档生成器更新

news2024/12/28 23:37:40

随着版本 7.3 新功能的发布，我们也对编辑器、插件以及文档生成器的 API 进行了更新。在下方了解更多详情。

增强的 WOPI 支持

从现在开始，您可在 WOPI 集成中使用二进制格式，如 doc、ppt 以及 xls。我们现已实现了相应方案，其中包括 WOPI 发现中的转换操作。其会将将二进制文件转换为 docx、pptx 以及 xlsx 以便进一步编辑。

此外我们还添加了 WOPI 转换 API 以便轻松处理不同的办公文件格式。

<form action="https://documentserver/cool/convert-to/docx" enctype="multipart/form-data" method="post">     
File: <input type="file" name="data"><br/>     
<input type="submit" value="Convert to DOCX">
</form>

CheckFileInfo WOPI 操作中的 UserCanNotWriteRelative 属性，用于声明用户是否有权限在 WOPI 服务器上新建文件。

PutRelativeFile WOPI 操作，可根据当前文件在主机上创建新文件。

在电子表格中插入外部数据

最新添加的 document.referenceData 参数定义了由集成器生成、用于在系统中对文件进行识别的对象。

搭配已实现的 setReferenceData 方法和 onRequestReferenceData 事件，其现在可使用文件链接来进行数据刷新，例如：用户可通过点击外部链接对话框中的相应按钮来更新从外部文件插入的值。了解更多

var onRequestReferenceData = function () {
var referenceData =  event.data.referenceData;
var path = event.data.path;
   ...
docEditor.setReferenceData({
 "fileType": "xlsx",
 "path": "sample.xlsx",
 "referenceData": {
"fileKey": "BCFA2CED",
"instanceId": "https://example.com"
 },
 "url": "https://example.com/url-to-example-document.xlsx"
 });
};
var docEditor = new DocsAPI.DocEditor("placeholder", {
"events": {
"onRequestReferenceData": onRequestReferenceData, 
 ...
    },
 ...
});

界面定制

拥有扩展许可的 ONLYOFFICE 文档开发者版用户可通过配置文件使用对编辑器前端界面进行定制的全新选项：

调整按钮、标签页等界面元素的字体；
定义右侧/左侧面板可见性的初始值 – 可见或隐藏

插件与宏 API 更新

initDataType 配置参数中的 Sign 类型。
从文档中返回所有 VBA 宏的 GetVBAMacros 方法。
实现外部拖放模拟的 OnDropEvent 方法。
现可在 window.Asc.plugin.executeMethod 中使用 Spreadsheet Api 与 Presentation Api。
下方提供了有关 OnDropEvent 方法的代码示例：

window.Asc.plugin.executeMethod("OnDropEvent", [{
  type: "ondrop",
  x : pos.x,
  y : pos.y,
  text : "test text",
  html : "test html"
}]);

文档生成器 API 更新

在 DocBuilder API 中，我们添加了许多新的注释、内容/图表以及其他方法，包括：

ApiBlockLvlSdt/AddComment
ApiComment/GetAutorName
ApiDocument/AddTableOfContents
ApiDocument/AddTableOfFigures
ApiParagraph/AddCaption
ApiDocument/GetStatistics

请查看新方法的完整列表。

请注意：目前已可使用更新后的 DocBuilder API。ONLYOFFICE 文档生成器的安装文件将很快更新至 v7.3。