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

Über die ONLYOFFICE- und Liferay-Integration

ONLYOFFICE bietet einen offiziellen Konnektor, um ONLYOFFICE Docs mit Liferay zu integrieren und Office-Dokumente in der Liferay Document and Media Library zu bearbeiten. Sie können den ONLYOFFICE-Konnektor vom Liferay Marketplace oder von der GitHub-Seite herunterladen. Der Konnektor wird unter der Apache-Lizenz vertrieben.

Weitere Informationen zur Funktionalität des ONLYOFFICE-Konnektors für Liferay finden Sie auf unserer API-Dokumentationsseite.

Haupteigenschaften

  • Erstellen von Dateien mit der Menüoption Create with ONLYOFFICE.
  • Erstellen und Ausfüllen von Online-Formularen.
  • Anzeigen und Bearbeiten vorhandener Textdokumente, Tabellen oder Präsentationen mit der Menüoption ONLYOFFICE Edit/View im Abschnitt Documents and Media.
  • 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, Bearbeiten und Anzeigen: DOCX, PPTX, XLSX, DOCXF
  • Ausfüllen von Formularen: OFORM
  • Konvertieren in Office Open XML: ODT, DOC, RTF, TXT, ODP, PPT, ODS, XLS, CSV
  • Nur Anzeigen: PDF

Was gibt es Neues in Version 2.1.0

Hinzugefügt

  • Unterstützung für .docxf- und .oform-Formate
  • Die Option zum Erstellen einer leeren .docxf aus dem Dateierstellungsmenü
  • Die Option zum Erstellen einer .oform-Datei aus einer .docxf-Datei mit dem Dokumentenmanager
  • Aktualisiertes Menü: "Speichern als..." im Editor
  • DE, ES, FR, IT, PT_BR, RU Übersetzungen

Das vollständige Änderungsprotokoll ist hier verfügbar.

Verbinden von ONLYOFFICE Docs mit Liferay

Anforderungen

  • ONLYOFFICE Docs (Document Server) 6.0 oder höher

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

    Weitere Informationen zur Installation von ONLYOFFICE Docs finden Sie auf der offiziellen Dokumentationsseite.
  • Liferay CE Portal 7.2 GA1+, Liferay DXP 7.2 GA1+, Liferay CE Portal 7.3 GA1+, Liferay DXP 7.3 GA1+, Liferay CE Portal 7.4 GA1+
  • ONLYOFFICE-Konnektor v2.0.0 für Liferay

Installieren des ONLYOFFICE-Konnektors für Liferay

Sie können den ONLYOFFICE-Konnektor mit dem App Manager oder aus dem offiziellen Liferay App Store installieren.

Um den Konnektor durch den App Manager zu installieren,

  1. Gehen Sie zu Control Panel -> Apps -> App Manager.
  2. Klicken Sie auf die Schaltfläche Liferay Optionen Symbol Options.
  3. Klicken Sie auf die Schaltfläche Upload.
  4. Wählen Sie im geöffneten Fenster die Anwendungsdatei ONLYOFFICE.

Um das Konnektor aus dem App Store zu installieren,

  1. Gehen Sie zu Control Panel -> Apps -> Store.
  2. Melden Sie sich mit Ihrem Liferay-Konto an.
  3. Finden Sie den ONLYOFFICE-Konnektor für Liferay.
  4. Kaufen Sie die Anwendung (kostenlos).

Nach Abschluss der Installation ist die Anwendung einsatzbereit.

Konfigurieren der Liferay- und ONLYOFFICE-Integrationsanwendung

Gehen Sie zu Control Panel -> Configuration -> System Settings. Wählen Sie im Abschnitt Platform die Kategorie Connectors und dann ONLYOFFICE aus.

ONLYOFFICE_konfigurieren ONLYOFFICE_konfigurieren

Hier können Sie die folgenden Einstellungen konfigurieren:

  • ONLYOFFICE Docs address: Geben Sie die URL-Adresse an, unter der der Dokumentbearbeitungsdienst installiert ist.
  • ONLYOFFICE Docs address for internal requests from the server: Geben Sie die Adresse an, die für den Zugriff auf den Document Editing Service von Liferay verwendet wird.
  • Server address for internal requests from ONLYOFFICE Docs: Geben Sie die Adresse an, die für den Zugriff auf Liferay vom Document Editing Service verwendet wird.
  • Secret key: Geben Sie den Schlüssel an, der zum Signieren der Daten verwendet wird. Weitere Information finden Sie im Abschnitt Aktivieren von JWT für die ONLYOFFICE- und Liferay-Integration in diesem Artikel.

Klicken Sie nach der Konfiguration der Integrationsanwendung auf die Schaltfläche Save, um die Änderungen zu übernehmen.

Aktivieren von JWT für die ONLYOFFICE- und Liferay-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 Liferay

Um eine Datei zu erstellen:

  1. Gehen Sie zum Abschnitt Documents and Media.
  2. Klicken Sie auf die Schaltfläche Liferay Erstellen Symbol Add File.
  3. Klicken Sie im geöffneten Menü auf die Schaltfläche Create with ONLYOFFICE.
    ONLYOFFICE_erstellen ONLYOFFICE_erstellen
  4. Wählen Sie auf der geöffneten Seite den Dateityp, geben Sie den Titel und die Beschreibung (optional) an.
  5. Klicken Sie auf die Schaltfläche Save.
ONLYOFFICE_erstellen2 ONLYOFFICE_erstellen2

Um eine Datei zu bearbeiten:

  1. Finden Sie die erforderliche Datei im Abschnitt Documents and Media.
  2. Klicken Sie auf das Dokument.
  3. Klicken Sie im geöffneten Menü auf die Schaltfläche Edit in ONLYOFFFICE.
ONLYOFFICE_bearbeiten ONLYOFFICE_bearbeiten

Um ein Formular zu erstellen:

  1. Öffnen Sie den Abschnitt Documents and Media.
  2. Klicken Sie auf die Schaltfläche Liferay create icon Add File.
  3. Klicken Sie im geöffneten Menü auf die Schaltfläche Create with ONLYOFFICE.
  4. Wählen Sie auf der geöffneten Seite die Option Form und geben Sie den Titel und die Beschreibung der Datei (optional) an.
    ONLYOFFICE_createform ONLYOFFICE_createform
  5. Klicken Sie auf die Schaltfläche Save.
  6. Speichern Sie das Formular als .docxf, um in Zukunft Zugriff zum Bearbeiten, Überarbeiten oder Zusammenarbeiten zu haben.

Um ein ausfüllbares Formular zu erstellen und die Dateibearbeitung durch andere Benutzer zu beschränken:

  1. Klicken Sie auf das Symbol More rechts neben der .docxf-Datei.
  2. Wählen Sie die Option Create form using ONLYOFFICE.
    ONLYOFFICE_createoform ONLYOFFICE_createoform

Um ein Formular auszufüllen:

  1. Klicken Sie auf das Symbol More rechts neben der .docxf-Datei.
  2. Wählen Sie die Option Fill form in ONLYOFFICE.
    ONLYOFFICE_fillform ONLYOFFICE_fillform
Um mehr über Formulare zu erfahren, lesen Sie bitte die entsprechenden Artikel zum Erstellen und Ausfüllen von Formularen.
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