CALVIEW: Unterschied zwischen den Versionen

CALVIEW
Zweck / Funktion
	Legt ein Device an, das alle Termine aus einem Calendar als Reading anzeigt.
Allgemein
Typ	Gerätemodul
Details
Dokumentation	EN / DE; Thema
Support (Forum)	Unterstützende Dienste/Kalendermodule
Modulname	57_CALVIEW.pm
Ersteller	Christian / Chris1284
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Aktuelle Version vom 11. Februar 2022, 19:11 Uhr

Todo: Dieser Artikel ist veraltet. Insbesondere stimmt die Definition (define) nicht mit der derzeit gültigen (siehe commandref) überein. Mitautoren gesucht! Dieser Artikel muss dringend überarbeitet werden!

CALVIEW ist ein Hilfsmodul, das alle Termine aus einem bestehenden Kalender des Moduls Calendar in Readings übernimmt.

Voraussetzungen

Es muss ein Calendar-Objekt definiert sein. Der dabei benutzte Name muss in der Definition des CALVIEW-Objekts spezifiziert werden.

Anwendung

Define

define <Name> CALVIEW <calendarname>[,<calendarname2>,...] <modus> [<updateintervall>]

Erläuterung der Parameter im define:

<calendarname>: Name des Calendar Kalenders. Mehrere Calendar-Namen durch Komma getrennt.
<modus>: 0  für "modeStarted" Termine
1  für "modeStarted";"modeUpcoming" Termine
2  für "all" Termine

<updateintervall>: Updateintervall in sec (default 43200). Nicht erforderlich, da ein Calendar-Update ein Calview-Update triggert.

Beispiel:

define myCalView CALVIEW Googlecalendar 1

Werte aktualisieren

CALVIEW in einer ReadingsGroup

set <Name> update

Beispiel:

set myCalView update

Aktualisierungsintervall festlegen

~~set <Name> intervall <time>~~

Das Aktualisierungsintervall wird (in den neueren Versionen - ab Mai 2015 - des Moduls) nur noch über das DEF verändert.

=== Weitere Attribute ===Internet of Things.

Attribute

maxreadings: Anzahl der angezeigten Termine festlegen

Beispiel:

attr myCalView maxreadings 10
sourcecolor: Hiermit können die Farben der einzelnen Kalender definiert werden. Diese können dann z.B. im Tablet UI Calview-Widget genutzt werden.

Beispiel:

attr myCalView sourcecolor Kalender1:green,Kalender2:yellow

Anwendungsbeispiel(e)

define kalenderTermine readingsGroup <%time_calendar>,<Text>,<Zuletzt erfasst> myView
attr kalenderTermine alias Termine
attr kalenderTermine group _KalenderView_
attr kalenderTermine mapping %READING
attr kalenderTermine room Kalender

Links

Ein komplettes Beispiel ist im ersten Beitrag dieser Diskussion im FHEM Forum enthalten

@@ Zeile 17: / Zeile 17: @@
 == Anwendung ==
 === Define ===
-:<code>define <Name> CALVIEW <calendarname>[,<calendarname2>] <modus> [<updateintervall>]</code>
+:<code>define <Name> CALVIEW <calendarname>[,<calendarname2>,...] <modus> [<updateintervall>]</code>
 Erläuterung der Parameter im '''define''':
@@ Zeile 26: / Zeile 26: @@
 ;<updateintervall>
-:Updateintervall in sec (default 43200). Nicht erforderlich.
+:Updateintervall in sec (default 43200). Nicht erforderlich, da ein Calendar-Update ein Calview-Update triggert.
 Beispiel:
 :<code>define myCalView CALVIEW Googlecalendar 1</code>
@@ Zeile 42: / Zeile 42: @@
 === Weitere Attribute ===Internet of Things.
+=== Attribute ===
 ;maxreadings
 :Anzahl der angezeigten Termine festlegen
 Beispiel:
 :<code>attr myCalView maxreadings 10</code>
+;sourcecolor
+:Hiermit können die Farben der einzelnen Kalender definiert werden. Diese können dann z.B. im Tablet UI Calview-Widget genutzt werden.
+Beispiel:
+:<code>attr myCalView sourcecolor Kalender1:green,Kalender2:yellow</code>
 == Anwendungsbeispiel(e) ==