Validierungs- und Prüfservices

Validierungs- und Prüfservices

Diese Seite beschreibt die verfügbaren Services zur Validierung von Benutzereingaben sowie die regelbasierten Prüfungen für Zahlungs- und Versandarten.

Die Services sind keine klassischen Konfigurationsknoten mit eigener Struktur, sondern werden in den jeweiligen Formular- oder Regeldefinitionen referenziert (z. B. in Account-, Checkout- oder Payment-/Shipping-Konfigurationen).

 


Inhaltsverzeichnis

 


 

1. addressCheck.* - Adressvalidierungen

adressCheck.* enthält Prüfungen für Adressfelder (z.B. Name, Straße, PLZ). Die Prüfungen werden in den jeweiligen Felddefinitionen unter validations hinterlegt.

Das Frontend zeigt die Felder wie konfiguriert an und prüft beim Ausfüllen, ob die Eingaben gültig sind. So werden falsche oder unzulässige Werte früh erkannt. [Link]

1.1 addressCheck.minLength - Mindestlänge

Prüft die Mindestlänge der Eingabe bei Adressfeldern.

 

Beispielkonfiguration für (accounts.addressField.firstName)

{ "label": "", "name": "firstName", "validations": [ { "options": { "len": 1 }, "service": "addressCheck.minLength" } ] }

 

Parameterübersicht

Parameter

Beschreibung

Parameter

Beschreibung

len

Gewünschte Mindestlänge in Zahlen.

 

1.2 addressCheck.maxLength - Maximallänge

Prüft die Maximallänge der Eingabe bei Adressfeldern.

 

Beispielkonfiguration für (accounts.addressField.firstName)

{ "label": "", "name": "firstName", "validations": [ { "options": { "len": 255 }, "service": "addressCheck.maxLength" } ] }

 

Parameterübersicht

Parameter

Beschreibung

Parameter

Beschreibung

len

Gewünschte Maximallänge in Zahlen.

 

1.3 addressCheck.numeric - Nur Ziffern

Prüft, ob die Eingabe bei Adressfelder nur aus Ziffern besteht.

 

Beispielkonfiguration für (accounts.addressField.phone)

{ "label": "", "name": "phone", "validations": [ { "service": "addressCheck.numeric" } ] }

 

Parameterübersicht

Parameter

Beschreibung

Parameter

Beschreibung

--

Keine zusätzlichen Parameter.

 

1.4 addressCheck.country - Ländercode (ISO)

Prüft, ob die Eingabe resp. Auswahl bei Länderlisten der Adressdatenfelder ein im Shop konfigurierter Ländercode ist (ISO-Code: 2-stellig, 3-stellig oder ISO-Nummer).

Die offiziellen ISO-3166-1-Codes (alpha-2, alpha-3 und numerisch) finden sich auf der Website der International Organization for Standardization (ISO): ISO - ISO 3166 — Country Codes

 

Beispielkonfiguration für (accounts.addressField.country)

{ "label": "", "name": "country", "validations": [ { "service": "addressCheck.country" } ] }

 

Parameterübersicht

Parameter

Beschreibung

Parameter

Beschreibung

--

Keine zusätzlichen Parameter.

 

1.5 addressCheck.zip - Postleitzahl (PLZ)

Prüft, ob die Eingabe eine gültige Postleitzahl (PLZ) für das angegebene Land ist. Die PLZ-Regeln stammen aus der Konfiguration. Das dazugehörige Land muss zwingend im Feld country übergeben werden.

 

Beispielkonfiguration für (accounts.addressField.country)

{ "label": "", "name": "zip", "validations": [ { "service": "addressCheck.zip" } ] }

 

Parameterübersicht

Parameter

Beschreibung

Parameter

Beschreibung

--

Keine zusätzlichen Parameter.

 

1.6 addressCheck.salutation - Anrede (Code)

Prüft, ob die Eingabe eine gültige Anrede ist (Code gemäß Konfiguration).

 

Beispielkonfiguration für (accounts.addressField.salutationCode)

{ "label": "", "name": "salutationCode", "validations": [ { "service": "addressCheck.salutation" } ] }

 

Parameterübersicht

Parameter

Beschreibung

Parameter

Beschreibung

--

Keine zusätzlichen Parameter.

 

1.7 addressCheck.regex - Regulärer Ausdruck

