Eingabekonfiguration
Eine oder mehrere der im Folgenden beschriebenen Nachfolgeaktionen können im Dialog Eingabekonfiguration für ein bestimmtes Ereignis (z.B. OnMouseClick) des Elements definiert werden. Der Dialog öffnet auf einen Mausklick in das Wertefeld dieses Ereignisses im Eigenschaftenfenster. Der Name des Ereignisses, für das diese Nachfolgeaktionen selektiert werden, ist als Titel in der grauen Zeile sichtbar.
Um eine Nachfolgeaktion hinzuzufügen, muss zunächst die entsprechende Aktion auf der linken Seite des Dialogs markiert werden. Dann kann durch Betätigen der Schaltfläche, dessen Pfeil nach rechts zeigt, die Aktion hinzugefügt werden. Um eine Aktion wieder zu löschen, muss sie auf der rechten Seite markiert werden und die Schaltfläche, dessen Pfeil nach links zeigt, betätigt werden.
Die folgenden Aktionen stehen zur Verfügung:
- Benutzerverwaltung
- Dialog schließen
- Dialog öffnen
- Sprachumschaltung
- Visualisierungswechsel
- Internes Kommando
- Framevisualisierung umschalten
- Variable schreiben
- ST-Code ausführen
- Variable umschalten
Benutzerverwaltung
Die Benutzerverwaltung als Nachfolgeaktion kann nur gewählt werden, wenn zuvor eine Benutzerverwaltung angelegt oder die Bibliothek "VisuUserManagement" manuell hinzugefügt worden ist.
Über die Benutzerverwaltung können die vier folgenden Standarddialoge und -aktionen hinzugefügt werden. Mit ihrer Hilfe ist es dem Visualisierungsnutzer im Onlinebetrieb möglich:
- sich anzumelden
- sich abzumelden
- das Benutzerpasswort zu ändern
- die Benutzerverwaltung zu öffnen
Dialog schließen
Hier kann festgelegt werden, dass auf das Ereignis hin der angegebene Dialog mit dem angegebenen Resultat geschlossen wird. Wählen Sie den gewünschten Dialog von der Auswahlliste, die alle momentan verfügbaren Eingabedialoge anbietet.
Dialog | Auswahl eines Dialogs aus der Auswahlliste |
Ergebnis | Die Liste bietet die Standardoptionen an, die in Dialogen verwendet werden. In diesen Standardoptionen ist eine Benutzerreaktion gefordert.
|
 | Beachten Sie, dass das Resultat, das vom zuletzt geschlossenen Dialog stammt, abgerufen werden kann und dass eine entsprechende Reaktion darauf in einem beliebigen Element derselben Visualisierung konfiguriert werden kann. Verwenden Sie dazu die Konfigurationsoption "OnDialogClosed". |
