Utiliser des rubriques personnalisées pour la communication - IoT Platform

Une catégorie de rubrique personnalisée couvre les rubriques de tous les appareils d'un produit. Cette rubrique explique comment définir une catégorie de rubrique personnalisée pour un produit et comment utiliser des rubriques personnalisées pour la communication.

Informations générales

Pour plus d'informations sur la définition et l'utilisation des rubriques, consultez la section Qu'est-ce qu'une rubrique ?.

Ajouter une catégorie de rubrique personnalisée

Connectez-vous à la console IoT Platform .
Sur la page Overview, recherchez l'instance à gérer et cliquez sur son ID ou son nom.
Dans le volet de navigation de gauche, choisissez Devices > Products.
Sur la page Products, recherchez le produit auquel vous souhaitez ajouter une catégorie de rubrique personnalisée, puis cliquez sur View.
Sur la page Product Details, choisissez Topic Categories > Topic Category > Edit Topic Category.

Dans la boîte de dialogue Edit Topic Category, configurez les paramètres, puis cliquez sur OK. Le tableau suivant décrit les paramètres.

Parameter	Description
Device Operation Authorizations	L'autorisation de l'appareil sur la catégorie de rubrique. Valeurs valides : Publish, Subscribe et Publish and Subscribe.
Topic Category	Une catégorie de rubrique se compose de plusieurs champs. Séparez les champs par des barres obliques (`/`). Le nom peut contenir des lettres, des chiffres et des traits de soulignement (_). Chaque champ de la catégorie de rubrique ne doit pas être vide. Si vous utilisez un produit de passerelle cloud, aucun préfixe n'est spécifié automatiquement. Vous devez spécifier une valeur personnalisée pour le paramètre. La valeur peut contenir des caractères génériques, y compris des signes plus (`+`) et des dièses (`#`). Vous pouvez utiliser la variable `${deviceName}` pour spécifier un DeviceName. Si vous utilisez un produit autre qu'une passerelle cloud, tenez compte des éléments suivants : Si vous définissez le paramètre Device Operation Authorizations d'une catégorie de rubrique sur Subscribe, vous pouvez spécifier les caractères génériques signe plus (`+`) et dièse (`#`) dans la catégorie de rubrique pour permettre aux appareils de s'abonner à plusieurs rubriques simultanément. `/${productKey}/${deviceName}/user/` est spécifié automatiquement comme préfixe de la valeur du paramètre. Vous devez uniquement spécifier un nom personnalisé pour la catégorie de rubrique. Remarque Pour plus d'informations sur l'utilisation des caractères génériques, voir la section Rubriques personnalisées avec caractères génériques.
Enable Delegated Subscription	Ce paramètre est disponible uniquement si vous définissez le paramètre Device Operation Authorizations sur Subscribe ou Publish and Subscribe. Si l'abonnement délégué est activé, IoT Platform aide les appareils à finaliser leurs abonnements lorsque les appareils du produit se connectent à IoT Platform.
Enable Compression or Decompression	Vous pouvez activer la compression et la décompression des données pour les rubriques personnalisées des instances Exclusive Enterprise Edition. Pour plus d'informations sur cette fonctionnalité, consultez la section Compression des données.
Description	La description de la catégorie de rubrique. Vous pouvez configurer ce paramètre pour distinguer les fonctionnalités des différentes catégories de rubriques.

Gérer les catégories de rubriques

Sur l'onglet Topic Category, recherchez une catégorie de rubrique personnalisée. Plusieurs opérations sont possibles sur la catégorie de rubrique. Le tableau suivant les décrit.

Operation	Procedure
Modifier une catégorie de rubrique	Cliquez sur Edit dans la colonne Actions. Dans la boîte de dialogue Edit Topic Category, modifiez les paramètres Device Operation Authorizations, Topic Category et Description. Dans le message qui s'affiche, cliquez sur OK.
Supprimer une catégorie de rubrique	Avertissement Après avoir supprimé une catégorie de rubrique personnalisée, les services de communication associés à cette catégorie deviennent indisponibles. Cela peut interrompre votre activité. Procédez avec prudence. Cliquez sur Delete dans la colonne Actions. Dans le message qui s'affiche, cliquez sur OK.
Spécifier s'il faut activer l'abonnement délégué	Recherchez une catégorie de rubrique dont le paramètre Device Operation Authorizations est défini sur Subscribe ou Publish and Subscribe, puis désactivez ou activez Enable Delegated Subscription.

Rubriques personnalisées avec caractères génériques

Le tableau suivant décrit les caractères génériques utilisables lors de la configuration d'une catégorie de rubrique personnalisée dans la console IoT Platform.

Remarque

Une rubrique qui inclut un ou plusieurs caractères génériques représente un ensemble de rubriques. Si vous accordez l'autorisation Publish ou Subscribe sur la rubrique et qu'un appareil s'y abonne, vous ne pouvez pas utiliser cette rubrique pour envoyer des messages.

Sur l'onglet Topic List de la page des détails de l'appareil, l'action Publish Message n'est pas disponible pour la rubrique. Vous ne pouvez pas envoyer de messages à l'appareil via cette rubrique.

Wildcard character

Description

Ce caractère générique doit être spécifié pour le dernier champ d'une rubrique et peut correspondre à toutes les valeurs de champ au niveau actuel et aux sous-niveaux.

Par exemple, vous créez la catégorie de rubrique /a1aycMA****/${deviceName}/user/#. Si l'appareil 1 s'abonne à la rubrique /a1aycMA****/device1/user/#, il s'abonne à toutes les rubriques commençant par /a1aycMA****/device1/user/, y compris /a1aycMA****/device1/user/update et /a1aycMA****/device1/user/update/error.

Ce caractère générique peut correspondre à toutes les valeurs de champ au niveau actuel.

Par exemple, vous créez la catégorie de rubrique /a1aycMA****/${deviceName}/user/+/error. Si l'appareil 1 s'abonne à la rubrique /a1aycMA****/device1/user/+/error, il s'abonne à plusieurs rubriques, telles que /a1aycMA****/device1/user/get/error et /a1aycMA****/device1/user/update/error.

Communication basée sur des rubriques personnalisées

D'IoT Platform vers les appareils

IoT Platform appelle l'opération API Pub pour publier des messages sur une rubrique. Les appareils reçoivent les messages d'IoT Platform en s'abonnant à la rubrique.
Des appareils vers IoT Platform

Un appareil publie des messages sur une rubrique personnalisée. IoT Platform peut recevoir les messages de l'appareil via un abonnement côté serveur AMQP (Advanced Message Queuing Protocol) ou la fonctionnalité de transfert de données.

Pour plus d'informations sur l'utilisation des rubriques personnalisées, consultez la section Utiliser des rubriques personnalisées pour la communication.