Open Source Dokumentenmanagement
Dokumentation

Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > Erste Schritte für Administratoren > agorum core ONLYOFFICE

agorum core ONLYOFFICE administrieren

Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plug-ins. Aktualisieren Sie das hier beschriebene Plug-in, um die Dokumentation verwenden zu können.

Voraussetzungen

Für die Nutzung von ONLYOFFICE in agorum core ist der Document Server ONLYOFFICE Docs notwendig.

Hinweis: Der Community Server ist nicht der Document Server! Um ONLYOFFICE Docs per API von außen ansprechen zu können, müssen Sie zwingend den Document Server ONLYOFFICE Docs installieren.

agorum core unterstützt alle verfügbaren Server Editionen (Stand 2020):

Wenden Sie sich an den offiziellen Hersteller für Rückfragen bezüglich der für Ihren Einsatzzweck benötigten Lizenz.

ONLYOFFICE kann auf Ihren eigenen Servern und in der Cloud betrieben werden. Im Falle der Cloud muss eine Besonderheit bezüglich der Kommunikation zwischen agorum core und ONLYOFFICE beachtet werden. Grundsätzlich muss der ONLYOFFICE-Server über HTTPS mit dem agorum core-Server kommunizieren können.

agorum core ONLYOFFICE einrichten

Sobald Sie das Plug-in installiert haben, müssen Sie die Verbindung zu ONLYOFFICE herstellen.

  1. Klicken Sie auf einer beliebigen Seite innerhalb von agorum core auf  .
  2. Wählen Sie Administration > ONLYOFFICE Verbindung einrichten.

    Ergebnis: Die Einstellungen zu ONLYOFFICE öffnen sich.
  3. Befüllen Sie die Eingabefelder.
  4. Speichern Sie die Änderungen.

    Ergebnis: Bei korrekten Einstellungen können Sie ab sofort Dokumente direkt betrachten und bearbeiten.
Verbindung zwischen ONLYOFFICE und agorum core einrichten

Felder

Eingabefeld Beschreibung Beispiel
ONLYOFFICE Documentserver URL Definiert die URL zum Document Server ONLYOFFICE Docs.

Die URL muss vom Browser des Benutzers aus erreichbar sein.		 
https://agorum-office-01.agorumcloud.com
agorum core URL Definiert die URL zum agorum core-Server.

Die URL muss von ONLYOFFICE Docs aus erreichbar sein. 		 
https://agorumdms.ihrefirma.de

Wenn der ONLYOFFICE-Server im selben Netzwerk installiert ist wie der agorum core-Server, können Sie auch die interne IP verwenden:

http://192.168.0.100
ONLYOFFICE Dokumentenserver "Secret" oder "Token" (JWT)

