Confluence ONLYOFFICE 集成应用

该 插件 让用户能够从 Confluence 中用 ONLYOFFICE 文档编辑办公文档。

该连接器可在官方 Atlassian Marketplace中获得。

特性

• 目前，可以编辑或查看以下格式的文档：DOCX、XLSX、PPTX、DOCXF、OFORM。
• 该插件将在 Office 文档的文档库中创建一个新的菜单选项- 在ONLYOFFICE 中编辑。 这允许多个用户实时协作并将这些更改保存到 Confluence中。
• 目前，可以将以下文档格式转换为OOXML：ODT、DOC、ODP、PPT、ODS、XLS。

安装 ONLYOFFICE 文档

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

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

安装 Confluence ONLYOFFICE 集成应用

将编译好的 target/onlyoffice-confluence-plugin.jar 上传到 Confluence 的 Manage add-ons 页面。

最新的编译包文件可在 此处 和 Atlassian Marketplace上获得。

您还可以从 Confluence 管理面板安装该应用程序：

1. 以管理员身份登录您的 Confluence 实例。
2. 导航到 Manage add-ons 页面。
3. 单击左侧面板上的 Find new apps 或 Find new add-ons。
4. 使用搜索找到 ONLYOFFICE Connector for Confluence 。 结果将包括与您的 Confluence 实例兼容的附加组件版本。
5. 单击 Install 以下载并安装该应用程序。
6. 现在您可以在 Installed and ready to go 对话框中单击 Close。

安装 Confluence ONLYOFFICE 集成应用

在 Manage add-ons 页面上找到上传的 Confluence ONLYOFFICE integration app。 单击 Configure 并输入安装了 ONLYOFFICE 文档的服务器的名称：

https://documentserver/

其中 documentserver 是安装了 ONLYOFFICE 文档 的服务器的名称。 该地址必须可从用户浏览器和 Confluence 服务器访问。 为了正常工作，Confluence 服务器地址也必须可以从 ONLYOFFICE 文档 访问。

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

编译 Confluence ONLYOFFICE 集成应用

如果您打算自己编译 Confluence ONLYOFFICE 集成应用程序（例如编辑源代码并在之后编译它），请按照以下步骤操作：

1. 成功构建需要稳定的 Java 版本。 如果您没有安装它，请使用以下命令安装 Open JDK 8：

   sudo apt-get update sudo apt-get install openjdk-8-jdk
2. 安装 Atlassian Plugin SDK。此处描述了安装过程。
3. 获取子模块： git submodule update --init --recursive
4. 编译包： atlas-package

这是如何运作的

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

1. 用户导航到 Confluence 附件并选择 在ONLYOFFICE中编辑 操作。
2. Confluence 向 OnlyOfficeEditorServlet 发出请求（表单的 URL：/plugins/servlet/onlyoffice/doceditor?attachmentId=$attachment.id).
3. Confluence 将文档发送到 ONLYOFFICE 文档存储服务并接收临时链接。

4. Confluence 准备一个具有以下属性的 JSON 对象：

   • url - ONLYOFFICE 文档用于下载文档的临时链接；
   • callbackUrl - ONLYOFFICE 文档通知文档编辑状态的 URL；
   • docserviceApiUrl - 客户端需要回复 ONLYOFFICE 文档的 URL（由 files.docservice.url.api 属性提供）；
   • key - 指示 ONLYOFFICE 文档是否再次下载文档的 UUID；
   • title - 文档标题（名称）。
5. Confluence 使用这个对象并从 freemarker 模板构建一个页面，填充所有这些值，以便客户端浏览器可以加载编辑器。
6. 客户端浏览器从 ONLYOFFICE 文档向 JavaScript 库发出请求，并向 ONLYOFFICE 文档发送包含上述属性的 DocEditor 配置。
7. 然后 ONLYOFFICE 文档从 Confluence 下载文档，用户开始编辑。
8. 当所有用户和客户端浏览器都完成编辑后，他们会关闭编辑窗口。
9. 在 10 秒 不活动后，ONLYOFFICE 文档会向 回调 URL 发送一个 POST，让 Confluence 知道客户端已完成对文档的编辑并关闭它。
10. Confluence 下载文档的新版本，替换旧版本。

在 此处下载 Confluence ONLYOFFICE 集成应用程序。