<chapter id="eventmonitoring">
<title
>Het monitoren (volgen) van gebeurtenissen</title>
<para
>Een gegevensobject voor het monitoren van gegevens volgt een of meer vectoren of scalairen en voert een bepaalde actie uit als in verband daarmee een bepaalde conditie waar is. Gebeurtenismonitoren worden gewoonlijk gebruikt in samenhang met <quote
>"live"</quote
> of "streaming" (voortdurend vernieuwde) gegevens. Bijvoorbeeld kan een gebeurtenismonitor worden gemaakt om te volgen of er wel of geen elementen zijn, in een gegevensvector die een temperatuur weergeven, die een te hoge waarde bereikt. </para>

<sect1 id="eventmonitordialog">
<title
>De dialoog Gebeurtenismonitor</title>

<para
>Hieronder volgt een schermbeeld van het venster dat u ziet wanneer u gebeurtenissen maakt of bewerkt. Daaronder volgt een uitleg over de instellingen. </para>

<screenshot>
<screeninfo
>Venster Gebeurtenismonitor</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-eventmonitor.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Venster Gebeurtenismonitor</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect2 id="eventsexpression">
<title
>Expressie</title>
<para
>De conditie die moet worden gevolgd (gemonitord), samen met andere gebeurteniskarakteristieken, kan hier worden gewijzigd. </para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Bewerkingen (operatoren)</guilabel>
</term>
<listitem>
<para
>Een lijst met beschikbare bewerkingen. Door in de lijst een bewerking te kiezen wordt die ingevoegd op de huidige invoegpositie in het tekstvak van de <guilabel
>Expressie</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Vectoren</guilabel>
</term>
<listitem>
<para
>Een lijst met de huidige vectorobjecten in &kst;. Door in de lijst een vector te kiezen wordt die ingevoegd op de huidige invoegpositie in het tekstvak van de <guilabel
>Expressie</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Scalairen</guilabel>
</term>
<listitem>
<para
>Een lijst met de waarden van de beschikbare scalairen. Delijst bevat zowel de scalaire waarden in de huidige sessie van &kst; als die van enkele ingebouwde constanten. Door in de lijst een scalair te kiezen wordt die ingevoegd op de huidige invoegpositie in het tekstvak van de <guilabel
>Expressie</guilabel
>. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guilabel
>Expressie</guilabel>
</term>
<listitem>
<para
>De expressie die moet worden gevolgd (gemonitord). U kunt deze direct intypen in het tekstvak of u kunt onderdelen selecteren uit de bovenstaande keuzelijsten. Zorg ervoor dat de ingevoerde expressie een boolese expressie is (d.w.z. dat de uitkomst of waar of onwaar is). Dit houdt gewoonlijk in dat er een gelijkheids- of ongelijkheidsteken in voorkomt. Let erop dat als vectoren in het tekstvak worden ingevoerd de afzonderlijke elementen ervan zullen worden gemonitord. </para>
<para
>Zodra de expressie waar wordt wordt de gebeurtenis actief gemaakt. Wat er daarna gebeurt hangt af van de instellingen in de volgende twee secties. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Beschrijving</guilabel>
</term>
<listitem>
<para
>Het tekstvak wordt gebruikt voor een korte beschrijving van de gebeurtenis. Deze beschrijving dient hoofdzakelijk om het overzicht te kunnen bewaren als er meerdere gebeurtenissen zijn. U kunt in dit tekstvak invullen wat u wilt. </para>
</listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2 id="eventskstdebuglog">
<title
>Kst Debug Log (Logboek voor het oplossen van programmafouten)</title>
<para
>In deze sectie worden instellingen gedaan voor het bijhouden van de &kst; "debug log" voor het geval dat  er een bepaalde gebeurtenis actief wordt. </para>
<variablelist>
<varlistentry>
<term
><guilabel
>Noteren indien:</guilabel
></term>
<listitem>
<para
>Kruis dit keuzevakje aan als u wilt dat het actief worden van deze gebeurtenis in de &kst; debug log wordt bijgehouden. Er zijn drie manieren waarop dit kan gebeuren&mdash;als notitie, waarschuwing en fout. Selecteer de gewenste manier met behulp van het juiste keuzerondje. </para>
</listitem>
</varlistentry>
</variablelist>


