Beispiel 1: Kalender suchen und laden

Ein gängiger Anwendungsfall für die "Kalender setzen" Aktion ist das Suchen eines Kalenders über ein Suchverhalten. Hierbei wird empfohlen Kalender auf Basis ihres Namens zu identifizieren, nicht anhand ihrer ID, da diese von System zu System abweichen kann (Übertragen von Masken auf ein anderes System). Hierfür wird einem Datumsfeld ein Verhalten "loadCalendar" hinterlegt, welches beim Laden der Formulardaten aufgerufen werden soll. Zusätzlich aktiviert das Datumsfeld die Option "Nur Werktage".

Im Suchverhalten wird der Kalender mit dem statischen Namen "Standardkalender" gesucht, welcher dann an die Aktion "Kalender setzen" übergeben wird.

Ergebnis:

Beispiel 2: Dynamisches Hinzufügen von Kalenderausnahmen

Der Datumswert "Abfahrtsdatum geplant" einer Sendung soll im Kalender des Feldes "Abfahrtsdatum tatsächlich" visuell dargestellt werden und unabhängig vom hinterlegten Kalender als auswählbarer Tag deklariert werden.
Ein bereits im System angelegter Kalender namens "Standardkalender" definiert grundlegende Feier- und Arbeitstage. In diesem Beispiel sind die definierten Werktage Montag bis Freitag.

Zur Umsetzung des Beispiels wird dem Datumsbereich-Element "Abfahrtsdatum geplant" ein Verhalten bei "geändert" hinterlegt. Dieses führt einen Client Workflow aus, welcher eine Kalenderinstanz ermittelt und an die Aktionen bei "wahr" weitergibt.

Der geänderte Datumsbereich wird als Variable "source" (1) (DateTime) an den Client Workflow übergeben. In die Variable "calendar" (2) wird im Workflow dann der resultierende Kalender geschrieben.
Als Aktion bei "wahr" wird "Kalender setzen" auf das Datumsbereich-Element "Abfahrtsdatum tatsächlich" ausgeführt.

Im Client Workflow (Regel: Statisch wahr) wird zunächst nach dem Kalender mit dem Namen "Standardkalender" gesucht und in die Variable "calendar" geschrieben.

Zu den Ausnahmen des Kalenders wird über den Auflöser Listenwert eine neue Kalenderausnahme hinzugefügt (1). Als kleiner Trick wird diese neue Instanz gleich in einer Ausführen mit Aktion bearbeitet, um direkt auf dessen Objektfelder zugreifen zu können (2).

Unten werden die Setze Wert Aktionen erläutert.

(A) Das Datum der Ausnahme wird auf den Wert von "Abfahrtsdatum geplant" gesetzt, welches als Variable "source" an den Client Workflow übergeben wurde (siehe weiter oben)

(B) Als Ausnahmetyp wird Arbeitstag gewählt, da dieses Datum nun unabhängig von den Regelarbeitstagen auswählbar sein soll

(C) Die Ausnahme soll mit einer grünlichen Farbe (Dezimalcode 6487936 hervorgehoben werden

(D) Die Beschriftung wird als "Localized Label" Instanz angegeben, über welche ein Ressourcen-Bundle (E) und -Name (F) definiert werden kann

(E) Das Sprachverwaltungsbundle der Beschriftung

(F) Der Ressourcenname der Beschriftung

Für das Datumsfeld "Abfahrtsdatum tatsächlich" wurde die Option "Nur Werktage" aktiviert, was Samstage und Sonntage aufgrund des Standardkalenders als nicht auswählbare Tage anzeigt. Im Ergebnis-Screenshot zu Beginn dieses Beispiels wird allerdings deutlich, dass die Ausnahme diese Regel außer Kraft setzt, da der Typ der Ausnahme ein "Arbeitstag" ist.