Mit Platzhaltern arbeiten
Die Konfigurationsdatei unterstützt verschiedene Platzhalter. Die Platzhalter werden vom HMI-Generator durch die referenzierten Werte ersetzt. Mit Hilfe von Platzhaltern können Sie die Eigenschaften von IEC-Codeelementen lesen und diese für die zu erzeugenden Elemente der HMI-Applikation übernehmen.
Platzhalter können in folgenden Attributen verwendet werden:
- Attribut displayname der Elemente <page>, <group> und <symbol>
- Attribut comment des Elements <symbol>
- Attribut value des Elements <data> (die Datenwerte werden über das übergeordnete <dataset>-Element einem <symbol>-, <group>- oder <page>-Element zugewiesen)
| Hinweis
Die Platzhalter müssen zwischen @-Zeichen eingeschlossen werden. Es wird nicht zwischen Groß-/Kleinschreibung unterschieden. |
Beispiel:
In diesem Beispiel wird der Wert 'Symbol_of_Robot1' als Objekt-ID des Symbols verwendet, das durch die FB-Instanz 'RobotFB' erzeugt wird. Dabei ist 'Robot1' der Name der POE-Instanz 'RobotFB'.
Die folgende Tabelle beschreibt die möglichen Platzhalter, die Werte, die mit dem jeweiligen Platzhalter gelesen werden und die Attribute, in denen der Platzhalter verwendet werden kann.
Platzhalter zum Lesen von Eigenschaften der Variable, die das Erzeugen des HMI-Elements auslöst:
| Platzhalter | Zu lesender Wert | Kann verwendet werden in Attribut |
|---|---|---|
| @Variable.Name@ | Name der Variable |
|
| @Variable.Comment@ | Kommentar der Variable | |
| @Variable.DataType@ | Datentyp der Variablen |
Platzhalter zum Lesen von Eigenschaften der POE-Instanz, die das Erzeugen des HMI-Elements auslöst:
| Platzhalter | Zu lesender Wert | Kann verwendet werden in Attribut |
|---|---|---|
| @Pou.GroupName@ | Gruppenname der POE-Instanz |
|
| @Pou.InstancePath@ | Instanzpfad der POE-Instanz | |
| @Pou.name@ | Name der POE-Instanz | |
| @Pou.PouKind@ | "FunctionBlock" oder "Program" | |
| @Pou.Comment@ | Kommentar der POE-Instanz für Programme. Kommentar des POE-Typs für Funktionsbausteine. | |
| @Pou.[xyz].Comment@ | Kommentar einer Variablen xyz (wird aus der Typdefinition der Variable entnommen) | |
| @Pou.DataType@ | Datentyp der POE-Instanz |
Platzhalter zum Lesen von Datums- und Zeitwerten zum Zeitpunkt der Generierung des HMI-Inhalts:
| Platzhalter | Zu lesender Wert | Kann verwendet werden in Attribut |
|---|---|---|
| @DateTime.Year@ @DateTime.Month@ @DateTime.Day@ @DateTime.Hour@ @DateTime.Minute@ @DateTime.Second@ @DateTime.Millisecond@ | Teile von Datum und Uhrzeit |
|
| @DateTime.DayOfYear@ | Kalendertag | |
| @DateTime.DayOfWeek@ | Wochentag. Beispiel: Sonntag | |
| @DateTime@ | Datum mit Tageszeit. Beispiel: 03.02.2021 11:31:02 | |
| @DateTime.Date@ | Datum mit Zeitverschiebung. Beispiel: 03.06.2021 12:00:00 |
Platzhalter zum Lesen von Eigenschaften der erzeugten HMI-Seiteninstanz:
| Platzhalter | Zu lesender Wert | Kann verwendet werden in Attribut | |
|---|---|---|---|
| @Page.Name@ | Name der HMI-Seiteninstanz
|
|
Platzhalter zum Lesen von Eigenschaften der erzeugten HMI-Symbolinstanz:
| Platzhalter | Zu lesender Wert | Kann verwendet werden in Attribut |
|---|---|---|
| @Symbol.Comment@ | Kommentar der HMI-Symbolinstanz |
|
| @Symbol.Name@ | Name der HMI-Symbolinstanz | |
| @Symbol.SymbolType.Name@ | Typenname der HMI-Symbolinstanz |
Platzhalter zum Lesen von Eigenschaften des PLCnext Engineer-Projekts:
| Platzhalter | Zu lesender Wert | Kann verwendet werden in Attribut |
|---|---|---|
| @Project.ProjectTitle@ | Name der aktuellen Projekts |
|
Platzhalter zum Lesen von Eigenschaften der erzeugten HMI-Gruppeninstanz:
| Platzhalter | Zu lesender Wert | Kann verwendet werden in Attribut |
|---|---|---|
| @Group.Name@ | Name der HMI-Gruppeninstanz | value des Elements <data>, referenziert vom Element <group> |
| @Group.Comment@ | Kommentar der HMI-Gruppeninstanz |