TextKonverter

Skriptsteuerung des TextKonverters

Alle Aktionen und Funktionen zur Bearbeitung und Konvertierung von Textdateien, die über die grafische Benutzeroberfläche des TextKonverters angewendet werden können, können auch über die Kommandozeile gesteuert werden. Damit ist es unter anderem möglich, den TextKonverter über Skripte zu steuern und Aufgaben der Textkonvertierung zu automatisieren.

In diesem Tutorial zeigen wir Ihnen, wie Sie den TextKonverter über Parameter steuern können und welche Parameter Ihnen zur Konvertierung von Dateien und Ordnerinhalten zur Verfügung stehen. Darüber hinaus können Sie auch das Tutorial zur Skriptsteuerung des TextEncoders für den TextKonverter verwenden. Das TextEncoder-Tutorial legt einen größeren Fokus auf das Einlesen und die Änderung von Kodierung und Zeilenumbruchtyp von Textdateien, während dieses Tutorial mehr auf die Anwendung von Aktionen zur Änderung des Inhaltes der Dateien abzielt. Alle im TextEncoder-Tutorial vorgestellten Parameter können genauso auch mit dem TextKonverter verwendet werden. Sie benötigen für die hier vorgestellten Funktionen den TextKonverter in der Version TextKonverter Pro CL.

Das Tutorial ist in die folgenden Abschnitte eingeteilt:

Allgemeine Grundlagen der Skriptsteuerung des TextKonverters

Um den TextKonverter in den Batch-Modus zu versetzen, verwenden wir den Parameter -cl. Dieser Parameter wird bei allen folgenden Beispielen immer als erstes übergeben. Geben wir diesen Parameter nicht an, startet der TextKonverter mit grafischer Benutzeroberfläche und es findet keine Konvertierung der übergebenen Dateien statt. Stattdessen werden Dateien, die als Parameter übergeben wurden, nach dem Start des Programms in der Dateiliste angezeigt. In gleicher Weise verhält es sich mit übergebenen Ordnern, deren Inhalte in die Dateiliste des TextKonverters geladen werden. Natürlich kann auch diese Funktion nützlich sein, falls Sie den TextKonverter mit bestimmten Dateien aufrufen möchten.

Grundsätzlich haben wir 3 verschiedene Möglichkeiten, dem TextKonverter mitzuteilen, welche Konvertierungen durchgeführt werden sollen: Wir können als Parameter einzelne Aktionen übergeben, wir können Aktionslisten in Form von Dateien übergeben, die mehrere Aktionen enthalten oder wir übergeben Einstellungsdateien, die neben den Aktionen auch noch andere Einstellungen wie zum Beispiel Speichereinstellungen enthalten können. Zusätzlich stehen uns einige Parameter für die Speicheroptionen, die Kodierung, den Zeilenumbruchtyp und für das Durchsuchen von übergebenen Ordnern zur Verfügung.

Schauen wir uns zunächst einige einfache Beispiele an, bevor wir danach in den folgenden Abschnitten ins Detail gehen. Das einfachste Beispiel ist, den TextKonverter eine einzelne Aktion ausführen zu lassen. Diese können wir mit dem Parameter "a=Aktion" übergeben:

TextKonverter.exe -cl C:\test.txt "a=REPLACE a b"

Dies ersetzt in der Datei "test.txt" den Buchstaben "a" durch "b". Wenn wir mehrere Aktionen anwenden möchten, können wir diese mit der Hilfe der Parameter a1, a2, a3 und so weiter hintereinander schreiben:

TextKonverter.exe -cl C:\test.txt "a1=DELETE a" "a2=DELETE b"

Dies löscht in der Datei "test.txt" alle Vorkommnisse von "a" und "b". Mehr dazu erfahren Sie in dem Abschnitt über die Anwendung von einzelnen Aktionen.

Wenn Sie mehrere Aktionen anwenden möchten, müssen Sie diese nicht zwingend hintereinander schreiben. Stattdessen können Sie mehrere Aktionen auch in einer Aktionsliste zusammenfassen (Textdatei mit einer Aktion pro Zeile) und lediglich diese Aktionsliste übergeben:

TextKonverter.exe -cl C:\test.txt al=C:\aktionsliste.tcal

Mehrere Aktionslisten können mit den Parametern al1, al2, al3 und so weiter übergeben werden und werden dann der Reihe nach vom TextKonverter abgearbeitet. Mehr über Aktionslisten erfahren Sie in dem Abschnitt über die Anwendung von Aktionslisten.

Die dritte Möglichkeit besteht darin, Einstellungsdateien zu übergeben. Einstellungsdateien sind die Dateien, in denen der TextKonverter seine Einstellungen speichert. Diese Dateien haben immer die Dateiendung TCS (Text Converter Settings) und können folgendermaßen übergeben werden:

TextKonverter.exe -cl C:\test.txt C:\einstellungen.tcs

Dies konvertiert die Datei "test.txt" gemäß der Einstellungen, die in der Einstellungsdatei "einstellungen.tcs" gespeichert sind. Mehr zur Erstellung und Anwendung von Einstellungsdateien erfahren Sie in dem Abschnitt über die Anwendung von Einstellungsdateien.

In all unseren bisherigen Beispielen haben wir keinen bewussten Einfluss auf den Speicherort der konvertierten Datei genommen (es sei denn in der Einstellungsdatei sind entsprechende Einstellungen vorhanden). Fehlt die Angabe zu einem abweichenden Speicherort, wird die Originaldatei überschrieben. Möchten wir die bearbeitete Datei an einen anderen Ort als die Originaldatei speichern, stehen uns dafür einige Parameter zur Verfügung, zum Beispiel:

TextKonverter.exe -cl C:\test.txt "a=WRITE LOWERCASE" save=C:\lowercase.txt
TextKonverter.exe -cl C:\test.txt "a=WRITE UPPERCASE" save-folder=C:\uppercase

Beide Zeilen ändern die Schreibweise des Textes in der Datei "test.txt". Die erste Zeile wandelt alle Buchstaben der Datei in Kleinbuchstaben um und speichert das Ergebnis als neue Datei in der Datei C:\lowercase.txt. In der zweiten Zeile wird statt einem vollständigen Dateipfad nur ein Ordner für die Speicherung angegeben. Das führt dazu, dass der Name der Datei beibehalten wird und das Ergebnis (alle Buchstaben groß) in diesem Fall als neue Datei unter C:\uppercase\test.txt gespeichert wird. Mehr über die Speicheroptionen erfahren Sie in dem Abschnitt über die Parameter für die Speicherung.

Neben den Parametern für die Speicherung gibt es auch einige Parameter für die Kodierung und den Zeilenumbruchtyp, die für das Einlesen und Speichern der Dateien verwendet werden. Ein Beispiel sehen Sie hier:

TextKonverter.exe -cl C:\test.txt "a=SWAP_LINES 1 2" save=C:\swapped.txt enc=utf8 bom=0 lb=crlf

In diesem Beispiel bearbeiten wir wieder die Datei "test.txt". Dieses Mal tauschen wir die erste und zweite Zeile und speichern das Ergebnis in der Datei C:\swapped.txt mit der Kodierung UTF-8 und dem Zeilenumbruchtyp CRLF (Windows) ab. Zusätzlich geben wir mit "bom=0" an, dass keine Byte Order Mark in die Datei geschrieben werden soll. Lassen wir die Parameter für die Kodierung und den Zeilenumbruchtyp weg, wird versucht, die Kodierung und den Zeilenumbruchtyp der Originaldatei zu ermitteln und wieder für die Speicherung zu verwenden. Mehr zu diesem Thema erfahren Sie in dem Abschnitt über die Parameter für die Kodierung und den Zeilenumbruchtyp. Dort erfahren Sie auch, wie Sie den TextKonverter dazu zwingen können, Dateien mit einem bestimmten Zeilenumbruchtyp oder einer bestimmten Kodierung einzulesen. Darüber hinaus finden Sie in der Übersicht über die unterstützten Formate des TextKonverters eine Liste aller vom TextKonverter unterstützten Kodierungen und Zeilenumbruchtypen.

Natürlich können alle bisher vorgestellten Parameter auch beliebig miteinander kombiniert werden. In welcher Reihenfolge die Parameter und Aktionen abgearbeitet und ausgeführt werden, auch falls mehrere konkurrierende Einstellungen übergeben werden, erfahren Sie in dem Abschnitt über die kombinierte Anwendung von Aktionen, Aktionslisten, Einstellungsdateien und Parametern.

Bislang haben wir immer nur eine Datei gleichzeitig bearbeitet. Es ist aber auch möglich, mehrere Dateien auf einmal zu bearbeiten. Zum Beispiel indem Sie mehrere Dateien oder gleich einen ganzen Ordner übergeben:

TextKonverter.exe -cl C:\test1.xml C:\test2.xml "a=DELETE_ATTRIBUTES ALL"
TextKonverter.exe -cl C:\ordner filter-ext=csv "a=CALC_IN_CELLS ALL ADD 1"

Mit der ersten Zeile löschen wir alle Attribute aus den XML-Dateien "test1.xml" und "test2.xml". Die zweite Zeile bearbeitet alle CSV-Dateien im Ordner "C:\ordner" und addiert in jeder Zelle der CSV-Tabelle den Wert 1. Mehr zu diesem Thema und weitere Filteroptionen für Ordner erfahren Sie in den Abschnitten über die Bearbeitung von einzelnen oder mehreren Dateien und die Bearbeitung von Ordnerinhalten.

Einzelne Aktionen anwenden

