Actions sur Réception de Message
Une fois qu’une solution a été abonnée à un chapitre auprès d’un broker, elle recevra des messages publiés par un broker sous ce chapitre. Les données de message (du dernier message reçu) seront placées dans la source de page $MT_MQTT et peuvent être accédées de là. Les actions à réaliser quand un message est reçu sont définies sur deux niveaux supérieurs : (I) un événement au niveau de la page pour chaque page, et (ii) un événement au niveau de la solution (ou du projet) (accédés via la section des Propriétés de projet du volet de Styles & Propriétés). Si aucune gestion d’événement n’est définie au niveau de l’événement de la page de la page active, alors les actions de l’événement au niveau du projet seront exécutées.
Dans ce chapitre, nous décrivons la chose suivante :
•La source de page $MT_MQTT
•Les événements, sur chaque page et niveau de solution, qui sont déclenchés quand un message est reçu.
source de page $MT_MQTT
La source de page $MT_MQTT a la structure fixée suivante :
$MT_MQTT
Root
|-- Message
| @topic
| @content
Au moment de la marche, si une solution a été abonnée à un chapitre auprès d’un broker, alors la solution recevra des messages publiés par un broker sous ce chapitre. Le nombre de répétitions de messages obtenu par la solution est déterminé par le niveau de la Qualité de Service spécifiée dans l’abonnement.
Le dernier message obtenu sera placé dans la source de page $MT_MQTT, avec le corps du message allant dans le nœud $MT_MQTT/Root/Message/@content et le nom du chapitre allant dans le nœud $MT_MQTT/Root/Message/@topic. Les données de message dans la source de page seront désormais accessibles à la solution et peuvent être utilisées pour le traitement de données.
| Note : | Le contenu de chaque message reçu est automatiquement converti par MobileTogether en un string hexBinary et stocké dans ce format dans le nœud $MT_MQTT/Root/Message/@content. Afin de convertir le string hexBinary en un string de texte, utilisez mt-hexBinary-to-string. MobileTogether fournit deux fonctions pour les convertir entre des strings hexBinary et strings de texte : mt-hexBinary-to-string et mt-string-to-hexBinary. |
Événements déclenchés quand un message est reçu
Quand une solution obtient un message, l’événement SurObtentionMQTT est déclenché. Vous pouvez préciser quelles actions doivent être exécutées quand cet événement est déclenché.
•Si des actions d’événement SurObtentionMQTT ont été définies au niveau de la page, alors ces actions sont exécutées quand cette source est active et reçoit un message.
•Si aucune action d’événement SurObtentionMQTT n’a été définie au niveau de la page, alors aucune action SurObtentionMQTT définie au niveau du projet ne sera exécutée.
Ce mécanisme vous permet de définir les actions au niveau du projet, qui peuvent être déclenchées pour chaque page active qui n’a pas ses actions d’événement au niveau de sa propre page OnMQTTReceive.