Der FilterBuilder im UDM Admin Client ermöglicht Kundenadministratoren die Erstellung und Verwaltung komplexer Filterregeln für Datenansichten. Mit dem FilterBuilder legen Sie fest, welche Datensätze in einer Ansicht, einem Bericht oder einem Dashboard angezeigt werden.

Als Kundenadministrator können Sie:

• Filterbedingungen für einzelne Felder definieren (Text, Zahlen, Datum, Boolean)
• Mehrere Bedingungen mit UND- oder ODER-Verknüpfungen kombinieren
• Bedingungen in Gruppen verschachteln, um komplexe Logik abzubilden
• Flexible Datumsfilter mit vordefinierten Zeiträumen oder rollierenden Fenstern einrichten
• Über Foreign-Key-Felder in verknüpfte Tabellen navigieren und dort filtern

Ein Filter im UDM-System besteht aus zwei Bausteinen: Filtergruppen und Filterbedingungen. Diese können beliebig verschachtelt werden.

Filtergruppe

Eine Filtergruppe fasst mehrere Bedingungen oder Untergruppen zusammen und verknüpft sie mit einem gemeinsamen Operator — entweder UND oder ODER.

Filterbedingung

Eine einzelne Filterbedingung besteht aus drei Teilen:

• Feld — das Datenfeld, nach dem gefiltert wird (z. B. „Kundenname“, „Erstelldatum“)
• Operator — die Vergleichsart (z. B. „Gleich“, „Enthält“, „Größer als“)
• Wert — der Vergleichswert (z. B. „GmbH“, „2025“, „Ja“)

Verschachtelung

Gruppen können Untergruppen enthalten. So lassen sich beliebig komplexe Filterbedingungen aufbauen. Jede Gruppe hat ihre eigene UND/ODER-Verknüpfung.

Die verfügbaren Operatoren hängen vom Datentyp des gewählten Feldes ab. Die folgende Tabelle zeigt alle Operatoren im System.

Text-Operatoren

Numerische Operatoren

Boolean-Operatoren

Datums-Operatoren

Datumsfelder unterstützen dieselben Vergleichsoperatoren wie numerische Felder (=, ≠, >, ≥, <, ≤). Zusätzlich stehen vier spezialisierte Datumsmodi zur Verfügung — siehe Abschnitt „Datums-Filter Modi“.

Foreign-Key-Operatoren

Spezial-Operatoren

Datumsfilter bieten vier spezialisierte Modi, um verschiedene Anforderungen abzudecken. Der Modus wird über ein Dropdown neben dem Datumsfeld ausgewählt.

Absolut-Modus

Festes, konkretes Datum über eine Kalender-Auswahl. Geeignet für Stichtagsabfragen und einmalige Auswertungen.

Beispiel: Erstelldatum = 15.03.2026

Vordefiniert-Modus

Schnellauswahl häufig genutzter Zeiträume. Der Filter passt sich automatisch an das aktuelle Datum an.

Jeder vordefinierte Zeitraum lässt sich über zwei Parameter weiter anpassen:

• Type — die Zeiteinheit (Tag, Woche, Monat, Quartal, Halbjahr, Jahr)
• Offset — eine Verschiebung als positiver oder negativer Wert

Beispiel: „Dieser Monat“ mit Offset −3 ergibt den Monat, der drei Monate zurückliegt.

Rollierend-Modus

Ein Zeitfenster relativ zum aktuellen Zeitpunkt, das sich täglich automatisch verschiebt.

Beispiele:

• Letzte 7 Tage: Einheit = Tage, Menge = −7
• Nächste 30 Tage: Einheit = Tage, Menge = 30
• Letzte 3 Monate: Einheit = Monate, Menge = −3

Teildatum-Modus

Filtert nach einzelnen Bestandteilen eines Datums — unabhängig vom restlichen Datum.

Beispiel: Erstelldatum: Monat = März — findet alle Einträge aus dem März, egal welches Jahr.

1. FilterBuilder öffnen

   Öffnen Sie den FilterBuilder in der gewünschten Konfiguration — z. B. in einer Datenansicht, einem Report oder einer Berechtigungsregel. Falls noch kein Filter vorhanden ist, sehen Sie die Schaltflächen „+ Bedingung“ und „+ Gruppe“.

2. Erste Bedingung hinzufügen

   Klicken Sie auf „+ Bedingung“. Es wird eine neue Filterzeile angelegt. Standardmäßig wird das erste sichtbare Feld mit dem Operator „Gleich“ vorausgewählt.

3. Feld auswählen

   Klicken Sie auf das Feld-Dropdown und wählen Sie das Datenfeld, nach dem Sie filtern möchten. Es werden nur sichtbare Felder der Datenquelle angezeigt.

4. Operator wählen

   Wählen Sie im Operator-Dropdown den gewünschten Vergleichsoperator. Die verfügbaren Operatoren passen sich automatisch an den Datentyp des Feldes an.

5. Vergleichswert eingeben

   Geben Sie den Vergleichswert ein. Bei Textfeldern erscheint ein Eingabefeld, bei Zahlen ein numerisches Feld, bei Datumsfeldern die Modusauswahl und bei Foreign-Key-Feldern eine Multi-Select-Liste.

   Einige Operatoren wie „Ist leer“, „Ist nicht leer“, „Ist wahr“ und „Ist falsch“ benötigen keinen Vergleichswert.

