Event - Versionsgeschichte

Ph1959de: Haupt-Kategorie FHEM entfernt; ist bereits über Kategoriebaum abgedeckt.

2019-12-04T11:29:10Z

Haupt-Kategorie FHEM entfernt; ist bereits über Kategoriebaum abgedeckt.

← Nächstältere Version		Version vom 4. Dezember 2019, 13:29 Uhr
Zeile 125:		Zeile 125:
	<references />		<references />

	~~[[Kategorie:FHEM]]~~
	[[Kategorie:FHEM-Verwendung]]		[[Kategorie:FHEM-Verwendung]]
	[[Kategorie:Glossary]]		[[Kategorie:Glossary]]

Ph1959de: hauptsächlich Rechtschreibung

2019-09-05T08:52:05Z

hauptsächlich Rechtschreibung

← Nächstältere Version		Version vom 5. September 2019, 10:52 Uhr
Zeile 1:		Zeile 1:
	== Definition ==		== Definition ==
	Ein [[Event]] ([[Ereignis]]) ist ~~eie unngerichtete~~ Nachricht, die vom FHEM-Server gesendet wird.		Ein [[Event]] ([[Ereignis]]) ist eine ungerichtete Nachricht, die vom FHEM-Server gesendet wird.

	Das Event enthält Informationen über den Zustand eines [[Gerät\|Gerätes]] ([[Device]]).		Das Event enthält Informationen über den Zustand eines [[Gerät\|Gerätes]] ([[Device]]).
Zeile 13:		Zeile 13:
	== Aufbau ==		== Aufbau ==
	Aufbau eines Events:		Aufbau eines Events:
	<~~pre~~><Datum> <Uhrzeit> <TYPE> <Gerätename> &lang;<Readingname>: &rang;<Wert></~~pre~~>		:<code><Datum> <Uhrzeit> <TYPE> <Gerätename> &lang;<Readingname>: &rang;<Wert></code>

	===Beispiele===		===Beispiele===
	Beispiel eines globalen Events, bei dem der Readingname fehlt:		Beispiel eines globalen Events, bei dem der Readingname fehlt:
	<~~pre~~>2016-12-13 11:40:33 Global global MODIFIED Test</~~pre~~>		:<code>2016-12-13 11:40:33 Global global MODIFIED Test</code>

	* Datum: 2016-12-13		* Datum: 2016-12-13
Zeile 27:		Zeile 27:

	Beispiel eines Geräte-Events mit Readingname:		Beispiel eines Geräte-Events mit Readingname:
	<~~pre~~>2016-12-13 11:48:26 PRESENCE LaptopAn presence: present</~~pre~~>		:<code>2016-12-13 11:48:26 PRESENCE LaptopAn presence: present</code>

	* Datum: 2016-12-13		* Datum: 2016-12-13
Zeile 37:		Zeile 37:

	== Verwendung ==		== Verwendung ==
	Events stehen allen Geräten des FHEM-Servers zur Weiterverarbeitung zur Verfügung. Sie sind ein wesentlicher Teil der [[Automatisierung]]		Events stehen allen Geräten des FHEM-Servers zur Weiterverarbeitung zur Verfügung. Sie sind ein wesentlicher Teil der [[Automatisierung]].
	Einige Gerätetypen, [[Eventhandler]] erfordern die Angabe von Ereignisfiltern in Form eines [[Regulärer_Ausdruck\|regulären Ausdrucks]]. Im Gerät werden dann nur die gefilterten Events in die Weiterverarbeitung einbezogen, das sind z.B.		Einige Gerätetypen, [[Eventhandler]], erfordern die Angabe von Ereignisfiltern in Form eines [[Regulärer_Ausdruck\|regulären Ausdrucks]]. Im Gerät werden dann nur die gefilterten Events in die Weiterverarbeitung einbezogen, das sind z.B.

	* [[DbLog]]		* [[DbLog]]
