Page Comparison

Diese Dokumentation ergänzt die Informationen der Moduldokumentation des Erweiterungsmoduls Versandhandel um Hinweise zur Installation und Konfiguration für die Verwendung Professional ERP-Schnittstelle zur EasyFLEX-Software des Versanddienstleisters Trans-O-Flex.

Installation von EasyFLEX

Für die Installation von EasyFLEX sind folgende grundsätzliche Schritte notwendig:

1. Installieren Sie EasyFLEX mit der von Ihrem Trans-O-Flex Vertriebspartner bereitgestellten Installationsdatei
2. Binden Sie nach der Installation die ebenfalls von Ihrem Trans-O-Flex Vertriebspartner bereitgestellte Vertragsdatei (*.dbb) ein, um die Software mit den für Sie relevanten Versandparametern zu bestücken:
   

   Include Page
   screen Installation EasyFLEX Vertragsdatei importieren screen Installation EasyFLEX Vertragsdatei importieren

   
   

   Include Page
   screen Installation EasyFLEX Stammdaten importieren screen Installation EasyFLEX Stammdaten importieren

   
   

   Include Page
   screen Installation EasyFLEX Vertragsdatei öffnen screen Installation EasyFLEX Vertragsdatei öffnen

   
   

   Include Page
   screen Installation EasyFLEX Stammdaten importieren Fenster schließen screen Installation EasyFLEX Stammdaten importieren Fenster schließen

Konfigurationsmaßnahmen in EasyFLEX

Die EasyFLEX-Software benötigt für die Anbindung an die Professional ERP Versandhandelsschnittstelle die nachfolgend beschriebenen Konfigurationsmaßnahmen. Zuvor sollte die von der Software-Schmiede Vogler & Hauke GmbH bereitgestellte Definitionsdatei XMLBEISPIELDATEI-TRANSOFLEX.xml in das für das Polling vorgesehene Verzeichnis kopiert werden, welches in der Konfigurationsvariablen TOFOUTCOPYTOPATH (vgl. Dokumentation Versandhandel.pdf) festgelegt wurde.

Zuordnung der Schnittstellendateieigenschaften

Es wird eine neue Definition für das Polling der zu verarbeitenden Dateien. Hierfür muss im Menü Sendungen der Eintrag Polling aufgerufen werden.

Im sich öffnenden Dialog muss dann über die Schaltfläche Neu eine neue Importdefinition erzeugt werden.

Es öffnet sich die Bearbeitungsmaske für Importeinstellungen. Als Name kann eine beliebige Bezeichnung – hier SWSXML – gewählt werden. Im Auswahlfeld Datenquelle Typ ist die Option Xml zu wählen.

Unmittelbar nach der Auswahl der Option Xml öffnet sich ein weiterer Dialog Import – Xml Einstellungen für die eigentliche Importdefinition.

Über die Schaltfläche Öffnen wird ein Dateiauswahldialog geöffnet innerhalb dessen die zu Beginn kopierte XML-Datei ausgewählt werden muss.

Nach erfolgter Auswahl der XML-Datei muss im Dialog Import – Xml Einstellungen über die Schaltfläche hinter dem Eingabefeld Root der Dialog XML-Daten Konfiguration aufgerufen werden.

In diesem Dialog ist der Eintrag Sendung auszuwählen und über die Schaltfläche Absolute Ref zu bestätigen. Die direkte Eingabe des Wertes //Sendung in das Eingabefeld Root ist zwar prinzipiell möglich, allerdings ist dies aufgrund eines Softwarefehlers zumindest in der aktuellen EasyFLEX-Version nicht zu empfehlen, da es bei diesem Vorgehen in den nachfolgenden Schritten zu einem Absturz des Programms kommen kann.

Nach der Zuordnung des XML-Wurzelelementes als absolute Referenz, sind im Eingabebereich Elemente weitere XML-Tags als relative Referenzen hinzuzufügen. Der mit einem * versehene Datensatz signalisiert einen zur Elementneuanlage anstehenden Datensatz. Um die Zuordnung vorzunehmen, muss im Feld Tag die zu verwendende Bezeichnung vorgegeben und im Anschluss über die jeweils am rechten Rand eines Eintrags befindliche Schaltfläche der bereits bekannte XML-Konfigurationsdialog geöffnet und nach Auswahl des gewünschten Eintrags mit der Schaltfläche Relative Refe bestätigt werden.

Alternativ können auch direkte Eingaben in den Eingabefeld Tag und Pfad vorgenommen werden. Folgende Tag/Pfad-Kombinationen werden zwingend benötigt:

Im Anschluss muss diese XML-Einstellung per OK bestätigt werden. Als nächstes folgt die Zuordnung der Quell-Datenfelder zu den Ziel-Datenfeldern im Dialog Import-Einstellungen – Sendungen per Drag & Drop.

Es müssen alle Quell-Datenfelder einem Ziel-Datenfeld zugeordnet werden. Folgende Zuordnungen sind vorzunehmen:

Zuordnungs-Tag

Ziel-Datenfeld

ShipmentRefNo

Sendung Ref-Nr.

Sender

Absender Ref-Nr.

Contract

Vertrag

Items

Produkte und Zusatzleistungen

ReceiverRefNo

Empfänger Ref-Nr.

Name 1

Empfänger Name 1

Name 2

Empfänger Name 2

Name 3

Empfänger Name 4

Street

Empfänger Straße

Zip

Empfänger PLZ

City

Empfänger Ort

Country

Empfänger Land

Tel

Empfänger Telefon

Email

Empfänger E-Mail

Gewicht

Sendungsgewicht

Diese Zuordnung ist mit der Schaltfläche Übernehmen zu bestätigen.

Als nächstes über die Schaltfläche Optionen den Dialog Import Optionen aufrufen, Einstellungen gemäß nachfolgender Abbildung vornehmen und mit OK bestätigen.

Nun kann auch der Dialog Import Einstellungen – Sendungen mit OK beendet werden, womit man zum Dialog Polling-Übersicht zurückkehrt.

In diesem Dialog ist das Klickfeld Platzhalter in Dateinamen benutzen anzuhaken, im dahinter befindlichen Textfeld der Platzhaltertext tof_easyflex*.xml einzugeben und zusätzlich die Option Sofort abarbeiten auszuwählen. Dann kann auch dieser Dialog mit OK abgeschlossen werden.