Wenn Sie nur eine oder wenige Änderungen an Dateien durchführen möchten, können Sie einzelne Aktionen direkt über Parameter übergeben ohne dafür extra eine Aktionsliste oder eine Einstellungsdatei erstellen zu müssen. Ein Beispiel dafür sehen Sie hier:

TextKonverter.exe -cl C:\test.txt "a=REPLACE a b"

Mit diesem Aufruf ersetzen wir in der Datei "test.txt" den Buchstaben "a" durch "b". Zunächst versetzen wir den TextKonverter mit "-cl" in den Batch-Modus. Anschließend übergeben wir die Datei, die wir bearbeiten möchten. Mit dem Parameter "a" können wir eine Aktion (in diesem Fall "REPLACE a b") definieren, die der TextKonverter dann ausführt.

Wenn wir den TextKonverter mehrere Aktionen ausführen lassen möchten, können wir dafür a1, a2, a3 und so weiter verwenden. Hier ist ein Beispiel:

TextKonverter.exe -cl C:\ordner "a1=REWRITE REMOVE_DOUBLE_SPACES" "a2=DELETE_LINES 1-5"

Mit diesem Aufruf bearbeiten wir alle Dateien aus dem Ordner "C:\ordner". Als erstes entfernen wir alle doppelten Leerzeichen, anschließend entfernen wir die ersten fünf Zeilen aus jeder Datei. Mehrere Aktionen werden immer in der Reihenfolge der Parameter ausgeführt. Selbst wenn Sie "a2" vor "a1" übergeben, wird immer zuerst der erste Parameter (hier also "a2") ausgeführt.

Wenn Sie nicht wissen, welche Aktionen verfügbar sind und wie die Syntax der Aktionen aussieht, können Sie zum Beispiel den TextKonverter starten und Ihre gewünschten Aktionen im Bereich "Aktionslisten > Neue Aktion" geführt über die grafische Benutzeroberfläche erstellen. Wenn Sie von der Listenansicht in die Textansicht der Aktionsliste wechseln, sehen Sie die Syntax und können die Aktion direkt kopieren und weiterverwenden. Weitere Informationen finden Sie auch in der Einführung in die Verwendung von Aktionslisten im TextKonverter.

Aktionslisten anwenden

Aktionslisten sind Textdateien, die eine oder mehrere Aktionen enthalten können. Damit bieten Aktionslisten die Möglichkeit, mehrere Aktionen zusammenzufassen und gebündelt anzuwenden. Jede Aktion steht innerhalb der Aktionsliste in einer neuen Zeile. Also zum Beispiel:

REPLACE Hallo "Guten Tag"
DELETE_IN_LINES 10-20 [0-9] -r
SORT_LINES 4-7 DOWN
WRITE UPPERCASE_WORDS

Diese Aktionsliste ersetzt zunächst "Hallo" durch "Guten Tag". Anschließend werden alle Zahlen aus den Zeilen 10 bis 20 mit der Hilfe eines regulären Ausdrucks (-r) gelöscht, danach die Zeilen 4 bis 7 absteigend sortiert und zuletzt der erste Buchstabe aller Wörter des gesamten Textes groß geschrieben.

Wenn wir diesen Text beziehungsweise diese Aktionsliste zum Beispiel unter dem Namen "C:\aktionsliste.tcal" (die Dateiendung TCAL steht für "Text Converter Action List") speichern, können wir sie folgendermaßen verwenden:

TextKonverter.exe -cl C:\test.txt al=C:\aktionsliste.tcal

Zunächst versetzen wir mit diesem Aufruf den TextKonverter mit dem Parameter "-cl" in den Batch-Modus. Wir übergeben die Datei "test.txt" und verwenden den Parameter "al=" um unsere Aktionsliste zu übergeben. Dies führt dazu, dass der TextKonverter alle Aktionen aus unserer Aktionsliste "aktionsliste.tcal" auf die Datei "test.txt" anwendet. Da wir keine Angaben zu einem abweichenden Speicherort gemacht haben, wird die Originaldatei "test.txt" mit der geänderten Datei überschrieben.

Es können auch mehrere Aktionslisten gleichzeitig übergeben und angewendet werden:

TextKonverter.exe -cl C:\test.txt al1=C:\aktionsliste1.tcal al2=C:\aktionsliste2.tcal

Mit den Parametern al1, al2, al3 und so weiter können mehrere Aktionslisten-Dateien hintereinander übergeben werden. Unabhängig davon, ob Sie al1, al2, al oder al10 als ersten Parameter verwenden, wird der TextKonverter immer als erstes die als erstes übergebene Aktionsliste abarbeiten. Wenn diese Aktionsliste fertig abgearbeitet ist, wird die nächste übergebene Aktionsliste abgearbeitet und so weiter.

Wenn Sie Ihre Aktionslisten nicht händisch erstellen möchten, können Sie dafür auch die grafische Benutzeroberfläche des TextKonverters verwenden. Im allen Bereichen mit dem Namen "Aktionslisten" finden Sie den Button "Neue Aktionsliste". Wenn Sie auf diesen Button klicken, gelangen Sie zu einem Editor, mit dem Sie bequem Aktionen erstellen und zu Ihrer Aktionsliste hinzufügen können. Das Ergebnis können Sie wahlweise aus dem Editor herauskopieren und abspeichern oder Sie überlassen die Verwaltung und Speicherung der Aktionslisten dem TextKonverter. Die im TextKonverter abgespeicherten Aktionslisten finden Sie im Ordner "actionlists" im Programmordner.

Einstellungsdateien anwenden

Neben der Übergabe von einzelnen Aktionen oder Aktionslisten als Parameter, können auch Einstellungsdateien für die Konvertierung von Dateien über die Skriptsteuerung verwendet werden. Einstellungsdateien haben immer die Dateiendung TCS (Text Converter Settings) und können alle Einstellungen des TextKonverters enthalten. Sie können also nicht nur einzelne Aktionen wie die Aktionslisten enthalten sondern zum Beispiel auch Speicheroptionen. Mehr über Einstellungsdateien erfahren Sie in dem Artikel über das Laden und Speichern von Einstellungen.

Einstellungsdateien können bequem über die grafische Benutzeroberfläche des TextKonverters erstellt werden. Stellen Sie dafür zunächst alle Aktionen, Optionen und Speicheroptionen im TextKonverter so ein, als würden Sie Dateien über die grafische Benutzeroberfläche konvertieren wollen. Anschließend gehen Sie in das Menü "Einstellungen > Einstellung speichern und laden" und klicken Sie auf den Button "Als Datei speichern". Sie erhalten eine Datei, die alle aktuellen Einstellungen des TextKonverters enthält. Diese Datei können Sie direkt dem TextKonverter übergeben:

TextKonverter.exe -cl C:\test.txt C:\einstellungen.tcs

In diesem Beispiel wird die Datei "test.txt" gemäß der Einstellungen konvertiert, die Sie in der Datei "einstellungen.tcs" abgespeichert haben. Dies können Aktionen genauso wie Speicheroptionen oder Konvertierungen der Kodierung oder des Zeilenumbruchtyps sein.

Wenn Sie mehrere Einstellungsdateien als Parameter übergeben, werden diese der Reihe nach geladen und überschreiben immer die bereits geladenen Einstellungen aus den anderen Einstellungsdateien. Wenn Sie in den Parametern Einstellungsdateien mit Aktionen, Aktionslisten oder anderen Parametern vermischen, werden immer als erstes die Einstellungsdateien geladen und gegebenenfalls von den Parametern überschrieben (mehr dazu hier).

Wenn Sie Einstellungsdateien mit dem TextKonverter abspeichern, enthalten diese Dateien zunächst viel mehr Informationen, als wir für unsere Skriptsteuerung benötigen. Zum Beispiel können die Einstellungsdateien unter anderem auch Angaben über die Fenstergröße, die Fensterposition oder die Spalten Ihrer Dateiliste enthalten. Diese Informationen nutzt der TextKonverter beim Laden der grafischen Benutzeroberfläche. Falls der TextKonverter im Batch-Modus gestartet wird, werden diese unbenötigten Informationen einfach ignoriert. Es ist also nicht notwendig, die Einstellungsdateien manuell "aufzuräumen", sie können einfach so verwendet werden, wie sie vom TextKonverter abgespeichert wurden.

Dennoch kann es Situationen geben, in denen es sinnvoll ist, die Einstellungsdateien manuell anzupassen. Sie können die Einstellungsdateien dafür mit einem beliebigen Texteditor öffnen und editieren. Zum Beispiel um eine Einstellungsdatei zu erstellen, die nur bestimmte Aktionen oder nur die Speicheroptionen enthält. Diese "Teil"-Einstellungsdateien können Sie dann als Parameter mit anderen Einstellungsdateien oder Parametern kombinieren, was in bestimmten Situationen effektiver ist, als für jede Kombination von Einstellungen eine eigene Einstellungsdatei zu erstellen.

Parameter für den Speicherort und den Dateinamen

Wenn wir dem TextKonverter nicht explizit mitteilen, wo und unter welchem Namen konvertierte Dateien abgespeichert werden sollen, wird standardmäßig die Originaldatei überschrieben. Ein Beispiel dafür wäre folgender Aufruf:

TextKonverter.exe -cl C:\test.txt "a=MOVE_LINES 1 -1"

Mit diesem Aufruf wird der TextKonverter als erstes die Datei "C:\test.txt" lesen, danach die erste Zeile der Datei an das Ende der Datei verschieben und das Ergebnis anschließend wieder unter "C:\test.txt" speichern und damit die Originaldatei überschreiben, da wir keinen abweichenden Speicherort angegeben haben.

Für den Fall, dass wir die Originaldatei nicht überschreiben möchten, stehen uns die Parameter save, save-folder, save-name und save-ext zur Verfügung. Im folgenden schauen wir uns Beispiele für jeden dieser Parameter an.

TextKonverter.exe -cl C:\test.txt "a=REPLACE a b" save=C:\ordner\neu.dat

Mit dem Parameter "save" kann ein ganzer Pfad für die Speicherung angegeben werden. In diesem Beispiel wird also zunächst die Datei "C:\test.txt" ausgelesen, danach wird der Buchstabe "a" durch "b" ersetzt und anschließend wird das Ergebnis in der Datei "C:\ordner\neu.dat" gespeichert. Die Originaldatei bleibt uns erhalten.

Dasselbe Ergebnis könnten wir auch durch die Verwendung der Parameter save-folder, save-name und save-ext erreichen:

TextKonverter.exe -cl C:\test.txt "a=REPLACE a b" save-folder=C:\ordner save-name=neu save-ext=dat

Das Ergebnis dieses Aufrufs wäre identisch zu dem Beispiel davor. Wieder wird das Ergebnis der Konvertierung in der Datei "C:\ordner\neu.dat" gespeichert. Während "save" einen ganzen Pfad erwartet, können wir mit den 3 Parametern save-folder, save-name und save-ext alle Bestandteile des Pfades einzeln setzen. Die Verwendung der 3 einzelnen Parametern ist vor allem dann sinnvoll, wenn wir nicht jeden dieser Parameter setzen. Zum Beispiel:

TextKonverter.exe -cl C:\test.txt "a=REPLACE a b" save-folder=C:\neu

In diesem Beispiel haben wir nur den Parameter "save-folder" gesetzt. Da der TextKonverter als Default-Wert immer den bisherigen Namen verwendet, führt dieser Aufruf dazu, dass der Name und die Dateiendung von der Originaldatei übernommen werden. Die konvertierte Datei wird also unter dem Namen "C:\neu\test.txt" gespeichert. Nützlich kann dieser Parameter vor allem dann sein, wenn wir mehrere Dateien oder alle Dateien aus einem Ordner konvertieren möchten und die Ergebnisse in einem neuen Ordner abspeichern möchten.

TextKonverter.exe -cl C:\test.txt "a=REPLACE a b" save-name=neu
TextKonverter.exe -cl C:\test.txt "a=REPLACE a b" save-ext=dat
TextKonverter.exe -cl C:\test.txt "a=REPLACE a b" save-folder=C:\neu save-ext=dat

Analog zu dem letzten Beispiel sieht das Ergebnis dieser 3 Aufrufe aus. Die erste Zeile ändert nur den Namen der Datei, gespeichert wird also unter Beibehaltung von Ordner und Dateiendung als "C:\neu.txt". Die zweite Zeile führt zu der Datei "C:\test.dat" und in der dritten Zeile ändern wir Ordner und Dateiendung während der Name der Datei von der ursprünglichen Datei übernommen wird, das Ergebnis wäre also "C:\neu\test.dat".

Neben der Verwendung dieser Parameter haben wir noch eine weitere Möglichkeit, Einfluss auf den Speicherort und den Dateinamen der konvertierten Datei zu nehmen. Diese besteht darin, Einstellungsdateien zu verwenden. Das Prinzip ist allerdings trotzdem dasselbe, da innerhalb der Einstellungsdateien auch die genannten Parameter enthalten sind. Der einzige Unterschied besteht darin, dass die Parameter nicht einzeln angegeben werden müssen sondern nur der Pfad zur betreffenden Einstellungsdatei als Parameter übergeben wird. Wie Sie Einstellungsdateien erstellen und verwenden können, erfahren Sie im Abschnitt zu Einstellungsdateien.

Parameter für die Kodierung und den Zeilenumbruchtyp

Weitere Parameter stehen uns zur Verfügung um die Kodierung und den Zeilenumbruchtyp für das Lesen und Schreiben der Dateien zu steuern. Für das Lesen sind dies die Parameter lb-read (linebreak read) und enc-read (encoding read), für das Schreiben können wir die Parameter lb (linebreak), enc (encoding) und bom (byte order mark) verwenden. Wenn wir dem TextKonverter keine Anweisungen geben, wird beim Lesen versucht, den Zeilenumbruchtyp und die Kodierung der Originaldatei automatisch zu erkennen und beim Schreiben wird der ermittelte Zeilenumbruchtyp und die Kodierung der Originaldatei übernommen.

Schauen wir uns drei Beispiele an, die diese Vorgehensweise verdeutlichen:

TextKonverter.exe -cl C:\test.txt enc=utf16le bom=1

Dieser Aufruf ändert die Kodierung der Datei "test.txt" nach UTF-16 Little Endian (utf16le), unabhängig davon, welche Kodierung die Datei vorher hatte. Der Zusatz "bom=1" sorgt dafür, dass eine Byte Order Mark in die Datei geschrieben wird. Da wir weder Parameter zum Zeilenumbruchtyp noch zu einem abweichenden Speicherort für die neue Datei spezifiziert haben, wird der Zeilenumbruchtyp der Originaldatei übernommen und die Originaldatei überschrieben. Da wir auch nicht angegeben haben, mit welcher Kodierung die Originaldatei gelesen werden soll, wird versucht, die Kodierung für das Lesen automatisch zu ermitteln.

TextKonverter.exe -cl C:\test.txt enc-read=win-1251 enc=utf8 bom=0 lb=crlf save=C:\neu.txt

In diesem Aufruf geben wir an, dass die Originaldatei die Windows Codepage 1251 (Kyrillisch) hat und der TextKonverter damit die Bytes der Originaldatei im Sinne dieser Codepage interpretieren soll. Dies ist für diese Kodierung wichtig, insbesondere wenn der Aufruf auf einem anderssprachigen Windows-System erfolgt, da sich die ANSI-Codepages allein aufgrund der Bytes nicht unterscheiden lassen und Interpretationssache sind. Nachdem die Datei gelesen wurde, ändert der TextKonverter die Kodierung der Datei in UTF-8 ohne Byte Order Mark und forciert den Zeilenumbruchtyp CR LF (Windows), unabhängig davon welcher Zeilenumbruchtyp in der Originaldatei verwendet wurde. Die konvertierte Datei wird unter "C:\neu.txt" gespeichert, die Originaldatei bleibt erhalten.

TextKonverter.exe -cl C:\test.txt a="INSERT test 10" lb-read=fixedlength-20 lb=system

In den ersten beiden Beispielen haben wir nur die Kodierung und den Zeilenumbruchtyp der Originaldatei geändert, ohne deren Inhalt zu verändern. In diesem Aufruf führen wir zusätzlich auch eine Aktion durch, die den Dateiinhalt ändert: Wir möchten das Wort "test" an Zeichenposition 10 in der Datei einfügen. Ansonsten möchten wir nur den Zeilenumbruchtyp von einer festen Zeilenlänge von 20 Zeichen auf den System-Zeilenumbruchtyp switchen, die Kodierung der Originaldatei soll erhalten bleiben. Der System-Zeilenumbruchtyp entspricht dem Standard-Zeilenumbruchtyp des Systems, auf dem der TextKonverter gerade ausgeführt wird (also zum Beispiel CR LF für Windows-Systeme).

Die Parameter für Aktionen, Aktionslisten oder Einstellungsdateien können an beliebiger Stelle stehen. In unserem Beispiel haben wir erst die Aktion definiert, dann "lb-read" und dann "lb". Wir könnten aber genauso auch jede andere beliebige Reihenfolge verwenden um das gleiche Ergebnis zu erhalten.

Welche Werte Sie für die verschiedenen Kodierungen und Zeilenumbruchtypen verwenden können, sehen Sie in der Übersicht über alle verfügbaren Parameter. Weitere Beispiele finden Sie im Tutorial für den TextEncoder. Alle dort erläuterten Parameter und Parameterwerte für den TextEncoder können genauso auch mit dem TextKonverter verwendet werden. Insbesondere die Abschnitte über benutzerdefinierte Zeichen für Zeilenumbrüche, Zeilenumbrüche an mehreren Zeichen und die Konvertierung von Dateien mit fixer Zeilenlänge gehen über die hier erklärten Beispiele hinaus.

Genauso wie bei den Parametern für den Speicherort und den Dateinamen können auch die Parameter für die Kodierung und den Zeilenumbruchtyp alternativ über Einstellungsdateien übergeben werden. Die Vorgehensweise ist wie folgt: Kodierung und Zeilenumbruchtyp werden über die grafische Benutzeroberfläche des TextKonverters konfiguriert, diese Einstellungen werden in einer Einstellungsdatei gespeichert und diese Einstellungsdatei wird dann dem TextKonverter statt der Parameter übergeben. Damit dies funktioniert, müssen die Aktionen "Kodierung" und/oder "Zeilenumbruchtyp" aktiv sein. Es reicht also nicht aus, in der grafischen Benutzeroberfläche nur die Werte unter "Einlesen als" und "Speichern als" zu ändern, es müssen auch die Haken bei "Kodierung" und/oder "Zeilenumbruchtyp" gesetzt sein. Ist dies nicht der Fall, werden die die Default-Werte "auto" für das Lesen und "keep" für das Schreiben verwendet. Wenn eine Einstellungsdatei übergeben wird, die Anweisungen für die Kodierung und/oder den Zeilenumbruchtyp enthält, und zusätzlich Parameter wie "enc" oder "lb" übergeben werden, überschreiben die Parameter die Werte aus der Einstellungsdatei. Mehr zur Erstellung und Verwendung von Einstellungsdateien erfahren Sie in dem Abschnitt über Einstellungsdateien.

