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/06/03 15:14] – [WebDav MS-Word] Tim van Leeuwen
+++ openwave:1.34:applicatiebeheer:instellen_inrichten:webdav_ms-word [2026/06/19 13:07] (huidige) – Lonneke van Dijk
@@ Regel 2: / Regel 2: @@
 {{tag>openwave:1.34:applicatiebeheer:functionaliteiten: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|]]
-===== Instellingen in de configuratietabel (tbinitialisatie) die het gedrag kunnen beïnvloeden ====
+===== Wanneer gebruikt OpenWave WebDAV? ====
-  * Zie de items van: [[.:configuratie:sectie_webdav|]]
+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]].
-  * [[.: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:
+**
+[[.:configuratie:sectie_webdav|Sectie: WebDav (meer informatie)]]**
+Bevat de basisinstellingen voor de WebDAV-koppeling en sessieafhandeling.
+   *** Item: Sleuteldomein** Wordt gebruikt om het domein te bepalen waarmee de WebDAV-URL wordt opgebouwd in combinatie met de authorisatieuuid.
+   *** Item: TokenExpireSeconds.** Bepaalt de geldigheidsduur en bewaartermijn van WebDAV-tokens.
+**
+[[.:configuratie:sectie_owb|Sectie: OWB (meer informatie)]]**
+Bevat instellingen voor tijdelijke opslag en verwerking van WebDAV-bestanden.
+  * **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? =====
-Indien de instelling //Sectie: OnlyOffice en Item: eenbewerkertegelijk// NIET bestaat of niet is aangevinkt dan wordt het document in de wijzigmodus geopend (met de onderstaande restricties bij een geregistreerd document). Meerdere personen tegelijk kunnen eenzelfde document wijzigen zonder dit van elkaar te weten. Degene die het laatst opslaat is degene die de nieuwe versie bepaalt. Niet aan te raden dus.
+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.
-Anders, indien de instelling //Sectie: WebDav en Item: eenbewerkertegelijk// is aangevinkt en de medewerker mag het document bewerken, dan wordt:
+Dit wordt daarom niet aanbevolen.
-  * 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//.
-  * 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.
+Wanneer de instelling //Sectie: WebDAV// en //Item: eenbewerkertegelijk// is ingeschakeld en de gebruiker mag het document bewerken (zie de waarschuwing beneden), dan wordt:
-===== Readonly en wijzigmodus in MS-Word via WebDav voor geregistreerde documenten =====
+  * 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.
-Indien een geregistreerd document wordt geopend met WebDav dan redeneert OpenWave als volgt:
-Indien:
+<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 47: / Regel 73: @@
 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).\\
+**Geldigheidsduur van tokens**
-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.\\
+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).
-Is de token verlopen en de medewerker sluit nadien het document, dan kunnen de laatste wijzigingen niet meer op de server c.q. het 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 geregistreerd document).
+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) =====
-De tokens worden overigens vanzelf weer verwijderd uit de tabel tbaccesstoken op grond van //Getal2 // van de instelling //Sectie: WebDav en Item: TokenExpireSeconds//. //Getal2// staat voor het aantal uur dat een uitgegeven token bewaard wordt in deze tabel. Defaultwaarde 8. Indien 0 of kleiner wordt niet opgeschoond.
+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: