Dialog 'Eingabekonfiguration'

Eingabeaktion 'Benutzerverwaltung'

„Dialoge und Aktionen“	Konfiguriert, welcher der möglichen Benutzerverwaltungsdialoge oder welche Aktion auf das Eingabeereignis folgt. Hinweis: Welcher Dialog zur Laufzeit verwendet wird, ist im Visualisierungsmanager in Registerkarte „Dialogeinstellungen“ eingestellt. Siehe dort „ Dialog Einloggen“ „Dialog Passwortänderung“ „Dialog Konfigurationsänderung“ Voreingestellt sind Dialoge aus der Bibliothek `‎VisuUserManagement‎`.
„Anmelden“	Eingabeaufforderung für das Anmelden öffnet sich. Voreinstellung: `‎VisuUserManagement.VUM_Login‎` in „ Dialog Einloggen“
„Abmelden“	Aktueller Benutzer wird abgemeldet.
„Benutzerpasswort ändern“	Dialog für Passwortänderung öffnet sich. Voreinstellung: `‎VisuUserManagement.VUM_ChangePassword‎` in „Dialog Passwortänderung“
„Benutzerverwaltung öffnen“	Dialog für Konfigurationsänderung öffnet sich. Voreinstellung: `‎VisuUserManagement.VUM_UserManagement‎` in „Dialog Konfigurationsänderung“

Siehe auch

⮫ „Benutzerverwaltung einrichten“
linktarget doesn't exist but @y.link.required='true'

Eingabeaktion 'Dialog schließen'

„Dialog“

Visualisierung des Typs „Dialog“, der geschlossen werden wird.

_visu_icon_open_list : Auswahlliste aller im Projekt verfügbaren Visualisierungen des Typs „Dialog“.

Beispiel:

Standarddialoge der Bibliothek ‎VisuDialogs‎, die üblicherweise im Projekt eingebunden ist.

‎FileOpenSave‎
‎Keypad‎
‎Login‎
‎Numpad‎
‎NumpadExtended‎
‎TextinputWithLimits‎

Hinweis: Ob eine Visualisierung als Dialog verwendet werden kann, ist in ihrer Objekteigenschaft in Registerkarte „Visualisierung“ eingestellt.

„Ergebnis“	Rückgabewert mit dem der Dialog geschlossen wird. Hinweis: Wenn auf das Schließen hin weitere Eingabeaktionen folgen, sind diese in der Eigenschaft „Eingabekonfiguration OnDialogClosed“ des Elements konfiguriert.
„Kein“	: Kein Rückgabewert
„OK“	: Der aktivierte Rückgabewert wird zurückgeliefert. Der Rückgabewert verweist auf die Schaltfläche im Dialog. Bei der OK-Schaltfläche wird der Wert `‎OK‎` zurückgeliefert. Die Schaltfläche für Abbrechen liefert den Wert `‎Cancel‎` zurück.
„Abbrechen“
„Beenden“
„Erneut versuchen“
„Ignorieren“
„Ja“
„Nein“

Siehe auch

linktarget doesn't exist but @y.link.required='true'
⮫ „Dialog 'Eigenschaften' eines Visualisierungsobjekts“

Eingabeaktion 'Dialog öffnen'

„Dialog“

Visualisierung (Typ „Dialog“). Der Dialog wird geöffnet.

_visu_icon_open_list : Auswahlliste mit allen im Projekt verfügbaren Dialogen.

Hinweis: Die Bibliothek „VisuDialogs“ stellt Visualisierungen (Typ „Dialog“) zur Verfügung.

‎VisuDialogs.FileOpenSave‎
‎VisuDialogs.Login‎

Übergabeparameter des Dialogs
„Parameter“	Schnittstellenparameter, so wie im Schnittstelleneditor der Visualisierung deklariert. Beispiel: `‎filelistProvider‎`
„Typ“	Datentyp des Parameters, so wie im Schnittstelleneditor der Visualisierung deklariert. Beispiel: `‎VISU_FBFILELISTPROVIDER‎`
„Wert“	Variable (Datentyp konform zum Datentyp des Parameters). Der Wert der Variablen wird beim Öffnen des Dialogs gelesen und an den Parameter übergeben. Beispiel: `‎PLC_PRG.fileListProvider //Instance of function block VisuDialogs.Visu_FbFileListProvider‎` : Die Eingabeunterstützung bietet alle projektweit verfügbaren Variablen an.

