ReadingsGroup - Versionsgeschichte

Justme: Änderung 31300 von FExplorer (Diskussion) rückgängig gemacht. ° ist korrekt wenn man nicht mit utf-8 arbeitet.

2019-10-03T21:32:18Z

Änderung 31300 von FExplorer (Diskussion) rückgängig gemacht. ° ist korrekt wenn man nicht mit utf-8 arbeitet.

← Nächstältere Version		Version vom 3. Oktober 2019, 23:32 Uhr
Zeile 147:		Zeile 147:
	\| rowspan=3 \| [[Datei:rgWetter.png\|thumb]]		\| rowspan=3 \| [[Datei:rgWetter.png\|thumb]]
	\|-		\|-
	\| <code>attr Wetter valueFormat { temperature => '%1.f °C', humidity => '%1.f %%', pressure => '%i mbar' }</code>		\| <code>attr Wetter valueFormat { temperature => '%1.f &deg;C', humidity => '%1.f %%', pressure => '%i mbar' }</code>
	\| Die Formatierung der Readingswerte		\| Die Formatierung der Readingswerte
	\|-		\|-

FExplorer: Fehlerhafte html entity korrigiert, muss möglicherweise auf der gesamten Seite auch an anderen Stellen erfolgen, hier nur weil ich es selbst in eigener fhem config habe

2019-10-03T16:40:07Z

Fehlerhafte html entity korrigiert, muss möglicherweise auf der gesamten Seite auch an anderen Stellen erfolgen, hier nur weil ich es selbst in eigener fhem config habe

← Nächstältere Version		Version vom 3. Oktober 2019, 18:40 Uhr
Zeile 147:		Zeile 147:
	\| rowspan=3 \| [[Datei:rgWetter.png\|thumb]]		\| rowspan=3 \| [[Datei:rgWetter.png\|thumb]]
	\|-		\|-
	\| <code>attr Wetter valueFormat { temperature => '%1.f &~~amp;~~deg;C', humidity => '%1.f %%', pressure => '%i mbar' }</code>		\| <code>attr Wetter valueFormat { temperature => '%1.f °C', humidity => '%1.f %%', pressure => '%i mbar' }</code>
	\| Die Formatierung der Readingswerte		\| Die Formatierung der Readingswerte
	\|-		\|-

AndreasMohr: Typos/Spelling

2018-08-14T20:49:09Z

Typos/Spelling

Änderungen zeigen

Baumbuwe: Vorlage Link2CmdRef

2018-01-31T13:02:42Z

Vorlage Link2CmdRef