Prüft, ob die Eingabe zu einem regulären Ausdruck passt.

 

Beispielkonfiguration für (accounts.addressField.additionalInfo)

{ "label": "", "name": "additionalInfo", "validations": [ { "options": { "expression": "^((?i)(?!Postfach).)*$" }, "service": "addressCheck.regex" } ] }

 

Parameterübersicht

Parameter

Beschreibung

Parameter

Beschreibung

expression

Regulärer Ausdruck (Zeichenkette).

 

1.8 addressCheck.phone - Telefonnummer

rüft, ob die Eingabe eine gültige Telefonnummer ist. Eine gültige Nummer besteht aus Ziffern (ohne Längenbeschränkung) und optional einer internationalen Vorwahl.

Das + in der Vorwahl wird nach erfolgreicher Validierung durch 00 ersetzt.

 

Beispielkonfiguration für (accounts.addressField.phone)

{ "label": "", "name": "phone", "validations": [ { "service": "addressCheck.phone" } ] }

 

Parameterübersicht

Parameter

Beschreibung

Parameter

Beschreibung

--

Keine zusätzlichen Parameter.

 

1.9 addressCheck.alpha - Nur Buchstaben (A–Z)

Prüft, ob die Eingabe nur aus lateinischen Buchstaben besteht (Groß-/Kleinschreibung egal).

 

Beispielkonfiguration für (accounts.addressField.additionalInfo)

{ "label": "", "name": "additionalInfo", "validations": [ { "service": "addressCheck.alpha" } ] }

 

Parameterübersicht

Parameter

Beschreibung

Parameter

Beschreibung

--

Keine zusätzlichen Parameter.

 

1.10 addressCheck.alphanum - Buchstaben/Ziffern (A–Z/0–9)

Prüft, ob die Eingabe nur aus lateinischen Buchstaben oder Ziffern besteht (Groß-/Kleinschreibung egal).

 

Beispielkonfiguration für (accounts.addressField.additionalInfo)

{ "label": "", "name": "additionalInfo", "validations": [ { "service": "addressCheck.alphanum" } ] }

 

Parameterübersicht

Parameter

Beschreibung

Parameter

Beschreibung

--

Keine zusätzlichen Parameter.

 

1.11 addressCheck.legalSigns - Erlaubte Zeichen

Prüft, ob alle Zeichen der Eingabe in der erlaubten Zeichenauswahl enthalten sind (Groß-/Kleinschreibung relevant).

 

Beispielkonfiguration für (accounts.addressField.additionalInfo)

{ "label": "", "name": "additionalInfo", "validations": [ { "options": { "signs": "123456ABCSDEF" }, "service": "addressCheck.legalSigns" } ] }

 

Parameterübersicht

Parameter

Beschreibung

Parameter

Beschreibung

signs

Erlaubte Zeichen (Zeichenkette).

 

1.12 addressCheck.illegalSigns - Verbotene Zeichen

Gegenteil von legalSigns: Die Eingabe darf keines der angegebenen Zeichen enthalten.

 

Beispielkonfiguration für (accounts.addressField.phone)