Hier ist aktiviert, bei welchen Rückgabewert des Dialogs auf die `‎Var_OUTPUT‎`-Variablen und die `‎VAR_IN_OUT‎`-Variablen geschrieben wird. Danach schließt sich der Dialog.
„Aktualisiere “ „und“ „falls Ergebnis“	Hinweis: Die Parameter werden aktualisiert, bevor der Dialog geschlossen wird. Bis dahin werden die Werte temporär abgelegt. Sie werden also nicht als Referenz sondern als Kopie verarbeitet.
„Kein“	: Bei keinem Rückgabewert
„OK“	: Legt fest, bei welchem Rückgabewert auf die Übergabeparameter geschrieben wird.
„Abbrechen“
„Beenden“
„Erneut versuchen“
„Ignorieren“
„Ja“
„Nein“

„Dialog modal öffnen“

_cds_icon_option_activated : Nur der Dialog verarbeitet Benutzereingaben. Die restlichen Visualisierungen sind für eine Benutzereingabe gesperrt.

„Position zum Öffnen“
„Zentriert“	Der Dialog erscheint in Bezug zur Visualisierung zentriert.
„Position“	Der Dialog erscheint an der angegebenen Position, so wie in „X“ und „Y“ definiert.
„X“	Positionsangabe in Pixel oder als Variable (ganzzahliger Datentyp)
„Y“	Positionsangabe in Pixel oder als Variable (ganzzahliger Datentyp)

Siehe auch

linktarget doesn't exist but @y.link.required='true'

Eingabeaktion 'Sprachumschaltung'

„Sprache“

Sprache, auf die umgeschaltet wird.

Beispiel: ‎en‎

_visu_icon_open_input_assistant : Die Eingabeunterstützung bietet alle im Projekt verfügbaren Sprachen an.

Eingabeaktion 'Visualisierungswechsel'

Tab. 709: „Zu Visualisierung gehen“
Visualisierung, die auf die Benutzereingabe hin dargestellt wird
„Zuweisen“	Visualisierung, ausgewählt aus allen verfügbaren Visualisierungen des Projekts oder der Bibliotheken Beispiel: `‎visMain‎`
„Ausdruck zuweisen“	Variable (`‎STRING‎`), die den Namen der Visualisierung enthält. Beispiel: `‎PLC_PRG.strVisu‎` bei folgendem Applikationscode: `‎strVisu: STRING := 'visMain';‎`
Intern wird die Reihenfolge gespeichert, in der Visualisierungen nacheinander über Benutzereingaben angezeigt werden. Die folgenden beiden Optionen nutzen diese Information.
„Vorherige Visualisierung“	: Visualisierung, die vor der aktuell angezeigten schon angezeigt worden war. Voraussetzung: Es gab bereits einen Visualisierungswechsel.
„Nächste Visualisierung“	: Visualisierung, die in der Aufrufreihenfolge nach der aktuellen steht. Voraussetzung: Es gab bereits einen Visualisierungswechsel, der über „Vorherige Visualisierung“ aufgerufen wurde.

Eingabeaktion 'Befehl ausführen'

Hier ist eine Liste mit Befehlen und deren Übergabeparameter konfiguriert, die die Visualisierung bei Eintreten des Eingabeereignisses abarbeitet.

„Befehle konfigurieren“

_visu_icon_open_list

„Programm auf der Steuerung ausführen“
„Programm beim Client ausführen“
„Drucken“
„Zu URL (WebVisu) navigieren“
„Rezeptur erstellen“
„Rezeptur lesen“
„Rezeptur schreiben“
„Rezeptur in Datei schreiben“
„Rezeptur aus Datei laden“
„Rezeptur löschen “

Um den ausgewählten Befehl in die untere Befehlsliste einzutragen, klicken Sie auf das Symbol _visu_icon_add .

	Der Befehl unter „Befehle konfigurieren“ wird in die Liste eingetragen
	Befehl wird entfernt Voraussetzung: Ein Befehl ist selektiert.
