EasyLog (DHL)

Nuclet zur Anbindung an die EasyLog-Schnittstelle (Versandsoftware DHL).

Überblick

Kurzbeschreibung

Das EasyLog-Nuclet implementiert die Schnittstelle zu der Drittanbieter Versandsoftware "EasyLog" von DHL als Anbindung an Nuclos. Die EasyLog-Software unterstützt bei Erfassung, Bearbeitung und Verfolgung von Transportaufträgen, Sendungsvorbereitung und Sendungsabwicklung. Hierzu gehören z.B. die Entgeltermittlung für erfasste Sendungen und der Ausdruck von Aufträgen zur Paketbeförderung und Commonlabels. Der Datenaustausch erfolgt über CSV-Dateien in definierten Verzeichnissen auf die Nuclos und Easylog zugreifen.

Nuclet-Bestandteile

Das EasyLog-Nuclet umfasst

• Java-Package "org.nuclet.easylog" mit 4 Java-Klassen

• 3 Businessobjekte/Masken

Java-Package-Struktur

Businessobjekt

Integration

Notwendige Schritte zur Integration

1. Download

2. Nuclet-Import

3. Konfiguration der Systemparameter (Konstanten in Java-Klasse)

4. Sourcecode-Anpassungen in den Java-Regeln

Alle Integrationschritte werden im folgenden im Detail erläutert.

Schritt 1: Download
Download der .nuclet-Datei „EasyLog-v1.2.0-4.13.0.nuclet“ auf der Nuclos-Webpage unter „Nuclos Services“ > „Download“ > „Nuclet Download“.

Schritt 2: Nuclet-Import
Import des EasyLog-Nuclets unter „Konfiguration“ > „Nuclet Management“ > „Importieren“ in Ihre bestehende Nuclos-Instanz, Auswahl der Datei „EasyLog-v1.2.0-4.13.0.nuclet“

Schritt 3: Konfiguration der System-Parameter

Schritt 4: Sourcecode-Anpassungen

Nuclos Export:

Erweitern der Klasse „AbstractAdresse“ und überschreiben der Methoden von „AbstractAdresse“ durch eine eigene Klasse „Adresse“ (Beispiel)

public class Adresse extends AbstractAdresse {

	@Override
	public String getAnschrift1() {
		// Businessobject
		return Kundenadresse.getAnschrift1();
		...
	}
	...

Aufruf der Export-Methode in einer Server-Regel (kann Benutzeraktion, Objektgenerierung, Job, etc. sein).
Übergabe der Parameter(-Objekte). Siehe auch Klasse TestEasyLogExport.

...
Adresse adresse = … // Angabe der Emfängeradresse
LieferbedingungDHL dhlNational = … // Query auf Stammdaten
String gewicht = … // Angabe des Paketgewichtes


 // Adresse, Lieferbedingung DHL, Gewicht
EasyLogExport export = EasyLogExport.getInstance(context);
export.exportEasylog(adresse, dhlNational, gewicht);
 ...

Nuclos Import:

Aufruf der Import-Methode in einer Server-Regel (kann Benutzeraktion, Objektgenerierung, Job, etc. sein).
Siehe auch Klasse TestEasyLogImport. 

...
context.log("Import der EasyLog-Datei");

easyLogImport importEL = EasyLogImport.getInstance(context);
importEL.importEasylog();
...

Prozessablauf

Nuclos Export:
Die Schnittstellendatei für die zu übernehmenden Daten von EasyLog müssen in einem festgelegten Quellverzeichnis (SystemParameter.DIR_EXPORT) und im Format CSV (SystemParameter.ENDING) vorliegen.
Eine Polling-Funktion von EasyLog liest die CSV-Dateien in definierten Abständen ein und verarbeitet die Daten. In der CSV-Datei sind Empfänger (Anschrift), Produktcode, Verfahren, Teilnahme, Land, Gewicht enthalten .

Nuclos Import:
Die Importfunktion für Sendungen ermöglicht komplette Sendungsdaten aus EASYLOG zu importieren. Die Schnittstellendatei von EasyLog liegt in einem Quellverzeichnis (SystemParameter.DIR_IMPORT) im Format CSV vor.
EasyLog liefert die generierte Order- und Tracking-Nummer zu diesem Versandauftrag. Jede Zeile in der CSV-Datei erstellt einen Datensatz im Nuclos Businessobjekt „EasyLog Sendungen“ (Maske).
Weitere Verabeitungsprozesse nach dem Einlesen können begonnen werden. Als Beispiel kann eine Verbuchung des Paktetes (Versandauftrages) mit dem Kundenauftrag erfolgen.

Implementierung Beispiel:

Unter dem Menüpunkg „Versand/Test EasyLog“ wird durch erzeugen eines neuen Datensatzes eine Testumgebung erstellt. Auf der Maske können über die Buttons „EasyLog Export“ und „EasyLog Import“ die Schnittstellen zu Easylog aufgerufen werden. Vorab ist die Konfiguration der SystemParameter notwendig. Die Buttons „EasyLog Export“ und „EasyLog Import“ rufen die Server-Regeln (Benutzeraktion) auf:

org.nuclet.easylog.test.TestEasyLogExport
org.nuclet.easylog.test.TestEasyLogImport

mit einer Implementierung von Beispieldaten. Über das Businessobjekt kann die Maske auch aus dem Menüfpfad wieder entfernt werden.

Versionshistorie