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 1. addressCheck.* - Adressvalidierungen
- 1.1 1.1 addressCheck.minLength - Mindestlänge
- 1.2 1.2 addressCheck.maxLength - Maximallänge
- 1.3 1.3 addressCheck.numeric - Nur Ziffern
- 1.4 1.4 addressCheck.country - Ländercode (ISO)
- 1.5 1.5 addressCheck.zip - Postleitzahl (PLZ)
- 1.6 1.6 addressCheck.salutation - Anrede (Code)
- 1.7 1.7 addressCheck.regex - Regulärer Ausdruck
- 1.8 1.8 addressCheck.phone - Telefonnummer
- 1.9 1.9 addressCheck.alpha - Nur Buchstaben (A–Z)
- 1.10 1.10 addressCheck.alphanum - Buchstaben/Ziffern (A–Z/0–9)
- 1.11 1.11 addressCheck.legalSigns - Erlaubte Zeichen
- 1.12 1.12 addressCheck.illegalSigns - Verbotene Zeichen
- 1.13 1.13 addressCheck.date - Datum
- 1.14 1.14 addressCheck.allowedSelection - Auswahl (Listenelement)
- 2 2. dataChecker.* - Allgemeine Feldvalidierungen
- 2.1 2.1 dataChecker.minLength - Mindestlänge
- 2.2 2.2 dataChecker.maxLength - Maximallänge
- 2.3 2.3 dataChecker.numeric - Nur Ziffern
- 2.4 2.4 dataChecker.country - Ländercode (ISO)
- 2.5 2.5 dataChecker.zip - Postleitzahl (PLZ)
- 2.6 2.6 dataChecker.salutation - Anrede (Code)
- 2.7 2.7dataChecker.regex - Regulärer Ausdruck
- 2.8 2.8 dataChecker.email - E‑Mail-Adresse
- 2.9 2.9 dataChecker.alphaClass - Buchstaben (min/verschiedene)
- 2.10 2.10 dataChecker.lowerAlphaClass - Kleinbuchstaben
- 2.11 2.11 dataChecker.upperAlphaClass - Großbuchstaben
- 2.12 2.12 dataChecker.digitClass - Ziffern
- 2.13 2.13 dataChecker.specialClass - Sonderzeichen
- 2.14 2.14 dataChecker.sequenceOfIdenticalCharacters - Wiederholte Zeichen (Sequenz)
- 2.15 2.15 dataChecker.consecutiveNumbers - Fortlaufende Zahlen
- 2.16 2.16 dataChecker.consecutiveLetters - Fortlaufende Buchstaben
- 2.17 2.17 dataChecker.palindrome - Palindrom
- 3 3. paymentValidation.* - Zahlungsarten-Validierung
- 3.1 3.1 paymentValidation.billCountry - Validierung des Landes (Rechnungsadresse) für Zahlungsarten
- 3.2 3.2 paymentValidation.billPhone - Validierung der Telefonnummer
- 3.3 3.3 paymentValidation.billDateOfBirth - Validierung des Geburtsdatums
- 3.4 3.4 paymentValidation.shippingCountry - Validierung des Landes (Lieferadresse)
- 3.5 3.5 paymentValidation.shippingMethod - Validierung der Versandart für Zahlungsarten
- 3.6 3.6 paymentValidation.accountType - Validierung des Kundentyps für Zahlungsarten
- 3.7 3.7 paymentValidation.denyDifferingShippingAddress - Validierung abweichender Lieferadressen für Zahlungsarten
- 3.8 3.8 paymentValidation.voucherDeny - Validierung von Gutscheinprodukten für Zahlungsarten
- 3.9 3.9 paymentValidation.total - Validierung von Mindest - / Maximalbestellwert für Zahlungsarten
- 3.10 3.10 paymentValidation.inventoryState - Validierung des Langerbestandes für Zahlungsarten
- 4 4. shippingMethodValidation.* - Versandarten-Validierung
- 4.1 4.1 shippingMethodValidation.shippingCountry - Validierung des Landes (Rechnungsadresse)
- 4.2 4.2 shippingMethodValidation.paymentMethod - Validierung der Versandart für Zahlungsarten
- 4.3 4.3 shippingMethodValidation.valueOfGoods - Validierung des Mindest- Maximalbestellwerts für Versandarten
- 4.4 4.4 shippingMethodValidation.productType - Validierung des Produkttyps für Versandarten
- 4.5 4.5 shippingMethodValidation.productDependency - Validierung der Produkt-Abhängigkeiten für Versandarten
- 4.6 4.6 shippingMethodValidation.expressCheckout - Validierung des Express-Checkout für Versandarten
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 |
|---|---|
| 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 |
|---|---|
| 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 |
|---|---|
-- | 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 |
|---|---|
-- | 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 |
|---|---|
-- | 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 |
|---|---|
-- | 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 |
|---|---|
| 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 |
|---|---|
-- | 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 |
|---|---|
-- | 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 |
|---|---|
-- | 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 |
|---|---|
| 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 |
|---|---|
| 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 |
|---|---|
| Trennzeichen zwischen Tag/Monat/Jahr (z. B. |
| Beliebige Kombination aus |
| Wenn aktiv ( Wenn deaktiviert ( |
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 |
|
|---|---|---|
|
|
|
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 |
|
|---|---|---|
| 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 |
|
|---|---|---|
| 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 |
|
|---|---|---|
-- | 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 |
|
|---|---|---|
-- | 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 |
|
|---|---|---|
-- | Keine zusätzlichen Parameter. (Für länderspezifische Prüfung muss das Feld |
|
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 |
|
|---|---|---|
-- | 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 |
|
|---|---|---|
| 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 |
|
|---|---|---|
-- | 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 |
|
|---|---|---|
| Mindestanzahl an Buchstaben (Zahl ≥ 0). |
|
| 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 |
|
|---|---|---|
| Mindestanzahl an Kleinbuchstaben (Zahl ≥ 0). |
|
| 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 |
|
|---|---|---|
| Mindestanzahl an Großbuchstaben (Zahl ≥ 0). |
|
| Mindestanzahl unterschiedlicher Großbuchstaben (Zahl ≥ 0). |
|
© 2025 WEBSALE AG | Impressum | Datenschutz