Nachdem Sie in 8.8 Oberfläche & Grundlagen das Layout-Gerüst erstellt haben, geht es nun um die Datenbindung und Datenaufbereitung. Sie lernen, wie Sie:

• Datenfelder aus der Feldliste an Steuerelemente binden
• Daten sortieren, gruppieren und filtern
• Parameter in Ausdrücken verwenden
• Berechnete Felder und Aggregatfunktionen erstellen

Jede Berichtsvorlage ist mit einer oder mehreren Datenquellen verbunden. Die verfügbaren Felder werden in der Feldliste (Field List) im Designer angezeigt.

Datenquellen in UDM

UDM verwendet JSON-Datenquellen, die automatisch aus den konfigurierten Datenquellen der Berichtsvorlage erzeugt werden. Im Designer erscheinen sie als Baumstruktur in der Feldliste:

• Berichtsdaten (Primäre Datenquelle) — Enthält die Hauptdaten für den Bericht. Sie wird auf dem Vorlagen-Tab unter „Primäre Datenquelle“ festgelegt.
• Weitere Datenquellen — Zusätzliche Datenquellen, die auf dem Tab „Weitere Datenquellen“ der Berichtsvorlage konfiguriert werden. Jede hat einen eigenen Knoten in der Feldliste.

Felder binden

1. Per Drag-and-Drop

   Ziehen Sie ein Feld aus der Feldliste direkt auf einen Berichtsbereich. Es wird automatisch ein Label mit Datenbindung erzeugt. Der Feldname erscheint in eckigen Klammern, z. B. [Firmenname].

2. Über das Eigenschaftenfenster

   Wählen Sie ein bestehendes Steuerelement aus. Im Eigenschaftenfenster finden Sie die Eigenschaft „Expression“ (oder „Text“ bei Labels). Klicken Sie auf die Schaltfläche (...), um den Expression Editor zu öffnen und ein Feld auszuwählen.

Datenfelder per Drag-and-Drop an Steuerelemente binden

Sortierung

Um die Daten im Bericht zu sortieren, wählen Sie den Detailbereich (Detail Band) aus und öffnen Sie im Eigenschaftenfenster die Eigenschaft „Sort Fields“. Fügen Sie ein oder mehrere Sortierfelder hinzu und legen Sie die Richtung fest (aufsteigend / absteigend).

Gruppierung

1. Gruppenkopf hinzufügen

   Rechtsklick auf die Designfläche → „Insert Band“ → „Group Header“.

2. Gruppierungsfeld festlegen

   Wählen Sie den Gruppenkopf aus. Im Eigenschaftenfenster öffnen Sie „Group Fields“ und wählen das Feld, nach dem gruppiert werden soll (z. B. Ort).

3. Gruppentitel anzeigen

   Ziehen Sie das Gruppierungsfeld aus der Feldliste in den Gruppenkopf-Bereich. So wird der Gruppenname (z. B. der Ortsname) als Überschrift über jeder Gruppe angezeigt.

4. Gruppenfuß für Zwischensummen

   Der zugehörige Gruppenfuß wird automatisch erstellt. Hier können Sie Aggregatfunktionen platzieren (siehe Abschnitt „Ausdrücke und Formeln“).

Gruppierung nach Ort mit Gruppenkopf und Gruppenfuß

Filterung

Der Bericht kann Daten über den Filter-Editor einschränken. Klicken Sie auf die leere Designfläche (den Bericht selbst) und öffnen Sie im Eigenschaftenfenster die Eigenschaft „Filter String“. Dort können Sie Bedingungen mit Feldern und Parametern definieren, z. B.:

[Erstelldatum] >= ?Berichtsmonat

Berechnete Felder

1. Feld hinzufügen

   Rechtsklick auf einen Datenquellen-Knoten in der Feldliste → „Add Calculated Field“.

2. Ausdruck definieren

   Im Eigenschaftenfenster des neuen Felds klicken Sie auf „Expression“ und geben die Formel ein, z. B.:
   [Vorname] + ' ' + [Nachname] (Textverkettung)
   [Menge] * [Einzelpreis] (Berechnung)

3. Datentyp festlegen

   Setzen Sie den Feldtyp passend zum Ergebnis: String, Int32, Decimal, DateTime usw.

4. Im Bericht verwenden

   Das berechnete Feld erscheint in der Feldliste und kann wie ein normales Datenfeld auf die Designfläche gezogen werden.

Berichtsparameter werden auf dem Tab „Parameter“ der Berichtsvorlage definiert (siehe 8.6 Berichtsvorlagen). Im Designer stehen sie automatisch zur Verfügung und können in Ausdrücken referenziert werden.

Der Expression Editor ist das zentrale Werkzeug für dynamische Inhalte. Sie erreichen ihn über die (...)-Schaltfläche neben Eigenschaften wie „Expression“, „Text“ oder „Visible“.

Ausdruck-Syntax

Aggregatfunktionen

Aggregatfunktionen werden typischerweise im Gruppenfuß oder Berichtsfuß verwendet:

UDM-Spezialfunktionen

Aufbauend auf dem tabellarischen Kundenbericht aus Teil 1 fügen wir Gruppierung, Aggregat und Parameterfilter hinzu.

1. Parameter anlegen

   Wechseln Sie auf den Tab „Parameter“ der Berichtsvorlage. Erstellen Sie einen Parameter Berichtsmonat vom Typ DateTime, markiert als „Notwendig“. Speichern Sie die Vorlage.

2. Gruppierung einrichten

   Zurück im Designer: Rechtsklick → „Insert Band“ → „Group Header“. Wählen Sie den Gruppenkopf und setzen Sie unter „Group Fields“ das Feld Ort. Ziehen Sie [Ort] als Label in den Gruppenkopf.

3. Anzahl pro Gruppe anzeigen

   Im automatisch erstellten Gruppenfuß platzieren Sie ein Label mit dem Ausdruck:
   'Anzahl Kunden: ' + Count()

   

   Gruppenfuß mit Anzahl der Kunden pro Ort

4. Filterausdruck mit Parameter

   Klicken Sie auf die leere Designfläche. Im Eigenschaftenfenster öffnen Sie „Filter String“ und geben ein:
   [Erstelldatum] >= ?Berichtsmonat

5. Parameterwert im Kopf anzeigen

   Fügen Sie im Berichtskopf ein Label hinzu mit dem Ausdruck:
   'Bericht ab: ' + FormatString('{0:MMMM yyyy}', ?Berichtsmonat)

6. Vorschau testen

   Wechseln Sie in den PREVIEW-Modus. Der Parameter-Dialog erscheint — geben Sie ein Datum ein und prüfen Sie, ob die Gruppierung und Filterung korrekt funktionieren.