Das Kalender-Ansichtselement (Typ: Scheduler) zeigt Datensätze als Termine in einer Kalenderansicht an. Je nach gewähltem Ansichts-Preset stehen verschiedene Darstellungen zur Verfügung — von der Übersicht über lange Zeiträume bis hin zur detaillierten Tagesplanung.

Das Ansichtselement eignet sich ideal für Datensätze mit Start- und Enddatum, z. B. Termine, Aufgaben, Projekte, Wartungsintervalle oder Meilensteine.

• Datenquelle — Eine Datenquelle mit mindestens einem Datumsfeld für den Terminbeginn.
• Datumsfelder — Mindestens ein Startdatum-Feld. Ein Enddatum-Feld ist empfohlen, damit die Dauer korrekt dargestellt wird.
• Admin-Berechtigung — Sie benötigen Zugriff auf den Admin-Bereich, um Ansichtselemente zu konfigurieren.

1. Ansichtselement anlegen

   Erstellen Sie ein neues Ansichtselement in Ihrer App. Wählen Sie als Typ:

   Scheduler

   Vergeben Sie einen aussagekräftigen Namen (z. B. „Projektkalender“ oder „Terminplanung“).

2. Datenquelle zuweisen Pflichtfeld

   Weisen Sie dem Ansichtselement eine Datenquelle zu. Diese Datenquelle liefert die Datensätze, die als Termine im Kalender dargestellt werden. Die verfügbaren Felder der Datenquelle stehen anschließend für die Feldzuordnung bereit.

3. Datumsfelder zuordnen Pflichtfeld

   Wechseln Sie zum Tab „Kalender“ (Einstellungen der Kalender-Anzeige). Im Abschnitt „Termin — Feldzuordnung“ ordnen Sie die Felder Ihrer Datenquelle den Kalender-Eigenschaften zu:

   Feld	Beschreibung
   Startdatum Pflicht	Das Datumsfeld, das den Beginn des Termins definiert. Beispiel: ProjektStart, TerminVon
   Enddatum Pflicht	Das Datumsfeld, das das Ende des Termins definiert. Bestimmt die Dauer im Kalender. Beispiel: ProjektEnde, TerminBis
   Titel Pflicht	Eines oder mehrere Felder, die als Beschriftung des Termins angezeigt werden. Bei mehreren Feldern kann eine Formatierung definiert werden. Beispiel: Projektname, Bezeichnung
   Untertitel Optional	Zusätzliche Felder, die als Beschreibung unterhalb des Titels angezeigt werden. Beispiel: Projektleiter, Bemerkung
   Ganztägig (Feld) Optional	Boolesches Feld der Datenquelle, das pro Termin festlegt, ob dieser ganztägig dargestellt wird. Überschreibt die globale Einstellung „Ganztägig“ aus dem Abschnitt Ansicht. Liefert das Feld keinen interpretierbaren Wert (leer/null), greift der globale Standard. Akzeptiert: true/false, 1/0 sowie bool-/int-Spalten.
   Kategorie-Feld Optional	Feld der Datenquelle, nach dem Termine gruppiert und farblich unterschieden werden können. Enthält entweder den Kategorienamen direkt oder eine Id, die auf einen Datensatz in einer separaten Kategorien-Datenquelle verweist (siehe Abschnitt Kategorie). Aktiviert die Kategorie-Legende oberhalb des Kalenders mit Ein/Aus-Schaltern pro Kategorie.
   Ressource-Id Optional	Verknüpft den Termin mit einer Ressource (z. B. Raum, Mitarbeiter). Wird für das Preset „Ressourcenplanung“ benötigt.

   Tipp: Titel-Formatierung Wenn Sie mehrere Felder für den Titel auswählen, können Sie im Feld „Titel Formatierung“ einen Formatstring angeben (z. B. {0} - {1}). So werden die Feldwerte in der gewünschten Reihenfolge und mit Trennzeichen dargestellt.
