Seitenhistorie
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-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. |
Info | ||
---|---|---|
| ||
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)
Konfigurationsdatei für den Java-Clients(EOMS-Input)
Die Konfiguration befindet sich in der Datei 'eoms.input.client.properties', welche im gleichen Verzeichnis abgelegt sein muss, aus welchem der Java-Clients(EOMS-Input) gestartet wird. Diese Konfigurationsdatei entspricht im Aufbau einer WIKIPEDIA - JAVA-Properties-Datei.
Folgende Einträge sind in dieser Konfigurationsdatei für die Kommunikation mit dem docxworld-Input-Server enthalten:
Eintrag | Wert | Beschreibung |
---|---|---|
eoms.input.service.host | xxx.xxx.xxx.xxx | Die IP-Adresse oder der Host-Name des Servers auf welchem das docxworld-System erreichbar ist |
eoms.input.service.port | 8080 | Ist der TCP/IP-Port unter welchem das docxworld-System mit entfernten Applikationen kommuniziert. |
eoms.input.user | AAAAAA | Ist Ihr Nutzer-Name für die Berechtigung zur Übertragung von Druckdaten an das docxworld-System |
eoms.input.password | BBBBBB | Ist Ihr Passwort für Ihren docxworld-Nutzer |
Einträge zur Datenübertragung via SFTP:
Eintrag | Wert | Beschreibung |
---|---|---|
eoms.input.producer.sftp.host | xxx.xxx.xxx.xxx | Die IP-Adresse oder der Host-Name des SFTP-Servers auf welchem die Daten für das docxworld-System entgegen genommen werden. |
eoms.input.producer.sftp.port | 22 | Ist der TCP/IP-Port unter welchem der SFTP-Server des docxworld-Systems mit entfernten Applikationen kommuniziert. |
eoms.input.producer.sftp.user | CCCCCC | Ist Ihr Nutzer-Name auf dem SFTP-Server von docxworld |
eoms.input.producer.sftp.password | DDDDDD | Ist Ihr Passwort für Ihren SFTP-Server-Nutzer |
Info | ||
---|---|---|
| ||
Verfügen Sie über keine Nutzerdaten für das docxworld-System und den SFTP-Server, so kontaktieren Sie bitte das docxworld-Service-Team. |
Start des Administrator-Client(Konsole)
Die Kommandozeile des Adminstrator-Client(Konsole) lautet wie folgt:
Codeblock |
---|
PATH_JRE\jre\bin\java -Djava.ext.dirs=lib;PATH_JRE/jre/lib/ext -cp .;rs-client.jar de.profiforms.rs.client.admin.AdminClientStarter KOMMANDO |
Wobei PATH_JRE der Pfad zur JAVA JRE ist und mit KOMMANDO die auszuführenden Befehle des Administrator-Client(Konsole) gemeint sind.
Info |
---|
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 |
Kommados des Administrator-Client(Konsole)
Starten Sie den Administrator-Client(Konsole) ohne ein Kommando, so erhalten Sie eine Liste der möglichen Kommandos als Hilfe angeboten. Hier eine Auflistung der Kommandos mit Kurzbeschreibung
Kommando | Parameter | Kommando-Beschreibung | Parameter-Beschreibung |
---|---|---|---|
-createUser | <user-email/ID> | Erzeugt eines R-S Nutzer ohne Berechtigung auf Arbeitsbereiche | <user-email/ID> |
-changePassword | <user-email/ID> | Ändert das Paßwort für einen bestehenden R-S Nutzer | <user-email/ID> |
-resetPassword | <user-email/ID> | Setzt das Passwort für einen bestehenden R-S Nutzer zurück | <user-email/ID> |
-createWorkspace | <name> | Erzeugt einen Arbeitsbereich mit dem angegebenen Namen im R-S | <name> |
-assignWorkspace | <workspace-name> | Weist einen existierenden R-S Nutzer einem Arbeitsbereich zu | <workspace-name> |
-assignWorkspaceAdmin | <workspace-name> | Weist einen existierenden Arbeitsbereich eine R-S Nutzer mit administrativen Rechten zu | <workspace-name> |
-unassignWorkspace | <workspace-name> | Entfernt einen R-S Nutzer aus dem angegebenen Arbeitsbereich. | <workspace-name> |
-renameWorkspace | <old-workspace-name> |
| <old-workspace-name> |
-fetchProductionBundleID | <destination-dir> | Führt ein Download für ein Produktions-Paket mit der angegebenen ID in das angegebene Verzeichnis durch | <destination-dir> |
-fetchProductionBundleDW | <destination-dir> | Führt ein Download für ein Produktions-Paket mit der angegebenen Verfahrensanummer aus dem docxworld-System in das angegebene Verzeichnis durch | <destination-dir> |
-listUsers |
| Zeigt alle im System vorhandene R-S Nutzer an |
|
-listActiveUsers |
| Zeigt alle im System aktuell angemeldeten R-S Nutzer an |
|
-listWorkspaces |
| Zeigt alle im System vorhandene Arbeitsbereiche an |
|
-listWorkspaceUsers | <workspace-name> | Zeigt alle einem Arbeitsbereich zugeordnete R-S Nutzer an | <workspace-name> |
-scheduleGC |
| Startet den Reorganisations-Lauf für das Datei-Repository des R-S |
|
-scheduleStorageInfoUpdate |
| Startet die Abfrage für Informationen über den Status des Datei-Repositories und gibt diese auf Konsole aus |
|
-createBinaryBundle | <binary-file> | Generiert ein BinaryBundle im R-S, welches zur Abarbeitung von Produktions-Paketen vorhanden sein muß. | <binary-file> |
-fetchBinaryBundle | <destination-dir> | Ruft ein BinaryBundle aus dem R-S ab und legt es im angegebenen Verzeichnis ab. | <destination-dir> |
-listBinaryBundles | Zeigt alle im System vorhandenen BinaryBundles an | ||
-clientVersion | Zeigt die Version des aktuell installierten R-S Clients an | ||
-serverVersion | Zeigt die Version des aktuell installierten R-S Servers an |