Nuclet: EasyLog (DHL) (not yet available)

Nuclet for connecting to the EasyLog interface (DHL shipping software).

Overview

Short description

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 components

The EasyLog Nuclet comprises

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

• 3 business objects/forms

Java package structure

Business object

Integration

Necessary integration steps

1. Download

2. Nuclet import

3. Configuration of the system parameters (constants in Java class)

4. Source code adjustments in the Java rules

All integration steps are explained in detail below.

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

Step 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“

Step 3: Configuration of the system parameters

Step 4: Source code adjustments

Nuclos export:

Extend the class „AbstractAdresse“ and override the methods of „AbstractAdresse“ with your own class „Adresse“ (example)

public class Adresse extends AbstractAdresse {

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

Call the export method in a server rule (can be a user action, object generation, job, etc.).
Passing the parameter (objects). See also class 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:

Call the import method in a server rule (can be a user action, object generation, job, etc.).
See also class TestEasyLogImport. 

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

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

Process flow

Nuclos export:
The interface file for the data to be transferred to EasyLog must be present in a defined source directory (SystemParameter.DIR_EXPORT) and in CSV format (SystemParameter.ENDING).
A polling function of EasyLog reads in the CSV files at defined intervals and processes the data. The CSV file contains recipient (address), product code, procedure, participation, country, weight.

Nuclos import:
The import function for shipments makes it possible to import complete shipment data from EASYLOG. The interface file from EasyLog is present in a source directory (SystemParameter.DIR_IMPORT) in CSV format.
EasyLog supplies the generated order and tracking number for this shipping order. Each line in the CSV file creates a record in the Nuclos business object „EasyLog Sendungen“ (form).
Further processing steps can be started after the import. As an example, a posting of the parcel (shipping order) with the customer order can take place.

Implementation example:

Under the menu item „Versand/Test EasyLog“, a test environment is created by generating a new record. On the form, the interfaces to EasyLog can be called via the buttons „EasyLog Export“ and „EasyLog Import“. The configuration of the SystemParameter is required beforehand. The buttons „EasyLog Export“ and „EasyLog Import“ call the server rules (user action):

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

with an implementation of example data. The form can also be removed from the menu path again via the business object.

Version history