Module de notification SMS « sms »

Description

Le module de notification SMS sert à notifier ou à alerter l'utilisateur lorsqu'un état système correspondant est présent. L'état système peut ici être configuré à volonté sous forme de canal d'entrée booléen. Il est en outre possible de définir librement le texte de la notification. Si des indications de position GPS sont également transmises dans le cadre d'une telle notification, il est de plus possible de les relier à un service cartographique (p. ex. Google Maps, Open Street Map, ...).

Fonctionnement concernant la reconfiguration dynamique du numéro de téléphone

Après le démarrage, le module charge d'abord le numéro de téléphone enregistré comme paramètre de configuration phoneNumber. Il consomme ensuite, à l'intervalle d'interrogation spécifié (voir ci-dessous), le canal défini sous setPhoneNumberChannelName, par lequel une reconfiguration du numéro de téléphone est possible (p. ex. à l'aide d'un canal Shared Attribute issu du module dashboard optiCLOUD). Le numéro de téléphone actuellement défini est ensuite produit dans le canal défini sous phoneNumberChannelName.

Interfaces et protocoles utilisés

• Modem de téléphonie mobile opérationnel et pris en charge

Configuration JSON

La section suivante décrit l'intégralité de la configuration JSON du module et explique chacun des paramètres.

Exemple de configuration (configuration typique)

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

Paramètres globaux du module

Nom du paramètre	Obligatoire	Type de données	Plage de valeurs utile	Valeur par défaut	Description
pollingIntervalMs	Non	INT	1 -	1000 (1 s)	Intervalle d'interrogation [ms]
triggerChannel	OUI	STRING			Nom du canal booléen qui fournit la condition de notification
phoneNumber	OUI	STRING	numéro de téléphone valide		Numéro de téléphone valide auquel le SMS est envoyé
phoneNumberChannelName	Non	STRING	nom de canal valide	MODULE.phoneNumber	Nom de canal pour la production ou l'affichage du numéro de téléphone
setPhoneNumberChannelName	Non	STRING	nom de canal valide	MODULE.setPhoneNumber	Nom de canal pour la consommation ou la saisie du numéro de téléphone
message	Non	STRING			Texte de notification (voir ci-dessous)

Configuration d'un texte de notification « message »

Le texte de notification peut en principe contenir des caractères quelconques, compatibles SMS toutefois. Les valeurs d'un ou de plusieurs canaux peuvent en outre être intégrées à ce texte. Les possibilités suivantes existent à cet effet

• Valeur de canal formatée automatiquement ${Kanalname}

• Valeur de canal formatée selon une spécification de format ${Kanalname}{Format}

Parmi les spécifications de format prises en charge figurent, pour les canaux de données numériques, la plupart des spécifications connues du langage de programmation C, comme p. ex. ${Kanalname}{%04.3f}, ainsi que, selon le type de données, des spécifications internes supplémentaires du module sous forme de chaîne, comme p. ex. ${Kanalname}{base64} ou ${Kanalname}{openstreetmap}.

Spécificateurs de format pour les GPS Locations et les ByteArrays

Dans le cas d'un canal GPS Location, les spécificateurs de format suivants peuvent être utilisés

• google pour insérer un lien hypertexte vers Google Maps
• openstreetmap pour insérer un lien hypertexte vers Open Street Map

Pour les canaux ByteArray, un encodage base64 peut être défini en option ; sinon, le ByteArray est transmis encodé en hexadécimal.

Informations sur le module

Information	Valeur
Auteurs	optiMEAS GmbH
depuis smartCORE	2.4
Type de module	Consumer
Dépendances	AUCUNE