Dieser Abschnitt beschreibt das Modul ImportDBC Version 1.1 für JTheseus 9.1.01
ImportDBC Version 1.1 importiert Dateien(Dokumente) aus einem Verzeichnis in
JTheseus-Verzeichnisstruktur und ist ab der JTheseus 9.1.01 einsetzbar.
Für den erfolgreichen Import von diesen Dateien ist für jede Datei eine ensprechende index-Datei
erforderlich.
Wichtig - die zu importierende Datei muss die Erweiterung, wie im Parameter SCANFILE-EXT steht (Default-Wert ist "TIF") und eine Index-Datei die Erweiterung, wie in Parameter CONTROLFILE-EXT steht (Default-Wert ist "IDX") haben.
Der Name der zu importierenden Datei muss am Anfang dem Parameter "SCANNAME" entsprechen. Alle Werte sind durch Komma zu trennen und es dürfen keine "." (Punkte) innerhalb eines Wertes vorhanden sein.
Die Parameter SCANFILE-EXT, CONTROLFILE-EXT, SCANNAME werden aus der "JTheseus.INI-Datei" des Moduls ImportDBC ausgelesen. Verfügbar ab Version 1.1 - OP 3291.
Weitere Informationen kann man dem Kochbuch für den OP 2317 (Kapitel Dokumentenimport) entnehmen.
Die Auflistung der Fehlermeldungen im Protokoll befindet sich in der Datei "Errors.txt" - dient nur der Information.
Installation:
Entpacken Sie die beiliegende ZIP-Datei in ein Verzeichnis Ihrer Wahl.
Nehmen Sie die Änderungen in der INI-Datei vor, wie unter dem Punkt "Konfiguration" beschrieben ist.
Sie starten die Routine über die Batch-Datei "StartImportDBC.bat".
Der Aufbau der "StartImportDBC.bat":
java -cp "%classPath%;c:\JTheseusWeb\build\web\WEB-INF\classes\;c:\JTheseusWeb\jtlib\jtds-1.2.jar;ImportDBC.jar" ImportDBC.Main
Am Anfang steht der Pfad zur "java.exe", wenn im %classPath% das nicht hinzugefügt wurde.
Danach kommt -cp und folgende Werte:
%classPath% Der Pfad, der im Betriebssystem für Java eingerichtet ist.
C:\Jtheseus\tomcat\webapps\jtheseus\WEB-INF\classes\ Der Pfad zu den JTheseus-Klassen
Hinweis:
Die hier farblich gekennzeichneten Pfade zu den JTheseus-Klassen in der "StartImportDBC.bat" können je nach Verzeichnisstruktur unterschiedlich sein.
c:\JTheseusWeb\jtlib\jtds-1.2.jar Der Pfad zum Datenbank-Treiber
ImportDBC.jar Der Pfad zu den ImportDokumenten-Klassen
ImportDBC.Main Aufruf des eigentlichen Programms
Konfiguration:
Im gleichen Verzeichnis wie die StartImportDBC.bat muss eine Datei "JTheseus.INI" liegen.
Bei den Einstellungen für die Datenbankverbindung (der Pfad für die Trace-Dateien und die Anzahl der Trace-Dateien)gelten die gleichen Bestimmungen wie bei jeder JTheseus.ini.
Bitte beachten Sie, dass der Parameter MaxConnections=3 nicht verringert werden darf.
Der "JTheseusFolder" gibt den Pfad zu JTheseus an. Dieser Pfad ist sehr wichtig für den Import von Dokumenten.
Es gibt auch hier einen Tracefile, welcher aber auch wieder JTheseus.trc als Dateinamen hat.
WICHTIG: NIEMALS diesen Tracefile auf den Ordner stellen, in dem die Traces von JTheseus liegen!
Bei Einstellungen für jeden Ordner mit den zu importierenden Dokumenten mit Barcode als "File separator" "/" verwenden.
Trennzeichen für die Dateiformate ist Komma ",".
Maximale Anzahl von Zeichen für eine Erweiterung ist 10.
Alle drei Parameter SCANNAME, CONTROLFILE-EXT,SCANFILE-EXT werden case insensitive (ohne Berücksichtigung der Groß- und Kleinschreibung) behandelt.
Der tatsächliche Name einer Steuerdatei wird case sensitive (Groß- und Kleinschreibung wird berücksichtigt) mit der Scandatei verglichen.
______________________________________________________________________________________________________
Parameter:
Context=MD Kontext (Mandant)
InputFolder=c:/ImportDBC/FileTransport Der Pfad für den Eingangsordner
ErrorFolder=c:/ImportDBC/FileTransport/Fehler Der Pfad für den Fehlerordner
ProtocolFolder=c:/ImportDBC/FileTransport/Protocol Der Pfad für den Protocolordner
ImportTimeout=1 Zeit für die nächste Übeprüfung des Eingansordners / in Minuten
RunOnce=Yes | No Die Prozedur läuft nur ein Mal (Yes) oder zyklisch (No).
SCANNAME=SCAN Die ersten Zeichen in dem Dateinamen der Steuerdateien und Scandateien
CONTROLFILE-EXT=idx,frm Die Endungen für die Steuerdateien
SCANFILE-EXT=tif,tiff,pdf,bmp Die Endungen für die Scandateien
======================================================================================================
Es ist zu beachten, dass bei nicht ordnugsgemäßen Abbruch der Routine (z.B. Prozess-"Kill",
Stromausfall usw.) in dem Arbeitsverzeichnis kann eine Datei ImportDBC.tmp bleiben.
Vor dem erneuten Start der Routine muss diese Datei entfernt werden.
Für das ordnungsgemäße Beenden der Routine bei der zyklischen Ausführung bitte die Taste Q
und dann Enter benutzen (alternativ auch möglich: STRG+C oder Window-Close Button).
Beispiel für angepasste Ini- und Bat-Datei:
Angepasste JT-Ini-Datei:
Angepasste Bat-Datei: