[[TOC(heading=Protocol handler)]]
[[TOC(heading=Protocol handler Releases, sectionindex, compact, depth=1, ServerReleases/)]]
[[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/)]]


= Protocol handler =

== Inleiding ==
Soms moet OpenAC kunnen communiceren met software en hardware die lokaal geïnstalleerd is op het werkstation van een gebruiker. Denk hierbij aan het printen van een batch documenten, het starten van meetapparatuur of het bewerken van een Word document. Om dit mogelijk maken is een zogenaamde //protocol handler// nodig. Dit is software die de communicatie verzorgt tussen OpenAC en lokale software en hardware.

Gebruik van de protocol handler is optioneel en is niet nodig voor de kernfunctionaliteit van OpenAC. 

== Implementatie ==
Voor OpenAC hebben we een eigen protocol handler ontwikkeld. Dit is een applicatie die weet hoe moet worden omgegaan met speciale hyperlinks. 

Alle hyperlinks beginnen met een //schema// gevolgd door ":". De bekendste schema's zijn http en https. Deze worden door de browser afgehandeld door de opgegeven pagina te laden. Een andere bekend schema is "mailto". Bij een klik op "mailto:adres@provider.nl" wordt de bij het besturingssysteem geregistreerde mail applicatie gestart.

OpenAC gebruikt het schema {{{openac-protocol}}} om lokaal geïnstalleerde software te starten.  Alle OpenAC URL's die beginnen met schema {{{openac-protocol:}}} worden door deze protocol handler afgehandeld. De OpenAC protocol handler moet zijn geïnstalleerd op elk werkstation waarop lokale software moet worden gestart. Het installatieprogramma koppelt schema {{{openac-protocol}}} aan de  {{{OpenACProtocolHandler.exe}}}. Hierdoor weet Windows welke applicatie moet worden gestart bij een klik op een link met schema {{{openac-protocol:}}}. 

Schematisch ziet de communicatie tussen OpenAC en lokale software en hardware er als volgt uit:

[[Image(protocol_handler_conceptueel.drawio.png, width=600)]]

== Installatie ==
Zie de [wiki:Documentatie/Beheerder/Modules/ProtocolHandler/Releases protcol handler releases] voor een installer.

== Controle installatie ==
Het is mogelijk om in OpenAC te controleren of de installatie is geslaagd. De controle moet worden uitgevoerd op een werkstation waarop de protocol handler is geïnstalleerd.

=== Versienummer ===
Het versienummer van de protocol handler wordt teruggegeven als antwoord op een ping. Zie de sectie "Ping" hieronder.

=== Ping ===
Onder Beheer -> Server status is een sectie "Protocol handler". Klik op "Ping protcol handler" en typ een bericht in de dialoog die verschijnt. Klik op de knop "Ping" om het bericht te versturen. Het duurt maximaal 30 seconden voordat er een bericht terugkomt van de protocol handler. Als de protocol handler goed is geïnstalleerd verschijnt een melding dat de protocol handler goed functioneert. Het antwoord bestaat uit het verstuurde bericht voorafgegaan door het versienummer:

[[Image(ping_protocolhandler_ok.png, width=700)]]

Als er een probleem is met de installatie van de protocol handler verschijnt de volgende melding:

[[Image(ping_protocolhandler_fout.png, width=700)]]

De eerste stap voor het oplossen van installatie problemen is controleren van het Windows applicatielogboek. Hierin schrijft de protocol handler zijn logberichten weg. De volgende stap is controleren van het OpenAC logbestand.