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 | title | Hinweis
---|
Hinweis |
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>
<password>
<firstname>
<lastname>
...
Erzeugt eines R-S Nutzer ohne Berechtigung auf Arbeitsbereiche
...
<user-email/ID>
Ist der Nutzername des R-S Nutzers im R-S
<password>
Ist das Passwort des R-S Nutzers
<firstname>
Ist der Vorname des R-S Nutzers
<lastname>
Ist der Familienname des R-S Nutzers
...
-changePassword
...
<user-email/ID>
<oldpassword>
<newpassword>
...
Ändert das Paßwort für einen bestehenden R-S Nutzer
...
<user-email/ID>
Ist der Nutzername des R-S Nutzers im R-S
<oldpassword>
Ist das bisherige Passwort des R-S Nutzers
<newpassword>
Ist das neue Passwort des R-S Nutzers
...
-resetPassword
...
<user-email/ID>
<newpassword>
...
Setzt das Passwort für einen bestehenden R-S Nutzer zurück
...
<user-email/ID>
Ist der Nutzername des R-S Nutzers im R-S
<newpassword>
Ist das neue Passwort des R-S Nutzers.
...
-createWorkspace
...
<name>
...
Erzeugt einen Arbeitsbereich mit dem angegebenen Namen im R-S
...
<name>
Names des Arbeitsbereiches
...
-assignWorkspace
...
<workspace-name>
<user-email/ID>
...
Weist einen existierenden R-S Nutzer einem Arbeitsbereich zu
...
<workspace-name>
Name des Arbeitsbereiches, welchem der R-S Nutzer zugeordnet werden soll
<user-email/ID>
Ist der Nutzername des R-S Nutzers im R-S
...
-assignWorkspaceAdmin
...
<workspace-name>
<user-email/ID>
...
Weist einen existierenden Arbeitsbereich eine R-S Nutzer mit administrativen Rechten zu
...
<workspace-name>
Name des Arbeitsbereiches, welchem der R-S Nutzer als Administrator zugeordnet werden soll
<user-email/ID>
Ist der Nutzername des R-S Nutzers im R-S
...
-unassignWorkspace
...
<workspace-name>
<user-email/ID>
...
Entfernt einen R-S Nutzer aus dem angegebenen Arbeitsbereich.
...
<workspace-name>
Name des Arbeitsbereiches, aus welchem der R-S Nutzer entfernt werden soll
<user-email>
Ist der Nutzername des R-S Nutzers im R-S
...
-renameWorkspace
...
<old-workspace-name>
<new-workspace-name>
...
...
<old-workspace-name>
Name des Arbeitsbereiches welcher umbenannt werden soll
<new-workspace-name>
der neue Name des Arbeitsbereiches
...
<destination-dir>
<bundle-id>
...
<destination-dir>
Verzeichnis in welches das Produktions-Paket abgelegt werden soll
<bundle-id>
ID des Produktions-Paketes im R-S
...
-fetchProductionBundleDW
...
<destination-dir>
<contract>
...
Führt ein Download für ein Produktions-Paket mit der angegebenen Verfahrensanummer aus dem docxworld-System in das angegebene Verzeichnis durch
...
<destination-dir>
Verzeichnis in welches das Produktions-Paket abgelegt werden soll
<contract>
Verfahrensnummer von docxworld
...
-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>
Name des Arbeitsbereiches, für welchen die R-S Nutzer angezeigt werden soll
...
-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
...
...
<binary-file>
Dateiname des BinaryBundles.
...
<destination-dir>
<bundleid>
...
<destination-dir>
Verzeichnis in welches das BinaryBundle abgelegt werden soll
<bundle-id>
ID des BinaryBundles im R-S
...