Die Syntax für die Definition und Ausführung einer Konvertierungs-Aktion:
ConvertITP /S{Original File(s)} /T{Target File(s)} /F# [/G] [/V] [/R] [/L{LogFile}] [/B{LogToJobFile}] [/+] [/A{PDF Author}] [/O{PDF Creator}] [/K{PDF Keywords}] [/U{PDF Subject}] [/I{PDF Title}]
In eckige Klammern "[ ]" eingeschlossene Argumente sind optional, alle anderen Argumente erforderlich. Die Argumente /S, /T, /F# müssen also immer angegeben werden. Dazu gibt es nur eine Ausnahme: Wenn /G angegeben wird, ist /T nicht erforderlich.
Zwischen dem Argument und dem Parameter dürfen Leerzeichen stehen. Zum Beispiel ist "/F6" gleich bedeutend mit "/F 6". Schließen Sie lange Dateinamen in Anführungszeichen ein, insbesondere wenn im Pfad Leerzeichen enthalten sind. Beispiel:
/J "C:\Program Files\MyApp\MyDoc.jpg".
/S{Original File(s)} wird verwendet, um die zu konvertierenden Original-Dateien anzugeben. Sie können eine einzelne Datei oder mehrere Dateien mit Platzhalter angeben, z.B. "C:\MyFiles\*.BMP". /T{Target files} sollte sich immer von /S{Original File(s)} unterscheiden.
/T{Target File(s)} wird verwendet, um die Ziel-Dateien anzugeben. Sie können eine einzelne Datei angeben oder mehrere Dateien mit Platzhalter angeben, z.B. "C:\MyFiles\*.PDF"). /T{Target files} sollte sich immer von /S{Original File(s)} unterscheiden.
[/F#] spezifiziert den Typ der Originaldateien. Das Symbol # wird durch eine Zahl ersetzt, welche Sie in der Tabelle „Datei-Typnummern" finden. Der Dateityp wird natürlich gleichzeitig durch die Erweiterung der Original-Datei(en) festgelegt (/S{Original File(s)} Argument).
[/G] sorgt dafür, dass die Ziel-Dateien im gleichen Ordner wie die Original-Dateien abgelegt werden. Verwenden Sie entweder /G oder /T. Beachten Sie bitte, dass /G nicht benutzt werden darf, wenn Sie nur eine einzelne Datei angeben. In diesem Fall bitte /T verwenden.
[/V] Mit diesem Argument wird nach Ausführung ein Fenster angezeigt, welches über die erfolgreiche oder nicht erfolgreiche Ausführung informiert. Bei Fehlen des Arguments erfolgt keine Ausgabe. Siehe auch /L.
[/R] alle Unterordner des Ordners, der in /S angegeben wurde, ebenfalls rekursiv durchsuchen und ggf. Dateien konvertieren. Dieses Argument wird verwendet, wenn Sie mehrere Dateien durch Platzhalter angegeben haben. Siehe auch /S, /T und /G für weitere Details zur Konvertierung ganzer Ordner.
[/L{LogFile}] Log-Datei Pfad und Name (z.B. d:\mylogs\CITP.LOG) Über die Ausführung wird eine Log-Datei angelegt, welche hier mit Pfad und Namen spezifiziert wird. Siehe auch /V.
[/B{LogToJobFile}] Nur die Aktionen, die fehlgeschlagen sind, werden in einer neuen Job-Datei angelegt, deren Pfad und Namen hier angegeben wird. /B unterscheidet sich von /L, weil die mit /B erzeugte Datei keine Kommentare enthält sondern nur Konvertierungs-Aktionen. Der Aufbau ist wie bei einer .SII Datei.
[/+] Die Grafik wird konvertiert und an eine bestehende PDF Datei angehängt.
[/A{PDF Author}] Spezifikation der Autor-Eigenschaft der PDF Datei.
[/D{PDF Creator}] Spezifikation der Erzeuger-Eigenschaft der PDF Datei.
[/K{PDF Keywords}] Spezifikation der Schlüsselwörter-Eigenschaft der PDF Datei.
[/U{PDF Subject}] Spezifikation der Betreff-Eigenschaft der PDF Datei.
[/I{PDF Title}] Spezifikation der Titel-Eigenschaft der PDF Datei.
Beispiele:
Die folgenden Beispiele sollen Ihnen helfen, die Funktionalität der Kommandozeilen-Parameter zu verstehen. Wählen Sie Beispiele für Ihre eigenen Aufgaben aus und verändern Sie sie entsprechend.
Wichtig: Bitte den gesamten Pfad zur Applikation angeben. In unseren Beispielen wurde zur Vereinfachung nur ConvertITP.EXE angegeben. Der vollständige Aufruf wäre "C:\Program Files\SoftInterface, Inc\Convert Image To PDF\ConvertITP.exe", unter der Annahme, dass Sie das Programm in Standard-Ordner installiert haben.
1. Angeben der Original-Dateien (/S), der Ziel-Dateien (/T), des .bmp Formats (/F0) und Informationen auf dem Bildschirm während der Konvertierung (/V):
ConvertITP.EXE /S "C:\Beispiel\Coffee.bmp" /T "C:\Beispiel\Output\CoffeeOut.pdf" /F0 /V
2. Angeben der Original-Dateien (/S), der Ziel-Dateien (/T), des .jpg Formats (/F2) und Erzeugung einer Log-Datei (/L) zur Ausgabe der Meldungen:
ConvertITP.EXE /S "C:\Beispiel\Ripple.jpg" /T "C:\Beispiel\Output\Ripple.pdf" /F2 /L "C:\Beispiel\LogFiles\OutputLog.LOG"
3. Angeben der Original-Dateien (/S), der Ziel-Dateien (/T), des .png Formats (/F13) und Angeben von Autor- (/A), Schlüsselwörter- (/K) und Titel-Eigenschaften (/I) der PDF Datei. Die Eigenschaften können angesehen werden, indem Sie im Internet-Explorer mit Rechtsklick die Dateieigenschaften aufrufen und "PDF Eigenschaften wählen" oder im Adobe Reader:
ConvertITP.EXE /S "C:\Beispiel\CITPIcon.png" /T "C:\Beispiel\Output\Icon.pdf" /F13 /A SoftInterface.com /K Logo /I Application Logo
4. Hier werden alle Dateien eines bestimmten Typs innerhalb eines Ordners über einen Platzhalter angegeben (*). Angeben der Original-Dateien (/S), in diesem Falles alle .jpg Dateien, die Ziel-Dateien (/T), und das .jpg Format (/F2). Informationen auf dem Bildschirm während der Konvertierung (/V) und Erzeugung einer Fehler-Job-Datei (/B) nur für fehlerhafte Aktionen:
ConvertITP.EXE /S "C:\Beispiel\*.jpg" /T "C:\Beispiel\Output\*.pdf" /F2 /V /B "C:\Beispiel\ErrorLogs\Error.SII
5. Konvertiere alle .bmp Dateien im Original-Ordner (/S), sichere sie in den gleichen Ordner als PDF Dateien (/G). Erzeuge eine Log-Datei (/L) mit den Konvertierungs-Ergebnissen sowie eine Fehler-Job-Datei (/B) nur für fehlerhafte Aktionen:
ConvertITP.EXE /S "C:\Beispiel\Output\*.bmp" /G /F0 /L "C:\Beispiel\LogFiles\OutputLog.LOG" /B "C:\Beispiel\ErrorLogs\Error.SII
Siehe auch:
Konvertierungs-Job-Dateien
Datei-Typnummern