Eventhandler: Unterschied zwischen den Versionen

Aktuelle Version vom 4. Dezember 2019, 12:30 Uhr

Begriff

Der englische Begriff event handler steht im Zusammenhang mit ereignisorientierten Programmiersprachen^[1]. Als deutsche Begriffe werden Ereignisbehandler^[2] oder Ereignishandler verwendet. Zur Abgrenzung wird im Zusammenhang mit FHEM die Schreibung Eventhandler verwendet.

Definition

Eventhandler reagieren auf Ereignisse, verarbeiten sie und liefern ein Ergebnis.

Benutzersicht

Aus Benutzersicht sind es Module, bzw. deren Geräte, die es erlauben Eingangsfilter, die Ereignisverarbeitung, das Ergebnis oder Teilaspekte dieser Parameter selbst zu bestimmen.

Allgemeine Eventhandler

Allgemeine Eventhandler geben dem Benutzer die Möglichkeit den Eingangsfilter, die Verarbeitung und das Ergebnis selbst zu bestimmen. Das ist bei den folgenden Modulen der Fall.

DOIF^[3] universelles Modul, welches ereignis- und zeitgesteuert Anweisungen ausführt
notify^[4] führt bei Events Anweisungen aus

Spezielle Eventhandler

Spezielle Eventhandler bieten Lösungen für typische Anwendungsfälle. Das ist bei den folgenden Modulen der Fall.

Alarm^[5] Konfiguration eines Hausalarmsystems mit 8 Alarmstufen
autocreate^[6] Erzeugt FHEM-Geräte automatisch
DbLog^[7] loggt Events in eine Datenbank
FileLog^[8] schreibt Events in eine Logdatei
PID20^[9] PID-Regler für Sensor und Aktor
sequence^[10] generiert Event nach Empfang einer definierten Event-Sequenz
THRESHOLD^[11] Simulation eines Zweipunktreglers
watchdog^[12] führt Befehl aus, falls innerhalb des Timeouts kein Event empfangen wurde

Bedienung

Es sind Ereignisfilter oder Suchmuster festzulegen. Die Verarbeitung ist zu beschreiben und das daraus resultierenden Ergebnis ist festzulegen.

Suchmuster oder Ereignisfilter

Die im System aktuell entstehenden Ereignisse können mit dem Eventmonitor angezeigt werden. Die angzeigten Ereignisse sind die Grundlage zur Erstellung von Ereignisfiltern oder Suchmustern als Eingangsparameter für einen Eventhandler. Wenn Ereignisse zu dem Filter passen, dann startet die Verarbeitung und ein Ergebnis wird geliefert.

Der Eventmonitor stellt einen Assistenten bereit, der für einige Module das Erstellen von Ereignisfiltern oder Suchmustern unterstützt.

Die genaue Syntax der Filter oder Suchmuster eines Eventhandler ist in der Befehlereferenz beschrieben.

Verarbeitung

Ein zum Ereignisfilter passendes Ereignis ist der Auslöser oder auch Trigger der Verarbeitung. Die Verarbeitung beinhaltet die Entscheidung welche Befehle ausgeführt werden sollen. Bei der Entscheidungsfindung können die in FHEM vorhandenen Größen und Werte berücksichtigt werden. Die Verküpfung erfolgt durch die vom jeweiligen Eventhandler bereitgestellten Möglichkeiten und Perlausdrücke^[13].

Ergebnis

Als Ergebnis der Eventverarbeitung werden Befehle ausgeführt, die FHEM-Befehlstypen sind in der Befehlereferenz beschrieben.

FHEM-Befehle, sie werden direkt angegben und sind in der Befehlereferenz im Abschnitt FHEM-Befehle zu finden.
Shellbefehle, sie werden durch doppelte Anführungszeichen "<Shellbefehle>" eingeschlossen.
Perlausdrücke, sie werden von geschweiften Klammern {<Perlausdrücke>} eingeschlossen.

Entwicklungssicht

Aus Modulsicht sind es Modulfunktionen, die Hardwareereignisse oder Systemereignisse behandeln.

Links

Timehandler

[1] ttps://de.wikipedia.org/wiki/Ereignis_(Programmierung)#Verwendung

[2] ttps://wiki.selfhtml.org/wiki/HTML/Eventhandler

[3] ref/DOIF

[4] ref/notify

