windream PCL COLD installieren

windream PCL COLD
Dokumentation
windream GmbH, Bochum
Copyright
© 2001 - 2003
by
windream GmbH / winrechte GmbH
Wasserstr. 219
44799 Bochum
Stand: 01/03 – 1.0.0.0
Alle Rechte vorbehalten. Kein Teil dieser Beschreibung
darf in irgendeiner Form (Druck, Fotokopie oder einem
anderen Verfahren) ohne Genehmigung der windream
GmbH / winrechte GmbH reproduziert oder unter
Verwendung elektronischer Systeme verarbeitet,
vervielfältigt oder verbreitet werden.
Wichtige Hinweise
Alle Informationen und technischen Angaben dieser Beschreibung wurden
von den Autoren mit größter Sorgfalt zusammengetragen. Sie können
jedoch weder Garantie noch juristische Verantwortung oder irgendeine
Haftung für Folgen, die auf fehlerhafte Angaben zurückgehen, übernehmen.
Wir weisen darauf hin, daß die in dieser Beschreibung verwendeten Softund Hardwarebezeichnungen und Markennamen der jeweiligen Firmen im
allgemeinen einem Warenzeichen-, Marken- oder Patentrechtschutz
unterliegen.
Inhalt
i
Inhalt
windream PCL COLD
1
Einleitung
1
Grundlagen zu windream COLD
3
Systemvoraussetzungen
7
Hardware-Voraussetzungen
7
Software-Voraussetzungen
7
Weitere Voraussetzungen
7
windream PCL COLD installieren
9
Nach der Installation
10
PCLTool SDK freischalten
10
Die Beschreibungsdateien (tpt-Dateien) erstellen
10
Die Beschreibungsdateien (tpt-Dateien) testen
11
Die Konfigurationsdatei PCLToXMLToWindream.ini erstellen
bzw. anpassen
12
Verarbeitungsablauf
13
Verzeichnisstruktur und installierte Dateien
14
bin
14
Die Beschreibungsdateien
15
Parameter der Beschreibungsdatei
15
Beispiel für eine Beschreibungsdatei
19
Die Konfigurationsdatei
22
Parameter der Datei
22
Beispiel für eine Konfigurationsdatei
28
Abbildungsverzeichnis
31
Tabellenverzeichnis
33
Index
35
windream PCL COLD
1
windream PCL COLD
Einleitung
Die vorliegende Dokumentation dient Ihnen als Hilfestellung bei der
Installation und Konfiguration von windream PCL COLD (ab Version
1.0.35).
Hinweis zur Namenskonvention: Die im weiteren Verlauf
dieser Dokumentation verwendete allgemeine Produktbezeichnung
XML Import Manager ein Synonym für die interne
Modulbezeichnung XMLToWindream.
windream PCL COLD ist die Lösung zur automatischen Übernahme
von HP PCL Druckdaten (PCL - Printer Control Language von
Hewlett Packard) basierend auf den Druckertreibern der HP Laser Jet
IV Serien in das DMS windream. Die Beschreibung gibt einen kurzen
Überblick über die Grundlagen und Voraussetzungen der Installation
von windream PCL COLD. Es wird ebenfalls erläutert, welche
Konfigurationen und Systemeinstellungen für den Betrieb von
windream PCL COLD notwendig und ggf. anzupassen sind.
Die für windream PCL COLD benötigte Komponente
PCLToXMLToWindream sowie die Konfigurationsdatei
(PCLToXMLToWindream.ini) werden in das
Programmverzeichnis von XMLToWindream kopiert.
Der XML Import Manager ist über ein Setup zu installieren. Die
Beschreibung des XML Import Managers und des Setups ist nicht
Bestandteil dieser Dokumentation. Sie finden die Beschreibung des
Import-Moduls in der Dokumentation "XML Import Manager Referenzarchivierung über XML-Dateien" auf der Installations-CD des
Importmoduls.
Die Installation von XMLToWindream setzt Kenntnisse in der
Bedienung von Microsoft Windows NT (Systemverwaltung) voraus.
Informationen dazu finden Sie in den entsprechenden
Dokumentationen von Microsoft.
Für den Betrieb von windream PCL COLD ist die Installation von
PCLTool SDK von Page Technology Marketing, Inc. (PageTech)
Voraussetzung. Vor der Inbetriebnahme von windream PCL COLD
sind mit Hilfe von PCLTool SDK die Beschreibungsdateien zu
erstellen, anhand derer die Konvertierung der Druckdaten für den
Import durch windream PCL COLD erfolgt.
2
windream PCL COLD
Die Installation und der Betrieb von windream PCL COLD setzt
Kenntnisse in der Bedienung von PCLTool SDK (beispielsweise für
die Erstellung der Beschreibungsdateien) voraus. Informationen dazu
finden Sie in den entsprechenden Dokumentationen von Technology
Marketing, Inc. (PageTech) - http://www.pcltools.com..
windream PCL COLD
3
Grundlagen zu windream COLD
Mit Hilfe der Software PCL Tool SDK bietet die windream GmbH
eine Lösung an zur automatischen Übernahme, Indexierung und
Archivierung von HP PCL Druckdaten in das DMS windream.
PCLTool SDK
Das PCLTool SDK ist eine Software zur Konvertierung von HP PCL4
und 5 Druckdateien (basierend auf den Druckertreibern der HP Laser
Jet IV Serien) in Bitmap-Formate (z.B. Tif), Vektor-Formate (z.B.
WMF) oder auch Adobe-Acrobat PDF-Format. Zudem besteht die
Möglichkeit den Text in Textdateien zu extrahieren, um diesen
beispielsweise in nachfolgenden Verarbeitungen als Volltext zu
Dokumenten zu archivieren.
Die Datenkonvertierung erfolgt mit dem Konvertierungsprogramm
PCLXFORM.exe von PCLTool SDK anhand von Transformation
Parameter Table Skripts (TPT-Beschreibungsdateien). Über diese
Dateien wird der Konvertierungsprozess gesteuert. Hier wird
beispielsweise festgelegt, welche Eingangsdateien konvertiert werden
sollen, die Art der Konvertierung und die Bezeichner der jeweiligen
Ausgabedateien.
Die so konvertierten Daten können dann in nachfolgenden Prozessen
beispielsweise für den Import (Indexierung und Archivierung) in das
DMS windream aufbereitet werden. Diese Integration der
Konvertierungssoftware und die Steuerung der einzelnen
Konvertierungsprozesse sind mit dem Modul
PCLToXMLToWindream realisiert worden.
PCLToXMLToWindream
Das Modul zur Anbindung (PCLToXMLToWindream) stößt anhand
der Beschreibungsdateien zunächst die Konvertierung der zugehörigen
Eingangsdateien an. Die Binärdateien werden dabei in das für den
Import erforderliche Format in den für den Import erwarteten
Verzeichnissen abgelegt. Die extrahierten Indexinformationen werden
zunächst in Indexdateien (mit der Endung idx) abgelegt.
Anschließend generiert PCLToXMLToWindream aus diesen
Indexdateien die entsprechenden XML-Dateien für den Import der
Indexdaten und stellt diese in die für den Import erwarteten
Verzeichnisse ein. Zusätzlich können bei der Konvertierung abhängig
von den gesetzten Parametern in den Beschreibungsdateien
Textdateien erstellt werden, die dann als Volltexte zu den Dateien
archiviert werden. Die erstellten Dateien (Binär- Index- und
Volltextdateien) werden dann von XMLToWindream archiviert.
•
PCLToXMLToWindream ruft zu den Eingangsdateien die für die
Konvertierung zugehörigen Beschreibungsdateien auf und startet
den Konvertierungsprozess durch PCLXForm.
4
windream PCL COLD
Unter Einsatz von PCLXForm werden von
PCLToXMLToWindream die Eingangsdaten wahlweise ins Tif G4Format oder ins PDF-Format konvertiert und ggf. zusätzlich zu den
Dokumenten die Texte extrahiert und in Textdateien für den Import
als Volltexte zur Verfügung gestellt.
• Zudem erstellt PCLToXMLToWindream für jede zu importierende
Datei eine XML-Datei für den Import mit XMLToWindream zur
automatischen Indexierung. Nach erfolgreicher Erstellung entfernt
PCLToXMLToWindream die bearbeiteten Dokumente aus den
Verzeichnissen der Eingangsdateien (abhängig von der aktuellen
Konfiguration).
•
windream PCL COLD
PCL-Eingangsdaten
PCLTool SDK / Editor
Beschreibungsdateien
Verarbeitung
PCLToXMLToWindream: Prozesse zur Konvertierung
und Bereitstellung der Eingangsdaten
XMLToWindream.vbs
Binärdatei
XML-Datei
XMLToWindream.exe
- Vorverarbeitung (z.B. OCR)
- Indizierung und Archivierung
- Nachverarbeitung
windream
Dokument
Volltext
Abbildung 1: windream PCL COLD
Analyse und Aufbereitung der Eingangsdaten
Für den Import der Dokumente werden die eingehenden Druckdaten
(PCL-Dateien) zunächst analysiert, d.h., es wird festgelegt welche
Informationen aus den Dokumenten als Indexkriterien für die zu
importierenden Dokumente verwendet werden sollen. Diese Analyse
erfolgt mit Hilfe des Programms PCLTool.exe von PCLTool SDK.
Anschließend werden diese Informationen in die Beschreibungsdateien
übernommen. Die erforderlichen Beschreibungsdateien werden mit
Hilfe eines beliebigen Editors unter Verwendung der
Programmiersprache von PCLXForm (Transformation Parameter
Table (TPT)) geschrieben.
Zudem wird in den Beschreibungsdateien festgelegt, dass eine
Dateivereinzelung erfolgen soll. Die Eingangsdateien können eine
Vielzahl von Dateien gleichen Typs (beispielsweise Rechnungen)
enthalten, die vor der Konvertierung für den Import nach windream
als einzelne Dateien verfügbar sein müssen. Des weiteren legen Sie hier
windream PCL COLD
5
die Art der Konvertierung der Eingangsdaten für die Erstellung der
Binärdateien fest. Möglich ist die Konvertierung in TIF- oder PDFDateien.
Falls mit Hilfe von PCLXForm für die Dokumente zusätzlich ein
Volltext (TXT-Datei) erstellt werden soll, müssen Sie dies in der
Beschreibungsdatei entsprechend festlegen. Beim Import werden diese
Textdateien als Volltext in windream gespeichert. Existiert zu einem
Dokument keine Textdatei, wird der Volltext von windream beim
Import erstellt. Dies ist allerdings nur für PDF-Dateien möglich.
Für jede PCL-Eingangsdatei ist eine eigene Beschreibungsdatei zu
erstellen.
Die Beschreibungsdateien werden mit der Endung .tpt in dem
Verzeichnis abgelegt, in dem PCLToXMLToWindream diese Dateien
für den Konvertierungsprozess erwartet (Programmverzeichnis von
PCLTool SDK).
Die Beschreibung von PCLTool SDK, der eingesetzten Programme
(z.B. PCLXForm.exe) oder der Beschreibungsdateien
(Transformation Parameter Table (.TPT)) ist nicht Bestandteil der
vorliegenden Dokumentation. Informationen dazu finden Sie in den
entsprechenden Dokumentationen des PCLTool SDK von Technology
Marketing, Inc..
Konvertierung der Eingangsdaten
PCLToXMLToWindream ist das Konvertierungsmodul, das die
Eingangsdaten aus den Beschreibungsdateien in das für den Import mit
Hilfe von PCLXForm.exe in dem von XMLToWindream benötigte
Format erstellt (siehe auch Abschnitt "Die Beschreibungsdateien", ab
Seite 15).
Mit Hilfe der Beschreibungsdateien und einer Konfigurationsdatei
werden die Eingangsdateien von PCLToXMLToWindream zunächst in
das für den Import ins DMS erforderliche Format konvertiert.
Anschließend stellt PCLToXMLToWindream diese Daten in den
erwarteten Verzeichnissen bereit. Optional erstellt
PCLToXMLToWindream zusätzlich unter Verwendung von PCLTool
SDK (PCLXForm) den Volltext in den für den Import erwarteten
Verzeichnissen zur Verfügung.
Abhängig von der aktuellen Konfiguration, entfernt
PCLToXMLToWindream nach erfolgreicher Konvertierung die
bearbeiteten Druckdaten aus dem Eingangsverzeichnis der
Eingangsdateien.
Import der Daten in windream
XMLToWindream (das Importmodul) übernimmt dann die
6
windream PCL COLD
Indexierung und Archivierung der Dokumente (Binärdateien,
Indexinformationen und Volltext).
Der Volltext wird dabei direkt bei der Archivierung in windream
erstellt. Existiert zu einem Dokument bereits eine Volltextdatei
(*.TXT), wird diese als Volltext in windream archiviert.
Die Beschreibung des Importmoduls finden Sie in der Dokumentation
"XMLToWindream - Referenzarchivierung über XML-Dateien" auf
der Installations-CD.
Konfiguration der Anwendung
Die Konfiguration von windream PCL COLD erfolgt über das Setup
von XMLToWindream, die Beschreibungsdateien (tpt-Dateien) und
die Konfigurationsdatei PCLToXMLToWindream.ini. Diese
Konfigurationsdatei enthält Informationen, die für den Datenimport
nach windream relevant sind. Dies sind zum Beispiel der Name des zu
verwendenden Objekttyps, die Bezeichner der objekttypspezifischen
Indexfelder oder der Zielpfad für die Dokumentablage in windream
(siehe auch Abschnitt "Die Konfigurationsdatei", ab Seite 22).
Durch die Erstellung projektspezifischer Beschreibungsdateien und die
Anpassung der standardmäßig mitgelieferten ini-Datei können
benutzerspezifische Anforderungen realisiert werden (siehe auch
Abschnitt "Die Beschreibungsdateien", ab Seite 15).
Installationsreihenfolge
Die Installation von windream PCL COLD setzt in jedem Fall eine
vorherige Installation von windream Server oder windream Client
inklusive der dafür benötigten Komponenten voraus (auf dem Rechner,
auf dem windream PCL COLD installiert wird).
Zudem muss PCLTool SDK von Page Technology Marketing, Inc.
(PageTech) installiert sein. Sie erhalten eine lizensierte Version von der
windream GmbH mit dem Erwerb von windream PCL COLD.
Für den Import der Dokumente muss der XML Import Manager
installiert sein. Sie erhalten eine lizensierte Version von der windream
GmbH mit dem Erwerb von windream PCL COLD.
Microsoft MSXML 3.0 muss installiert sein. Die Software finden Sie
auf der Installations-CD. Sie können diese mit Hilfe der Datei
msxml3.msi installieren.
Die Installationsprogramme für windream Server, windream Client
und windream PCL COLD (PCLTool SDK, XML Import Manager,
PCLToXMLToWindream) finden Sie auf den Installations-CDs, die Sie
von der windream GmbH oder Ihrem windream Partner erhalten
haben.
windream PCL COLD
7
Systemvoraussetzungen
Folgende Systemvoraussetzungen müssen im einzelnen für die
Installation von windream COLD erfüllt sein:
Hardware-Voraussetzungen
Es müssen die Hardware-Voraussetzungen erfüllt sein, die für die
Installation der aktuellsten Version von PCLTool SDK gelten.
• Es müssen die Hardware-Voraussetzungen erfüllt sein, die für die
Installation von XMLToWindream gelten.
• Arbeitsspeicher von mindestens 128 Mbyte (empfohlen: 256
MByte).
•
Software-Voraussetzungen
•
•
•
•
•
•
Es müssen die Software-Voraussetzungen erfüllt sein, die für die
Installation der aktuellsten Version von PCLTool SDK gelten.
Aktuelle Version von PCL Tool SDK von Technology Marketing,
Inc. (PageTech).
Es müssen die Software-Voraussetzungen erfüllt sein, die für die
Installation von XMLToWindream gelten.
XML Import Manager von der windream GmbH.
Microsoft Installer ab der Version 1.1.
Microsoft XML Engine 2.6 (Microsoft MSXML 3.0). Die Software
finden Sie auf der Installations-CD und Sie können diese mit Hilfe
der Datei msxml3.msi installieren.
Weitere Voraussetzungen
Im folgenden werden weitere Anforderungen aufgeführt, die für den
Betrieb von windream PCL COLD erfüllt sein müssen.
Indexdaten (Objekttyp) für die Archivierung in windream
Für den Betrieb von windream PCL COLD werden für die
Indexierung abhängig von der Art der zu importierenden Dokumente
verschiedene Objekttypen benötigt. Diese müssen in windream
entsprechend definiert sein. Entweder Sie verwenden Objekttypen, die
bereits in windream existieren oder Sie legen die Objekttypen in
windream mit Hilfe der entsprechenden Administrationsfunktion aus
der windream Management Console (WMC) an.
Die für die Indexierung zu verwendenden Indexmerkmale (Objekttyp
und die objekttypspezifischen Indexe) werden mit den entsprechenden
Inhalten aus den XML-Dateien gelesen. PCLToXMLToWindream
verwendet bei der Erstellung der XML-Dateien für die Einträge der zu
verwendenden Indexmerkmale die Angaben aus der
8
windream PCL COLD
Konfigurationsdatei PCLToXMLToWindream.ini (siehe auch
Abschnitt "Die Konfigurationsdatei", ab Seite 22).
Zielverzeichnis in windream
Das Verzeichnis, in dem die zu archivierenden Dokumente im
windream-Laufwerk abgelegt werden sollen, muß bekannt sein bzw.
entsprechend eingerichtet sein (Zugriffsrechte beachten). Das
Zielverzeichnis wird in der Konfigurationsdatei
PCLToXMLToWindream.ini festgelegt (siehe auch Abschnitt
"Die Konfigurationsdatei", ab Seite 22).
windream PCL COLD
9
windream PCL COLD installieren
Für die Installation von windream PCL COLD müssen Sie die
benötigten Komponenten in folgender Reihenfolge installieren:
1. PCLTool SDK
2. XML Import Manager
3. PCLToXMLToWindream.exe und PCLToXMLToWindream.ini
Die Komponenten PCLTool SDK und XML Import Manager
installieren Sie über das jeweilige Setup von den entsprechenden
Installations-CDs.
Die Dateien PCLToXMLToWindream.exe und
PCLToXMLToWindream.ini kopieren Sie von der InstallationsCD in das Verzeichnis bin im Programmverzeichnis von
XMLToWindream auf dem Zielsystem.
Eine ausführliche Beschreibung des Setups vom XML Import Manager
finden Sie in der Dokumentation "XMLToWindream Referenzarchivierung über XML-Dateien" auf der Installations-CD.
Eine Beschreibung der Installation von PCLTool SDK finden Sie in
den Dokumentationen von Technology Marketing, Inc. (PageTech).
10
windream PCL COLD
Nach der Installation
Nach Abschluß der Installation müssen Sie die Beschreibungsdateien
und die Konfigurationsdatei PCLToXMLToWindream.ini
erstellen bzw. anpassen, die von PCLToXMLToWindream für die
Konvertierung der PCL-Druckdateien benötigt werden. Zudem
müssen Sie die Software PCLTool SDK freischalten.
PCLTool SDK freischalten
Um die Software PCLTool SDK freizuschalten, kopieren Sie die Datei
runcode.ini in das Programmverzeichnis von PCLTool SDK.
Diese Datei erhalten Sie von der windream GmbH mit dem Erwerb
von windream PCL COLD.
Die Beschreibungsdateien (tpt-Dateien) erstellen
Die Beschreibungsdateien müssen Sie entsprechend der zu
verarbeitenden Eingangsdateien neu erstellen. Sie können alternativ
auch die mitgelieferte Beispieldatei verwenden und diese den
vorliegenden Anforderungen entsprechend anpassen. Um die Dateien
zu erstellen bzw. zu bearbeiten, verwenden Sie einen beliebigen
Texteditor. Weitergehende Informationen zum Aufbau der Dateien
finden Sie im Abschnitt "Die Beschreibungsdateien", ab Seite 15.
Hinweis: Mit dem Erwerb von windream PCL COLD erhalten
Sie immer auch eine Beispieldatei.
Für die Extraktion der Indexinformationen aus einer Eingangsdatei,
müssen Sie zunächst die Positionen der Indexdaten aus der zu
verarbeitenden PCL-Eingangsdatei ermitteln. Diese Positionen tragen
Sie dann für die einzelnen Indexfelder in der entsprechenden Sektion in
der zugehörigen Beschreibungsdatei ein.
So ermitteln Sie die Position der Daten für die Indexfelder
1. Legen Sie mit einem Texteditor eine Beschreibungsdatei (z.B.
rechnung.tpt) für die zu bearbeitende Eingangsdatei an.
2. Öffnen Sie diese Datei.
3. Starten Sie danach das Programm PCLXForm.exe.
4. Öffnen Sie die Eingangsdatei (z.B. eingang01.cpl), aus der
Sie die Position der Indexdaten ermitteln möchten (Befehl
File>Open).
5. Aktivieren Sie den Befehl Index by Location aus dem Menü Search.
6. Markieren Sie den Bildauschnitt, in dem sich die erste zu
extrahierende Indexinformation befindet (z.B. die
Rechnungsnummer).
windream PCL COLD
11
Abbildung 2: windream PCL COLD - Ermittlung der Indexinformationen mit PCLTool SDK
Im Dialogfeld Define locations for indexing werden die Positionsangaben
angezeigt.
7. Multiplizieren Sie diese Angaben mit dem Faktor 100 und
übertragen Sie diese Werte dann für das Indexfeld in der
Beschreibungsdatei (Sektion [Fields], dem diese
Informationen zugeordnet werden sollen.
8. Wiederholen Sie die Schritte 6 bis 7, bis Sie die Positionsangaben
für alle zu extrahierenden Indexdaten ermittelt haben.
Die Beschreibungsdateien (tpt-Dateien) testen
Um sicherzustellen, dass die Konvertierung der Eingangsdaten durch
PCLXForm anhand der erstellten Beschreibungsdatei ordnungsgemäß
erfolgt, können Sie die Beschreibungsdatei nach der Fertigstellung mit
Hilfe von PCLXForm von PCLTool SDK testen.
Dazu geben Sie folgenden Befehl in der Kommandozeile ein:
<Programmverzeichnis PCLTool SDK>\PCLXForm
<Name der Beschreibungsdatei>.tpt inf=<Name
der Eingangsdatei>
Beispiel:
C:\Programme\PCLTSDK\PCLXForm rechnung.tpt
inf=eingang01.pcl
Hinweis: Vor dem Einsatz von windream PCL COLD, wird
empfohlen, die Beschreibungsdateien zu testen, um zu
12
windream PCL COLD
gewährleisten, dass die Konvertierung der Dateien den
gewünschten Anforderungen entspricht und damit auch der Import
der Dateien fehlerfrei durchgeführt werden kann.
So testen Sie die Beschreibungsdatei
1. Öffnen Sie ein MS DOS-Fenster.
2. Wechseln Sie in das Programmverzeichnis von PCLTool SDK (cd
Laufwerk:\<Programmverzeichnis PCLTool
SDK>).
3. Geben Sie den Befehl PCLXForm <Name der
Beschreibungsdatei>.tpt inf=<Name der
Eingangsdatei> ein.
PCLXForm liefert als Ergebnis die Binär- und die Indexdateien (pdfbzw. tif- und die idx-Dateien) und stellt diese in den in der
Beschreibungsdatei festgelegten Verzeichnissen bereit. Nach der
Kontrolle der erstellten Dateien, können Sie die Bearbeitung der
Beschreibungsdatei abschließen und mit der Bearbeitung der
Konfigurationsdatei PCLToXMLToWindream.ini fortfahren.
Die Konfigurationsdatei PCLToXMLToWindream.ini
erstellen bzw. anpassen
Die Datei PCLToXMLToWindream.ini können Sie entweder neu
erstellen oder Sie verwenden die mitgelieferte Datei und passen sie den
vorliegenden Anforderungen entsprechend an. Um die
Konfigurationsdatei zu erstellen bzw. zu bearbeiten, verwenden Sie
einen beliebigen Texteditor. Eine ausführliche Beschreibung der
Konfigurationsdatei sowie ein Beispiel finden Sie im Abschnitt "Die
Konfigurationsdatei", ab Seite 22.
windream PCL COLD
13
Verarbeitungsablauf
Der Vorgang von der Aufbereitung der Eingangsdaten bis zum Import
der Dokumente unterteilt sich in mehrere aufeinander aufbauende
Prozesse.
Die Analyse der Eingangsdaten und die Entwicklung der
Beschreibungsdateien für die Erkennung der Indexdaten
(vorbereitende Maßnahmen vor der Konvertierung).
• Die automatische Konvertierung der aufbereiteten PCL-Daten in
das XML- und das TIFF- bzw. PDF-Format und der Datenimport
nach windream.
•
Der automatische Import der Dokumente wird über ein VisualBasicSkript (VB-Skript) gesteuert. Das Skript
XMLToWindreamBatch.vbs wird als Vorgang aus dem Ordner
Geplante Vorgänge im Windows Explorer gestartet. Der Vorgang muß
unter einer Benutzerkennung konfiguriert werden, die die Archivierung
in windream in den gewünschten Zielordnern zuläßt.
XMLToWindreamBatch.vbs ist das zentrale Steuerungsskript für
den XML-Import in das DMS windream. Es beinhaltet die einzelnen
Bearbeitungsschritte in Form von entsprechenden Prozeßaufrufen.
Zunächst wird das Konvertierungsmodul PCLToXMLToWindream
aufgerufen, das die benötigten Eingangsdateien (Binär-, Index- und
Volltextdateien) der Eingangsdaten zur Verfügung stellt.
Nach erfolgreicher Konvertierung entfernt PCLToXMLToWindream
die bearbeiteten Dateien aus dem Verzeichnis der Eingangsdaten. Falls
dies nicht gewünscht ist, muß die Konfiguration in der INI-Datei
PCLToXMLToWindream.ini entsprechend angepasst werden
(siehe Eintrag DeleteInputFiles im Abschnitt "Die
Konfigurationsdatei", ab Seite 22).
Anschließend wird das Programm XMLToWindream.exe gestartet,
das die Indexierung und Archivierung der Dokumente (Import) in
windream durchführt. Eine ausführliche Beschreibung des
Steuerungsskripts sowie des Importmoduls finden Sie in der
Dokumentation "XMLToWindream - Referenzarchivierung über
XML-Dateien" von auf der Installations-CD.
14
windream PCL COLD
Verzeichnisstruktur und installierte Dateien
Bei der Installation des XML Import Managers wird die benötigte
Verzeichnisstruktur angelegt bzw. installiert. Dokumentiert werden im
folgenden nur die Ordner und Dateien, die für die Installation der
Komponente PCLToXMLToWindream verwendet werden.
Die Beschreibung der Verzeichnisse und Dateien, die bei der
Installation des Importmoduls XMLToWindream.exe angelegt
werden, entnehmen Sie bitte der Dokumentation zu XMLToWindream
auf der Installations-CD ("XMLToWindream - Referenzarchivierung
über XML-Dateien").
bin
Um PCLToXMLToWindream zu installieren, müssen Sie nach der
Installation von XMLToWindream die folgenden Dateien in das
Unterverzeichnis bin im Programmverzeichnis von
XMLToWindream (Standard: XMLToWindream) kopieren:
Name der Datei
Erläuterung
PCLToXMLToWindream.exe Ausführbares Programm, das die
Daten für den Import bereitstellt.
PCLToXMLToWindream.ini Datei zur Konfiguration des
Konvertierungsprogramms
PCLToXMLToWindream.exe.
rechnung.tpt
Tabelle 1: Installierte Dateien im Ordner "bin"
Beispiel einer Beschreibungsdatei.
windream PCL COLD
15
Die Beschreibungsdateien
Anhand der Beschreibungsdateien wird durch
PCLToXMLToWindream die Konvertierung der PCL-Eingangsdateien
unter Einsatz von PCLXForm angestossen. Für jede PCLEingangsdatei ist eine Beschreibungsdatei zu erstellen. Zunächst
werden die Dokumente vereinzelt. Nach der Dokumentvereinzelung
werden für jedes Dokument zwei oder drei Dateien angelegt:
Binärdatei (Ausgabedateiname.pdf oder
Ausgabedateiname.tif); diese Datei muss für den Import
vorliegen.
• Indexdatei (Ausgabedateiname.idx); diese Datei muss für
den Import vorliegen.
• Volltextdatei (Ausgabedateiname.txt); diese Datei kann
optional erstellt werden.
•
Diese Dateien werden dann von PCLToXMLToWindream in den
Verzeichnissen abgelegt, in denen diese von XMLToWindream
erwartet werden. Die Indexdateien (Ausgabedateiname.idx)
werden zuvor von PCLToXMLToWindream in das für den Import
notwendige XML-Format konvertiert.
Parameter der Beschreibungsdatei
Im folgenden wird der Aufbau einer Beschreibungsdatei erläutert. Es
werden allerdings ausschließlich die Parameter näher beschrieben, die
Einstellungen festlegen, die für den Einsatz von windream PCL
COLD (PCLToXMLToWindream und den XML Import Manager)
notwendig sind (beispielsweise die Pfadangaben für die
Ausgabedateien, Dateinamen der zu importierenden Dateien oder auch
die Feldbeschreibung der zu verwendenden Indizes). Parameter, die die
Konvertierungsprozesse durch PCLXForm konfigurieren, werden
nicht näher erläutert. Zudem werden die Beschreibungsdateien
projektspezifisch programmiert und können um weitere Einstellungen
ergänzt werden.
Eine ausführliche Beschreibung der tpt-Dateien und der möglichen
Parameter finden Sie in der Dokumentation zu "PCL TransForm
(PCLXForm.exe)" von Technology Marketing, Inc. (PageTech).
Sektion [JobParams]
In dieser Sektion werden der Name für die Ausgabedateien, das
Verzeichnis, aus dem die Eingangsdaten gelesen, und das Verzeichnis,
in das die konvertierten Dateien geschrieben werden sollen, festgelegt.
Zudem werden hier die Art der Konvertierung und die Optionen zur
Datei-Konvertierung definiert.
16
windream PCL COLD
#codeperpage
<Ausgabedateiname>%4D
Initialisierung des Schlüssels codeperpage zur Vergabe des
Ausgabedateinamens, der in der Sektion [PageJob] gesetzt wird.
InputDir
InputDir=D:\input
Verzeichnis, aus dem die Eingangsdateien (PCL-Druckdateien) für die
Konvertierung gelesen werden sollen. Dieser Parameter muss gesetzt
sein und mit dem Eintrag InputDirectory in der
Konfigurationsdatei PCLToXMLToWindream.ini
übereinstimmen.
OutputPath
OutputPath=C:\<Programmverzeichnis
XMLToWindream>\binary
Das Verzeichnis, in das die von PCLXForm konvertierten TifDokumente geschrieben werden sollen - dies ist das Verzeichnis
Binary, in dem das Importmodul XMLToWindream die
Binärdateien für den Import nach windream erwartet. Standardmäßig
wird dieses Verzeichnis bei der Installation von XMLToWindream im
Programmverzeichnis von XMLToWindream angelegt (Standard:
XMLToWindream\binary). Der Parameter muss auf dieses
Verzeichnis verweisen.
OutFileName
OutFileName=#codeperpage
Name der Ausgangsdatei, dieser muss genauso festgelegt werden.
Schlüssel codeperpage wird in der Sektion [PageJob] gesetzt.
MultiPage
MultiPage=true
Die Dokumentvereinzelung wird durch diesen Schalter veranlasst.
True = Dokumente werden vereinzelt; False = Keine
Dokumentvereinzelung.
AuxDir
AuxDir=C:\<Programmverzeichnis
XMLToWindream>\binary
Verzeichnis für zusätzlich erstellbare Dateien. Wird von PCLXForm
für den Konvertierungsprozess benötigt.
windream PCL COLD
17
KeyCode
KeyCode=1650014102
Schlüssel von PCLTool SDK, der die Software freischaltet und
Watermarks entfernt; wird nicht benötigt, wenn die lizensierte Version
von PCLTool SDK von der windream GmbH erworben ist. Dann
erfolgt die Freischaltung über die Datei runcode.ini (siehe auch
Abschnitt "PCLTool SDK freischalten", ab Seite 10).
NoProgBar
NoProgBar=true
Zeigt Fortschrittsdialog während des Konvertierungsprozesses an
(False). True=Dialog wird nicht angezeigt.
ExtractAllText
ExtractAllText=true
Diese Einstellung veranlasst die Extraktion des gesamten Dokuments
als Volltext. False= keine Extraktion.
Conversion
Conversion=tif
Legt den Typ der Ausgabedateien fest und bestimmt den Typ für die
Konvertierung der Tif-Dateien; Dateien werden in das Tiff Bitmap
Format (.Tif) konvertiert. Für den Import erwartet der XMLImportmanager die Binärdateien entweder als Tif- oder als PDFDateien. Die Konvertierung erfolgt durch PCLXForm und wird in der
tpt-Datei festgelegt.
Falls eine Konvertierung in TIF-Dateien gewünscht ist, verwenden Sie
diesen Parameter. Andernfalls kommentieren Sie diese Zeile aus und
setzen die entsprechenden Parameter für die PDF-Generierung (s.u.).
Die folgenden Parameter betreffen die Einstellungen zur PDFGenerierung (Konvertierung der Eingangsdaten in PDFDateien).
Multistrip=false
Conversion=pdf
Legt den Typ der Ausgabedateien fest und bestimmt den Typ für die
Konvertierung der PDF-Dateien; Dateien werden in das Portable
Document Format (.PDF) konvertiert.
PdfImageType=raster
LandRotate=true
18
windream PCL COLD
Eine ausführliche Beschreibung der einzelnen Parameter finden Sie in
der Dokumentation zu PCL TransForm (PCLXForm.exe) von
Technology Marketing, Inc. (PageTech) - "PCLXForm Programmer's
Guide"
Sektion [Fields]
In dieser Sektion werden die Variablen für die Indexfelder definiert und
die Positionen festgelegt, an der die zu übernehmenden Indexdaten für
die einzelnen Indexfelder in den zu konvertierenden Dateien
ausgelesen werden sollen. Die Positionsermittlung erfolgt zuvor mit
Hilfe des Programms PCLTool.exe. Die zu konvertierende
Eingangsdatei (PCL-Datei) wird geladen und über den Befehl
Search>Index by Location werden die Positionsangaben für die einzelnen
Indexfelder ermittelt. Diese müssen Sie dann hier ( X, Y, W, H) für
jedes zu verwendende Feld eintragen (siehe auch Abschnitt "So
ermitteln Sie die Position der Daten für die Indexfelder", ab Seite 10).
Hinweis: Die Feldbezeichner der Indexfelder müssen mit denen
in der Konfigurationsdatei PCLToXMLToWindream.ini für
die zugehörigen Objekttypen definierten Felder übereinstimmen.
Die hier definierten Indexfelder werden in der angegebenen
Reihenfolge mit den entsprechenden Indexdaten in die Indexdatei
(idx-Datei) übernommen. Aus dieser Indexdatei wird dann die
entsprechende XML-Datei generiert. Dabei werden nur die
Indexfelder berücksichtigt, die sowohl in der tpt-Datei als auch in
der Konfigurationsdatei definiert sind (siehe auch Abschnitt "Die
Konfigurationsdatei", ab Seite 22).
Die Dateiendungen für die Ausgabedateien (Binär- Index- und
Volltextdateien müssen mit den entsprechenden Einträgen in der
Konfigurationsdatei (Sektion [Common]) übereinstimmen.
Zudem werden in dieser Sektion u.a. die Variablen für die Namen der
Ausgangsdateien (konvertierte Binärdateien), der Volltext- und der
Indexdateien definiert.
Field
Field
Field
f_feld1
f_feld2
f_feldn
( X, Y, W, H)
( X, Y, W, H)
( X, Y, W, H)
; Name der aktuellen Seite =
Ausgabedateiname
; Name der aktuellen Seite =
Ausgabedateiname
VarStr
vsBasePageName
VarStr
vsPageName
VarStr
VarStr
VarStr
vsLastPageName
vsLastExtractFileName
vsExtractFileName
; Name der aktuellen
Volltextdatei
windream PCL COLD
19
VarStr
VarStr
VarNum
VarNum
VarStr
vsIDXName
vsPageNumber
vnPageNumber
dummyNumber
vsTmp
; Name der aktuellen Indexdatei
; Laufende Nummer als String
; Laufende Nummer
Sektion [PageJob]
Die Ermittlung der Indexdaten aus den Dateien, das Anlegen und
Schreiben der Index-, der Binär- und der Volltextdateien erfolgt dann
in der Sektion [PageJob].
Beispiel für eine Beschreibungsdatei
Diese Datei beschreibt die Konvertierung einer PCL-Eingangsdatei, in
der jede Seite der Datei einem Dokument entspricht. Für die
Verarbeitung von Dateien mit mehrseitigen Dokumenten, muss die
Beschreibungsdatei entsprechend programmiert werden.
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
windream GmbH, Bochum
Datei
Rechnung.tpt
Erstellt am
07/2002
Autor
windream GmbH
Beschreibung:
Musterbeschreibung zur PCL-Konvertierung
Diese Beschreibung dient der Verarbeitung von Rechnungen,
von denen in der Eingangsdatei mehrere vorhanden sind.
Diese Datei wird vereinzelt, aus jeder Datei die Indizes
extrahiert und eine Ausgangsdatei geschrieben, deren Format
fuer den windream Import Manager (XMLToWindream) verarbeitbar ist.
[JobParams]
; Initialisierung zur Vergabe des Ausgabedateinamens
#codeperpage
<Rechnung>%4D
; Verzeichnis, aus dem die Eingangsdateien gelesen werden sollen
InputDir=d:\input
; Verzeichnis in das die Tiff-konvertierten Dokumente geschrieben
; werden sollen - dies ist das Verzeichnis Binary von XMLToWindream
OutputPath=c:\XMLToWindream\binary
; Name der Ausgangsdatei muss genauso festgelegt werden
OutFileName=#codeperpage
; Die Dokumentvereinzelung wird durch diesen Schalter veranlasst
MultiPage=true
; Verzeichnis fuer zusätzlich erstellbare Dateien
20
windream PCL COLD
AuxDir=c:\XMLToWindream\binary
; Schlüssel von PCLTool SDK, der die Software freischaltet und Watermarks
; entfernt
;KeyCode=1650014102
NoProgBar=true
; Diese Einstellung veranlasst die Extraktion des gesamten Dokumentes
; als Volltext
;ExtractAllText=true
; Konvertierungstyp, für Tiff-Generierung
; Conversion=tif
; Einstellungen zur PDF-Generierung
; Multistrip=false
Conversion=pdf
PdfImageType=raster
;LandRotate=true
[Fields]
;
; benoetigte Indizes
; Zur Positionsermittlung wird PCLTool.exe aufgerufen,
; die PCL-Datei geladen und Search->Index by Location
; verwendet
;
Field
Field
Field
Field
Field
VarStr
VarStr
VarStr
VarStr
VarStr
VarStr
VarStr
VarNum
VarNum
VarStr
f_kunde
f_kundnr
f_komnr
f_datum
f_rechnr
vsBasePageName
vsPageName
vsLastPageName
vsLastExtractFileName
vsExtractFileName
vsIDXName
vsPageNumber
vnPageNumber
dummyNumber
vsTmp
(598,
(441,
(441,
(441,
(493,
63, 12, 209)
244, 16, 31)
370, 14, 30)
413, 14, 67)
316, 21, 32)
; Name der aktuellen Seite = Ausgabedateiname
; Name der aktuellen Seite = Ausgabedateiname
;
;
;
;
Name der
Name der
Laufende
Laufende
aktuellen Volltextdatei
aktuellen Indexdatei
Nummer als String
Nummer
[Pre-Job]
Set_Num (vnPageNumber, 1)
[Page-Job]
Get_Inp_Basename(vsBasePagename)
Set_Str(vsPageName, "RE_")
ConCat_Str(vsPageName, vsBasePagename)
Format_Num(vsPageNumber, dummyNumber, vnPageNumber)
ConCat_Str(vsPageName, "_")
ConCat_Str(vsPageName, vsPageNumber)
Set_Str ( vsExtractFileName, vsPageName )
Set_Str ( vsIDXName, vsPageName )
ConCat_Str(vsPageName, ".pdf")
ConCat_Str(vsExtractFileName, ".txt")
ConCat_Str(vsIDXName, ".idx")
Set_Str(vsLastPageName, vsPageName)
windream PCL COLD
Set_Pg_Name ( vsPageName )
;
; Dateiname für den extrahierten Volltext setzen
;
; Set_Text_Extract_Filename(vsExtractFileName)
;
; Index Datei oeffnen und mit Indexfeldern fuellen
;
Open_Txt_File(vsIDXName)
;
; Kundennummer
;
Show_Field_Txt(f_kundnr)
;
; Kommissionsnummer
;
Show_Field_Txt(f_komnr)
;
; Rechnungsnummer
;
Show_Field_Txt(f_rechnr)
;
; Kundenname
;
Show_Field_Txt(f_kunde)
;
; Rechnungsdatum
;
Show_Field_Txt(f_datum)
Close_Txt_File()
Add_num(vnPageNumber, 1)
[End-Job]
[End]
21
22
windream PCL COLD
Die Konfigurationsdatei
Mit Hilfe dieser Datei wird die Konvertierung der Eingangsdateien und
der Import der Dokumente in das DMS konfiguriert. Hier werden die
Zielverzeichnisse in windream festgelegt. Für die Konvertierung der
Indexdateien (idx-Dateien) in das XML-Format werden die
notwendigen Zuordnungen für den zu verwendenden Objekttyp und
der objekttypspezifischen Indexfelder eingetragen.
Parameter der Datei
Im folgenden werden die einzelnen Parameter der Konfigurationsdatei
beschrieben.
Sektion [Common]
In dieser Sektion werden allgemeine Parameter gesetzt (beispielsweise
das Verzeichnis der Eingangsdateien oder die Dateiendungen der zu
importierenden Dateien).
InputDirectory
InputDirectory=D:\input
Verzeichnis, aus dem die Eingangsdateien (PCL-Druckdateien) für die
Konvertierung gelesen werden sollen. Dieser Parameter muss gesetzt
sein und mit dem Eintrag InputDir in der Beschreibungsdatei
übereinstimmen.
IdxFileExtension
IdxFileExtension=idx
Dateiendung der von PCLXForm erstellten Indexdateien. Dieser
Parameter muss gesetzt sein und mit den Einträgen in der
Beschreibungsdatei (tpt-Datei) übereinstimmen (Sektion
[Fields]).
Default-Einstellung ist IdxFileExtension=idx.
BinaryFileExtension
BinaryFileExtension=pdf oder
BinaryFileExtension=tif
Dateiendung der von PCLXForm erstellten Binärdateien. Dies sind
abhängig von der in der Beschreibungsdatei festgelegten Art der
Konvertierung entweder PDF- oder Tif-Dateien. Dieser Parameter
muss gesetzt sein und mit den Einträgen in der Beschreibungsdatei
(tpt-Datei) übereinstimmen (Sektion [Fields]).
Default-Einstellung ist BinaryFileExtension=pdf.
windream PCL COLD
23
FulltextFileExtension
FulltextFileExtension=txt
Dateiendung der von PCLXForm erstellten Textdateien. Dieser
Parameter muss gesetzt sein, wenn die erstellten Textdateien als
Volltexte archiviert werden sollen (Sektion [Fields]).
Default-Einstellung ist FulltextFileExtension=txt.
AddOTToRootFolder
AddOTToRootFolder=1/0
1 - Im Zielverzeichnis in windream wird ein Unterverzeichnis mit dem
Namen des verwendeten Objekttyps angelegt (z.B.:
\pclconversion\rechnung).
0 - es wird kein Unterverzeichnis angelegt.
Dieser Parameter muss gesetzt sein. Das Zielverzeichnis selbst wird in
der Sektion [windream] gesetzt.
Default-Einstellung ist AddOTToRootFolder=0.
ConvertFileName
ConvertFileName=1/0
Falls Eingangsdateien mit anderen Endungen als standardisierten
Endungen (z.B. numerische Endungen) verarbeitet werden sollen,
müssen die Dateien vorab umbenannt werden. Dateien mit
numerischen Endungen können in keinem Fall verarbeitet werden.
1 - wandelt den Namen der PCL-Eingangsdatei von xyz.000 in
xyz000.pcl um. Dabei wird die numerische Extension dem
Dateinamen als Bestandteil angehängt.
0 - es erfolgt keine Umbenennung. In diesem Fall muss dann über den
Parameter InputFileExtension der zu verarbeitende Dateityp
gesetzt werden (z.B. pcl oder inp).
Default-Einstellung ist ConvertFileName=0.
DeleteInputFiles
DeleteInputFiles=1/0
Testschalter, der es erlaubt, die generierten Dateien einzusehen sowie
die Eingangsdateien wieder zu verwenden.
1 - Nach der Verarbeitung (Import ins DMS) werden die
Eingangsdateien und die für den Import generierten Dateien aus den
24
windream PCL COLD
jeweiligen Eingangsverzeichnissen von windream PCL COLD
gelöscht.
0 - Die generierten Dateien und die Eingangsdateien werden nicht
gelöscht.
Default-Einstellung ist DeleteInputFiles=1.
InputFileExtension
InputFileExtension=pcl
Schalter der ausschließlich dann verwendet wird, wenn
ConvertFileName=0 ist, um den Dateityp der Dateien
festzulegen, die bearbeitet werden sollen. Muss in diesem Fall gesetzt
sein (z.B. pcl oder txt).
Default-Einstellung ist InputFileExtension=pcl.
AddTimeStampToFileName
AddTimeStampToFileName=1/0
1 - Der Name der Eingangsdatei wird zusätzlich um einen Zeitstempel
als Namensbestandteil erweitert, um den Dateinamen eindeutig zu
machen.
0 - Der Name der Eingangsdatei wird nicht erweitert.
Default-Einstellung ist AddTimeStampToFileName=0.
Sektion [PCLCONV]
Hier wird das Programmverzeichnis von PCLTool SDK eingetragen.
PCLPath
PCLPath=C:\Programme\PCLTSDK
Sektion [windream]
In dieser Sektion werden die Zuordnungen der Beschreibungsdateien
(tpt-Dateien) zu den jeweiligen Objekttypen gesetzt. Zunächst
müssen die zu verwendenden Beschreibungsdateien ermittelt, dann die
zugehörigen Objekttypen zugewiesen werden.
Dafür gibt es zwei alternativ zu verwendende Möglichkeiten:
die Zuordnung über den Parameter Objecttypename oder
• die Zuordnung über die Parameter CharsFromFileName und
Dateinamen bzw. Dateinamenkürzel
•
windream PCL COLD
25
Fehlt der Eintrag CharsFromFileName wird der Objekttyp aus
dem Namen der Eingangsdatei ohne Endung entnommen. Ist der
Eintrag Objecttypename gesetzt, dann wird dieser Objekttyp für
alle zu verarbeitenden Dateien verwendet. Ist der Parameter
Objecttypename gesetzt, werden die ggf. unter
CharsFromFileName und Dateinamen bzw.
Dateinamenkürzel festgelegten Einstellungen ignoriert. In
diesem Fall kann für die zu verarbeitenden Dateien immer nur eine
Beschreibungsdatei verwendet werden. Andernfalls können mehrere
Beschreibungsdateien einem Objekttyp zugewiesen werden.
Objecttypename
Objecttypename=OTname
CharsFromFileName
CharsFromFileName=2
Hier legen Sie fest, wieviele Zeichen aus dem Namen der Eingangsdatei
(vom Anfang des Namens) zur Ermittlung der zugehörigen tpt-Datei
und für die Zuordnung des Objekttyps verwendet werden sollen.
Abhängig von der hier festgelegten Anzahl weisen Sie unter Dateiname
bzw. Dateinamenkürzel dann den jeweilig zu verwendenden Objekttyp
zu. Falls der Eintrag CharsFromFileName nicht gesetzt ist, wird
der komplette Name der Eingangsdatei verwendet. Sie können hier
dann auch mehreren Beschreibungsdateien einen Objekttyp zuweisen.
Im Eintrag TPTFile in den Sektionen der Objekttypen geben Sie die
zu verwendenden Beschreibungsdateien an.
Dateiname bzw. Dateinamenkürzel
Dateiname=Objekttypname1 oder
Dateinamenkürzel=Objekttypname1
Beispiel
Eingangsdateien: rechnung123.pcl, nkform456.pcl
Beschreibungsdateien: rechnung.tpt, nkform.tpt
Objekttyp: Rechnung
CharsFromFileName=2
RE=Rechnung
NK=Rechnung
Ende Beispiel
26
windream PCL COLD
RootFolder
RootFolder=pclconversion
Zielverzeichnis in windream.
Default-Einstellung ist RootFolder=pclconversion.
AddFolder
AddFolder=0/1/2/3/4/5
Der Eintrag steuert, ob im Zielverzeichnis in windream
Unterverzeichnisse gebildet werden sollen, die im Bezeichner das
aktuelle Datum als Bestandteil enthalten. Abhängig vom Parameter
AddOTToRootFolder werden diese Verzeichnisse direkt im
Zielverzeichnis angelegt oder im Verzeichnis für den verwendeten
Objekttyp. Über diesen Eintrag kann die Anzahl von Dateien in einem
Zielverzeichnis begrenzt werden. Dadurch ist zum einen die Anzeige
im Windows Explorer problemlos möglich. Zum anderen ermöglicht
diese Angabe eine zeitliche Strukturierung der archivierten Dokumente.
Default-Einstellung ist AddFolder=0.
Möglich sind die folgenden Werte:
Wert
Zusätzliche Verzeichnisse
0
Es werden keine zusätzlichen Verzeichnisse erzeugt
(Standard).
1
Ein Unterverzeichnis mit dem Bezeichner für das aktuelle
Jahr wird angelegt.
Beispiel : W:\pclconversion\2001
2
Die Unterverzeichnisse mit den Bezeichnern für das aktuelle
Jahr und für den aktuellen Monat werden angelegt.
Beispiel : W:\pclconversion\2002\12
3
Die Unterverzeichnisse mit den Bezeichnern für das aktuelle
Jahr, den aktuellen Monat und Tag werden angelegt.
Beispiel : W:\pclconversion\2002\12\08
4
Die Unterverzeichnisse mit den Bezeichnern für das aktuelle
Jahr, den aktuellen Monat, Tag und Stunde werden angelegt.
Beispiel : W:\pclconversion\2002\12\08\07
5
Die Unterverzeichnisse mit den Bezeichnern für das aktuelle
Jahr, den aktuellen Monat, Tag, Stunde und Viertelstunde
werden angelegt.
Beispiel : W:\pclconversion\2002\12\08\07\15
Tabelle 2: Zusätzliche Verzeichnisse (Eintrag AddFolder) im windream Zielverzeichnis
windream PCL COLD
27
Sektion [Objekttypname1]
Für jeden zu verwendenden Objekttyp wird unter dem Namen des
Objekttyps eine Sektion angelegt, in der die Einstellungen (z.B. die
Zuordnung der Indexdaten aus den tpt- bzw. idx-Dateien zu den
Indexfeldern des Objekttyps) für den Objekttyp festgelegt werden.
Hinweis: Die angegebenen Indexfelder müssen mit den
Einstellungen in den tpt-Dateien bzw. den generierten idxDateien übereinstimmen. Alle hier aufgeführten Felder müssen
genauso in den tpt-Dateien definiert sein. Umgekehrt müssen alle
in der tpt-Datei festgelegten Felder in der Konfigurationsdatei
definiert werden. Es wird empfohlen, dass die Feldbezeichner in
den tpt-Dateien und in der Konfigurationsdatei mit "f_"
beginnen.
f_feld1=Feldbezeichner Feld1 des Objekttyps
f_feld2=Feldbezeichner Feld2 des Objekttyps
f_feld3=Feldbezeichner Feld3 des Objekttyps
f_feldn=Feldbezeichner Feldn des Objekttyps
AppendToRootFolder
Über diesen Eintrag kann die Anzahl von Dateien in einem
Zielverzeichnis begrenzt werden. Dadurch ist zum einen die Anzeige
im Windows Explorer problemlos möglich. Zum anderen ermöglicht
diese Angabe eine zeitliche Strukturierung der archivierten Dokumente
beispielsweise nach Kunden oder Datum der Dokumente.
Bei der Ablage im DMS werden im Zielverzeichnis weitere
Unterverzeichnisse unter den hier festgelegten Bezeichnern angelegt, in
dem die Dokumente dann gespeichert werden.
Es kann maximal ein Datumsfeld angegeben werden. Zudem muss die
Reihenfolge der angegebenen Felder mit der Reihenfolge der Felder in
der tpt-Datei übereinstimmen und das zuletzt eingetragene Feld muss
auch an letzter Stelle in der tpt-Datei gesetzt werden.
AppendToRootFolder=f_feld3,f_feldn
Beispiel:
AppendDateToRootFolder=f_kunde,f_datum
f_kunde=Kundenname=KundeA GmbH
f_datum=Rechnungsdatum=10.12.2002
28
windream PCL COLD
Im Zielverzeichnis werden die Unterverzeichnisse KundeA
GmbH\2002\12\10 angelegt.
TPTFile
TPTFile=beschreibungsdatei1.tpt,beschreibungsd
atei2.tpt
Beispiel
Eingangsdateien: rechnung123.pcl, nkform456.pcl
Beschreibungsdateien: rechnung.tpt, nkform.tpt
Objekttyp: Rechnung
Objekttypspezifische Indexfelder: Rechnungsnummer,
Rechnungsdatum, Kundennummer, Kundenname
In der tpt-Datei definierte Felder:f_rechnr, f_kundnr und
f_kunde, f_datum.
Einträge in der Konfigurationsdatei für den Objekttyp Rechnung:
[Rechnung]
f_rechnr=Rechnungsnummer
f_kundnr=Kundennummer
f_kunde=Kundenname
f_datum=Rechnungsdatum
AppendDateToRootFolder=f_kunde,f_datum
TPTFile=rechnung.tpt, nkform.tpt
Ende Beispiel
Beispiel für eine Konfigurationsdatei
;
; PCLToXMLToWindream.ini
;
; Konfigurationsdatei zur PCL-Konvertierung
;
;
; Maximale Laenge der Eintraege : 255 Zeichen
;
[Common]
windream PCL COLD
29
InputDirectory=d:\input
IdxFileExtension=idx
BinaryFileExtension=pdf
FulltextFileExtension=txt
; Name des Objekttypen an das Wurzelverzeichnis anhängen
; \pclconversion\rechnung
AddOTToRootFolder=1
;
; wandelt den Namen der Eingangsdatei xyz.000 in xyz000.pcl um
; die numerische Extension wird dem Dateinamen als Bestandteil hinzugefuegt.
;
ConvertFileName=1
;
; Testschalter, der es erlaubt, die generierten Dateien einzusehen sowie die
; Eingangsdateien wieder zu verwenden
DeleteInputFiles=0
; Schalter der benutzt wird, um nur Dateien einer bestimmten Endung zu
; bearbeiten, wenn ConvertFileName=0 ist
InputFileExtension=pcl
; der Eingangsdateiname wird zusätzlich um einen Zeitstempel als Namensbestandteil
; erweitert, um den Dateinamen eindeutig zu machen
AddTimeStampToFileName=1
[PCLCONV]
PCLPath=D:\Programme\PCLTSDK
[windream]
; Auflistung der Namensbestandteile aus dem Dateinamen und die Zuordnung zu einem
; windream Objekttypen
; fehlt der Eintrag wird der Objecttyp entweder aus dem Namen der Eingangsdatei
; ohne Endung ermittelt oder es wird der unter Objecttypenname gesetzte
; Objecttyp fuer alle zu verarbeitenden Dateien verwendet.
; entweder Objecttypename setzen oder Mappings
; Namensbestandteil = Objecttypename verwenden.
; Sobald Objecttypename gesetzt ist, werden die anderen Einstellungen
; ignoriert.
; CharsFromFileName - wieviele Zeichen aus dem Eingangsdateinamenanfang zur
; Ermittlung der zugehörigen tpt Datei verwendet werden sollen.
;
; Objecttypename=Rechnung
CharsFromFileName=2
RE=Rechnung
NK=Rechnung
LI=Lieferschein
RootFolder=pclconversion
AddFolder=0
[Rechnung]
f_rechnr=Rechnungsnummer
f_datum=Datum1
f_kundnr=Kundennummer
f_kunde=Kundenname
f_komnr=Kommissionsnummer
;
; reservierter Feldname AppendDateToRootFolder
; in den generierten IDX Dateien sollten die Felder
; mit f_ beginnen
; Dieser Eintrag bewirkt, dass die Dateien in einem Verzeichnisbaum mit dem
; ausgewählten Datum im Pfad abgelegt werden.
; Beispiel: \pclconversion\Musterfirma GmbH\2002\07\30
; Die Angabe des Datumsbestandteils bewirkt eine Begrenzung der Anzahl der Dateien
; in den Zielverzeichnissen. Dadurch ist zum einen die Anzeige im
; Windows Explorer problemlos möglich. Zum anderen ermöglicht diese Angabe eine
30
windream PCL COLD
; zeitliche Strukturierung der archivierten Dokumente - maximal kann ein Feld mit
; Datum angegeben werden.
AppendToRootFolder=f_kunde,f_datum
TPTFile=rechnung.tpt,nkform.tpt
[Lieferschein]
f_liefernr=Nummer
f_datum=Datum1
f_kunde=Kundenname
f_kundnr=Kundennummer
;
; reservierter Feldname AppendDateToRootFolder
; in den generierten IDX Dateien sollten die Felder
; mit f_ beginnen
; Dieser Eintrag bewirkt, dass die Dateien in einem Verzeichnisbaum mit dem
; ausgewählten Datum im Pfad abgelegt werden.
; Beispiel: \pclconversion\Musterfirma GmbH\2002\07\30
; Die Angabe des Datumsbestandteils bewirkt eine Begrenzung der Anzahl der Dateien
; in den Zielverzeichnissen. Dadurch ist zum einen die Anzeige im
; Windows Explorer problemlos möglich. Zum anderen ermöglicht diese Angabe eine
; zeitliche Strukturierung der archivierten Dokumente - maximal kann ein Feld mit
; Datum angegeben werden.
AppendToRootFolder=f_kunde,f_datum
TPTFile=lieferschein.tpt
Abbildungsverzeichnis
Abbildungsverzeichnis
Abbildung 1: windream PCL COLD 4
Abbildung 2: windream PCL COLD - Ermittlung der Indexinformationen mit
PCLTool SDK 11
31
Tabellenverzeichnis
33
Tabellenverzeichnis
Tabelle 1: Installierte Dateien im Ordner "bin" 14
Tabelle 2: Zusätzliche Verzeichnisse (Eintrag AddFolder) im windream Zielverzeichnis
26
Index
35
Index
#
#codeperpage 16
[
[Common] 22
[Fields] 18
[JobParams] 15
[Objekttypname1] 27
[PageJob] 19
[PCLCONV] 24
[windream] 24
Erstellung der Beschreibungsdateien
10
ExtractAllText 17
Extraktion der Indexinformationen 10
F
Freischaltung der Software PCLTool
SDK 10
FulltextFileExtension 23
G
Grundlagen 3
A
I
AddFolder 26
AddOTToRootFolder 23
AddTimeStampToFileName 24
Analyse und Aufbereitung der
Eingangsdaten 4
AppendToRootFolder 27
AuxDir 16
IdxFileExtension 22
Import der Daten in windream 5
Indexinformationen ermitteln 10
InputDir 16
InputDirectory 22
InputFileExtension 24
Installation
Voraussetzungen 7
Installationsreihenfolge 6
Installieren
windream PCL COLD 9
B
Beispiel
für eine Beschreibungsdatei 19
für eine Konfigurationsdatei 28
Beschreibungsdateien 10, 11, 15
Beispiel 19
Erstellen 10
Parameter 15
Testen 11
bin 14
BinaryFileExtension 22
K
KeyCode 17
Konfiguration der Anwendung 6
Konfigurationsdatei 12, 22
Beispiel 28
Parameter 22
Konvertierung der Eingangsdaten 5
C
L
CharsFromFileName 25
Conversion 17
ConvertFileName 23
LandRotate 17
D
MultiPage 16
Multistrip 17
M
DeleteInputFiles 23
E
Einleitung 1
N
NoProgBar 17
36
Index
O
Objecttypename 25
OutFileName 16
OutputPath 16
P
Parameter der Konfigurationsdatei 22
PCLPath 24
PCLTool SDK 3
PCLTool SDK freischalten 10
PCLToXMLToWindream 3
Installieren 9
PCLToXMLToWindream.ini 12, 22
PdfImageType 17
R
RootFolder 26
S
Sektion [Common] 22
Sektion [Fields] 18
Sektion [JobParams] 15
Sektion [Objekttypname1] 27
Sektion [PCLCONV] 24
Sektion [windream] 24
Systemvoraussetzungen 7
T
tpt-Dateien 10, 15
TPTFile 28
V
Verarbeitungsablauf 13
Voraussetzungen
Installation
PCLToXMLToWindream 7
W
windream PCL COLD
Installieren 9