Verschillen

Dit geeft de verschillen weer tussen de geselecteerde revisie en de huidige revisie van de pagina.

--- openwave:1.34:applicatiebeheer:instellen_inrichten:webdav_ms-word [2026/04/08 11:24] – [Geldigheidsduur token] Paul de Boer
+++ openwave:1.34:applicatiebeheer:instellen_inrichten:webdav_ms-word [2026/06/19 13:07] (huidige) – Lonneke van Dijk
@@ Regel 1: / Regel 1: @@
-====== WebDav MS-Word ======
+====== WebDAV MS-Word ======
 {{tag>openwave:1.34:applicatiebeheer:functionaliteiten:documenten}}
-Via WebDav kan de lokale MS-Word gebruikt worden om MS-Word documenten te bewerken in de Cloud (vanuit documentenlijst, creëer document en geregistreerde documenten).
+Met WebDav kunnen Microsoft Word-documenten rechtstreeks vanuit OpenWave worden geopend, bewerkt en opgeslagen met de lokaal geïnstalleerde versie van Microsoft Word. Dit geldt zowel vanuit creëer documenten en vanuit geregistreerde documenten.
-===== Wanneer besluit OpenWave om de lokale MS-Word via WebDav aan te roepen =====
-Zie het schema op: [[..:probleemoplossing:programmablokken:toon_documenten_en_download|]]
+===== Wanneer gebruikt OpenWave WebDAV? ====
-===== Instellingen in de configuratietabel (tbinitialisatie) die het gedrag kunnen beinvloeden====
+OpenWave bepaalt op basis van de configuratie en de documentstatus of een geregistreerd document via WebDAV wordt geopend. De exacte beslisboom is beschreven in [[..:probleemoplossing:programmablokken:toon_documenten_en_download|Toon document en bewerk/download]].
-  * Zie de items van : [[.:configuratie:sectie_webdav|]]
-  * [[.:configuratie:sectie_owb|]] de items: MaxUurWebDavMove, MaxUurWebDavEdit, MaxUurWebDavDownload, MaxUurWebDavUpload, TussenmapWebDavEdit, TussenmapWebDavMove, TussenmapWebDavDownload,TussenmapWebDavUpload\\
-  * [[.:configuratie:sectie_documenten|]] het Item: WebDav
-Zie voor de verplichte instellingen ook [[..:probleemoplossing:programmablokken:toon_documenten_en_download|]]
+Het gebruik van WebDAV wordt beïnvloed door instellingen in de volgende secties:
-===== Een bewerker tegelijk? Alleen bij geregistreerde documenten =====
+**
+[[.:configuratie:sectie_webdav|Sectie: WebDav (meer informatie)]]**
-Indien de  instelling //Sectie: OnlyOffice en Item: eenbewerkertegelijk// NIET bestaat of niet is aangevinkt dan wordt het document in de wijzigmodus geopend (tenzij het gaat om een geregistreerd document: dan gelden de uitzonderingen hieronder). Meerdere personen tegelijk kunnen eenzelfde document wijzigen. Degene die het laatst opslaat is degene die de nieuwe versie bepaalt.
+Bevat de basisinstellingen voor de WebDAV-koppeling en sessieafhandeling.
-Anders, indien de instelling //Sectie: WebDav en Item: eenbewerkertegelijk// is aangevinkt en de medewerker mag het document bewerken, dan wordt:
+   *** Item: Sleuteldomein** Wordt gebruikt om het domein te bepalen waarmee de WebDAV-URL wordt opgebouwd in combinatie met de authorisatieuuid.
-  * op de kaart van een geregistreerd document bij opening van het document met WebDav - en wel op het moment dat de gebruiker als eerste een bewerking doet -  de docplaats (//waar is het document//) gewijzigd in:  //wordt (L)okaal bewerkt//. De medewerkersnaam van degene die op die manier de bestandslock zet wordt gezet in de kolom// Laatst geregistreerd door/is bij//.
+   *** Item: TokenExpireSeconds.** Bepaalt de geldigheidsduur en bewaartermijn van WebDAV-tokens.
-  * na sluiting van het document wordt de docplaats veranderd in S (server) waarmee het document wordt vrijgegeven voor de eerstvolgende gebruiker. Dit, mits het document door de gebruiker wordt gesloten binnen de geldige tijsduur van token (zie hieronder).
-Het is dus vanwege controle aan te raden de  instelling //Sectie: OnlyOffice en Item: eenbewerkertegelijk// aan te zetten.
+**
-===== Readonly en wijzigmodus in MS-Word via WebDav voor geregistreerde documenten =====
+[[.:configuratie:sectie_owb|Sectie: OWB (meer informatie)]]**
-Indien een geregistreerd document wordt geopend met WebDav dan redeneert OpenWave als volgt:
+Bevat instellingen voor tijdelijke opslag en verwerking van WebDAV-bestanden.
-Indien:
+  * **Items: MaxUurWebDavMove / Edit / Download / Upload.** Bepalen hoe lang tijdelijke WebDAV-bestanden per actie worden bewaard voordat opschoning plaatsvindt.
+  * **Items: TussenmapWebDavMove / Edit / Download / Upload.** Bepalen de tussenmappen waar WebDAV-bestanden tijdelijk worden opgeslagen per actie.
+**
+[[.:configuratie:sectie_documenten|Sectie: Documenten (meer informatie)]]**
+Bevat instellingen die bepalen of WebDAV wordt gebruikt bij het openen van documenten.
+  * **Item: WebDav.** Aanvinkvak waarmee wordt bepaald of WebDAV mag worden gebruikt. Indien aangevinkt, wordt op basis van de in //Tekst// opgegeven extensies bepaald of het document via WebDAV wordt geopend (bijvoorbeeld docx;doc). Met //Getal1// kan worden ingesteld dat na het creëren van een document niet automatisch WebDAV wordt gestart.
+Afhankelijk van deze configuratie, de documentstatus en de regels in Toon document en bewerk/download, bepaalt OpenWave of een document via WebDAV wordt geopend.
+===== Een bewerker tegelijk? =====
+Wanneer de instelling //Sectie: WebDAV// en //Item: eenbewerkertegelijk// niet is ingeschakeld, wordt een document direct in wijzigmodus geopend. Hierdoor kunnen meerdere gebruikers hetzelfde document gelijktijdig bewerken zonder elkaar daarvan op de hoogte te stellen. De gebruiker die als laatste opslaat, bepaalt uiteindelijk de inhoud van het document.
+Dit wordt daarom niet aanbevolen.
+Wanneer de instelling //Sectie: WebDAV// en //Item: eenbewerkertegelijk// is ingeschakeld en de gebruiker mag het document bewerken (zie de waarschuwing beneden), dan wordt:
+  * op de registratiekaart de docplaats veranderd in L (lokaal), waarmee voor andere mensen het document alleen in read only modus geopend kan worden. Ook wordt de registreerder geupdate met de inlogger.
+  * het document in de wijzigmodus geopend. Per definitie kan dit maar één persoon zijn.
+  * na sluiting van het document wordt de docplaats veranderd in S (server) waarmee het document wordt vrijgegeven voor de eerstvolgende gebruiker. Dit, mits het document door de gebruiker wordt gesloten binnen de geldige tijdsduur van de token (zie hieronder). Ook wordt de gewijzigde datum van het geregistreerde document gewijzigd met het huidige tijdstip.
+<adm warning>
+Als in Word instellingen Beveiligde Weergave aanstaat, dan moet er eerst in Word op Bewerken inschakelen gedrukt worden voordat je daadwerkelijk in editmodes komt.
+</adm>
+===== Openen in alleen-lezen(read only) modus =====
+Een geregistreerd document wordt in alleen-lezen modus geopend wanneer één van de onderstaande situaties van toepassing is:
   * de bovenliggende zaak is geblokkeerd
-  * OF docplaats = L (lokaal) EN //Sectie: WebDav en Item: eenbewerkertegelijk// is aangevinkt
+  * OF docplaats = L (lokaal) EN //Sectie: WebDAV en Item: eenbewerkertegelijk// is aangevinkt
   * OF datum verstuurd is gevuld
-  * OF de richting is B (binnenkomend)
+  * OF de richting is inenkomend
   * OF het document is Definitief
   * OF extensie = .pdf
@@ Regel 38: / Regel 65: @@
 <adm warning>
-Een document dat geopend is in read-only modus heeft in de titelbalk in MS-Word achter de documentnaam de tekst: //Alleen-lezen//. De gebruiker kan in het document tekst toevoegen, maar dat heeft tot gevolg dat bij het opslaan van het document de gebruiker gedwongen wordt dat aangepaste document onder een andere naam (en lokaal) op te slaan, immers het document dat van de fileserver of DMS komt is read-only,
+Een document dat geopend is in read-only modus heeft in de titelbalk in MS-Word achter de documentnaam de tekst: //Alleen-lezen//. De gebruiker kan in het document tekst toevoegen, maar dat heeft tot gevolg dat bij het opslaan van het document de gebruiker gedwongen wordt dat aangepaste document onder een andere naam (en lokaal) op te slaan, immers het document dat van de fileserver of DMS komt is read-only.
 </adm>
@@ Regel 44: / Regel 71: @@
 ===== Document uit DMS bewerken met MS-Word via WebDav =====
-Indien het aangewezen document uit een DSM komt (via Stuf zaak/DMS) dan zal het gewijzigde document via updateZaakDocument_Di02 met de bestaande documentidentifier worden aangeboden aan het DMS, in plaats van voegZaakDocumentToe_Lk01.
+Indien het aangewezen document uit een DMS komt (via Stuf zaak/DMS) dan zal het gewijzigde document via updateZaakDocument_Di02 met de bestaande documentidentifier worden aangeboden aan het DMS, in plaats van voegZaakDocumentToe_Lk01.
-De kolom //Tekst// van de instelling //Sectie: KoppelingDOCNAAMDMS Item: HTTPSoapAction_updateZaakDocument_Di02// moet gevuld worden met juiste soapaction: //<nowiki>http://www.egem.nl/StUF/sector/zkn/0310/updateZaakDocument_Di02</nowiki>//
+De kolom //Tekst// van de instelling //Sectie: KoppelingDOCNAARDMS Item: HTTPSoapAction_updateZaakDocument_Di02// moet gevuld worden met juiste soapaction:
+ //<nowiki>http://www.egem.nl/StUF/sector/zkn/0310/updateZaakDocument_Di02</nowiki>//
 ===== Geldigheidsduur token =====
-Bij elke aanroep vanuit OpenWave om een WebDav document te openen wordt een token gegenereerd en opgeslagen in de tabel tbaccesstoken (zie beheer detailscherm medewerkers in blok tokens). De geldigheidsduur van de token wordt bepaald door //Getal1// van de instelling //sectie: WebDav en item:TokenExpireSeconds//. Default is dat 28800 seconden (= 8 uur).\\
-Die token is cruciaal voor het uiwisselen van informatie tussen WebDav (MS-Word) en OpenWave.\\
-Zolang de token geldig is kan een medewerker een document bewerken en tussentijds opslaan. De status van de kolom //waar is het document// op de detailkaart van het geregistreerde document wordt dan keurig bijgewerkt.\\
-Is de token verlopen en de medewerker sluit nadien het document, dan kunnen de laatste wijzigingen niet meer op de server cq dms worden bijgewerkt. De medewerker zal desgewenst het document op zijn/haar eigen device moeten opslaan om later eventueel up te loaden. Echter ook de status van de kolom //waar is het document// kan in dat geval niet meer automatisch worden bijgewerkt door OpenWave (alleen een functioneel beheerder heeft hier rechten toe op de detailkaart van geregisteerd document).
+**Geldigheidsduur van tokens**
+Bij elke aanroep vanuit OpenWave om een WebDAV document te openen wordt een token gegenereerd. Deze wordt opgeslagen in de tabel tbaccesstoken (zie beheer detailscherm medewerkers in blok tokens).
+De geldigheidsduur van een token wordt bepaald door de instelling //Sectie: WebDAV, Item: TokenExpireSeconds// (kolom //Getal1//). De defaultwaarde bedraagt 28.800 seconden (8 uur).
+De token wordt gebruikt en is cruciaal voor de communicatie tussen OpenWave en Microsoft Word via WebDAV. Zolang de token geldig is:
+  * 	kunnen documenten worden opgeslagen;
+  * 	wordt de documentstatus bijgewerkt;
+  * 	kunnen wijzigingen worden teruggeschreven naar de server of het DMS.
+**Verlopen token**
+Indien een token verloopt terwijl een document nog geopend is:
+  * 	kunnen latere wijzigingen niet meer automatisch worden opgeslagen;
+  * 	kan het document niet meer worden bijgewerkt in het DMS of op de server;
+  * 	wordt de documentstatus mogelijk niet meer automatisch hersteld (alleen een functioneel beheerder heeft hier rechten toe op de detailkaart van geregistreerd document).
+In dat geval moet de gebruiker het document lokaal opslaan en eventueel later opnieuw uploaden.
+**Opschonen van tokens**
+Verlopen tokens worden automatisch verwijderd uit de tabel tbaccesstoken. De bewaartermijn wordt bepaald door de instelling //Sectie: WebDAV, Item: TokenExpireSeconds// (kolom //Getal2//). Deze waarde geeft het aantal uren aan dat een verlopen token in de tabel bewaard blijft.
+De defaultwaarde bedraagt 8 uur.
+Wanneer de waarde in //Getal2// gelijk is aan 0 of lager, vindt geen automatische opschoning van verlopen tokens plaats.
+===== Technische werking (stroomschema) =====
+Het proces begint met het automatisch aanmaken van een token met een unieke authorisatieuuid. Samen met de waarde uit de kolom //Info// van de instelling //Sectie: WebDAV, Item: Sleuteldomein// wordt hiermee een WebDAV-URL opgebouwd.
+Voorbeeld:
-===== Stroomschema bewerken document via MS-Word met WebDav =====
+https://voorbeeld.open-wave.nl/api/webdav/31fd5475beef407591096d70f2f4bb8e
-Het proces begint met het automatisch aanmaken van een token met een authorisatieuuid (zie onder blok token op detailscherm van medewerkerskaart)  waarmee - samen met de kolom //info// van de instelling //sectie: webdav en item: Sleuteldomein// - de url geconstrueerd wordt waarmee WebDav gestart wordt, bijvoorbeeld //<nowiki>ofv|u|https://acc.rommeldam.open-wave.nl/api/webdav/31fd5475beef407591096d70f2f4bb8e</nowiki>//\\
+De token bevat onder andere de bestandsnaam die WebDAV verwacht aan te treffen in de map die is geconfigureerd als Tussenmapdownloadfiles.
-In de token zit de bestandnaam die WebDav vervolgens verwacht aanwezig te zijn op de map: //Tussenmapdownloadfiles//\\
-Indien alles OK dan redeneert het proces als volgt bij het openen van een document (in werkelijkheid is het verkeer tussen OpenWave en Webdav wat uitgebreider dan hier is aangegeven):
+Nadat de token is gevalideerd, start het proces voor het openen, bewerken en opslaan van het document via Microsoft Word. Het werkelijke verkeer tussen OpenWave en WebDAV is uitgebreider dan in deze flowchart wordt weergegeven: