Redmine

此插件允许用户使用打包为Document Server的ONLYOFFICE Docs（社区或企业版）编辑Redmine中的附件。

功能¶

- 查看和编辑文本文档、电子表格、演示文稿和表单。
- 使用两种协同编辑模式（快速和严格）实时协同编辑文档，跟踪更改、注释、内置聊天。
- 设置页面以设置到服务器的连接和JWT身份验证，自定义编辑器的外观。
- 为授权编辑器提供移动视图。
- 使用考虑用户语言偏好的模板创建新附件。
- 转换附件并保存或下载它们。

支持格式¶

• 要能够打开用于编辑的格式，请在[格式设置](#formats)中勾选它。由于某些格式限制，可能会发生数据丢失。

配置Redmine ONLYOFFICE集成插件¶

常规设置¶

• 文档编辑服务地址。
  已安装ONLYOFFICE Docs（文档服务器）的URL。留空以禁用插件。

高级服务器设置¶

• ONLYOFFICE Docs内部请求的地址。
• ONLYOFFICE Docs内部请求的服务器地址。
• 连接到演示ONLYOFFICE Docs服务器。

安全¶

• 密钥。
  从ONLYOFFICE文档服务器7.2开始，JWT身份验证默认启用，密钥自动生成以限制对ONLYOFFICE Docs的访问、出于安全和数据完整性的原因。在ONLYOFFICE Docs配置文件中指定您的密钥（https://api.onlyoffice.com/editors/signature/），然后在插件的设置页面中指定相同的密钥。留空以禁用身份验证。
• 授权头。
• 禁用证书验证（不安全）。

编辑器自定义设置¶

• 显示聊天菜单按钮。
• 显示更紧凑的标题。
• 显示反馈和支持菜单按钮。
• 显示帮助菜单按钮。
• 显示单色工具栏标题。

格式¶

• 指定允许直接打开进行编辑的格式列表。

安装ONLYOFFICE Docs¶

在进行插件安装之前，请确保您有一个可以从Redmine和任何终端客户端解析和连接的ONLYOFFICE Docs（文档服务器）实例。此外，请确保ONLYOFFICE Docs可以直接向Redmine POST。

ONLYOFFICE Docs拥有免费的社区版和可扩展的企业版。

我们建议使用Docker https://github.com/onlyoffice/Docker-DocumentServer 来安装免费社区版。或者，您可以按照以下说明进行操作 https://helpcenter.onlyoffice.com/installation/docs-community-install-ubuntu.aspx 在Debian、Ubuntu或其衍生版上安装。

要安装企业版，请按照以下说明操作 https://helpcenter.onlyoffice.com/installation/docs-enterprise-index.aspx。

安装Redmine ONLYOFFICE集成插件¶

要安装此插件，您需要Redmine版本4.2或更高版本，或版本5.0或更高版本。还应注意，插件与Ruby 2.7.2或更高版本，或3.0.0或更高版本兼容。我们建议使用Redmine 5与Ruby 3一起使用。

安装Redmine后，下载插件 https://github.com/ONLYOFFICE/onlyoffice-redmine/releases。
curl --location https://github.com/ONLYOFFICE/onlyoffice-redmine/releases/latest/download/onlyoffice_redmine.tar.zst --output onlyoffice_redmine.tar.zst

将其解压缩到插件目录中。
tar --extract --file onlyoffice_redmine.tar.zst --directory plugins

如果Redmine没有自动完成，请安装插件的依赖项。
bundle install

执行迁移。
RAILS_ENV=production bundle exec rake redmine:plugins:migrate NAME=onlyoffice_redmine

最后，重启Redmine。有关插件安装的更多信息，请参阅Redmine Wiki页面 https://redmine.ruby-lang.org.cn/projects/redmine/wiki/Plugins#Installing-a-plugin。