WebDav-Server
Ermöglicht den Dokumentenzugriff für den CMI Web Client.
Allgemeines
Aufgabe
Mit dem WebDAV-Server können Office Dokumente direkt aus dem Web-Client bearbeitet werden. Im Gegensatz zum CMI Explorer wird hier nicht der Registraturplan und Dossier als Filesystem bereitgestellt, sondern die Funktionalität ist auf das Bearbeiten (lesen, speichern) von Dokumenten beschränkt.
Strategische_Einordnung
Ermöglicht den Dokumentenzugriff für den CMI Web Client.
Systemvoraussetzungen
Folgende Services verwendet die Komponente:
| Service | Version | Anbindung | Protokoll | Standardports | Verfügbarkeit | Fehlertoleranzklasse |
|---|---|---|---|---|---|---|
| CMI Server | 25 | on request | http/s | 10004 | muss | Reconnect |
| CMI STS | >=3 | on request | http/s | 443 | muss | Reconnect |
Der Web Client und Microsoft Office sind Clients dieser Komponente.
Beispielsweise für den IIS:
- Das .NET Core Runtime (8.0.0) Windows Hosting Bundle muss installiert sein. Wichtig: Der Service führt Hintergrundaufgaben aus und muss daher im IIS-Betrieb für den Dauerbetrieb konfiguriert werden.
Technisches
Eigenschaften
Die Komponente erfüllt folgende Eigenschaften:
- Stateless: Nein
- Skalierbar/Multiinstanzfähig: Nein
- Mehrmandantenfähig: Nein
- Proxyfähig: Ja, wenn X-Forwarded-Header gesendet werden
- Laufzeitverhalten: Web-Anwendung - Die Anwendung wird durch http-Anfragen aktiviert, es gibt keine selbständig ablaufenden internen Prozesse.
Sonstiges:
OPTIONS Requests drüfen nicht durch eine Firewall blockiert werden. Sie sind für die Kommunikation erforderlich.
Der WebDav-Server sendet folgende Header an Microsoft Office, um Office anzuweisen, eine Anmeldung am CMI STS vorzunehmen. Diese Header dürfen nicht durch eine Firewall gefiltert werden.
CMI WebDavServer Response-Headers:
* Für die CMI STS Anmeldung
* X-FORMS_BASED_AUTH_REQUIRED
* X-FORMS_BASED_AUTH_RETURN_URL
* X-FORMS_BASED_AUTH_DIALOG_SIZE
* X-FORMS_BASED_AUTH_ACCEPTED
* Um das Dokument im Bearbeitungsmodus öffnen zu können
* Allow: COPY, DELETE, GET, HEAD, LOCK, MOVE, OPTIONS, POST, PROPFIND, PROPPATCH, PUT, REPORT, UNLOCK
* Public: COPY, DELETE, GET, HEAD, LOCK, MOVE, OPTIONS, POST, PROPFIND, PROPPATCH, PUT, REPORT, UNLOCK
* Access-Control-*
* X-Engine
* DAV
* MS-Author-Via
Microsoft Office Request-Headers:
* X-Office-Major-Version
* X-MS-CookieUri-Requested
* X-FeatureVersion
* X-MSGETWEBURL
* X-IDCRL_ACCEPTED
* X-IDCRL_OPTIONS
Fehlertoleranz
Ist einer der abhängigen Services nicht verfügbar, funktioniert die Komponente nicht. Da die Verbindungsversuche zu den abhängigen Services für jede Client-Anfrage erneut erfolgen, stellt die Komponente ihre Funktion selbstständig wieder hier, sobald die Umsysteme verfügbar sind.
Sequenzdiagramm
1) Der Web Client ruft folgenden Link auf (Office-Uri):
ms-word:ofv|u|<webdab-server-url>/<obj-guid>/<field-id>/<filename>.<extension>
2) Das Betriebssystem leitet diesen Link an Office weiter.
3) Word ruft den WebDAV-Server auf.
4) Authentifizierung (siehe [Wiki]).
5) Kommunikation via WebDAV-Protokoll zwischen Office und WebDAV-Server. Der WebDAV-Server holt Dokument-Informationen und Inhalt vom CMI Server. Dokument-Locks werden in der Datenbank des CMI Servers gespeichert.
Technologiestack
Folgende Technologien werden eingesetzt:
- ASP.NET Core 8.0