Datenübertragung > EP Scripting

Das Add-On EP Scripting kann verwendet werden, den Daten-Empfang und -Versand über externe Programme zu realisieren. So können beispielsweise Daten, insbesondere EDI-Nachrichten, per FTP oder X.400 (via T-Systems FileWork) versendet werden. Das verwendete System ist auf größtmögliche Flexibilität ausgelegt, um möglichst viele verschiedene Programme ansteuern zu können. Die Ansteuerung erfolgt über Skripte, welche die Syntax von Windows-Batchdateien verwenden, sowie optionalen Parameterdateien. Sowohl Skripte, als auch Parameterdateien werden dynamisch erzeugt und so an den jeweiligen Aufruf angepasst.

Windows-Batch-Programmierung

EP Scriping speichert Skripte als Windows-Batch-Skripte (.bat). Einige Links mit Informationen über Windows-Batch-Programmierung finden Sie unter FAQ / Allgemein / Nützliche Links.

!MC5 verwendet drei unterschiedliche Typen von Skripten, die zu unterschiedlichen Zeiten und in unterschiedlichen Kontexten ausgeführt werden:

•Eingangs-Skripte - Werden ausgeführt, wenn im Eingang eines EPS-Partners Dateien gefunden wurden.

•Ausgangs-Skripte - Werden für jede an einen EPS-Partner gesendete Datei ausgeführt.

•Timer-Skripte - Werden unabhängig von Partnern in regelmäßigen Intervallen ausgeführt.

Benutzereingabe in Skripten unbedingt vermeiden!

Achten Sie darauf, keine Befehle in den auszuführenden Skripten zu verwenden, die auf Benutzereingaben warten! Die Skripte werden von !MC5 unsichtbar im Hintergrund ausgeführt. Wartet ein Skript auf eine Benutzereingabe so ist dies für den Benutzer nicht sichtbar und es kann auch keine Eingabe erfolgen. Das Skript bleibt an der entsprechenden Stelle einfach hängen (es wird automatisch beendet, wenn der globale Skript-Timeout - in der Standardeinstellung nach 10 Minuten - erreicht wird). Dies betrifft beispielsweise auch den Befehl copy: Existiert die Zieldatei im copy-Befehl bereits, muss das Überschreiben durch den Benutzer bestätigt werden, was bei der Ausführung als Skript in !MC5 nicht möglich ist. Im Fall des copy-Befehls kann (und sollte) die Bestätigung durch den Parameter /y unterdrückt werden.

Verarbeitung eingehender Daten

!MC5 prüft in regelmäßigen Intervallen auf neue Dateien im Eingangsverzeichnis jedes Partners. Werden passende Dateien gefunden, wird das für den Partner unter Eingang gewählte Skript ausgeführt und danach werden die Dateien einzeln durch das Module EDI verarbeitet. Der genaue Ablauf sieht wie folgt aus:

1.Passende Dateien werden gefunden.

2.(optional) Die Dateien werden von EBCDIC zu ASCII konvertiert. Kopien der Originaldateien werden im Unterverzeichnis EPS_EBCDIC gespeichert.

3.(optional) Das unter Eingang ausgewählte Skript wird ausgeführt (Variable FILENAME enthält die für den Partner unter Eingang eingestellte Dateimaske).

4.Die Dateien werden einzeln an das Modul EDI übergeben

5.(optional) Der für den Partner eingestellte Filter wird ausgeführt

6.Weitere Verarbeitung gemäß EDI-Einstellungen.

7.Sofern der Filter unter 5. die Datei nicht abgelehnt hat, wird die Datei nach der Verarbeitung in das Unterverzeichnis EPS_Received verschoben.

Versand von Daten

Über das Add-On EP Scripting können Daten nur mittels des Autoversands oder über EDI-Import-Regeln versendet werden. Wird der Versand über eine dieser Automatik-Funktionen angestoßen, dann wird das für den Partner unter Ausgang gewählte Skript für jede Datei einzeln ausgeführt. Der genaue Ablauf sieht wie folgt aus:

1.Eine oder mehrere Dateien werden durch den Autoversand oder einen EDI-Import erfasst und entsprechend verarbeitet.

2.Die Dateien werden in das Ausgangsverzeichnis des Partners gespeichert.

3.(optional) Die Dateien werden von ASCII zu EBCDIC konvertiert. Kopien der Originaldateien werden im Ausgangsverzeichnis in das Unterverzeichnis EPS_ASCII gespeichert.

4.(optional) Das für den Partner unter Ausgang ausgewählte Skript wird ausgeführt (Variable FILENAME enthält den Dateinamen der erfassten Datei).

Partner-unabhängige Timer-Skripte

Timer-Skripte werden unabhängig von Partnereinstellungen in regelmäßigen Intervallen ausgeführt. Sie können beispielsweise dazu verwendet werden, regelmäßig über ein externes Programm neue EDI-Nachrichten abzuholen und diese in den Eingang eines Partners zu speichern, was dann zur automatischen Verarbeitung der Dateien führt (siehe Verarbeitung eingehender Daten). In ausgehender Richtung können Timer-Skripte auch dafür eingesetzt werden, in regelmäßigen Intervallen Dateien zu versenden, die im Ausgang eines Partners stehen.

!MC5-Skript-Variablen

In !MC5 EPS-Skripten können zusätzliche Variablen verwendet werden, die von !MC5 vor dem Aufruf des Skripts entsprechend ersetzt werden. Es gibt sowohl globale Variablen, die über die Windows-Registry gesetzt werden können, als auch lokale, also Skript-abhängige, sowie Partner-abhängige Variablen, deren Werte in den Partner-Einstellungen von EPS-Partnern gesetzt werden können. Partner-abhängige Variablen können nur in Eingangs- oder Ausgangs-Skripten verwendet werden, da nur diese beiden Skript-Typen mit Partner verknüpft werden.

Die Variablen können sowohl im Skript, als auch in der Parameter-Datei verwendet werden.

Globale Variablen

•%GLOB:Name% - Wird durch den Wert der globalen Variable Name ersetzt. Globale Variablen können unter Einstelllungen / EP Scripting / Globale Skript-Variablen angelegt und bearbeitet werden.

Lokale Variablen

•%VAR:BATCH% - Dateiname des Skripts selbst.

•%VAR:PARAMTEXT% - Dateiname der Parameterdatei.

Partner-abhängige Variablen

•%VAR:P1% ... %VAR:P8% - Freie, für jeden Partner individuell definierbare Parameter.

•%VAR:FOLDER% - Eingangs- bzw. Ausgangsverzeichnis des Partners

•%VAR:FILENAME% - Feld Dateimaske/-name des Partners oder, bei Ausgangs-Skripten, der Dateiname der zu versenden Datei.

•%VAR:FILEMASK% - Feld Dateimaske/-name des Partners