SharePoint

Funktionsvergleich

¹ Der Co-Editing-Modus "Formal" kann sich negativ auf den Zugriffstoken-Parameter bei Verwendung von WOPI auswirken.

Unterstützte Formate

Offizieller Konnektor:

• Zum Anzeigen und Bearbeiten: DOCM, DOCX, DOTM, DOTX, PDF, POTM, POTX, PPSM, PPSX, PPTM, PPTX, XLSB, XLSM, XLSX, XLTM, XLTX
• Nur zum Anzeigen: CSV, DJVU, DOC, DOT, DPS, DPT, EPUB, ET, ETT, FB2, FODP, FODS, FODT, HML, HTM, HTML, HWP, HWPX, KEY, MD, MHT, MHTML, NUMBERS, ODG, ODT, ODP, ODS, OTT, OTP, OXPS, PAGES, POT, PPS, PPT, RTF, STW, SXC, SXI, SXW, TXT, VSDM, VSDX, VSSM, VSSX, VSTM, VSTX, WPS, WPT, XLS, XLT, XML, XPS

WOPI:

• Zum Anzeigen und Bearbeiten: DOCX, XLSX, PPTX, DOCM, XLSM, PPTM, ODT, ODS, ODP, CSV, PDF
• Nur zum Anzeigen: DJVU, XPS

Was gibt es Neues in Version 3.1.0

Geändert

• Neue unterstützte Formate hinzugefügt

Das vollständige Änderungsprotokoll finden Sie hier.

Anforderungen

• ONLYOFFICE Document Server v7.1 (Server oder Cloud-Version) oder höher. Die Instanz muss von SharePoint und allen Endclients auflösbar und erreichbar sein und in der Lage sein, direkt POST-Anfragen an SharePoint zu senden. Bitte beachten Sie die offizielle Dokumentationsseite, um mehr über die Installation von ONLYOFFICE Docs zu erfahren.
• SharePoint 2019
• ONLYOFFICE Konnektor 3.1.0 für SharePoint

Installation und Konfiguration

Die ONLYOFFICE SharePoint-Integrationslösung ist ein offizieller ONLYOFFICE-Konnektor, der auf der GitHub-Seite unter der GNU AGPL v.3 Lizenz verfügbar ist.

Um mehr darüber zu erfahren, wie sie funktioniert und wie man die Lösung kompiliert, besuchen Sie bitte unsere API-Dokumentation.

1. Klicken Sie auf Start, zeigen Sie auf Alle Programme, dann auf Verwaltung und klicken Sie auf Dienste. Stellen Sie sicher, dass der Dienst SharePoint Administration gestartet ist.
2. Klicken Sie auf Start, öffnen Sie die SharePoint Management Shell und navigieren Sie zu dem Verzeichnis, das die .wsp-Datei enthält.
3. Führen Sie das Skript Install.ps1 aus:

   PS> .\Install.ps1

4. Geben Sie die Adresse Ihrer SharePoint-Site ein:

   https://<yoursharepointsite>

   Anstelle der Schritte 3 und 4 können Sie den folgenden Befehl eingeben:

   Add-SPSolution -LiteralPath<solutionpath>/onlyoffice.wsp

   Auf der Startseite der SharePoint Central Administration klicken Sie auf Systemeinstellungen → Farmverwaltung → Farmlösungen verwalten. Auf der Seite Lösungsverwaltung klicken Sie auf onlyoffice.wsp und dann auf Lösung bereitstellen.