Parameter für das Dateidatum

Bei der Konvertierung von Dateien mit dem TextKonverter können wir die Originaldateien entweder mit den konvertierten Dateien überschreiben oder die konvertierten Dateien als neue Dateien abspeichern, indem wir einen von der Originaldatei abweichenden Speicherort oder Namen angeben.

Wenn das Ergebnis der Konvertierung als gänzlich neue Datei abgespeichert wird, trägt diese Datei nach der Speicherung automatisch den Zeitstempel, an dem die Konvertierung stattgefunden hat. Dies betrifft sowohl das Erstellungsdatum als auch das Datum der letzten Änderung der Datei. Falls wir die Originaldatei überschreiben, bleibt zwar das Erstellungsdatum des Originals unverändert, jedoch ändert sich das Änderungsdatum der Datei auf den Zeitpunkt der Konvertierung.

Falls Sie diese automatische Änderung des Dateidatums nicht wünschen, können wir den Parameter "date=keep" übergeben:

TextKonverter.exe -cl C:\test1.txt "a=REPLACE a b" save=C:\test1.txt date=keep
TextKonverter.exe -cl C:\test2.txt "a=REPLACE c d" save=C:\neu.txt date=keep

Der Parameter "date=keep" bewirkt, dass das Datum der Originaldatei für die konvertierte Datei übernommen wird. Dies betrifft sowohl das Erstellungsdatum als auch das Änderungsdatum sowie das Datum des letzten Zugriffs und lässt sich sowohl für Überschreibungen als auch für die Speicherung von konvertierten Dateien als neue Datei anwenden, wie das Beispiel zeigt.

Dieser Parameter entspricht der Option "Datum der Originaldatei übernehmen" aus den Speicheroptionen der grafischen Benutzeroberfläche des TextKonverters. Entsprechend lässt sich die Option auch anwenden, in dem eine Einstellungsdatei übergeben wird, die die entsprechenden Einstellungen enthält.

Parameter für die Aktivierung von Platzhaltern und Referenzen

Standardmäßig ist die Ersetzung von Platzhaltern und Referenzen im TextKonverter deaktiviert. Wenn Sie Platzhalter oder Referenzen innerhalb der Skriptsteuerung nutzen möchten, müssen Sie daher die entsprechenden Optionen aktivieren, da die betreffenden Platzhalter ansonsten nicht ersetzt werden. Für deren Aktivierung haben Sie mehrere Möglichkeiten.

Wenn Sie Einstellungsdateien verwenden, können Sie eine oder beide der Optionen über die grafische Benutzeroberfläche des TextKonverters aktivieren, bevor Sie Ihre Einstellungsdatei speichern. Sie finden beide Optionen im Bereich "Aktionen > Optionen".

Wenn Sie keine Einstellungsdateien verwenden, zum Beispiel weil Sie mit einzelnen Aktionen oder Aktionslisten arbeiten, oder die Konfiguration aus übergebenen Einstellungsdateien überschreiben möchten, können Sie die Verwendung von Platzhaltern und Referenzen alternativ über die Parameter "ph" und "ref" steuern. Mit "ph=1" können Sie Platzhalter aktivieren, mit "ref=1" können Sie Referenzen aktivieren. Wenn Sie statt der "1" eine "0" verwenden, werden die entsprechenden Optionen deaktiviert.

Ein Beispiel für die Verwendung des Parameters "ref" ist der folgende Aufruf des TextKonverters, der in der CSV-Datei "C:\data.csv" den Inhalt des Feldes A1 (1:1) mit der Hilfe einer Referenz auf den Inhalt des Feldes B2 (2:2) setzt:

TextKonverter.exe -cl C:\data.csv "a=REPLACE_CELLS 2:2 %%ref:cell=1:1%%" ref=1

Wir verwenden die Aktion "REPLACE_CELLS Feld NeuerInhalt". Damit die darin enthaltene Zellen-Referenz %ref:cell=1:1% als solche interpretiert wird, übergeben wir den Parameter "ref=1". Im Skriptaufruf unter Windows müssen wir darüber hinaus das "%"-Zeichen verdoppeln, damit es als solches erkannt wird.

Ein Beispiel für die Verwendung des Parameters "ph" ist der folgende Aufruf des TextKonverters, der in der Datei "C:\test.txt" ein beliebiges Datum durch das aktuelle Datum ersetzt:

TextKonverter.exe -cl C:\test.txt "a=REPLACE [0-9]+-[0-9]+-[0-9]+ %%date%% -r" ph=1

Genutzt wird dafür die REPLACE-Funktion (REPLACE Suchen Ersetzen -Parameter), die als einzelne Aktion übergeben wird und mit der Hilfe des regulären Ausdrucks "[0-9]+-[0-9]+-[0-9]+" (-r) ein beliebiges Datum im Format "Zahl-Zahl-Zahl" sucht und dieses mit dem Datums-Platzhalter "%date%", der für das aktuelle Datum steht, ersetzt. Das "%"-Zeichen verdoppeln wir erneut, damit es als solches erkannt wird. Als letzten Parameter übergeben wir "ph=1" und stellen damit sicher, dass der Platzhalter auch als solcher interpretiert wird.

Auch wenn in den beiden Beispielen jeweils nur eine der beiden Optionen aktiviert wurde, können Sie natürlich auch beide Parameter innerhalb eines Aufrufs übergeben und unabhängig voneinander verwenden.

In den Parametern für den Speicherort und den Dateinamen "save", "save-folder", "save-name" sowie "save-ext" werden Platzhalter immer ersetzt. Die Aktivierung der Platzhalter-Option ist entsprechend nur notwendig, wenn Sie Platzhalter innerhalb Ihrer Aktionen verwenden. Für die Verwendung in Dateinamen ist eine Aktivierung nicht notwendig.

Kombinierte Anwendung von Aktionen, Aktionslisten, Einstellungsdateien und Parametern

Einzelne Aktionen, Dateien mit Aktionslisten, Einstellungsdateien und alle sonstigen Parameter wie die Parameter für den Speicherort, die Kodierung oder den Zeilenumbruchtyp können dem TextKonverter auch kombiniert übergeben werden. In diesem Zusammenhang stellt sich die Frage, welche Wechselwirkung die verschiedenen Parameter entfalten können und in welcher Reihenfolge der TextKonverter die einzelnen Einstellungen und Aktionen verarbeitet. Diese Frage ist insbesondere für den Fall wichtig, falls sich einzelne Einstellungen ergänzen oder sogar widersprechen.

Grundsätzlich verarbeitet der TextKonverter die übergebenen Parameter in der folgenden Reihenfolge:

Schauen wir uns noch einige Beispiele für die kombinierte Anwendung von Aktionen, Aktionslisten, Einstellungsdateien und Parametern an, die die Priorität und die Reihenfolge der Anwendung verdeutlichen:

TextKonverter.exe -cl C:\test.txt a2="DELETE a" al=C:\aktionsliste.tcal a1="DELETE b"

In diesem Beispiel wird als erstes die Aktion a2 ausgeführt, danach werden alle Aktionen aus der Aktionsliste angewendet und anschließend die Aktion a1. Der TextKonverter folgt also strikt der Reihenfolge der Parameter, unabhängig davon ob Einzelaktionen oder Aktionslisten übergeben werden und unabhängig davon welche Parameternummer Sie den Aktionen und Aktionslisten geben.

TextKonverter.exe -cl C:\test.txt a="DELETE a" C:\einstellungen.tcs al=C:\aktionsliste.tcal

In diesem Beispiel kommt eine Einstellungsdatei hinzu. Einstellungsdateien werden immer zuerst abgearbeitet, unabhängig davon, an welcher Position sie in den Parametern definiert sind. Es wird also als erstes die Einstellungsdatei angewendet, dann die Einzelaktion, dann die Aktionsliste.

TextKonverter.exe -cl C:\test.txt save-folder=C:\neu save-ext=dat C:\einstellungen.tcs

In diesem Beispiel wird wieder zuerst die Einstellungsdatei geladen. Anschließend überschreiben die Parameter save-folder und save-ext mögliche Speicheroptionen aus der Einstellungsdatei. Unabhängig davon, welche Speicheroptionen in der Einstellungsdatei definiert sind, wird also im Ordner "C:\neu" mit der Dateiendung "dat" gespeichert. Da wir keinen Parameter für den Namen der Datei angegeben haben, wird diese Einstellung auch nicht überschrieben und es wird für die Speicherung der Name verwendet, der in der Einstellungsdatei konfiguriert wurde (wenn in der Einstellungsdatei keine Einstellungen zum Namen vorhanden sind, wird der Name der Originaldatei verwendet). Die Reihenfolge der Parameter spielt in diesem Fall keine Rolle, wir bekommen das gleiche Ergebnis, unabhängig davon in welcher Reihenfolge wir die gegebenen Parameter anordnen.

Einzelne und mehrere Dateien bearbeiten

Um eine einzelne Datei mit dem TextKonverter über die Kommandozeile zu bearbeiten, können Sie einfach den Pfad zu der Datei übergeben, so wie wir es auch schon in vielen Beispielen in diesem Tutorial gesehen haben:

TextKonverter.exe -cl C:\test.txt "a=REPLACE a b"

