Modulo di allarme SMS "smsalarms"

Descrizione

Il modulo "smsalarms" consente di inviare tramite SMS, in forma elaborata, i nuovi allarmi provenienti dalla centrale allarmi.

Interfacce e protocolli utilizzati

• meccanismi interni di allarme di smartCORE

Configurazione JSON

La sezione seguente descrive l'intera configurazione JSON del modulo e illustra i singoli parametri.

Configurazioni di esempio (minime)

{
  "module":"smsalarms",
  "factory":"smsalarms",
  "config":{
    "phoneNumber": "+49800762782673",
    "messageContains": "some.*RegularExpressionMatchingAlarmMessage"
  }
}

{
  "module":"smsalarms",
  "factory":"smsalarms",
  "config":{
    "phoneNumber": "+49800762782673",
    "contextContains": "some.*RegularExpressionMatchingAlarmContext"
  }
}

Configurazione di esempio (massima)

{
  "module":"smsalarms",
  "factory":"smsalarms",
  "config":{
    "pollingIntervalMs": 1000,
    "phoneNumber": "+49800762782673",
    "phoneNumberChannelName": "SomeChannelShowingPhoneNumber",
    "setPhoneNumberChannelName": "SomeChannelForSettingTheNumber",
    "contextContains": "some.*RegularExpressionMatchingAlarmContext",
    "messageContains": "some.*RegularExpressionMatchingAlarmMessage",
    "message": "Some message text",
    "level": "alarm"
  }
}

Parametri globali del modulo

Nome del parametro	Obbligatorio	Tipo di dati	Intervallo di valori consigliato	Default	Descrizione
pollingIntervalMs	No	INT	1000 -	1000	Intervallo di elaborazione [ms]
phoneNumber	SÌ	STRING			Numero di telefono del destinatario dell'SMS
phoneNumberChannelName	No	STRING		MODULNAME.phoneNumber	Canale per fornire il numero di telefono attualmente impostato
setPhoneNumberChannelName	No	STRING		MODULNAME.setPhoneNumber	Canale per impostare il numero di telefono corrente
contextContains	SÌ (*)	STRING			Espressione regolare che seleziona un messaggio di allarme con il contesto corrispondente
messageContains	SÌ (*)	STRING			Espressione regolare che seleziona un messaggio di allarme con il messaggio corrispondente
message	No	STRING		Messaggio del messaggio di allarme	Testo della notifica SMS (vedere sotto)
level	No	STRING			Livello di gravità dell'allarme ("none", "info", "action", "service", "warning", "alarm", "error", "fatal")

(*) alternativamente o entrambi

Configurazione della notifica SMS "message"

Il messaggio SMS può contenere i seguenti componenti

• testo
• contesto dell'allarme, espresso dalla variabile ${AlarmContext}
• messaggio dell'allarme, espresso dalla variabile ${AlarmMessage}
• valori non formattati di canali qualsiasi (${someChannel})
• valori formattati di canali qualsiasi con la sintassi di printf, come ad es. ${someChannel}{%.2d}
• indicazioni di posizione (posizioni GPS), come ad es. ${GPS.Location}
• indicazioni di posizione con collegamento a un servizio di mappe, come ${GPS.Location}{google} oppure ${GPS.Location}{openstreetmap}

Inoltre sia il contesto dell'allarme sia il messaggio dell'allarme possono essere pre-elaborati testualmente mediante stream editing, con possibilità di retroriferimento, come ad es.

${AlarmMessage}{s/hello/world/}

Informazioni sul modulo

Informazione	Valore
Autori	optiMEAS GmbH
da smartCORE	2.8
Tipo di modulo	Consumer/Producer
Dipendenze	NESSUNA