Event-on-change-reading - Versionsgeschichte

AlanBlack: /* Beispiel */

2022-02-05T18:33:05Z

Beispiel

← Nächstältere Version		Version vom 5. Februar 2022, 20:33 Uhr
Zeile 56:		Zeile 56:

	Achtung: dies löst wie oben beschrieben ggf. Konstrukte wie <code><nowiki>… notify GeraetXXXX:wert …</nowiki></code> aus.		Achtung: dies löst wie oben beschrieben ggf. Konstrukte wie <code><nowiki>… notify GeraetXXXX:wert …</nowiki></code> aus.

			Falls ein Reading namens "unwanted" KEINE Events erzeugen soll, lässt sich das mit
			:<code><nowiki>attr <device> event-on-change-reading (?!unwanted).*</nowiki></code>
			unterdrücken.

			Wenn KEIN Event bei einem Gerät erzeugt werden soll, lässt sich das mit
			:<code><nowiki>attr <device> event-on-change-reading $</nowiki></code>
			erreichen.

	Um ein Threshold für nur ein Reading zu setzen:		Um ein Threshold für nur ein Reading zu setzen:

Ph1959de: diverse Kleinigkeiten

2021-01-16T11:13:49Z

diverse Kleinigkeiten

Cwagner: Entfernung der nachfolgenden Leerzeichen in Listenaufzählungen des Attributes gem. dieser Diskussion: https://forum.fhem.de/index.php?topic=60557.0

2021-01-15T16:10:56Z

Entfernung der nachfolgenden Leerzeichen in Listenaufzählungen des Attributes gem. dieser Diskussion: https://forum.fhem.de/index.php?topic=60557.0

Soulman: Ergänzungen von Beispielen

2021-01-03T18:47:15Z

Ergänzungen von Beispielen

← Nächstältere Version		Version vom 3. Januar 2021, 20:47 Uhr
Zeile 48:		Zeile 48:


	== ~~Praktische Anwendung~~ ==		== Beispiel ==
	In einer einfachen Anwendung kann, um alle Readings eines Gerätes nur bei Änderungen zu verarbeiten, das Attribut folgendermaßen gesetzt werden:		In einer einfachen Anwendung kann, um alle Readings eines Gerätes nur bei Änderungen zu verarbeiten, das Attribut folgendermaßen gesetzt werden:
	:<code><nowiki>attr <device> event-on-change-reading .*</nowiki></code>		:<code><nowiki>attr <device> event-on-change-reading .*</nowiki></code>
Zeile 58:		Zeile 58:

	Achtung: dies löst wie oben beschrieben ggf. Konstrukte wie <code><nowiki>… notify GeraetXXXX:wert …</nowiki></code> aus.		Achtung: dies löst wie oben beschrieben ggf. Konstrukte wie <code><nowiki>… notify GeraetXXXX:wert …</nowiki></code> aus.

			Um ein Threshold für nur eine Reading zu setzen:
			:<code><nowiki>attr <device> <device> event-on-change-reading Temp.:0.4 ,.</nowiki></code>
			Alle Readings, die mit Temp beginnen, erzeugen nur ein Event, wenn die Änderung >0.4 Grad ist. Alle anderen Readings erzeugen bei jeder Änderung ein Event.

			Nur ein Reading mit Threshold berücksichtigen:
			:<code><nowiki>attr <device> <device> event-on-change-reading Temp.*:0.4</nowiki></code>
			Alle Readings, die mit Temp beginnen, erzeugen nur ein Event, wenn die Änderung >0.4 Grad ist. Alle anderen Readings erzeugen keine Event, auch nicht bei Werteänderung.


	Mit [[event-on-update-reading]] und [[event-min-interval]] kann das Verhalten verfeinert werden.		Mit [[event-on-update-reading]] und [[event-min-interval]] kann das Verhalten verfeinert werden.

Soulman: ich habe Versucht den Artikel so umzuschreiben, das ICH ihn beim ersten Lesen verstanden hätte

2021-01-03T17:46:34Z