Mit diesem Aufruf ersetzen wir in der Datei "test.txt" den Buchstaben "a" durch "b". Die Originaldatei wird in diesem Fall überschrieben, da wir keine abweichenden Anweisungen zur Speicherung geben.

Wenn wir die Originaldatei nicht überschreiben möchten, können wir über die Parameter "save" einen abweichenden Pfad für die Speicherung angeben:

TextKonverter.exe -cl C:\test.txt "a=REPLACE a b" save=C:\neu.txt

Mit diesem Aufruf bleibt die Originaldatei "C:\test.txt" erhalten und wir speichern unser Ergebnis in der Datei "C:\neu.txt".

Wenn Sie mehrere Dateien gleichzeitig in gleicher Weise bearbeiten möchten, ist es nicht nötig, den TextKonverter mehrfach aufzurufen. Sie können auch einfach mehrere Dateipfade hintereinander übergeben:

TextKonverter.exe -cl C:\test1.txt C:\test2.txt C:\test3.txt "a=REPLACE a b"

Mit diesem Aufruf ersetzen wir den Buchstaben "a" durch "b" in den Dateien "test1.txt", "test2.txt" und "test3.txt". Auch in diesem Beispiel werden die 3 Originaldateien überschrieben. Möchten Sie die Originaldateien erhalten, können Sie einfach einen abweichenden Speicherort oder einen abweichenden Namen für die neuen Dateien über die Parameter save-folder, save-name und save-ext angeben (einen einzelnen Dateipfad für die Speicherung über den Parameter "save" zu übergeben ergibt an dieser Stelle keinen Sinn, da wir mehrere Dateien haben). Also zum Beispiel:

TextKonverter.exe -cl C:\test1.txt C:\test2.txt "a=REPLACE a b" save-folder=C:\neu

Durch diesen Aufruf bearbeiten wir die Dateien "C:\test1.txt" sowie "C:\test2.txt" und speichern das Ergebnis im Ordner "C:\neu". Da wir nur einen neuen Ordner angegeben haben und keine Aussage über den Dateinamen treffen, wird der Dateiname der Originaldatei übernommen. Das Ergebnis unserer Konvertierung wird also in den Dateien "C:\neu\test1.txt" und "C:\neu\test2.txt" gespeichert. Natürlich können wir auch den Namen oder die Dateiendung für die neue Datei ändern. Zum Beispiel:

TextKonverter.exe -cl C:\test1.txt C:\test2.txt "a=REPLACE a b" save-name=%%name%%_%%date%% save-ext=dat

In diesem Beispiel übernehmen wir nur den Ordner der Originaldateien. Den Namen und die Dateiendung ändern wir dagegen über die Parameter "save-name" und "save-ext". Als neuen Namen möchten wir dem alten Namen das aktuelle Datum anhängen. Dafür benutzen wir die beiden Platzhalter %name% für den alten Namen und %date% für das aktuelle Datum (wir müssen das Prozentzeichen im Aufruf verdoppeln, damit das Betriebssystem nicht die Variablen in seinem Sinne interpretiert). Als neue Dateiendung möchten wir die Dateiendung "dat" verwenden. Mehr zu diesem Thema erfahren Sie in dem Abschnitt über die Parameter für die Speicherung.

Wenn Sie mehrere Dateien konvertieren möchten, müssen Sie nicht zwingend den Pfad zu jeder einzelnen Datei angeben. Stattdessen können Sie auch einen oder mehrere Ordner übergeben, deren Inhalt dann konvertiert wird. Wie das funktioniert und wie Sie Filter verwenden können, um nicht alle Dateien aus übergebenenen Ordner zu konvertieren, erfahren Sie im nächsten Abschnitt.

Dateien aus Ordnern bearbeiten

Wenn Sie sehr viele Dateien bearbeiten möchten, kann es mühselig sein, jede Datei einzeln an den TextKonverter zu übergeben. Für diesen Fall können Sie auch mit Ordnern arbeiten. Um alle Dateien aus einem Ordner zu konvertieren, können wir einfach den Pfad zu dem betreffenden Ordner übergeben. Die Syntax ist dabei genauso, wie wir es auch schon bei der Übergabe von Dateien gemacht haben:

TextKonverter.exe -cl C:\ordner "a=REPLACE a b"

Mit diesem Aufruf werden alle Dateien, die sich in Ordner "C:\ordner" befinden konvertiert (der Buchstabe "a" wird in den Dateien durch den Buchstaben "b" ersetzt). Da wir keinen abweichenden Speicherort angegeben haben, werden die Originaldateien in dem Ordner überschrieben. Möchten wir die Originaldateien erhalten, können wir die Parameter für die Speicherung verwenden um Einfluss auf den Speicherort und den neuen Dateinamen zu nehmen. Zum Beispiel:

TextKonverter.exe -cl C:\ordner "a=REPLACE a b" save-folder=C:\neu

Mit diesem Aufruf werden alle Dateien aus dem Ordner "C:\ordner" konvertiert und das Ergebnis wird im Ordner "C:\neu" gespeichert. Die Originaldateien aus "C:\ordner" bleiben erhalten und nach der Konvertierung befinden sich im Ordner "C:\neu" alle konvertierten Dateien. Da wir keine abweichenden Angaben zum Dateinamen gemacht haben (zum Beispiel über den Parameter save-name) werden die Dateinamen der Originaldateien übernommen.

Es können auch mehrere Ordner gleichzeitig bearbeitet werden:

TextKonverter.exe -cl C:\ordner1 C:\ordner2 "a=REPLACE a b" save-folder=%%ordner%%\neu

Mit diesem Beispiel bearbeiten wir alle Dateien aus den Ordnern "C:\ordner1" und "C:\ordner2". Wir möchten die konvertierten Dateien nicht mischen und sie wieder in 2 verschiedenen Ordnern abspeichern. Daher arbeiten wir in dem Parameter "save-folder" für den Speicherort mit der Variablen %ordner%, die für den alten Ordner steht (wir müssen das Prozentzeichen im Aufruf verdoppeln, damit das Betriebssystem nicht die Variablen in seinem Sinne interpretiert). Dieser Aufruf führt also dazu, dass die konvertierten Dateien aus "C:\ordner1" im Ordner "C:\ordner1\neu" gespeichert werden und die konvertierten Dateien aus "C:\ordner2" im Ordner "C:\ordner2\neu". Würden wir den Parameter "save-folder" in diesem Beispiel weglassen, würden in beiden Ordnern alle Originaldateien durch die konvertierten Dateien überschrieben.

Natürlich können wir auch Dateien und Ordner gemischt übergeben:

TextKonverter.exe -cl C:\test.txt C:\ordner "a=REPLACE a b"

Durch diese Aufruf wird einerseits die Einzeldatei "C:\test.txt" konvertiert und andererseits alle Dateien aus dem Ordner "C:\ordner".

In unseren bisherigen Beispielen haben wir immer alle Dateien aus den übergebenen Ordnern bearbeitet. Wir können aber auch Filter verwenden, um nur die Dateien aus den übergebenen Ordnern zu bearbeiten, auf die der Filter passt:

TextKonverter.exe -cl C:\ordner "a=REPLACE a b" filter-ext=txt
TextKonverter.exe -cl C:\ordner "a=REPLACE a b" filter-ext=htm/html

Diese beiden Beispiele zeigen den Filter "filter-ext" für die Dateiendung. Mit der ersten Zeile bearbeiten wir aus dem Ordner "C:\ordner" nur die Dateien mit der Dateiendung "txt". Mehrere Dateiendungen können wir mit einem Schrägstrich trennen: Mit der zweiten Zeile bearbeiten wir demnach alle Dateien, die entweder die Dateiendung "htm" oder "html" haben.

TextKonverter.exe -cl C:\ordner "a=REPLACE a b" filter-name=[a-f]
TextKonverter.exe -cl C:\ordner "a=REPLACE a b" filter-name=[a-f] filter-name-regex=1
TextKonverter.exe -cl C:\ordner "a=REPLACE a b" filter-name=a/b/c filter-ext=txt

Diese 4 Beispiele zeigen den Filter "filter-name" für den Dateinamen. Mit der ersten Zeile bearbeiten wir alle Dateien, die die Zeichenkette "[a-f]" in ihrem Namen enthalten. Also zum Beispiel "[a-f].txt" oder "ab[a-f]cd.txt". In der zweiten Zeile benutzen wir reguläre Ausdrücke. Mit dem Parameter "filter-name-regex=1" teilen wir dem TextKonverter mit, dass "filter-name" als regulärer Ausdruck zu interpretieren ist (lassen wir "filter-name-regex" weg, wird standardmäßig nicht als regulärer Ausdruck interpretiert). Wir suchen also diesmal nicht die Dateien, die die Zeichenkette "[a-f]" enthalten, sondern alle Dateien, die einen der Buchstaben von a bis f enthalten. Also zum Beispiel "a.txt", "xb.txt" oder "abc.txt" aber nicht Dateien wie "gh.txt" oder "p.txt". Das dritte Beispiel kombiniert "filter-name" mit "filter-ext" und demonstriert dass wir mehrere unabhängige Suchen mit einem Schrägstrich definieren können. Wir möchten nur Dateien bearbeiten, die in ihrem Dateinamen den Buchstaben "a", "b" oder "c" enthalten und die Dateiendung "txt" haben. Also zum Beispiel "a.txt", "abc.txt" aber nicht "d.txt", "a.dat" oder "b.dat".

