Seitenhistorie
Nuclet zur Anbindung an die cKonto-Schnittstelle
| Name: | cKonto |
| Package: | org.nuclet.ckonto |
| Namensraum: | CKT |
| Version: | 1.01.0 |
| Datum: | 13.0312.2013 |
| Nuclos-Version: | ab Nuclos 4.0.1 |
Überblick
Kurzbeschreibung
...
Das cKonto-Nuclet umfasst ein Java-Package mit drei Java-Klassen.
Java-Package-Struktur
Java-Package | Java-Klasse | Kurzbeschreibung |
org.nuclet.ckonto | CkontoCheck | Container-Klasse zur Verarbeitung des cKonto-XMLs |
| CkontoConstants | Konstanten zur Interpretation der Schnittstellenrückgabewerte |
| CkontoUtils | Utility-Klasse mit Validierungsmethoden |
...
Die Integration des cKonto-Nuclets erfolgt in 5 4 Schritten:
Download
Nuclet-Import
Konfiguration der Systemparaemter (entfällt bis auf weiteres)Nuclet-Parameter
Sourcecode-Anpassungen in eigenen Java-Regeln des cKonto-NucletsSourcecode-Anpassungen in eigenen Regeln
Alle Integrationschritte werden im folgenden im Detail detailliert erläutert.
Schritt 1: Download
Download der .nuclet-Datei „cKonto-v1.01.0.nuclet“ auf der Nuclos-Webpage unter „Nuclos Services“ > „Download“ > „Nuclet Download“.
...
Import des cKonto-Nuclets unter „Konfiguration“ > „Nuclet Management“ > „Importieren“ in Ihre bestehende Nuclos-Instanz, Auswahl der Datei „cKonto-v1.01.0.nuclet“
Schritt 3: Konfiguration der SystemNuclet-Parameter
Das cKonto-Nuclet ist über Nuclet-Parameter parametrisierbar. Die Einrichtung der verwendeten Nuclos-Systemparameter über „Administration“ > „Parameter“Nuclet-Pameter erfolgt im Nuclet-Management unter „Konfiguration“.
Parameter | Kurzbeschreibung |
|---|---|
CKONTO_CHECKcKonto Check | Kennzeichnung, ob eine Kontoprüfung über die cKonto-Schnittstelle erfolgen sollCKONTO_KEY |
| cKonto Key | Registrierungsschlüssel |
Tabelle 2: System-Parameter
...
...
Anmerkung: Dieser Schritt wird erst in einer zukünfigen Version notwendig, d.h. sobald die neue Nuclos-API das Auslesen von System-Parametern unterstützt. Solange dies nicht der Fall ist, erfolgt die Konfiguration in Schritt 8, durch Anpassung von entsprechenden Konstanten im Java-Code.
cKonto URL | URL der cKonto-Schnittstelle |
Tabelle 2: Nuclet-Parameter
Schritt 4: Sourcecode-Anpassungen in den Java-Regeln des cKonto-Nuclets
...
Java-Package
...
Java-Klasse
...
Kurzbeschreibung
...
org.nuclet.ckonto
...
CkontoUtils
...
Konfiguration der zwei Konstanten CKONTO_CHECK und CKONTO_KEY
Tabelle 4: Anwendungsspezifische Anpassungen in Java-Regeln
CkontoUtils
Es ist notwendig, die beiden Konstanten CKONTO_CHECK und CKONTO_KEY für den eigenen Anwendungszweck zu konfigurieren:
CKONTO_CHECK: legt fest, ob eine Kontoprüfung über die cKonto-Schnittstelle erfolgen soll
CKONTO_KEY: definiert den Authentifizierungsschlüssel für die cKonto-Schnittstelle; der Default-Wert für Testzwecke ist „demo“
| Codeblock | ||||
|---|---|---|---|---|
| ||||
public class CkontoUtils
{
private static final String CKONTO_KEY = "demo"; // Authentifizierungsschlüssel
private static final String CKONTO_CHECK = "Y"; // Soll eine Kontovalidierung durchgeführt werden?
(...)
}
|
| Hinweis |
|---|
Achtung: Die Validierungsmethoden validiereIBAN() und validiereKontoverbindung() der Klasse Klasse CkontoUtils validieren die übergebenen Parameter immer, unabhängig vom Wert der Konstanten CKONTO_CHECKdes Nuclet-Parameters cKonto Check. Zur Abfrage, ob eine Validierung tatsächlich erfolgen soll, dient die Methode istKontovalidierungAktiviert() in der selben Klasse. |
| Info |
Anmerkung: Dieser Schritt wird in einer zukünfigen Version entfallen, d.h. sobald die neue Nuclos-API das Auslesen von System-Parametern unterstützt. Sobald dies der Fall ist, wird diese Anpasung über Schritt 3 geregelt (s.o.). |
Schritt 54: Sourcecode-Anpassungen in eigenen Regeln
...
Die Validierung lässt sich auf diese Weise einfach über die Konstante CKONTO_CHECK (und später über den entsprechenden SystemNuclet-Parameter , s.o.) cKonto Check an- und ausschalten.
Versionshistorie
Version | Datum | Typ | Änderungen |
|---|---|---|---|
| 1.0.0 | 13.03.2013 | initiale Version | - |
| 1.1.0 | 13.12.2013 | Umstellung auf Nuclos 4.0 |
|
Überblick
Inhalte