5. Auf der Startseite der SharePoint Central Administration klicken Sie unter Anwendungsverwaltung auf Webanwendungen verwalten.
6. Stellen Sie sicher, dass Ihre Site ausgewählt ist, und klicken Sie auf das Symbol Authentifizierungsanbieter.
7. Im Pop-up-Fenster Authentifizierungsanbieter klicken Sie auf Standardzone.
8. Unter Authentifizierung bearbeiten aktivieren Sie Anonymen Zugriff zulassen und klicken auf Speichern.
9. Zurück in der Webanwendungsverwaltung klicken Sie auf das Symbol Anonyme Richtlinie.
10. Unter Einschränkungen für anonymen Zugriff wählen Sie Ihre Zone aus, setzen die Berechtigungen auf Keine – Nein und klicken auf Speichern.
11. Öffnen Sie in SharePoint die Seite /_layouts/15/Onlyoffice/Settings.aspx mit den administrativen Einstellungen. Geben Sie folgende Adresse ein:

    https://<documentserver>/

    Dabei ist documentserver der Name des Servers, auf dem ONLYOFFICE Docs installiert ist. Die Adresse muss für den Benutzerbrowser und vom SharePoint-Server aus zugänglich sein. Die Adresse des SharePoint-Servers muss auch von ONLYOFFICE Docs erreichbar sein, damit alles korrekt funktioniert.

Wenn Sie Subsites in SharePoint eingerichtet haben, müssen Sie die Verbindung zu ONLYOFFICE Docs zusätzlich für jede Subsite konfigurieren. Gehen Sie zu den Einstellungen jeder Subsite und geben Sie die Docs-Adresse im entsprechenden Feld ein.

Ab ONLYOFFICE Docs v7.2 ist JWT standardmäßig aktiviert und der Geheimschlüssel wird automatisch generiert. Sie müssen ihn auch auf der SharePoint-Seite aktivieren: Finden Sie Ihren Geheimschlüssel in der ONLYOFFICE Docs-Konfigurationsdatei und geben Sie denselben Geheimschlüssel in den SharePoint-Administrations-Einstellungen an. Weitere Details finden Sie im Abschnitt JWT aktivieren weiter unten.

Wenn der JWT-Schutz aktiviert ist, muss ein benutzerdefinierter Headername angegeben werden, da die SharePoint-Sicherheitsrichtlinie externe 'Authorization'-Header blockiert. Dieser Header sollte auch in den ONLYOFFICE Docs Signatur-Einstellungen angegeben werden (weitere Informationen finden Sie hier).

Kompilieren der Lösung

Es gibt zwei Möglichkeiten, die ONLYOFFICE SharePoint-Integrationslösung zu kompilieren:

• Mit MS Visual Studio:
  1. Greifen Sie auf den SharePoint-Server zu und öffnen Sie dieses Projekt in Visual Studio.
  2. Öffnen Sie im Solution Explorer das Kontextmenü für das Projekt und wählen Sie Veröffentlichen.
  3. Wählen Sie im Dialogfeld Veröffentlichen die Option Veröffentlichen im Dateisystem aus.
  4. Klicken Sie auf Veröffentlichen. Nach Abschluss des Veröffentlichungsprozesses wird die Lösungsdatei .wsp erstellt.
  5. Kopieren Sie die erstellte Datei in den Ordner mit der Install.ps1-Datei (standardmäßig der Ordner BuildAndInstall).
• Mit der Datei build.bat:
  1. Wechseln Sie in den Ordner BuildAndInstall.
  2. Führen Sie die Datei build.bat aus.
  3. Die erstellte Lösungsdatei .wsp wird im Ordner BuildAndInstall abgelegt.

Funktionsweise

Die ONLYOFFICE-Integration folgt der API, die hier dokumentiert ist.

1. Der Benutzer navigiert zu einem Dokument innerhalb von SharePoint und wählt im Kontextmenü oder im Menüband die Aktion In ONLYOFFICE bearbeiten aus.
2. SharePoint sendet eine Anfrage an die Editor-Seite (URL in der Form: /_layouts/15/Onlyoffice/editorPage.aspx?SPListItemId={ItemId}&SPListURLDir={ListUrlDir}&action=track).
3. SharePoint erstellt ein JSON-Objekt mit folgenden Eigenschaften:
   • url — die URL, die ONLYOFFICE Docs zum Herunterladen des Dokuments verwendet;
   • callbackUrl — die URL, über die ONLYOFFICE Docs den Status der Dokumentbearbeitung meldet;
   • DocumentSeverHost — die URL, an die der Client antworten muss (kann auf der Einstellungsseite festgelegt werden);
   • Key — die Datei-ID aus SharePoint;
   • FileName — der Dokumenttitel (Name);
   • CurrentUserId — die Benutzer-ID;
   • CurrentUserName — der Benutzername.
