Esquemas de modelos de datos

Las integraciones gestionadas admiten dos tipos de esquemas: capacidad y definición de tipos. Si va a crear un modelo de datos personalizado, utilice un documento de esquema JSON para definir cualquier tipo de esquema. Cada documento de esquema tiene un límite de 50 000 caracteres.

Esquema de capacidades

Una capacidad es un elemento fundamental que representa funcionalidades específicas dentro de un punto final. Con las capacidades, puede modelar los estados y comportamientos de los dispositivos mediante propiedades, acciones y eventos. Las propiedades le permiten modelar los atributos de estado del dispositivo de forma flexible con cualquier tipo de datos declarativos. Las acciones y los eventos modelan el comportamiento del dispositivo, incluidos los comandos que puede ejecutar y las señales que puede informar.

A continuación, se muestra una estructura de alto nivel de un esquema de capacidad.

Capability
  |
  |-- Action
  |-- Event      
  |-- Property

Acción

Entidad que representa una interacción con una capacidad de un dispositivo. Por ejemplo, toque el timbre o vea quién está en la puerta.

Evento

Una entidad que representa un evento desde una capacidad de un dispositivo. Un dispositivo puede enviar un evento para informar de un incidente, una alarma o una actividad desde un sensor, como un golpe a la puerta.

Propiedad

Entidad que representa un atributo concreto del estado del dispositivo. Por ejemplo, suena una campana o la luz del porche está encendida

Cada capacidad incluye un identificador de espacio de nombres único, información sobre la versión y una descripción de su propósito. El documento de esquema utiliza el control de versiones semántico para mantener la compatibilidad con versiones anteriores y, al mismo tiempo, habilitar nuevas funciones.

Para obtener más información, consulte Esquema para las definiciones de capacidades.

Esquema de definición de tipos

Una definición de tipo es un tipo de datos estructurados declarativos que permite la reutilización y la componibilidad. Define cómo se debe formatear y restringir la información. Utilice definiciones de tipos para crear formatos de datos estandarizados en toda su solución de IoT.

Cada definición de tipo incluye:

• Un identificador único con espacio de nombres

• Título

• Descripción

• Propiedades que definen el formato y las restricciones de los datos

Los tipos pueden ser primitivas simples, como números enteros o cadenas con límites definidos, o estructuras complejas, como enumeraciones u objetos personalizados con varios campos. Las definiciones de tipos utilizan la sintaxis del esquema JSON para especificar las restricciones, incluidos los valores mínimos y máximos, las longitudes de las cadenas y los patrones permitidos.

Para obtener más información, consulte Esquema para las definiciones de tipos.