HowtoForge

So integrierst du ONLYOFFICE Docs mit Redmine unter Ubuntu

von ·

ONLYOFFICE Docs ist eine Open-Source-Office-Suite, die unter der GNU AGPL v3.0 verbreitet wird. Sie umfasst webbasierte Viewer und kollaborative Editoren für Textdokumente, Tabellenkalkulationen und Präsentationen, die mit OOXML-Formaten kompatibel sind.

ONLYOFFICE Docs kann in verschiedene Cloud-Dienste wie Nextcloud, ownCloud, Seafile, Alfresco, Plone usw. integriert und auch in deine eigene Lösung eingebettet werden. Die Editoren können auch als Teil der kompletten Produktivitätslösung ONLYOFFICE Workspace genutzt werden.

Redmine ist ein kostenloses und quelloffenes Projektmanagement- und Problemverfolgungstool, das projektspezifische Wikis und Foren, Zeiterfassung und eine flexible rollenbasierte Zugriffskontrolle umfasst. Mit den integrierten ONLYOFFICE Docs kannst du Office-Dokumente direkt in Redmine bearbeiten und mitverfassen.

In diesem Tutorial lernst du, wie du ONLYOFFICE Docs und Redmine-Instanzen mithilfe einer Integrations-App verbinden kannst.

Beachte, dass ONLYOFFICE mit Redmine v.4.0.0 oder höher kompatibel ist.

Schritt 1: Installiere ONLYOFFICE Docs

Um Dokumente in Redmine bearbeiten zu können, brauchst du eine Instanz von ONLYOFFICE Docs (Dokumentenserver), die sowohl von Redmine als auch von den Endclients aus auflösbar und verbindbar ist. ONLYOFFICE Docs muss außerdem in der Lage sein, direkt in Redmine zu posten.
Der einfachste Weg, die neueste Version der Suite mit allen Abhängigkeiten zu installieren, ist die Verwendung von Docker, indem du den folgenden Befehl ausführst:

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

Eine detaillierte Anleitung findest du in diesem HowtoForge-Tutorial.

Schritt 2: Installiere die Integrations-App

Lade den ONLYOFFICE Connector für Redmine herunter. Klone den Master-Zweig von GitHub:

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

oder lade die neueste archivierte Version herunter und entpacke sie:

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

Du kannst die App auch aus dem Redmine Plugins-Verzeichnis herunterladen.

Das Plugin-Unterverzeichnis muss den Namen onlyoffice_redmine tragen. Benenne den geklonten Ordner onlyoffice-redmine oder den entpackten Ordner onlyoffice_redmine-x.y.z in onlyoffice_redmine um.

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

Stelle dann sicher, dass die Redmine-Instanz gestoppt ist und lege das onlyoffice_redmine-Plugin-Verzeichnis in den Ordner redmine/plugins.

Gehe in das Redmine-Stammverzeichnis und installiere die Abhängigkeiten:

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

Starte anschließend die Redmine-Instanz neu.

Schritt 3: Konfiguriere die Integrations-App

Sobald du den Connector installiert hast, konfiguriere ihn über die Redmine-Oberfläche. Gehe zu Verwaltung -> Plugins -> ONLYOFFICE Redmine Plugin -> Konfigurieren. Gib die folgenden Einstellungen an:

  • Die URL und den Port des installierten ONLYOFFICE Document Servers.
  • Den geheimen Schlüssel, um JWT zu aktivieren, das deine Dokumente vor unberechtigtem Zugriff schützt. Du musst denselben geheimen Schlüssel auch in der ONLYOFFICE Document Server-Konfigurationsdatei angeben, um die Validierung zu aktivieren.
  • Editor-Anpassungseinstellungen, falls erforderlich.

Einstellungen

Schritt 4: ONLYOFFICE Docs in Redmine verwenden

Du kannst Textdokumente, Tabellenkalkulationen und Präsentationen, die in die Module Issues, Files, Documents, Wiki oder News in Redmine hochgeladen wurden, anzeigen, bearbeiten und gemeinsam bearbeiten. Für jedes Modul hängen die Zugriffsrechte zum Anzeigen oder Bearbeiten von Dateien von den Benutzerrollenberechtigungen ab.

Einstellung der Erlaubnis

Derzeit kannst du DOCX-, XLSX- und PPTX-Dateien bearbeiten und mit ihnen zusammenarbeiten.

ONLYOFFICE Redmine Integration

Andere Formate sind zur Ansicht verfügbar: 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.
Für die Zusammenarbeit stehen folgende Funktionen zur Verfügung: Echtzeit- und absatzsichernde Co-Editing-Modi, Änderungen verfolgen, Kommentare und ein integrierter Chat.
Das ist alles! Mit ONLYOFFICE Docs kannst du jetzt Office-Dokumente direkt in deinem Redmine bearbeiten und mitverfassen.

Das könnte dich auch interessieren …