Online Help icom Data Suite

Inserting values in messages

Current values of data points (e.g. I/O conditions, Modbus registers, flags, timers) can be inserted with the following syntax

  • as SMS message (max. 140 characters)
  • into the topic and message text of an e-mail
  • into the text of a server feed of the type Alarm or Event
  • into the topic and message text of an MQTT message

:

$<data point>
The following applies here:
<data point>The exact name as it is assigned automatically by the icom Data Suite when entering the data point. If no blank can follow the name of the data point in the message text, the name of the data point must be placed in brackets.

Furthermore, the following variables are available for actual values:

  • $TIME for the system time (format: hh:mm:ss 'time zone', e.g. 18:01:06 CEST)
  • $TIMESTAMP for the system time in seconds since the epoch (01.01.1970) in UTC (e.g. 1062244800)
  • $TIMESTAMP_ISO8601 or the timestamp of the system as per ISO 8601 (e.g. 2016-01-10T13:07:23+0100)
  • $DATE for the system date (format: 'weekday' 'month' 'day' 'year', e.g. Tue May 23 2017)
  • $UPTIME for the system run-time (format: h(hh):mm:ss, e.g. 12:13:07)
  • $LOCATION for the location of the router (as configured in the router under Administration -> Hostnames)
  • $SERIALNUMBER for the serial number of the router
  • $PROFILEHASH for the hash of the running profile

All variables are case-sensitive.

Examples for a message text with variables (it is prerequisite that respective data points with these names (e.g. "IN_1" or "OUT 2") have been created first):

  • Input 1 (name of the data point “input1”) has the decimal value $input1
  • Output 2 (output2) has the binary value $(output2)

In order to be able to use the symbol "$" in a message text, $$ needs to be inserted into the message text since a single Dollar symbol will be interpreted as an escape sequence for a current value.

Back to overview