Description of macro expressions in the PROMOTIC system

In many Pma objects or Pmg objects property configurators in the Pm.EvalMacro method (but also in other methods) can be used the macro expression.

The macro expression for example allows to enter a text expression into the configurator, that is "evaluated" after starting the application. For example this macro expression can be used for:

- refering to the localised text in the XML file (Macro expression $.text)
- refering to the value in an INI file (Macro expression $.cfgfile)
- create a complex evaluation of multiple macros, etc.

The macro expression is always evaluated just once, at application launch, when opening a panel or when calling a method (based on logic of placing) respectively. Therefore it is not possible to assume the macro as a data binding!

For all configurators or methods with possible macro expression entry, this possibility is allways explicitly stated in the description (see "PmgString > Text" configurator). There is also the information about the the macro expression evaluation sequence - in most cases:

- The macro expression in the Pma object configurator is evaluated after starting the application.
- The macro expression in the Pmg object configurator is evaluated while the panel is opening.
- The macro expression in the method parameter is evaluated when the method is called.
List of macro expressions:
$.text: Represents the string read from a text file.
$.par: Reference to Pma object or Pmg object parameter
$.cfgfile: Represents the value stored in the configuration file.
$.join: Represents a string value composed of all parameters of current expression.
$.expr: Evaluates an expression written in JavaScript syntax.
$.path: Represents the full path to the folder or file.
$const: (obsolete) Represents the string quoted directly from current macro expression.
$vb: (obsolete) Represents the result of the specified VBScript expression evaluation.
See also:

Pm8.03.00: In those configurators where macro expressions can be entered, there is a new button on the left (similar to data binding button) that can be used for composing a macro expression by configuration.
PROMOTIC 9.0.4 SCADA system documentation - MICROSYS, spol. s r.o.

Send page remarkContact responsible person
- Macro expression
- $vb
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice