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 Configuration → Import & Export → Object import create a new record
• the structure definition IBAN Registry use
• the file IBAN_Registry_DE.csv store
• assign a name for the import process (e.g. "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 Configuration → Rule sets → Generic implementation 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 select "iban"
  • as Assigned attribute select the field that should contain the IBAN to be validated
• save the record

Now, in the Server rule manager the rule "PruefeIBAN" must be assigned to the implementing business object as an insert, update and/or state-change rule.

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 .

A rule ("PruefeUndFormatiereIBAN") is also available for this in the Server rule manager.

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: