The script manager allows to import / export the structure of groups and expressions from / to a CSV file. The CSV file is formatted as follows:
- Each field is enclosed in double quotes. If the field contains double quotes, then additional double quotes are put around them. For example, the field "Mud" temperature, °C should look like this: """Mud"" temperature, °C"
- Fields are separated by commas. For example: "Group1","RandomExpr","pt=trig1:100;","","DOUBLE","return Math.random();","Random number every 100ms"
- Each new set of fields begins with a new line
- The first line defines the names of the fields (parameters) and should contain all the parameters used
Description of fields used when exporting and importing expressions:
- Expression Group: contains the path to the group where the expression is located. Group names are separated by dots.
- Expression: contains the expression name.
- Triggers: contains a set of triggers defined in the expression, such as dt=trig_b:Examples.TagB. The format of this field is described below.
- Modules: Contains a set of modules imported into the expression, e.g. module1;module2;md5 (modules are separated by semicolons)..
- DataType: contains the type of data to be returned.
- Code: contains the expression code.
- Comment: contains any custom text.
Triggers are written using the following format: [TRIGGER_TYPE]=[TRIGGER_NAME]:[PARAMETER], where
- TRIGGER_TYPE: specifies the trigger type (periodic or data trigger) and takes the value of pt or dt, respectively.
- TRIGGER_NAME: specifies the name (key) of the trigger.
- PARAMETER: depending on the trigger type, defines the following parameter:
- update rate set in milliseconds (for the periodic trigger).
- path to the tag (for the data trigger).
To define several triggers, you need to specify the required number of strings in [TRIGGER_TYPE]=[TRIGGER_NAME]:[PARAMETER] format divided by semicolons.