Nuclet: EasyLog (DHL) (not yet available)

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

Overview

Short description

The EasyLog Nuclet implements the interface to the third-party shipping software "EasyLog" by DHL as a connection to Nuclos. The EasyLog software assists with capturing, processing and tracking transport orders, shipment preparation and shipment handling. This includes, for example, the fee calculation for captured shipments and the printing of orders for parcel delivery and common labels. Data is exchanged via CSV files in defined directories that Nuclos and EasyLog access.

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 the .nuclet file „EasyLog-v1.2.0-4.13.0.nuclet“ from the Nuclos web page under „Nuclos Services“ > „Download“ > „Nuclet Download“.

Step 2: Nuclet import
Import the EasyLog Nuclet under „Configuration“ > „Nuclet Management“ > „Import“ into your existing Nuclos instance, selecting the file „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