Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Schemi di modelli di dati
Managed Integrations supporta due tipi di schema: capacità 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.
- Event
-
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 abilitando al contempo 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
Description
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.
