The Nuclet provides methods and rules for validating IBANs.

The following is checked:

• the structure (length, permitted characters and substructures)
• checksum (it is a valid IBAN)

Release

Integration

1. Import of the IBAN registry

First, the definitions for the IBAN validation (IBAN registry) must be imported.

This is done via an CSV-Import:

• under the menu item Konfiguration → Import &Export → Objektimport create a new record
• the structure definition IBAN Registry use
• the file IBAN_Registry_DE.csv store
• einen Namen für den Importvorgang vergeben (z.B. "Import IBANRegistry")
• save the record and press the button Importieren in the toolbar

Creating the CSV import (left) and successful import (right).

2. Usage

There are two ways to use the IBAN validation:

a) Call validation methods in your own Java classes

For this, the corresponding methods in the class org.nuclet.iban.IBANValidator can be called.

A complete validation is performed by calling the method

public static boolean validateIban(RuleContext context, String iban) 

which on success true returns and otherwise throws an IBANValidationExeption (inherits from BusinessException).

b) Use generic implementation

An already existing business object with a validatable IBAN field can be configured as an implementation of the generischen Businessobjekts Kontoverbindung from the IBAN Nuclet as follows:

• under the menu item Konfiguration → Regelwerke → Generische Implementierung create a new record
• as generic business object the BO Kontoverbindung select
• as Implementing business object select the desired existing BO with an IBAN field
• in the subform Attribute create a new entry
  • as Generic attribute "iban" auswählen
  • as Assigned attribute select the field that should contain the IBAN to be validated
• save the record

Now, in the Server rule manager die Regel "PruefeIBAN" als Insert-,  Update- und/oder State-Change-Rule dem implementierenden Businessobjekt zugewiesen werden.

3. IBAN formatting

In the class IbanValidator the function exists

public static String formatiereIBAN(RuleContext context, String iban) throws BusinessException

which first validates the IBAN and then, if successful, returns it formatted according to the standard DIN 5008 .

Auch hierfür steht eine Regel ("PruefeUndFormatiereIBAN") im Server Regelmanager zur Verfügung.

4. IBAN formatting

The supported country formats can be (de)activated separately in the IBAN registry.

If the validation is deactivated, the validation fails for IBANs with the corresponding country prefix.

By default, all supported formats are also activated

Supported formats

The IBAN validation supports the following country codes: