wiki:Documentatie/Beheerder/Modules/ProtocolHandler

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@…" 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:

Installatie

Zie de 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:

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

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.

Last modified 4 months ago Last modified on Jan 2, 2024 5:18:08 PM

Attachments (3)

Download all attachments as: .zip