Die Reihenfolge in der Liste definiert die Reihenfolge der Ausführung.
	Der selektierte Befehl wird in der Liste um eine Position nach unten geschoben.
	Der selektierte Befehl wird in der Liste um eine Position nach oben geschoben.

Tab. 710: Befehl „Programm auf der Steuerung ausführen“
„Befehl“	„1. Parameter“	„2. Parameter“
`‎ExecutePlcProgram‎`	`‎'C:\programs\notepad.exe'‎`	`‎'Notes_A.txt'‎`
EXE-Datei, die auf der Steuerung ausgeführt wird. Das Programm wird auf der SPS ausgeführt und darf deshalb nicht interaktiv sein und es darf keine Benutzeroberfläche haben. Möglich ist ein Programm, das zum Beispiel eine Datei kopiert.	Programmname mit Verzeichnis als `‎STRING‎` in einfachen Anführungszeichen	Argumente des Programms als `‎STRING‎` in einfachen Anführungszeichen Beispiel: Name der Datei, die das Programm öffnet

Tab. 711: Befehl „Programm beim Client ausführen“
„Befehl“	„1. Parameter“	„2. Parameter“
`‎ExecuteClientProgram‎`	`‎'C:\programs\notepad.exe'‎`	`‎'Notes_A.txt'‎`
EXE-Datei, die auf der Darstellungsvariante ausgeführt wird. Ausnahme: WebVisu! Das Programme wird im Kontext der Darstellungsvariante ausgeführt. Somit darf das Programm interaktiv und mit Benutzeroberfläche sein.	Programmname mit Verzeichnis als `‎STRING‎` in einfachen Anführungszeichen	Argumente des Programms als `‎STRING‎` in einfachen Anführungszeichen Beispiel: Name der Datei, die das Programm öffnet

HINWEIS

Wenn die Visualisierung als CODESYS WebVisu dargestellt wird, kann kein Programm (exe-Datei) gestartet werden!

Tab. 712: Befehl „Zu URL (WebVisu) navigieren “
„Befehl“	„1. Parameter“	„2. Parameter“
`‎NavigateURL‎`	`‎'http://de.wikipedia.org'‎` `‎PLC_PRG.stURL‎`	`‎'replace'‎`
Die Visualisierung navigiert zur Webseite der URL. Voraussetzung: Visualisierung wird als CODESYS WebVisu ausgeführt.	URL Als Literal in einfache Anführungszeichen Als Variable (`‎STRING‎`)	Wenn kein Parameter angebeben ist, wird die Webseite in einem neuen Fenster oder einer neuen Registerkarte dargestellt. Wenn `‎'replace'‎` angegeben ist, wird die CODESYS WebVisu durch die Webseite ersetzt.

Tab. 713: Befehl „Rezeptur lesen“
„Befehl“	„1. Parameter“	„2. Parameter“
`‎ReadRecipe‎`	`‎'RecipeDefinitionForModules'‎`	`‎'RecipeModuleA'‎`
	Name der Rezepturdefinition Als Literal Als Variable (STRING)	Name der Rezeptur Als Literal Als Variable (STRING)
Zur Laufzeit der Visualisierung werden die Istwerte aus den Variablen der Rezepturdefinition von der Steuerung gelesen und in die angegebene Rezeptur geschrieben. Dabei werden die Werte implizit (in einer Datei auf der Steuerung) gespeichert und in der Rezepturdefinition im Rezeptur-Manager in CODESYS angezeigt. In anderen Worten: Die in CODESYS verwaltete Rezeptur wird mit den Werten aus der Steuerung aktualisiert.

Tab. 714: Befehl „Rezeptur schreiben“
„Befehl“	„1. Parameter“	„2. Parameter“
`‎WriteRecipe‎`	`‎PLC_PRG.stRecipeDef‎`	`‎PLC_PRG.stRecipe‎`
	Name der betroffenen Rezepturdefinition Als Literal Als Variable (STRING)	Name der Rezeptur (aus der Rezepturdefinition) Als Literal Als Variable (STRING)
Zur Laufzeit der Visualisierung werden die Werte der Rezeptur, so wie sie im Rezeptur-Manager vorliegen, auf die Variablen in der Steuerung geschrieben.