ich habe Versucht den Artikel so umzuschreiben, das ICH ihn beim ersten Lesen verstanden hätte

Änderungen zeigen

Ph1959de: noch'n Typo - aber eigentlich sollte der Satz aus dem Abschnitt Syntax wieder raus, da ohnehin schon (besser) unter "Beispiele" abgehandelt.

2020-12-27T11:59:05Z

noch'n Typo - aber eigentlich sollte der Satz aus dem Abschnitt Syntax wieder raus, da ohnehin schon (besser) unter "Beispiele" abgehandelt.

← Nächstältere Version		Version vom 27. Dezember 2020, 13:59 Uhr
Zeile 10:		Zeile 10:
	Die zu berücksichtigenden Readings sind als durch Komma getrennte Werte anzugeben, können aber auch über reguläre Ausdrücke zusammengefasst werden.		Die zu berücksichtigenden Readings sind als durch Komma getrennte Werte anzugeben, können aber auch über reguläre Ausdrücke zusammengefasst werden.

	~~Insbsondere~~ sinnvoll ist		Insbesondere sinnvoll ist
	<code><nowiki>event-on-change-reading .*</nowiki></code> Dies führt dazu, ~~das~~ alle Readings noch Events erzeugen, aber nur wenn diese sich im Wert ändern.		<code><nowiki>event-on-change-reading .*</nowiki></code> Dies führt dazu, dass alle Readings noch Events erzeugen, aber nur wenn diese sich im Wert ändern.

	== Wechselwirkungen ==		== Wechselwirkungen ==

Soulman: /* Syntax */ typo

2020-12-26T21:33:36Z

Syntax: typo

← Nächstältere Version		Version vom 26. Dezember 2020, 23:33 Uhr
Zeile 9:		Zeile 9:
	:<code><nowiki>attr <device> event-on-change-reading reading1[:threshold][,reading2[:threshold]...n]</nowiki></code>		:<code><nowiki>attr <device> event-on-change-reading reading1[:threshold][,reading2[:threshold]...n]</nowiki></code>
	Die zu berücksichtigenden Readings sind als durch Komma getrennte Werte anzugeben, können aber auch über reguläre Ausdrücke zusammengefasst werden.		Die zu berücksichtigenden Readings sind als durch Komma getrennte Werte anzugeben, können aber auch über reguläre Ausdrücke zusammengefasst werden.
	~~Insbsonder~~ sinnvoll ist
			Insbsondere sinnvoll ist
	<code><nowiki>event-on-change-reading .*</nowiki></code> Dies führt dazu, das alle Readings noch Events erzeugen, aber nur wenn diese sich im Wert ändern.		<code><nowiki>event-on-change-reading .*</nowiki></code> Dies führt dazu, das alle Readings noch Events erzeugen, aber nur wenn diese sich im Wert ändern.

Soulman: /* Syntax */

2020-12-26T21:33:14Z

Syntax

← Nächstältere Version		Version vom 26. Dezember 2020, 23:33 Uhr
Zeile 9:		Zeile 9:
	:<code><nowiki>attr <device> event-on-change-reading reading1[:threshold][,reading2[:threshold]...n]</nowiki></code>		:<code><nowiki>attr <device> event-on-change-reading reading1[:threshold][,reading2[:threshold]...n]</nowiki></code>
	Die zu berücksichtigenden Readings sind als durch Komma getrennte Werte anzugeben, können aber auch über reguläre Ausdrücke zusammengefasst werden.		Die zu berücksichtigenden Readings sind als durch Komma getrennte Werte anzugeben, können aber auch über reguläre Ausdrücke zusammengefasst werden.
			Insbsonder sinnvoll ist
			<code><nowiki>event-on-change-reading .*</nowiki></code> Dies führt dazu, das alle Readings noch Events erzeugen, aber nur wenn diese sich im Wert ändern.

	== Wechselwirkungen ==		== Wechselwirkungen ==

Beta-User: timestamp-on-change-reading und shelly1pm-Beispiel eingefügt

2020-07-01T15:43:32Z

timestamp-on-change-reading und shelly1pm-Beispiel eingefügt

