Confluence

Über die ONLYOFFICE- und Confluence-Integration

ONLYOFFICE bietet einen offiziellen Konnektor, um ONLYOFFICE Docs mit Confluence zu integrieren und Office-Dokumente innerhalb der Dokumentbibliothek zu bearbeiten. Sie können den ONLYOFFICE-Konnektor über den Atlassian Marketplace installieren oder laden Sie es von der GitHub-Seite herunter. Die Anwendung wird unter der Apache-Lizenz vertrieben.

Weitere Informationen zur Funktionsweise und zur Kompilierung des ONLYOFFICE-Konnektors für Confluence finden Sie in unserer API-Dokumentation.
Haupteigenschaften
  • Erstellen von Textdokumenten, Tabellenkalkulationen und Präsentationen mit der Option New document.
  • Erstellen und Ausfüllen von Online-Formularen.
  • Bearbeiten und Anzeigen von Dokumenten mit der Option Edit in ONLYOFFICE.
    Confluence Cloud unterstützt das Hochladen und Bearbeiten von Dateien.
  • 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: DOCX, XLSX, PPTX, DOCXF
  • Bearbeiten und Anzeigen: DOCM, DOCX, DOCXF, DOTM, DOTX, HTM, POTM, POTX, PPSM, PPSX, PPTM, PPTX, XLSM, XLSX, XLTM, XLTX, XML
  • Zur Bearbeitung mit möglichem Informationsverlust: CSV, EPUB, FB2, HTML, ODP, ODS, ODT, OTP, OTS, OTT, RTF, TXT
  • Zum Ausfüllen von Formularen: OFORM
    Confluence Cloud unterstützt die Formate .oform und .docxf nicht.
  • Zur Konvertierung in Office Open XML: DOC, DOCM, DOCXF, DOT, DOTM, DOTX, EPUB, FB2, FODP, FODS, FODT, HTM, HTML, MHT, ODP, ODS, ODT, OTP, OTS, OTT, OXPS, PDF, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, RTF, XLS, XLSM, XLT, XLTM, XLTX, XML, XPS
    Confluence Cloud unterstützt keine Konvertierung. Alle diese Formate werden nur zur Anzeige unterstützt.
  • Nur Anzeigen: CSV, DJVU, DOC, DOCM, DOCX, DOCXF, DOT, DOTM, DOTX, EPUB, FB2, FODP, FODS, FODT, HTM, HTML, MHT, ODP, ODS, ODT, OFORM, OTP, OTS, OTT, OXPS, PDF, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX, RTF, TXT, XLS, XLSM, XLSX, XLT, XLTM, XLTX, XML, XPS
Was gibt es Neues in Version 4.3.1

Hinzugefügt

  • Kompatibilität mit Confluence 8.4.0.
  • Kompatibilität mit den Formaten .oform und .docxf.
  • Document Server v6.4 und früher wird nicht mehr unterstützt.
  • Dokumentvorschau.
  • Dateien aus dem Speicher herunterladen.
  • Spezielles Einfügen in der Tabellenkalkulation. Bitte lesen Sie den Abschnitt "Inhalte einfügen mit Optionen" in diesem Artikel, um mehr darüber zu erfahren.
  • Neue unterstützte Formate.
  • Interne Verbesserungen für die JWT-Signatur.
  • Aktualisierung der Schwachstellenabhängigkeit.

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

Verbinden von ONLYOFFICE Docs mit Confluence

Anforderungen
  • ONLYOFFICE Document Server V. 7.0 (die Server- oder Cloud-Lösung) oder höher

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

    Weitere Informationen zur Installation von ONLYOFFICE Docs finden Sie auf der offiziellen Dokumentationsseite.
  • Confluence Data Center 7.12.0 - 8.6.0 oder Confluence Server 7.12.0 - 8.6.0
  • ONLYOFFICE Konnektor für Confluence
Installieren des ONLYOFFICE-Konnektors für Confluence vom Atlassian Marketplace

Sie können die neueste Konnektor-Version vom offiziellen Atlassian Marketplace herunterladen. Dies geschieht auf folgende Weise:

  1. Melden Sie sich als Administrator bei Ihrer Confluence-Instanz an.
  2. Klicken Sie auf das Drop-Down-Feld für Administratoren und wählen Sie Manage apps (Apps verwalten) aus. Das Fenster Manage apps (Apps verwalten) wird geladen.
  3. Klicken Sie links auf der Seite auf Find new apps (Neue Apps finden).
  4. Finden Sie den ONLYOFFICE Connector for Confluence über das Suchfeld. Die Ergebnisse enthalten die Add-On-Versionen, die mit Ihrer Confluence-Instanz kompatibel sind.
  5. Klicken Sie auf Install (Installieren), um Ihre Anwendung herunterzuladen und zu installieren.
