Artikel zum Thema:
Schließen
Changelog
Schließen
In der cloud testen
In der cloud testen
Hilfe-Center
Integration

Über die ONLYOFFICE- und Redmine-Integration

ONLYOFFICE bietet einen offiziellen Konnektor zur Integration von ONLYOFFICE Docs mit Redmine , um an Office-Dokumenten zusammenzuarbeiten, die an die folgenden Redmine-Module angehängt sind: Issues, Files, Documents, Wiki und News. Sie können den ONLYOFFICE-Konnektor vom Redmine Marketplace oder der ONLYOFFICE GitHub-Seite herunterladen. Die Anwendung wird unter der Apache-Lizenz vertrieben.

Haupteigenschaften

  • Anzeigen und Bearbeiten von Textdokumenten, Tabellenkalkulationen und Präsentationen aus den Redmine-Modulen abhängig von den Benutzerzugriffsrechten.
  • Online-Formulare erstellen und ausfüllen.
  • Gemeinsame Bearbeitung von Dokumenten in Echtzeit: zwei Bearbeitungs-Modi (Schnell und Formal). Verfolgen Sie Änderungen und verwenden Sie Kommentare und den integrierten Chat.
  • JWT-Unterstützung, um Ihren Datenverkehr zu sichern, damit niemand mit Ausnahme der Benutzer mit den entsprechenden Rechten auf Ihre Dokumente zugreifen können.

Unterstützte Formate

  • Erstellen und bearbeiten: DOCX, DOCXF, PPTX, XLSX.
  • Formulare ausfüllen: OFORM.
  • Anzeigen: 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.

Was gibt es Neues in Version 1.0.0

Hinzugefügt

  • Die Plugin-Konfigurationsseite
  • Die Möglichkeit, docx-, xlsx- und pptx-Dateien gemeinsam zu bearbeiten
  • Die Möglichkeit, die Darstellung des Dokumenteditors anzupassen
  • Die Möglichkeit, aus dem Dokumenteditor zur Seite mit der Datei zurückzukehren
  • ONLYOFFICE-Favicons auf Browser-Tabs
  • Erkennung eines mobilen Browsers

Das vollständige Änderungsprotokoll ist hier.

Verbinden von ONLYOFFICE Docs mit Redmine

Anforderungen

  • ONLYOFFICE Docs Version 6.4 und höher

    Sie benötigen eine Instanz von ONLYOFFICE Docs, die sowohl von Redmine als auch von beliebigen End-Clients auflösbar und verbindbar ist. Die Instanz muss direkt an Redmine POSTen können.

    Weitere Informationen zur Installation von ONLYOFFICE Docs finden Sie auf der offiziellen Dokumentationsseite.
  • Redmine v4.0.0. Wenn Sie Redmine noch nicht kennen, installieren Sie es gemäß dieser Anleitung.
  • ONLYOFFICE-Konnektor v1.0.0 für Redmine

Installieren des ONLYOFFICE-Konnektors für Redmine

  1. Laden Sie das ONLYOFFICE-Integrations-Plugin für Redmine herunter. Dafür gibt es mehrere Möglichkeiten:
    1. Laden Sie die neueste archivierte Version vom Redmine Marketplace herunter.
    2. Laden Sie die neueste archivierte Version von der ONLYOFFICE GitHub-Seite herunter:
      wget https://github.com/ONLYOFFICE/onlyoffice-redmine/archive/refs/tags/v1.0.0.tar.gz

      Entpacken Sie das Archiv:

      tar -xvzf v1.0.0.tar.gz
    3. Klonen Sie den Master-Branch:
      git clone https://github.com/ONLYOFFICE/onlyoffice-redmine
    Das Plugin-Unterverzeichnis muss als onlyoffice_redmine benannt werden. Benennen Sie den geklonten onlyoffice-redmine Ordner oder den entpackten onlyoffice_redmine-x.y.z Ordner in onlyoffice_redmine um.
    mv onlyoffice-redmine onlyoffice_redmine
                                         mv onlyoffice-redmine-1.0.0 onlyoffice_redmine

    Stellen Sie vor der Installation des Plugins sicher, dass die Redmine-Instanz gestoppt ist.

  2. Legen Sie das Plugin-Verzeichnis onlyoffice_redmine in das Verzeichnis plugins ab, z.B.:
    cp -r /root/onlyoffice_redmine/. /redmine/plugins/onlyoffice_redmine
    Der Pfad zum Verzeichnis plugins kann sich je nach Ihren Redmine-Installationsoptionen unterscheiden. Sie können den Befehl find / -type d -name plugins verwenden, um den Pfad zu finden.
  3. Gehen Sie zum Stammverzeichnis von Redmine:
    cd redmine
  4. Installieren Sie die Abhängigkeiten:
    bundle install
  5. Initialisieren/aktualisieren Sie die Datenbank:
    RAILS_ENV=production bundle exec rake db:migrate
    RAILS_ENV=production bundle exec rake redmine:plugins:migrate NAME=onlyoffice_redmine
  6. Starten Sie die Redmine-Instanz neu.

