1 MT940: Überblick

Kurzbeschreibung

Das MT940-Nuclet bietet die Möglichkeit

• elektronische Kontoauszüge, die im MT940-Format vorliegen, automatisiert einzulesen

• die eingelesenen Daten in eine Struktur von Nuclos-Businessobjekten zu übertragen

• die Bankumsätze anhand des Verwendungszwecks automatisch andere Businessobjekte ("Referenzen", das sind je nach Anwendungszweck bspw. Ihren Rechnungen) zuzuorden

Für die den Bankumsätzen zugeordneten Objekten (Rechnungen, o.ä.) wird bei Zahlungseingang automatisiert ein Statuswechsel durchgeführt (bspw. von "offen" nach "bezahlt").

Mehr zu Funktionsumfang und implementierten Abläufen dieses Nuclets finden Sie im Abschnitt 2.

Nuclet-Bestandteile

Das MT940-Nuclet umfasst im Rahmen der .nuclet-Datei

• sieben Businessobjekte (für Kontoauszüge, Bankumsätze und diverse Stammdaten),

• sechs Layouts,

• ein Statusmodell (für Bankumsätze),

• zwei Attributgruppen,

• diverse Java-Regeln (verteilt auf Packages),

• drei Nuclet-Parameter,

• eine Jobsteuerung (zur Steuerung des Import-Jobs),

• drei Strukturdefinitionen (für den Import von Stammdaten) und

• eine Nuclet-Abhängigkeit.

Darüberhinaus werden in der ZIP-Datei folgende Komponenten mitgeliefert:

• drei CSV-Dateien für Objektimporte sowie

• zwei MT940-Beispieldateien mit Kontauszügen.

Tabelle 1: Nuclet-Bestandteile

Java-Package-Struktur

Die Java-Regeln sind in sieben Packages unterteilt:

• Regeln für maskengesteuerte Events (org.nuclet.mt940.rule)

• Regeln zur Steuerung von System-Jobs (org.nuclet.mt940.job)

• Regeln für die Geschäftslogik (org.nuclet.mt940.logic)

• Regeln zum Einlesen und Verarbeiten von MT940-Dateien (org.nuclet.mt940.parser)

• Regeln für Datenbankzugriffe (org.nuclet.mt940.facade)
• Wrapper-Klassen als Nuclet-Schnittstelle (org.nuclet.mt940.wrapper)
• Statuswechsel-Definitionen als Nuclet-Schnittstelle (org.nuclet.mt940.statemodel)

Die wesentlichen Abhängigkeiten der Packages sind in der folgenden Abbildung veranschaulicht. Die Abbildung beschränkt sich auf diejenigen Hauptpakete, die der Prozessteuerung dienen.

In dreien dieser vier Java-Packages stellt eine abstrakte Java-Klasse die Basisfunktionalität über die deklarierten und (größtenteils) definierten Methoden. Die Import-Prozesse sind entlang der vordeklarierten Methoden dieser abstrakten Klassen festgelegt und bedürfen für den normalen Anwendungsfall keiner weiteren Anpassung.

In den Paketen für Datenbankzugriffe (org.nuclet.mt940.facade) und Wrapper-Klassen (org.nuclet.mt940.wrapper) sind ebenfalls abstrakte Klassen definiert, deren konkrete Ausprägungen anwendungsspezifisch zu implementieren sind. Konkret bedeutet dies an dieser Stelle, Schnittstellen zum Zielnuclet herzustellen und anwendungsspezifisches Verhalten festzulegen (und zwar für Währung, Zahlungsbedingungen und Referenzen).

Tabelle 2: Java-Package-Struktur

Anwendungsspezifische Anpassungen sollten nur umgesetzt werden, entweder

• in den konkreten, bereits vorhandenen, Klassen (siehe Tabelle) oder

• durch neue, eigene konkrete Implementierungen

Das Package org.nuclet.mt940.parser enthält die Klasse MT940SparkasseParser, die bereits dezidiertes Verhalten für von Sparkassen gelieferte MT940-Dateien zur Verfügung stellt. Die zweite konkrete Implementierung innerhalb dieses Packages ist die Klasse MT940Parser, die über die Basisfunktionalität des AbstractMT940Parser hinaus kein zusätzliches Verhalten mitbringt. Für MT940-Dateien, die von anderen Kreditinstituten erstellt werden, müsste die Klasse MT940Parser (oder eine eigene, konkrete Implementierung des AbstractMT940Parser) ggf. mit bankspezifischem Verhalten gefüllt werden.

Das MT940-Nuclet ist zur Zeit derart konfiguriert, dass das sparkassenspezifische Verhalten genutzt wird. Die Initialisierung des Parsers erfolgt im Konstruktur der Klasse org.nuclet.mt940.job.MT940Importer und könnte dort jederzeit auf ein anderes Verhalten, d.h. eine eigene Implementierung umdirgiert werden.

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);

}

Der Java-Sourcecode ist mit @replace!-Tags an all jenen Stellen markiert, wo anwendungsspezifisches Verhalten hinzugefügt werden kann. Dazu mehr im Abschnitt 4.