Dialog öffnen
Hier kann definiert werden, dass auf eine Mausaktion hin ein Dialog geöffnet werden soll, der durch eine andere (Standard- oder vom Benutzer erstellte) Visualisierung repräsentiert wird. Die Auswahlliste bietet alle Visualisierungen an, die in Ihren Objekteigenschaften den Verwendungszweck "Dialog" eingetragen haben. Somit kann ein selbst erstellter Dialog als Benutzereingabemaske in einer Visualisierung verwendet werden.
Zumindest die Standardobjekte "VisuDialogs.Login" und "VisuDialogs.FileOpenSave" sind verfügbar, wenn VisuDialogs.library im Projekt eingebunden ist. Es können zudem auch selbst erstellte Eingabedialoge genutzt werden.
Dialog | Auswahl eines Dialogs aus der Auswahlliste |
Parameter | Für die ausgewählte Dialogvisualisierung werden die Eingangs- (VAR_INPUT), Ausgangs- (VAR_OUTPUT) und Ein-/ Ausgangsparameter (VAR_IN_OUT,) die im Schnittstellen-Editor definiert worden sind, dargestellt. (Parameter, Typ, Wert) In der letzten Spalte "Wert" können die Parameter mit Variablen aus der SPS verbunden werden. Die Werte der Variablen werden dann beim Öffnen der Dialogvisualisierung in die Parameter geschrieben (VAR_INPUT, VAR_IN_OUT) und gegebenenfalls beim Schließen des Dialogs zurückgelesen. (VAR_OUTPUT, VAR_IN_OUT. |
Ereignis | Es muss angegeben werden, auf welches Ergebnis der Dialogvisualisierung hin Ihre Ausgangs- und Ein-/Ausgangsparameter geschrieben werden sollen: Setzen Sie einen Haken in der Verwenden-Spalte des gewünschten Ergebniswertes. Mögliche Werte:
|
| Beachten Sie, dass die Ausgangs- und Ein-/Ausgangsparameter einer Dialog-Visualisierung nicht geschrieben werden, bevor der Dialog geschlossen wird! Bis dahin werden die Werte nur auf dem Stack gespeichert, d.h. werden nicht als Referenzen sondern als Kopien gehandhabt. |
Sprachumschaltung
Hier kann eine Landessprache angegeben werden, die auf die Mausaktion hin für die Darstellung der Visualisierungstexte verwendet wird. Verwenden Sie dabei das Sprachkürzel, das in der/ den zugehörigen Textliste(n) verwendet wird. Alternativ können Sie auf die Taste 
klicken, um die gewünschte Sprache im Eingabeassistenten auszuwählen. (Siehe auch Sprache und Text)
Visualisierungswechsel
Hier kann ein Wechsel der aktuell sichtbaren Visualisierungsseite als Nachfolgeaktion eingestellt werden. (Siehe auch Abschnitt "Umschalten zwischen Visualisierungsseiten")
Wählen Sie eine der folgenden Optionen zur Festlegung, welche Visualisierungsseite auf die Mausaktion im Onlinebetrieb hin angezeigt werden soll:
Zuweisen | Die Visualisierungsseite kann direkt eingegeben werden. Dazu wird idealerweise die Eingabehilfe verwendet, die über die Schaltfläche |
Ausdruck zuweisen | Hier kann eine Variable vom Typ String angegeben werden, die von dem SPS-Projekt verwendet wird und den Namen der Visualisierungsseite liefert. Beispiel: sVisualizationName : STRING := ‘MyVisualization‘; |
| Die Abfolge, in der Visualisierungsseiten nacheinander über Benutzereingaben angezeigt wurden, wird intern gespeichert. Mit den folgenden beiden Optionen können diese Informationen genutzt werden. |
Vorhergehende Visualisierung | Die zuvor angezeigte Visualisierungsseite wird wieder angezeigt. Wenn zuvor noch keine aufgerufen worden ist, wird weiterhin die aktuelle gezeigt. |
Nächste Visualisierung | Die Visualisierungsseite, die in der aufgezeichneten Abfolge der Visualisierungswechsel hinter der aktuellen steht, wird angezeigt. Dies ist als nur möglich, wenn aus dieser vorher bereits ein Visualisierungswechsel über "Vorhergehende Visualisierung" vorgenommen worden ist. |
Internes Kommando
Hier können ein oder mehrere Kommandos definiert werden, die auf die Mausaktion hin ausgeführt werden sollen.
Wählen Sie aus der Liste "Befehle konfigurieren" einen Befehl aus und betätigen Sie die Schaltfläche 
, um ihn in der Tabelle im unteren Teil des Dialogs einzufügen. Diese Tabelle enthält alle ausgewählten Befehle der Eingabekonfiguration.
Eine kurze Beschreibung zum oben in der Liste ausgewählten Befehl wird immer im Mittelteil des Dialogs angezeigt. Ergänze Sie dementsprechend die Parameter des Befehls unten in den Tabellenspalten "1. Parameter" und "2. Parameter". Die Spalte "Kommando" zeigt den internen Kommandonamen. Sehen Sie hierzu auch in der folgenden Tabelle die Beschreibung der einzelnen Kommandos.
Mit der Schaltfläche 
kann der gerade ausgewählte Eintrag von der Liste entfernt werden. Die konfigurierten Befehle werden später, wenn die Benutzereingabe auf das Visualisierungselement erfolgt, entsprechend ihrer Anordnung in der Tabelle von nach unten nacheinander aufgeführt. Um die Reihenfolge zu verändern, können die Einträge mit den Schaltflächen 
und 
verschoben werden.
Die folgenden Kommandos stehen zur Auswahl:
Programm auf der Steuerung ausführen Programm beim Client ausführen | Das angegebene Programm (*.exe) wird auf der Steuerung bzw. beim Visualisierungs-Client ausgeführt. 1. Parameter: Zeichenfolge (String), Pfad der Programmdatei (Beispiel: c:\programs\notepad.exe) 2. Parameter: Zeichenfolge (String), Argumente für das auszuführende Programm, z.B. Name einer Datei, die das Programm öffnen soll (Beispiel: copyfile.txt) |
Der Standarddialog "Drucken" wird geöffnet, wo Einstellungen zum Einstellen des Druckerbereichs und der Druckerparameter etc. vorgenommen werden können. Darüber kann die aktuelle Visualisierung ausgedruckt werden. Dieser Befehl wird nur innerhalb der PLC HMI unter Windows unterstützt. | |
Zu URL (WebVisu) navigieren | Voraussetzung: Visualisierung wird als PLC HMI Web ausgeführt. Bei Eintreten des Eingabeereignisses navigiert die Visualisierung zur Webseite er angegebenen URL 1. Parameter: Webadresse URL - als Variable des Typs String, um die Startseite programmatisch zu setzten. (Beispiel: MAIN.sUrl) - als Literal in einfachen Hochkommata. (Beispiel: http://www.beckhoff.com 2. Parameter: Wenn kein Parameter angegeben ist, wird die Webseite in einem neuen Fenster oder einer neuen Registerkarte dargestellt. Wenn "replace" angegeben ist, wird die PLC HMI Web durch die Webseite ersetzt. |
Framevisualisierung umschalten
Voraussetzung: In einer Visualisierung im Projekt gibt es mindestens ein Frame-Element, dem über die Frame-Auswahl verschiedene Visualisierungen zugeordnet wurden. Diese Visualisierungen erhalten innerhalb des Frames eine Indizierung 0, 1, 2, usw. und im Standardfall wird die erste der zugeordneten Visualisierungen (Index 0) online im Frame angezeigt.
Im vorliegenden Dialog können Sie nun konfigurieren, dass beim Ausführen der Mausaktion auf das aktuelle Visualisierungselement in einem bestimmten Frame-Element eine bestimmte der ihm zugeordnete Visualisierung angezeigt wird. Mit dem aktuellen Element kann also ein Umschalter für die Anzeige von Visualisierung in einem Frame programmiert werden. (Siehe auch Abschnitt "Umschalten zwischen Visualisierungsseiten innerhalb eines Frames")
Die Auswahlart des betroffenen Frame-Elementes
- Kann sich auf die aktuelle Visualisierung beschränken, was einen einfacheren Konfigurationsdialog, allerdings ohne dynamische Konfigurationsmöglichkeit, bedeutet. (→ Lokale Visualisierung)
- Kann für alle im Projekt verfügbaren Visualisierungen erweitert werden, die auch dynamische Definitionen des Frames und der angezeigten Visualisierung erlauben (→ beliebige Visualisierung)
Lokale Visualisierung
Nur Frames der aktuellen Visualisierung können angesprochen werden und stehen somit hier im Feld "Auswahl des Frames" zur Auswahl. Dies ist ein einfacher Dialog zur schnellen direkten Konfiguration in der lokalen Visualisierung. Er bietet allerdings nicht die Möglichkeit, die gewünschte Visualisierung über eine Projektvariable anzugeben. Wenn dies benötigt wird, wählen Sie "beliebige Visualisierung".
Die Auswahl des Frame zeigt die lokalen Frame-Elemente und eingerückt darunter jeweils die zugeordneten Visualisierungen.
Wählen Sie unterhalb des betroffenen Frames die gewünschte Visualisierung, die auf die Mausaktion hin angezeigt werden soll. Klicken Sie auf "Auswahl zuweisen", um die Einstellungen zu speichern. Die aktuelle Auswahl wird daraufhin in den Feldern Frameauswahl und Visualisierungsauswahl angezeigt.
Beliebige Visualisierung
Alle Frames des Projekts und ihre zugeordneten Visualisierungen stehen zur Auswahl. In diesem Fall können Frame und Visualisierung auch über Projektvariablen, also dynamisch angegeben werden.
Die "Auswahl von Frame und Visualisierung" wird dann über folgende Felder und Optionen vorgenommen:
Direkte Zuweisung | Wenn diese Option aktiviert ist, kann der Name des betroffenen Frame-Elements direkt mit der entsprechenden Visualisierung eingegeben werden. Über die Schaltfläche Beispiel: Visualization_1.MyFrame |
Zuweisung über Ausdruck | Diese Option kann alternativ aktiviert werden, um eine Projektvariable vom Typ String für die Angabe des Frame-Elements zu verwenden. Über die Schaltfläche Beispiel: sVisualization : STRING := ‘Visualization_1.MyFrame’; |
| Die gewünschte Visualisierung, die bei der Mausaktion im ausgewählten Frame angezeigt werden soll, wird über ihren Index angegeben. Dieser Index ist eine mit 0 beginnende aufsteigende, ganzzahlige Nummerierung der Visualisierung, die einem Frame in der Frame-Auswahl zugewiesen wurden. Somit wird initial standardmäßig immer die erste Visualisierung in dieser Liste angezeigt. |
Auszuwählender Index | Geben Sie hier den Index der gewünschten Visualisierung direkt oder über eine in der Applikation verwendete Projektvariable an. Die Schaltfläche |
Variable schreiben
Wenn für ein Visualisierungselement eine Eingabekonfiguration des Typs "Variable schreiben" existiert, dann wird, sobald die entsprechende Mausaktion ausgeführt wird, das Element eine Möglichkeit bieten, einen Wert einzugeben. Der Wert kann dann als eine Zeichenfolge über ein Numpad oder Keypad eigegeben werden und wird nach Beendigung der Eingabe auf die Projektvariable geschrieben, die hier im Eingabekonfigurationsdialog angegeben ist. Der Wert wird entsprechend des Datentyps der Projektvariablen als Text oder als numerischer Wert interpretiert.
Wählen Sie von der Auswahlliste im rechten Teil des Dialogs einen der folgenden Eingabetypen:
Standard | Es wird der Standard-Eingabetyp verwendet. Sie können den Standard in den Einstellungen des Visualisierungsmanagers festlegen. |
Texteingabe | Es öffnet sich ein Feld für die Wert-/ Texteingabe. Um Werte einzugeben, muss eine Tastatur vorhanden sein. |
Texteingabe mit Grenzen | Es öffnet sich ein Feld für die Wert-/ Texteingabe. Zusätzlich werden oberhalb die Eingabegrenzen angezeigt, welche bei Unterschreiten oder Überschreiten rot dargestellt werden. Um Werte einzugeben, muss eine Tastatur vorhanden sein. |
VisuDialogs.Keypad | Die Mausaktion wird eine simulierte Tastatur öffnen. Sie können durch Mausklicks auf die entsprechenden Tastenfelder eine Zeichenfolge eingeben. |
VisuDialogs.Numpad | Die Mausaktion wird ein simuliertes Nummernfeld öffnen. Sie könne durch Mausklicks auf die entsprechenden Tastenfelder eine numerische Zeichenfolge eingeben. |
| Zusätzlich zu den Standard-Eingabetypen werden alle Visualisierungen angeboten, welche in ihren Eigenschaften als "Nummernfeld", "Tastatur" oder "Dialog für Eingabekonfiguration" definiert wurden. (Siehe Objekteigenschaften) |
| Für die Benutzung von Tastatur oder Nummernfeld muss die Bibliothek "VisuDialogs" im Bibliotheksmanager hinzugefügt werden. |
Wählen Sie dann die zu bearbeitende Variable aus:
Textausgabevariable verwenden | Der Wert wird in die Variable geschrieben, die als Textausgangsvariable in dem Visualisierungselement angegeben ist. |
Andere Variable verwenden | Angabe einer Projektvariablen. Hierzu können Sie über die Schaltfläche |
Initiales Darstellungsformat | Angabe eines Platzhalters mit Formatierungsangabe Beispiel: %2.3f |
Min | Angabe der Untergrenze für die einzugebende Variable |
Max | Angabe der Obergrenze für die einzugebende Variable |
Dialogtitel | Angabe als Text oder über eine Textvariable, was in der Titelleiste des Dialogs angezeigt werden soll |
Passwortfeld | Falls Sie wünschen, dass Ihre Eingabe durch "*********" (wie im Fall von Passworten) versteckt dargestellt werden soll, so aktivieren Sie das Kontrollkästchen vor dem Passwortfeld. |
Beispiel
Sehen Sie als Beispiel die obige Dialogabbildung und nehmen Sie an, es handele sich um den Konfigurationsdialog für ein Rechteckelement. Wenn im Onlinebetrieb die Maustaste auf diesem Rechteck gedrückt wird, erscheint ein Nummerntastaturfeld mit dem Titel, der von der Variablen "MAIN.sTitle" geliefert wird.
Durch Mausklick auf 1, 2 und 3 kann beispielsweise der Wert "123" eingegeben werden. Dieser Wert wird im oberen Teil des Dialogs angezeigt, ebenso wie die Minimal- und Maximalwerte für die Eingabe, die durch "MAIN.fMinValue" und "MAIN.fMaxValue" gegeben werden. Sobald die Eingabe mit einem Mausklick auf die Taste OK bestätigt wird, wird "123" auf die Variable "MAIN.fValue" geschrieben. Wenn "fValue" als STRING-Variable definiert ist, erhält es den Wert "123". Wenn "fValue" eine numerische Variable ist, erhält sie den Wert 123.
ST-Code ausführen
Im Eingabefeld dieser Nachfolgeaktion kann Code in Strukturiertem Text eingegeben werden, der auf eine Mausaktion hin ausgeführt werden soll.
| Ein komplexes ST-Programm ist nur möglich, wenn die PLC HMI und/oder die PLC HMI Web aktiviert worden ist. Ansonsten sind nur einfache Zuweisungen ausführbar. |
Variable umschalten
Hier kann eine boolesche Variable eingegeben werden, die bei wiederholter Mausaktion zwischen TRUE und FALSE wechseln soll.
