Как интегрировать ONLYOFFICE Docs с Redmine в Ubuntu
На этой странице
- Шаг 1. Установите ONLYOFFICE Docs
- Шаг 2. Установите приложение для интеграции
- Шаг 3. Настройте приложение для интеграции
- Шаг 4. Используйте ONLYOFFICE Docs в Redmine
ONLYOFFICE Docs — это офисный пакет с открытым исходным кодом, распространяемый по лицензии GNU AGPL v3.0. Он включает веб-средства просмотра и редакторы для совместной работы для текстовых документов, электронных таблиц и презентаций, хорошо совместимые с форматами OOXML.
ONLYOFFICE Docs можно интегрировать с различными облачными сервисами, такими как Nextcloud, ownCloud, Seafile, Alfresco, Plone и т. д., а также встроить в собственное решение. Редакторы также можно использовать как часть комплексного решения ONLYOFFICE Workspace.
Redmine — это бесплатный инструмент с открытым исходным кодом для управления проектами и отслеживания проблем, который включает вики и форумы для каждого проекта, отслеживание времени и гибкий контроль доступа на основе ролей. Благодаря интегрированному ONLYOFFICE Docs вы можете редактировать и совместно редактировать офисные документы прямо из Redmine.
В этом руководстве мы узнаем, как подключить ONLYOFFICE Docs и экземпляры Redmine с помощью приложения для интеграции.
Обратите внимание, что ONLYOFFICE совместим с Redmine версии 4.0.0 или выше.
Шаг 1. Установите ONLYOFFICE Docs
Чтобы иметь возможность редактировать документы в Redmine, вам нужен экземпляр ONLYOFFICE Docs (Document Server), который разрешается и подключается как из Redmine, так и из любых конечных клиентов. Документы ONLYOFFICE также должны иметь возможность напрямую публиковать сообщения в Redmine.
Самый простой способ установить последнюю версию пакета со всеми зависимостями — использовать Docker, выполнив следующую команду:
sudo docker run -i -t -d -p 80:80 --restart=always onlyoffice/documentserver
Вы можете найти подробные инструкции в этом учебнике HowtoForge.
Шаг 2. Установите приложение для интеграции
Загрузите коннектор ONLYOFFICE для Redmine. Клонируйте основную ветку с GitHub:
git clone https://github.com/ONLYOFFICE/onlyoffice-redmine
или скачайте и разархивируйте последнюю заархивированную версию:
wget https://github.com/ONLYOFFICE/onlyoffice-redmine/archive/refs/tags/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 -> Настроить. Укажите следующие параметры:
- URL-адрес и порт установленного сервера документов ONLYOFFICE.
- Секретный ключ для включения JWT, защищающего ваши документы от несанкционированного доступа. Вам также необходимо указать тот же секретный ключ в файле конфигурации Сервера документов ONLYOFFICE, чтобы включить проверку.
- При необходимости измените настройки редактора.
Шаг 4. Используйте ONLYOFFICE Docs в Redmine
Вы можете просматривать, редактировать и совместно работать над текстовыми документами, электронными таблицами и презентациями, загруженными в модули «Проблемы», «Файлы», «Документы», «Вики» или «Новости» в Redmine. Для каждого модуля права доступа к просмотру или редактированию файлов зависят от разрешений роли пользователя.
В настоящее время вы можете редактировать и совместно работать над файлами 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 Docs.