4. Darstellung konfigurieren

   Im Abschnitt „Ansicht“ passen Sie die Kalenderdarstellung an:

   Einstellung	Beschreibung
   Ansichts-Preset	Wählen Sie das Preset, das am besten zu Ihrem Anwendungsfall passt (siehe Tabelle oben).
   Start-Ansicht	Welche Ansicht wird beim ersten Öffnen des Kalenders aktiv? Optionen: Aus Ansichts-Preset (Standard — aus dem gewählten Preset abgeleitet), Tag, Woche, Arbeitswoche, Monat, Übersicht, Zeitleiste Tag/Woche/Monat. Wenn der Anwender die Ansicht ändert, wird seine Wahl persönlich gespeichert (ViewState) und überschreibt diesen Standard bei erneutem Öffnen.
   Start-Datum	Welcher Zeitraum ist beim Öffnen im Fokus? Optionen: Heute (Standard), Aktuelle / Nächste / Vorherige Woche (jeweils Montag), Aktueller / Nächster / Vorheriger Monat (jeweils 1. des Monats), Aktuelles Jahr (1. Januar). Ebenfalls vom ViewState des Anwenders übersteuerbar.
   Startzeit / Endzeit	Begrenzt den sichtbaren Zeitbereich pro Tag (z. B. 08:00 bis 18:00). Relevant für Tages- und Wochenansichten.
   Zeitslot (Minuten)	Legt die Rasterung der Zeitachse fest (z. B. 15, 30 oder 60 Minuten). Standard: 60 Minuten.
   Wochenende anzeigen	Steuert, ob Samstag und Sonntag im Kalender sichtbar sind. Standard: aktiviert.
   Ganztägig	Globaler Standardwert: Wenn aktiviert, werden Termine ganztägig (ohne Uhrzeitbezug) dargestellt. Kann pro Termin durch das Feld-Mapping „Ganztägig (Feld)“ im Abschnitt Termin — Feldzuordnung überschrieben werden.

   Im Abschnitt „Darstellung“ können Sie zusätzlich Farben und visuelle Elemente konfigurieren:

   Einstellung	Beschreibung
   Farbe Feldname Optional	Ein Feld der Datenquelle, das die Farbe des Termins bestimmt (z. B. ein Statusfeld mit CSS-Farbwerten).
   Standard-Farbe Optional	Fallback-Farbe, wenn kein Farbfeld zugeordnet ist oder der Wert leer ist.
   Badge Feldname Optional	Zeigt ein kleines Badge-Label am Termin an (z. B. Priorität oder Typ).
   Tooltip Optional	Felder, die als Tooltip beim Überfahren des Termins angezeigt werden.

5. Ressourcen konfigurieren (optional)

   Zwei Betriebsmodi:

   • Modus A — implizit: Nur das Feld Ressource-Id (Abschnitt Termin — Feldzuordnung) ist gesetzt, keine Ressourcen-Datenquelle. Die Ressourcen entstehen als DISTINCT über den Feldwert der Termine — ideal, wenn im Datensatz bereits der Anzeigename steht (z. B. ein reines Textfeld mit dem Namen der Abteilung). Farbe: aus Standard-Farbe des Abschnitts Ressource.
   • Modus B — explizit mit eigener Datenquelle: Im Abschnitt „Ressource“ wird eine separate Datenquelle zugewiesen, die die verfügbaren Ressourcen enthält (z. B. Räume, Mitarbeiter, Geräte) — inkl. Anzeigename, Farbe und weiteren Attributen. Der Wert des Ressource-Id-Felds der Termine muss auf das Id-Feld der Ressourcen-Datenquelle verweisen.

   Wenn Sie das Preset „Ressourcenplanung“ verwenden, ist Modus B typisch. Für einfache Gruppierung ohne eigene Stammdaten-Tabelle reicht Modus A.

   Feld	Beschreibung
   Datenquelle	Die Datenquelle, die die Ressourcen enthält.
   Id Feldname	Das Feld, das die eindeutige Kennung der Ressource enthält. Muss mit dem Feld „Ressource-Id“ der Termine übereinstimmen.
   Titel	Das Feld, das als Anzeigename der Ressource dient.
   Farbe Feldname	Optionales Feld für die farbliche Kennzeichnung der Ressource.

   Hinweis zur Ressourcenplanung Die Ressource-Id im Termin-Datensatz muss auf den Wert des Id-Feldes in der Ressourcen-Datenquelle verweisen. Nur so kann der Kalender die Termine den richtigen Ressourcen zuordnen.
