ExecuteCommand

Gruppe

Eigene Klassen Phase 6

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


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.

test.bat
mkdir test222


Hinweis: Die Datei muss im Arbeitsverzeichnis liegen. Hier also im Installationsverzeichnis ./ des Integration Servers.