<onfunctionblock> Element

This element defines the FB instance which triggers the creation of the HMI symbol instance or symbol group on the HMI page or the folder under the 'Application' node in the PLANT.

Parent elements: <group>, <symbol>, <folder>

Attributes:

Attribute Description Type / Required

id Unique identifier that defines the FB instance that triggers the creation of the HMI symbol instance or symbol group defined by the parent <symbol> or <group> element or the folder defined by the parent <folder> element. Type: string
Required: yes

name Defines the name of the FB instance that triggers the creation of the symbol instance/symbol group/folder. Type: string
Required: no

unique Specifies whether the symbol instance/symbol group/folder should be created once or as many times the FB instance exists.
If set to "true", the symbol instance/symbol group/folder is created once, even if the triggering FB instance exists two or more times in the project. Type: boolean true or false (default)
Required: no

level Specifies for which FB instance node level as represented in the PLANT under the program instance node the creation is triggered. You can use this attribute to limit the creation to a specific node level.
The program instance ('Robot' in the following example) has level 0 (root node). The child nodes (FB instances 'Robot1' and 'Robot2' in the example) have level 1 and so on.

Example:
In the following example, setting level to 0 means that no symbol instance is created because 'RobotFB' has level 1. With level="1", an instance of the symbol 'Robot' would be created.

To limit the symbol/group generation to several levels, separate the desired levels by the "|" character. Example:

In this example, an instance of the symbol 'MySymbol' would be created by the FB instance 'MyFB' with a node level of 0, 1, and 3. Type: string
Required: no

Attribute	Description	Type / Required
id	Unique identifier that defines the FB instance that triggers the creation of the HMI symbol instance or symbol group defined by the parent <symbol> or <group> element or the folder defined by the parent <folder> element.	Type: string Required: yes
name	Defines the name of the FB instance that triggers the creation of the symbol instance/symbol group/folder.	Type: string Required: no
unique	Specifies whether the symbol instance/symbol group/folder should be created once or as many times the FB instance exists. If set to "true", the symbol instance/symbol group/folder is created once, even if the triggering FB instance exists two or more times in the project.	Type: boolean true or false (default) Required: no
level	Specifies for which FB instance node level as represented in the PLANT under the program instance node the creation is triggered. You can use this attribute to limit the creation to a specific node level. The program instance ('Robot' in the following example) has level 0 (root node). The child nodes (FB instances 'Robot1' and 'Robot2' in the example) have level 1 and so on. Example: In the following example, setting level to 0 means that no symbol instance is created because 'RobotFB' has level 1. With level="1", an instance of the symbol 'Robot' would be created. To limit the symbol/group generation to several levels, separate the desired levels by the "\|" character. Example: In this example, an instance of the symbol 'MySymbol' would be created by the FB instance 'MyFB' with a node level of 0, 1, and 3.	Type: string Required: no