Bedienung > Transformation von Dateigruppen > Kommandozeilenprogramm

Tetra_cl lässt sich entweder über ein Management steuern, das mit dem Transformations-Manager erzeugt wurde, oder durch Parameter für die Quell- und Ziel-Dateien.

tetra_cl -p PROJECT -s SOURCE [-t TARGET] [-b BACKUP] [-c CONFIGURE] [-x EXTRA] [-a] [-r]

Die einzelnen Parameter sind stets mit einem Bindestrich gekennzeichnet, auf den unmittelbar ein Buchstabe folgt. Nach einem Leerzeichen muss bei einigen Parametern ein Text folgen. Die Ausdrücke in eckigen Klammern sind optional.

Pfadangaben, die Leerzeichen enthalten müssen in Anführungszeichen gesetzt werden, z.B.: "C:\Dokumente und Einstellungen\admin\Eigene Dateien\Ziel"

Parameter	Bedeutung	Beispiele
-p PROJECT	TETRA-Projekt	exchange.ttp
-m MANAGEMENT	Transformations-Manager Projekt	MyWebSite.ttm
-s SOURCE	Quelldatei(en)	C:\dir\*.txt
-t TARGET	Zieldatei oder Zielverzeichnis	C:\dir2\target.txt
-b BACKUP	Backup-Verzeichnis	C:\Backup
-c CONFIGURE	Konfigurationsparameter	"\"C:\\boost\", \"C:\\mylib\""
-x EXTRA	Extra-parameter	alternative_rule
-a ASK	Abfrage bei jeder Datei
-r RECURSIVE	rekursiv die Dateien der Unterordner einschließen

Auf den Parameter -p folgt die Adresse des TETRA-Projekts, mit dem die Dateien des Quellverzeichnisses transformiert werden sollen.

Auf den Parameter -m folgt die Adresse des Transformations-Manager-Projekts, in dem die Quell- und Ziel-Dateien spezifiziert sind.

Auf den Parameter -s folgt die Kennzeichnung der Dateien, die transformiert werden sollen.

Diese Kennzeichnung ist im einfachsten Fall die Adresse einer einzelnen Datei, wie "C:\dir\source.txt". Um alle TXT-Dateien eines Verzeichnisses zu transformieren, kann eine Maske wie "C:\dir\*.txt" verwendet werden. Die Dateien des aktuellen Verzeichnisses werden transformiert, wenn die Maske keine Verzeichnisangabe enthält. Z.B.:"ab?.*" würde alle Dateien des aktuellen Verzeichnisses als Quelldateien auswählen, sie mit "ab" beginnen, worauf ein einzelnes Zeichen und eine beliebige Erweiterung folgt; etwa "ab1.txt", "ab2.txt" und "ab_.bat"

Die Angabe eines Ziels ist optional. Fehlt sie, so werden die Quelldateien durch ihrer transformierten Versionen überschrieben. Als Ziel kann ein vollständig spezifizierter Dateiname angegeben werden oder aber ein Dateiname ohne spezifiziertes Verzeichnis. Im letzteren Fall wird die Datei in das Quellverzeichnis geschrieben. Wird umgekehrt zwar ein Zielverzeichnis, aber kein Dateiname angegeben, so werden die Quelldateien unter ihrem alten Namen in das neue Verzeichnis geschrieben.

Ein Backup-Verzeichnis ist notwendig, wenn mindestens eine der Quelldateien durch ein Zieldatei überschrieben wird.. Wenn keine Datei überschrieben wird, wird kein Backup angelegt..

"feuerbach.txt" wird durch seine transformierte Version überschrieben. Vor der Transformation wird in "C:\Backup" eine Sicherheitskopie von "feuerbach.txt" angelegt..

Die transformierte Version von "feuerbach.txt" wird in die Datei "bachfeuer.txt" im gleichen aktuelle Verzeichnis geschrieben.

Die transformierten Dateien werden in das Unterverzeichnis "..\newdir" geschrieben. Falls das Verzeichnis nicht existiert, wird es automatisch neu angelegt.

Werden durch die Angabe der Quelle mehrere Dateien ausgewählt zugleich aber ein einzelner Dateiname für das Ziel bestimmt, werden alle Ergebnisse in die einzelne Zieldatei geschrieben. Diese muss von allen Quelldateien verschieden sein.

Auf die Option "-c" folgend können Parameter, die vor dem Start sämtlicher Transformationen benötigt werden, als Bezeichner oder String an das Projekt übergeben werden.. Dort werden sie mit der Funktion ConfigParam gelesen. Ein Config-Parameter wird für alle Dateien gesetzt.

Auf die Option "-x" folgend können Parameter, die vor dem Start einer bestimmten Transformation benötigt werden, als Bezeichner oder String an das Projekt übergeben werden.. Dort werden sie mit der Funktion ExtraParam gelesen. Pro Datei kann ein Extra-Parameter gesetzt werden.

Der optionale Parameter "-a" veranlasst, dass vor der Transformierung jeder Datei die Frage auf dem Bildschirm erscheint:

Die Frage muss durch Drücken des entsprechenden Anfangsbuchstabens beantwortet werden:

a die Transformation wird für diese Datei und alle weiteren Dateien durchgeführt

c die Transformation wird für diese Datei und alle weiteren Dateien abgebrochen

Der optionale Parameter "-r" bestimmt, dass das Quellverzeichnis rekursiv nach Quelldateien durchsucht wird, d.h. dass in allen Unterverzeichnissen des Quellverzeichnisses nach Dateien die zur Maske passen gesucht wird.