@@ Zeile 11: / Zeile 11: @@
 == Wechselwirkungen ==
-Dieses Attribut steht in Wechselwirkung mit den Attributen [[event-on-update-reading]] und [[event-min-interval]], bitte also unbedingt auch deren Beschreibung berücksichtigen!
+Dieses Attribut steht in Wechselwirkung mit den Attributen ''timestamp-on-change-reading'' [[event-on-update-reading]] und [[event-min-interval]], bitte also unbedingt auch deren Beschreibung berücksichtigen!
 Sind bei einem Device weder ''event-on-change-reading'' noch ''event-on-update-reading'' spezifiziert, werden für alle Readings sowohl bei Änderung als auch bei der Aktualisierung (mit dem gleichen Wert) Events erzeugt. Sobald jedoch eines der beiden Attribute gesetzt ist, müssen alle Readings, die protokolliert werden sollen bei (mindestens) einem der Attribute berücksichtigt sein.
@@ Zeile 24: / Zeile 24: @@
 In der Regel ist es sinnvoll, ''event-on-change-reading'' mit ''min-interval'' zu kombinieren, ''min-interval'' deshalb, damit von Zeit zu Zeit Einträge in das Logfile geschrieben werden (findet FHEM zu wenige Ereignisse pro betrachteter Zeitspanne, bleibt das Diagramm leer oder wird nur teilweise gezeichnet (Plotabriss)).
 == Beispiele ==
 Um alle Readings eines Gerätes nur bei Änderungen zu protokollieren, sollte das Attribut folgendermaßen gesetzt werden:
 :<code><nowiki>attr <device> event-on-change-reading .*</nowiki></code>
 == Siehe auch ==

Markusbloch: Baustelle entfernt

2018-01-20T14:24:05Z

Baustelle entfernt

← Nächstältere Version		Version vom 20. Januar 2018, 16:24 Uhr
Zeile 1:		Zeile 1:
	{{SEITENTITEL:event-on-change-reading}} <!-- da richtige Schreibweise kleinen Anfangsbuchstaben hat -->		{{SEITENTITEL:event-on-change-reading}} <!-- da richtige Schreibweise kleinen Anfangsbuchstaben hat -->
	<!-- Infobox Attribut sinnvoll? -->		<!-- Infobox Attribut sinnvoll? -->
	~~{{Baustelle}}~~
	Mit dem Attribut [[event-on-change-reading]] kann für Readings eines Gerätes festgelegt werden, dass nur bei einer Wertänderung ein Event (und damit in der Regel auch ein Log-Eintrag) erzeugt werden soll. Damit stellt das Attribut eine Möglichkeit zur Verfügung, die Menge von Log-Einträgen zu reduzieren.		Mit dem Attribut [[event-on-change-reading]] kann für Readings eines Gerätes festgelegt werden, dass nur bei einer Wertänderung ein Event (und damit in der Regel auch ein Log-Eintrag) erzeugt werden soll. Damit stellt das Attribut eine Möglichkeit zur Verfügung, die Menge von Log-Einträgen zu reduzieren.