Zeile 68:		Zeile 68:
	Manchmal ist es sinnvoll, bei der [[Event#Verwendung\|Verwendung]] von Events einen [[regulärer Ausdruck\|regulären Ausdruck]] mit '''state''' zu formulieren.		Manchmal ist es sinnvoll, bei der [[Event#Verwendung\|Verwendung]] von Events einen [[regulärer Ausdruck\|regulären Ausdruck]] mit '''state''' zu formulieren.

	Die Ergänzung eines Events mit dem Reading '''state''' erfolgt in dem Gerät, das als Empfänger des Events dient; dort ist das Attribut <code>addStateEvent</code> zu setzen.		Die Ergänzung eines Events mit dem Reading '''state''' erfolgt in dem Gerät, das als Empfänger des Events dient; dort ist das Attribut <code>addStateEvent</code> zu setzen, d.h., bei gesetztem Attribut addStateEvent enthalten auch diese Events den Readingnamen und lassen sich in Eventhandlern wie Events anderer Readings behandeln.

	D.h. bei gesetztem Attribut addStateEvent enthalten auch diese Events den Readingnamen und lassen sich in Eventhandlern wie Events anderer Readings behandeln.

	===Beschränken von Events===		===Beschränken von Events===
Zeile 112:		Zeile 110:

	Sammelevents enthalten die gleiche Zeitangabe im Zeitstempel.		Sammelevents enthalten die gleiche Zeitangabe im Zeitstempel.

	==== Beispiel ====		==== Beispiel ====
	2017-03-19 14:22:31.559 I2C_BMP180 BMP180 T: 20.8 P: 998 P-NN: 999		2017-03-19 14:22:31.559 I2C_BMP180 BMP180 T: 20.8 P: 998 P-NN: 999

Trelle: /* Sammel-Events */

2018-09-18T21:55:43Z

Sammel-Events

← Nächstältere Version		Version vom 18. September 2018, 23:55 Uhr
Zeile 109:		Zeile 109:

	=== Sammel-Events ===		=== Sammel-Events ===
	Geräte können zusammenhängende Aktualisierungen von [[Readings]] sammeln und diese als ~~Sammel-Event~~ auslösen.		Geräte können zusammenhängende Aktualisierungen von [[Readings]] sammeln und diese als Sammelevent auslösen.

	Sammelevents enthalten die gleiche Zeitangabe im Zeitstempel.		Sammelevents enthalten die gleiche Zeitangabe im Zeitstempel.

Trelle: /* Links */

2018-09-18T21:52:23Z

Links

← Nächstältere Version		Version vom 18. September 2018, 23:52 Uhr
Zeile 120:		Zeile 120:
	==Links==		==Links==
	* [[Automatisierung]]		* [[Automatisierung]]
			* [[DevelopmentModuleIntro#Events]]
	* [[Event_monitor\|Eventmonitor]]		* [[Event_monitor\|Eventmonitor]]
	* [https://wiki.selfhtml.org/wiki/Perl/Regul%C3%A4re_Ausdr%C3%BCcke Reguläre Ausdrücke]		* [https://wiki.selfhtml.org/wiki/Perl/Regul%C3%A4re_Ausdr%C3%BCcke Reguläre Ausdrücke]

Ph1959de: Grammatik; Intra-Wiki Link idR nur beim ersten Auftreten

2018-09-07T17:04:18Z

Grammatik; Intra-Wiki Link idR nur beim ersten Auftreten

← Nächstältere Version		Version vom 7. September 2018, 19:04 Uhr
Zeile 1:		Zeile 1:
	== Definition ==		== Definition ==
	Ein [[Event]] ([[Ereignis]]) ist ~~eine ungerichtete~~ Nachricht, die vom FHEM-Server gesendet wird.~~<br>~~		Ein [[Event]] ([[Ereignis]]) ist eie unngerichtete Nachricht, die vom FHEM-Server gesendet wird.
	Das [[Event]] enthält Informationen über den Zustand eines [[Gerät\|Gerätes]] ([[Device]]).~~<br>~~
	Der Anstoss zum Senden eines Events geht von einem [[Gerät]] aus.~~<br>~~		Das Event enthält Informationen über den Zustand eines [[Gerät\|Gerätes]] ([[Device]]).
	Ein [[Event]] beinhaltet den Zeitpunkt der Entstehung seines Inhalts.~~<br>~~
			Der Anstoss zum Senden eines Events geht von einem Gerät aus.

			Ein Event beinhaltet den Zeitpunkt der Entstehung seines Inhalts.

	=== Sprachgebrauch ===		=== Sprachgebrauch ===
	Unter [[Event]] oder [[Ereignis]] wird oft nur der Teil <code><Gerätename> &lang;<Readingname>: &rang;<Wert></code> oder <code>&lang;<Readingname>: &rang;<Wert></code> verstanden.		Unter Event oder Ereignis wird oft nur der Teil <code><Gerätename> &lang;<Readingname>: &rang;<Wert></code> oder <code>&lang;<Readingname>: &rang;<Wert></code> verstanden.

	== Aufbau ==		== Aufbau ==
Zeile 34:		Zeile 37:

	== Verwendung ==		== Verwendung ==
	Events stehen allen ~~[[Gerät\|~~Geräten]] des FHEM-Servers zur Weiterverarbeitung zur Verfügung. Sie sind ein wesentlicher Teil der [[Automatisierung]]		Events stehen allen Geräten des FHEM-Servers zur Weiterverarbeitung zur Verfügung. Sie sind ein wesentlicher Teil der [[Automatisierung]]
	Einige Gerätetypen, [[Eventhandler]] erfordern die Angabe von Ereignisfiltern in Form eines [[Regulärer_Ausdruck\|regulären Ausdrucks]]. Im [[Gerät]] werden dann nur die gefilterten Events in die Weiterverarbeitung einbezogen, das sind z.B.		Einige Gerätetypen, [[Eventhandler]] erfordern die Angabe von Ereignisfiltern in Form eines [[Regulärer_Ausdruck\|regulären Ausdrucks]]. Im Gerät werden dann nur die gefilterten Events in die Weiterverarbeitung einbezogen, das sind z.B.

	* [[DbLog]]		* [[DbLog]]
Zeile 41:		Zeile 44:
	* [[FileLog]]		* [[FileLog]]
	* [[notify]]		* [[notify]]
	* [[sequence]]		* sequence
	* [[watchdog]]		* [[watchdog]]

	Zur Erstellung eines ~~Ereignisfilter~~ ist die genaue Kenntnis über den Inhalt eines Events erforderlich.		Zur Erstellung eines Ereignisfilters ist die genaue Kenntnis über den Inhalt eines Events erforderlich.
	Die aktuellen Ereignisse können im '''[[Event_monitor\|Eventmonitor]]''' oder mit '''[[inform]]'''<ref>https://fhem.de/commandref_DE.html#inform</ref> über einen [[Telnet]]-Client angezeigt werden.		Die aktuellen Ereignisse können im '''[[Event_monitor\|Eventmonitor]]''' oder mit '''inform'''<ref>https://fhem.de/commandref_DE.html#inform</ref> über einen [[Telnet]]-Client angezeigt werden.
	Der Befehl '''[[Trigger\|trigger]]'''<ref>https://fhem.de/commandref_DE.html#trigger</ref> simuliert den Anstoss eines Gerätes an den FHEM-Server ein Event zu senden.		Der Befehl '''[[Trigger\|trigger]]'''<ref>https://fhem.de/commandref_DE.html#trigger</ref> simuliert den Anstoss eines Gerätes, an den FHEM-Server ein Event zu senden.

	==Besonderheiten==		==Besonderheiten==
	===Events des Reading '''state'''===		===Events des Reading '''state'''===
	Wenn ein [[Gerät]] ein Event für das [[Readings\|Reading]] '''state''' generiert, dann wird der Readingname weggelassen.		Wenn ein Gerät ein Event für das [[Readings\|Reading]] '''state''' generiert, dann wird der Readingname weggelassen.

	====Beispiel====		====Beispiel====
	<pre>2016-12-13 11:48:26 PRESENCE LaptopAn present</pre>		<pre>2016-12-13 11:48:26 PRESENCE LaptopAn present</pre>
Zeile 62:		Zeile 66:

	===Ergänzen des Reading '''state''' im Event===		===Ergänzen des Reading '''state''' im Event===
	Manchmal ist es sinnvoll bei der [[Event#Verwendung\|Verwendung]] von Events einen [[regulärer Ausdruck\|regulären Ausdruck]] mit '''state''' zu formulieren.		Manchmal ist es sinnvoll, bei der [[Event#Verwendung\|Verwendung]] von Events einen [[regulärer Ausdruck\|regulären Ausdruck]] mit '''state''' zu formulieren.

	Die Ergänzung eines Events mit dem Reading '''state''' erfolgt in dem [[Gerät]], das als Empfänger des Events dient, dort ist das Attribut <code>addStateEvent</code> zu setzen.		Die Ergänzung eines Events mit dem Reading '''state''' erfolgt in dem Gerät, das als Empfänger des Events dient; dort ist das Attribut <code>addStateEvent</code> zu setzen.

	D.h. bei gesetztem Attribut addStateEvent enthalten auch diese Events den Readingnamen und lassen sich in ~~[[Eventhandler\|~~Eventhandlern]] wie Events anderer Readings behandeln.		D.h. bei gesetztem Attribut addStateEvent enthalten auch diese Events den Readingnamen und lassen sich in Eventhandlern wie Events anderer Readings behandeln.

	===Beschränken von Events===		===Beschränken von Events===
Zeile 78:		Zeile 82:
	* [[event-aggregator]]		* [[event-aggregator]]
	DbLog:		DbLog:
	* [[cacheEvents]]		* cacheEvents
	* [[syncEvents]]		* syncEvents

	Das Modul [[DOIFtools]] bietet die Möglichkeit eine Eventstatistik zu erstellen, als Grundlage zur Optimierung des ~~Eventaufkommen~~.		Das Modul [[DOIFtools]] bietet die Möglichkeit eine Eventstatistik zu erstellen, als Grundlage zur Optimierung des Eventaufkommens.

	===Erweiterung des angezeigten Zeitstempels um Milisekunden===		===Erweiterung des angezeigten Zeitstempels um Milisekunden===
	Die Anzeige des Zeitstempels kann auf Millisekunden erweitert werden, wenn das globale Attribut '''mseclog''' auf '''1''' gesetzt wird.		Die Anzeige des Zeitstempels kann auf Millisekunden erweitert werden, wenn das globale Attribut '''mseclog''' auf '''1''' gesetzt wird.

	====Beispiel====		====Beispiel====
	<pre>2016-12-13 11:48:26.836 PRESENCE LaptopAn present</pre>		<pre>2016-12-13 11:48:26.836 PRESENCE LaptopAn present</pre>
Zeile 96:		Zeile 101:

	=== Einzelevents ===		=== Einzelevents ===
	~~[[Gerät\|~~Geräte]] können für jede Aktualisierung jedes [[Readings]] ein [[Event]] auslösen. In diesem Fall handelt es sich um Einzel-Events.		Geräte können für jede Aktualisierung jedes [[Readings]] ein Event auslösen. In diesem Fall handelt es sich um Einzel-Events.

	Sie können an den unterschiedlichen Zeiten im Zeitstempel erkannt werden.		Sie können an den unterschiedlichen Zeiten im Zeitstempel erkannt werden.
Zeile 104:		Zeile 109:

	=== Sammel-Events ===		=== Sammel-Events ===
	~~[[Gerät\|~~Geräte]] können zusammenhängende Aktualisierungen von [[Readings]] sammeln und diese als Sammel-Event auslösen.		Geräte können zusammenhängende Aktualisierungen von [[Readings]] sammeln und diese als Sammel-Event auslösen.

	Sammelevents enthalten die gleiche Zeitangabe im Zeitstempel.		Sammelevents enthalten die gleiche Zeitangabe im Zeitstempel.

Trelle: /* Sammel-Events */

2018-09-07T15:47:39Z

Sammel-Events

← Nächstältere Version		Version vom 7. September 2018, 17:47 Uhr
Zeile 106:		Zeile 106:
	[[Gerät\|Geräte]] können zusammenhängende Aktualisierungen von [[Readings]] sammeln und diese als Sammel-Event auslösen.		[[Gerät\|Geräte]] können zusammenhängende Aktualisierungen von [[Readings]] sammeln und diese als Sammel-Event auslösen.

	~~Sammel- Events~~ enthalten die gleiche Zeitangabe im Zeitstempel.		Sammelevents enthalten die gleiche Zeitangabe im Zeitstempel.
	==== Beispiel ====		==== Beispiel ====
	2017-03-19 14:22:31.559 I2C_BMP180 BMP180 T: 20.8 P: 998 P-NN: 999		2017-03-19 14:22:31.559 I2C_BMP180 BMP180 T: 20.8 P: 998 P-NN: 999

Trelle: /* Einzel-Events */

2018-09-07T15:47:14Z

Einzel-Events

← Nächstältere Version		Version vom 7. September 2018, 17:47 Uhr
Zeile 95:		Zeile 95:
	* Wert: present		* Wert: present

	=== ~~Einzel-Events~~ ===		=== Einzelevents ===
	[[Gerät\|Geräte]] können für jede Aktualisierung jedes [[Readings]] ein [[Event]] auslösen. In diesem Fall handelt es sich um Einzel-Events.		[[Gerät\|Geräte]] können für jede Aktualisierung jedes [[Readings]] ein [[Event]] auslösen. In diesem Fall handelt es sich um Einzel-Events.

Trelle: /* Beschränken von Events */

2018-09-07T15:45:38Z

Beschränken von Events

← Nächstältere Version		Version vom 7. September 2018, 17:45 Uhr
Zeile 81:		Zeile 81:
	* [[syncEvents]]		* [[syncEvents]]

	Das Modul [[DOIFtools]] bietet die Möglichkeit eine ~~Event-Statistik~~ zu erstellen, als Grundlage zur Optimierung des ~~Event-Aufkommens~~.		Das Modul [[DOIFtools]] bietet die Möglichkeit eine Eventstatistik zu erstellen, als Grundlage zur Optimierung des Eventaufkommen.

	===Erweiterung des angezeigten Zeitstempels um Milisekunden===		===Erweiterung des angezeigten Zeitstempels um Milisekunden===

Trelle: /* Links */

2018-08-15T17:36:47Z

Links

← Nächstältere Version		Version vom 15. August 2018, 19:36 Uhr
Zeile 114:		Zeile 114:

	==Links==		==Links==
			* [[Automatisierung]]
	* [[Event_monitor\|Eventmonitor]]		* [[Event_monitor\|Eventmonitor]]
	* [https://wiki.selfhtml.org/wiki/Perl/Regul%C3%A4re_Ausdr%C3%BCcke Reguläre Ausdrücke]		* [https://wiki.selfhtml.org/wiki/Perl/Regul%C3%A4re_Ausdr%C3%BCcke Reguläre Ausdrücke]

Trelle: /* Verwendung */

2018-08-15T17:35:12Z

Verwendung

← Nächstältere Version		Version vom 15. August 2018, 19:35 Uhr
Zeile 34:		Zeile 34:

	== Verwendung ==		== Verwendung ==
	Events stehen allen [[Gerät\|Geräten]] des FHEM-Servers zur Weiterverarbeitung zur Verfügung.		Events stehen allen [[Gerät\|Geräten]] des FHEM-Servers zur Weiterverarbeitung zur Verfügung. Sie sind ein wesentlicher Teil der [[Automatisierung]]
	Einige Gerätetypen, [[Eventhandler]] erfordern die Angabe von Ereignisfiltern in Form eines [[Regulärer_Ausdruck\|regulären Ausdrucks]]. Im [[Gerät]] werden dann nur die gefilterten Events in die Weiterverarbeitung einbezogen, das sind z.B.		Einige Gerätetypen, [[Eventhandler]] erfordern die Angabe von Ereignisfiltern in Form eines [[Regulärer_Ausdruck\|regulären Ausdrucks]]. Im [[Gerät]] werden dann nur die gefilterten Events in die Weiterverarbeitung einbezogen, das sind z.B.