Validierungsregeln stellen sicher, dass Daten bestimmte Kriterien erfüllen, bevor sie gespeichert werden. UDM unterstützt dabei zwei Ebenen:

• Dialog-Regeln (Client-Validierung) — werden direkt im Bearbeitungsdialog geprüft, noch bevor die Daten an den Server gesendet werden. Der Anwender erhält sofortiges Feedback.
• Entity-Regeln (Server-Validierung) — werden serverseitig beim Speichern geprüft. Sie greifen unabhängig vom Dialog, z. B. auch bei Importen oder API-Zugriffen.

Typische Anwendungsfälle sind Pflichtfelder, Wertebereiche, Format-Prüfungen (E-Mail, IBAN), Eindeutigkeitsprüfungen und komplexe Geschäftsregeln per DynamicCode.

Die einfachste Form der Validierung ist das Pflichtfeld. Sie können ein Feld auf zwei Wegen als Pflichtfeld markieren:

• Auf Entity-Ebene — in der Spaltenkonfiguration der Entität. Gilt dann für alle Dialoge, die dieses Feld verwenden.
• Auf Dialog-Ebene — im Dialog-Designer für ein einzelnes Dialogelement. Gilt nur für diesen spezifischen Dialog.

In unserem Beispiel: Öffnen Sie den Rechnungsdialog im Dialog-Designer, wählen Sie das Element „Kunde“ aus und aktivieren Sie die Eigenschaft „Pflichtfeld“ im Eigenschaftenpanel.

Für Regeln, die über ein einfaches Pflichtfeld hinausgehen, wechseln Sie im Dialog-Designer auf den Tab „Regeln“ des ausgewählten Elements.

1. Element im Dialog-Designer auswählen

   Klicken Sie auf das Dialogelement, für das Sie eine Regel definieren möchten — in unserem Beispiel das Feld „Betrag“.

2. Tab „Regeln“ öffnen

   Unterhalb des Eigenschaftenpanels finden Sie den Tab „Regeln“. Die Zahl in Klammern zeigt die Anzahl aktiver Regeln.

3. Neue Regel hinzufügen

   Klicken Sie auf „Regel hinzufügen“. Wählen Sie den Regeltyp aus der Dropdown-Liste — für den Betrag wählen wir PositiveOnly (nur positive Werte, größer 0).

4. Parameter konfigurieren

   Je nach Regeltyp stehen ein oder zwei Parameter zur Verfügung. Bei PositiveOnly sind keine weiteren Parameter erforderlich. Bei einer Range-Regel würden Sie Minimum (Parameter 1) und Maximum (Parameter 2) angeben.

Jede Regel erzeugt im Fehlerfall eine Meldung. UDM generiert automatisch eine Standardmeldung basierend auf dem Regeltyp. Sie können jedoch eine benutzerdefinierte Fehlermeldung hinterlegen, die für Ihre Anwender verständlicher ist.

In unserem Beispiel: Für die PositiveOnly-Regel am Feld „Betrag“ hinterlegen wir die benutzerdefinierte Meldung: Der Rechnungsbetrag muss größer als 0 sein.

Zusätzlich können Sie den Schweregrad festlegen:

Für Geschäftsregeln, die über die deklarativen Regeltypen hinausgehen, steht DynamicCode zur Verfügung. Damit können Sie beliebige C#-Logik als Validierung hinterlegen.

In unserem Beispiel: Das Fälligkeitsdatum muss nach dem Rechnungsdatum liegen. Dafür verwenden wir entweder die eingebaute Regel DateGreaterThanField (mit Verweis auf das Vergleichsfeld) oder — bei komplexerer Logik — einen DynamicCode-Block.

UDM bietet eine Vielzahl deklarativer Regeltypen, gruppiert nach Kategorie:

Wertpräsenz

Text & Format

Numerisch & Wertebereich

Datum & Eindeutigkeit

Benutzerdefiniert

Neben den Dialog-bezogenen Regeln können Sie Validierungsregeln auch direkt auf Entity-Ebene definieren. Diese gelten global und werden bei jedem Speichervorgang serverseitig geprüft — unabhängig davon, ob die Daten über einen Dialog, einen Import oder eine API-Schnittstelle eingehen.

Entity-Regeln konfigurieren Sie in der Entitäten-Verwaltung im Bereich „Server-Regeln“. Dort wählen Sie das Feld und den Regeltyp aus — die verfügbaren Regeltypen sind identisch mit den Dialog-Regeln.

Jede Regel besitzt einen Aktiv-Schalter. Damit können Sie eine Regel temporär deaktivieren, ohne sie zu löschen. Dies ist nützlich bei:

• Datenmigration — bestimmte Prüfungen vorübergehend aussetzen
• Fehlerbehebung — gezielt einzelne Regeln testen
• Stufenweiser Einführung — Regeln vorbereiten und später scharfschalten

Der neue AllowNull-Schalter legt fest, ob ein Feld NULL-Werte (leere Werte) zulässt. Wenn deaktiviert, wird beim Speichern eine Validierungsmeldung angezeigt, falls das Feld leer ist.

Der AllowNull-Schalter ist eine einfachere Alternative zu einer Pflichtfeld-Validierungsregel und kann direkt in den Feldeinstellungen konfiguriert werden.