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

Über die ONLYOFFICE- und Nuxeo-Integration

ONLYOFFICE bietet einen offiziellen Konnektor, um ONLYOFFICE Docs mit Nuxeo zu integrieren und Office-Dokumente innerhalb des Content-Management-Systems zu bearbeiten. Sie können den ONLYOFFICE-Konnektor vom offiziellen Nuxeo Marketplace installieren oder von der GitHub-Seite herunterladen. Die Anwendung wird unter der Apache-Lizenz vertrieben.

Weitere Informationen zur Funktionalität und zum Kompilieren des ONLYOFFICE-Konnektors für Nuxeo finden Sie in unserer API-Dokumentation.

Haupteigenschaften

  • Bearbeiten von Textdokumenten, Tabellenkalkulationen und Präsentationen.
  • 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

  • Bearbeiten: DOCX, PPTX, XLSX
  • Ausfüllen von Formularen: OFORM
  • Nur Anzeigen: PDF, ODT, ODS, ODP, DOC, XLS, PPT, CSV, RTF

Verbinden von ONLYOFFICE Docs mit Nuxeo

Anforderungen

  • ONLYOFFICE Docs 5.9.4 oder höher

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

    Weitere Informationen zur Installation von ONLYOFFICE Docs finden Sie auf der offiziellen ONLYOFFICE Docs Dokumentationsseite.
  • Nuxeo LTS 2019

ONLYOFFICE-Addon für Nuxeo installieren

Sie können ONLYOFFICE mit einer registrierten Nuxeo Online Services-Instanz mit Internetzugang, einer nicht registrierten Instanz oder einer Offline-Instanz verbinden.

In der bereitgestellten Anleitung wird das nuxeoctl-Skript verwendet. Besuchen Sie die offizielle Dokumentationsseite von Nuxeo, um weitere verfügbare Optionen zum Installieren der Pakete zu finden.

Für eine bei Nuxeo Online Services registrierte Instanz mit Internetzugang folgen Sie bitte diesen Schritten:

  1. Stoppen Sie Ihren Server
    ./nuxeoctl stop
  2. Führen Sie den folgenden Befehl aus, um den Konnektor zu installieren:
    ./nuxeo/bin/nuxeoctl mp-install onlyoffice-nuxeo-x.x.x
    Dabei ist onlyoffice-nuxeo-x-x-x die neueste verfügbare Version des ONLYOFFICE-Konnektors für Nuxeo.
    Um die Konnektorversion zu erfahren,
    1. Öffnen Sie Nuxeo Marketplace auf und finden Sie den offiziellen ONLYOFFICE-Konnektor.
    2. Klicken Sie auf die Schaltfläche Install.
    3. Finden Sie die Konnektor-Version im Abschnitt For a Nuxeo Online Sevices registered instance with internet access.
  3. Nachdem das Paket heruntergeladen und installiert wurde, starten Sie Ihren Server
    ./nuxeoctl start

Führen Sie für eine nicht registrierte Instanz oder eine Offline-Instanz die folgenden Schritte aus:

  1. Stoppen Sie Ihren Server
    ./nuxeoctl stop
  2. Laden Sie den Konnektor herunter
    wget https://connect.nuxeo.com/nuxeo/site/marketplace/package/onlyoffice-nuxeo/download?version=x.x.x 
    Dabei ist version=x.x.x die neueste verfügbare Version des ONLYOFFICE-Konnektors für Nuxeo. Besuchen Sie andernfalls Nuxeo Marketplace und finden Sie den Link manuell.
  3. Installieren Sie das Paket, indem Sie den Pfad zur heruntergeladenen .zip-Datei angeben
    ./nuxeoctl mp-install /Path/to/file/onlyoffice-nuxeo-x.x.x.zip
  4. Nachdem das Paket heruntergeladen und installiert wurde, starten Sie Ihren Server
    ./nuxeoctl start

ONLYOFFICE-Addon für Nuxeo konfigurieren

Öffnen Sie die Datei nuxeo/bin/nuxeo.conf mit einem beliebigen verfügbaren Texteditor und fügen Sie die folgenden Zeilen hinzu:

onlyoffice.docserv.url=http://documentserver/
onlyoffice.jwt.secret=yoursecret

Dabei ist docserv.url die URL einer installierten und ausgeführten ONLYOFFICE Docs-Instanz und jwt.secret ist der Schlüssel zur Validierung des JSON-Webtokens bei der Anfrage an ONLYOFFICE Docs.

Weitere Informationen finden Sie im Abschnitt JWT für die ONLYOFFICE und Nuxeo-Integration aktivieren in diesem Artikel.

JWT für die ONLYOFFICE und Nuxeo-Integration aktivieren

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 der Datei nuxeo/bin/nuxeo.conf dasselbe Geheimnis in der Zeichenfolge onlyoffice.jwt.secret=yoursecret an und speichern Sie die Einstellungen.

Verwendung von ONLYOFFICE Docs in Nuxeo

Um ein Dokument zu bearbeiten oder anzuzeigen:

  1. Öffnen Sie die benötigte Datei.
  2. Klicken Sie auf die Schaltfläche View in ONLYOFFICE.

    Das Dokument wird zum Anzeigen und Bearbeiten geöffnet.

ONLYOFFICE_dateianzeigen ONLYOFFICE_dateianzeigen
Um ein Dokument gemeinsam zu bearbeiten, ist Folgendes erforderlich: Benutzer müssen über die Berechtigung zum Bearbeiten des Dokuments verfügen und das Dokumentformat muss vom Konnektor unterstützt werden.
Um mehr über Formulare zu erfahren, lesen Sie bitte die entsprechenden Artikel zum Erstellen und Ausfüllen von Formularen.

Um ein Dokument gemeinsam zu bearbeiten:

  1. Öffnen Sie die Zusammenfassungsseite des Dokuments.
  2. Klicken Sie in der unteren rechten Ecke des Fensters auf das Symbol Collaborative Edition With ONLYOFFICE.

    Das Dokument wird zur gemeinsamen Bearbeitung geöffnet.

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