Import & Export

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:

  1. Update rate set in milliseconds (for the periodic trigger).

  2. 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.

Last updated