4. SharePoint erstellt eine Seite, die all diese Werte enthält, damit der Client-Browser den Editor laden kann.
5. Der Client-Browser lädt die JavaScript-Bibliothek von ONLYOFFICE Docs und sendet die DocEditor-Konfiguration mit den oben genannten Eigenschaften an ONLYOFFICE Docs.
6. Dann lädt ONLYOFFICE Docs das Dokument von SharePoint herunter und der Benutzer beginnt mit der Bearbeitung.
7. Wenn alle Benutzer und Client-Browser mit der Bearbeitung fertig sind, schließen sie das Bearbeitungsfenster.
8. Nach 10 Sekunden Inaktivität sendet ONLYOFFICE Docs eine POST-Anfrage an callbackUrl, um der SharePoint ONLYOFFICE-Lösung mitzuteilen, dass die Clients die Bearbeitung beendet und das Dokument geschlossen haben.
9. SharePoint lädt eine neue Version des Dokuments herunter und ersetzt die alte.

Um mehr über die häufigsten Probleme und deren Lösungen zu erfahren, besuchen Sie bitte unseren Troubleshooting-Leitfaden.

JWT aktivieren

Zum Schutz der Dokumente vor unbefugtem Zugriff verwenden die ONLYOFFICE-Editoren JSON Web Token (JWT). Das Token wird bei der Initialisierung des Dokumenteneditors und während des Befehlsaustauschs zwischen den internen ONLYOFFICE Docs-Diensten in der Konfiguration hinzugefügt. Der Geheimschlüssel wird verwendet, um das JSON Web Token zu signieren und das Token bei Anfragen an ONLYOFFICE Docs zu validieren.

Ab ONLYOFFICE Docs v7.2 ist JWT standardmäßig aktiviert und der Geheimschlüssel wird automatisch generiert. Sie müssen Ihren Geheimschlüssel in der ONLYOFFICE Docs-Konfigurationsdatei finden und denselben Geheimschlüssel in den Konnektor-Einstellungen angeben.

Schritt 1: Finden Sie Ihren Geheimschlüssel in der ONLYOFFICE Docs-Konfigurationsdatei

1. Öffnen Sie die Datei local.json mit einem beliebigen Texteditor:
   • Für Linux: /etc/onlyoffice/documentserver/local.json
   • Für Windows: %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
   • Für Docker: Betreten Sie den ONLYOFFICE Docs-Container mit docker exec -it <containerID> bash und öffnen Sie /etc/onlyoffice/documentserver/local.json. Alternativ führen Sie aus:

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

   Die local.json-Datei sollte wie folgt aussehen:

   {"services": {"CoAuthoring": {"token": {"enable": {"request": {"inbox": true,"outbox": true},"browser": true}},"secret": {"inbox": {"string": "yoursecret"},"outbox": {"string": "yoursecret"},"session": {"string": "yoursecret"}}}}}

2. Der Wert true ist in drei Abschnitten angegeben, was 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 Geheimschlüssel ist in drei Abschnitten angegeben. Sie können den Standardwert durch Ihren eigenen Schlüssel ersetzen – er muss in allen drei Abschnitten identisch 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:

   supervisorctl restart all

Schritt 2: Geben Sie denselben Geheimschlüssel in den Konnektor-Einstellungen an

Geben Sie in den Konnektor-Einstellungen denselben Schlüssel im Feld Geheimschlüssel ein und speichern Sie die Einstellungen.

Einschränkungen

Die Verbindung von ONLYOFFICE Docs über WOPI weist aufgrund der WOPI-Architektur einige Einschränkungen auf:

• Keine Unterstützung für die Funktion Versionsverlauf.
• Das Einfügen von Bildern aus dem Speicher wird nicht unterstützt.
• Das Vergleichen von Dokumenten wird nicht unterstützt.
• Keine Unterstützung für die Formate: DOC, XLS, PPT.

Anforderungen

• ONLYOFFICE Document Server v7.1 oder höher mit aktiviertem WOPI. Folgen Sie dieser Anleitung, um WOPI zu aktivieren.
• SharePoint 2019