Tab. 715: Befehl „Rezeptur in Datei speichern“
„Befehl“	„1. Parameter“	„2. Parameter“
`‎SaveRecipeAs‎`	`‎PLC_PRG.stRecipeDef‎`	`‎PLC_PRG.stRecipe‎`
	Name der betroffenen Rezepturdefinition Als Literal Als Variable (STRING)	Name der betroffenen Rezeptur, die aktualisiert und in einer Datei gespeichert wird. Als Literal Als Variable (STRING) Optionaler Parameter: Wenn Sie hier keinen Übergabeparameter angeben, werden die Werte aus den Rezepturvariablen nur in der danach angegebenen Datei gespeichert. Die impliziten Rezepturdateien werden nicht aktualisiert.
Zur Laufzeit der Visualisierung öffnet der Dialog „Save Recipe as“ und fordert den Benutzer auf einen Speicherort auf der Steuerung und einen Dateinamen anzugeben. Der Dateiname darf nicht `‎<Rezeptur>.<Rezepturdefinition>‎` sein. Die Dateierweiterung ist `‎.txtrecipe‎`. Der Benutzer kann dann die Datei, die die Istwerte aus den Rezepturvariablen enthält, speichern. Wenn im 2. Parameter kein Übergabeparameter angegeben ist, wird die Datei gespeichert ohne eine implizite Rezepturdatei zu ändern. Wenn im 2. Parameter ein Übergabeparameter angegeben ist, wird auch die implizite Rezepturdatei aktualisiert. Hinweis: Wenn die Option „Rezepturänderungen automatisch in Rezepturdateien speichern“ in Registerkarte „Rezeptur-Manager - Allgemein“ aktiviert ist, ist die Rezepturdefinition in CODESYS und die impliziten Rezepturdateien automatisch gleich. Hinweis: Auf der Steuerung befinden sich implizite (automatisch erstellte) Rezepturdateien mit Namen `‎<Rezeptur>.<Rezepturdefinition>.txtrecipe‎`. Sie dienen üblicherweise der Applikation als Zwischenablage beim Lesen und Schreiben von Rezepturvariablen.

Tab. 716: Befehl „Rezeptur aus Datei laden“
„Befehl“	„1. Parameter“	„2. Parameter“
`‎LoadRecipeFrom‎`	`‎PLC_PRG.stReccipeDef‎`	`‎PLC_PRG.stReccipe‎`
	Name der betroffenen Rezepturdefinition Als Literal Als Variable (STRING)	Name der betroffenen Rezeptur Als Literal Als Variable (STRING)
Zur Laufzeit der Visualisierung öffnet der Dialog „Load Recipe“. Er bietet dem Visualisierungsbenutzer eine Liste mit Dateien an, die auf dem Dateisystem der Steuerung liegen und filtert nach der Erweiterung `‎txtrecipe‎`. Die ausgewählte Datei wird geladen. Die Rezepturen aus der Datei werden dann in die impliziten Dateien geschrieben und im Rezeptur-Manager in der angegebenen Rezepturdefinition in der angegebenen Rezeptur eingelesen. Voraussetzung: Die Datei wurde mit dem Befehl `‎SaveRecipeAs‎` erstellt.

Tab. 717: Befehl „Rezeptur erstellen“
„Befehl“	„1. Parameter“	„2. Parameter“
`‎CreateRecipe‎`	`‎PLC_PRG.stRecipeDef‎`	`‎PLC_PRG.stRecipe_New‎`
	Name der betroffenen Rezepturdefinition Als Literal Als Variable (STRING)	Name der neuen Rezeptur Als Literal Als Variable (STRING)
Zur Laufzeit der Visualisierung wird in der angegebenen Rezepturdefinition eine neue Rezeptur erstellt.

Tab. 718: Befehl „Rezeptur löschen“
„Befehl“	„1. Parameter“	„2. Parameter“
`‎DeleteRecipe‎`	`‎PLC_PRG.stRecipeDef‎`	`‎PLC_PRG.stRecipe‎`
	Name der betroffenen Rezepturdefinition Als Literal Als Variable (STRING)	Name der Rezeptur Als Literal Als Variable (STRING)
Zur Laufzeit der Visualisierung wird die angegebene Rezeptur´aus der angegebenen Rezepturdefinition gelöscht.

