Updating BICPlusIBAN

The data files used to populate BICPlusIBAN directory must be obtained from SWIFT directly. The sample BICPlusIBAN directory from SWIFT Message Library is only the test data files to be used with the sample project. They are not intended to be used in a production environment.

The Java constructor for the BICPlusIBAN class loads the required data from the following SWIFT-supplied files:

• BI.TXT

• IS.TXT

The constructor takes an argument from the directory that contains these two files. It then opens each file and loads the appropriate fields into a searchable structure. For more details on these files, see the current SWIFT BICPlusIBAN Directory Technical Specifications document for actual file layout and positioning information.

The BI data contains the BICPlusIBAN information. The IS data provides IBAN structure information. The SWIFT Message Library takes these data together to execute the validation rules. These base files and update delta files should be obtained directly from SWIFT.

To Update BICPlusBAN Information

1. In the NetBeans Projects window, expand CAPS Components Library > Message Library > Swift.
2. Right-click the BICPlusIBAN.jar file, point to Version Control, and select Check Out. Click Check Out on the dialog box that appears.
3. Right-click the BICPlusIBAN.jar file again, and select Update BICPlusIBAN Files.

   A browser window appears so you can browse to and select the files to update.

4. Navigate to the location of the BI.txt file on the SWIFT update CD-ROM. select the file, and click Open.
5. Repeat the above two steps to update the IS.txt file.

BICPlusIBAN Validation Method Definitions

The SWIFT Message Library provides the following validation methods for BICPlusIBAN:

• Deriving the BIC from the IBAN: This validation method is used to derive the BIC from the IBAN. This can be useful in situations where the IBAN is present but the BIC is missing in a SEPA payment instruction. The method takes no arguments, and will return an array list of BIC code and BRANCH code. The signature is:

  ArrayList deriveBICfromIBAN()

• Validating the Bank ID: This validation method is used to validate that the Bank ID contained in an IBAN is a valid Bank ID. This can be useful in situations where the ordering customer has constructed the IBAN. However, the validation does not guarantee that the IBAN itself is valid. The method takes no arguments, and will return a boolean result. The signature is:

  boolean validateBankID()

• Validating the BIC: This validation method is used to validate that the BIC is a valid BIC. This can for example be useful in situations when the ordering customer attempted to derive the BIC itself from financial institution's name and address. The method takes no arguments, and will return a boolean result. The signature is:

  boolean validateBIC()

• Validating the BIC/IBAN combination: This validation method is used to validate that the BIC and the IBAN belong to one and the same institution. The method takes no arguments, and will return a boolean result. The signature is:

  boolean validateBICIBANCombo()