====== 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 creëer document 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 beinvloeden====
* 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|]]
===== 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 aamn te raden dus.
Anders, indien de instelling //Sectie: WebDav en Item: eenbewerkertegelijk// is aangevinkt en de medewerker mag het document bewerken, dan wordt:
* 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.
===== Readonly en wijzigmodus in MS-Word via WebDav voor geregistreerde documenten =====
Indien een geregistreerd document wordt geopend met WebDav dan redeneert OpenWave als volgt:
Indien:
* de bovenliggende zaak is geblokkeerd
* OF docplaats = L (lokaal) EN //Sectie: WebDav en Item: eenbewerkertegelijk// is aangevinkt
* OF datum verstuurd is gevuld
* OF de richting is B (binnenkomend)
* OF het document is Definitief
* OF extensie = .pdf
* Of de gebruiker heeft geen wijzigrechten
Dan wordt het document in readonly modus geopend in WebDav.
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,
===== 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.
De kolom //Tekst// van de instelling //Sectie: KoppelingDOCNAAMDMS Item: HTTPSoapAction_updateZaakDocument_Di02// moet gevuld worden met juiste soapaction: //http://www.egem.nl/StUF/sector/zkn/0310/updateZaakDocument_Di02//
===== 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).
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.
===== Stroomschema bewerken document via MS-Word met WebDav =====
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 //ofv|u|https://acc.rommeldam.open-wave.nl/api/webdav/31fd5475beef407591096d70f2f4bb8e//\\
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):
{{:openwave:1.34:applicatiebeheer:instellen_inrichten:webdav_msword.png?800|}}