Weitere Filter sind "filter-name-matchcase" (Soll die Groß und Kleinschreibung bei der Filterung beachtet werden?), "filter-name-matchall" (Soll der gesamte Dateiname dem Suchbegriff entsprechen?), "filter-hiddenfiles" (Sollen auch unsichtbare Dateien eingeschlossen werden?) oder "filter-onlytextfiles" (Sollen nur Textdateien bearbeitet werden?). Erläuterungen dazu und weitere Erklärungen zu den Filtern erhalten Sie in der Liste aller verfügbaren Parameter.

Neben den Filtern für den Dateinamen und die Dateiendung kann auch der Umgang mit Unterordnern über Parameter gesteuert werden. Dazu stehen uns die Parameter "search-subdirs" und "keep-subdirs" zur Verfügung.

Mit dem Parameter "search-subdirs" können Sie bestimmen, ob bei der Bearbeitung eines Ordners nur die Dateien bearbeitet werden sollen, die direkt in dem Ordner liegen, oder auch die Dateien, die unterhalb dieses Ordners in einem Unterordner (sub dir) liegen. Wir haben 3 Möglichkeiten:

TextKonverter.exe -cl C:\ordner "a=REPLACE a b" search-subdirs=0
TextKonverter.exe -cl C:\ordner "a=REPLACE a b" search-subdirs=1
TextKonverter.exe -cl C:\ordner "a=REPLACE a b"

In jedem dieser Beispiele sollen Dateien aus dem Ordner "C:\ordner" bearbeitet werden. In der ersten Zeile geben wir mit "search-subdirs=0" an, dass keine Dateien bearbeitet werden sollen, die in einem Unterordner von "C:\ordner" liegen. Es werden also nur Dateien bearbeitet, die direkt in "C:\ordner" liegen, also zum Beispiel "C:\ordner\test.txt" nicht aber Dateien wie "C:\ordner\ordner\test.txt" oder "C:\ordner\1\2\3\test.txt". Anders ist der Effekt der zweiten Zeile. Mit "search-subdirs=1" geben wir explizit an, dass auch alle Dateien aus Unterordnern bearbeitet werden sollen. Mit diesem Aufruf würden also alle 3 genannten Dateien "C:\ordner\test.txt", "C:\ordner\ordner\test.txt" und "C:\ordner\1\2\3\test.txt" konvertiert. In der dritten Zeile lassen wir den Parameter "search-subdirs" weg. In diesem Fall wird der Default-Wert verwendet, der für "search-subdirs" "1" ist. Auch wenn wir den Parameter weglassen, werden also sowohl die Dateien direkt aus dem Ordner als auch alle Dateien aus Unterordnern bearbeitet. Die Zeilen 2 und 3 führen demnach zum selben Ergebnis.

Mit dem Parameter "keep-subdirs" können wir die Frage regeln, ob die Ordnerstruktur der Unterordner beim Speichern beibehalten werden soll oder nicht. "keep-subdirs" kann die Werte 0 oder 1 annehmen:

TextKonverter.exe -cl C:\ordner "a=REPLACE a b" save-folder=C:\neu search-subdirs=1 keep-subdirs=0
TextKonverter.exe -cl C:\ordner "a=REPLACE a b" save-folder=C:\neu search-subdirs=1 keep-subdirs=1

In diesen beiden Beispielen möchten wir die Dateien aus dem Ordner "C:\ordner" bearbeiten und in dem neuen Ordner "C:\neu" abspeichern. In beiden Zeilen haben wir mit "search-subdirs=1" angegeben, dass auch alle Dateien aus Unterordnern bearbeitet werden sollen. Jedoch haben wir einmal "keep-subdirs=0" geschrieben und einmal verwenden wir "keep-subdirs=1". In der ersten Zeile mit "keep-subdirs=0" signalisieren wir den TextKonverter, dass die Unterordner nicht beibehalten werden sollen. Es werden also alle konvertierten Dateien direkt im Ordner "C:\neu" abgespeichert, unabhängig davon, ob die Dateien direkt in "C:\ordner" oder in einem beliebigen Unterordner lagen. Anders verhält es sich in der zweiten Zeile mit "keep-subdirs=1". Hier sagen wir dem TextKonverter, dass die Unterordner-Struktur beibehalten werden soll. Demnach wird die ursprüngliche Datei "C:\ordner\test1.txt" in "C:\neu\test1.txt" gespeichert und die ursprüngliche Datei "C:\ordner\ordner\test2.txt" in "C:\neu\ordner\test2.txt". Mit "keep-subdirs=0" würden die Dateien unter "C:\neu\test1.txt" und "C:\neu\test2.txt" gespeichert. Lassen wir den Parameter "keep-subdirs" weg, entspricht dies "keep-subdirs=0" und alle Dateien würde direkt im Ausgabeordner ohne Unterordner gespeichert werden.

Anzeige von Informationen über Dateien

Neben der Konvertierung und Bearbeitung von Textdateien per Skriptsteuerung, bietet der TextKonverter auch die Möglichkeit, Dateieigenschaften von Textdateien in der Kommandozeile oder in einem Skript auszugeben. Unter anderem ist es möglich, allgemeine Dateiinformationen wie die Dateigröße oder textdateisspezifische Informationen wie die Kodierung, den Zeilenumbruchtyp oder die Anzahl von Wörtern, Zeilen oder Zeichen von Textdateien auszugeben.

Im Tutorial über die Ausgabe von Dateiinformationen und textdateispezifischen Eigenschaften über die Kommandozeile oder per Skript finden Sie Erklärungen, Beispielaufrufe und Übersichtstabellen der möglichen Parameter bezüglich dieses Themas.

Übersicht über alle verfügbaren Parameter

In der folgenden Tabelle sind alle verfügbaren Parameter gelistet, die Sie im Batch-Modus des TextKonverters verwenden können. Den Namen des Parameters finden Sie in der Spalte "Parameter". In der Spalte "Werte" sind alle Werte aufgeführt, die der jeweilige Parameter annehmen kann. Wird der Parameter beim Aufruf des TextKonverters nicht angegeben, wird der Wert aus der Spalte "Default" verwendet. Die meisten der Parameter finden sich auch in den Beispielen innerhalb dieses Tutorials wieder.