{ "label": "", "name": "phone", "validations": [ { "options": { "signs": ""*|~%${};"<>§@ “ ()/-_" #*|~%${}“ ;"<>@§" }, "service": "addressCheck.illegalSigns" } ] }

 

Parameterübersicht

Parameter

Beschreibung

Parameter

Beschreibung

signs

Unerlaubte Zeichen (Zeichenkette).

 

1.13 addressCheck.date - Datum

Prüft, ob die Eingabe ein gültiges Datum ist, und formatiert die Eingabe bei Bedarf.

Beispielkonfiguration für (accounts.addressField.additionalInfo)

{ "label": "", "name": "additionalInfo", "validations": [ { "options": { "delimeter": - "dateformat": DMY "formatleadingzero": false }, "service": "addressCheck.legalSigns" } ] }

 

Parameterübersicht

Parameter

Beschreibung

Parameter

Beschreibung

delimiter

Trennzeichen zwischen Tag/Monat/Jahr (z. B. - für 15-10-2025).

dateformat

Beliebige Kombination aus D, M, Y (z. B. DMY für 15-10-2025).

formatleadingzero

Wenn aktiv (true), werden Tage/Monate zweistellig formatiert (5 → 05).

Wenn deaktiviert (false), werden führende Nullen entfernt (05 → 5). (Wahrheitswert)

 

1.14 addressCheck.allowedSelection - Auswahl (Listenelement)

Validiert, ob die Eingabe einem vordefinierten Auswahlwert entspricht. Hierzu wird die dataId einer Konfiguration aus general.addressListElements übergeben.

Typische Anwendung: Prüfung, ob eine Adresse z. B. „Packstation“ oder „Privatadresse“ ist.

 

Beispielkonfiguration für (accounts.addressField.additionalInfo)

{ "label": "", "name": "addressType" "validations": [ { "options": { "listElements": "general.addressListElements.addressType" }, "service": "addressCheck.allowedSelection" } ] }

 

Parameterübersicht

Parameter

Beschreibung

 

Parameter

Beschreibung

 

listElements

dataId einer Definition aus general.addressListElements

 

 


 

2. dataChecker.* - Allgemeine Feldvalidierungen

dataChecker.* enthält Prüfungen für allgemeine Formularfelder, die nicht speziell zu einer Adresse gehören. Die Prüfungen werden in der jeweiligen Felddefinition unter validations eingebunden.

Das Frontend übernimmt die Vorgaben aus der Felddefinition und prüft beim Ausfüllen, ob die Eingabe korrekt ist (z.B. Länge, Format oder unerlaubte Zeichen). [Link]

2.1 dataChecker.minLength - Mindestlänge

Prüft die Mindestlänge der Eingaben bei Formular-Eingabefeldern.

 

Beispielkonfiguration für (inquiry.form.catalogue.fields.firstName)

{ "label": "Vorname", "name": "firstName", "required": true, "validations": [ { "options": { "len": 3 }, "service": "dataChecker.minLength" } ] }

 

Parameterübersicht

Parameter

Beschreibung

 

Parameter

Beschreibung

 

len

Gewünschte Mindestlänge in Zahlen.

 

 

2.2 dataChecker.maxLength - Maximallänge

Prüft die Maximallänge der Eingaben bei Formular-Eingabefeldern.

 

Beispielkonfiguration für (inquiry.form.catalogue.fields.firstName)

{ "label": "Vorname", "name": "firstName", "required": true, "validations": [ { "options": { "len": 255 }, "service": "dataChecker.maxLength" } ] }

 

Parameterübersicht

Parameter

Beschreibung

 

Parameter

Beschreibung

 

len

Gewünschte Maximallänge in Zahlen.

 

 

2.3 dataChecker.numeric - Nur Ziffern

Prüft, ob die Eingabe bei Formular-Eingabfeldern nur aus Ziffern besteht.

 

Beispielkonfiguration für (inquiry.form.catalogue.fields.phone)

{ "label": "Telefon", "name": "phone", "validations": [ { "service": "dataChecker.numeric" } ] }

 

Parameterübersicht

Parameter

Beschreibung

 

Parameter

Beschreibung

 

--

Keine zusätzlichen Parameter.

 

 

2.4 dataChecker.country - Ländercode (ISO)

Prüft, ob die Eingabe resp. Auswahl bei Länderlisten der Formularfelder ein im Shop konfigurierter Ländercode ist (ISO-Code: 2-stellig, 3-stellig oder ISO-Nummer).

Die offiziellen ISO-3166-1-Codes (alpha-2, alpha-3 und numerisch) finden sich auf der Website der International Organization for Standardization (ISO): ISO - ISO 3166 — Country Codes

ISO - ISO 3166 — Country Codes

 

Beispielkonfiguration für (inquiry.form.catalogue.fields.country)

{ "label": "Land", "name": "country", "validations": [ { "service": "dataChecker.country" } ] }

 

Parameterübersicht

Parameter

Beschreibung

 

Parameter

Beschreibung

 

--

Keine zusätzlichen Parameter.

 

 

2.5 dataChecker.zip - Postleitzahl (PLZ)

Prüft, ob die Eingabe eine gültige Postleitzahl (PLZ) für das angegebene Land ist. Die PLZ-Regeln stammen aus der Konfiguration. Das dazugehörige Land muss zwingend im Feld country übergeben werden.

 

Beispielkonfiguration für (inquiry.form.catalogue.fields.zip)

{ "label": "Postleitzahl", "name": "zip", "validations": [ { "service": "dataChecker.zip" } ] }

 

Parameterübersicht

Parameter

Beschreibung

 

Parameter

Beschreibung

 

--

Keine zusätzlichen Parameter. (Für länderspezifische Prüfung muss das Feld country im Kontext verfügbar sein.)

 

 

 

2.6 dataChecker.salutation - Anrede (Code)

Prüft, ob die Eingabe eine gültige Anrede ist (Code gemäß Konfiguration).

 

Beispielkonfiguration für (inquiry.form.catalogue.fields.salutation)

{ "label": "Anrede", "name": "salutation", "validations": [ { "service": "dataChecker.salutation" } ] }

 

Parameterübersicht

Parameter

Beschreibung

 

Parameter

Beschreibung

 

--

Keine zusätzlichen Parameter.

 

 

2.7dataChecker.regex - Regulärer Ausdruck

Prüft, ob die Eingabe zu einem regulären Ausdruck passt.

 

Beispielkonfiguration für (inquiry.form.catalogue.fields.additionalInfo)

{ "label": "Zusatzinformation", "name": "additionalInfo", "validations": [ { "options": { "expression": "^((?i)(?!Postfach).)*$" }, "service": "dataChecker.regex" } ] }

 

Parameterübersicht

Parameter

Beschreibung

 

Parameter

Beschreibung

 

expression

Regulärer Ausdruck (Zeichenkette).

 

 

2.8 dataChecker.email - E‑Mail-Adresse

Prüft, ob die Eingabe eine gültige E‑Mail-Adresse ist.

 

Beispielkonfiguration für (inquiry.form.catalogue.fields.mail)

{ "label": "E-Mail-Adresse", "name": "mail", "validations": [ { "service": "dataChecker.email" } ] }

 

Parameterübersicht

Parameter

Beschreibung

 

Parameter

Beschreibung

 

--

Keine zusätzlichen Parameter.

 

 

2.9 dataChecker.alphaClass - Buchstaben (min/verschiedene)

Stellt sicher, dass die Eingabe mindestens minChars lateinische Buchstaben enthält (Groß-/Kleinschreibung egal); optional Mindestanzahl unterschiedlicher Buchstaben.

 

Beispielkonfiguration für (inquiry.form.catalogue.fields.additionalInfo)

{ "label": "Zusatzinformation", "name": "additionalInfo", "required": true, "validations": [ { "options": { "minChars": 8, "minDifferentChars": 2 }, "service": "dataChecker.alphaClass" } ] }

 

Parameterübersicht

Parameter

Beschreibung

 

Parameter

Beschreibung

 

minChars

Mindestanzahl an Buchstaben (Zahl ≥ 0).

 

minDifferentChars

Mindestanzahl unterschiedlicher Buchstaben (Zahl ≥ 0).

 

 

2.10 dataChecker.lowerAlphaClass - Kleinbuchstaben

Wie alphaClass, jedoch nur Kleinbuchstaben.

 

Beispielkonfiguration für (inquiry.form.catalogue.fields.additionalInfo)

{ "label": "Zusatzinformation", "name": "additionalInfo", "required": true, "validations": [ { "options": { "minChars": 8, "minDifferentChars": 2 }, "service": "dataChecker.lowerAlphaClass" } ] }

 

Parameterübersicht

Parameter

Beschreibung

 

Parameter

Beschreibung

 

minChars

Mindestanzahl an Kleinbuchstaben (Zahl ≥ 0).

 

minDifferentChars

Mindestanzahl unterschiedlicher Kleinbuchstaben (Zahl ≥ 0).

 

 

2.11 dataChecker.upperAlphaClass - Großbuchstaben

Wie alphaClass, jedoch nur Großbuchstaben.

 

Beispielkonfiguration für (inquiry.form.catalogue.fields.additionalInfo)

{ "label": "Zusatzinformation", "name": "additionalInfo", "required": true, "validations": [ { "options": { "minChars": 8, "minDifferentChars": 2 }, "service": "dataChecker.upperAlphaClass" } ] }

 

Parameterübersicht

Parameter

Beschreibung

 

Parameter

Beschreibung

 

minChars

Mindestanzahl an Großbuchstaben (Zahl ≥ 0).

 

minDifferentChars

Mindestanzahl unterschiedlicher Großbuchstaben (Zahl ≥ 0).

 

 

© 2025 WEBSALE AG | Impressum | Datenschutz