Schemata für Datenmodelle

Managed Integrations unterstützt zwei Schematypen: Capability und Typdefinition. Wenn Sie ein benutzerdefiniertes Datenmodell erstellen, verwenden Sie ein JSON-Schemadokument, um beide Schematypen zu definieren. Jedes Schemadokument hat ein Limit von 50.000 Zeichen.

Funktionsschema

Eine Fähigkeit ist ein grundlegender Baustein, der bestimmte Funktionen innerhalb eines Endpunkts darstellt. Mithilfe von Funktionen können Sie Gerätestatus und -verhalten anhand von Eigenschaften, Aktionen und Ereignissen modellieren. Mithilfe von Eigenschaften können Sie die Statusattribute des Geräts flexibel mit jedem deklarativen Datentyp modellieren. Aktionen und Ereignisse modellieren das Verhalten des Geräts, einschließlich Befehle, die es ausführen kann, und Signalen, die es melden kann.

Im Folgenden wird eine allgemeine Struktur eines Funktionsschemas dargestellt.

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

Aktion

Eine Entität, die eine Interaktion mit einer Fähigkeit eines Geräts darstellt. Läuten Sie beispielsweise die Glocke oder sehen Sie sich an, wer an der Tür steht.

Ereignis

Eine Entität, die ein Ereignis aus einer Fähigkeit eines Geräts darstellt. Ein Gerät kann ein Ereignis senden, um einen Vorfall, einen Alarm oder eine Aktivität eines Sensors zu melden, z. B. ein Klopfen an der Tür.

Eigenschaft

Eine Entität, die ein bestimmtes Attribut im Status des Geräts darstellt. Zum Beispiel klingelt eine Glocke oder das Licht auf der Veranda ist an

Jede Funktion umfasst eine eindeutige Namespace-ID, Versionsinformationen und eine Beschreibung ihres Zwecks. Das Schemadokument verwendet semantische Versionierung, um die Abwärtskompatibilität aufrechtzuerhalten und gleichzeitig neue Funktionen zu ermöglichen.

Weitere Informationen finden Sie unter Schema für Funktionsdefinitionen.

Typdefinitionsschema

Eine Typdefinition ist ein deklarativer strukturierter Datentyp, der Wiederverwendbarkeit und Zusammensetzbarkeit ermöglicht. Sie definiert, wie Informationen formatiert und eingeschränkt werden sollten. Verwenden Sie Typdefinitionen, um standardisierte Datenformate für Ihre IoT-Lösung zu erstellen.

Jede Typdefinition umfasst:

• Eine eindeutige Namespace-ID

• Title

• Beschreibung

• Eigenschaften, die Datenformatierung und Einschränkungen definieren

Typen können entweder einfache Grundelemente wie Ganzzahlen oder Zeichenketten mit definierten Grenzwerten oder komplexe Strukturen wie Aufzählungen oder benutzerdefinierte Objekte mit mehreren Feldern sein. Typdefinitionen verwenden die JSON-Schemasyntax, um Einschränkungen wie Mindest- und Höchstwerte, Zeichenkettenlängen und zulässige Muster anzugeben.

Weitere Informationen finden Sie unter Schema für Typdefinitionen.