Seitenhistorie
...
| Hinweis | ||
|---|---|---|
| ||
Das Wechselkurs-Nuclet beinhaltet keine Währungsbusinessobjekt mehr. Eine Währungsbusinessobjekt muss im Ziel-Nuclet also existieren oder im Rahmen einer Integration angelegt werden. Zwingend notwendig für diese Währungsbusinessobjekt ist, dass ein Attribut existiert, in dem der dreistellige ISO-4217-Währungscode als Identifizierungsmerkmal gespeichert wird (siehe dazu auch Wikipedia). Weitere Voraussetzungen an die Währungsbusinessobjekt Währungsbusinessobjekte entnehmen Sie bitte dem Abschnitt "Integration" auf dieser Seite. Es ist möglich und vorgesehen, die Währung aus dem Currency-Nuclet zu nutzen. |
...
Das Wechselkurs-Nuclet war bislang mit dem Währungs-Nuclet ("Currency") gebündelt, die Währungsbusinessobjekt Währungsbusinessobjekte wurde nun von der Wechselkursfunktionalität getrennt.
...
Das Currency-Nuclet umfasst im Rahmen der .nuclet-Datei
zwei businessobjekten Businessobjekte (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.
...
Typ | Name, englisch | Name, deutsch | Kurzbeschreibung |
|---|---|---|---|
businessobjektBusinessobjekt | Currency Converter | Währungsrechner |
|
| Exchange Rate | Wechselkurs |
|
Layout | Currency Converter |
| Layout für businessobjekt Businessobjekt „Currency Converter“ |
| Exchange Rate |
| Layout für die businessobjekt Businessobjekt „Exchange Rate“ |
Java-Package | org.nuclet.exchangerates.facade |
| Java-Regeln für Datenbankzugriffe je businessobjektBusinessobjekt |
| org.nuclet.exchangerates.job |
| Java-Regeln zur Steuerung von Jobs („Jobsteuerung“) |
| org.nuclet.exchangerates.logic |
| Geschäftslogik |
| org.nuclet.exchangerates.rule |
| Regeln für Insert-,Update- und Delete-Events |
| org.nuclet.exchangerates.test |
| Java-Regeln zur Steuerung von Tests |
| org.nuclet.exchangerates.wrapper | Wrapper-Klassen als Nuclet-Schnittstelle | ||
| org.nuclet.exchangerates.xml |
| XML-Parserfunktionalität für die EZB-Schnittstelle |
Jobsteuerung | Currency Converter Test |
| Test-Job für Währungskonvertierungen |
| ECB Exchange Rates |
| Fristenjob für die Aktualisierung von Wechselkursen |
Strukturdefinition | Currency Converter |
| Importstruktur für businessobjekt Businessobjekt „Currency Converter“ |
Nuclet-Abhängigkeit | org.nuclet.Common |
| allgemeine Helferfunktionalität |
Objektimport | Currency_Converter.csv |
| Stammdatensätze für businessobjekt Businessobjekt „Currency Converter“ |
Tabelle 1: Nuclet-Bestandteile
...
Java-Package | Java-Klasse | Kurzbeschreibung |
org.nucket.exchangerates.facade | AbstractCurrencyFacade | Schnittstellendefinition für Datenbankzugriffe auf eine ein Währungsbusinessobjekt |
| CurrencyFacade | konkrete Ausprägung für Datenbankzugriffe auf eine ein Währungsbusinessobjekt | |
| CurrencyFacadeFactory | Factory-Klasse für die CurrencyFacade | |
| ExchangeRateFacade | Datenbankzugriffe auf die businessobjekt das Businessobjekt „Exchange Rate“ |
org.nuclet.exchangerates.job | EcbExchangeRateImporter | Importer-Klasse für die EZB-Schnittstelle |
| EcbExchangeRatesJob | Job für den Aufruf des EZB-Schnittstellenimports |
org.nuclet.exchangerates.logic | CurrencyConverterLogic | Logik für Währungskonvertierungen |
| CurrencyLogic | Validierungslogik für Währungen |
org.nuclet.exchangerates.rule | ConvertCurrencyAmount | Konvertierung in der Währungsrechner-Maske |
| ValidateBaseCurrency | Validierungen hinsichtlich der Existenz einer Basis-Währung |
| SwapCurrencies | Währungstausch (Basis- und Zielwährung) in der Währungsrechner-Maske |
org.nuclet.exchangerates.test | CurrencyConverterTest | Test-Klasse zum Testen von Währungskonvertierungen |
| CurrencyConverterTestJob | Job zum aufruf des Tests von Währungskonvertierungen |
| org.nuclet.exchangerates.wrapper | AbstractCurrencyWrapper | Wrapper-Objekt für Schnittstellendefinition auf Währungsbusinessobjekt |
| CurrencyWrapper | konkrete Implementierung des Wrapper-Objektes für Währungen | |
org.nuclet.exchangerates.xml.sax | EcbExchangeRate | Wrapper-Klasse für den Import über die EZB-Schnittstelle |
| EcbExchangeRateHandler | XML-Handler für die EZB-Schnittstelle |
...
Download
Nuclet-Import
- Anlegen einer eines Währungsbusinessobjekt oder Import des Currency-Nuclets
- Anpassungen im businessobjektenBusinessobjekte-Wizard
Objektimport anlegen
Objektimport ausführen
Zuordnung von Regeln im Regelmanagement
- Anpassungen in den Java-Regeln
- Layout-Anpassungen
- aktuelle Wechselkurse einlesen
...
| Info | ||
|---|---|---|
| ||
Beim Import werden die folgenden vier Warnhinweise erscheinen:
Der Grund dafür ist: Die Währungsbusinessobjekt Währungsbusinessobjekte als Referenzbusinessobjekt fehlt in den businessobjekten Businessobjekten "Wechselkurs" und "Währungsrechner". Dazu mehr im Schritt 4. |
Schritt 3: Anlegen einer eines Währungsbusinessobjekt oder Import des Currency-Nuclets
Voraussetzung für das Funktionieren des Wechselkurs-Nuclet ist die Existenz einer Währungsbusinessobjekt eines Währungsbusinessobjekts mit folgenden Pflichtfeldern:
| Attribut | Datentyp | Funktion | Umsetzung im Currency-Nuclet |
|---|---|---|---|
| ISO-4217-Code | Text | Identifizierung der Währung über den dreistelligen Währungscode (siehe Wikipedia) | iso4217Code |
| Anzahl der Nachkommastellen | Ganzzahl | die Anzahl der Nachkommastellen des Währungssystems bestimmen die Nachkommastellen der Wechselkurse | numberOfDigits |
| Basiswährung? | Ja/Nein | Definition einer system-eindeutigen Basiswährung (hier: EUR) | isBaseCurrency |
Die Das Währungsbusinessobjekt "Currency" im Currency-Nuclet genügt diesen Voraussetzungen.
| Info |
|---|
Die Attribute müssen nicht so heißen, wie hier angegeben. Eine übereinstimmende Datentypisierung ist hingegen wichtig. Eine Zuordnung der tatsächlich verwendeten Attribute der Währungsbusinessobjekt Währungsbusinessobjekte aus dem Zielnuclet zu den Schnittstellenattributen erfolgt dann im Schritt 8a). |
...
Schritt 4: Anpassungen im businessobjektenBusinessobjekte-Wizard
Über den businessobjektenBusinessobjekte-Wizard muss dann die tatsächlich genutzte Währungsbusinessobjekt Währungsbusinessobjekte als Referenzbusinessobjekt Referenzbusinessobjekte in die Attribute "Basiswährung" und "Zielwährung" der beiden businessobjekten "Wechselkurs" und "Währungsrechner" eingetragen werden.
...
| Quellnuclet | Regeltyp | Regel | Zielnuclet | businessobjektBusinessobjekt |
|---|---|---|---|---|
| ExchangeRates | Aktualisieren | ValidateBaseCurrency | das Nuclet, in dem die tatsächlich von Ihnen genutzte Währungsbusinessobjekt liegt | ihre eigene eigenes Währungsbusinessobjekt |
| ExchangeRates | Anlegen | ValidateBaseCurrency | das Nuclet, in dem die tatsächlich von Ihnen genutzte Währungsbusinessobjekt liegt | ihre eigene eigenes Währungsbusinessobjekt |
| ExchangeRates | Löschen | ValidateBaseCurrency | das Nuclet, in dem die tatsächlich von Ihnen genutzte Währungsbusinessobjekt liegt | ihre eigene eigenes Währungsbusinessobjekt |
Schritt 8: Anpassungen in den Java-Regeln
Das Wechselkurs-Nuclet funktioniert mit jeder jedem beliebigen Währungsbusinessobjekt, daher sind bei einer Integration einige Anpassungen in den Java-Regeln durchzuführen:
| Java-Package | Java-Regel | Kurzbeschreibung | |
|---|---|---|---|
| a | org.nuclet.exchangerates.wrapper | CurrencyWrapper | Wrapper-Objekt für Währungen, d.h. hier wird eine Schnittstelle zur tatsächlich genutzten Währungsbusinessobjekt definiert |
| b | org.nuclet.exchangerates.facade | CurrencyFacade | Definition von notwendigen Datenbankzugriffen auf die das tatsächlich genutzte Währungsbusinessobjekt |
| c | org.nuclet.exchangerates.rule | ValidateBaseCurrency | Nutzung des in 8a) definierten Wrapper-Objekts, d.h. das Business-Objekt der Währungsbusinessobjekt aus dem RuleContext wird "gewrappt" |
...
Die Klasse CurrencyWrapper dient als Nuclet-Schnittstelle zur zum tatsächlich genutzten Währungsbusinessobjekt. Der Methoden und der Konstruktor der Klasse sind mit anwendungsspezifischem Verhalten zu befüllen. Beispiele dazu sind jeweils in Kommentarblöcken angegeben; diese Beispiele sind bei der Integration also an die das tatächlich genutzte Währungsbusinessobjekt (bzw. deren BusinessObject-Klasse) anzupassen.
...
In der Klasse CurrencyFacade sind die Methoden getBaseCurrencies() und getCurrencyByIso4217Code() mit anwendungsspezifischem Verhalten gefüllt werden. Ein Beispiel dazu ist jeweils in einem Kommentarblock angegeben, dieses Beispiel ist an die das tatächlich genutzte Währungsbusinessobjekt (bzw. deren BusinessObject-Klasse) anzupassen.
...
Die importierten Daten werden in der businessobjekt für Wechselkursee („Exchange Rate“) gespeichert.
Die Masken für Währungen und Wechselkurse sind unter dem Menüpunkt „Wechselkurse“ zu finden. Dies ist über den businessobjektenBusinessobjekt-Wizard jederzeit zu ändern.
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 businessobjektenBusinessobjekt-Wizard aus dem Menü entfernen.
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“.
...
Zugriffsrechte für existierende Benutzergruppen für Layouts, businessobjektenBusinessobjekte, Attribute und Attributgruppen können in Nuclos wie üblich über drei Wege festgelegt werden (siehe dazu http://wiki.nuclos.de):
allemeine Einstellungen für businessobjekten für Businessobjekte unter „Administration“ > „Benutzergruppen“
statusabhängige Einstellungen für Attribute/Attributgruppen unter „Konfiguration“ > „Statusmodell“
datensatzspezifische Einstellungen unter „Konfiguration“ > „Datenquellen“ > „Datensatzfreigabe“
...
Überblick
Inhalte