Seitenhistorie
Ziel dieses Schrittes ist, das tatsächlich im Zielnuclet verwendeten Businessobjekt an den Java-Code des MT940-Nuclets anzubinden. Dazu wird der Ansatz verfolgt, Nuclet-unabhängige Wrapper-Klassen zu verwenden – anstelle der zu den Businessobjekten generierten Businessobjekt-Klassen.
Zu den technischen Hintergründen lesen Sie dazu bitte auch den Artikel "Schnittstellen in Java-Regeln".
Hinweis |
---|
Dieser Integrationsschritt kann erst durchgeführt werden, sobald die Vorbedingungen aus Abschnitt 3 erfüllt sind – d.h. sobald entsprechende Businessobjekte für Währung, Referenzen und ggf. Zahlungsbedingungen existieren. |
...
Bei der Anbindung des CAMT-Nuclets sind Wrapper-Klassen für Währungsobjekte, Referenzen und Zahlungsbedingungen (optional) anzupassen.
Wrapper-Klasse | Funktion | Java-Package | Anzupassende Methoden/Konstruktoren |
---|---|---|---|
CurrencyWrapper | Anbindung an verwendete Währungsbusinessobjekt | org.nuclet.mt940.wrapper |
|
ConditionsOfPaymentWrapper | Anbindung an genutzte Zahlungsbedingungen | org.nuclet.mt940.wrapper |
|
ReferenceWrapper | Anbindung an verwendete Referenzobjekte | org.nuclet.mt940.wrapper |
|
Tabelle 4.7.1: Übersicht Nuclet-Schnittstellen
4.7.1.1 CurrencyWrapper
Die Klasse CurrencyWrapper dient als Nuclet-Schnittstelle zum tatsächlich genutzten Währungsbusinessobjekt.
Der Konstruktor der Klasse und die Methode getIso4217Code() sind mit anwendungsspezifischem Verhalten zu befüllen. Letztere Methode sollte den ISO-4217-Währungscode (siehe dazu Wikipedia) des Währunsobjektes zurückliefern.
Methode | Funktion | Anpassung optional? |
---|---|---|
CurrencyWrapper | Zuordnung des tatsächlich genutzten Businessobjektes | nein |
getIso4217Code() | liefert den dreistelligen ISO-4217-Code der Währung (z.B. "EUR", "USD", "GBP") | nein |
Tabelle 4.7.1.1: Anpassungen in CurrencyWrapper
Beispiele dazu sind in Kommentarblöcken angegeben; diese Beispiele sind bei der Integration also an die tatsächlich genutzte Währungsbusinessobjekt (bzw. deren BusinessObject-Klasse) anzupassen.
...
Werden Skontobedingungen verwendet, dann sind die Getter-Methoden für Skontosatz und Skontofrist anzupassen.
Methode | Funktion | Anpassung optional? |
---|---|---|
ConditionsOfPaymentWrapper | Zuordnung des tatsächlich genutzten Businessobjektes | ja |
getCashDiscount() | liefert den Skontosatz | ja |
getCashDiscountPeriod() | liefert die Skontofrist (in Tagen) | ja |
getExtendedCashDiscount() | liefert den Skontosatz bei erweiterter Skontofrist | ja |
getExtendedCashDiscountPeriod() | liefert die erweiterte Skontofrist (in Tagen) | ja |
getCashDiscountExGratiaDays() | liefert die Kulanz (in Tagen) | ja |
Tabelle 4.7.1.2: Anpassungen in ConditionsOfPaymentWrapper
Beispiele dazu sind in Kommentarblöcken angegeben; diese Beispiele sind bei der Integration also an das tatsächlich genutzte Businessobjekt (bzw. deren BusinessObject-Klasse) anzupassen.
...
Anzupassen sind der Konstruktor der Klasse sowie die folgenden Methoden:
Methode | Funktion | Anpassung optional? |
---|---|---|
ReferenceWrapper() | Zuordnung des tatsächlich genutzten Businessobjektes | nein |
getAcceptFirstIncomingPayment() | Liefert die Information darüber, ob die erste eingehende Zahlung den Statuswechsel m Referenzobjekt auslösen soll, d.h. den Statusübergang in Richtung "Bezahlt", "Beglichen", o.ä. | ja |
getBankTransactionRef() | Liefert alle zugeordneten Bankumsätze, indirekt über die Zwischenbusinessobjek "BankTransactionRef", d.h. es sollten alle Einträge des entsprechenden Unterformulars zurückgegeben werden. | nein |
getConditionsOfPaymentId() | Liefert die Datenbank-ID der tatsächlich referenzierten Zahlungsbedingungen | ja |
getDateOfInvoice() | Liefert das Zahlungsdatum. | ja |
getTotalAmountGross() | Liefert den Bruttogesamtbetrag des Referenzobjektes, d.h. den über eingehende Zahlung auszugleichenden Betrag. | nein |
setPaymentDate() | Setzt das "Payment Date" (Zahlungsdatum, Bezahlt am, o.ä.) im Referenzobjekt. | ja |
Tabelle 4.7.1.3: Anpassungen in ReferenceWrapper
Beispiele dazu sind in Kommentarblöcken angegeben; diese Beispiele sind bei der Integration also an das tatsächlich genutzte Businessobjekt (bzw. deren BusinessObject-Klasse) anzupassen.
Codeblock | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
package org.nuclet.camt.wrapper; import java.math.BigDecimal; import java.util.Date; import java.util.List; import org.nuclos.api.businessobject.BusinessObject; import org.nuclos.api.businessobject.facade.Stateful; import org.nuclos.api.provider.QueryProvider; import org.nuclet.camt.BankTransactionRef; import org.nuclet.camt.wrapper.ConditionsOfPaymentWrapper; import org.nuclet.camt.wrapper.AbstractConditionsOfPaymentWrapper; import org.nuclet.camt.wrapper.AbstractReferenceWrapper; // @replace! // // mit eigenem Code zu ersetzen, Beispiel: // // import org.nuclet.businessnuclet.ClientBilling; /** * Konkrete Wrapper-Klasse für Referenzobjekte (Rechnungen, o.ä.) * * @version 1.0 * @date 10.02.2015 * @nuclet org.nuclet.CAMT054 * @nucletversion 1.0.0 * @sincenucletversion 1.0.0 * @since 10.02.2015 * * @author frank.lehmann@nuclos.de */ public class ReferenceWrapper extends AbstractReferenceWrapper { public ReferenceWrapper(final Stateful reference) { // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen! // // Beispiel: // // if (reference instanceof ClientBilling) { // this.businessObject = reference; // } } /** * Liefert die Referenz-Nummer, anhand derer der Datensatz eindeutig * zu identifizieren ist */ public String getReferenceNumber() { // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen! // // Beispiel: // // return ((ClientBilling)this.businessObject).getBillingNumber(); return null; } /** * Liefert die Datenbank-ID der referenzierten Zahlungsbedingungen * */ public Long getConditionsOfPaymentId() { // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen! // // Beispiel: // // return ((ClientBilling)this.businessObject).getConditionsOfPaymentId(); return null; } /** * Liefert die Information darüber, ob die erste eingehende Zahlung den Statuswechsel * im Referenzobjekt auslösen soll, d.h. den Statusübergang in Richtung "Bezahlt", * "Beglichen", o.ä. */ public Boolean getAcceptFirstIncomingPayment() { // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen! // // Beispiel: // // return ((ClientBilling)this.businessObject).getAcceptFirstIncomingPayment(); return Boolean.FALSE; } /** * Liefert alle zugeordneten Bankumsätze, indirekt über die Zwischenentität "BankTransactionRef", * d.h. es sollten alle Einträge des entsprechenden Unterformulars zurückgegeben werden. * */ public List<BankTransactionRef> getBankTransactionRef() { // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen! // // Beispiel: // // return ((ClientBilling)this.businessObject).getBankTransactionRef(); return null; } /** * Liefert das Zahlungsdatum. * */ public Date getDateOfInvoice() { // @replace Bitte bei Nuclet-Integration mit eigenem Code ersetzen! // // Beispiel: // // return ((ClientBilling)this.businessObject).getBillingDate(); return null; } /** * Liefert den Bruttogesamtbetrag des Referenzobjektes, d.h. den über eingehende * Zahlung auszugleichenden Betrag. * */ public BigDecimal getTotalAmountGross() { // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen! // // Beispiel: // // return ((ClientBilling)this.businessObject).getTotalAmountGross(); return BigDecimal.ZERO; } /** * Setzt das "Payment Date" (Zahlungsdatum, Bezahlt am, o.ä.) im Referenzobjekt. * * @param datPaymentDate * */ public void setPaymentDate(final Date datPaymentDate) { // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen! // // Beispiel: // // ((ClientBilling)this.businessObject).setPaymentDate(datPaymentDate); } } |
...