Zeitsteuerungsbausteine Hilfe

Feiertagskalender

Beschreibung

Dieser Baustein liest einen als iCal / ics formatierten Kalender ein und stellt Informationen zum jeweils nächsten ganztägigen (jedoch nicht: mehrtägigen) Ereignis dar. Damit können Wecker gesteuert oder Termine auf grafischen Anzeigen visualisiert werden.

Wiederkehrende Termine (Serientermine) werden derzeit noch nicht vollständig unterstützt; während Serientermine selbst noch nicht einbezogen werden, werden die von der Serie abweichenden Termine berücksichtigt.

Der Ausgang des Logikbausteins zeigt entweder den Feiertag des aktuelles Tages oder des nächsten Feiertages innerhalb der nächsten 6 Monate an. Der Ausgang wird kurz nach Mitternacht des Folgetags eines Feiertags automatisch aktualisiert (und triggert so ggf. einen Wecker (Weckzeit)-Baustein).

Eigenschaften

Eingänge

Bezeichnung Porttyp Beschreibung
iCal Kalender Zeit

Eingang, an den ein iCal / ics Kalender übermittelt wird.

Da die Auswertung großer Kalender auf dem X1 recht viel Last erzeugen kann, sollten die Aktualierungsintervalle eher großzügig gewählt werden und Lastzeiten (z.B. volle Stunden) gemieden werden. Gute Erfahrungen wurden mit einer Aktualisierungszeit von z.B. einer Woche erzielt.

Als Anbieter für iCal / ics Dateien hat sich OfficeHolidays.com als recht zuverlässig erwiesen. Hier können ics-Kalender für Länder und einzelne Regionen gewählt und im Baustein dynamisch verarbeitet werden. Der Kalender für Berlin ist beispielsweise unter der URL "https://www.officeholidays.com/ics-local-name/germany/berlin" verfügbar.

Parameter

Bezeichnung Porttyp Beschreibung
Einschließende Parameter Ganzzahl

Um Ereignisse zu filtern, können sie mittels einschließender Parameter gefiltert werden. Ein Ereignisse wird dann angezeigt wenn alle 0..10 einschließenden Parameter erfüllt sind.

Die Filterung efolgt mittels "String.StartsWith(.. OrdinalIgnoreCase)", so dass auch selbst gewählte Prefixe erfasst werden können.
xx. Einschließender Parameter Ganzzahl

Ein einschließender Parameter.

Sollen beispielsweise bei einem von Microsoft Exchange erzeugten iCal-Kalender nur Einträge berücksichtigt werden, die als "gebucht" klassifiziert sind, so würde als Parameter "X-MICROSOFT-CDO-BUSYSTATUS:BUSY" eingetragen werden.
Ausschließende Parameter Ganzzahl

Um Ereignisse zu filtern, können sie mittels ausschließender Parameter gefiltert werden. Ein Ereigniss wird dann angezeigt wenn keiner der 0..10 ausschließenden Parameter erfüllt sind.

Die Filterung efolgt mittels "String.StartsWith(.. OrdinalIgnoreCase)", so dass auch selbst gewählte Prefixe erfasst werden können.
xx. Ausschließender Parameter Ganzzahl

Ein ausschließender Parameter.

Sollen beispielsweise in einem Abfallkalender alle Einträge ausgeblendet werden, die "Biomüll" heißen, so würde als Parameter "SUMMARY:Biomüll" eingetragen werden.
Formatvorlage Text

Erlaubt die Formatierung des Ausgabetextes mit Platzhaltern "{x}" für den nächsten Termin. Dafür stehen die folgenden Werte zur Verfügung:

  • 0 [DateTime] Startzeit des nächsten Termins.
  • 1 [String] Betreff/Titel des nächsten Termins.

Wird keine Formatierung angegeben, so bleibt die Ausgabe "Zusamenfassung" leer!

Formatierungsoptionen werden hier erläutert: Formatierungsoptionen für Datum und Zeit
Text "Keine Eregnisse" Text

Text, der am Ausgang "Zusammenfassung" ausgegeben wird, wenn im Kalender für die nächsten sieben Tage kein Termin eingetragen ist.

Ausgänge

Bezeichnung Porttyp Beschreibung
Nächstes Ereignis Zeit

Gibt die Startzeit des nächsten Ereignisses zurück. Das jeweils nächste Ereignis wird sofort oder kurz nach Mitternacht des aktuellen Ereignisses angezeigt.

Liegt für die nächsten sechs Monate kein Ereignis an, so wird der Standardzeitpunkt "01.01.0001 00:00:00" zurückgegeben.

Der Parameter "Zusammenfassung" wird immer unmittelbar vor diesem Ausgang aktualisiert.
Zusamenfassung Zeit

Liefert eine Zusammenfassung des nächsten Termins gemäß der in "Formatvorlage" eingestellten Formatierung.

Liegt für nächsten sechs Monate kein Ereignis an, kann ein definierter Text ("Text "Keine Ereignisse"") ausgegeben werden.

Der Parameter "Nächstes Ereignis" wird immer unmittelbar nach diesem Ausgang aktualisiert.

Anwendung

Beispiel: Weckzeit ermitteln

Wenn die Tagesroutine zu unterschiedlichen Zeiten beginnt, die sich nicht auf Wochentage festlegen lassen (-> Zeitschaltuhr), bietet es sich an, die zumeist existierenden Kalender auszulesen. Häufig exisiteren verschiedene Kalender parallel, so dass aus allen Kalendern gegebenenfalls der nächste bzw. früheste Termin ausgewählt werden muss.

Dieser Baustein nimmt von 1..10 Kalendern die Zeiten des jeweils nächsten Termins entgegen und bestimmt so den nächsten bzw. frühesten Termin, der dann an den Wecker weitergeleitet werden kann.

Da der Wecker zum Wecken aktiv eingeschaltet werden muss, können auch während des Tages jeweils die nächsten Termine an die Logikbausteine geschickt werden. Der Wecker würde nur dann auslösen, wenn er untertags aktiv geschaltet wird.

Wecker (Weckzeit) - Terminkalender und Feiertagskalender auslesen
Zunächst werden Termine aus einem Exchange-Online-Kalender ausgelesen und die Feiertage von einem Webdienst bereitgestellt. Um die Daten in verschiedenen Logikblättern zu verwenden, werden sie in X1-Variablen-Datenpunkten gespeichert.
Wecker (Weckzeit) - Terminkalender und Feiertagskalender verwenden
In diesem Beispiel wird die Weckzeit aus einem Kalender bestimmt. Der Feiertagskalender und die Werktagskonfiguration unterstützen bei der Auswahl der Standardweckzeit.

Standardweckzeiten können beispielsweise durch Szenen, Zeitschaltuhren (z.B. Wochentag, Wochenende) oder auch Eingabegeräte auf einen der Eingänge gelegt werden.

Damit ein Wecker auslöst, muss der Termin rechtzeitig übermittelt werden. Dauert beispielsweise die Wecksequenz des Weckers 30 min, die Vorlaufzeit des Weckzeit-Bausteins 45 min, so muss der Termin mindestens 1h 15min vor der eigentlichen Weckzeit durch den Terminkalender-Logikbaustein übermittelt worden sein.

Lizenzinformationen