ONLYOFFICE_confluence_installierenONLYOFFICE_confluence_installieren
ONLYOFFICE-Konnektor für Confluence konfigurieren

Öffnen Sie Confluence administration (Confluence Verwaltung) -> Manage apps (Apps verwalten) -> ONLYOFFICE Connector for Confluence -> Configure (Konfigurieren):

  • Document Server: Geben Sie die URL-Adresse ein, auf der der Document Editing Server installiert ist (z. B. https://documentserver).
    WichtigDie Adresse von ONLYOFFICE Docs muss von Confluence aus zugänglich sein, und die Adresse von Confluence muss von ONLYOFFICE Docs aus zugänglich sein.
  • Secret key (Geheimer Schlüssel): Geben Sie den Schlüssel an, der zum Signieren der Daten verwendet wird.
    Ab ONLYOFFICE Docs v7.2 ist JWT standardmäßig aktiviert und der geheime Schlüssel wird automatisch generiert. Sie müssen es auch auf der Confluence-Seite aktivieren: Suchen Sie Ihren geheimen Schlüssel in der Konfigurationsdatei von ONLYOFFICE Docs und geben Sie dann denselben geheimen Schlüssel in den Konnektor-Einstellungen an. Weitere Einzelheiten finden Sie im Abschnitt JWT für die ONLYOFFICE- und Confluence-Integration aktivieren dieses Artikels.

Erweiterte Servereinstellungen:

  • Server address for internal requests from the Document Editing Service (Serveradresse für interne Anfragen vom Dokumentenbearbeitungsdienst): Adresse, die für den Zugriff auf den Confluence-Server vom Document Editing Service verwendet wird.
  • Document Editing Service address for internal requests from the server (Adresse des Dokumentbearbeitungsdienstes für interne Anfragen vom Server): Adresse, die für den Zugriff auf den Document Editing Service vom Confluence-Server verwendet wird.
    Confluence Cloud unterstützt die Konfiguration erweiterter Einstellungen nicht.
ONLYOFFICE_confluence_konfigurierenONLYOFFICE_confluence_konfigurieren
JWT für die ONLYOFFICE- und Confluence-Integration aktivieren

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

Ab ONLYOFFICE Docs v7.2 ist JWT standardmäßig aktiviert und der geheime Schlüssel wird automatisch generiert. Sie müssen Ihren geheimen Schlüssel in der Konfigurationsdatei von ONLYOFFICE Docs finden 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

      Sie können auch den folgenden Befehl verwenden, um den geheimen Standardschlüssel zu finden, ohne local.json zu öffnen:

      sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

    Die Datei local.json sollte so aussehen:

    {"services": {"CoAuthoring": {"token": {"enable": {"request": {"inbox": true,"outbox": true},"browser": true}},"secret": {"inbox": {"string": "yoursecret"},"outbox": {"string": "yoursecret"},"session": {"string": "yoursecret"}}}}}
  2. Der true-Wert wird in drei Abschnitten angegeben. Dies bedeutet, dass die Token-Validierung aktiviert ist.
    • services.CoAuthoring.token.enable.browser
    • services.CoAuthoring.token.enable.request.inbox
    • services.CoAuthoring.token.enable.request.outbox
  3. Der automatisch generierte geheime Schlüssel wird in drei Abschnitten angegeben. Sie können den standardmäßigen Geheimwert durch Ihren eigenen Geheimschlüssel ersetzen. Der geheime Schlüssel muss in drei Abschnitten gleich sein.
    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string
  4. Wenn Sie Änderungen vornehmen, speichern Sie diese und starten Sie die Dienste neu, damit die Konfigurationsänderungen aktualisiert werden.
    supervisorctl restart all

Schritt 2: In den Konnektor-Einstellungen denselben geheimen Schlüssel angeben

Geben Sie in den Konnektor-Einstellungen dasselbe Geheimnis im Feld Geheimer Schlüssel an und speichern Sie die Einstellungen.

Verbinden mit der Demo ONLYOFFICE Docs
Confluence Cloud unterstützt keine Verbindung zum Demoserver.

Wenn Sie die ONLYOFFICE Online-Editoren in Confluence testen möchten, ohne ONLYOFFICE Docs zu installieren:

  1. Gehen Sie zu Confluence administration (Confluence-Verwaltung) -> Manage apps (Apps verwalten) -> ONLYOFFICE Connector for Confluence -> Configure (Konfigurieren).
  2. Aktivieren Sie das Kontrollkästchen Connect to demo ONLYOFFICE Document Server (Verbindung zur Demoversion von ONLYOFFICE Document Server herstellen).
  3. Klicken Sie auf die Schaltfläche Save (Speichern).
WichtigDies ist ein öffentlicher Testserver, der während eines Zeitraums von 30 Tagen verfügbar sein wird. Geben Sie dort Ihre sensiblen Daten nicht weiter.

Verwendung von ONLYOFFICE Docs in Confluence

Um eine Datei zu erstellen:

  1. Öffnen Sie die Seite, auf der Sie eine Datei erstellen möchten.
  2. Klicken Sie auf die Schaltfläche New document (Neues Dokument).
  3. Wählen Sie den benötigten Dateityp.
  4. Geben Sie den Dateinamen in das Textfeld neben dem Dateitypsymbol ein.
  5. Klicken Sie auf die Schaltfläche Confluence Datei speichern SymbolSave (Speichern).

Das Dokument wird im ONLYOFFICE Docs-Editor geöffnet.

ONLYOFFICE_confluence_neue_DateiONLYOFFICE_confluence_neue_Datei

Um eine Dateivorschau zu erstellen:

  1. Öffnen Sie eine beliebige Confluence-Seite zur Bearbeitung.
  2. Klicken Sie auf die Option Insert more content (Weiteren Inhalt einfügen).
  3. Wählen Sie die Option Other macros (Andere Makros).
  4. Wählen Sie die Option ONLYOFFICE Preview (ONLYOFFICE-Vorschau).
  5. Wählen Sie auf der Seite Attachments (Anhänge) die gewünschte Datei aus.
  6. Passen Sie bei Bedarf die Breite und Höhe der Dateivorschau an.
  7. Klicken Sie auf die Schaltfläche Insert (Einfügen).
ONLYOFFICE_confluence_datei_vorschauONLYOFFICE_confluence_datei_vorschau

Um eine Datei herunterzuladen:

  1. Öffnen Sie das Dateikontextmenü, indem Sie auf den Pfeil links neben dem Namen klicken.
  2. Klicken Sie auf die Schaltfläche Download as (Herunterladen als). Das Fenster Download as with ONLYOFFICE (Herunterladen als mit ONLYOFFICE) wird geöffnet.
  3. Bearbeiten Sie bei Bedarf den File Name (Dateinamen) im entsprechenden Feld.
  4. Öffnen Sie das Dropdown-Menü Target type (Zieltyp) und wählen Sie das erforderliche Format aus.
  5. Klicken Sie auf die Schaltfläche Herunterladen.
ONLYOFFICE_confluence_datei_herunterladenONLYOFFICE_confluence_datei_herunterladen

Um eine Datei zu bearbeiten oder anzuzeigen:

  1. Suchen Sie die benötigte Datei.
  2. Klicken Sie auf die Schaltfläche Edit in ONLYOFFICE (In ONLYOFFICE bearbeiten).

Das Dokument wird im ONLYOFFICE-Editor geöffnet.

Um ein Dokument gemeinsam zu bearbeiten, sollten die autorisierten Benutzer dieselbe Datei gemeinsam öffnen.

ONLYOFFICE_confluence_Datei_bearbeitenONLYOFFICE_confluence_Datei_bearbeiten

Um ein Formular zu erstellen:

  1. Öffnen Sie die Seite, auf der Sie eine Datei erstellen müssen.
  2. Klicken Sie auf die Schaltfläche New document (Neues Dokument) und wählen Sie die Option Form (Formular) aus.
    ONLYOFFICE_neue_FormONLYOFFICE_neue_Form
  3. Geben Sie den Dateinamen in das Textfeld neben dem Dateitypsymbol ein.
  4. Wählen Sie die .docx-Datei aus, die an diese oder andere Seiten angehängt ist, oder wählen Sie die Option Create from blank (Aus leerere Datei erstellen).
  5. Das Formular wird im ONLYOFFICE Docs-Editor geöffnet.
  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 einzuschränken:

  1. Öffnen Sie Attachments (Anhänge).
  2. Klicken Sie auf den Link Create form using ONLYOFFICE (Formular mit ONLYOFFICE erstellen) rechts neben der .docxf-Datei. Die .oform-Datei wird im Abschnitt Attachments (Anhänge) erstellt.
    ONLYOFFICE_Formular_erstellenONLYOFFICE_Formular_erstellen

Um ein Formular auszufüllen:

  1. Öffnen Sie Attachments (Anhänge).
  2. Klicken Sie auf den Link Fill form in ONLYOFFICE (Formular in ONLYOFFICE ausfüllen) rechts neber der .oform-Datei.
    ONLYOFFICE_Formular_ausfüllenONLYOFFICE_Formular_ausfüllen
  3. Das Formular wird im ONLYOFFICE Docs-Editor geöffnet.
Um mehr über Formulare zu erfahren, lesen Sie bitte die entsprechenden Artikel zum Erstellen und Ausfüllen von Formularen.

Video anschauen

Wie verbindet man ONLYOFFICE Docs mit Confluence

Hosten ONLYOFFICE Docs auf Ihrem eigenen Server oder nutzen Sie es in der Cloud

Artikel zum Thema:
Alle Schlagwörter