Tab. 719: Befehl „Drucken“
„Befehl“	„1. Parameter“	„2. Parameter“
`‎Print‎`	Optional: Dateinamen für das Visualisierungsbild, das gedruckt wird, zum Beispiel: 'Startbild'	Für den Befehl `‎Print‎` kann kein 2. Parameter angegeben werden.
Zur Laufzeit der Visualisierung öffnet sich der Standarddialog „Drucker“. In dem Dialog wählen Sie einen Drucker aus und konfigurieren Sie weitere Druckeinstellungen. Wenn Sie den Dialog bestätigen, wird das aktuell dargestellte Visualisierungsbild gedruckt. Hinweis: Der Befehl kann nur in der TargetVisu ausgeführt werden.

Siehe auch

Eingabeaktion 'Framevisualisierung umschalten'

Bei Auftreten des Eingabeereignisses schaltet in einem Frame die Darstellung auf eine andere Visualisierung um.

„Auswahlart“
„Lokale Visualisierung“	Das Gruppe „Frameauswahl“ ist sichtbar.
„Beliebige Visualisierung“	Die Gruppe „Auswahl von Frame und Visualisierung“ ist sichtbar.

Voraussetzung: „Lokale Visualisierung“ ist aktiviert.
„Frameauswahl“	Liste mit allen Frames, die die aktive Visualisierung enthält. Unter jedem Frame sind die referenzierten Visualisierungen aufgelistet, so wie sie auch in der Eigenschaft „Referenzierte Visualisierungen“ des jeweiligen Frames festgelegt sind. Beispiel:
„Auswahl zuweisen“	Die Auswahl in Eingabefeld „Frame-Auswahl“ wird übernommen und erscheint in den Einstellungen „Ausgewählter Frame“ und „Ausgewählte Visualisierung“. Voraussetzung: Sie haben in Eingabefeld „Frame-Auswahl“ eine Visualisierung selektiert!
„Auswahl des Frames“	Name des Frames, in dem umgeschaltet wird. Beispiel: `‎MainArea‎` Tipp: Verwenden Sie den Befehl „Auswahl zuweisen“ um die Einstellung hier zu ändern.
„Visualisierungsauswahl“	Name der Visualisierung, auf die umgeschaltet wird. Beispiel: `‎visMainArea‎` Tipp: Verwenden Sie den Befehl „Auswahl zuweisen“ um die Einstellung hier zu ändern.

Voraussetzung: „Beliebige Visualisierung“ ist aktiviert.
„Auswahl von Frame und Visualisierung“	Enthält den Frame, in dem umgeschaltet wird.
„Zuweisen“	Frame mit vollständigem Pfad, in dem umgeschaltet wird. Auf welche Visualisierung bestimmt der Index. Beispiel: `‎visMain.frameA.visB.frameB‎` Die Pfadangabe erfolgt im Format: `‎<Visualisierungsname>.<Framename> { <Visualisierungsname>.<Framename> }‎` Vorsicht: Visualisierungen können mit Hilfe von Frame-Elementen beliebig tief verschachtelt sein. Um den Frame-Auswahltyp „Beliebige Visualisierung umschalten“ problemlos nutzen zu können, darf ein Frame jedoch nicht mehr als 21 referenzierte Visualisierungen enthalten.
„Ausdruck zuweisen“	Variable (`‎STRING‎`). Enthält den Pfad des Frames, in dem umgeschaltet wird. Beispiel: `‎strFrane: STRING := 'visMain.frameA.visB.frameB';‎`
„Auszuwählender Index“	Index, der bestimmt, welche der referenzierten Visualisierungen dargestellt wird Als ganze Zahl Als Variable (ganzzahliger Datentyp) Beispiel :`‎PLC_PRG.iIndex‎` Hinweis: Die referenzierten Visualisierungen eines Frames werden über ihre Reihenfolge automatisch indiziert.

Voraussetzung: Das Projekt enthält Visualisierungen, die eine Struktur bilden.

Siehe auch

linktarget doesn't exist but @y.link.required='true'
⮫ „Dialog 'Konfiguration der Framevisualisierungen'“

Eingabeaktion 'Variable schreiben'

Die Konfiguration der Eingabeaktion bestimmt, wie ein Visualisierungsbenutzer einen Wert eingibt und auf welche Variable der Wert geschrieben wird.

