Ausgabespalten legen fest, welche Felder in einer Tabelle, Liste oder Kartenansicht angezeigt werden. Sie bestimmen außerdem die Reihenfolge, die Spaltenbreite, das Anzeigeformat und optionale Datenanreicherungen (Enrichments) oder KPI-Indikatoren.

Die Spaltenkonfiguration existiert auf drei Ebenen, die hierarchisch vererbt werden:

Spalten in einer Datenquelle verwalten

1. Datenquelle öffnen

   Navigieren Sie im Admin-Bereich zur gewünschten Datenquelle und wechseln Sie zum Tab „Ausgabespalten“.

2. Vorhandene Spalten prüfen

   Die Tabelle zeigt alle derzeit konfigurierten Ausgabespalten mit Feldname, Titel, Datentyp und Reihenfolge.

3. Spalte hinzufügen

   Klicken Sie in der Toolbar auf „Hinzufügen“. Es öffnet sich eine Auswahl aller verfügbaren Felder des zugrunde liegenden Objekts. Wählen Sie eines oder mehrere Felder aus und bestätigen Sie.

4. Spalte entfernen

   Wählen Sie die gewünschte Zeile und klicken Sie auf den Löschen-Button in der Zeilen-Aktion. Die Spalte wird aus der Ausgabe entfernt.

5. Speichern

   Vergessen Sie nicht, die Datenquelle zu speichern, damit die Änderungen wirksam werden.

Ungebundenes Feld anlegen

