Das Kanban-Ansichtselement zeigt Datensätze als Karten in Spalten, die einen Status oder eine Kategorie repräsentieren. Karten können angeklickt werden, um den Datensatz zu bearbeiten; per Rechtsklick stehen die konfigurierten Karten-Aktionen als Kontextmenü zur Verfügung.

Die Konfiguration gliedert sich in zwei Bereiche: die Karten-Einstellungen (welche Felder auf der Karte angezeigt werden) und die Spalten-Einstellungen (woher die Spalten kommen und wie sie dargestellt werden).

• Datenquelle — Eine Datenquelle mit einem Statusfeld (z. B. „Status“) muss in der App konfiguriert sein.
• Spalten-Datenquelle (optional) — Eine separate Datenquelle, die die möglichen Spalten definiert (z. B. eine Lookup-Tabelle mit Status-Werten, Farben und Sortierung).
• 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:

   Kanban

   Vergeben Sie einen aussagekräftigen Namen (z. B. „Aufgaben-Board“) und speichern Sie das Ansichtselement.

2. Datenquelle zuweisen Pflichtfeld

   Weisen Sie dem Ansichtselement eine Datenquelle zu. Diese liefert die Datensätze, die als Karten auf dem Board erscheinen. Die Felder der Datenquelle stehen anschließend für die Karten-Konfiguration zur Verfügung.

3. Karten-Einstellungen konfigurieren

   Wechseln Sie zum Tab „Einstellungen“. Im Bereich „Karte“ legen Sie fest, welche Felder auf jeder Karte angezeigt werden:

   Mit * gekennzeichnete Felder sind Pflichtfelder.

   • Status Feldname * — Bestimmt, in welcher Spalte die Karte erscheint
   • Titel Feldname * — Wird als Überschrift der Karte angezeigt
   • Beschreibung Feldname — Zusätzlicher Text unter dem Titel
   • Tags Feldname — Schlagwörter als Labels auf der Karte
   • Priorität Feldname — Numerische Priorität, wird auf der Karte angezeigt
   • Farbe Feldname — Feld mit Hex-Code oder CSS-Farbnamen, das den farbigen Links-Rahmen der Karte bestimmt. Wenn nicht gesetzt, wird die Spaltenfarbe als Fallback verwendet.
4. Spalten-Einstellungen konfigurieren

   Im Bereich „Spalte“ definieren Sie, woher die Spalten des Boards kommen und wie sie dargestellt werden:

   • Datenquelle — Optionale separate Datenquelle für die Spaltendefinitionen (z. B. Lookup-Tabelle „Status-Werte“)
   • Id Feldname — Eindeutige Kennung der Spalte (wird mit dem Status-Feld der Karte abgeglichen)
   • Name Feldname — Angezeigter Titel der Spalte
   • Farbe Feldname — Individuelle Spaltenfarbe (z. B. Hex-Wert)
   • Sortierung Feldname — Reihenfolge der Spalten auf dem Board
   Tipp Wenn Sie keine separate Spalten-Datenquelle angeben, werden die Spalten automatisch aus den vorhandenen Status-Werten der Karten generiert. Für mehr Kontrolle über Reihenfolge, Farben und Benennung empfiehlt sich eine eigene Spalten-Datenquelle.

Karten-Einstellungen

Spalten-Einstellungen

* Pflicht, wenn eine Spalten-Datenquelle zugewiesen ist.

Im User-Client können Anwender:

• Karten anklicken, um den Datensatz zu selektieren bzw. zu bearbeiten
• Mit Rechtsklick auf eine Karte das Kontextmenü mit den konfigurierten Karten-Aktionen öffnen (z. B. Status ändern, Zuweisen, Löschen)
• Spalten per Klick auf den Spalten-Header ein- und ausklappen
• Die Übersicht nutzen, um Engpässe schnell zu erkennen (z. B. zu viele Karten in einer Spalte)

Wenn das Kanban-Board leer bleibt oder nicht wie erwartet aussieht, zeigt die Anzeige selbst einen konkreten Hinweis:

• „Konfiguration unvollständig“ (blau) — Es fehlen Pflichtfelder. Die fehlenden Felder werden namentlich gelistet.
• „Keine Daten“ (gelb) — Die Datenquelle liefert keine Einträge und es ist keine Spalten-Datenquelle konfiguriert. Prüfen Sie den Filter der Datenquelle oder legen Sie eine Spalten-Datenquelle an.
• „Keine Karte passt zu einer Spalte“ (gelb) — Die Werte der Karten-Status-Felder passen zu keiner Spalten-ID. Die Anzeige listet die nicht zuordenbaren Status-Werte. Prüfen Sie, ob Status Feldname der Karte und Id Feldname der Spalten-Datenquelle dieselben Wertebereiche enthalten.
• Warnung über dem Board — Einige Karten konnten zugeordnet werden, andere nicht. Die Warnung oberhalb des Boards nennt Anzahl und betroffene Status-Werte.

Wie wird der Status einer Karte geändert?

Statusänderungen erfolgen über konfigurierte Karten-Aktionen (UdmActions mit IsRowAction), die im Kontextmenü der Karte erscheinen. Alternativ über den Detail-Dialog des Datensatzes. Sobald der Status-Wert geändert und gespeichert wird, erscheint die Karte automatisch in der neuen Spalte.

Kann ich die Spalten ohne eigene Datenquelle konfigurieren?

Ja. Wenn Sie keine separate Spalten-Datenquelle angeben, werden die Spalten automatisch aus den vorhandenen Status-Werten der Datensätze erzeugt. Allerdings haben Sie dann weniger Kontrolle über Reihenfolge, Farben und Benennung.

Können mehrere Felder als Kartentitel angezeigt werden?

Ja. Die Felder Titel Feldname und Beschreibung Feldname unterstützen Mehrfachauswahl. Die ausgewählten Felder werden kombiniert auf der Karte dargestellt.

Wie beeinflusse ich die Sortierung der Karten innerhalb einer Spalte?

Die Karten werden innerhalb einer Spalte in der Reihenfolge angezeigt, wie sie von der Datenquelle geliefert werden. Um die Sortierung zu steuern, konfigurieren Sie die gewünschte Sortierung direkt in der Datenquelle des Ansichtselements.

Wie werden die Farben auf den Karten dargestellt?

Jede Karte erhält einen farbigen Rahmen am linken Rand. Die Farbe wird in dieser Reihenfolge ermittelt:

• Karten-Farbfeld (Einstellung Farbe Feldname im Karten-Bereich) — wenn gesetzt und mit Wert gefüllt, hat es Vorrang.
• Spalten-Farbe (aus Farbe Feldname der Spalten-Datenquelle oder Standard Spaltenfarbe) — wird als Fallback verwendet.

So können Sie z. B. die Spaltenfarbe zur Kennzeichnung des Status nutzen und zusätzlich einzelne Karten über ein eigenes Farb-Feld hervorheben (z. B. nach Priorität).