Promotic
WikipediaLinkedInYoutubeTwitterFacebook

PmNamedValues - saving format of named values

On many places in the PROMOTIC system it is necessary to enter multiple named values in a single text. The format described below can be used for this purpose.

The format is very similar to the syntax of CSS styles in HTML pages.

 
Syntax:
name1:value1;name2:value2; ...

For example: "Temperature:85;Pressure:1013.85;Power:56.5;"

 
- Name: Represents value identifier. This is a system name and must not contain empty string, diacritics, spaces and the first character must not be a number.
- Value: Follows after colon (:).
- If the value is a real number with decimal point then the decimal separator must be a period.
- The value may contain colon.
- The value must not contain:
- Char semicolon (;). Must be replaced by two characters: backslash and s ("\s")
- Char NewLine (0A hexa). Must be replaced by two characters: backslash and n ("\n")
- Char CarriageReturn (0D hexa). Must be replaced by two characters: backslash and r ("\r")
- Char backslash (\). Must be replaced by two characters: 2x backslash ("\\")

This format can be used e.g. for the following purposes:
- In the configurator PROMOTIC object parameters.
- In the method OpenView, in the entry sOptions or sParams.
- In the object PmMap, in methods mapSaveToString and mapLoadFromString.
- In the object PmAlarmEvent, in configurator Sound parameters.
- etc.
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice