Der Java-Client(EOMS-Input) ist ein in der Programmiersprache Java entwickelter Einlieferungs-Client, welcher als Kommandozeilen-Programm in bestehende Systeme eingebunden werden kann. Die einfachste Form der Nutzung ist der Aufruf des Java-Clients(EOMS-Input) über Batch oder Script-Dateien. Unter allen Plattformen auf welchen Java installiert ist, kann über den nicht grafischen Java-Client(EOMS-Input) von der Kommandozeile des Betriebssystems eine Datenübertragung in das docxworld-System erfolgen.
Arbeitsweise
Der Java-Client(EOMS-Input) kommuniziert nach dem Start mit dem docxworld-Input-Server auf zwei Wegen:
- über einen Kommunikations-Kanal
- über einen Daten-Kanal
Über den Kommunikations-Kanal tauschen sich der Java-Client(EOMS-Input) generell über den Status der Datenübertragung. Des weiteren werden nach der erfolgreichen Datenübertragung über den Kommunikations-Kanal noch Variablen/Parameter übergeben, welche das docxworld-System für die Weiterverarbeitung der Daten benötigt.
Über den Daten-Kanal werden die eigentlichen Druckdaten übertragen an das docxworld-System übertragen. Als Übertragungsprotokoll für die Daten kann folgendes Protokoll verwendet werden:
- SFTP - Übertragung mittel SecureFileTransferProtocol (SSL-Verschlüsselung) an ein docxworld-System
Den Status der gesamten Verarbeitung (Kommunikation-Kanal und Daten-Kanal) gibt der Java-Client(EOMS-Input) über einen Return-Code an das aufrufende Programm zurück.
| Return-Code | Bedeutung |
|---|---|
| 0 | Die Übertragung der Daten ist vollständig und ohne Fehler abgeschlossen worden. |
| 1 | Bei der Kommunikation zwischen de, Java-Client(EOMS-Input) und dem docxworld-Server oder bei der Datenübertragung ist ein Fehler aufgetreten. |
Sind bei der Arbeit des Java-Clients(EOMS-Input) Fehler aufgetreten, so wird die genaue Fehlerursache in einer LOG-Datei protokolliert. Diese LOG-Datei finden Sie im Unterverzeichnis '/logs' im Installations-/Arbeitsverzeichnisses des Java-Clients(EOMS-Input). Der Dateiname lautet: 'eoms.input.info.log'.
Voraussetzung für den Start des Java-Client(EOMS-Input)
- die Verfügbarkeit eines JAVA JRE ab der Version 1.6 auf dem Server wo der Java-Client ausgeführt wird
- eine installierte Version des Java-Client(EOMS-Input)
- eine korrekt definierte Konfigurationsdatei 'eoms.input.client.properties' des Java-Clients(EOMS-Input)
Start des Java-Client(EOMS-Input)
Die Kommandozeile des Java-Client(EOMS-Input) lautet wie folgt:
java -Djava.ext.dirs=lib;%PATH_JRE%/jre/lib/ext -cp .;eoms-input-client.jar de.profiforms.eoms.input.client.EOMSInputClientStarter PARAMETER
Wobei PATH_JRE der Pfad zur JAVA JRE (/bin) ist und mit PARAMETER die auszuführenden Kommandos und übergebene Variablen desJava-Client(EOMS-Input) gemeint sind.
Damit Umlaute oder Sonderzeichen bei der Eingabe über die Kommandozeile berücksichtigt werden, kann direkt hinter ..\bin\java die verwendete Codepage angegeben werden
Unter dem Telnet/SSH-Client PUTTY für UNIX ist die Codepage z.B. wie folgt zu setzen: -Dsun.jnu.encoding=iso-8859-1 -Dfile.encoding=iso-8859-1
Im PUTTY kann die Codepage auch über die Konfiguration WINDOW/Translation eingestellt werden.
Kommados und Variablen des Java-Client(EOMS-Input)
Starten Sie den Administrator-Client(Konsole) ohne ein Kommando, so erhalten Sie eine Liste der möglichen Kommandos/Variable als Hilfe angeboten. Hier eine Auflistung der Kommandos mit Kurzbeschreibung
Kommando | Kommando-Beschreibung |
|---|---|
-submit | Weist den Java-Client(EOMS-Input) an eine Übertragung von Druckdaten an das docxworld-System durchzuführen. |
Variablen werden als zweiter Stellungsparameter, jeweils getrennt durch ',' angegeben.
Variable | Variablen-Beschreibung |
|---|---|
CUST_CUSTOMER=XXXXXXXX | Beschreibt die Ihnen zugeordnete docxworld-Kundennummer unter welcher Sie die Daten einliefern. |
| CUST_CONTRACT=YYYYYY | Beschreibt die docxworld-Vertragsnummer für welchen Sie die Daten einliefern. |
CUST_REFERENCE=ZZZZZZZ | Bezeichnet eine eineindeutige Referenz auf die eingelieferten Daten. Unter dieser Referenz können Sie Anfragen über den Status an das docxworld-System stellen. |
| CUST_VAR[1|4]=AAAAAAA | Sind weitere vier Variablen, welche Sie in Absprache mit dem docxworld-Team als Eigenschaften für diesen Job übergeben. |
Verfügen Sie über keine Angaben für CUST_CUSTOMER, CUST_CONTRACT für das docxworld-System, so kontaktieren Sie bitte das docxworld-Service-Team.
Schreibweise
Die Schreibweise für Gross-/Kleinbuchstaben der Variablen ist nicht von Bedeutung. Beachten Sie weiterhin, dass Leerzeichen in Variablen-Name nicht erlaubt sind und Leerzeichen im Variablen-Inhalt mir "" umschlossen werden müssen.
Überblick
Inhalte