Tutoriel : Republication d'un message MQTT

Ouvrez le hub de règles de la AWS IoT console.

Dans Règles, choisissez Créer et commencez à créer votre nouvelle règle.

Dans la partie supérieure de Créer une règle :

1. Dans Nom, entrez le nom de la règle. Pour ce didacticiel, nommez le republish_temp.

   N'oubliez pas qu'un nom de règle doit être unique au sein de votre compte et de votre région, et qu'il ne doit pas comporter d'espaces. Nous avons utilisé un trait de soulignement dans ce nom pour séparer les deux mots du nom de la règle.

2. Dans Description, décrivez la règle.

   Une description significative vous permet de vous souvenir du rôle de cette règle et de la raison pour laquelle vous l'avez créée. La description peut être aussi longue que nécessaire, donc soyez aussi détaillée que possible.

Dans l'déclararionde requête règle de Create a rule :

1. Dans Utiliser la version SQL, sélectionnez 2016-03-23.

2. Dans la zone d'édition de la instruction de requête de règle, entrez l'instruction :

   SELECT topic(2) as device_id, temperature FROM 'device/+/data'

   Cette instruction :

   • Écoute les messages MQTT dont le objet correspond au filtre de device/+/data objet.

   • Sélectionne le deuxième élément dans la chaîne de l'objet et l'affecte au device_id champ.

   • Sélectionne le temperature champ de valeur dans la charge utile du message et l'affecte au temperature champ.

Dans Définir une ou plusieurs actions :

1. Pour ouvrir la liste des actions de règle pour cette règle, choisissez Ajouter une action.

2. Dans Sélectionner une action, choisissez Republier un message dans un AWS IoT sujet.

3. Au bas de la liste d'actions, choisissez Configurer l'action pour ouvrir la page de configuration de l'action sélectionnée.

Sous Configurer les actions :

1. Dans Sujet, entrez device/data/temp. Il s'agit de l'objet MQTT du message que cette règle publiera.

2. Dans Qualité de service, choisissez 0 - Le message est délivré zéro fois ou plus.

3. Dans Choisir ou créer un rôle pour accorder AWS IoT l'accès pour effectuer cette action :

   1. Choisissez Create Role (Créer un rôle). La boîte de dialogue Créer un rôle s'ouvre.

   2. Saisissez un nom qui décrit le nouveau rôle. Dans le cadre de ce tutoriel, utilisez republish_role.

      Lorsque vous créez un nouveau rôle, les politiques appropriées pour exécuter l'action de la règle sont créées et associées au nouveau rôle. Si vous modifiez le objet de cette action de règle ou si vous utilisez ce rôle dans une autre action de règle, vous devez mettre à jour la politique de ce rôle afin d'autoriser le nouveau objet ou la nouvelle action. Pour mettre à jour un rôle existant, choisissez Mettre à jour le rôle dans cette section.

   3. Choisissez Create Role pour créer le rôle et fermer la boîte de dialogue.

4. Choisissez Ajouter une action pour ajouter l'action à la règle et revenez à la page Créer une règle.

L'action Republier un message dans un AWS IoT sujet est désormais répertoriée dans Définir une ou plusieurs actions.

Dans la vignette de la nouvelle action, sous Republier un message dans un AWS IoT objet, vous pouvez voir le objet dans lequel votre action de republication sera publiée.

Il s'agit de la seule action de règle que vous ajouterez à cette règle.

Dans Créer une règle, faites défiler l'écran vers le bas et choisissez Créer une règle pour créer la règle et terminer cette étape.

Dans le client MQTT de la AWS IoT console, abonnez-vous aux rubriques d'entrée, dans ce cas, device/+/data.

1. Dans le client MQTT, sous Souscriptions, choisissez Publish to topic.

2. Dans Sujet d'abonnement, entrez le objet du filtre de objet d'entrée,device/+/data.

3. Conservez les valeurs par défaut des autres paramètres.

4. Choisissez Subscribe to topic (S'abonner à la rubrique).

   Dans la colonne Abonnements, la section Publier dans un objet device/+/data apparaît.

Abonnez-vous à l’objet que votre règle publiera :device/data/temp.

1. Sous Abonnements, choisissez S’abonner à un objet nouveau, puis dans Sujet d'abonnement, entrez l’objet du message republié,device/data/temp.

2. Conservez les paramètres par défaut du reste des champs

3. Choisissez Subscribe to topic (S'abonner à la rubrique).

   Dans la colonne Abonnements, la section appareil/+/data, device/data/temp apparaît.

Publiez un message sur le objet d'entrée avec un identifiant d'appareil spécifique, device/22/data. Vous ne pouvez pas publier au format MQTT des objets contenant des caractères génériques.

1. Dans le client MQTT, sous Souscriptions, choisissez Publier dans la rubrique.

2. Dans le champ Publier, entrez le nom de l'objet d'entrée, device/22/data.

3. Copiez les exemples de données présentés ici et, dans la zone d'édition située sous le nom de l'objet, collez les exemples de données.

   {
     "temperature": 28,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

4. Pour envoyer votre message MQTT, choisissez Publier dans le objet.

Passez en revue les messages qui ont été envoyés.

1. Dans le client MQTT, sous Abonnements, il y a un point vert à côté des deux objets auxquels vous vous êtes abonné précédemment.

   Les points verts indiquent qu'un ou plusieurs nouveaux messages ont été reçus depuis la dernière fois que vous les avez consultés.

2. Sous Abonnements, choisissez device/+/data pour vérifier que la charge utile du message correspond à ce que vous venez de publier et ressemble à ceci :

   {
     "temperature": 28,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

3. Sous Abonnements, choisissez device/data/temp pour vérifier que la charge utile de votre message republié ressemble à ceci :

   {
     "device_id": "22",  
     "temperature": 28
   }

   Notez que la device_id valeur est une chaîne entre guillemets et que la temperature valeur est numérique. Cela est dû au fait que la topic() fonction a extrait la chaîne du nom de l'objet du message d'entrée tandis que la temperature valeur utilise la valeur numérique de la charge utile du message d'entrée.

   Si vous souhaitez transformer la device_id valeur en valeur numérique, remplacez-la topic(2) dans l'déclararionde requête de règle par :

   cast(topic(2) AS DECIMAL)

   Notez que la conversion de la topic(2) valeur en valeur numérique ne fonctionnera que si cette partie de la rubrique contient uniquement des caractères numériques.

Si vous constatez que le message correct a été publié dans la rubrique device/data/temp, votre règle a fonctionné. Découvrez les informations supplémentaires que vous pouvez obtenir sur l'action Republier la règle dans la section suivante.

Si vous ne voyez pas que le message correct a été publié dans les rubriques device/+/data ou device/data/temp, consultez les conseils de dépannage.