← Nächstältere Version		Version vom 16. Januar 2021, 13:13 Uhr
Zeile 29:		Zeile 29:

	Insbesondere sinnvoll ist der reguläre Ausdruck .* , der alle Readings umfasst:		Insbesondere sinnvoll ist der reguläre Ausdruck .* , der alle Readings umfasst:
	:<code><nowiki>attr <device>~~<nowiki>~~event-on-change-reading .*</nowiki></code>		:<code><nowiki>attr <device> event-on-change-reading .*</nowiki></code>
	So formuliert führt das Attribut dazu, dass alle Readings noch Events erzeugen, aber nur wenn diese sich im Wert ändern.		So formuliert führt das Attribut dazu, dass alle Readings noch Events erzeugen, aber nur wenn diese sich im Wert ändern.

	Mit Threshold ist optional ein Wert ~~angegebbar~~, um den das "neue" Reading größer oder kleiner sein soll als das vorherige, um ein Event auszulösen. So löst		Mit Threshold ist optional ein Wert angebbar, um den das "neue" Reading größer oder kleiner sein soll als das vorherige, um ein Event auszulösen. So löst
	:<code>attr event-on-change-reading temperature:0.4,humidity:2 </code>		:<code>attr event-on-change-reading temperature:0.4,humidity:2 </code>
	nur bei Änderungen der Temperatur um mindestens 0,4 Grad oder Änderung der Luftfeuchtigkeit von 2 % ein Event aus (und damit einen Eintrag ins Logfile). Threshold ist besonders sinnvoll bei sehr fein auflösenden Sensoren, um z.b. zu verhindern, ~~das~~ jede Temperaturschwankung um 0,1 Grad ein Event auslöst.		nur bei Änderungen der Temperatur um mindestens 0,4 Grad oder Änderung der Luftfeuchtigkeit von 2 % ein Event aus (und damit einen Eintrag ins Logfile). Threshold ist besonders sinnvoll bei sehr fein auflösenden Sensoren, um z.B. zu verhindern, dass jede Temperaturschwankung um 0,1 Grad ein Event auslöst.


	== Wechselwirkungen ==		== Wechselwirkungen ==
	Wie oben erwähnt steht das Attribut in Wechselwirkung mit den Attributen ''timestamp-on-change-reading'' [[event-on-update-reading]] und [[event-min-interval]], die das Verhalten modifizieren. Dies ist beim Einsatz zu berücksichtigen.		Wie oben erwähnt, steht das Attribut in Wechselwirkung mit den Attributen ''timestamp-on-change-reading'' [[event-on-update-reading]] und [[event-min-interval]], die das Verhalten modifizieren. Dies ist beim Einsatz zu berücksichtigen.

	Sind bei einem Device weder ''event-on-change-reading'' noch ''event-on-update-reading'' spezifiziert, werden für alle Readings sowohl bei Änderung als auch bei der Aktualisierung (Update mit dem gleichen Wert) Events erzeugt (Default Verhalten). Sobald jedoch eines der beiden Attribute gesetzt ist, müssen alle Readings, die protokolliert werden sollen bei (mindestens) einem der Attribute berücksichtigt sein.		Sind bei einem Device weder ''event-on-change-reading'' noch ''event-on-update-reading'' spezifiziert, werden für alle Readings sowohl bei Änderung als auch bei der Aktualisierung (Update mit dem gleichen Wert) Events erzeugt (Default Verhalten). Sobald jedoch eines der beiden Attribute gesetzt ist, müssen alle Readings, die protokolliert werden sollen, bei (mindestens) einem der Attribute berücksichtigt sein.

	Ist für ein Reading sowohl ''event-on-change-reading'' als auch ''event-on-update-reading'' spezifiziert, wird bei jeder Aktualisierung des Readings ein Event erzeugt, das ''event-on-change'' wird für dieses Reading also außer Kraft gesetzt bzw. "überstimmt".		Ist für ein Reading sowohl ''event-on-change-reading'' als auch ''event-on-update-reading'' spezifiziert, wird bei jeder Aktualisierung des Readings ein Event erzeugt, das ''event-on-change'' wird für dieses Reading also außer Kraft gesetzt bzw. "überstimmt".


	== timestamp-on-change-reading ==		== timestamp-on-change-reading ==
	Ist nur event-on-change-reading für ein Reading spezifiziert, entfällt zunächst einmal nur der Trigger, der Zeitstempel wird weiter aktualisiert. Benötigt man jedoch den Zeitstempel der letzten Änderung (z.B. die Ein- oder Ausschaltzeit eines Relais), kann man mithilfe von ''timestamp-on-change-reading'' auch die Aktualisierung des Zeitstempels unterbinden, falls der Wert sich nicht geändert hat.		Ist nur event-on-change-reading für ein Reading spezifiziert, entfällt zunächst einmal nur der Trigger, der Zeitstempel wird weiter aktualisiert. Benötigt man jedoch den Zeitstempel der letzten Änderung (z.B. die Ein- oder Ausschaltzeit eines Relais), kann man mithilfe von ''timestamp-on-change-reading'' auch die Aktualisierung des Zeitstempels unterbinden, falls der Wert sich nicht geändert hat.


	== Beispiel ==		== Beispiel ==
