Verwenden von Eigenschaften in einer Azure IoT Central-Lösung

In dieser Anleitung erfahren Sie, wie Sie Geräteeigenschaften verwenden, die in einer Gerätevorlage in Ihrer Azure IoT Central-Anwendung definiert sind.

Eigenschaften repräsentieren zeitliche Momentaufnahmen. Beispielsweise kann ein Gerät eine Eigenschaft verwenden, um die Zieltemperatur zu melden, die erreicht werden soll. Standardmäßig sind Geräteeigenschaften in IoT Central schreibgeschützt. Schreibbare Eigenschaften ermöglichen es Ihnen, den Zustand zwischen Ihrem Gerät und Ihrer Azure IoT Central-Anwendung zu synchronisieren.

Sie können Cloudeigenschaften auch in einer Azure IoT Central-Anwendung definieren. Cloud-Eigenschaftswerte werden nie mit einem Gerät ausgetauscht und fallen nicht in den Geltungsbereich dieses Artikels.

Informationen zu den IoT-Plug-und-Play-Eigenschaftskonventionen finden Sie unter IoT Plug-and-Play-Konventionen.

Weitere Informationen zu den Eigenschaftendaten, die ein Gerät mit IoT Central austauscht, finden Sie unter Telemetrie, Eigenschaft und Befehlsnutzlast.

Informationen zum Verwalten von Eigenschaften mithilfe der IoT Central REST-API finden Sie unter Verwendung der IoT Central REST-API zum Steuern von Geräten.

Informationen zum Implementieren von Eigenschaften in einem Gerät ohne Verwendung der Geräte-SDKs finden Sie unter "Kommunizieren mit einem IoT-Hub mithilfe des MQTT-Protokolls".

Definieren Sie Ihre Eigenschaften

Eigenschaften sind Datenfelder, die den Zustand Ihres Geräts darstellen. Verwenden Sie Eigenschaften, um den dauerhaften Zustand des Geräts darzustellen, z. B. den Ein-/Aus-Zustand eines Geräts. Eigenschaften können auch grundlegende Geräteeigenschaften darstellen, z. B. die Softwareversion des Geräts. Sie können Eigenschaften als schreibgeschützt oder schreibbar deklarieren.

Der folgende Screenshot zeigt eine Eigenschaftsdefinition in einer Azure IoT Central-Anwendung.

In der folgenden Tabelle sind die Konfigurationseinstellungen für eine Eigenschaftsfunktion aufgeführt.

Feld	Description
Anzeigename	Der Anzeigename des Eigenschaftswerts, der auf Dashboardkacheln und in Geräteformularen verwendet wird.
Name	Der Name der Eigenschaft. Azure IoT Central generiert einen Wert für dieses Feld aus dem Anzeigenamen, Aber Sie können bei Bedarf Ihren eigenen Wert auswählen. Dieses Feld muss alphanumerisch sein. Der Gerätecode verwendet diesen Name-Wert .
Funktionstyp	Eigentum.
Semantischer Typ	Der semantische Typ der Eigenschaft, z. B. Temperatur, Zustand oder Ereignis. Die Auswahl des semantischen Typs bestimmt, welche der folgenden Felder verfügbar sind.
Schema	Der Datentyp der Eigenschaft, z. B. "Double", "String" oder "Vector". Der semantische Typ bestimmt die verfügbaren Auswahlmöglichkeiten. Das Schema ist für die Ereignis- und Zustandsemantiktypen nicht verfügbar.
Beschreibbar	Wenn die Eigenschaft nicht schreibbar ist, kann das Gerät Eigenschaftswerte an Azure IoT Central melden. Wenn die Eigenschaft schreibbar ist, kann das Gerät Eigenschaftswerte an Azure IoT Central melden. Dann kann Azure IoT Central Eigenschaftsupdates an das Gerät senden.
Schweregrad	Nur für den Ereignissemantiktyp verfügbar. Die Schweregrade sind "Fehler", " Informationen" oder "Warnung".
Zustandswerte	Nur für den Zustandssemantiktyp verfügbar. Definieren Sie die möglichen Statuswerte, von denen jeder den Anzeigenamen, den Namen, den Enumerationstyp und den Wert enthält.
Einheit	Eine Einheit für den Eigenschaftswert, z. B. mph, %oder °C.
Anzeigegerät	Eine Anzeigeeinheit für die Verwendung auf Dashboard-Kacheln und Geräte-Formularen.
Kommentar	Beliebige Kommentare zur Eigenschaftsfunktion.
Description	Eine Beschreibung der Eigenschaftsfunktion.

