Language: Deutsch · English

1 MT940: Overview

Short description

The MT940 Nuclet offers the option

• to automatically read electronic bank statements that are in MT940 format

• to transfer the imported data into a structure of Nuclos business objects

• to automatically assign the bank transactions, based on the remittance information, to other business objects ("references", which depending on the application purpose are e.g. your invoices)

For the objects assigned to the bank transactions (invoices, etc.), a state change is performed automatically on incoming payment (e.g. from "open" to "paid").

More about the feature scope and implemented processes of this Nuclet can be found in section 2.

Nuclet components

Within the .nuclet file, the MT940 Nuclet comprises

• seven business objects (for bank statements, bank transactions and various master data),

• six layouts,

• one state model (for bank transactions),

• two attribute groups,

• various Java rules (distributed across packages),

• three Nuclet parameters,

• one job control (to control the import job),

• three structure definitions (for importing master data) and

• one Nuclet dependency.

In addition, the following components are supplied in the ZIP file:

• three CSV files for object imports and

• two MT940 example files with bank statements.

Table 1: Nuclet components

Java package structure

The Java rules are divided into seven packages:

• rules for screen-controlled events (org.nuclet.mt940.rule)

• rules for controlling system jobs (org.nuclet.mt940.job)

• rules for the business logic (org.nuclet.mt940.logic)

• rules for reading and processing MT940 files (org.nuclet.mt940.parser)

• rules for database accesses (org.nuclet.mt940.facade)
• wrapper classes as a Nuclet interface (org.nuclet.mt940.wrapper)
• state change definitions as a Nuclet interface (org.nuclet.mt940.statemodel)

The essential dependencies of the packages are illustrated in the following figure. The figure is limited to those main packages that serve the process control.

In three of these four Java packages, an abstract Java class provides the basic functionality via the declared and (mostly) defined methods. The import processes are defined along the pre-declared methods of these abstract classes and require no further adjustment for the normal use case.

In the packages for database accesses (org.nuclet.mt940.facade) and wrapper classes (org.nuclet.mt940.wrapper), abstract classes are also defined whose concrete forms must be implemented in an application-specific way. Concretely, this means at this point establishing interfaces to the target Nuclet and defining application-specific behaviour (namely for currency, conditions of payment and references).

Table 2: Java package structure

Application-specific adjustments should only be implemented, either

• in the concrete, already existing classes (see table) or

• by new, own concrete implementations

The package org.nuclet.mt940.parser contains the class MT940SparkasseParser, which already provides dedicated behaviour for MT940 files supplied by savings banks (Sparkassen). The second concrete implementation within this package is the class MT940Parser, which beyond the basic functionality of the AbstractMT940Parser does not bring any additional behaviour. For MT940 files created by other banks, the class MT940Parser (or your own concrete implementation of the AbstractMT940Parser) filled with bank-specific behaviour if necessary.

The MT940 Nuclet is currently configured such that the savings-bank-specific behaviour is used. The parser is initialized in the constructor of the class org.nuclet.mt940.job.MT940Importer and could be redirected there at any time to a different behaviour, i.e. your own implementation.

public MT940Importer(final JobContext context, 
    final String strMT940Directory,
    final String strMT940ReferenceType)
{

    super(context, strMT940Directory, strMT940ReferenceType);

    // @replace!
    //
    // Replace with your own logic and/or your own parser here, if you 
    // need more specific behaviour.
    //
    this.logic = new MT940Logic(context, strMT940ReferenceType);

    this.parser = new MT940SparkasseParser(context);

}

The Java source code is marked with @replace! tags at all those places where application-specific behaviour can be added. More on this in section 4.

Related pages