Zeile 56:		Zeile 53:
	dafür gesorgt werden, dass jede Stunde auch ohne Werteänderung die Readings dennoch verarbeitet werden, also in z.b. in das Logfile geschrieben werden (findet FHEM zu wenige Ereignisse pro betrachteter Zeitspanne, bleiben Graphen leer oder werden nur teilweise gezeichnet (Plotabriss)).		dafür gesorgt werden, dass jede Stunde auch ohne Werteänderung die Readings dennoch verarbeitet werden, also in z.b. in das Logfile geschrieben werden (findet FHEM zu wenige Ereignisse pro betrachteter Zeitspanne, bleiben Graphen leer oder werden nur teilweise gezeichnet (Plotabriss)).

	Das obige Kombination der Attribute führt also dazu, dass ein Event ~~wird~~ erzeugt wird, wenn der neue Wert wirklich abweichend vom alten Wert ist '''oder''' mindestens ''min-interval'' Sekunden seit dem letzten Event vergangen sind.		Das obige Kombination der Attribute führt also dazu, dass ein Event erzeugt wird, wenn der neue Wert wirklich abweichend vom alten Wert ist '''oder''' mindestens ''min-interval'' Sekunden seit dem letzten Event vergangen sind.

	Achtung: dies löst wie oben beschrieben ggf. Konstrukte wie <code><nowiki>… notify GeraetXXXX:wert …</nowiki></code> aus.		Achtung: dies löst wie oben beschrieben ggf. Konstrukte wie <code><nowiki>… notify GeraetXXXX:wert …</nowiki></code> aus.

	Um ein Threshold für nur ~~eine~~ Reading zu setzen:		Um ein Threshold für nur ein Reading zu setzen:
	:<code>attr ~~<device>~~ <device> event-on-change-reading Temp.:0.4,.</code>		:<code>attr <device> event-on-change-reading Temp.:0.4,.</code>
	Alle Readings, die mit Temp beginnen, erzeugen nur ein Event, wenn die Änderung >0.4 Grad ist. Alle anderen Readings erzeugen bei jeder Änderung ein Event.		Alle Readings, die mit Temp beginnen, erzeugen nur ein Event, wenn die Änderung >0.4 Grad ist. Alle anderen Readings erzeugen bei jeder Änderung ein Event.

	Nur ein Reading mit Threshold berücksichtigen:		Nur ein Reading mit Threshold berücksichtigen:
	:<code><nowiki>attr ~~<device>~~ <device> event-on-change-reading Temp.*:0.4</nowiki></code>		:<code><nowiki>attr <device> event-on-change-reading Temp.*:0.4</nowiki></code>
	Alle Readings, die mit Temp beginnen, erzeugen nur ein Event, wenn die Änderung >0.4 Grad ist. Alle anderen Readings erzeugen keine Event, auch nicht bei Werteänderung.		Alle Readings, die mit Temp beginnen, erzeugen nur ein Event, wenn die Änderung >0.4 Grad ist. Alle anderen Readings erzeugen keine Event, auch nicht bei Werteänderung.


	Mit [[event-on-update-reading]] und [[event-min-interval]] kann das Verhalten verfeinert werden.		Mit [[event-on-update-reading]] und [[event-min-interval]] kann das Verhalten verfeinert werden.


	== Siehe auch ==		== Siehe auch ==
Zeile 77:		Zeile 72:
	*[[event-min-interval]]		*[[event-min-interval]]
	*[[event-aggregator]]		*[[event-aggregator]]

	~~== Links ==~~
	* Benutzungstipps (''Best Practice'') für das Attribut in {{Link2Forum\|Topic=36522\|LinkText=diesem Forenthread}}		* Benutzungstipps (''Best Practice'') für das Attribut in {{Link2Forum\|Topic=36522\|LinkText=diesem Forenthread}}

	[[Kategorie:Attribut (allgemeingültig)]]		[[Kategorie:Attribut (allgemeingültig)]]