Informationen zur Digital Twin Definition Language (DTDL), die Azure IoT Central zum Definieren von Eigenschaften in einer Gerätevorlage verwendet, finden Sie unter IoT Plug &Play-Konventionen > Schreibgeschützte Eigenschaften.

Optionale Felder, z. B. Anzeigename und Beschreibung, ermöglichen es Ihnen, weitere Details zu der Schnittstelle und den Funktionen hinzuzufügen.

Wenn Sie eine Eigenschaft erstellen, können Sie komplexe Schematypen wie Object und Enum angeben.

Wenn Sie das komplexe Schema auswählen, z. B. "Object", müssen Sie das Objektschema definieren.

Implementieren von schreibgeschützten Eigenschaften

Standardmäßig sind Eigenschaften schreibgeschützt. Mit schreibgeschützten Eigenschaften kann das Gerät Aktualisierungen der Eigenschaftswerte an die Azure IoT Central-Anwendung melden. Ihre Azure IoT Central-Anwendung kann den Wert einer schreibgeschützten Eigenschaft nicht festlegen.

Azure IoT Central verwendet Gerätezwillinge zum Synchronisieren von Eigenschaftswerten zwischen dem Gerät und der Azure IoT Central-Anwendung. Die gemeldeten Eigenschaften von Gerätezwillingen werden für die Eigenschaftswerte eines Geräts verwendet. Weitere Informationen finden Sie im Lernprogramm: Konfigurieren Ihrer Geräte aus einem Back-End-Dienst.

Ein Gerät sendet Eigenschaftsaktualisierungen als JSON-Nutzlast. Weitere Informationen finden Sie unter Telemetrie, Eigenschaften und Befehls-Payloads.

Sie können das Azure IoT-Geräte-SDK verwenden, um ein Eigenschaftenupdate an Ihre Azure IoT Central-Anwendung zu senden.

Beispielimplementierungen in mehreren Sprachen finden Sie im Lernprogramm: Erstellen und Verbinden einer Clientanwendung mit Ihrer Azure IoT Central-Anwendung.

Die folgende Ansicht in der Anwendung Azure IoT Central zeigt die schreibgeschützten Eigenschaften des Geräts:

Implementieren schreibbarer Eigenschaften

Ein IoT Central-Operator legt beschreibbare Eigenschaften für ein Formular fest. Azure IoT Central sendet die Eigenschaft an das Gerät. Azure IoT Central erwartet eine Bestätigung vom Gerät.

Beispielimplementierungen in mehreren Sprachen finden Sie unter Erstellen und Verbinden einer Clientanwendung mit Ihrer Azure IoT Central-Anwendung.

Die Antwortnachricht sollte die Felder ac und av enthalten. Das feld ad ist optional. Weitere Informationen finden Sie unter IoT Plug & Play-Konventionen > Schreibbare Eigenschaften.

Wenn der Operator eine schreibbare Eigenschaft in der Azure IoT Central UI festlegt, verwendet die Anwendung eine gewünschte Geräteeigenschaft des Device Twin, um den Wert an das Gerät zu übermitteln. Das Gerät antwortet dann mithilfe einer gemeldeten Eigenschaft des Gerätezwillings. Wenn Azure IoT Central den gemeldeten Eigenschaftswert empfängt, wird die Eigenschaftsansicht mit dem Status "Akzeptiert" aktualisiert.

Wenn Sie den Wert eingeben und "Speichern" auswählen, lautet der Anfangsstatus "Ausstehend". Wenn das Gerät die Änderung akzeptiert, ändert sich der Status in "Angenommen".

Verwenden von Eigenschaften auf nicht zugewiesenen Geräten

Sie können schreibbare Eigenschaften auf einem Gerät anzeigen und aktualisieren, das keiner Gerätevorlage zugewiesen ist.

Um vorhandene Eigenschaften auf einem nicht zugewiesenen Gerät anzuzeigen, navigieren Sie zum Gerät im Abschnitt "Geräte ", wählen Sie " Gerät verwalten" und dann "Geräteeigenschaften" aus:

Sie können die beschreibbaren Eigenschaften in dieser Ansicht aktualisieren:

Nächste Schritte

Nachdem Sie nun wissen, wie Sie Eigenschaften in Ihrer Azure IoT Central-Anwendung verwenden können, lesen Sie:

• IoT Plug and Play-Konventionen
• Telemetrie-, Eigenschaften- und Befehlsnutzlasten
• Lernprogramm: Erstellen und Verbinden einer Clientanwendung mit Ihrer Azure IoT Central-Anwendung