Integration. Erste Schritte. Jira

Hilfe-Center

Integration

So integrieren Sie ONLYOFFICE mit Nextcloud

Über die ONLYOFFICE- und Jira-Integration

ONLYOFFICE bietet einen offiziellen Konnektor zur Integration von ONLYOFFICE Docs mit Jira Software, um an Office-Dokumenten zusammenzuarbeiten, die an Ihre Jira-Probleme angehängt sind. Sie können es vom offiziellen Atlassian Marketplace oder GitHub herunterladen. Die Anwendung wird unter der Apache-Lizenz vertrieben.

Um mehr darüber zu erfahren, wie es funktioniert, besuchen Sie bitte unsere API-Dokumentation.

Haupteigenschaften

Anzeigen und Bearbeiten von Textdokumenten, Tabellenkalkulationen, Präsentationen und Formularen mit der Option Edit in ONLYOFFICE.
Um mehr über Formulare zu erfahren, lesen Sie bitte die entsprechenden Artikel zum Erstellen und Ausfüllen von Formularen.
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, sodass niemand außer den Benutzern mit den entsprechenden Zugriffsberechtigungen auf Ihre Dokumente zugreifen kann.

Unterstützte Formate

Erstellen, Bearbeiten und Anzeigen: DOCX, PPTX, XLSX
Ausfüllen von Formularen: OFORM
Nur Anzeigen: DOC, DOCM, DOC, DOTX, DOTM, ODT, FODT, OTT, RTF, TXT, HTML, HTM, MHT, PDF, DJVU, FB2, EPUB, XPS, XLS, XLSM, XLTZ , XLTX, XLTM, ODS, FODS, OTS, CSV, PPS, PPSX, PPSM, PPT, PPTM, POT, POTX, POTM, ODP, FODP, OTP

Verbinden von ONLYOFFICE Docs mit Jira

Anforderungen

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

Bitte besuchen Sie die offizielle Dokumentationsseite von ONLYOFFICE Docs, um mehr über die Installation von ONLYOFFICE Docs zu erfahren.
Jira Software (Server oder Daten-Center) V. 7.13.0 - 8.19.0
Bitte lesen Sie die offizielle Atlassian-Dokumentation, um mehr über die Installation von Jira Software zu erfahren.

ONLYOFFICE-Konnektor für Jira installieren

Sie können den Konnektor vom offiziellen Atlassian Marketplace herunterladen oder aus den auf GitHub verfügbaren Quellcodes kompilieren.

Konnektor vom Atlassian Marketplace hinzufügen

Melden Sie sich als Administrator bei Ihrer Jira Software-Instanz an.
Klicken Sie oben rechts auf das Verwaltungssymbol und wählen Sie die Option Manage apps aus dem Menü.
Der Abschnitt Find new apps wird geöffnet. Klicken Sie auf das Feld Search the Marketplace und finden Sie die Jira ONLYOFFICE integration app.
Klicken Sie auf die Schaltfläche Install, um die Anwendung herunterzuladen und zu installieren.

Hinzufügen des aus dem Quellcode kompilierten Konnektors

Um den ONLYOFFICE-Konnektor für Jira kompilieren zu können, müssen Sie zunächst folgende Voraussetzungen installieren:

Um den ONLYOFFICE-Konnektor für Jira zu kompilieren, gehen Sie folgendermaßen vor:

Klonen Sie das onlyoffice-jira Repository.

git clone https://github.com/ONLYOFFICE/onlyoffice-jira.git

Öffnen Sie das Verzeichnis onlyoffice-jira.
```
cd onlyoffice-jira
```
Führen Sie den folgenden Befehl aus:
```
atlas-package
```
Warten Sie, während der Konnektor kompiliert wird. Danach befindet sich der Konnektor im Ordner target.

Sie können den kompilierten Konnektor auf Ihrer Seite Jira Software Administration -> Manage Apps hochladen.

Melden Sie sich als Administrator bei Ihrer Jira Software-Instanz an.
Klicken Sie oben rechts auf das Verwaltungssymbol und wählen Sie die Option Manage apps aus dem Menü.
Wählen Sie links auf der Seite den Abschnitt Manage apps aus.
Klicken Sie auf den Link Upload app.
Klicken Sie auf die Schaltfläche Choose File, suchen Sie nach der kompilierten Datei target/onlyoffice-jira-app.jar und klicken Sie auf Upload. Warten Sie, während die Anwendung installiert wird.