← Nächstältere Version		Version vom 15. Januar 2021, 18:10 Uhr
Zeile 1:		Zeile 1:
	{{SEITENTITEL:event-on-change-reading}} <!-- da richtige Schreibweise kleinen Anfangsbuchstaben hat -->		{{SEITENTITEL:event-on-change-reading}} <!-- da richtige Schreibweise kleinen Anfangsbuchstaben hat -->
	<!-- Infobox Attribut sinnvoll? -->		<!-- Infobox Attribut sinnvoll? -->

	Mit dem Attribut [[event-on-change-reading]] kann für Readings eines Gerätes festgelegt werden, dass nur bei einer Wertänderung ein Event (und damit in der Regel auch ein Log-Eintrag) erzeugt werden soll und nicht bei jedem turnusmäßigen Update des Gerätes.		Mit dem Attribut [[event-on-change-reading]] kann für Readings eines Gerätes festgelegt werden, dass nur bei einer Wertänderung ein Event (und damit in der Regel auch ein Log-Eintrag) erzeugt werden soll und nicht bei jedem turnusmäßigen Update des Gerätes.

Zeile 28:		Zeile 29:

	Insbesondere sinnvoll ist der reguläre Ausdruck .* , der alle Readings umfasst:		Insbesondere sinnvoll ist der reguläre Ausdruck .* , der alle Readings umfasst:
	:<code><nowiki>attr <device><nowiki>event-on-change-reading .*</nowiki></code>		:<code><nowiki>attr <device><nowiki>event-on-change-reading .*</nowiki></code>
	So formuliert führt das Attribut dazu, dass alle Readings noch Events erzeugen, aber nur wenn diese sich im Wert ändern.		So formuliert führt das Attribut dazu, dass alle Readings noch Events erzeugen, aber nur wenn diese sich im Wert ändern.

	Mit Threshold ist optional ein Wert angegebbar, um den das "neue" Reading größer oder kleiner sein soll als das vorherige, um ein Event auszulösen. So löst		Mit Threshold ist optional ein Wert angegebbar, um den das "neue" Reading größer oder kleiner sein soll als das vorherige, um ein Event auszulösen. So löst
	:<code~~><nowiki~~>attr event-on-change-reading temperature:0.4, humidity:2 ~~</nowiki>~~</code>		:<code>attr event-on-change-reading temperature:0.4,humidity:2 </code>
	nur bei Änderungen der Temperatur um mindestens 0,4 Grad oder Änderung der Luftfeuchtigkeit von 2 % ein Event aus (und damit einen Eintrag ins Logfile). Threshold ist besonders sinnvoll bei sehr fein auflösenden Sensoren, um z.b. zu verhindern, das jede Temperaturschwankung um 0,1 Grad ein Event auslöst.		nur bei Änderungen der Temperatur um mindestens 0,4 Grad oder Änderung der Luftfeuchtigkeit von 2 % ein Event aus (und damit einen Eintrag ins Logfile). Threshold ist besonders sinnvoll bei sehr fein auflösenden Sensoren, um z.b. zu verhindern, das jede Temperaturschwankung um 0,1 Grad ein Event auslöst.

Zeile 60:		Zeile 61:

	Um ein Threshold für nur eine Reading zu setzen:		Um ein Threshold für nur eine Reading zu setzen:
	:<code~~><nowiki~~>attr <device> <device> event-on-change-reading Temp.:0.4 ,.~~</nowiki>~~</code>		:<code>attr <device> <device> event-on-change-reading Temp.:0.4,.</code>
	Alle Readings, die mit Temp beginnen, erzeugen nur ein Event, wenn die Änderung >0.4 Grad ist. Alle anderen Readings erzeugen bei jeder Änderung ein Event.		Alle Readings, die mit Temp beginnen, erzeugen nur ein Event, wenn die Änderung >0.4 Grad ist. Alle anderen Readings erzeugen bei jeder Änderung ein Event.