diff --git a/CHANGED b/CHANGED
index 666917e27..876026e64 100644
--- a/CHANGED
+++ b/CHANGED
@@ -1,5 +1,6 @@
# Add changes at the top of the list. Keep it in ASCII, and 80-char wide.
# Do not insert empty lines here, update check depends on it.
+ - change: 57_SSCal: commandref reviewed
- feature: 98_RandomTimer: Add offState attribute to e.g. evaluate state
reading instead of STATE; NOTE: this will be
default behaviour starting with featurelevel 6.1
diff --git a/FHEM/57_SSCal.pm b/FHEM/57_SSCal.pm
index 5bbcd2522..2f2f31e60 100644
--- a/FHEM/57_SSCal.pm
+++ b/FHEM/57_SSCal.pm
@@ -48,6 +48,7 @@ eval "use FHEM::Meta;1" or my $modMetaAbsent = 1;
# Versions History intern
my %SSCal_vNotesIntern = (
+ "2.2.2" => "08.03.2020 review commandref ",
"2.2.1" => "04.03.2020 expand composite event 'compositeBlockNumbers' by 'none' ",
"2.2.0" => "03.03.2020 new composite event 'compositeBlockNumbers' ",
"2.1.0" => "01.03.2020 expand composite Event, bugfix API if entry with 'is_all_day' and at first position in 'data' ",
@@ -4524,7 +4525,46 @@ return $default;
-
+
+
+
+Hints for event generation
+
+
+
+ Depending on the volume of the retrieved data, a large number of readings can be created.
+ To avoid too extensive event generation in FHEM, the attribute event-on-update-reading is preset after
+ definition of the calendar device to:
+
+
+ attr event-on-update-reading.*Summary.*,state
+
+
+
+ If events are to be created for all readings, event-on-update-reading must be set to .* and mustn't be deleted.
+
+
+ SSCal generates additional events for each event, which contains a start time, with each new read-in
+ of a calendar. These events provide the user with assistance in creating his own control logic in FHEM based on
+ calendar entries.
+
+ The event composite contains the information fields:
+
+
+ - block number of the appointment
+ - Event ID of the appointment
+ - indicator for a serial appointment (0=no serial appointment or 1=serial appointment)
+ - start time in ISO 8601 format
+ - Status of the event
+ - the text in Description (corresponds to the Description field in Synology Calendar WebUI) or the text in Summary
+ if Description is not set
+
+
+
+ The event compositeBlockNumbers contains the block numbers of all events of the calendar.
+ If there are no appointments, this event has only the value none.
+
+
@@ -4641,8 +4681,8 @@ return $default;
calUpdate [<Kalenderliste>]
Ruft die Einträge der selektierten Kalender (siehe Attribut usedCalendars) ab.
- Alternativ kann eine Komma getrennte Liste der abzufunden Kalender dem Befehl übergeben werden. Die Kalendernamen können Leerzeichen
- enthalten.
+ Alternativ kann eine Komma getrennte Liste der abzurufenden Kalender dem Befehl übergeben werden. Die Kalendernamen können
+ Leerzeichen enthalten.
@@ -5049,7 +5089,46 @@ return $default;
-
+
+
+
+Hinweise zur Eventgenerierung
+
+
+
+ Je nach Umfang der abgerufenen Daten können sehr viele Readings erstellt werden. Um eine zu umfangreiche Eventgenerierung
+ in FHEM zu verhindern, ist nach der Definition des Kalenderdevices das Attribut event-on-update-reading
+ voreingestellt auf:
+
+
+ attr event-on-update-reading .*Summary.*,state
+
+
+
+ Sollen Events für alle Readings erstellt werden, muss event-on-update-reading auf .* eingestellt und nicht gelöscht
+ werden.
+
+ SSCal generiert für jedes Ereignis, welches einen Begin-Zeitpunkt enthält, zusätzliche Events bei jedem erneuten Einlesen
+ eines Kalenders. Diese Events bieten dem Anwender Hilfe zur Erstellung eigener Steuerungslogiken in FHEM auf Grundlage
+ von Kalendereinträgen.
+
+ Der Event composite enthält die Informationsfelder:
+
+
+ - Blocknummer des Termins
+ - Event-ID des Termins
+ - Kennzeichen für ein Serientermin (0=kein Serientermin oder 1=Serientermin)
+ - Startzeitpunkt im ISO 8601 Format
+ - Status des Events
+ - den Text in Description (entspricht dem Feld Beschreibung im Synology Kalender WebUI) bzw. den Text in Summary
+ falls Description nicht gesetzt ist
+
+
+
+ Der Event compositeBlockNumbers enthält die Blocknummern aller Termine des Kalenders. Sind keine Termine vorhanden, enthält
+ dieser Event nur den Wert none.
+
+