Aktion eingeben: Befehl ausführen

Hier werden Befehle mit Übergabeparametern aufgelistet, die die Visualisierung beim Auftreten eines Eingabeereignisses verarbeitet.

„Befehle konfigurieren“

_visu_icon_open_list.png
  • „Programm auf der SPS ausführen“

  • „Programm auf dem Client ausführen“

  • „Drucken“

  • „Zur URL navigieren (WebVisu)“

  • „Rezept erstellen“

  • „Rezept lesen“

  • „Rezept schreiben“

  • „Rezept in Datei schreiben“

  • „Rezept aus Datei laden“

  • „Rezept löschen“

Klicken Sie auf das Symbol _visu_icon_add.png, um den ausgewählten Befehl zur unteren Befehlsliste hinzuzufügen.

_visu_icon_add.png

Der Befehl in „Configure commands“ wird der Liste hinzugefügt.

_visu_icon_remove_command.png

Der Befehl wird entfernt.

Erfordernis: Ein Befehl ist ausgewählt.

Die Reihenfolge in der Liste bestimmt die Reihenfolge der Ausführung.

_visu_icon_down_command.png

Der ausgewählte Befehl wird in der Liste um eine Position nach unten verschoben.

_visu_icon_up_command.png

Der ausgewählte Befehl wird in der Liste um eine Position nach oben verschoben.

Tab. 842: Befehl: Programm auf der SPS ausführen

„Befehl“

„1. Parameter“

„2. Parameter“

‎ExecutePlcProgram‎

‎'C:\programs\notepad.exe'‎

‎'Notes_A.txt'‎

EXE-Datei, die auf dem Controller ausgeführt wird

Das Programm wird auf der SPS ausgeführt und darf daher nicht interaktiv sein und keine Benutzerschnittstellen haben.

Es ist beispielsweise möglich, dass ein Programm eine Datei kopiert.

Programmname mit Verzeichnis als String in einfachen, geraden Anführungszeichen

Argumente des Programms als String in einfachen, geraden Anführungszeichen

Beispiel: Name der Datei, die das Programm öffnet

Tab. 843: Befehl: Programm auf dem Client ausführen

„Befehl“

„1. Parameter“

„2. Parameter“

‎ExecuteClientProgram‎

‎'C:\programs\notepad.exe'‎

‎'Notes_A.txt'‎

EXE-Datei, die auf der Anzeigevariante ausgeführt wird. Ausnahme: WebVisu.

Das Programm wird im Kontext der Anzeigevariante ausgeführt. Danach kann das Programm interaktiv sein und eine Benutzeroberfläche haben.

Programmname mit Verzeichnis als ‎STRING‎ in einfachen, geraden Anführungszeichen

Argumente des Programms als ‎STRING‎ in einfachen, geraden Anführungszeichen

Beispiel: Name der Datei, die das Programm öffnet

HINWEIS

HINWEIS
HINWEIS
HINWEIS

HINWEIS

HINWEIS

Wenn die Visualisierung als CODESYS WebVisu angezeigt wird, kann kein Programm (EXE-Datei) gestartet werden.

Tab. 844: Befehl: Zur URL navigieren (WebVisu)

„Befehl“

„1. Parameter“

„2. Parameter“

‎NavigateURL‎

‎'http://en.wikipedia.org'‎

‎PLC_PRG.stURL‎

‎'replace'‎

Die Visualisierung navigiert zu der Webseite mit der URL.

Erfordernis: Die Visualisierung wird als CODESYS WebVisu ausgeführt.

URL

  • Als wörtliche Rede in einfachen, geraden Anführungszeichen

  • Als Variable (STRING)

Wird kein Parameter angegeben, so wird die Webseite in einem neuen Fenster oder einer neuen Registerkarte angezeigt.

Wenn ‎'replace'‎ angegeben ist, wird CODESYS WebVisu durch die Webseite ersetzt.

Tab. 845: Befehl: Rezept lesen

„Befehl“

„1. Parameter“

„2. Parameter“

‎ReadRecipe‎

‎'RecipeDefinitionForModules'‎

‎'RecipeModuleA'‎

Name der Rezeptdefinition

  • Als wörtliche

  • Als Variable (‎STRING‎)

Name des Rezepts

  • Als wörtliche

  • Als Variable (‎STRING‎)

Zur Laufzeit der Visualisierung liest die Steuerung die Ist-Werte aus den Variablen der Rezeptdefinition und schreibt sie in das angegebene Rezept. Die Werte werden implizit gespeichert (in einer Datei auf der Steuerung) und in der Rezepturdefinition im Rezepturmanager von CODESYS angezeigt. Mit anderen Worten: Das Rezept, das in CODESYS verwaltet wird, wird mit Werten aus dem Controller aktualisiert.

Tab. 846: Befehl: Rezept schreiben

„Befehl“

„1. Parameter“

„2. Parameter“

‎WriteRecipe‎

‎PLC_PRG.stRecipeDef‎

‎PLC_PRG.stRecipe‎

Name der betroffenen Rezeptdefinition

  • Als wörtliche

  • Als Variable (‎STRING‎)

Name des Rezepts (aus der Rezeptdefinition)

  • Als wörtliche

  • Als Variable (‎STRING‎)

Zur Laufzeit der Visualisierung werden die Werte des Rezepts in die Variablen auf der Steuerung geschrieben, wie sie im Rezepturmanager stehen.

Tab. 847: Befehl: Rezept in Datei speichern

„Befehl“

„1. Parameter“

„2. Parameter“

‎SaveRecipeAs‎

‎PLC_PRG.stRecipeDef‎

‎PLC_PRG.stRecipe‎

Name der betroffenen Rezeptdefinition

  • Als wörtliche

  • Als Variable (‎STRING‎)

Name des betroffenen Rezepts, das aktualisiert und in einer Datei gespeichert wird

  • Als wörtliche

  • Als Variable (‎STRING‎)

Optionaler Parameter: Wenn Sie hier keinen Übergabeparameter angeben, werden die Werte aus den Rezeptvariablen nur in der Datei gespeichert, die später angegeben wird. Die impliziten Rezeptdateien werden nicht aktualisiert.

Zur Laufzeit der Visualisierung öffnet sich der Dialog „Rezept speichern unter“ und fordert den Benutzer auf, einen Dateinamen und einen Speicherort auf der Steuerung anzugeben. Der Dateiname darf nicht ‎<recipe>.<recipe definition>‎ lauten. Die Dateierweiterung ist ‎.txtrecipe‎.

Der Benutzer kann dann die Datei speichern, die die aktuellen Werte der Rezeptvariablen enthält. Ist im 2. Parameter ein Übergabeparameter nicht angegeben, so wird die Datei ohne Änderung einer impliziten Rezeptdatei gespeichert. Wird im 2. Parameter ein Übergabeparameter angegeben, so wird auch die implizite Rezeptdatei aktualisiert.

Hinweis: Wenn die Option „Rezeptänderungen automatisch in Rezeptdateien speichern“ in der Registerkarte „Rezeptmanager - Allgemein“ aktiviert ist, werden die Rezeptdefinition in CODESYS und die impliziten Rezeptdateien automatisch beibehalten.

Hinweis: Auf dem Steuergerät existieren implizite (automatisch generierte) Rezeptdateien mit Namen in der folgenden Syntax: ‎<recipe>.<recipe definition>.txtrecipe‎. Diese werden in der Regel in der Anwendung als Puffer beim Lesen und Schreiben von Rezeptvariablen verwendet.

Tab. 848: Befehl: Rezept aus Datei laden

„Befehl“

„1. Parameter“

„2. Parameter“

‎LoadRecipeFrom‎

‎PLC_PRG.stReccipeDef‎

‎PLC_PRG.stReccipe‎

Name der betroffenen Rezeptdefinition

  • Als wörtliche

  • Als Variable (‎STRING‎)

Name des betroffenen Rezepts

  • Als wörtliche

  • Als Variable (‎STRING‎)

Zur Laufzeit der Visualisierung wird der Dialog „Rezept laden“ geöffnet. Sie stellt dem Visualisierungsbenutzer eine Dateiliste zur Verfügung, die sich im Dateisystem der Steuerung befindet und nach der Erweiterung ‎txtrecipe‎ filtert. Die ausgewählte Datei wird heruntergeladen. Dann werden die Rezepte aus der Datei in die impliziten Dateien geschrieben und in das angegebene Rezept in der Rezeptdefinition des Rezeptmanagers eingelesen.

Erfordernis: Die Datei wurde mit dem Befehl ‎SaveRecipeAs‎ erstellt.

Tab. 849: Befehl: Rezept erstellen

„Befehl“

„1. Parameter“

„2. Parameter“

‎CreateRecipe‎

‎PLC_PRG.stRecipeDef‎

‎PLC_PRG.stRecipe_New‎

Name der betroffenen Rezeptdefinition

  • Als wörtliche

  • Als Variable (STRING)

Name des neuen Rezepts

  • Als wörtliche

  • Als Variable (STRING)

Zur Laufzeit der Visualisierung wird ein neues Rezept in der angegebenen Rezeptdefinition angelegt.

Tab. 850: Befehl: Rezept löschen

„Befehl“

„1. Parameter“

„2. Parameter“

‎DeleteRecipe‎

‎PLC_PRG.stRecipeDef‎

‎PLC_PRG.stRecipe‎

Name der betroffenen Rezeptdefinition

  • Als wörtliche

  • Als Variable (‎STRING‎)

Name des Rezepts

  • Als wörtliche

  • Als Variable (‎STRING‎)

Zur Laufzeit der Visualisierung wird das angegebene Rezept aus der Rezeptdefinition gelöscht.