Element <folder>

Dieses Element definiert den Ordner, der unterhalb des 'Applikation'-Knotens in der ANLAGE erzeugt werden soll. Mit dem <folder>-Element können Sie Ordnerstrukturen anlegen, um Ihre HMI-Seiten in der ANLAGE zu organisieren. Das Erzeugen eines Ordners wird durch die Existenz eines IEC-Codeelements (z.B. FB-Instanz, Programminstanz, Variable usw.) oder einer vorhandenen HMI-Seite im Projekt angestoßen. Die Angabe, für welches Codeelement oder für welche HMI-Seite der Ordner erzeugt wird, erfolgt mit Hilfe des untergeordneten <on...>-Elements wie z.B. <onfunctionblock> Element oder <onpage>-Elements.

<folder>-Elemente können verschachtelt werden. Die Anzahl der Verschachtelungen ist nicht begrenzt.

Elternelement: <generation>, <folder>

Attribute:

Attribut Beschreibung Typ / Notwendig

displayname Name des zu erzeugenden Ordners.
In @ eingeschlossene Platzhalter können verwendet werden. Typ: Zeichenfolge
Notwendig: ja

required Mit dem Wert "true" wird ein leerer Ordner erzeugt, auch wenn das <folder>-Element keine untergeordneten <page>- oder <folder>-Elemente enthält. Mit dem Wert "false" oder wenn das Attribut nicht angegeben ist, wird nur dann ein Ordner erzeugt, wenn das Element untergeordnete <page>-Elemente enthält. Typ: true oder false (Default-Wert)
Notwendig: nein

unique Gibt an, ob der Ordner nur einmal oder so oft erzeugt werden soll, wie das triggernde Element vorhanden ist.
Mit dem Wert "true" wird der Ordner nur einmal erzeugt, auch wenn das triggernde Element mehr als einmal im Projekt vorhanden ist. Typ: true oder false (Default-Wert)
Notwendig: nein

Attribut	Beschreibung	Typ / Notwendig
displayname	Name des zu erzeugenden Ordners. In @ eingeschlossene Platzhalter können verwendet werden.	Typ: Zeichenfolge Notwendig: ja
required	Mit dem Wert "true" wird ein leerer Ordner erzeugt, auch wenn das <folder>-Element keine untergeordneten <page>- oder <folder>-Elemente enthält. Mit dem Wert "false" oder wenn das Attribut nicht angegeben ist, wird nur dann ein Ordner erzeugt, wenn das Element untergeordnete <page>-Elemente enthält.	Typ: true oder false (Default-Wert) Notwendig: nein
unique	Gibt an, ob der Ordner nur einmal oder so oft erzeugt werden soll, wie das triggernde Element vorhanden ist. Mit dem Wert "true" wird der Ordner nur einmal erzeugt, auch wenn das triggernde Element mehr als einmal im Projekt vorhanden ist.	Typ: true oder false (Default-Wert) Notwendig: nein

Beispiel:

Im folgenden Beispiel wird der Ordner 'SampleFolder' und der Ordner 'TopFolder' mit dem Unterordner 'Level1' erzeugt. Die Ordner werden erzeugt, wenn die FB-Instanz 'RobotFB' (im untergeordneten <onfunctionblock>-Element angegeben) im Code existiert. Durch das Setzen von required="true" für den 'SampleFolder' wird sichergestellt, dass der Ordner auch dann erzeugt wird, wenn das Element keine untergeordneten <page>- oder <folder>-Elemente enthält.