„Eingabetyp“ Art und Weise, wie zur Eingabe aufgefordert wird.
„Standard“	Ein Eingabefeld oder bei Bedarf (wenn die Darstellungsvariante über keine Hardwaretastatur verfügt) eine virtuelle Tastatur erscheint. Hinweis: Die Standardmöglichkeit für eine Texteingabe zur Laufzeit ist im Visualisierungsmanager festgelegt: Registerkarte „Dialog-Einstellungen“, „Einstellungen für die Standardtexteingabe“.
„Texteingabe“	Ein Eingabefeld erscheint. Sie können eine Zahl oder einen Text über Tastatur eingeben. Voraussetzung: Die Darstellungsvariante verfügt über eine Tastatur als Eingabegerät.
„Texteingabe mit Grenzen“	Ein Eingabefeld erscheint. Sie können eine Zahl oder einen Text über Tastatur eingeben. Das Feld zeigt zusätzlich den Wertebereich für die Eingabe an. Bei Unterschreiten oder Überschreiten wird der Eingabewert rot dargestellt. Voraussetzung: Die Darstellungsvariante verfügt über eine Tastatur als Eingabegerät.
„VisuDialogs.Keypad“	Eine virtuelle Tastatur erscheint. Sie können damit eine Zahl oder einen Text eingeben.
„VisuDialogs.Numpad“	Eine virtuelle Tastatur erscheint. Sie können damit eine Zahl eingeben.
„VisuDialogs.NumpadExtended“	Eine virtuelle Tastatur erscheint. Sie können damit eine Zahl eingeben. Hier ist auch das Hexadezimal- oder Exponentialformat erlaubt.

„Variable zur Bearbeitung auswählen“
„Textausgabevariable verwenden“	: Der Eingabewert wird in die Textausgabevariable des Elements geschrieben. Das ist die Variable, die In der Eigenschaft „Textvariable Text“ zugewiesen ist.
„Andere Variable verwenden“	: Variable, auf die der Eingabewert geschrieben wird. Beispiel: `‎PLC_PRG.iVariable‎`
„Initiales Darstellungsformat“	Platzhalter mit Formatierungsangabe. Sie bestimmt das Ausgabeformat für den Variablenwert und für die Eingabegrenzen. Beispiel: `‎%2.3f‎` für die Darstellung des Werts als Dezimalbruch mit Komma.

„Min“	Minimalwert der Eingabegrenze. Wenn ein Benutzer einen kleineren Wert eingibt, wird er nicht übernommen. als fester Wert als Variable (Datentyp konform zur ausgewählten Variable)
„Max“	Maximalwert der Eingabegrenze. Wenn ein Benutzer einen größeren Wert eingibt, wird er nicht übernommen. als fester Wert als Variable (Datentyp konform zur ausgewählten Variable)
„Dialogtitel“	Text, der in der Titelleiste des Dialog angezeigt wird. Optional. als fester String Beispiel: `‎Insert value‎` als Variable (`‎STRING‎`) Beispiel `‎PLC_PRG.stTitel : STRING := 'Insert value';‎`

„Passwort-Feld“

_cds_icon_option_activated : Unsichtbare Texteingabe. Statt des eingegebenen Texts wird ‎***‎ dargestellt.

Tab. 720: „Position, an der der Eingabedialog geöffnet werden soll“
„Globale Einstellungen verwenden (vom Visualisierungsmanager)“	: Diese Option ist nur für die Verwendung in einer TargetVisu oder WebVisu wirksam! Die Einstellungen, die auf der Registerkarte „Dialogeinstellungen“ im Visualisierungsmanager vorliegen, werden verwendet.
„Zentriert“	: Der Dialog wird in der Mitte des Visualisierungsfensters geöffnet.
„Position“	: Der Dialog wird an der hier definierten Position in der Visualisierung geöffnet. „X“, „Y“: Variable oder direkte Zahl (Pixel) zur Definition der linken oberen Ecke des Dialogs im Koordinatensystem des Visualisierungsfensters. Sie können hier den Platzhalter `‎ElementRectangle.ptTopLeft.iX‎` beziehungsweise `‎.iY ElementRectangle.ptBottomRight.iY‎` verwenden. Er wird zur Laufzeit durch die Koordinaten des aufrufenden Elements ersetzt.

Siehe auch

