Sie zeigen eine alte Version dieser Seite an. Zeigen Sie die aktuelle Version an.

Unterschiede anzeigen Seitenhistorie anzeigen

« Vorherige Version anzeigen Version 23 Nächste Version anzeigen »

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. Desweiteren 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-CodeBedeutung
0Die Ü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.

Hinweis

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)

 

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.
XXXXXXXX = Numerisch 8-stellig
Hinweis: Diese Variable muß angegeben werden.

CUST_CONTRACT=YYYYYY

Beschreibt die docxworld-Vertragsnummer für welchen Sie die Daten einliefern.
YYYYYY = Numerisch 6-stellig
Hinweis: Diese Variable muß angegeben werden.

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.
ZZZZZZZ = Zeichenkette, welche optimalerweise DATUM/UHRZEIT/ID enthält. Beispiel: 2011.01.23-00013
Hinweis: Diese Variable muß angegeben werden.

CUST_VAR[1|4]=AAAAAAA

Sind weitere vier Variablen, welche Sie in Absprache mit dem docxworld-Team als Eigenschaften für diesen Job übergeben.
Hinweis: Die Angabe dieser Variablen ist optional.

Hinweis

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.

  • Keine Stichwörter