Validierer


Validierer können einem Element zugeordnet werden, um zu prüfen ob deren Wert als gültig oder ungültig gewertet werden soll. Im letzteren Fall gilt das entsprechende Element als "nicht valide", was dann ggf. auch für übergeordnete Elemente gilt. In Erfassungsmasken für Geschäftsobjekte wird das "Speichern" verweigert, solange "nicht valide" Elemente enthalten sind, so wie das auch ohne die Konfiguration von Validierern der Fall ist, wenn nicht alle Pflichtfelder gefüllt sind.

Für dasselbe Feld können dabei mehrere Validierer konfiguriert werden, wobei jedem Validierer eine bestimmte Prüfbedingung und ein "Infotext" zugewiesen wird, der unterhalb des Elements erscheint, wenn die Prüfung fehlschlägt. Falls mehrere Validierer konfiguriert sind, erfolgt die Prüfung in der per Drag & Drop wählbaren Reihenfolge innherhalb der Konfiguration und der erste Fehlschlag liefert den Infotext für die Anzeige unterhalb des Elements (s. Beispiele unten). Für Pflichtfelder hat die Prüfung auf "leer" allerdings immer höchste Priorität. Solange ein Pflichtfeld leer ist erscheint deshalb immer der Standardtext ("Dieses Feld muss ausgefüllt werden.") unter dem Element.

Zur Definition der Prüfbedingung muss einer der nachfolgenden aufgelisteten Validierertypen ausgewählt und mit spezifischen Parametern versehen werden.

Unabhängig vom Validierertyp werden folgende Einstellungen angeboten:

  • Infotext: Meldungstext (oder eine Zuordnung aus der Sprachverwaltung) für die Anzeige unter dem Element, sobald bzw. solange die Prüfbedingung nicht erfüllt ist

  • Option "Nur wenn Pflichtfeld": Checkbox, die entscheidet, ob der Validierer nur abhängig von der "Pflichtfeld"-Eigenschaft des Elements ausgewertet werden soll.

  • Option "Nur wenn gefüllt": Checkbox, die entscheidet, ob der Validierer nur ausgewertet werden soll, wenn das Element überhaupt einen Wert enthält.

  • Text bei Bestehen: Ein optionaler Text, welcher angezeigt wird, wenn der Validierer bestanden hat. Sind mehrere Validierer mit Erfolgsmeldung konfiguriert, wird die des letzten Validierers angezeigt.

  • Option "Bestehen visualisieren": Ist diese Option aktiviert, wird bei bestandener Validierung das Element entsprechend farblich gekennzeichnet.

images/download/attachments/189437268/image-2024-11-11_15-18-0-version-1-modificationdate-1731334679957-api-v2.png

Tipp: Die Texte werden auch als Berechnungsausdruck ausgewertet.

Konfiguration

Über die Eigenschaftenkategorie "Validierung" können die Validierer je Element konfiguriert werden.

images/download/attachments/189437268/image-2024-11-11_15-1-35-version-1-modificationdate-1731333695491-api-v2.png

Durch Klicken auf das images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/add.svg Symbol können Validierer hinzugefügt werden. Direkt nach dem Klick erscheint eine Auswahlliste mit sämtlichen unterstützten Validierertypen.

Der auswählte Typ wird anschließend als Beschriftung des Validierers in der Liste angezeigt.

images/download/attachments/189437268/image-2024-11-11_15-3-55-version-1-modificationdate-1731333835923-api-v2.png images/download/attachments/189437268/image2018-5-18_14_25_30-version-1-modificationdate-1731333472238-api-v2.png

Über die images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/forbidden.svg Schaltfläche (1) kann ein Validierer wieder entfernt werden. Durch einen Doppelklick oder aber auch durch einen Klick auf das Pfeilsymbol (2) wird die Konfiguration des Validierers geöffnet.

images/download/attachments/189437268/image-2024-11-11_15-6-55-version-1-modificationdate-1731334015681-api-v2.png

Welche Parameter zur Konfiguration des Validierers zur Verfügung stehen, hängt vom Validierertyp ab.

Beispiel

Der Wert eines Textfeldes soll nur als gültig angesehen werden, wenn dessen Wert eine Ganzzahl ist und zwischen 1 und 100 liegt.

Konfiguration

Ergebnis

images/download/attachments/189437268/image2018-5-18_14_47_55-version-1-modificationdate-1731333472242-api-v2.png

images/download/attachments/189437268/image2018-5-18_14_49_38-version-1-modificationdate-1731333472244-api-v2.png

images/download/attachments/189437268/image2018-5-18_14_50_39-version-1-modificationdate-1731333472249-api-v2.png

images/download/attachments/189437268/image2018-5-18_14_51_4-version-1-modificationdate-1731333472253-api-v2.png

images/download/attachments/189437268/image2018-5-18_14_51_24-version-1-modificationdate-1731333472251-api-v2.png

images/download/attachments/189437268/image2018-5-18_14_51_51-version-1-modificationdate-1731333472255-api-v2.png



Zusätzlich können auch ein "Text bei Bestehen" und die Visualisierung des Erfolgs festgelegt werden.

images/download/attachments/189437268/image2019-10-7_13-51-59-version-1-modificationdate-1731333472262-api-v2.png


images/download/attachments/189437268/image2019-10-7_13-52-47-version-1-modificationdate-1731333472264-api-v2.png