linktarget doesn't exist but @y.link.required='true'
⮫ „Platzhalter mit Formatierungsangabe im Ausgabetext“
linktarget doesn't exist but @y.link.required='true'
⮫ „Dialog 'Eigenschaften' eines Visualisierungsobjekts“
⮫ „Platzhalter mit Formatierungsangabe im Ausgabetext“
linktarget doesn't exist but @y.link.required='true'

Eingabeaktion 'ST-Code ausführen'

Eingabefeld

Editor für Code als strukturierter Text

Eingabeaktion 'Variable umschalten'

„Variable“

Variable (‎BOOL‎). Sie schaltet bei einem Eingabeereignis zwischen ‎TRUE‎ und ‎FALSE‎ um.

Beispiel: ‎PLC_PRG.bSwitch‎

Eingabeaktion 'Dateiübertragung'

Mit der Eingabeaktion „Dateiübertragung“ kann eine Datei von einer Bedienvariante (Target- oder Webvisualisierung) sowohl von als auch zur SPS übertragen werden. Dies funktioniert entweder mittels Dateitransfer („Typ“: „Datei“) oder mittels Streaming („Typ“: „Streaming“).

Die Aktion bewirkt, dass zur Laufzeit in der Visualisierung ein Dateiauswahldialog erscheint. Dort kann der Visualisierungsbenutzer eine Datei auswählen, die entweder von oder zur SPS übertragen werden wird: Bei der Übertragung von einer SPS zur Visualisierung öffnet sich der Dialog „Datei speichern“. Bei der Übertragung von der Visualisierung zur SPS öffnet sich der Dialog „Datei öffnen“.

„Übertragung“

„Richtung“

Richtung der Dateiübertragung

„Von der SPS zur Visualisierung“

Das in „Dateiname“ oder „Streaming Instanzname“ bestimmte Objekt wird von der SPS zur Visualisierung übertragen.

Zur Laufzeit erscheint in der Visualisierung der Dateiauswahldialog „Datei speichern“.

„Von der Visualisierung zur SPS“

Die vom Visualisierungsbenutzer bestimmte Datei wird zur SPS übertragen und dort unter dem in „Dateiname“ oder „Streaming Instanzname“ angegebenen Dateipfad gespeichert.

Zur Laufzeit erscheint in der Visualisierung der Dateiauswahldialog „Datei öffnen“.

„Typ“

Legt fest, wie die Datei übertragen wird

Übertragungstyp „Datei“: mittels Dateitransfer
Übertragungstyp „Streaming“: mittels Streaming

„Typ“

„Datei“

Die Datenübertragung erfolgt mittels Dateitransfer.

„Dateiname“

Dateipfad (Typ ‎STRING‎), der die Datei im Dateisystem der Steuerung bezeichnet

Variable

Beispiel: ‎strTransferFile: STRING;‎
Literal mit relativem Pfad

Beispiel: ‎'/Recipes/Recipe_1.txt'‎ speichert die Datei im Verzeichnis ‎Recipes‎
Literal mit Platzhalter ‎$PLCLOGIC$‎

‎PlcLogic‎ ist die Standardauflösung für den Verzeichnisplatzhalter ‎$PLCLOGIC$‎.

Beispiel: ‎'$$PLCLOGIC$$/test.txt'‎ legt die Datei im Verzeichnis ‎PlcLogic‎ ab.

Beispiel: ‎'$$PLCLOGIC$$/MyData/test.txt'‎ legt die Datei im Unterverzeichnis ‎PlcLogic/MyData‎ ab.
Literal mit Platzhalter ‎$VISU$‎

‎visu‎ ist die Standardauflösung für den Platzhalter ‎$VISU$‎.

Beispiel: ‎'$$VISU$$/test.txt'‎ legt die Datei im Unterverzeichnis ‎PlcLogic/visu‎ ab. Alternativ kann ‎'visu/test.txt'‎ angegeben werden.
Literal mit absolutem Pfad

Beispiel: ‎ 'E:\temp\test.txt'‎

Hinweis: Solche Dateipfade werden nicht immer unterstützt.

Hinweis: Wenn in der Visualisierung der Dateipfad von einem Benutzer mit Hilfe eines „Textfeld“-Elements eingegeben wird, muss das Maskierungszeichen ‎$‎ nicht angegeben werden: ‎$VISU$/dummy.txt‎

