Liferay ONLYOFFICE 连接器

该 插件 使用户可以从 Liferay 中使用 ONLYOFFICE 文档编辑办公文档。

特性

• 目前可以使用此插件打开和编辑以下文档格式：DOCX、XLSX、PPTX、DOCXF、OFORM。
• 以下格式仅供查看：ODT、ODS、ODP、DOC、XLS、PPT。
• 该插件将在 Office 文档的 文档和媒体 部分中创建一个新的 ONLYOFFICE 编辑/查看 菜单选项。 这允许多个用户实时协作并将这些更改保存到 Liferay。

安装 ONLYOFFICE 文档

您将需要一个可从 Liferay 和任何终端客户端解析和连接的 ONLYOFFICE 文档（文档服务器）实例。 如果不是这种情况，请使用官方 ONLYOFFICE 文档文档页面。 ONLYOFFICE 文档还必须能够直接发布到 Liferay。

启动 ONLYOFFICE 文档实例的最简单方法是使用 Docker。

安装 Liferay ONLYOFFICE 连接器

从 Liferay Marketplace 安装它， 或者如果您自己构建连接器，只需将编译的 .jar 文件从 build\libs 文件夹放入 /opt/liferay/deploy。 Liferay 会自动安装它。

配置 Liferay ONLYOFFICE 连接器

为了配置连接器，您必须导航到 系统设置 （控制面板 -> 配置 -> 系统设置）。 在 平台 部分单击 连接器 类别并选择 ONLYOFFICE。

从 7.2 版开始，默认情况下启用 JWT，并自动生成密钥以限制对 ONLYOFFICE 文档的访问，这也是出于安全原因和数据完整性考虑。 在 Liferay 系统设置 页面上指定您自己的密钥。 在 ONLYOFFICE 文档 配置文件中，指定相同的密钥并启用验证。

编译 Liferay ONLYOFFICE 连接器

只需运行 gradle build。 输出 .jar 将放置在 build/libs 目录中。

这个怎么运作

ONLYOFFICE 集成遵循此处的 API文档。

1. 用户导航到 Liferay 中的 文档和媒体 部分并选择 在 ONLYOFFICE 中编辑 操作。

2. Liferay 为文档服务器准备了一个 JSON 对象，具有以下属性：

   • url: ONLYOFFICE 文档用于下载文档的 URL，
   • callbackUrl: ONLYOFFICE 文档通知文档编辑状态的 URL；
   • key: fileVersionId 指示ONLYOFFICE 文档是否重新下载文档；
   • title：文档标题（名称）。
3. 客户端浏览器从 ONLYOFFICE 文档向 JavaScript 库发出请求，并向 ONLYOFFICE 文档发送具有上述属性的 DocEditor 配置。
4. 然后 ONLYOFFICE 文档从 Liferay 下载文档，用户开始编辑。然后 ONLYOFFICE 文档从 HumHub 下载文档，用户开始编辑。
5. ONLYOFFICE 文档向 callbackUrl 发送 POST 请求，通知 HumHub 用户正在编辑文档。
6. ONLYOFFICE 文档向回调URL 发送 POST 请求，以通知 Liferay 用户正在编辑文档。
7. 当所有用户和客户端浏览器都完成编辑后，他们会关闭编辑窗口。
8. 在 10 秒 不活动后，ONLYOFFICE 文档向回调URL 发送一个 POST，让 Liferay 知道客户端已完成对文档的编辑并关闭它。
9. Liferay 下载文档的新版本，替换旧版本。

在 此处下载 Liferay ONLYOFFICE 连接器。