Modulo di notifica SMS "sms"

Descrizione

Il modulo di notifica SMS serve a notificare ovvero ad allertare l'utente quando si verifica un determinato stato del sistema. Lo stato del sistema può essere configurato a piacere come canale di ingresso booleano. Inoltre è possibile definire liberamente il testo della notifica. Se nell'ambito di una tale notifica vengono trasmesse anche informazioni sulla posizione GPS, è inoltre possibile collegarle a un servizio di mappe (ad es. Google Maps, Open Street Map, ...).

Funzionamento relativo alla riconfigurazione dinamica del numero di telefono

Dopo l'avvio il modulo carica dapprima il numero di telefono memorizzato come parametro di configurazione phoneNumber. Quindi, nell'intervallo di interrogazione specificato (vedere sotto), consuma il canale definito in setPhoneNumberChannelName, tramite il quale è possibile riconfigurare il numero di telefono (ad es. tramite un canale shared attribute del modulo dashboard optiCLOUD). Successivamente il numero di telefono attualmente impostato viene prodotto nel canale definito in phoneNumberChannelName.

Interfacce e protocolli utilizzati

• modem per rete mobile pronto all'uso e supportato

Configurazione JSON

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

Configurazione di esempio (configurazione tipica)

    {
      "module":"SMS",
      "factory":"sms",
      "config":{
        "pollingIntervalMs": 1000,
        "triggerChannel": "SomeBooleanConditionChannel",
        "phoneNumber": "+4961729977120",
        "phoneNumberChannelName": "PhoneNumberChannel_for_Display",
        "setPhoneNumberChannelName": "PhoneNumberChannel_for_Entry",
        "message": "Some Message Text (see below)"
      }
    }

Parametri globali del modulo

Nome del parametro	Obbligatorio	Tipo di dati	Intervallo di valori consigliato	Valore di default	Descrizione
pollingIntervalMs	No	INT	1 -	1000 (1 s)	Intervallo di interrogazione [ms]
triggerChannel	SÌ	STRING			Nome del canale booleano che fornisce la condizione di notifica
phoneNumber	SÌ	STRING	numero di telefono valido		Numero di telefono valido a cui viene inviato l'SMS
phoneNumberChannelName	No	STRING	nome di canale valido	MODULE.phoneNumber	Nome del canale per la produzione ovvero la visualizzazione del numero di telefono
setPhoneNumberChannelName	No	STRING	nome di canale valido	MODULE.setPhoneNumber	Nome del canale per il consumo ovvero l'inserimento del numero di telefono
message	No	STRING			Testo della notifica (vedere sotto)

Configurazione di un testo di notifica "message"

Il testo della notifica può contenere in linea di principio caratteri qualsiasi, purché compatibili con gli SMS. Inoltre nel testo possono essere integrati anche i valori di uno o più canali. A tale scopo sono disponibili le seguenti possibilità

• Valore del canale formattato automaticamente ${Kanalname}

• Valore del canale formattato secondo una specifica di formato ${Kanalname}{Format}

Tra le specifiche di formato supportate rientrano, nel caso di canali di dati numerici, la maggior parte di quelle note dal linguaggio di programmazione C, come ad es. ${Kanalname}{%04.3f}, nonché, in funzione del tipo di dati, ulteriori specifiche interne al modulo sotto forma di stringa, come ad es. ${Kanalname}{base64} oppure ${Kanalname}{openstreetmap}.

Specificatori di formato per GPS Location e ByteArray

Nel caso di un canale GPS Location possono essere utilizzati i seguenti specificatori di formato

• google per inserire un collegamento ipertestuale a Google Maps
• openstreetmap per inserire un collegamento ipertestuale a Open Street Map

Per i canali ByteArray può essere definita facoltativamente una codifica base64; in caso contrario il ByteArray viene trasmesso codificato in esadecimale.

Informazioni sul modulo

Informazione	Valore
Autori	optiMEAS GmbH
da smartCORE	2.4
Tipo di modulo	Consumer
Dipendenze	NESSUNA