</sect2>

<sect2 id="eventsemailnotification">
<title
>Emailbericht</title>
<para
>Hier kunt u de instellingen doen voor het sturen van een emailbericht als een gebeurtenis actief wordt. </para>

<variablelist>
<varlistentry>
<term
><guilabel
>Bericht</guilabel
></term>
<listitem>
<para
>Kruis dit keuzevakje aan als u wilt dat &kst; een emailbericht stuurt naar het opgegeven adres mocht deze gebeurtenis zich voordoen. Vul ook het emailadres in in het tekstvak <guilabel
>Afzender</guilabel
>. Dit adres komt in het veld <quote
>Van:</quote
> van het emailbericht. </para>
</listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2 id="eventselog">
<title
>ELOG</title>
<para
>Door &kst; kan ook een ELOG-logboek worden bijgehouden als er gebeurtenissen actief worden. Dit kan nuttig zijn voor het vanaf een andere computer volgen van veranderende gegevens, of voor het verkrijgen van samenvattingen over de gebeurtenissen die zich hebben voorgedaan. </para>

<variablelist>
<varlistentry>
<term
><guilabel
>Bericht</guilabel
></term>
<listitem>
<para
>Na het aankruisen van dit keuzevakje wordt voor deze gebeurtenismonitor het ELOG-loggen aangezet. Klik op <guibutton
>Instellen...</guibutton
> voor het opgeven van de instellingen van de server en het loggen zelf. </para>
</listitem>
</varlistentry>
</variablelist>
</sect2>

</sect1>

<sect1 id="elogextension">
<title
>DE ELOG-uitbreiding</title>
<para
>Door de ELOG-uitbreiding kunnen gebeurtenismonitoren logboeken bijhouden op een server waarop de Electronic Logbook- (elektronisch logboek) toepassing draait. Deze logboekgegevens kunnen, bijvoorbeeld, worden gebruikt om op een andere computer &kst;-gebeurtenissen te volgen of periodieke rapporten te maken over gegevens. Voor informatie over het instellen en het onderhoud van een ELOG-server zie de officiële <ulink url="http://midas.psi.ch/elog/"
>ELOG-webpagina</ulink
>. Om de ELOG-uitbreiding in &kst; te activeren kies <guimenuitem
>Uitbreidingen...</guimenuitem
> in het menu  <guimenu
>Instellingen</guimenu
> en zorg ervoor dat <quote
>ELOG-uitbreiding</quote
> is geselecteerd. </para>

<sect2 id="elogextensionsettings">
<title
>De instellingen van de server en van het loggen</title>
<para
>Als ELOG is geactiveerd voor het volgen van een gebeurtenis moeten de instellingen voor de server en van het loggen worden gekozen. Voor het instellen van het loggen klikt u op de knop <guibutton
>Instellen...</guibutton
> in de ELOG-sectie van de dialoog voor de Gebeurtenismonitor. U ziet dan als het goed is de dialoog voor ELOG-gebeurtenis invoer: </para>
<screenshot>
<screeninfo
>Loginstellingen gebeurtenismonitor</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-eventmonitor-loggingsettings.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Loginstellingen gebeurtenismonitor</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Gebruik de drie keuzevakjes onderaan om te selecteren over welk type informatie een logboek moet worden bijgehouden. Met <guilabel
>Log Kst-vensterbeeld</guilabel
> wordt opgegeven dat een afbeelding van het thans actieve venster in het logboek moet worden opgenomen. Met <guilabel
>Log Kst-instellingen</guilabel
> wordt opgegeven dat het bestand <filename
>*.kst</filename
> met de instellingen van &kst; in het logboek moet worden opgenomen. En tenslotte, indien <guilabel
>Log Kst debugging informatie</guilabel
> is geselecteerd wordt een kopie van de <link linkend="debuglog"
>debuglog</link
> ook in het logboek opgenomen. </para>

