[[TOC(heading=Documentserver)]]
[[TOC(heading=Moduleconfiguratie, sectionindex, compact, depth=3, allactive, Documentatie/Beheerder/Modules/)]]
[[TOC(heading=Beheerder, sectionindex, compact, depth=2, allactive, indirect=Documentatie/Beheerder/TOC)]]
[[TOC(heading=Documentatie, sectionindex, compact, depth=1, allactive, Documentatie/)]]


= Documentserver =
De documentserver van OpenAC 3 maakt gebruik van WebDAV. De documentserver zorgt ervoor dat gebruikers vanuit OpenAC 3 Office-documenten kunnen bewerken.

De OpenAC WebDAV-server is een aparte applicatie genaamd openac-webdav.exe die wordt meegeleverd met de OpenAC distributie en tijdens het starten van OpenAC wordt opgestart als een apart proces.

== Configuratie ==
Om WebDAV in gebruik te nemen moet een sectie "Documentserver" worden opgenomen in appsettings.json:
{{{#!json
"Documentserver": {
    "__comment__": "Type: Filesystem of WebDAV",
    "Type": "WebDAV",
    "WebDAV": {
        "Host": "localhost",
        "Port": 3000,
        "Dir": "//localhost/d$/openac_data",
        "LogDir": "d:/openac_data/log"
    }
},
}}}

||**Type**||"WebDAV" om WebDAV te gebruiken, anders "Filesystem"||
||**Host**||De hostnaam van de server waar OpenAC 3 en de WebDAV-server op draaien. OpenAC clients moeten de server met deze naam kunnen benaderen||
||**Port**||Het poortnummer waarop de WebDAV-server te bereiken is. Het poortnummer mag niet in gebruik zijn (ook niet door OpenAC 3) en moet worden vrijgegeven in de firewall||
||**Dir**||De documentenmap van OpenAC. Het pad mag zowel in UNC-notatie of met een schijfletter worden opgegeven maar gebruik altijd **forward slashes**||
||**!LogDir**||Lokale servermap waar de WebDAV-server zijn logbestand naartoe schrijft. Gebruik een schijfletter en **forward slashes**||


**Let op:** De WebDAV-server gebruikt dezelfde configuratiebestanden als OpenAC (appsettings.json en hosting.json) maar is strikter dan OpenAC wat JSON-fouten betreft. Bij syntactische fouten in de JSON-bestanden start de WebDAV-server niet op.

Aandachtspunten:
* Commentaar is niet toegestaan in JSON-bestanden. Verwijder blokken die beginnen met /* en eindigen met */ en regels die beginnen met //.
* Als openac-webdav niet opstart, probeer de executable dan op te starten vanaf de command line. Foutmeldingen verschijnen op de console.

== Certificaat ==
Communicatie tussen Office en de WebDAV-server is beveiligd met een SSL-certificaat. Om ingebruikname van de server te vergemakkelijken leveren we een door de Fenac uitgegeven certificaat mee met OpenAC. Dit certificaat is te vinden in de map Modules\WebDAV. Om het te kunnen gebruiken moet het rootcertificaat hiervan worden vertrouwd. Doe dit door FenacCA.cer te installeren als vertrouwd basiscertificaat.

== Stoppen & Starten ==
De WebDAV-server wordt automatisch gestart door OpenAC. Als het nodig is de server te stoppen dan kan dit vanaf de server statuspagina.

== Gebruik ==
Door te klikken op een documentlink in OpenAC zal Office worden opgestart en zal contact zoeken met de WebDAV-server om het document te openen. De gebruiker zal éénmalig moeten inloggen met de OpenAC gebruikersnaam en het OpenAC wachtwoord. De WebDAV-server gebruikt de OpenAC 3 login service om de gebruiker in te loggen.