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 文档对办公内容进行编辑和协同处理了。
