Nextcloud Integration

Ab Version 26.6.1

Die WWS kann Dokumentenordner über Nextcloud freigeben und Dateien direkt in Nextcloud öffnen. Dadurch können Benutzer aus der Warenwirtschaft heraus auf die Funktionen von Nextcloud zugreifen, wie z. B. die webbasierte Dokumentenbearbeitung, Vorschau, Zusammenarbeit und Freigabe.

Die Dokumente bleiben weiterhin im Dokumentenbereich der WWS verwaltet. Nextcloud wird ergänzend verwendet, um weitere Funktionen bereitzustellen.

Benutzer können auf diese Weise Dokumente auf sichere Weise über Nextcloud mit anderen Benutzern teilen, ohne dass diese Zugriff auf die WWS selbst benötigen.

Einrichtung

Externen Speicher in Nextcloud einrichten

In Nextcloud wird unter den Administrationseinstellungen im Bereich Administration > 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
```
- Ersetzen Sie wwsmax.meineurl.de durch die URL Ihrer WWS-Installation.
- Freigabe erlauben ist optional. Wird diese Option aktiviert, können Benutzer in Nextcloud die Dokumente aus der WWS mit anderen Benutzern teilen.
- 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
```
Zugangsdaten pro Benutzer hinterlegen

Für jeden Benutzer, der die Nextcloud-Integration von WWS MaX verwenden soll, müssen die persönlichen WWS-Zugangsdaten beim externen Speicher in Nextcloud hinterlegt werden. Nur so ist sichergestellt, dass jeder Benutzer nur auf Dokumente zugreifen kann, für die er in der WWS autorisiert wurde.

Pro Benutzer wird hierzu in WWS MaX ab Version 26.7.2 unter Hauptmenü > Benutzereinstellungen > Anmeldetoken ein neues Anwendungstoken erstellt. Siehe Anmeldetoken.

In Nextcloud wird als Benutzername [token] zusammen mit dem zuvor erstellten Anwendungstoken als Kennwort für die Anmeldung am externen Speicher verwendet.

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

Verwendet ein Benutzer in der WWS MaX WebApp die Funktion Von allen Geräten abmelden, werden sämtliche Anmeldetoken des Benutzers gelöscht. Dadurch verliert auch Nextcloud den Zugriff auf die WWS MaX. Um die Nextcloud-Integration anschließend wieder nutzen zu können, muss der Benutzer ein neues Anmeldetoken erstellen und die externe Freigabe erneut autorisieren.
Bis zur erneuten Autorisierung stehen auch die vom Benutzer erstellten Links und Freigaben nicht zur Verfügung.
Wird ein Benutzer in der WWS MaX gesperrt oder gelöscht, kann Nextcloud nicht mehr auf die diesem Benutzer zugeordnete externe Freigabe zugreifen. Alle darüber erstellten Links und Freigaben werden dadurch vorübergehend ungültig. Sie können erst wieder genutzt werden, nachdem die externe Freigabe mit gültigen Zugangsdaten erneut autorisiert wurde.
WWS MaX Resolver installieren Optional

Der WWS MaX Resolver verbessert die Integration zwischen WWS MaX und Nextcloud.

Ohne Resolver kann WWS MaX Benutzer direkt zu einem Ordner in Nextcloud führen. Dateien können allerdings nicht direkt im passenden Nextcloud-Viewer oder Editor geöffnet werden.

Mit installiertem Resolver kann WWS MaX Dateien direkt im entsprechenden Nextcloud-Viewer oder Editor öffnen oder diese in der Dateiansicht selektieren.

Der Resolver befindet sich im Installationsverzeichnis der WWS im Ordner:
```
C:\Program Files (x86)\Styletronix.net\Auftragsverwaltung V2\Apps\wwsmax_resolver
```
Eine Installationsbeschreibung finden Sie hier: Installationsanleitung.
Nextcloud-URL in WWS MaX eintragen

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

Hauptmenü > Systemeinstellungen > Allgemein > Globale Einstellungen > Nextcloud FileShare URL
- Wenn der Resolver nicht installiert ist, tragen Sie unter Nextcloud FileShare URL folgende URL ein:
```
https://meinenextcloud.de/apps/files/files?dir=/WWSMaX/{0}
```
- Wenn der Resolver installiert ist, verwenden Sie folgende URL unter Nextcloud FileShare URL:
```
https://meinenextcloud.de/apps/wwsmax_resolver/{1}?path=/WWSMaX/{0}&mode={2}
```
Hinweis
Ersetzen Sie meinenextcloud.de durch die URL Ihrer Nextcloud-Installation.
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:
# Mit installiertem Resolver https://meinenextcloud.de/apps/wwsmax_resolver/{1}?path=/Styletronix/WWSMaX/{0}&mode={2} # Ohne Resolver https://meinenextcloud.de/apps/files/files?dir=/Styletronix/WWSMaX/{0}

Platzhalter in der URL

Die Platzhalter in der URL werden von WWS MaX 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.
- open bedeutet, dass Nextcloud den Ordner oder die Datei im integrierten Viewer oder Editor öffnen soll.
- select bedeutet, dass Nextcloud den Ordner oder die Datei nur in der Dateiansicht markieren soll, ohne sie zu öffnen.
{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.