<para
>In deze dialoog komen extra velden beschikbaar zodra de ELOG-server instellingen zijn gedaan. Om deze instellingen aan te passen kiest u <guibutton
>Instellingen...</guibutton
>. U moet dan de volgende dialoog zien: </para>

<screenshot>
<screeninfo
>Instellingen server gebeurtenismonitor</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-eventmonitor-serversettings.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Instellingen server gebeurtenismonitor</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Hieronder volgt een beschrijving van de instellingen in dit venster. </para>
<variablelist>
<varlistentry>
<term
><guilabel
>Configuratie</guilabel
>, <guibutton
>Opslaan</guibutton
>, en <guibutton
>Inlezen</guibutton
> </term>
<listitem>
<para
>De keuzelijst van <guilabel
>Configuratie</guilabel
> bevat een lijst van opgeslagen instellingen voor de ELOG-server. Om instellingen hieruit in te lezen selecteert u deze in de lijst en klikt u op de knop <guibutton
>Inlezen</guibutton
>. Om de huidige instellingen op te slaan in deze dialoog selecteert u waar dit moet en klikt u op de knop <guibutton
>Opslaan</guibutton
>. </para>
<caution>
<para
>Het opslaan van instellingen overschrijft eventueel reeds op die plaats aanwezige instellingen. </para>
</caution>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>IP-adres</guilabel
> en <guilabel
>Poortnummer</guilabel
></term>
<listitem>
<para
>Voer het IP-adres in van de machine met de ELOG-server. Het poortnummer waar de ELOG-server op luistert is op de server instelbaar, maar is standaard 8080. Dus als u er niet zeker van bent kunt u het beste 8080 invoeren voor het poortnummer. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Logboek</guilabel
></term>
<listitem>
<para
>De ELOG-server kan een of meer logboeken bijhouden, dus moet u de naam van het logboek opgeven als er in wordt geschreven. Zorg ervoor dat u de naam van het logboek goed spelt.  </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Gebruikersnaam</guilabel
>, <guilabel
>Wachtwoord gebruiker</guilabel
>, en <guilabel
>Schrijf wachtwoord</guilabel
></term>
<listitem>
<para
>Afhankelijk van de instellingen van de ELOG-server kunnen deze instellingen wel of niet nodig zijn. Indien dat wel het geval is vult u de juiste gegevens in in de juiste tekstvakken. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Afmetingen opgeslagen vensterbeeld</guilabel
></term>
<listitem>
<para
>In deze keuzelijst kunt u de afmetingen, in pixels, selecteren van het &kst;-schermbeeld dat wordt opgeslagen (indien opgegeven). </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Schrijf als HTML-tekst</guilabel
></term>
<listitem>
<para
>Indien dit keuzevakje is geselecteerd kunnen HTML-teksten worden opgenomen in het logboek. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Geen emailbericht</guilabel
></term>
<listitem>
<para
>Indien de instellingen van het logboek het sturen van een emailbericht inhouden als er in het logboek wordt geschreven, wordt dit onderdrukt door het selecteren van dit keuzevakje. Merk op dat dit geen invloed heeft op de emailberichten van &kst; zelf voor gebeurtenismonitoren. </para>
</listitem>
</varlistentry>

</variablelist>

<para
>Door te klikken op de knop <guibutton
>Toepassen</guibutton
> worden de ingevoerde instellingen een feit. Klik op <guibutton
>Vernieuwen</guibutton
> om de invoerdialoog voor een ELOG-gebeurtenis (de vorige dialoog) bij te werken. In deze dialoog moeten extra velden zichtbaar zijn. Deze velden zijn uniek voor het geselecteerde logboek. Als u met de instellingen tevreden bent kunt u met <guibutton
>Test</guibutton
> een testbericht sturen om in het logboek op te nemen. Klik op <guibutton
>Sluiten</guibutton
> als u de dialoog wilt verlaten. </para>
</sect2>

</sect1>
</chapter>