Schemi di modelli di dati

Le integrazioni gestite supportano due tipi di schema: funzionalità e definizione del tipo. Se stai creando un modello di dati personalizzato, utilizzi un documento dello schema JSON per definire entrambi i tipi di schema. Ogni documento dello schema ha un limite di 50.000 caratteri.

Schema di capacità

Una funzionalità è un elemento fondamentale che rappresenta funzionalità specifiche all'interno di un endpoint. Grazie alle funzionalità, è possibile modellare gli stati e i comportamenti dei dispositivi utilizzando proprietà, azioni ed eventi. Le proprietà consentono di modellare gli attributi di stato del dispositivo in modo flessibile con qualsiasi tipo di dati dichiarativo. Le azioni e gli eventi modellano il comportamento del dispositivo, inclusi i comandi che può eseguire e i segnali che può segnalare.

Di seguito viene illustrata una struttura di alto livello di uno schema di funzionalità.

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

Azione

Un'entità che rappresenta un'interazione con una funzionalità di un dispositivo. Ad esempio, suona il campanello o guarda chi c'è alla porta.

Evento

Un'entità che rappresenta un evento da una funzionalità del dispositivo. Un dispositivo può inviare un evento per segnalare un incidente, un allarme o un'attività tramite un sensore, ad esempio quando bussa alla porta.

Proprietà

Un'entità che rappresenta un particolare attributo nello stato del dispositivo. Ad esempio, suona un campanello o la luce del portico è accesa

Ogni funzionalità include un identificatore univoco con namespace, informazioni sulla versione e una descrizione del suo scopo. Il documento dello schema utilizza il controllo delle versioni semantiche per mantenere la compatibilità con le versioni precedenti e abilitare nuove funzionalità.

Per ulteriori informazioni, consulta Schema per le definizioni delle funzionalità.

Schema di definizione del tipo

Una definizione di tipo è un tipo di dati strutturato dichiarativo che consente la riutilizzabilità e la componibilità. Definisce come le informazioni devono essere formattate e vincolate. Usa le definizioni dei tipi per creare formati di dati standardizzati per la tua soluzione IoT.

Ogni definizione di tipo include:

• Un identificatore univoco con namespace

• Titolo

• Descrizione

• Proprietà che definiscono la formattazione e i vincoli dei dati

I tipi possono essere primitive semplici, come numeri interi o stringhe con limiti definiti, oppure strutture complesse come enumerazioni o oggetti personalizzati con più campi. Le definizioni dei tipi utilizzano la sintassi dello schema JSON per specificare i vincoli, tra cui valori minimi e massimi, lunghezze delle stringhe e modelli consentiti.

Per ulteriori informazioni, consulta Schema per le definizioni dei tipi.