MS Office Dokumente direkt über WebDAV öffnen

Microsoft Office bietet eine native Unterstützung für das direkte Öffnen und Bearbeiten von Dokumenten über WebDAV, ohne dass der agorum core client installiert sein muss. Dies funktioniert über Office URI-Schemata und ermöglicht eine nahtlose Cloud-Integration.

Die vollständige Dokumentation zum Office URI Schemes finden Sie in der Microsoft-Dokumentation: Microsoft Office URI Schemes

Voraussetzungen

Sie können agorum core für das direkte Öffnen von MS Office Dokumenten konfigurieren, wenn folgende Voraussetzungen erfüllt sind:

Lokale MS Office Installation erforderlich (Office 2013 oder höher empfohlen)
WebDAV muss konfiguriert sein
Negotiate-Authentifizierung (NTLM oder Kerberos) wird unterstützt
Gültiges SSL-Zertifikat auf dem Server

Funktionsweise

Microsoft Office verwendet ein spezielles URI-Schema, um Dokumente direkt von WebDAV-Servern zu öffnen. Die URL-Struktur folgt dem Microsoft Office URI Schemes Standard, Beispiel:

ms-word:ofe|u|https://server/webdav/pfad/dokument.docx

Für verschiedene Office-Anwendungen gibt es unterschiedliche URI-Schemas:

ms-word: für Word-Dokumente (.docx, .doc)
ms-excel: für Excel-Dokumente (.xlsx, .xls)
ms-powerpoint: für PowerPoint-Präsentationen (.pptx, .ppt)

Konfiguration in agorum core (ASA-AddOn)

Für die Einrichtung muss eine ASA-Konfiguration erstellt werden, die das URI-Schema generiert:

Öffnen Sie den ASA-Konfigurator und erstellen oder öffnen Sie eine ASA-Konfiguration, siehe Konfiguration im agorum core smart assistant konfigurator anlegen.
Erstellen Sie eine neue Aktion, siehe Elemente im agorum core smart assistant konfigurator anlegen.
Geben Sie im Feld Befehlsgruppe Öffnen an.
Erstellen Sie einen Selektor-Eintrag mit folgenden Einstellungen:
Name: MS Word
Selektor: [nameExtension=/do[tc]x?/i]
Geben Sie folgendes JavaScript an:
```
/* global sc, sca, folder, objects, data */

let beans = require('common/beans');

let [_, host, ssl, port, path] = beans.get(objects[0], 'unc(webdav)').match(/\\{2}(.+?)(@SSL)?(@[0-9]+)?\\webdav\\(.+)/);

'url:ms-word:ofe|u|' + (ssl === '@SSL' ? 'https' : 'http') + '://' + host + (port ? ':' + port.slice(1) : '') + '/webdav/' + path.replace(/\\/g, '/');
```
Funktionsweise des Skripts:
1. UNC-Pfad-Extraktion: Das Skript verwendet beans.get(), um den WebDAV-UNC-Pfad des ersten Objekts abzurufen. Das Format des UNC-Pfads ist: \\hostname[@SSL][@port]\webdav\pfad
2. Regex-Parsing: Der UNC-Pfad wird mittels regulärem Ausdruck in folgende Komponenten zerlegt:
• host: Hostname/Server-Adresse
• ssl: SSL-Flag
• port: Port-Nummer
• path: Relativer Datenpfad nach /webdav/
3. URL-Konstruktion: Erstellt eine MS Word Office Protocol Handler URL mit folgendem Schema:
```
url:ms-word:ofe|u|[protokoll]://[host][:port]/webdav/[pfad]
```
• Protokoll: https bei SSL, sonst http
• Port: Nur eingefügt, wenn vorhanden
• Pfad: Backslashes werden in Forward-Slashes umgewandelt
Schalten Sie die ASA-Konfiguration über Datei > Exportieren aktiv.
Wählen Sie zum Testen ein docx-Dokument aus, etwa /agorum/roi/Files/Demo/Einstieg zu agorum core.docx.

Ergebnis: Das Dokument öffnet sich auf Ihrem lokalen Rechner in MS Word.
• Abhängig von Ihrer MS Office Konfiguration kann es sein, dass Sie sich zuerst in MS Office anmelden müssen.
• Wenn Sie selbstsignierte Zertifikate verwenden, kann es sein, dass Sie das Zertifikat zuerst installieren oder einen Sicherheitshinweis bestätigen müssen.