Bei der Einrichtung von ONLYOFFICE muss ein secret token konfiguriert werden (https://api.onlyoffice.com/editors/signature/). Tragen Sie das secret token in das Eingabefeld ein.

  • Das secret token wird bei ONLYOFFICE in der Datei /etc/onlyoffice/documentserver/local.json eingestellt.
  • Die Tokens müssen aktiviert sein.
  • Ein „geheimes“ secret muss eingestellt sein.

Hinweis: Beachten Sie die Hinweise auf der offiziellen Website des Herstellers. Die Informationen rechts im Feld Beispiel sind ein aktueller Auszug der Konfiguration, Stand 2020.

Wenn Sie Änderungen an der Datei local.json vorgenommen haben, müssen Sie den Service mit folgendem Befehl neu starten:

supervisorctl restart all
 
// ...
"token": {
  "enable": {
    "request": {
      "inbox": true,
      "outbox": true
    },
    "browser": true
  },
  "inbox": {
    "header": "Authorization"
  },
  "outbox": {
    "header": "Authorization"
  }
},
"secret": {
  "inbox": {
    "string": "meingeheimessecret"
  },
  "outbox": {
    "string": "meingeheimessecret"
  },
  "session": {
    "string": "meingeheimessecret"
  }
}
// ...
Weitere Informationen zu "Secret" bei ONLYOFFCE ab Version 7.2.0

Ab ONLYOFFICE 7.2.0 wird das secret token bereits erzeugt, Sie können es mit folgendem Befehl anzeigen:

documentserver-jwt-status.sh

// ...
"secret": {
  "inbox": {
    "string": "xx"
  },
  "outbox": {
    "string": "xx"
  },
  "session": {
    "string": "xx"
  }
},
// ...

Limits und Empfehlungen

ONLYOFFICE ist im Standard so eingestellt, dass die maximale Dateigröße 100 MB ist. Größere Dokumente können nicht geladen werden.

Verwenden Sie die neueren Open-Document-Formate, da diese kleiner und kompatibler mit ONLYOFFICE sind:

ONLYOFFICE in der Cloud verwenden

Sofern ONLYOFFICE in einer Cloud betrieben wird und agorum core in Ihrem internen Netz liegt, benötigt ONLYOFFICE Zugriff über HTTPS auf agorum core. D. h. agorum core muss aus dem Internet heraus erreichbar sein – oder zumindest vom ONLYOFFICE-Cloud-Server aus.

Verwenden Sie einen Proxyserver, der bestimmte Bestandteile von agorum core ins Internet veröffentlicht. Tipps, wie Sie solch eine Konfiguration aufbauen, können Sie im Internet nachlesen.

Sie müssen nicht den gesamten agorum core-Server ins Internet stellen. Folgende URLs genügen:

/api/rest/custom/onlyoffice.download.noauth/*
/api/rest/custom/onlyoffice.noauth/*

Gängige Open-Source-Proxyserver, die Sie einsetzen können:

Achtung: Sicherheitsrisiko durch falsche Konfiguration. Verwenden Sie für den internen agorum core-Webserver keine einfache Portweiterleitung.

Wenn Sie Probleme mit ONLYOFFICE haben

Kein Zugriff auf diese Datei möglich


Beschreibung des Problems

Beim Zugriff von ONLYOFFICE auf den agorum core-Server erscheint in ONLYOFFICE die Meldung Kein Zugriff auf diese Datei möglich.


Ursache

Die agorum core URL ist nicht korrekt.


Lösung

  1. Tragen Sie die korrekte agorum core URL ein.

Sicherheitstoken des Dokuments ist nicht korrekt


Beschreibung des Problems

Beim Zugriff von ONLYOFFICE auf den agorum core-Server erscheint in ONLYOFFICE die Meldung Sicherheitstoken des Dokuments ist nicht korrekt. Wenden Sie sich an Ihren Serveradministrator.


Ursache

Der ONLYOFFICE Dokumentenserver Secret oder Token (JWT) ist nicht korrekt.


Lösung

  1. Tragen Sie den korrekten ONLYOFFICE Dokumentenserver „Secret“ oder „Token“ (JWT) ein.

Ansicht bleibt bei Klick auf ein Office-Dokument leer


Beschreibung des Problems

In agorum core bleibt die Registerkarte Ansicht bei Klick auf ein Office-Dokument leer.

Ansicht bleibt bei Klick auf Office-Dokument leer


Ursachen


Lösungen


Die Adresse des ONLYOFFICE-Servers ist falsch

  1. Tragen Sie die korrekte Adresse des ONLYOFFICE-Servers ein.


Der ONLYOFFICE-Server ist nicht erreichbar

  1. Prüfen Sie den ONLYOFFICE-Server.

Herunterladen ist fehlgeschlagen


Beschreibung des Problems

Beim Zugriff von ONLYOFFICE auf den agorum core-Server erscheint in ONLYOFFICE die Meldung Herunterladen ist fehlgeschlagen.


Ursache

Die eingetragene Adresse im Feld agorum core URL weist am Ende der Adresse ein / auf (etwa http://onlyoffice-test.docker.agorum.com/)


Lösung

  1. Korrigieren Sie die agorum core URL, sodass am Ende der Adresse kein / mehr steht: 
    http://onlyoffice-test.docker.agorum.com