Esquemas do modelo de dados

As integrações gerenciadas oferecem suporte a dois tipos de esquema: capacidade e definição de tipo. Se você estiver criando um modelo de dados personalizado, use um documento de esquema JSON para definir qualquer tipo de esquema. Cada documento de esquema tem um limite de 50.000 caracteres.

Esquema de capacidade

Um recurso é um alicerce fundamental que representa funcionalidades específicas em um endpoint. Com recursos, você pode modelar estados e comportamentos de dispositivos usando propriedades, ações e eventos. As propriedades permitem que você modele os atributos de estado do dispositivo de forma flexível com qualquer tipo de dados declarativo. Ações e eventos modelam o comportamento do dispositivo, incluindo comandos que ele pode executar e sinais que ele pode relatar.

A seguir, é exibida uma estrutura de alto nível de um esquema de recursos.

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

Ação

Uma entidade que representa uma interação com a capacidade de um dispositivo. Por exemplo, toque a campainha ou veja quem está na porta.

Event

Uma entidade que representa um evento a partir de uma capacidade do dispositivo. Um dispositivo pode enviar um evento para relatar um incidente, alarme ou atividade de um sensor, como uma batida na porta.

Propriedade

Uma entidade que representa um atributo específico no estado do dispositivo. Por exemplo, uma campainha está tocando ou a luz da varanda está acesa

Cada recurso inclui um identificador exclusivo com namespace, informações de versão e uma descrição de sua finalidade. O documento do esquema usa controle de versão semântico para manter a compatibilidade com versões anteriores e, ao mesmo tempo, ativar novos recursos.

Para obter mais informações, consulte Esquema para definições de capacidade.

Esquema de definição de tipo

Uma definição de tipo é um tipo de dados estruturado declarativo que permite a reutilização e a capacidade de composição. Ele define como as informações devem ser formatadas e restringidas. Use definições de tipo para criar formatos de dados padronizados em toda a sua solução de IoT.

Cada definição de tipo inclui:

• Um identificador exclusivo com namespace

• Cargo

• Descrição

• Propriedades que definem a formatação e as restrições dos dados

Os tipos podem ser primitivos simples, como números inteiros ou cadeias de caracteres com limites definidos, ou estruturas complexas, como enumerações ou objetos personalizados com vários campos. As definições de tipo usam a sintaxe do esquema JSON para especificar restrições, incluindo valores mínimos e máximos, comprimentos de string e padrões permitidos.

Para obter mais informações, consulte Esquema para definições de tipo.