[5] ref/Alarm

[6] ref/autocreate

[7] ref/DbLog

[8] ref/FileLog

[9] ref/PID20

[10] ref/sequence

[11] ref/THRESHOLD

[12] ref/watchdog

[13] ttps://perldoc.perl.org/index.html

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]

[9]

[10]

[11]

[12]

[13]

@@ Zeile 1: / Zeile 1: @@
-{{Baustelle}}
 == Begriff ==
 Der englische Begriff event handler steht im Zusammenhang mit ereignisorientierten Programmiersprachen<ref>https://de.wikipedia.org/wiki/Ereignis_(Programmierung)#Verwendung</ref>. Als deutsche Begriffe werden Ereignisbehandler<ref>https://wiki.selfhtml.org/wiki/HTML/Eventhandler</ref> oder Ereignishandler verwendet. Zur Abgrenzung wird im Zusammenhang mit FHEM die Schreibung [[Eventhandler]] verwendet.
@@ Zeile 7: / Zeile 6: @@
 == Benutzersicht ==
-Aus Benutzersicht sind es [[Module]], bzw. deren [[Gerät|Geräte]], die es erlauben Eingangsfilter, die Ereignisverarbeitung, das Ergebnis oder Teilaspekte dieser Parameter selbst zu bestimmen
+Aus Benutzersicht sind es [[Modul|Module]], bzw. deren [[Gerät|Geräte]], die es erlauben Eingangsfilter, die Ereignisverarbeitung, das Ergebnis oder Teilaspekte dieser Parameter selbst zu bestimmen.
 === Allgemeine Eventhandler ===
-Allgemeine Eventhandler geben dem Benutzer die Möglichkeit den Eingangsfilter, die Verarbeitung und das Ergebnis selbst zu bestimmen. Das ist bei den folgenden Modulen der Fall.
+Allgemeine Eventhandler geben dem Benutzer die Möglichkeit den Eingangsfilter, die Verarbeitung und das Ergebnis selbst zu bestimmen. Das ist bei den folgenden [[Modul|Modulen]] der Fall.
-* [[DOIF]]<ref>{{Link2CmdRef|Anker=DOIF_|Lang=de|Label=DOIF}}</ref>
+* [[DOIF]]<ref>{{Link2CmdRef|Anker=DOIF|Lang=de}}</ref> universelles [[Modul]], welches ereignis- und zeitgesteuert Anweisungen ausführt
-* [[notify]]<ref>{{Link2CmdRef|Anker=notify|Lang=de|Label=notify}}</ref>
+* [[notify]]<ref>{{Link2CmdRef|Anker=notify|Lang=de}}</ref> führt bei Events Anweisungen aus
 === Spezielle Eventhandler ===
-Spezielle Eventhandler bieten dem Benutzer nur eingeschränkte Möglichkeiten die Verarbeitung und das Ergebnis selbst zu bestimmen. Das ist bei den folgenden Modulen der Fall.
+Spezielle Eventhandler bieten Lösungen für typische Anwendungsfälle. Das ist bei den folgenden [[Modul|Modulen]] der Fall.
-* [[DbLog]]<ref>{{Link2CmdRef|Anker=DbLog|Lang=de|Label=DbLog}}</ref>
+* [[Modul_Alarm|Alarm]]<ref>{{Link2CmdRef|Anker=Alarm|Lang=en}}</ref> Konfiguration eines Hausalarmsystems mit 8 Alarmstufen
-* [[FileLog]]<ref>{{Link2CmdRef|Anker=FileLog|Lang=de|Label=FileLog}}</ref>
+* [[autocreate]]<ref>{{Link2CmdRef|Anker=autocreate|Lang=de}}</ref> Erzeugt FHEM-Geräte automatisch
-* [[sequence]]<ref>{{Link2CmdRef|Anker=sequence|Lang=de|Label=sequence}}</ref>
+* [[DbLog]]<ref>{{Link2CmdRef|Anker=DbLog|Lang=de}}</ref> loggt Events in eine Datenbank
-* [[watchdog]]<ref>{{Link2CmdRef|Anker=watchdog|Lang=de|Label=watchdog}}</ref>
+* [[FileLog]]<ref>{{Link2CmdRef|Anker=FileLog|Lang=de}}</ref> schreibt Events in eine Logdatei
+* [[PID20_-_Der_PID-Regler|PID20]]<ref>{{Link2CmdRef|Anker=PID20|Lang=de}}</ref> PID-Regler für Sensor und Aktor
-Bei dem [[Modul]] [[FileLog]] z.B. kann der Eingangsfilter selbst bestimmt werden und im Ergebnis wird in eine Textdatei geschrieben, das Modul bietet nicht die Möglichkeit in eine Datenbank zu schreiben. Diese Möglichkeit bietet der spezielle [[Eventhandler]] [[DbLog]].
+* [[sequence]]<ref>{{Link2CmdRef|Anker=sequence|Lang=de}}</ref> generiert Event nach Empfang einer definierten Event-Sequenz
+* [[THRESHOLD]]<ref>{{Link2CmdRef|Anker=THRESHOLD|Lang=de}}</ref> Simulation eines Zweipunktreglers
+* [[watchdog]]<ref>{{Link2CmdRef|Anker=watchdog|Lang=de}}</ref> führt Befehl aus, falls innerhalb des Timeouts kein Event empfangen wurde
 === Bedienung ===