Verbindung über WOPI

1. Öffnen Sie Ihren SharePoint-Server. Starten Sie die Konsole SharePoint Management Shell und setzen Sie die benötigte WOPI-Zone:

   Set-SPWOPIZone -Zone "external-http"

   Der documentserver verwendet standardmäßig den Parameter external-http.
2. Prüfen Sie, ob auf der aktuellen Farm WOPI-Bindungen für andere Dokumenttypen vorhanden sind:

   Get-SPWOPIBinding

   Löschen Sie diese Bindungen, falls vorhanden:

   Remove-SPWOPIBinding -All:$true

3. Erstellen Sie neue Bindungen für Standardaktionen entsprechend den Dateitypen.

   Um Bindungen für alle Dateitypen gleichzeitig zu erstellen:

   New-SPWOPIBinding -ServerName ip_or_domain.com:port

   Um Bindungen nur für bestimmte Dateitypen zu erstellen:

   New-SPWOPIBinding -ServerName ip_or_domain.com:port -Extension DOCX

   Wenn kein SSL verwendet wird, fügen Sie am Ende des Befehls -AllowHTTP hinzu.

Erstellen neuer Dokumente

Um neue Dokumente erstellen zu können, richten Sie die unten beschriebenen Parameter ein. Dieses Beispiel gilt nur für DOCX-Dateien, aber Sie können ähnlich XLSX-, PPTX- und andere Dateien hinzufügen.

1. Aktivieren Sie die Einstellung Verwaltung von Inhaltstypen zulassen: Gehen Sie zu Dokumente → Bibliothekseinstellungen → Erweiterte Einstellungen. Wählen Sie im Abschnitt Verwaltung von Inhaltstypen zulassen Ja aus und klicken Sie auf OK.
   
2. Gehen Sie in der Dokumente-Bibliothek zu Websiteinhalte → Websiteeinstellungen → Websiteinhaltstypen. Klicken Sie auf Erstellen. Füllen Sie das Formular aus: Name (Neues Dokument), Beschreibung. Wählen Sie als übergeordneten Inhaltstyp Dokumentinhaltstypen, Dokument. Wählen Sie in der bestehenden Gruppe Benutzerdefinierte Inhaltstypen und klicken Sie auf OK.
   
3. Gehen Sie in der Dokumente-Bibliothek zu Websiteinhalte → Websiteeinstellungen → Websiteinhaltstypen. Wählen Sie den kürzlich hinzugefügten Neues Dokument aus. Gehen Sie zu Erweiterte Einstellungen → Dokumentvorlage → Neue Dokumentvorlage hochladen. Klicken Sie auf die Schaltfläche Datei auswählen, laden Sie das erforderliche Dokument hoch und klicken Sie auf OK.
   
4. Gehen Sie zur Dokumente-Bibliothek → Bibliothekseinstellungen. Wählen Sie im Abschnitt Inhaltstypen die Option Aus vorhandenen Websiteinhaltstypen hinzufügen. Wählen Sie in der Liste Websiteinhaltstypen auswählen aus Benutzerdefinierte Inhaltstypen. Wählen Sie im Feld Verfügbare Websiteinhaltstypen Neues Dokument. Klicken Sie auf die Schaltfläche Hinzufügen > und dann auf OK.
   
5. Aktualisieren Sie die Seite in der Dokumente-Bibliothek und klicken Sie auf die Schaltfläche Neu.
   
6. Der Inhaltstyp Dokument wird automatisch als übergeordneter Typ hinzugefügt. Er muss ausgeblendet werden: Gehen Sie zur Dokumente-Bibliothek → Bibliothekseinstellungen. Wählen Sie im Abschnitt Inhaltstypen die Option Neue Schaltflächenreihenfolge und Standardinhaltstyp ändern.
   
   Im Feld Sichtbar deaktivieren Sie das Kontrollkästchen für den Inhaltstyp Dokument und klicken auf OK.
   
7. Aktualisieren Sie die Seite in der Dokumente-Bibliothek und klicken Sie auf die Schaltfläche Neu – nur der Menüpunkt Neues Dokument ist verfügbar.