ParameterWerteDefaultBeschreibung
[Dateien]beliebige(r) Dateipfad(e)- Pfad zur Datei, die konvertiert werden soll. Es können mehrere Dateien hintereinander angegeben werden, um mehrere Dateien gleichzeitig zu konvertieren. Mehr Informationen und Beispiele im Abschnitt über die Konvertierung von Dateien.
[Ordner]beliebige(r) Ordnerpfad(e)- Pfad zu einem Ordner, dessen Inhalt konvertiert werden soll. Um nicht alle Dateien aus dem Ordner zu konvertieren, können Sie die Parameter search-subdirs, filter-ext, filter-name, filter-name-matchcase, filter-name-matchall, filter-name-regex, filter-hiddenfiles und filter-onlytextfiles verwenden, um die Suche einzugrenzen. Es können mehrere Ordner hintereinander angegeben werden, um den Inhalt mehrerer Ordner gleichzeitig zu konvertieren. Mehr Informationen und Beispiele im Abschnitt über die Konvertierung von Ordnerinhalten.
[TCS-Dateien] Einstellungsdateien mit der Dateiendung *.tcs- Pfad zu einer Einstellungsdatei mit der Dateiendung TCS (Text Converter Settings), die alle Einstellungen des TextKonverters wie Aktionen oder Speicheroptionen enthalten kann. Einstellungsdateien können mit allen anderen Parametern kombiniert und überschrieben werden. Es können mehrere Einstellungsdateien hintereinander angegeben werden, die dann hintereinander geladen werden. Mehr zur Verwendung und Erstellung von Einstellungsdateien im Abschnitt über die Anwendung von Einstellungsdateien.
a, a1, a2, a3,... einzelne Aktion -Mit den Parametern a, a1, a2, a3 und so weiter kann dem TextKonverter eine einzelne Aktion als Parameter übergeben werden, die der TextKonverter dann ausführen wird. Die Syntax ist a=Aktion, also zum Beispiel "a=REPLACE a b" oder "a1=DELETE x". Wenn Sie nur eine einzelne Aktion als Parameter übergeben möchten, können Sie "a" verwenden. Wenn Sie mehrere Aktionen als Parameter übergeben möchten, können Sie für die erste Aktion "a1" verwenden, für die zweite Aktion "a2", für die dritte Aktion "a3" und so weiter. Sie sind aber nicht an eine korrekte Nummerierung gebunden. Sie können theoretisch also auch mit "a7" starten und "a1" bis "a6" auslassen. Anwendungsbeispiele und mehr Informationen zu diesem Parameter finden Sie im Abschnitt zur Anwendung von einzelnen Aktionen.
al, al1, al2, al3,...beliebiger Dateipfad zu einer in einer Textdatei gespeicherten Aktionsliste-Mit den Parametern al, al1, al2, al3 und so weiter kann dem TextKonveter der Pfad zu einer Aktionsliste übergeben werden, die der TextKonverter dann ausführen wird. Die Syntax ist al=Pfad, also zum Beispiel "al=C:\aktionsliste.tcal" oder "al1=C:\aktionen.txt". Die übergebene Datei kann eine beliebige Textdatei sein, die eine Aktion je Zeile enthält. Die typische Dateiendung für Aktionslisten für den TextKonverter ist TCAL (Text Converter Action List). Die übergebenen Dateien können aber auch eine beliebige andere Dateiendung wie zum Beispiel TXT haben. Wenn Sie nur eine einzelne Aktionsliste als Parameter übergeben möchten, können Sie "al" verwenden. Wenn Sie mehrere Aktionslisten als Parameter übergeben möchten, können Sie für die erste Aktionsliste "al1" verwenden, für die zweite Aktionsliste "al2", für die dritte Aktionsliste "al3" und so weiter. Sie sind aber nicht an eine korrekte Nummerierung gebunden. Sie können theoretisch also auch mit "al7" starten und "al1" bis "al6" auslassen. Anwendungsbeispiele, ein Beispiel für eine Aktionsliste und mehr Informationen zu diesem Parameter finden Sie im Abschnitt zur Anwendung von Aktionslisten. In diesem Abschnitt erfahren Sie auch, wie sie Aktionslisten direkt mit dem TextKonverter über die grafische Benutzeroberfläche erstellen können.
ph1 oder 0-Aktiviert (ph=1) oder deaktiviert (ph=0) Platzhalter. Mehr über die Hintergründe und Anwendung dieses Parameters in diesem Abschnitt.
ref1 oder 0-Aktiviert (ref=1) oder deaktiviert (ref=0) Referenzen. Mehr über die Hintergründe und Anwendung dieses Parameters in diesem Abschnitt.
savePfad zu beliebiger Datei- Mit diesem Parameter können Sie die konvertierte Datei explizit unter einem frei wählbaren Dateinamen abspeichern. Geben Sie zum Beispiel save=C:\Ordner\Datei.txt an, um die konvertierte Datei als C:\Ordner\Datei.txt abzuspeichern. Wenn Sie die konvertierte Datei unter Beibehaltung des Dateinamens und der Dateiendung lediglich in einem anderen Ordner abspeichern möchten, benutzen Sie bitte den Parameter save-folder und lassen Sie den Parameter save weg. Außerdem können in gleicher Weise die Parameter save-name für den Namen und save-ext für die Dateiendung verwendet werden und miteinander kombiniert werden. Wenn Sie keinen der Parameter save, save-folder, save-name oder save-ext angeben, wird die Originaldatei überschrieben. Mehr Informationen zu diesem Parameter und Beispiele für dessen Verwendung finden Sie im Abschnitt über die Parameter für die Speicherung.
save-folderkeep oder beliebiger OrdnerkeepOrdner, in dem die konvertierte Datei abgespeichert wird. Ohne Angabe dieses Parameters oder falls Sie diesen Parameter mit dem Wert "keep" aufrufen, wird die Datei in dem Ordner abgespeichert, in dem auch die Originaldatei liegt. Dieser Parameter kann mit den Parametern save-name und save-ext kombiniert werden. Jeder dieser Parameter ist optional, so dass Sie unabhängig voneinander den Ordner, den Namen und die Endung definieren können. Wenn Sie die konvertierte Datei unter einem expliziten Dateinamen mit Pfad, Name und Endung speichern möchten, benutzen Sie bitte den Parameter save. Wenn Sie keinen der Parameter save, save-folder, save-name oder save-ext angeben, wird die Originaldatei überschrieben. Mit dem Parameter keep-subdirs können Sie steuern, wie mit Unterordnern innerhalb des Ordners umgegangen werden soll. Mehr Informationen zu diesem Parameter und Beispiele für dessen Verwendung finden Sie im Abschnitt über die Parameter für die Speicherung.
save-namekeep oder beliebiger TextkeepName ohne Ordner und Dateiendung, mit dem die konvertierte Datei abgespeichert wird. Ohne Angabe dieses Parameters oder falls Sie diesen Parameter mit dem Wert "keep" benutzen, erhält die Datei den Namen, den auch die Originaldatei hatte. Dieser Parameter kann mit den Parametern save-folder und save-ext kombiniert werden. Jeder dieser Parameter ist optional, so dass Sie unabhängig voneinander den Ordner, den Namen und die Endung definieren können. Wenn Sie die konvertierte Datei unter einem expliziten Dateinamen mit Pfad, Name und Endung speichern möchten, benutzen Sie bitte den Parameter save. Wenn Sie keinen der Parameter save, save-folder, save-name oder save-ext angeben, wird die Originaldatei überschrieben. Mehr Informationen zu diesem Parameter und Beispiele für dessen Verwendung finden Sie im Abschnitt über die Parameter für die Speicherung.
save-extkeep oder beliebiger TextkeepDateiendung mit dem die konvertierte Datei abgespeichert wird. Ohne Angabe dieses Parameters oder falls Sie diesen Parameter mit dem Wert "keep" benutzen, erhält die konvertierte Datei die Dateiendung, die auch die Originaldatei hatte. Dieser Parameter kann mit den Parametern save-folder und save-name kombiniert werden. Jeder dieser Parameter ist optional, so dass Sie unabhängig voneinander den Ordner, den Namen und die Endung definieren können. Wenn Sie die konvertierte Datei unter einem expliziten Dateinamen mit Pfad, Name und Endung speichern möchten, benutzen Sie bitte den Parameter save. Wenn Sie keinen der Parameter save, save-folder, save-name oder save-ext angeben, wird die Originaldatei überschrieben. Mehr Informationen zu diesem Parameter und Beispiele für dessen Verwendung finden Sie im Abschnitt über die Parameter für die Speicherung.
enckeep, ascii, latin1, latin2, win-ansi, win-1250, win-1251, win-1252, win-1253, cp437, utf7, utf8, utf16le, utf16be, utf32le oder utf32bekeep Kodierung für die konvertierte Datei. Mit "keep" wird die Kodierung der Originaldatei für die Speicherung der konvertierten Datei verwendet, ansonsten wird die angegebene Kodierung für die Speicherung verwendet. Die Kodierung "win-ansi" ist abhängig von der Lokalisierung Ihrer Windows-Version. Es wird die Windows-Codepage verwendet, die Ihrer Sprachversion von Windows entspricht. Eine Übersicht über alle verfügbaren Kodierungen finden Sie hier. Mehr Informationen zu diesem Parameter und Beispiele für dessen Verwendung finden Sie im Abschnitt über die Parameter für die Kodierung.
enc-readauto, ascii, latin1, latin2, win-ansi, win-1250, win-1251, win-1252, win-1253, cp437, utf7, utf8, utf16le, utf16be, utf32le oder utf32beauto Kodierung, mit der die Datei eingelesen wird. Falls dieser Parameter nicht angegeben wird, wird versucht die Kodierung automatisch zu erkennen. Die Kodierung "win-ansi" ist abhängig von der Lokalisierung Ihrer Windows-Version. Es wird die Windows-Codepage verwendet, die Ihrer Sprachversion von Windows entspricht. Mehr Informationen zu diesem Parameter und Beispiele für dessen Verwendung finden Sie im Abschnitt über die Parameter für die Kodierung.
bom0, 1 oder keepkeep Soll eine Byte Order Mark in die Datei geschrieben werden? 0 für nie, 1 für immer, "keep" für wie in der Originaldatei. Mehr Informationen zu diesem Parameter und Beispiele für dessen Verwendung finden Sie im Abschnitt über die Parameter für die Kodierung.
lbkeep, system, crlf, lf, cr, nl, ff, nel, ls, ps, vt, tab, nochar, customstr-x, customcp-xkeep Zeilenumbruch-Typ für die konvertierte Datei. Mit "keep" wird der Zeilenumbruchtyp der Originaldatei beibehalten, ansonsten wird der angegebene Typ verwendet. Der Wert "system" entspricht dem Standard-Zeilenumbruch-Typ des Betriebssystems, auf dem der TextKonverter aktuell ausgeführt wird. Also zum Beispiel crlf für Windows. Die Konstante "nochar" steht für kein Zeichen. Sie können nochar verwenden, um alle Zeilenumbruchszeichen aus einer Datei zu entfernen. Mit "customstr-" und "customcp-" lassen sich benutzerdefinierte Zeichen für einen Zeilenumbruch über Text oder Codepoints definieren (das x steht für den benutzerdefinierten Text oder Codepoint). Eine Erklärung und Beispiele für die Verwendung von benutzerdefinierten Zeilenumbrüchen finden Sie hier und hier (letzter Link bezieht sich auf den TextEncoder, kann aber genauso auch für den TextKonverter verwendert werden). Mehr Informationen zu diesem Parameter und Beispiele für dessen Verwendung finden Sie in der Übersicht über die verschiedenen Zeilenumbruchtypen, die Sie mit dem TextKonverter verweden können, sowie im Abschnitt über die Parameter für den Zeilenumbruchtyp.
lb-readauto, system, crlf, lf, cr, nl, ff, nel, ls, ps, vt, tab, fixedlength-x, customstr-x, customstrs-x, customcp-x, customcps-xauto Zeilenumbruch, mit dem die Datei eingelesen wird. Falls dieser Parameter nicht angegeben wird oder "auto" angegeben ist, wird versucht den Zeilenumbruch automatisch zu erkennen. Der Wert "system" entspricht dem Standard-Zeilenumbruch-Typ des Betriebssystems, auf dem der TextKonverter aktuell ausgeführt wird, also zum Beispiel crlf für Windows. Mit "fixedlength-" kann ein Text mit fixer Zeilenlänge eingelesen werden (zum Beispiel "fixedlength-70" für 70 Zeichen pro Zeile). Eine Erklärung und Beispiele finden Sie hier und hier. Mit "customstr-" und "customcp-" lassen sich benutzerdefinierte Zeichen für einen Zeilenumbruch über Text oder Codepoints für das Einlesen definieren (das x steht für den benutzerdefinierten Text oder Codepoint). Eine Erklärung und Beispiele finden Sie hier und hier. Wenn Sie Dateien mit verschiedenen gemischten Zeilenumbruchtypen haben, können Sie "customstrs-" und "customcps-" verwenden. Damit lassen sich mehrere kommagetrennte benutzerdefinierte Zeilenumbrüche über Text oder Codepoints definieren, zum Beispiel "customcps-13,10". Ein Erklärung und Beispiele für die Anwendung finden Sie hier und hier. Mehr Informationen zu diesem Parameter und Beispiele für dessen Verwendung finden Sie in der Übersicht über die verschiedenen Zeilenumbruchtypen, die Sie mit dem TextKonverter verweden können, sowie im Abschnitt über die Parameter für den Zeilenumbruchtyp. Einige der hier verlinkten Seiten für Erklärungen und Beispiele führen zum Tutorial über die Skriptsteuerung des TextEncoders. Die dort gezeigten Beispiele und Erklärungen gelten aber genauso für den TextKonverter.
dateauto oder keepautoMit date=keep wird jedes Datum der Originaldatei für die geänderte oder neu gespeicherte Datei übernommen. Wenn Sie diesen Parameter weglassen oder date=auto verwenden, richtet sich das Änderungsdatum der Datei nach dem Zeitpunkt der Bearbeitung und das Erstellungsdatum bleibt bei der ersten Erstellungzeit der Datei.
filter-extbeliebiger Text-Falls nur Dateien mit einer bestimmten Endung bearbeitet werden sollen, können Sie diese Endung(en) hier angeben. Also zum Beispiel filter-ext=txt um nur Dateien mit der Endung TXT zu bearbeiten. Mehrere Endungen können mit einem Schrägstrich getrennt werden. Also zum Beispiel filter-ext=php/htm/html um nur Dateien mit den Endungen PHP, HTM oder HTML zu bearbeiten. Wenn Sie diesen Parameter weglassen oder leer lassen, werden Dateien mit allen Endungen berücksichtigt.
filter-namebeliebiger Text- Falls nur Dateien mit einem bestimmten Namen bearbeitet werden sollen, können Sie hier einen Namen angeben. Bearbeitet werden alle Dateien die die mit "filter-name" angegebenen Zeichen in ihrem Namen enthalten. Mit filter-name=ab also zum Beispiel Dateien wie abc.txt oder xab.txt. Mehrere Suchbegriffe können mit einem Schrägstrich getrennt definiert werden (zum Beispiel filter-name=abc/def um alle Dateien zu finden, in deren Namen entweder "abc" oder "def" vorkommt). Wenn Sie diesen Parameter weglassen oder leer lassen, werden Dateien mit allen Namen berücksichtigt.
filter-name-matchcase0 oder 10Soll der mit dem Parameter "filter-name" angegebene Text oder reguläre Ausdruck gemäß seiner Groß- und Kleinschreibung interpretiert werden? 0 für nein, 1 für ja. Falls 1 muss der Text/RegEx im Dateinamen genau so in der gleichen Schreibweise vorkommen. Falls 0 wird unabhängig von der Groß- und Kleinschreibung gesucht.
filter-name-matchall0 oder 10Soll der mit dem Parameter "filter-name" angegebene Text oder reguläre Ausdruck dem Dateinamen komplett entsprechen? 0 für nein, 1 für ja. Falls 1 muss der gesamte Dateinamen den Suchbegriff vollständig matchen. Falls 0 ist es ausreichend wenn der Suchbegriff lediglich irgendwo im Dateinamen vorkommt.
filter-name-regex0 oder 10Falls der unter "filter-name" angegebene Suchfilter als regulärer Ausdruck interpretiert werden soll, verwenden Sie 1. Falls einfach nur nach dem angegebenen Text gesucht werden soll, 0.
filter-hiddenfiles0 oder 10Sollen beim Bearbeiten eines Ordners auch versteckte Dateien bearbeitet werden? 0 für nein, 1 für ja. Mit dem Wert 0 bleiben alle versteckten Dateien unberührt, mit dem Wert 1 werden auch die versteckten Dateien bearbeitet.
filter-onlytextfiles0 oder 11Sollen beim Bearbeiten eines Ordners nur Textdateien bearbeitet werden? 0 für nein, 1 für ja. Falls ja, wird jede Datei vor der Konvertierung geprüft, ob sie eine Binärdatei ist und eine Bearbeitung nur dann durchgeführt, falls die Datei keine Binärdatei ist.
search-subdirs0 oder 11 Sollen beim Bearbeiten eines Ordners auch Dateien aus einem Unterordner bearbeitet werden? 0 für nein, 1 für ja. Mit dem Wert 0 werden nur die Dateien bearbeitet, die direkt im Ordner liegen. Mit dem Wert 1 werden sowohl die Dateien bearbeitet, die direkt im Ordner liegen, als auch alle Dateien, die in einem Unterordner unterhalb des Ordners liegen. Beispiele und weitere Erläuertungen zu diesem Parameter finden Sie im Abschnitt "Dateien aus Ordnern bearbeiten".
keep-subdirs0 oder 10 Dieser Parameter kontrolliert ob die Ordnerstruktur aus einem ursprünglichen Ordner in einem neuen Ordner beibehalten werden soll oder nicht. Anwendungsfall: Es wird ein Ordner übergeben, dessen Inhalt konvertiert werden soll. Innerhalb dieses Ordners gibt es einen oder mehrere Unterordner mit beliebig vielen Ebenen. Außerdem sollen die Dateien in einem neuen oder in einem anderen Ordner gespeichert werden (definiert über den Parameter save-folder). Mit keep-subdirs=1 werden die Dateien im neuen Ordner in der selben Ordnerstruktur gespeichert, wie sie innerhalb des Originalordners gespeichert waren. Mit keep-subdirs=0 wird die Ordnerstruktur aus dem ursprünglichen Ordner ignoriert und alle Dateien werden direkt im Ordner gespeichert, der für die Speicherung definiert wurde. Beispiele und Erläuertungen zu diesem Parameter finden Sie im Abschnitt "Dateien aus Ordnern bearbeiten".
openfile0 oder 10Soll die konvertierte Datei nach der Bearbeitung geöffnet werden? Mit openfile=1 wird die neu erstellte Datei geöffnet.
delfile0 oder 10Soll die Originaldatei nach der Konvertierung gelöscht werden? Mit delfile=1 wird die Originaldatei gelöscht. Diese Option ist nur sinnvoll, wenn die konvertierten Dateien unter einem anderen Namen oder an einem anderen Ort als die Originaldatei gespeichert werden sollen und die Originaldateien nicht behalten werden sollen.
info%enc%, %bom%, %encbom%, %lb%, %lines%, %chars%, %words%, Platzhalter für den Dateinamen und Ordner, Platzhalter für die Dateigröße, Platzhalter für das Datum und beliebiger Text frei kombinierbar-Mit dem Parameter "info" können Informationen über die übergebenen Dateien und die Dateien aus übergebenen Ordnern in der Konsole ausgegeben werden. Als Wert können die Platzhalter %enc% (Kodierung der Datei), %bom% (Ist eine Byte Order Mark vorhanden?), %encbom% (Kodierung und Byte Order Mark), %lb% (Zeilenumbruchtyp), %lines% (Anzahl der Zeilen), %chars% (Anzahl der Zeichen) und %words% (Anzahl der Wörter) sowie beliebiger Freitext miteinander kombiniert werden. Außerdem können die Platzhalter für den Dateinamen, den Ordner, die Dateigröße und das Datum verwendet werden. Also zum Beispiel "info=%enc%" um ausschließlich die Kodierung anzuzeigen, "info=%encbom% %lb%" um Kodierung, Byte Order Mark und Zeilenumbruchtyp anzuzeigen oder "info=Die Datei %filename% hat %lines% Zeilen, %chars% Zeichen und %words% Wörter." um diesen Satz für eine Datei auszugeben. Eine detaillierte Erklärung und weitere Beispiele finden Sie im Tutorial über die Ausgabe von Dateiinformationen per Skript.

