ONLYOFFICE Docs mit Redmine verbinden – Anleitung zur Integration

ONLYOFFICE Docs ist eine leistungsstarke Open-Source-Office-Lösung, die gemeinsame Online-Bearbeitung von Textdokumenten, Tabellen und Präsentationen ermöglicht. Die Suite unterstützt vollständig das OOXML-Format und lässt sich nahtlos in verschiedene Cloud-Plattformen integrieren, darunter Nextcloud, Seafile, Alfresco, Redmine, ownCloud und weitere.

Redmine wiederum ist ein vielseitiges Open-Source-Werkzeug für Projektmanagement und Aufgabenverfolgung. Durch die Verknüpfung mit ONLYOFFICE Docs können in Redmine abgelegte docx-, xlsx- und pptx-Dateien direkt innerhalb der Module wie Tickets, Dateien, Dokumente, Wiki oder News bearbeitet und gemeinsam genutzt werden. Die Zugriffsrechte richten sich dabei nach den Benutzerrollen in den jeweiligen Modulen.

Systemvoraussetzungen

• ONLYOFFICE Docs (Document Server) Version 6.4
• Redmine ab Version 4.0
• ONLYOFFICE Connector Plugin für Redmine

Schritt 1: Connector herunterladen

Lade zuerst das ONLYOFFICE Connector Plugin für Redmine herunter.

Du kannst das Haupt-Repository klonen:

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

Alternativ kannst du das Archiv herunterladen und entpacken:

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

$ tar -xvzf v1.0.0.tar.gz

Benenne den entpackten Ordner um:

Wenn du das Repository geklont hast:

$ mv onlyoffice-redmine onlyoffice_redmine

Oder wenn du das Archiv verwendet hast:

$ mv onlyoffice-redmine-1.0.0 onlyoffice_redmine

Schritt 2: Plugin installieren

Stelle sicher, dass Redmine während der Plugin-Installation gestoppt ist.

Kopiere den Plugin-Ordner in das Redmine-Verzeichnis für Plugins:

$ cp -r /root/onlyoffice_redmine/. /redmine/plugins/onlyoffice_redmine

Falls du dir beim Pfad unsicher bist, kannst du ihn mit folgendem Befehl finden:

$ find / -type d -name plugins

Wechsle in das Redmine-Hauptverzeichnis:

$ cd redmine

Installiere nun die benötigten Abhängigkeiten:

$ bundle install

Führe anschließend die Datenbankmigration durch:

$ RAILS_ENV=production bundle exec rake db:migrate

$ RAILS_ENV=production bundle exec rake redmine:plugins:migrate NAME=onlyoffice_redmine

Starte danach deinen Redmine-Server neu, um die Änderungen zu übernehmen.

Schritt 3: Document Server in Redmine konfigurieren

Rufe in Redmine die Administrationsoberfläche auf und konfiguriere den Document Server wie folgt:

• Wechsle zu Administration → Plugins und suche den ONLYOFFICE Redmine-Eintrag.
• Klicke auf Konfigurieren.
• Gib folgende Informationen ein:
  • Adresse des Document Editing Service: Trage die URL mit Port ein, z. B. https://documentserver:8080.
  • Geheimer Schlüssel: Aktiviere den JWT-Schutz und verwende denselben Schlüssel wie im ONLYOFFICE Document Server.
  • Optionen für die Editor-Anpassung:
    • Chat-Menüschaltfläche anzeigen
    • Feedback- & Support-Menü anzeigen
    • Kompakte Kopfzeile verwenden
    • Hilfe-Menüschaltfläche anzeigen
    • Monochrome Werkzeugleiste anzeigen
• Klicke auf Übernehmen, um die Einstellungen zu speichern.

Fazit

Die Verbindung zwischen ONLYOFFICE Docs und Redmine wurde erfolgreich eingerichtet. Du kannst ab sofort Office-Dateien direkt innerhalb von Redmine bearbeiten und gemeinsam nutzen, ohne zwischen Anwendungen wechseln zu müssen.