Módulo de notificación por SMS "sms"

Descripción

El módulo de notificación por SMS sirve para notificar o alertar al usuario cuando se da un estado del sistema determinado. El estado del sistema puede configurarse aquí libremente como canal de entrada booleano. Además, es posible definir con flexibilidad el texto de la notificación. Si en el marco de una notificación de este tipo se transmiten también datos de posición GPS, es posible además vincularlos con un servicio de mapas (p. ej., Google Maps, Open Street Map, ...).

Funcionamiento en relación con la reconfiguración dinámica del número de teléfono

Tras el inicio, el módulo carga en primer lugar el número de teléfono almacenado como parámetro de configuración phoneNumber. A continuación consume, en el intervalo de consulta especificado (véase más abajo), el canal definido en setPhoneNumberChannelName, a través del cual es posible reconfigurar el número de teléfono (p. ej., mediante un canal de Shared Attribute del módulo de dashboard optiCLOUD). Después se produce el número de teléfono establecido actualmente en el canal definido en phoneNumberChannelName.

Interfaces y protocolos utilizados

• Módem de telefonía móvil operativo y compatible

Configuración JSON

En la sección siguiente se describe la configuración JSON completa del módulo y se explican los distintos parámetros.

Configuración de ejemplo (configuración habitual)

    {
      "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)"
      }
    }

Parámetros globales del módulo

Nombre del parámetro	Obligatorio	Tipo de datos	Rango de valores razonable	Valor por defecto	Descripción
pollingIntervalMs	No	INT	1 -	1000 (1 s)	Intervalo de consulta [ms]
triggerChannel	SÍ	STRING			Nombre del canal booleano que proporciona la condición de notificación
phoneNumber	SÍ	STRING	número de teléfono válido		Número de teléfono válido al que se envía el SMS
phoneNumberChannelName	No	STRING	nombre de canal válido	MODULE.phoneNumber	Nombre del canal para producir o mostrar el número de teléfono
setPhoneNumberChannelName	No	STRING	nombre de canal válido	MODULE.setPhoneNumber	Nombre del canal para consumir o introducir el número de teléfono
message	No	STRING			Texto de la notificación (véase más abajo)

Configuración de un texto de notificación "message"

El texto de la notificación puede contener, en principio, cualquier carácter, siempre que sea compatible con SMS. Además, en este texto pueden integrarse valores de uno o varios canales. Para ello existen las siguientes posibilidades

• Valor de canal con formato automático ${Kanalname}

• Valor de canal formateado según una especificación de formato ${Kanalname}{Format}

Entre las especificaciones de formato admitidas se cuentan, en el caso de canales de datos numéricos, la mayoría de las conocidas del lenguaje de programación C, como p. ej. ${Kanalname}{%04.3f}, así como, según el tipo de datos, especificaciones adicionales internas del módulo en forma de cadena, como p. ej. ${Kanalname}{base64} o ${Kanalname}{openstreetmap}.

Especificadores de formato para GPS Locations y ByteArrays

En el caso de un canal GPS Location pueden utilizarse los siguientes especificadores de formato

• google para insertar un hipervínculo a Google Maps
• openstreetmap para insertar un hipervínculo a Open Street Map

Para los canales ByteArray puede definirse opcionalmente una codificación base64; de lo contrario, el ByteArray se transmite codificado en hexadecimal.

Información del módulo

Información	Valor
Autores	optiMEAS GmbH
desde smartCORE	2.4
Tipo de módulo	Consumer
Dependencias	NINGUNA