Klicken Sie auf „Neues Feld“ in der Toolbar, um eine Spalte ohne Datenbankbindung hinzuzufügen. Solche Felder können über dynamischen Code (C#) oder über eine Aggregationsregel befüllt werden.

Berechnete Spalte anlegen

Klicken Sie auf „Berechnete Spalte“ (Taschenrechner-Symbol). Es wird ein neues ungebundenes Feld erstellt und automatisch die Spaltenkonfiguration mit einer vorbereiteten Aggregationsregel geöffnet.

Spalten in einem Ansichtselement verwalten

Das Vorgehen ist identisch: Öffnen Sie das Ansichtselement, wechseln Sie zum Tab „Ausgabespalten“ und verwenden Sie die gleichen Toolbar-Aktionen.

Spaltenreihenfolge ändern

Die Spaltenreihenfolge wird über das Feld „Reihenfolge“ (OrderNr) in der Ausgabespalten-Tabelle gesteuert. Ändern Sie den Wert direkt im Grid — niedrigere Werte erscheinen weiter links.

Spaltentitel anpassen

Jede Ausgabespalte hat ein Feld „Titel“. Dieser Text wird als Spaltenüberschrift im Anwender-Client angezeigt. Wenn das Feld leer ist, wird der Feldname des Objekts als Fallback verwendet.

Spaltenbreite

Die Spaltenbreite wird im Ansichtselement über die jeweilige Grid-Konfiguration gesteuert. In der Datenquelle selbst wird keine Breite definiert — diese steuert nur, welche Spalten verfügbar sind.

Maximale Anzeigezeichen (MaxDisplayChars)

Mit dem Feld „Max. Anzeigezeichen“ können Sie die Anzahl der angezeigten Zeichen für Textwerte begrenzen. Längerer Text wird abgeschnitten und mit einem Auslassungszeichen (…) dargestellt.

Das DisplayFormat bestimmt, wie ein Wert in der Tabelle dargestellt wird. Es wird direkt in der Ausgabespalten-Zeile im Feld „Anzeigeformat“ hinterlegt.

Datenanreicherungen transformieren Spaltenwerte zur Laufzeit, ohne dass Sie dynamischen Code schreiben müssen. Sie werden in der Spaltenkonfiguration als geordnete Liste von Regeln definiert und nacheinander auf den Wert angewendet.

Spaltenkonfiguration öffnen

1. Ausgabespalten-Tab öffnen

   Navigieren Sie zur Datenquelle oder zum Ansichtselement und wechseln Sie zum Tab „Ausgabespalten“.

2. Zeilen-Aktion „Spaltenkonfiguration“ klicken

   Klicken Sie in der Zeile der gewünschten Spalte auf das Schieberegler-Symbol (fa-sliders). Die Spaltenkonfiguration öffnet sich als Seitenbereich rechts neben der Ausgabespalten-Tabelle.

Bei einem Objekt-Feld erreichen Sie die Spaltenkonfiguration über den Detail-Dialog des Feldes → Subdialog „Anreicherung“.

Verfügbare Enrichment-Typen

Datumsberechnung im Detail

Die Datumsberechnung kennt fünf Operationen, die über das Feld Operation ausgewählt werden:

Tipp: Für ein Mitglieder-Grid mit nächstem Geburtstag und Tagen bis dahin legen Sie zwei berechnete Spalten an, beide mit Quellfeld Geburtsdatum: eine mit NextAnniversary, eine mit UntilAnniversary (Einheit Days). Beide Operationen lesen das Quellfeld unabhängig — keine Verkettung nötig.

Enrichment-Regel hinzufügen

1. Spaltenkonfiguration öffnen

   Öffnen Sie die Spaltenkonfiguration wie oben beschrieben (Schieberegler-Symbol oder Subdialog „Anreicherung“).

2. Button „Enrichment hinzufügen“ klicken

   Am unteren Rand des Konfigurationsbereichs finden Sie ein Dropdown. Wählen Sie den gewünschten Regeltyp (z. B. PrefixSuffix, Template, Math).

3. Regel konfigurieren

   Die neue Regel erscheint als farbige Karte. Jeder Regeltyp zeigt nur die für ihn relevanten Felder an:

   • PrefixSuffix: Prefix-Text, Suffix-Text
   • Template: Template-String mit Feldnamen in {geschweifte Klammern}
   • Math: Operation (Addieren, Subtrahieren, Multiplizieren, Dividieren, Runden) und Faktor
   • Lookup: Ziel-Objekt (Entity), Schlüsselfeld, Anzeigefeld
4. Zielfeld festlegen (optional)

   Standardmäßig schreibt die Regel in das gleiche Feld. Über das Feld „Zielfeld“ können Sie den Wert in ein anderes (ggf. neues) Feld schreiben lassen.

5. Speichern

   Speichern Sie die Datenquelle oder das Ansichtselement. Die Enrichment-Regeln werden bei der nächsten Datenabfrage automatisch angewendet.

Regeln verketten (Chaining)

Mehrere Enrichment-Regeln können nacheinander auf dasselbe Feld angewendet werden. Die Reihenfolge wird über die Feld-Nummer (OrderNr) gesteuert. Das Ergebnis einer Regel ist der Eingabewert der nächsten Regel.

Regel aktivieren / deaktivieren

Jede Regelkarte hat eine Checkbox zum Aktivieren/Deaktivieren. Deaktivierte Regeln werden bei der Verarbeitung übersprungen, bleiben aber in der Konfiguration erhalten.

Vererbungssteuerung für Enrichments

Auf Datenquellen- und Ansichtselement-Ebene können Sie steuern, wie die Enrichments der Elternebene behandelt werden:

Spaltenwerte können als visuelle KPI-Indikatoren dargestellt werden — z. B. als Ampel, Fortschrittsbalken, Badge oder Sternebewertung. Die vollständige Anleitung zur KPI-Konfiguration finden Sie in:

Mit der Mini-Chart-Funktion können Sie numerische Spaltenwerte als kleine Inline-Diagramme direkt in der Tabellenzelle darstellen. So werden Verhältnisse und Trends auf einen Blick sichtbar.

Verfügbare Diagrammtypen

Mini-Chart einrichten

1. Ausgabespalte auswählen

   Wählen Sie im Tab „Ausgabespalten“ die Spalte aus, in der das Mini-Chart angezeigt werden soll.

2. Mini-Chart aktivieren

   Setzen Sie im Detailbereich rechts das Häkchen bei „Mini-Chart“. Die Konfigurationsoptionen werden eingeblendet.

3. Diagrammtyp und Größe wählen

   Wählen Sie den gewünschten Diagrammtyp aus der Dropdown-Liste. Die Größe (in Pixel) bestimmt die Höhe bzw. den Durchmesser des Diagramms in der Tabellenzelle.

4. Datenspalten zuordnen

   Unter „Spalten“ legen Sie fest, welche numerischen Felder als Datenpunkte verwendet werden. Klicken Sie auf „Spalte hinzufügen“ und wählen Sie das gewünschte Feld aus.

5. Farbe zuweisen

   Jede Datenspalte hat einen Farbwähler. Klicken Sie auf das Farbfeld, um eine Farbe aus der Palette auszuwählen oder einen eigenen Hex-Code einzugeben.

6. Speichern und Vorschau prüfen

   Speichern Sie die Änderungen und wechseln Sie in die Vorschau, um das Ergebnis in der Tabelle zu sehen.

Optionale Einstellungen

Beispiel 1: Währungsbetrag mit Prefix

Sie möchten, dass die Spalte „Betrag“ automatisch die Währung anzeigt:

• Enrichment-Typ: PrefixSuffix
• Suffix: EUR
• Ergebnis: 150,00 EUR

Beispiel 2: Vollständiger Name aus Einzelfeldern

Sie möchten Vor- und Nachname in einer Spalte kombinieren:

• Enrichment-Typ: Template
• Template: {Nachname}, {Vorname}
• Zielfeld: VollerName (neues Feld)
• Ergebnis: Mustermann, Max

Beispiel 3: Nettobetrag zu Brutto umrechnen

Sie möchten den Nettobetrag automatisch mit MwSt. anzeigen:

• Enrichment-Typ: Math
• Operation: Multiplizieren, Faktor: 1,19
• Zielfeld: BruttoBetrag

Beispiel 4: Null-Werte durch Platzhalter ersetzen

• Enrichment-Typ: Conditional
• Null-Ersatzwert: (nicht gesetzt)
• Leer-Ersatzwert: (leer)

Beispiel 5: Anzahl offener Aufgaben (Berechnete Spalte)

1. „Berechnete Spalte“ klicken

   In der Datenquelle des Vorgangs: Toolbar → „Berechnete Spalte“.

2. Spalte benennen

   Ausgabename: AnzahlOffeneAufgaben, Titel: Offene Aufgaben, Datentyp: Int32.

3. Aggregation konfigurieren
   • Ziel-Objekt: Aufgabe
   • Lokales Schlüsselfeld: VorgangId
   • Fremd-Schlüsselfeld: VorgangId
   • Aggregationstyp: Count
   • Filter: Status = Offen
4. Optional: KPI-Indikator

   Ampel mit Schwellwerten: Grün bei 0, Gelb bei 1–3, Rot ab 4.

5. Speichern

   Die Spalte zeigt nun die Anzahl offener Aufgaben pro Vorgang an.

Muss ich eine Anreicherung auf jeder Ebene neu konfigurieren?

Nein. Durch das Vererbungsprinzip werden Einstellungen automatisch von der Objekt-Ebene über die Datenquelle bis zum Ansichtselement durchgereicht. Sie müssen nur dort konfigurieren, wo Sie etwas ändern oder ergänzen möchten.

In welcher Reihenfolge werden Enrichments und dynamischer Code ausgeführt?

Enrichments laufen vor dem dynamischen Code. Auf Entity-Ebene laufen Enrichments vor OnAfterGetData. Auf Datenquellen-Ebene laufen Enrichments vor OnProcessRow. Dynamischer Code kann also auf bereits angereicherte Werte zugreifen.

Kann ich mehrere Anreicherungsregeln auf dieselbe Spalte anwenden?

Ja. Regeln werden in der konfigurierten Reihenfolge nacheinander angewendet (Chaining). So können Sie z. B. zuerst trimmen, dann in Großbuchstaben umwandeln und abschließend einen Prefix hinzufügen.

Was ist der Unterschied zwischen DisplayFormat und dem Format-Enrichment?

Das DisplayFormat wird direkt im Ausgabespalten-Grid gepflegt und dient der Grundformatierung. Das Format-Enrichment ist eine zusätzliche Regel innerhalb der Spaltenkonfiguration und kann mit anderen Enrichments kombiniert und verkettet werden.

Was passiert, wenn ein Lookup-Wert nicht gefunden wird?

Wenn der Schlüsselwert im Ziel-Objekt nicht existiert, bleibt der Originalwert erhalten. Es wird kein Fehler erzeugt.

Werden Aggregationen bei jeder Abfrage neu berechnet?

Ja. Aggregationen werden als SQL-Unterabfrage ausgeführt und liefern immer den aktuellen Stand. Es gibt keinen Cache.

Kann ich eine berechnete Spalte nachträglich bearbeiten?

Ja. Öffnen Sie einfach die Spaltenkonfiguration der berechneten Spalte über das Schieberegler-Symbol. Die Aggregationsregel kann jederzeit geändert oder durch andere Enrichment-Regeln ergänzt werden.