Nextcloud Integration

Überblick

Die WWS kann Dokumentenordner und Dateien direkt in Nextcloud öffnen. Dadurch können Benutzer aus der Warenwirtschaft heraus in den zugehörigen Nextcloud-Bereich wechseln, ohne den Ordner dort manuell suchen zu müssen.

Die Dokumente bleiben weiterhin im Dokumentenbereich der WWS verwaltet. Nextcloud wird ergänzend verwendet, um Funktionen wie die webbasierte Dokumentenbearbeitung, Vorschau, Zusammenarbeit und Freigabe bereitzustellen. Je nach Dateityp kann eine Datei direkt im integrierten Nextcloud-Editor geöffnet werden.

Beim Aufruf aus der WWS wird der aktuelle Dokumentenpfad an Nextcloud übergeben. Nextcloud prüft anschließend anhand des angemeldeten Benutzers, ob Zugriff auf den Ordner oder die Datei besteht. Nur wenn der Benutzer die entsprechenden Berechtigungen besitzt, wird der Ordner geöffnet oder die Datei im passenden Nextcloud-Viewer bzw. Editor angezeigt.

Damit kann ein Benutzer beispielsweise aus einem Kunden-, Beleg- oder Projektordner der WWS direkt in Nextcloud wechseln, dort Office-Dokumente bearbeiten oder einen freigegebenen Link zu einem Ordner oder Dokument erstellen.

Einrichtung

1. Externen Speicher in Nextcloud einrichten

In Nextcloud wird unter den Verwaltungseinstellungen im Bereich „Externer Speicher“ ein neuer externer Speicher vom Typ „WebDAV“ angelegt.

Empfohlene Einstellungen:

Ordnername: WWSMaX
Externer Speicher: WebDAV
URL/Pfad: https://wwsmax.meineurl.de/dav/[auth]
Authentifizierung: Manuelle Eingabe, in Datenbank speichern
Freigabe erlauben: optional aktivieren
Groß-/Kleinschreibung beachtendes Dateisystem: deaktivieren

Der Teil /dav/[auth] in der WebDAV-Adresse ist erforderlich, damit sich Nextcloud mit Benutzername und Kennwort des jeweiligen WWS-Benutzers am WWS-WebDAV-Server anmelden kann.

Der Ordnername legt fest, unter welchem Namen der WWS-Dokumentenbereich in Nextcloud erscheint. Wird beispielsweise WWSMaX verwendet, befinden sich die Dokumente aus Sicht von Nextcloud unterhalb von:

/WWSMaX/...

Bei Bedarf kann im Ordnernamen auch eine Ordnerstruktur verwendet werden, zum Beispiel:

Styletronix/WWSMaX

Dann erscheint der WWS-Dokumentenbereich in Nextcloud entsprechend unter:

/Styletronix/WWSMaX/...

2. Zugangsdaten pro Benutzer hinterlegen

Für jeden Benutzer, der die Nextcloud-Integration von WWSMaX verwenden soll, müssen die persönlichen WWS-Zugangsdaten beim externen Speicher hinterlegt werden.

Dazu öffnet der Benutzer in Nextcloud den eingerichteten externen Speicher und trägt dort seinen WWS-Benutzernamen und sein WWS-Kennwort ein. Anschließend sollte die Verbindung geprüft werden.

Beim ersten Zugriff kann es zu einer kurzen Verzögerung kommen, da Nextcloud den externen Speicher initial prüft und die Ordnerstruktur einliest.

3. Optional: WWSMaX Resolver installieren

Optional kann auf dem Nextcloud-Server die App wwsmax_resolver installiert werden.

Der Resolver verbessert die Integration zwischen WWSMaX und Nextcloud. Ohne Resolver kann WWSMaX Benutzer direkt zu einem Ordner in Nextcloud führen. Das funktioniert zuverlässig für Ordneransichten, reicht aber nicht in allen Fällen aus, um einzelne Dateien direkt im passenden Nextcloud-Viewer oder Editor zu öffnen.

Mit installiertem Resolver kann WWSMaX auch Dateien über ihren WWS-Pfad an Nextcloud übergeben. Der Resolver ermittelt daraus im aktuellen Benutzerkontext die passende Datei in Nextcloud und öffnet sie anschließend im vorgesehenen Nextcloud-Viewer bzw. Editor. Dadurch muss WWSMaX keine internen Nextcloud-Datei-IDs speichern oder verwalten.

Der Resolver bietet insbesondere folgende Vorteile:

direkte Übergabe von WWSMaX-Ordnern und Dateien an Nextcloud
Öffnen von Dateien im passenden Nextcloud-Viewer oder Office-Editor
keine Speicherung interner Nextcloud-Datei-IDs in der WWS erforderlich
Prüfung des Zugriffs im Kontext des angemeldeten Nextcloud-Benutzers
stabilere Verlinkung, auch wenn Nextcloud intern andere Datei-IDs verwendet

Der Resolver befindet sich im Installationsverzeichnis der WWS im Ordner:

Apps\wwsmax_resolver

Eine Installationsbeschreibung liegt dort bei.

4. Nextcloud-URL in WWSMaX eintragen

Die URL zur Nextcloud-Integration wird in WWSMaX unter folgendem Menüpunkt hinterlegt:

Einstellungen -> Globale Einstellungen -> Nextcloud FileShare URL

Variante ohne WWSMaX Resolver

Wenn der Resolver nicht installiert ist, kann WWSMaX direkt zur Ordneransicht von Nextcloud verlinken:

https://meinenextcloud.de/apps/files/files?dir=/WWSMaX/{0}

Diese Variante eignet sich vor allem zum Öffnen von Ordnern in Nextcloud.

Variante mit WWSMaX Resolver

Wenn der Resolver installiert ist, sollte folgende URL verwendet werden:

https://meinenextcloud.de/apps/wwsmax_resolver/{1}?path=/WWSMaX/{0}&mode={2}

Diese Variante eignet sich sowohl für Ordner als auch für Dateien. Dateien können dadurch direkt im passenden Nextcloud-Viewer oder Editor geöffnet werden.

Wurde beim externen Speicher ein anderer Ordnername als WWSMaX verwendet, muss WWSMaX in der URL durch den tatsächlich verwendeten Ordnernamen ersetzt werden.

Beispiel bei Ordnername Styletronix/WWSMaX:

https://meinenextcloud.de/apps/wwsmax_resolver/{1}?path=/Styletronix/WWSMaX/{0}&mode={2}

5. Platzhalter in der URL

Die Platzhalter in der URL werden von WWSMaX automatisch ersetzt:

{0} enthält den URL-codierten relativen Datei- oder Ordnerpfad aus der WWS.
{1} enthält die auszuführende Aktion. Standardmäßig wird open verwendet.
{2} enthält den Zugriffsmodus. Standardmäßig wird auto verwendet.

Der Standardmodus auto bedeutet, dass Nextcloud selbst entscheidet, wie das Ziel geöffnet wird. Ordner werden in der Nextcloud-Dateiansicht geöffnet. Dateien werden im passenden Nextcloud-Viewer oder, falls verfügbar, im integrierten Office-Editor geöffnet.