Konfigurieren des ONLYOFFICE-Konnektors für Jira

Klicken Sie auf die Schaltfläche Configure unter der installierten Jira ONLYOFFICE integration app auf der Seite Manage apps oder finden Sie die App im Abschnitt OTHER der Seite Manage apps.

Geben Sie im Adressfeld Document Editing Service address die IP-Adresse oder den Hostnamen des Servers an, auf dem ONLYOFFICE Docs installiert ist.

Sie können auch einen geheimen Schlüssel angeben, der zum Validieren des JSON-Webtoken bei der Anfrage an ONLYOFFICE Docs verwendet wird. Weitere Information finden Sie im Abschnitt Aktivieren von JWT für die ONLYOFFICE- und Jira-Integration in diesem Artikel.

Der Abschnitt Advanced server settings kann verwendet werden, wenn Ihre Netzwerkkonfiguration keine Anfragen zwischen der installierten Jira Software und ONLYOFFICE Docs über die öffentlichen Adressen zulässt. Geben Sie in diesem Fall Adressen für interne Anfragen in die entsprechenden Felder ein:

Jira Software Serveradresse für interne Anfragen von ONLYOFFICE Docs.
ONLYOFFICE Docs-Adresse für interne Anfragen vom Jira Software-Server.

Klicken Sie auf Save, um die Einstellungen zu speichern.

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

Ö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
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

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"
        }
      }
    }
  }
}

Speichern Sie Ihre Änderungen.
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 Jira

Dateien anzeigen und bearbeiten

Sie können die ONLYOFFICE-Editoren aus jedem Abschnitt Attachments einer Ausgabe öffnen. Diese Option ist für Probleme aus jedem Modul verfügbar, in dem ein Problem geöffnet werden kann, z. B. Probleme-Liste, Backlog, Probleme usw.

Anhänge müssen vom Administrator aktiviert werden.

Auf der Problemseite kann mit der Option More -> Attach files ein neuer Anhang hinzugefügt werden. Weitere Informationen finden Sie in der offiziellen Dokumentation.

Um ein Textdokument, eine Tabelle, eine Präsentation oder ein Formular zu öffnen, bewegen Sie den Mauszeiger über die gewünschte Datei und klicken Sie auf das Symbol ONLYOFFICE_Konnektor Edit in ONLYOFFICE.

Die Datei wird in einem neuen Browser-Tab im entsprechenden ONLYOFFICE-Editor geöffnet.

Zugriffsberechtigungen

Zugriffsberechtigungen für Dateien hängen von den Zugriffsrechten eines Benutzers auf das entsprechende Problem ab.

Bearbeiten von Dateien. Um Dateien bearbeiten zu können, muss ein Benutzer über Berechtigungen zum Erstellen von Anhängen (Create attachments) verfügen.

Anzeigen von Dateien. Die Dateivorschau in den ONLYOFFICE-Viewern ist für alle Benutzer verfügbar, die ein Problem anzeigen können, aber keine Berechtigungen zum Bearbeiten des Problems oder Berechtigungen zum Erstellen von Anhängen haben. Wenn das Dateiformat zum Bearbeiten nicht unterstützt wird, wird die Datei zum Anzeigen geöffnet.

Änderungen speichern

Die an einer Datei vorgenommenen Änderungen werden in einer neuen Datei mit demselben Namen wie die Originaldatei gespeichert, wobei am Ende des Dateinamens ein Postfix hinzugefügt wird, z.B. Sample-1.docx.

Die während der gemeinsamen Bearbeitung an einer Datei vorgenommenen Änderungen werden nur in der ersten Version der Datei gespeichert. Wird das Dokument von mehreren Benutzern gleichzeitig bearbeitet, werden die Änderungen nur in der ersten Datei angezeigt. Bis der letzte Benutzer den Editor schließt, wird dem Problem keine neue Version der Datei hinzugefügt.

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

Artikel zum Thema:

Changelog