6. Kategorien konfigurieren (optional)

   Wenn im Feldzuordnungs-Bereich ein „Kategorie-Feld“ gesetzt ist, zeigt der Kalender oberhalb der Ansicht eine Legende mit Chips pro Kategorie — jeder Chip zeigt Farbe, Titel und Anzahl der Termine. Per Klick wird die Kategorie ein- oder ausgeblendet. Zusätzliche Schalter Alle, Keine, Invertieren rechts oben.

   Zwei Betriebsmodi:

   • Modus A — implizit: Nur Kategorie-Feld der Haupt-Datenquelle ist gesetzt. Die Legende wird aus den unterschiedlichen Feldwerten der aktuell geladenen Termine abgeleitet. Farbe pro Kategorie wird — falls vorhanden — aus dem Farbe Feldname (Abschnitt Darstellung) übernommen.
   • Modus B — explizit mit eigener Datenquelle: Im Abschnitt Kategorie wird zusätzlich eine Kategorie-Datenquelle hinterlegt (analog zu Ressourcen). Diese liefert alle möglichen Kategorien — auch solche ohne aktuelle Termine (Count = 0, ausgegraut). Ideal für stabile Farben und vollständige Übersicht.

   Feld	Beschreibung
   Datenquelle (optional)	Separate Datenquelle mit allen verfügbaren Kategorien. Wird für Modus B benötigt. Leer lassen für Modus A.
   Id Feldname	Feld der Kategorien-Datenquelle mit der eindeutigen Kennung. Der Wert des Kategorie-Felds der Haupt-Datenquelle muss darauf verweisen.
   Titel	Feld (oder mehrere Felder + Formatierung) mit dem anzuzeigenden Kategorienamen.
   Farbe Feldname	Optionales Feld mit einem CSS-Farbwert pro Kategorie.
   Standard-Farbe	Fallback-Farbe, wenn kein Farbfeld zugeordnet ist oder der Wert leer ist.

   Persistenz der Auswahl Die Ein/Aus-Auswahl der Kategorie-Chips wird pro Anwender im ViewState gespeichert und bleibt über Datenaktualisierungen hinweg erhalten.
7. Ganztagestermine ein- oder ausblenden

   In der Toolbar des Kalenders steht die Aktion „Ganztagestermine ein/aus“ zur Verfügung. Ein Klick blendet alle Termine mit IsAllDay = true aus oder wieder ein — unabhängig davon, ob der Wert aus dem globalen Ganztägig-Haken oder aus dem Feld-Mapping Ganztägig (Feld) stammt. Die Einstellung bleibt über Datenaktualisierungen hinweg erhalten.

8. Ansichtselement speichern

   Speichern Sie das Ansichtselement. Der Kalender wird sofort in der App-Navigation angezeigt und stellt die Termine der zugewiesenen Datenquelle dar.

In diesem Beispiel erstellen wir einen Kalender für Projekte mit Start- und Enddatum.

Ergebnis: Im Kalender werden alle Projekte als farblich gekennzeichnete Balken dargestellt. Der Titel zeigt den Projektnamen, der Untertitel den Projektleiter und den Status. Projekte ohne Enddatum erscheinen als eintägige Einträge.

Kann ich den Kalender-Typ (Preset) nachträglich ändern?

Ja. Öffnen Sie das Ansichtselement im Admin-Client und ändern Sie das Ansichts-Preset im Abschnitt „Ansicht“. Die Feldzuordnungen bleiben erhalten. Der Anwender sieht die geänderte Darstellung nach dem nächsten Laden.

Warum werden keine Termine angezeigt?

Prüfen Sie folgende Punkte:

• Ist eine Datenquelle zugewiesen und enthält sie Datensätze?
• Ist das Startdatum-Feld korrekt zugeordnet?
• Liegt das Datum der Termine im aktuell sichtbaren Zeitraum des Kalenders?
• Enthalten die Datensätze gültige Datumswerte (keine Null-Werte)?

Was passiert, wenn kein Enddatum vorhanden ist?

Termine ohne Enddatum werden als Einträge mit der Dauer eines einzelnen Tages bzw. Zeitslots dargestellt. Für eine korrekte Darstellung von Zeiträumen empfiehlt es sich, immer ein Enddatum zu pflegen.

Wofür wird die Ressourcen-Datenquelle benötigt?

Die Ressourcen-Datenquelle wird ausschließlich für das Preset „Ressourcenplanung“ benötigt. Sie definiert die Ressourcen (z. B. Räume, Mitarbeiter), denen die Termine zugeordnet werden. Ohne Ressourcen-Datenquelle funktionieren die anderen Presets uneingeschränkt.

Kann der Anwender Termine direkt im Kalender bearbeiten?

Der Kalender dient primär der Visualisierung. Durch Klick auf einen Termin öffnet sich der zugehörige Datensatz im Detail-Dialog, wo Änderungen vorgenommen werden können.

Kann ich mehrere Kalender in einer App haben?

Ja. Erstellen Sie mehrere Ansichtselemente vom Typ Scheduler mit unterschiedlichen Datenquellen oder Einstellungen. Jeder Kalender erscheint als eigener Navigationspunkt in der App.