@@ Zeile 32: / Zeile 33: @@
 Wenn [[Ereignis|Ereignisse]] zu dem Filter passen, dann startet die Verarbeitung und ein Ergebnis wird geliefert.
-Der [[Event monitor|Eventmonitor]] stellt einen Assistenten bereit, der für einige Module das Erstellen von Ereignisfiltern oder Suchmustern unterstützt.
+Der [[Event monitor|Eventmonitor]] stellt einen Assistenten bereit, der für einige [[Modul|Module]] das Erstellen von Ereignisfiltern oder Suchmustern unterstützt.
 Die genaue Syntax der Filter oder Suchmuster eines [[Eventhandler]] ist in der {{Link2CmdRef|Anker=doctop|Lang=de|Label=Befehlereferenz}} beschrieben.
 ==== Verarbeitung ====
+Ein zum Ereignisfilter passendes [[Ereignis]] ist der Auslöser oder auch Trigger der Verarbeitung.
+Die Verarbeitung beinhaltet die Entscheidung welche Befehle ausgeführt werden sollen. Bei der Entscheidungsfindung können die in FHEM vorhandenen Größen und Werte berücksichtigt werden. Die Verküpfung erfolgt durch die vom jeweiligen [[Eventhandler]] bereitgestellten Möglichkeiten und Perlausdrücke<ref>https://perldoc.perl.org/index.html</ref>.
 ==== Ergebnis ====
-Als Ergebnis der Eventverarbeitung werden Befehle ausgeführt, die {{Link2CmdRef|Anker=command|Lang=de|Label=Befehlstypen}} sind in der {{Link2CmdRef|Anker=command|Lang=de|Label=Befehlereferenz}} beschrieben.
+Als Ergebnis der Eventverarbeitung werden Befehle ausgeführt, die {{Link2CmdRef|Anker=command|Lang=de|Label=FHEM-Befehlstypen}} sind in der {{Link2CmdRef|Anker=command|Lang=de|Label=Befehlereferenz}} beschrieben.
-* FHEM-Befehle, sie werden direkt angegben.
+* FHEM-Befehle, sie werden direkt angegben und sind in der {{Link2CmdRef|Anker=command|Lang=de|Label=Befehlereferenz}} im Abschnitt '''FHEM-Befehle''' zu finden.
 * Shellbefehle, sie werden durch doppelte Anführungszeichen <code>"<Shellbefehle>"</code> eingeschlossen.
-* Perlausdrücke, sie werden von geschweiften Klammern <code>{Perlausdrücke}</code> eingeschlossen.
+* Perlausdrücke, sie werden von geschweiften Klammern <code>{<Perlausdrücke>}</code> eingeschlossen.
 == Entwicklungssicht ==
-Aus Modulsicht sind Modulfunktionen die Hardwareereignisse oder Systemereignisse behandeln.
+Aus Modulsicht sind es Modulfunktionen, die Hardwareereignisse oder Systemereignisse behandeln.
 * [[DevelopmentModuleIntro#X_Dispatch|X_Dispatch]]
@@ Zeile 54: / Zeile 57: @@
 == Links ==
+* [[Timehandler]]
 <references />
+[[Kategorie:FHEM-Verwendung]]
 [[Kategorie:Glossary]]