6. Weitere Bedingungen oder Gruppen hinzufügen

   Klicken Sie erneut auf „+ Bedingung“, um eine weitere Bedingung in derselben Gruppe anzulegen. Klicken Sie auf „+ Gruppe“, um eine verschachtelte Untergruppe mit eigener UND/ODER-Verknüpfung zu erstellen.

7. Gruppenverknüpfung anpassen

   Ändern Sie die Verknüpfung einer Gruppe über das Dropdown am Anfang der Gruppe. Wählen Sie zwischen UND (alle Bedingungen müssen zutreffen) und ODER (mindestens eine muss zutreffen).

8. Bedingung oder Gruppe entfernen

   Klicken Sie auf das Löschen-Symbol rechts neben einer Bedingung oder Gruppe, um sie zu entfernen. Wird die letzte Bedingung einer Gruppe entfernt, wird die gesamte Gruppe aufgelöst.

Felder, die auf andere Tabellen verweisen (z. B. „Kunde“, „Fahrzeugstatus“), bieten zwei Filtervarianten.

Einfacher FK-Filter (Multi-Select)

Wählen Sie einen oder mehrere Werte aus der verknüpften Tabelle. Die verfügbaren Werte werden automatisch geladen und alphabetisch sortiert angezeigt.

• Operator ∈ (Ist in Liste) — Datensatz wird angezeigt, wenn der FK-Wert in der Auswahl enthalten ist
• Operator ∉ (Ist nicht in Liste) — Datensatz wird angezeigt, wenn der FK-Wert nicht in der Auswahl enthalten ist

FK-Subfeld-Filter (Navigation in verknüpfte Tabelle)

Statt nach IDs zu filtern, können Sie in die verknüpfte Tabelle navigieren und nach dortigen Feldern filtern.

1. FK-Feld auswählen

   Wählen Sie das Foreign-Key-Feld (z. B. „Fahrzeugstatus“) im Feld-Dropdown.

2. In die verknüpfte Tabelle navigieren

   Klicken Sie auf den Navigations-Pfeil neben dem FK-Feld. Das Dropdown zeigt nun die Felder der verknüpften Tabelle.

3. Subfeld auswählen

   Wählen Sie das gewünschte Feld in der verknüpften Tabelle (z. B. „StatusName“). Ein Zurück-Button am Anfang der Liste ermöglicht die Rückkehr zur Haupttabelle.

4. Operator und Wert setzen

   Konfigurieren Sie den Filter wie gewohnt mit Operator und Wert. Die Anzeige zeigt den vollständigen Pfad, z. B. FahrzeugStatus.StatusName = 'Aktiv'.

Warum sehe ich nicht alle Felder im Feld-Dropdown?

Im FilterBuilder werden nur sichtbare Felder der Datenquelle angezeigt. Wenn ein Feld in der Entitätskonfiguration als unsichtbar markiert ist, erscheint es nicht im Dropdown. Prüfen Sie die Feldkonfiguration in der Entitätsverwaltung.

Wie ändere ich die Verknüpfung von UND auf ODER?

Klicken Sie auf das Dropdown am Anfang der Filtergruppe (standardmäßig „UND“) und wählen Sie „ODER“. Die Änderung gilt für alle Bedingungen innerhalb dieser Gruppe.

Kann ich Filter verschachteln?

Ja. Klicken Sie auf „+ Gruppe“, um eine Untergruppe mit eigener UND/ODER-Verknüpfung zu erstellen. Untergruppen können wiederum weitere Untergruppen enthalten.

Was passiert, wenn ein rollierender Datumsfilter gespeichert wird?

Rollierende Filter speichern die Konfiguration (z. B. „letzte 7 Tage“), nicht den konkreten Datumsbereich. Bei jeder Ausführung wird der Bereich anhand des aktuellen Datums neu berechnet.

Wie filtere ich nach einem Feld in einer verknüpften Tabelle?

Wählen Sie das FK-Feld aus und klicken Sie auf den Navigations-Pfeil. Sie sehen nun die Felder der verknüpften Tabelle. Wählen Sie dort das gewünschte Feld und konfigurieren Sie Operator und Wert. Mit dem Zurück-Button gelangen Sie zurück zur Haupttabelle.

Wie entferne ich den gesamten Filter?

Entfernen Sie alle Bedingungen einzeln über das Löschen-Symbol, oder nutzen Sie die Schaltfläche „Filter zurücksetzen“, sofern diese in der jeweiligen Ansicht verfügbar ist.

Werden Änderungen am Filter automatisch gespeichert?

Nein. Der Filter muss über die entsprechende Speichern-Funktion der Ansicht oder Konfiguration explizit gespeichert werden. Änderungen gehen verloren, wenn Sie die Seite ohne Speichern verlassen.

Unterstützt der FilterBuilder Platzhalter oder Wildcards?

Nicht direkt. Verwenden Sie stattdessen die Operatoren „Enthält“, „Beginnt mit“ oder „Endet mit“, um ähnliche Ergebnisse zu erzielen.