Hinweis: Im Fall, dass der Dateipfad vom Benutzer eingegeben wird, sollte dieser von der Applikation geprüft werden, um das Auslesen oder Überschreiben unerwünschter Dateien zu vermeiden.

„Typ“

„Streaming“

Die Datenübertragung erfolgt über Streaming.

„Streaming Instanzname“

Instanzpfad (Typ ‎IVisuStreamWriter‎ oder ‎IVisuStreamReader‎), der das Objekt im Dateisystem der Steuerung bezeichnet

Typ‎IVisuStreamReader‎ bei Übertragungsrichtung „Von der SPS zur Visualisierung“

Typ ‎IVisuStreamWriter‎ bei Übertragungsrichtung „Von der Visualisierung zur SPS“

„Steuerflags“

Hinweis: Die Variable wird nur bei der Übertragungsrichtung „Von der Visualisierung zur SPS“ ausgewertet.

Variable (Typ ‎DWORD‎)

Bestimmt, wie das Objekt (Datei oder Instanzobjekt) auf dem Dateisystem der SPS behandelt wird. Dafür stehen zwei Flags zur Verfügung, mit denen die Variable gesetzt werden kann.

Flag 1: ‎VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName‎
Flag 2: ‎VisuElems.VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc‎

Optionen

Kein Flag gesetzt:

Der Benutzer wählt eine Datei aus, die unter dem in „Dateiname“ oder „Streaming Instanzname“ angegebenen Pfad abgelegt wird
Flag 1 ist gesetzt:

Der Pfad, der zur Laufzeit der Visualisierung vom Benutzer eingegeben wird, wird übernommen und als Pfad im SPS-Dateisystem verwendet
Beide Flags sind gesetzt:

Der Pfad wird zusätzlich geprüft. Wenn unter dem auf Client-Seite angegebenen Pfad bereits ein Objekt vorhanden ist, erscheint in der Visualisierung eine Meldung mit einer Abfrage. Dort kann der Visualisierungsbenutzer das Überschreiben der Datei bestätigen.

Beispiel: ‎dwControlFlag‎

Beispiel

Die Übertragungsrichtung ist „Von der Visualisierung zur SPS“ (Schreiben).

Beispiel: Auf dem Visualisierungsgerät ist eine neue Rezepturdatei ‎Recipes/Recipe_2021.txt‎ erstellt worden. Der Visualisierungsbenutzer wählt diese Datei aus und möchte, dass diese auf der SPS unter diesem Namen abgespeichert wird. Da die Kontroll-Flags entsprechend gesetzt sind, öffnet sich ein Meldungsfenster und Visualisierungsbenutzer kann das Überschreiben der Datei bestätigen.

PROGRAM PLC_PRG
VAR
	xVisuToggle : BOOL;
	dwControlFlag : DWORD:= VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName + VisuElems.VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc;
	strFileName: STRING := '/Recipes/Recipe_new.txt';
END_VAR

Tab. 721: „Statusvariablen“
„Übertragung läuft“	Boolesche Variable (optional) `‎TRUE‎`: Die Übertragung läuft.
„Übertragung erfolgreich“	Boolesche Variable (optional) `‎TRUE‎`: Die Übertragung ist erfolgreich beendet.
„Fehlercode“	`‎0‎`: Kein Fehler `‎1‎`: Nicht näher spezifizierter Fehler `‎2‎`: Abbruch des Dateidialogs `‎3‎`: Andere Dateiübertragung aktiv `‎4‎`: Fehler während der Dateiübertragung `‎5‎`: Abbruch durch Timeout `‎6‎`: Dateilesefehler – Die Datei ist nicht vorhanden oder kann nicht gelesen werden `‎7‎`: Keine Geräteunterstützung für die Dateiübertragung Mögliche Ursachen: CODESYS WebVisu: Dateiübertragung standardmäßig nicht möglich Kommunikation mit einer Steuerung der Version < 3.5.11: Funktionalität ist nicht implementiert Kommunikation mit einer Steuerung der Version >= 3.5.11: Dateiübertragung ist nicht freigeschaltet (Geratebeschreibung) Hinweis: Kontaktieren Sie in diesem Fall das CODESYS-Supportteam.