← Nächstältere Version		Version vom 31. Januar 2018, 15:02 Uhr
Zeile 13:		Zeile 13:

	== Definition ==		== Definition ==
	Siehe ~~[http://fhem.de/commandref.html#~~readingsGroup ~~commandref]~~.		Siehe {{Link2CmdRef\|Anker=readingsGroup}}.

	== Attribute ==		== Attribute ==
Zeile 19:		Zeile 19:
	Weitergehende Erläuterungen zu einzelnen Attributen.		Weitergehende Erläuterungen zu einzelnen Attributen.

	Die komplette Liste der Attribute ist der ~~commandref~~ zu entnehmen.		Die komplette Liste der Attribute ist der {{Link2CmdRef}} zu entnehmen.

	=== noheading ===		=== noheading ===
Zeile 41:		Zeile 41:
	mapping wird verwendet um Elemente einer Zeile auszutauschen, bspw. um		mapping wird verwendet um Elemente einer Zeile auszutauschen, bspw. um
	* den Zeilentitel gegen den Raumnamen auszutauschen (zB. [[ReadingsGroup#Einfache Auswahl über Reading-Namen\|einfach]], [[ReadingsGroup#Schriftgrößen, Farben, Icons\|doppelt]], [[ReadingsGroup#Reading-Werte zuordnen (Icon / Text)\|erweitert]], [[ReadingsGroup#Heizungsteuerung für HM Wand- und Heizkörperthermostate\|noch mehr]], [[ReadingsGroup#Enigma Receiver\|leer]])		* den Zeilentitel gegen den Raumnamen auszutauschen (zB. [[ReadingsGroup#Einfache Auswahl über Reading-Namen\|einfach]], [[ReadingsGroup#Schriftgrößen, Farben, Icons\|doppelt]], [[ReadingsGroup#Reading-Werte zuordnen (Icon / Text)\|erweitert]], [[ReadingsGroup#Heizungsteuerung für HM Wand- und Heizkörperthermostate\|noch mehr]], [[ReadingsGroup#Enigma Receiver\|leer]])
	Weitere Anwendungsbeispiele finden sich in den div. Beispielen unten und in der ~~commandref~~.		Weitere Anwendungsbeispiele finden sich in den div. Beispielen unten und in der {{Link2CmdRef}}.

	=== valueFormat ===		=== valueFormat ===
Zeile 50:		Zeile 50:
	* größere Berechnungen in [[99_myUtils_anlegen\|99_myUtils.pm]] aufzurufen (zB. [[ReadingsGroup#Enigma Receiver\|Enigma Receiver]]).		* größere Berechnungen in [[99_myUtils_anlegen\|99_myUtils.pm]] aufzurufen (zB. [[ReadingsGroup#Enigma Receiver\|Enigma Receiver]]).

	Weitere Anwendungsbeispiele finden sich in den div. Beispielen unten und in der ~~commandref~~.		Weitere Anwendungsbeispiele finden sich in den div. Beispielen unten und in der {{Link2CmdRef}}.

	=== valueIcon ===		=== valueIcon ===
	valueIcon wird verwendet um einer Zeile zusätzlich ein Symbol hinzuzufügen (zB. [[ReadingsGroup#Auswahl über Reading-Namen, Status als Symbol dargestellt\|einfach]], [[ReadingsGroup#Heizungswerte, Status und Regelmöglichkeit\|etwas mehr]]).		valueIcon wird verwendet um einer Zeile zusätzlich ein Symbol hinzuzufügen (zB. [[ReadingsGroup#Auswahl über Reading-Namen, Status als Symbol dargestellt\|einfach]], [[ReadingsGroup#Heizungswerte, Status und Regelmöglichkeit\|etwas mehr]]).

	Weitere Anwendungsbeispiele finden sich in den div. Beispielen unten und in der ~~commandref~~.		Weitere Anwendungsbeispiele finden sich in den div. Beispielen unten und in der {{Link2CmdRef}}.

	=== valueStyle ===		=== valueStyle ===
	valueStyle wird verwendet um die dargestellten Werte optisch anzupassen (zB. [[ReadingsGroup#Ausgabestil (hier rechtsbündig)\|einfach]], [[ReadingsGroup#Internal Values ausgeben\|erweitert]], [[ReadingsGroup#Wertabhängige Farbgebung\|komplex]]).		valueStyle wird verwendet um die dargestellten Werte optisch anzupassen (zB. [[ReadingsGroup#Ausgabestil (hier rechtsbündig)\|einfach]], [[ReadingsGroup#Internal Values ausgeben\|erweitert]], [[ReadingsGroup#Wertabhängige Farbgebung\|komplex]]).

	Weitere Anwendungsbeispiele finden sich in den div. Beispielen unten und in der ~~commandref~~.		Weitere Anwendungsbeispiele finden sich in den div. Beispielen unten und in der {{Link2CmdRef}}.

	== Beispiele ==		== Beispiele ==
Zeile 800:		Zeile 800:

	=== Readings löschen ===		=== Readings löschen ===
	Es kann vorkommen, dass Readings angezeigt werden, die garnicht existieren sollten - bspw. wenn man in einer HTTPMOD ein Reading umbeannt hat, kann auch der alte Readingsname immernoch angezeigt werden. Solche Readings können mit der globalen Funktion ~~[http://fhem.de/commandref.html#~~deletereading deletereading] gelöscht werden.		Es kann vorkommen, dass Readings angezeigt werden, die garnicht existieren sollten - bspw. wenn man in einer HTTPMOD ein Reading umbeannt hat, kann auch der alte Readingsname immernoch angezeigt werden. Solche Readings können mit der globalen Funktion {{Link2CmdRef\|Anker=deletereading\|Label=deletereading}} gelöscht werden.

	'''Achtung:''' Auf jeden Fall die ~~[http://fhem.de/commandref.html#~~deletereading ~~CommandRef~~ dazu] lesen!		'''Achtung:''' Auf jeden Fall die {{Link2CmdRef\|Anker=deletereading}} dazu lesen!

	Beispiel:		Beispiel:

MGu: Typo

2017-12-31T23:39:08Z

Typo

← Nächstältere Version		Version vom 1. Januar 2018, 01:39 Uhr
Zeile 8:		Zeile 8:
	\|ModOwner=Andre ({{Link2FU\|430\|Forum}} / [[Benutzer Diskussion:justme\|Wiki]])}}		\|ModOwner=Andre ({{Link2FU\|430\|Forum}} / [[Benutzer Diskussion:justme\|Wiki]])}}

	Das FHEM-[[:Kategorie:Hilfsmodul\|Hilfsmodul]] [[readingsGroup]] bietet eine einfache Möglichkeit, ''Readings'' (kein Präfix vor dem Reading-Namen), ''Internals'' (Präfix "+" vor dem Namen des internen Wertes) und ''Attributes'' (Präfix "?" vor dem Namen des Attributs) von einem oder mehreren ''Devices'' darzustellen und flexibel zu formatieren.		Das FHEM-[[:Kategorie:Hilfsmodul\|Hilfsmodul]] [[readingsGroup]] bietet eine einfache Möglichkeit, <code>Readings</code> (kein Präfix vor dem Reading-Namen), <code>Internals</code> (Präfix "+" vor dem Namen des internen Wertes) und <code>Attributes</code> (Präfix "?" vor dem Namen des Attributs) von einem oder mehreren <code>Devices</code> darzustellen und flexibel zu formatieren.

	Die Aktualisierung im Browserfenster geschieht per longpoll und überträgt nur die jeweils geänderten Zellen. Wenn eine readingsGroup in keinem Browserfenster angezeigt wird findet keine longpoll ~~aktualisierung~~ statt.		Die Aktualisierung im Browserfenster geschieht per <code>longpoll</code> und überträgt nur die jeweils geänderten Zellen. Wenn eine <code>readingsGroup</code> in keinem Browserfenster angezeigt wird, findet keine <code>longpoll</code> Aktualisierung statt.

	== Definition ==		== Definition ==

Markusbloch: Anpassung von -Tags nach

2017-07-26T18:01:10Z

Anpassung von <source>-Tags nach <syntaxhighlight>

Änderungen zeigen

Markusbloch: Ersetzung von Forum-Links mit Vorlage Link2Forum

2017-03-19T19:50:31Z

Ersetzung von Forum-Links mit Vorlage Link2Forum

← Nächstältere Version		Version vom 19. März 2017, 21:50 Uhr
Zeile 749:		Zeile 749:

	=== Enable/Disable Button am Beispiel eines WeekdayTimer ===		=== Enable/Disable Button am Beispiel eines WeekdayTimer ===
	Dieses Beispiel zeigt die Anwendung einer readingsGroup, um im Frontend einen Enable/Disable Button für ein Objekt darzustellen. Für den [[WeekdayTimer]] gibt es hier spezielle Erweiterungen (set Routinen, um das Attribut ''disable'' zu setzen). Es gibt aber auch eine allgemeinere Variante (siehe ~~[http://forum.fhem.de/index.php/topic,~~23655~~.msg169141.html#msg169141~~ diesen Forumsbeitrag]) für alle Objekte, die das FHEM Attribut ''disable'' unterstützen.		Dieses Beispiel zeigt die Anwendung einer readingsGroup, um im Frontend einen Enable/Disable Button für ein Objekt darzustellen. Für den [[WeekdayTimer]] gibt es hier spezielle Erweiterungen (set Routinen, um das Attribut ''disable'' zu setzen). Es gibt aber auch eine allgemeinere Variante (siehe {{Link2Forum\|Topic=23655\|Message=169141\|LinkText=diesen Forumsbeitrag}}) für alle Objekte, die das FHEM Attribut ''disable'' unterstützen.
	{\| class="wikitable"		{\| class="wikitable"
	! Definition !! Erläuterungen		! Definition !! Erläuterungen
Zeile 810:		Zeile 810:
	=== Ausrichtung der Tabelle drehen (horizontal/vertikal) ===		=== Ausrichtung der Tabelle drehen (horizontal/vertikal) ===
	Eine Readingsgroup wird standardmäßig immer zeilenweise aufgebaut, zB. jedes Gerät in eine neue Zeile. Die Werte der Geräte werden dann in den Spalten dargestellt.		Eine Readingsgroup wird standardmäßig immer zeilenweise aufgebaut, zB. jedes Gerät in eine neue Zeile. Die Werte der Geräte werden dann in den Spalten dargestellt.
	Wenn man eine Readingsgroup für nur ein Gerät mit vielen Readings hat (zB. [[Allergy]]), so kann man die Darstellung horizontal oder vertikal ausrichten, indem man die Readingsgroup detailliert definiert. Ein Bsp. dazu liefert der Foreneintrag ~~[https://forum.fhem.de/index.php/topic,~~37194~~.msg440446.html#msg440446]~~ :		Wenn man eine Readingsgroup für nur ein Gerät mit vielen Readings hat (zB. [[Allergy]]), so kann man die Darstellung horizontal oder vertikal ausrichten, indem man die Readingsgroup detailliert definiert. Ein Bsp. dazu liefert der Foreneintrag {{Link2Forum\|Topic=37194\|Message=440446}} :

	<pre>		<pre>

Krikan: um Pflichtbestandteil lang ergaenzt

2017-02-05T14:05:15Z

<source> um Pflichtbestandteil lang ergaenzt

← Nächstältere Version		Version vom 5. Februar 2017, 16:05 Uhr
Zeile 688:		Zeile 688:
	Im konkreten Beispiel ist via caldav ein Abfallkalender eingebunden, der die folgenden Einträge erzeugt:		Im konkreten Beispiel ist via caldav ein Abfallkalender eingebunden, der die folgenden Einträge erzeugt:

	<source>		<source lang="text">
	t_001_bdate 06.02.2017 2017-02-04 14:40:49		t_001_bdate 06.02.2017 2017-02-04 14:40:49
	t_001_btime 00:00:00 2017-02-04 14:40:49		t_001_btime 00:00:00 2017-02-04 14:40:49

Fabian: /* Inhalte berechnen */

2017-02-04T17:15:29Z

Inhalte berechnen

← Nächstältere Version		Version vom 4. Februar 2017, 19:15 Uhr
Zeile 726:		Zeile 726:
	}		}
	</source>		</source>
	~~In der~~ Code in der cfg-Datei würde bei valueFormat zwischen den Hauptklammern immer ;;;; statt ;; und an jedem Zeilenende ein \ haben.		Der Code in der cfg-Datei würde bei valueFormat zwischen den Hauptklammern immer ;;;; statt ;; und an jedem Zeilenende ein \ haben.

	=== Dynamische Inhalte ===		=== Dynamische Inhalte ===

Fabian: /* Inhalte filtern */ Kap. "Inhalte berechnen" angelegt

2017-02-04T17:14:50Z

Inhalte filtern: Kap. "Inhalte berechnen" angelegt

← Nächstältere Version		Version vom 4. Februar 2017, 19:14 Uhr
Zeile 682:		Zeile 682:

	Dies kann man noch weiter ausbauen und dynamische Auswahllisten erstellen (s. [[ReadingsGroup#Dynamische Inhalte]]).		Dies kann man noch weiter ausbauen und dynamische Auswahllisten erstellen (s. [[ReadingsGroup#Dynamische Inhalte]]).

			=== Inhalte berechnen ===
			Will man nur kleine Berechnungen machen und möchte diese aus irgendeinem Grund nicht in die [[99_myUtils_anlegen\|99_myUtils.pm]] auslagern (zB. der Übersicht halber), so kann man die Berechnung auch direkt in <code>valueFormat</code> einbauen. Ein ganz einfaches Bsp. dazu ist das Filtern von Inhalten ([[ReadingsGroup#Inhalte filtern\|s.o.]]).

			Im konkreten Beispiel ist via caldav ein Abfallkalender eingebunden, der die folgenden Einträge erzeugt:

			<source>
			t_001_bdate 06.02.2017 2017-02-04 14:40:49
			t_001_btime 00:00:00 2017-02-04 14:40:49
			...
			t_001_summary Gelber Sack 2017-02-04 14:40:49
			</source>

			Daraus lässt sich mit <code>readingsGroup</code> so direkt keine ordentliche Darstellung erzeugen. Gewünscht ist aber das folgende Format eines Zeilenentrags:

			<code>06.02.2017 Gelber Sack</code>

			Dies lässt sich durch eine noch einigermaßen kurze Berechnung erzeugen - längere Berechnungen sollte man definitiv in myUtils auslagern (vgl. [[ReadingsGroup#Enigma Receiver\|hier]]). Der folgende Code filtert zusätzlich weitere nicht erwünschte Einträge aus und macht noch eine Wortanpassung:

			<source lang="perl">
			# die readingsGroup reagiert nur auf summary-Einträge ( .* steht für eine beliebige Anzahl beliebiger Zeichen)

			define Abfallkalender readingsGroup calvAbfallKalender:t_.*summary

			attr Abfallkalender valueFormat {
			use Time::Local;;
			# alle Einträge Bio... und 4-wöchige Rest... ignorieren
			if (not $VALUE =~ /Bio/ and
			not $VALUE =~ /Restmülltonne..4/) {
			# readingname für bdate zum summary erzeugen
			my $rBdate = $READING =~ s/summary/bdate/r;;
			# readingvalue für bdate auslesen
			my $vDate = ReadingsVal($DEVICE,$rBdate,"");;
			# wenn value 'tonne' enthält dieses entfernen
			if ($VALUE =~ /tonne/) {
			$vDate . " " . substr($VALUE,0,index($VALUE,'tonne'));;
			} else {
			"$vDate %VALUE";;
			}
			} else {
			undef;;
			}
			}
			</source>
			In der Code in der cfg-Datei würde bei valueFormat zwischen den Hauptklammern immer ;;;; statt ;; und an jedem Zeilenende ein \ haben.

	=== Dynamische Inhalte ===		=== Dynamische Inhalte ===