Prinzipiell können alle aufgeführten Parameter miteinander kombiniert und innerhalb eines Aufrufs des TextKonverters zusammen verwendet werden. Welche Rolle dabei die Reihenfolge der Parameter spielt und wie die verschiedenen Parameter dabei interagieren - insbesondere in dem Fall, falls sich einzelne Parameter widersprechen - erfahren Sie im Abschnitt über die kombinierte Anwendung von Aktionen, Aktionslisten, Einstellungsdateien und Parametern. Wird der TextKonverter aufgerufen ohne einen bestimmten Parameter zu definieren, wird für diesen Parameter der Wert aus der Spalte "Default" verwendet. Steht in der "Default"-Spalte der Wert "-" heißt dies, dass der betreffende Parameter per Default leer ist.

Skriptsteuerung der alten Programmversion

Die alte Programmversion des TextKonverters kannte noch keine Aktionen oder Aktionslisten. Auch viele der heutigen Parameter wie die Parameter für die für das Einlesen und Speichern verwendete Kodierung oder den verwendeten Zeilenumbruchtyp sowie die Parameter für die Speicheroptionen gab es noch nicht. Stattdessen mussten nahezu alle Einstellungen über Einstellungsdateien mit der damaligen Dateiendung TKG übergeben werden.

Falls Sie sich über die alten Möglichkeiten informieren möchten oder noch die alte Version des TextKonverters verwenden, finden Sie hier die Einführung in die Batch-Funktionalität des alten TextKonverter Pro CL.