Online-Hilfe icom Data Suite

Einfügen von Werten in Nachrichten

Aktuelle Werte von Datenpunkten (z.B. I/O-Zustände, Modbus-Register, Merker, Timer) können mit der nachfolgenden Syntax

  • als SMS-Nachricht (max. 140 Zeichen)
  • in den Betreff und Nachrichtentext einer E-Mail
  • in den Text eines Server-Feeds vom Typ Alarm oder Event
  • in den Topic und Nachrichtentext einer MQTT-Nachricht

eingefügt werden:

$<datenpunkt>
Wobei folgendes gilt:
<datenpunkt> Der genaue Name wie er beim Anlegen des Datenpunkts von der icom Data Suite automatisch vergeben wird. Kann im Nachrichtentext hinter dem Namen des Datenpunkts kein Leerzeichen folgen, ist der Name des Datenpunkts in Klammern zu setzen.

Weiter sind folgende feste Variablen für Aktualwerte verfügbar:

  • $TIME für die Uhrzeit des Systems (Format: hh:mm:ss 'Zeitzone', z.B. 18:01:06 CEST)
  • $TIMESTAMP für die Uhrzeit des Systems in Sekunden seit 01.01.1970 (Unix-Epoche) in UTC (z.B. 1062244800)
  • $TIMESTAMP_ISO8601 für den Zeitstempel des Systems nach ISO 8601 (z.B. 2016-01-10T13:07:23+0100)
  • $DATE für das Datum des Systems (Format: 'Wochentag' 'Monat' 'Tag' 'Jahr', z.B. Tue May 23 2017)
  • $UPTIME für die Laufzeit des Systems (Format: h(hh):mm:ss, z.B. 12:13:07)
  • $LOCATION für den Standort des Routers (wie im Router unter Administration -> Hostnamen eingestellt)
  • $SERIALNUMBER für die Seriennummer des Routers
  • $PROFILEHASH für den Hash des laufenden Profils

Bei allen Variablen wird Groß- und Kleinschreibung berücksichtigt.

Beispiele für einen Nachrichtentext mit Variablen (Voraussetzung ist, dass entsprechende Datenpunkte mit diesen Namen (z.B. "IN_1" oder "OUT 2") vorher angelegt wurden):

  • Eingang 1 (Name des Datenpunkts "input1") hat den dezimalen Wert $input1
  • Ausgang 2 ("output2") hat den binären Wert $(output2)

Um das Symbol "$" in einem Nachrichtentext verwenden zu können, muss $$ im Nachrichtentext eingegeben werden, da ein einzelnes Dollar-Symbol als Escape-Sequenz für einen Aktualwert interpretiert wird.

Zurück zur Übersicht