Parameter

Top  Previous  Next

Bedienung > Transformation von Dateigruppen > Kommandozeilenprogramm > Parameter

 

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.

Im ersten Fall hat der Aufruf die Form:

 

tetra_cl -p PROJECT -m MANAGEMENT [-a]

 

im zweiten Fall ist er:

 

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

 

 

 

 

-p PROJECT

 

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

 

 

-m MANAGEMENT

 

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

Wird der -m Paramerter angeführt, so werden -s und -t und -r ignoriert.

 

 

-s SOURCE

 

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"

 

 

-t TARGET

 

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.

 

-b BACKUP

 

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

 

 

Beispiele:

 

tetra_cl -p exchange.ttp -s feuerbach.txt -b C:\Backup

 

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

 

tetra_cl -p exchange.ttp -s feuerbach.txt -t bachfeuer.txt

 

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

 

tetra_cl -p exchange.ttp -s *.* -t ..\newdir

 

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.

 

 

-c CONFIGURE

 

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.

 

-x EXTRA

 

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.

 

 

-a ASK

 

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

 

transform: quelle to ziel ? (yes,no,all,cancel)

 

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

 

y        die Transformation wird für diese Datei durchgeführt

n        die Transformation wird für diese Datei nicht durchgeführt

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

 

 

-r RECURSIVE

 

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.

 



Diese Seite gehört zur TextTransformer Dokumentation

Home  Inhalt  English