Skip to main content

Aktion: ExecuteShellCommand

Funktion: Die Aktion führt ein Shell-Kommando auf dem PLC-Gerät aus.

Aufruf: Testtreiber Devices

Registerkarte: Konfiguration

Gerätename

Gerät im geöffneten Projekt, auf dessen Shell verbunden wird

tm_storefullobjectname.png: Kopiert die Einstellungen eines Objekts, das im POUs- oder Gerätebaum selektiert ist, in das Eingabefeld

_cds_icon_arrow_down.png: Öffnet eine Auswahlliste mit geeigneten Objekten, die im geöffneten Projekt konfiguriert sind

Tipp: Sie können die Einstellungen eines selektierten Objekts auch in das Eingabefeld ziehen (Drag&Drop).

Befehl

Das auszuführende Kommando

Weitere Informationen über Shell-Kommandos finden Sie in der Hilfe zur Registerkarte SPS-Shell.

Timeout (ms)

Wartezeit auf eine Antwort der Geräte-Shell

Trifft während dieser Zeitspanne keine Antwort des Gerätes ein, schlägt die Aktion fehl.

Tabelle 41. Ergebnis

Ergebnis nicht überprüfen

Die Antwort der Geräte-Shell wird nicht ausgewertet.

Übereinstimmung mit Zeichenfolgen

Überprüfung, ob die empfangene Antwort mit der angegebenen Zeichenfolge übereinstimmt

Wenn dies nicht der Fall ist, schlägt die Aktion fehl. Die Zeichenfolge kann im Feld unterhalb festgelegt werden.

Übereinstimmung mit regulärem Ausdruck

Überprüfung, ob die Antwort dem angegebenen regulären Ausdruck entspricht

Wenn dies nicht der Fall ist, schlägt die Aktion fehl. Der reguläre Ausdruck kann im Feld unterhalb festgelegt werden.



Ergebnis speichern

Ausgangsparameter, dem die empfangene Antwort zugewiesen wird

Angabe ohne Anführungszeichen

Beispiel: {ResultShellCommand}

Wenn Übereinstimmung mit regulärem Ausdruck aktiv ist, wird die erste Match-Gruppe des regulären Ausdrucks der Skriptvariablen zugewiesen.

Registerkarte: Parameter

Die in der Registerkarte Parameter definierten Parameter werden verwendet, um Werte zwischen Testskriptvariablen und Parametern von Testaktionen auszutauschen. Parameter können in der Registerkarte Konfiguration als Platzhalter verwendet werden. Dabei wird der Name des Parameters im Konfigurationsdialog in geschweifte Klammern gesetzt. Beispielsweise {name}.

Tipp

Global im Skript definierte Variablen (mit Präfix $GLOBALS.) können Sie direkt in der Testaktion verwenden. Eine Übergabe durch Eingangsparameter ist dabei nicht notwendig. Für das Schreiben von globalen Variablen ist die Verwendung von Ausgangsparametern notwendig.

Eingangsparameter: Bei der Ausführung der Testaktion werden die Werte der Testskriptvariablen den Eingangsparametern der Testaktion übergeben und können in der Konfiguration der Testaktion verwendet werden.

Ausgangsparameter: Bei der Ausführung der Testaktion werden die Werte der Ausgangsparameter der Testaktion den Testskriptvariablen übergeben und können so beispielsweise in anderen Testaktionen verwendet werden.

Name

Name des Eingangs- / Ausgangsparameters

Dieser Name wird zusätzlich zum Variablennamen definiert, um die Herkunft des Parameters erkenntlich machen zu können, wenn er an ein anderes Skript übergeben wird. Beim Testlauf wird dieser Name als Name außerhalb Im Fenster Testfortschritt in der Registerkarte Variablen (Gültigkeitsbereich #<n>) mit angezeigt.

Hintergrund: Wenn ein Skript A ein anderes Skript B aufruft, und seine Variable x dem Skript B als Parameter y übergibt, so ist aus Sicht des Skripts B der Parameter y die Variable y.

Um zu sehen, dass diese Variable „außerhalb“ des Skripts B als Variable x bekannt ist, gibt es die Spalte Name („Name außerhalb“): Im Gültigkeitsbereich des Skripts B hat die Variable y den Namen x, weil sie im Gültigkeitsbereich des aufrufenden Skripts A als Variable x an den Parameter y übergeben wurde.

Variable

Name der Testskriptvariablen

Beispiel: TS_CaseA_Result

Nach oben

Verschiebt die selektierte Variable um 1 Zeile nach oben

Nach unten

Verschiebt die selektierte Variable um 1 Zeile nach unten

Entfernen

Entfernt die selektierte Variable aus der Liste

In diesem Abschnitt: