Nuclet für Währungsumrechnungen und Wechselkursfunktionalität

Überblick

Kurzbeschreibung

Das Wechselkurs-Nuclet bietet die Möglichkeit

• Wechselkurse zu pflegen

• Währnungsbeträge von einer Währung in eine andere zu konvertieren

• Wechselkurse über eine Schnittstelle bei der Europäischen Zentralbank (EZB) täglich aktualisieren zu lassen

Das Wechselkurs-Nuclet war bislang mit dem Währungs-Nuclet ("Currency") gebündelt, die Währungsentität wurde nun von der Wechselkursfunktionalität getrennt.

Das Wechselkurs-Nuclet ist geeignet, mit allen Währungsentitäten im Zusammenspiel zu funktionieren.

Nuclet-Bestandteile

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

• zwei Entitäten (für Wechselkurse und einen Währungsrechner),

• zwei Layouts,

• diverse Java-Regeln (verteilt auf Packages),

• zwei Jobsteuerungen (zur Steuerung des EZB-Schnittstelle einerseits, für Tests andererseits),

• eine Strukturdefinition (für den Import von Stammdaten) und

• eine Nuclet-Abhängigkeit.

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

• eine CSV-Datei für Objektimporte

Tabelle 1: Nuclet-Bestandteile

Java-Package-Struktur

Die Java-Regeln sind in sieben Packages unterteilt:

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

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

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

• Fassaden-Klassen für die Ausführung von Datenbankabfragen je Enität (org.nuclet.exchangerates.facade)

• Regeln zum Einlesen und Verarbeiten von MT940-Dateien (org.nucletexchangerates.xml)

• Regeln für die Ausführung von Tests (org.nuclet.exchangerates.test)

• Wrapper-Klassen als Nuclet-Schnittstelle (org.nuclet.exchangerates.wrapper)

Die Abhängigkeiten der Packages sind in der folgenden Abbildung veranschaulicht.

Das Wechselkurs-Nuclet ist Java-seitig voll funktionsfähig. Hier eine Übersicht über die auf die einzelnen Packages verteilten Java-Klassen:

Tabelle 2: Java-Package-Struktur

Anwendungsspezifische Anpassungen sollten in den Java-Regeln i.A. nicht notwendig sein.

Integration

Notwendige Schritte zur Integration

Die Integration des MT940-Nuclets erfolgt in 5 Schritten:

1. Download

2. Nuclet-Import

3. Objektimporte anlegen

4. Objektimporte ausführen

5. Anpassungen im Entitäten-Wizard

Alle Integrationschritte werden im folgenden im Detail erläutert.

Schritt 1: Download

Download der ZIP-Datei „Currency-v1.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 „Currency-v1.0.0.nuclet“

Schritt 3: Objektimporte anlegen

Objektimporte („Konfiguration“ > „Import & Export“) anlegen zu den Strukturdefinitionen „Currency“ und „Currency Converter“. Dazu können die mitgelieferten CSV-Dateien „Currency.csv“ und „Currency_Converter.csv“ (zu finden im Unterverzeichnis „data“ der ZIP-Datei) verwendet werden.

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

Bitte verwenden Sie die Währungs-Entität („Currency“) in den Entitäten, in denen Währungsbeträge enthalten sind. Wenn noch keine Währung als Attribut-Referenz in Ihrem Nuclos-System vorhanden ist, dann genügt es die Währung als zusätzliches Attribut hinzunehmen. Sollten Sie bereits eine eigene Entität nutzen, die Währungen abbildet, dann ist die Integration des Nuclets nur mit einem Mehraufwand zu realisieren.

Nutzung

Einrichten der Jobsteuerung

1. Öffnen der Jobsteuerung „ECB Exchange Rates“ unter „Administration“ > „Jobsteuerung“

2. Konfiguration von Startdatum, Startzeit, Intervall, E-Mail-Benachrichtigung und Optionen zum Löschen des Log-Infos.

3. Jobsteuerung aktivieren, falls der Job im konfigurierten Rhythmus automasiert ausgeführt werden soll. Alternativ lässe sich der Job über die Jobsteuerung auch manuell ausführen.

Betrieb

1. Die importierten Daten werden in der Entität für Wechselkursee („Exchange Rate“) gespeichert.

2. Die Masken für Währungen und Wechselkurse sind unter dem Menüpunkt „Wechselkurse“ zu finden. Dies ist über den Entitäten-Wizard jederzeit zu ändern.

3. Der Währungsrechner ist ebenfalls unter dem Menüpunkt „Wechselkurse“ zu finden. Sollten Sie ihn nicht nutzen wollen, dann können Sie ihn über den Entitäten-Wizard aus dem Menü entfernen.

4. Das Nuclet ist zur Zeit so eingestellt, dass alle Wechselkurse in der Basiswährung des System angezeigt werden. Da die Aktualisierung über die EZB-Schnittstelle läuft, ist der Euro (EUR) als Basiswährung hinterlegt. Sie können das Nuclet auch leicht so einstellen, dass in jeder Währung der Wechselkurs zum Euro angezeigt wird: Dazu öffnen Sie das Layout „Currency“ und tauschen den eingetragenen Wert im Feld „Fremdschlüssel“ (Unterformular „Exchange Rates“) von „baseCurrency“ auf „counterCurrency“.

Einrichten von Benutzerrechten (optional)

Zugriffsrechte für existierende Benutzergruppen für Layouts, Entitäten, Attribute und Attributgruppen können in Nuclos wie üblich über drei Wege festgelegt werden (siehe dazu http://wiki.nuclos.de):

1. allemeine Einstellungen für Entitäten unter „Administration“ > „Benutzergruppen“

2. statusabhängige Einstellungen für Attribute/Attributgruppen unter „Konfiguration“ > „Statusmodell“

3. datensatzspezifische Einstellungen unter „Konfiguration“ > „Datenquellen“ > „Datensatzfreigabe“

Tests

• Für einfache Tests von Währungskonvertierungen steht die Währungsrechner-Maske zur Verfügung.

• Für erweiterte Tests von Währungskonvertierungen nutzen Sie bitte die Klasse org.nuclet.currency.test.CurrencyConverterTest. Diese können Sie auch gerne auf Ihre eigenen Bedürfnisse anpassen und erweitern. Die Klasse wird vom org.nuclet.currency.test.CurrencyConverterTestJob aufgerufen, und dieser lässt sich über die Jobsteuerung „Currency Converter Test“ bei Bedarf (am besten manuell) ausführen.

Versionen