ExecuteCommand
Gruppe |
|
Funktion |
Die Klasse ermöglicht die Ausführung von Kommandos auf Betriebssystemebene. |
Konfigurationsdatei |
sample_execute_command.properties |
Beschreibung
Die Klasse ermöglicht die Ausführung von Kommandos auf Betriebssystemebene. Im Feld Zusätzliche Parameter muss der Pfad zu einer Properties-Datei übergeben werden.
Parameterbeschreibung
Parametername |
Beschreibung |
cmd |
Das Kommando, das ausgeführt werden soll. z.B. ls. |
param.<x> |
Die Parameter, die dem Kommando mitgegeben werden sollen. Index ist 1. Mit param.1=-l wird bei dem Kommando ls das Gesamt-Kommando ls -l ausgeführt. |
working.dir |
Das Arbeitsverzeichnis, in dem das Kommando ausgeführt werden soll. Falls kein Verzeichnis angegeben ist, wird das Installationsverzeichnis des Integration Servers verwendet. |
max.time |
Die Maximalzeit, die das Kommando benötigen darf, bevor ein Fehler gemeldet wird. |
error |
Es wird ein Fehler gemeldet, wenn die Ausführung des Kommandos den angegeben Fehler auf stdout zurückliefert. Mit Voranstellung von regex: kann auch ein regulärer Ausdruck verwendet werden. |
success |
Der Rückgabewert (Zahl) des Kommandos im Erfolgsfall. Wenn nichts angegeben, dann wird der Wert 0 erwartet. |
env.<VARIABLENNAME> |
Umgebungsvariablen, die vor der Ausführung gesetzt werden sollen. Mit env.MY_VAR=xyz wird z.B. die Umgebungsvariable MY_VAR mit dem Wert xyz gesetzt. |
Hinweis: Für die Werte der Parameter cmd und param.<x> können auch Platzhalter verwendet werden:
Variablen in der Syntax @VAR_NAME@
System-Konstanten (nicht Profil-Konstanten) in der Syntax %CONST_NAME%
Die Platzhalter <file>, <basefile>, <file-prefix> und <file-out>
Beispiel
Zusätzlicher Parameter: ./conf/test.properties
cmd=C:\\test.bat
#param.1=
#working.dir=
#max.time=
error=@VAR_ERROR@
#success=
#env.XXX=
Hinweis: Die Properties-Datei muss im Unterverzeichnis ./conf des Installationsverzeichnis des Integration Servers liegen.
Hinweis: Beachten Sie den doppelten Backslash im cmd-Befehl. Dies ist notwendig, weil der Backslash in Properties-Dateien ein Sonderzeichen ist. Siehe auch Abschnitt Aufbau einer Properties-Datei.
Hinweis: Leerzeichen sind kein Problem. Die erste Zeile könnte also z. B. auch cmd=C:\\test x.bat lauten.
mkdir test222
Hinweis: Die Datei muss im Arbeitsverzeichnis liegen. Hier also im Installationsverzeichnis ./ des Integration Servers.