Una categoría de tema personalizado abarca los temas de todos los dispositivos de un producto. Este documento describe cómo definir una categoría de tema personalizado para un producto y cómo utilizar temas personalizados para la comunicación.
Contexto
Para obtener información sobre cómo definir y usar temas, consulte What is a topic.
Agregar una categoría de tema personalizado
Inicie sesión en la IoT Platform console.
En la página Overview, busque la instancia que desea gestionar y haga clic en el ID o el nombre de la instancia.
En el panel de navegación izquierdo, elija .
En la página Products, busque el producto al que desea agregar una categoría de tema personalizado y haga clic en View.
En la página Product Details, elija .
-
En el cuadro de diálogo Edit Topic Category, configure los parámetros y haga clic en OK. La siguiente tabla describe los parámetros.
Parámetro
Descripción
Device Operation Authorizations
Permiso del dispositivo sobre la categoría de tema. Valores válidos: Publish, Subscribe y Publish and Subscribe.
Topic Category
Una categoría de tema consta de varios campos. Separe los campos con barras diagonales (
/). El nombre puede contener letras, dígitos y guiones bajos (_). Ningún campo de la categoría de tema puede estar vacío.Si usa un producto de puerta de enlace en la nube, no se especifica ningún prefijo automáticamente. Debe especificar un valor personalizado para el parámetro. El valor puede contener caracteres comodín, incluidos signos más (
+) y signos de número (#). Puede usar la variable${deviceName}para especificar un DeviceName.Si usa un producto que no es de puerta de enlace en la nube, tenga en cuenta lo siguiente:
Si establece el parámetro Device Operation Authorizations de una categoría de tema en Subscribe, puede especificar los caracteres comodín de signo más (
+) y signo de número (#) en la categoría de tema para permitir que los dispositivos se suscriban a varios temas simultáneamente./${productKey}/${deviceName}/user/se especifica automáticamente como prefijo del valor del parámetro. Solo necesita especificar un nombre personalizado para la categoría de tema.
NotaPara obtener más información sobre cómo usar caracteres comodín, consulte Custom topics with wildcard characters.
Enable Delegated Subscription
Este parámetro solo está disponible si establece el parámetro Device Operation Authorizations en Subscribe o Publish and Subscribe.
Si la suscripción delegada está habilitada, IoT Platform ayuda a los dispositivos a completar las suscripciones cuando se conectan a IoT Platform.
Enable Compression or Decompression
Puede habilitar la compresión y descompresión de datos para temas personalizados de instancias Exclusive Enterprise Edition. Para obtener más información sobre esta función, consulte Data compression.
Description
Descripción de la categoría de tema. Configure este parámetro para distinguir las funciones de diferentes categorías de temas.
Gestionar categorías de temas
En la pestaña Topic Category, busque una categoría de tema personalizado. Puede realizar varias operaciones en la categoría de tema. La siguiente tabla describe dichas operaciones.
Operación | Procedimiento |
Modificar una categoría de tema |
|
Eliminar una categoría de tema | Aviso Después de eliminar una categoría de tema personalizado, los servicios de comunicación relacionados con dicha categoría dejan de estar disponibles. Esto podría interrumpir su negocio. Proceda con precaución.
|
Especificar si se habilita la suscripción delegada | Busque una categoría de tema cuyo parámetro Device Operation Authorizations esté establecido en Subscribe o Publish and Subscribe y desactive |
o active 
Enable Delegated Subscription. Temas personalizados con caracteres comodín
La siguiente tabla describe los caracteres comodín que puede usar al configurar una categoría de tema personalizado en la consola de IoT Platform.
Un tema que incluye uno o más caracteres comodín representa un conjunto de temas. Si otorga el permiso Publish o Subscribe sobre el tema y un dispositivo se suscribe a él, no podrá usar ese tema para enviar mensajes.
En la pestaña Topic List de la página de detalles del dispositivo, la acción Publish Message no está disponible para el tema. No puede enviar mensajes al dispositivo mediante dicho tema.
|
Carácter comodín |
Descripción |
|
# |
Este carácter comodín debe especificarse en el último campo de un tema y puede coincidir con todos los valores de campo en el nivel actual y los subniveles. Por ejemplo, si crea la categoría de tema |
|
+ |
Este carácter comodín puede coincidir con todos los valores de campo en el nivel actual. Por ejemplo, si crea la categoría de tema |
Comunicación basada en temas personalizados
-
De IoT Platform a dispositivos
IoT Platform llama a la operación de API Pub para publicar mensajes en un tema. Los dispositivos reciben mensajes de IoT Platform al suscribirse al tema.
-
De dispositivos a IoT Platform
Un dispositivo publica mensajes en un tema personalizado. IoT Platform puede recibir mensajes del dispositivo mediante una suscripción del lado del servidor de Advanced Message Queuing Protocol (AMQP) o la función de reenvío de datos.
Para obtener más información sobre cómo usar temas personalizados, consulte Use custom topics for communication.