Das Nuclet bietet Methoden und Regeln zur Validierung von IBAN.
Gepüft wird:
Version | Änderungen |
---|---|
2.6 |
|
Zunächst müssen die Definitionen für die IBAN-Validierung (IBAN-Registry) importiert werden.
Dies erfolgt über einen CSV-Import:
Anlegen des CSV-Imports (links) und erfolgreicher Import (rechts).
Es gibt zwei Möglkichkeiten die IBAN-Validierung zu nutzen:
a) Validierungsmethoden in eigenen Java-Klassen aufrufen
Dafür können die entsprechenden Methoden in der Klasse org.nuclet.iban.IBANValidator aufgerufen werden.
Eine vollständige Validierung erfolgt per Aufruf der Methode
public static boolean validateIban(RuleContext context, String iban) |
die bei Erfolg true zurückgibt und anderenfalls eine IBANValidationExeption (erbt von BusinessException) wirft.
b) Generische Implementierung verwenden
Ein bereits existierendes Businessobjekt mit einem validierbaren IBAN-Feld kann wie folgt als Implementierung des generischen Businessobjekts Kontoverbindung aus dem IBAN-Nuclet konfiguriert werden:
Nun kann im Server Regelmanager die Regel "PruefeIBAN" als Insert-, Update- und/oder State-Change-Rule dem implementierenden Businessobjekt zugewiesen werden.
In der Klasse IbanValidator existiert die Funktion
public static String formatiereIBAN(RuleContext context, String iban) throws BusinessException |
welche die IBAN zunächst validiert und dann, wenn erfolgreich, entsprechend der Norm DIN 5008 formatiert zurück gibt.
Auch hierfür steht eine Regel ("PruefeUndFormatiereIBAN") im Server Regelmanager zur Verfügung.
Die unterstützen Länderformate können in der IBAN-Registry jeweils separat (de)aktiviert werden.
Ist die Validierung deaktiviert schlägt die Validierung für IBAN mit dem entsprechenden Länderprefix fehl.
Standardmäßig sind alle unterstützen Formate auch aktiviert
Die IBAN-Validierung unterstützt die folgenden Ländercodes:
AT | Österreich |
BE | Belgien |
BG | Bulgarien |
CY | Zypern |
CZ | Tschechische Republik |
DK | Dänemark |
FO | Dänemark |
GL | Dänemark |
EE | Estland |
FI | Finnland |
FR | Frankreich |
DE | Deutschland |
GI | Gibraltar |
GR | Griechenland |
HU | Ungarn |
IS | Island |
IE | Irland |
IT | Italien |
LV | Lettland |
LI | Liechtenstein (Fürstentum) |
LT | Litauen |
LU | Luxemburg |
MT | Malta |
MC | Monaco |
NL | Niederlande |
NO | Norwegen |
PL | Polen |
PT | Portugal |
RO | Rumänien |
SK | Slovakische Republik |
SI | Slowenien |
ES | Spanien |
SE | Schweden |
CH | Schweiz |
GB | Großbritannien |