Konfigurieren des ONLYOFFICE-Konnektors für Redmine

Gehen Sie zur Konsole Administration -> Plugins, suchen Sie das ONLYOFFICE-Integrations-Plugin für Redmine und klicken Sie auf Configure. Geben Sie die folgenden Parameter an:

  • Document Editing Service address: Geben Sie die URL-Adresse und den Port an, unter denen ONLYOFFICE Docs installiert ist (z.B. https://documentserver:8080). Dieses Feld ist obligatorisch.
  • Secret key: Geben Sie den Schlüssel an, der zum Signieren der Daten verwendet wird. Weitere Informationen finden Sie im Abschnitt Aktivieren von JWT für die ONLYOFFICE- und Redmine-Integration in diesem Artikel.
  • Markieren Sie bei Bedarf die folgenden Anpassungseinstellungen:
    • Die Menüschaltfläche Chat anzeigen.
    • Die Kopfzeile kompakter anzeigen.
    • Die Menüschaltfläche Feedback & Support anzeigen.
    • Die Menüschaltfläche Help anzeigen.
    • Die monochrome Kopfzeile der Symbolleiste anzeigen.

Klicken Sie unten auf die Schaltfläche Apply, um die Änderungen zu speichern.

ONLYOFFICE_konfigurieren ONLYOFFICE_konfigurieren

Aktivieren von JWT für die ONLYOFFICE- und Redmine-Integration

Um Dokumente vor unbefugtem Zugriff zu schützen, verwenden ONLYOFFICE-Editoren das JSON Web Token (JWT). Das Token wird in der Konfiguration hinzugefügt, wenn der Dokumenteneditor initialisiert wird und während des Austauschs von Befehlen zwischen internen ONLYOFFICE Docs-Diensten. Der geheime Schlüssel wird verwendet, um das JSON-Web-Token zu signieren und das Token auf Anfrage an ONLYOFFICE Docs zu validieren.

Um Ihre Dokumente zu schützen, müssen Sie die Token-Validierung aktivieren und Ihren eigenen geheimen Schlüssel in der ONLYOFFICE Docs-Konfigurationsdatei angeben und dann denselben geheimen Schlüssel in den Konnektor-Einstellungen angeben.

Schritt 1: ONLYOFFICE Docs konfigurieren

  1. Öffnen Sie die Datei local.json mit einem beliebigen verfügbaren Texteditor.
    • Für Linux - /etc/onlyoffice/documentserver/local.json
    • Für Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
    • Für Docker – öffnen Sie den ONLYOFFICE Docs-Container mit dem Befehl docker exec -it <containerID> bash und öffnen Sie /etc/onlyoffice/documentserver/local.json
  2. Aktivieren Sie die Token-Validierung, indem Sie den Wert false in drei Abschnitten in true ändern:
    • services.CoAuthoring.token.enable.browser
    • services.CoAuthoring.token.enable.request.inbox
    • services.CoAuthoring.token.enable.request.outbox
  3. Geben Sie Ihren eigenen geheimen Schlüssel an, indem Sie den geheimen Wert in drei Abschnitten durch Ihre eigene Textzeichenfolge ersetzen. Der geheime Schlüssel muss derselbe sein.
    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string
    {
      "services": {
        "CoAuthoring": {
          "token": {
            "enable": {
              "request": {
                "inbox": true,
                "outbox": true
              },
              "browser": true
            }
          },
          "secret": {
            "inbox": {
              "string": "yoursecret"
            },
            "outbox": {
              "string": "yoursecret"
            },
            "session": {
              "string": "yoursecret"
            }
          }
        }
      }
    }
    
  4. Speichern Sie Ihre Änderungen.
  5. Starten Sie die Dienste neu, damit die Konfigurationsänderungen aktualisiert werden.
    supervisorctl restart all

Schritt 2: Denselben geheimen Schlüssel in den Konnektor-Einstellungen angeben

Geben Sie in den Konnektor-Einstellungen dasselbe Geheimnis im Feld Secret Key an und speichern Sie die Einstellungen.

Verwendung von ONLYOFFICE Docs in Redmine

Alle Dateiänderungen werden in der Originaldatei gespeichert.

Berechtigungen ändern

Bitte beachten Sie, dass verfügbare Dateiaktionen (Anzeigen oder Bearbeiten) für jedes einzelne Modul von den Berechtigungen der Benutzerrolle abhängen.

Gehen Sie zu Administration -> Roles and permissions, wählen Sie die erforderliche Rolle in der Liste aus, aktivieren/deaktivieren Sie die erforderlichen Berechtigungen und klicken Sie auf Save.

Weitere Informationen finden Sie in der offiziellen Redmine-Dokumentation.

Anzeigen und Bearbeiten von Dateien

Modul Issues

Um die an Probleme angehängten Dateien oder Kommentare im entsprechenden Editor zu öffnen, klicken Sie rechts neben dem Dateinamen auf die Schaltfläche ONLYOFFICE Symbol Edit in ONLYOFFICE / Open in ONLYOFFICE.

Die Möglichkeit, Dokumente zu bearbeiten, ist für Benutzerrollen mit der Berechtigung Edit issues verfügbar.

Die Möglichkeit, Dateien zum Anzeigen zu öffnen, ist für Benutzerrollen mit der Berechtigung View issues verfügbar.

Modul Issues Modul Issues
Modul Files

Dateien stehen nur und ausschließlich Benutzern mit den Berechtigungen View files oder Manage files zum Anzeigen zur Verfügung. Um eine Datei im entsprechenden Editor zu öffnen, klicken Sie rechts neben dem Dateinamen auf die Schaltfläche ONLYOFFICE Symbol Open in ONLYOFFICE.

Modul Files Modul Files
Modul Documents

Um Dateien im entsprechenden Editor zu öffnen, klicken Sie rechts neben dem Dateinamen auf die Schaltfläche ONLYOFFICE Symbol Edit in ONLYOFFICE / Open in ONLYOFFICE.

Die Möglichkeit, Dokumente zu bearbeiten, ist für Benutzerrollen mit der Berechtigung Edit documents verfügbar.

Die Möglichkeit, Dateien zum Anzeigen zu öffnen, ist für Benutzerrollen mit der Berechtigung View documents verfügbar.

Modul Documents Modul Documents

Um ein Formular zu erstellen, klicken Sie auf den Link Create in ONLYOFFICE und wählen Sie die Option Form Template aus.

create a form create a form

Füllen Sie die erforderlichen Felder aus und klicken Sie auf Create.

Um mehr über Formulare zu erfahren, lesen Sie bitte die entsprechenden Artikel zum Erstellen und Ausfüllen von Formularen.
Modul Wiki

Um Dateien im entsprechenden Editor zu öffnen, klicken Sie rechts neben dem Dateinamen auf die Schaltfläche ONLYOFFICE Symbol Edit in ONLYOFFICE / Open in ONLYOFFICE.

Die Möglichkeit, Dokumente zu bearbeiten, ist für Benutzerrollen mit der Berechtigung Edit Wiki pages verfügbar.

Die Möglichkeit, Dateien zum Anzeigen zu öffnen, ist für Benutzerrollen mit der Berechtigung View Wiki verfügbar.

Modul Wiki Modul Wiki
Modul News

Um Dateien im entsprechenden Editor zu öffnen, klicken Sie rechts neben dem Dateinamen auf die Schaltfläche ONLYOFFICE Symbol Edit in ONLYOFFICE / Open in ONLYOFFICE.

Die Möglichkeit, Dokumente zu bearbeiten, ist für Benutzerrollen mit der Berechtigung Edit news verfügbar.

Die Möglichkeit, Dateien zum Anzeigen zu öffnen, ist für Benutzerrollen mit der Berechtigung View news verfügbar.

Modul News Modul News
Herunterladen Beste Editoren auf Ihrer Webseite Lassen Sie Ihre Seite-Benutzer alle Arten von Text-, Tabellenkalkulations- und Präsentationsdateien
öffnen und gemeinsam bearbeiten
Wer sich dafür interessiert hat,
hat auch das Folgende gelesen:
Schließen