Seitenhistorie
...
Das MT940-Nuclet ist zur Zeit derart konfiguriert, dass das allgemeingültige Verhalten genutzt wird. Die Initialisierung des Parsers erfolgt im Konstruktur der Klasse org.nuclet.mt940.job.MT940Importer und könnte dort jederzeit auf das sparkassenspezifische Verhalten oder eine eigene Implementierung umdirgiert werden.
| Codeblock | ||||
|---|---|---|---|---|
| ||||
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 MT940Parser(context);
}
|
Abbildung 1: MT940Importer
Der Java-Sourcecode ist mit @replace!-Tags an all jenen Stellen markiert, wo anwendungsspezifisches Verhalten hinzugefügt werden kann. Dazu mehr im nächsten Abschnitt "Integration".
Integration
Notwendige Schritte zur Integration
Die Integration des MT940-Nuclets erfolgt in 8 Schritten:
Download
Nuclet-Import
Objektimporte anlegen
Objektimporte ausführen
Anpassungen im Entitäten-Wizard
Einrichtung eines Eingangsverzeichnisses
Konfiguration der Systemparaemter (entfällt bis auf weiteres)
Sourcecode-Anpassungen in Java-Regeln
Alle Integrationschritte werden im folgenden im Detail erläutert.
Schritt 1: Download
Download der ZIP-Datei „MT940-v2.0.0.zip“ auf der Nuclos-Webpage unter „Nuclos Services“ > „Download“ > „Nuclet Download“. Das ZIP anschließend lokal entpacken.
Schritt 2: Nuclet-Import
Import des MT940-Nuclets unter „Konfiguration“ > „Nuclet Management“ > „Importieren“ in Ihre bestehende Nuclos-Instanz, Auswahl der Datei „MT940-v2.0.0.nuclet“
Schritt 3: Objektimporte anlegen
Objektimporte („Konfiguration“ > „Import & Export“) anlegen zu den Strukturdefinitionen „Bank Transaction Type“, „Banking Business Line“ und „Debit/Credit Mark“. Für die Importe können die mitgelieferten CSV-Dateien „Bank_Transaction_Type.csv“, „Banking_Business_Line.csv“ und „Debit_Credit_Mark.csv“ (zu finden im Unterverzeichnis „data“ der ZIP-Datei) verwendet werden.
| Info |
|---|
Achtung: Es besteht eine Abhängigkeit zwischen „Bank Transaction Type“ und „Banking Business Line“; die Bankgeschäftssparten („Banking Business Line“) müssen vor den Bankgeschäftsvorfällen („Bank Transaction Type“) importiert werden. |
| Info |
|---|
Hinweis: Die CSV-Dateien beziehen sich auf die Spezifikationen der Sparkassen. Sollte das MT940-Format Ihrer Hausbank von der vorliegenden Implementierung abweichen bzw. sollten die Inhalte der MT940-Dateien hinsichtlich anders zu interpretieren sein, müssen Sie die zu importierenden Stammdaten selbst anlegen. Dies betrifft nur die beiden Entitäten „Banking Business Line“ (Bankgeschäftssparten) und „Bank Transaction Type“ (Bankgeschäftsvorfällen). |
Schritt 4: Objektimporte ausführen
Die in Schritt 3 angelegten Objektimporte ausführen, so dass alle notwendigen Stammdaten im System sind.
Schritt 5: Anpassungen im Entitäten-Wizard
Variante SINGLE: In der Entität „Bankumsatz“ („Bank Transaction“) verweist das Attribut „Referenz“ („Reference“) auf ein Objekt vom Typ der Dummy-Entität „MT940-Referenz“ („MT940 Reference“). Dieses Referenz-Attribut dient der Zuordnung von Bankumsätzen zu Rechnungen, etc., je nach Anwendungszweck. Bitte über den Entitäten-Wizard das Attribut dahingehend bearbeiten, dass die für Sie richtige Entität referenziert wird.
Variante MULTIPLE: Für den Fall, dass es in Ihren Geschäftsprozessen üblich ist, einem Bankumsatz mehrere Referenzen (Rechnungen, o.a.) zuzuordnen, verwenden Sie bitte die Zwischenentität „Referenz-2-Bankumsatz“ („Bank Transaction Ref“). Diese Entität dient der Abbildung dieser n-m-Beziehungen. In diesem Fall müsste das Attribut „Referenz“ also in dieser Entität angepasst werden wie in Punkt 7. beschrieben.
Die Java-Regeln lassen sich über den System-Parameter MT940_REFERENCE_TYPE auf die zu bevorzugte und zu verwendende Variante abstimmen; siehe dazu auch Schritt 7 (Konfiguration der System-Parameter).
| Info |
|---|
Anmerkung: Eine weitere, denkbare Variante wäre, eine feste Anzahl (1-n) von Referenzen in der Entität Bankumsatz zuzulassen. Entität und Java-Regeln wären dementsprechend anzupassen. |
Schritt 6: Einrichten eines Eingangsverzeichnisses
Einrichtung eines Dateiverzeichnis für den Eingang der MT940-Dateien. Das Verzeichnis sollte auf dem Server liegen
Überblick
Inhalte