如何在 Ubuntu 上将 ONLYOFFICE 文档集成至 Redmine

ONLYOFFICE 文档是一款符合 GNU AGPL v3.0 的开源办公套件。其中包含基于 Web 的查看器和协作编辑器，可用于处理文本文档、电子表格以及与 OOXML 格式高度兼容的演示文稿。

ONLYOFFICE 文档可与 Nextcloud、ownCloud、Seafile、Alfresco、Plone 等多种云服务进行集成，还可嵌入至您自己的解决方案中。编辑器还可作为完整生产力解决方案 ONLYOFFICE 工作区的一部分进行使用。

​​Redmine​​ 是一款免费开源的项目管理与问题追踪工具，其中集成了项目百科与论坛、时间追踪以及灵活的基于角色的访问权限控制功能。在集成 ONLYOFFICE 后，您可直接在 Redmine 中对办公文档进行编辑和共同编辑。

在本教程中，我们将了解如何使用集成应用实现 ONLYOFFICE 文档与 Redmine 实例之间的连接。

请注意，ONLYOFFICE 兼容 Redmine v4.0.0 及更高版本。

第 1 步：安装 ONLYOFFICE 文档

如需在 Redmine 中编辑文档，您需要安装 ONLYOFFICE 文档实例（文档服务器），且确保其能够在 Redmine 与一切终端客户端中进行解析和连接。ONLYOFFICE 文档还需要能够直接通过 POST 方式与 Redmine 进行连接。

安装带有所有依赖的最新版本套件的最简单方式是使用 Docker 运行以下命令：

sudo docker run -i -t -d -p 80:80 --restart=always onlyoffice/documentserver

您可在​​此 HowtoForge 教程​​中找到详细说明。

第 2 步：安装集成应用

下载 Redmine 的 ONLYOFFICE 连接器。从 ​​GitHub​​ 上克隆 master 分支：

git clone https://github.com/ONLYOFFICE/onlyoffice-redmine

或下载并解压最新的归档版本：

wget https://github.com/ONLYOFFICE/onlyoffice-redmine/archive/refs/tags/v1.0.0.tar.gztar -xvzf v1.0.0.tar.gz

tar -xvzf v1.0.0.tar.gz

您还可从 ​​Redmine 插件目录​​中获取此应用。

插件子目录必须命名为 onlyoffice_redmine。您可将已克隆的 onlyoffice-redmine 或解压缩的 onlyoffice_redmine-x.y.z 文件夹重命名为 onlyoffice_redmine。

mv onlyoffice-redmine onlyoffice_redmine
mv onlyoffice-redmine-1.0.0 onlyoffice_redmine

然后确保已停止 Redmine 实例，并将 onlyoffice_redmine 插件目录放入 redmine/plugins 文件夹中。

前往 Redmine 根目录并安装依赖：

cd redmine
bundle install
Initialize/update the database:
RAILS_ENV=production bundle exec rake db:migrate
RAILS_ENV=production bundle exec rake redmine:plugins:migrate NAME=onlyoffice_redmine

完成后重启 Redmine 实例。

第 3 步：配置集成应用

在安装了连接器后，可通过 Redmine 界面对其进行配置。前往“管理 -> 插件 -> ONLYOFFICE Redmine 插件 -> 配置”。指定以下设置：

• 已安装 ONLYOFFICE 文档服务器的 URL 与端口。
• 用于保护文档不受未授权访问侵扰的 JWT Secret Key。您还需要在 ONLYOFFICE 文档服务器的配置文件中声明相同的 Secret Key 以启用验证。
• 如有必要还可进行编辑器自定义设置。

第 4 步：在 Redmine 内使用 ONLYOFFICE 文档

现在，您将可在 Redmine 中就上传至问题、文件、文档、Wiki 或新闻模块的文本文档、电子表格以及演示文稿进行查看、编辑与协作。各模块的文件查看或编辑权限取决于用户角色权限。

目前您可就 DOCX、XLSX 以及 PPTX 文件进行编辑和协作。

其他可供查看的格式有：DOC、DOCX、DOCM、DOT、DOTX、DOTM、ODT、FODT、OTT、RTF、TXT、HTML、HTM、MHT、XML、PDF、DJVU、FB2、EPUB、XPS、XLS、XLSX、XLSM、XLT、XLTX、XLTM、ODS、FODS、OTS、CSV、PPS、PPSX、PPSM、PPT、PPTX、PPTM、POT、POTX、POTM、ODP、FODP、OTP。

协作功能方面则有以下可用选项：实时和段落锁定共同编辑模式、跟踪更改、评论以及内置聊天。

这就完成啦！现在相信您能轻松地在 Redmine 中直接使用 ONLYOFFICE 文档对办公内容进行编辑和协同处理了。