Integrieren Ihrer Azure IoT Central-Anwendung in andere Clouddienste mithilfe von Workflows
Sie können Regeln in IoT Central erstellen, die Aktionen als Reaktion auf telemetriebasierte Bedingungen auslösen. Um beispielsweise eine E-Mail zu senden, wenn eine Gerätetemperatur einen Schwellenwert überschreitet.
Der Azure IoT Central V3-Connector für Power Automate und Azure Logic Apps ermöglicht die Erstellung komplexerer Regeln, um Vorgänge in IoT Central zu automatisieren:
- Wenn eine Regel in Ihrer Azure IoT Central-App ausgelöst wird, kann ein Workflow in Power Automate oder Azure Logic Apps ausgelöst werden. Durch diese Workflows können Aktionen in anderen Clouddiensten (beispielsweise Microsoft 365) oder in einem Drittanbieterdienst ausgeführt werden.
- Durch ein Ereignis in einem anderen Clouddienst (beispielsweise Microsoft 365) kann ein Workflow in Power Automate oder Azure Logic Apps ausgelöst werden. Durch diese Workflows können Aktionen ausgeführt oder Daten aus Ihrer IoT Central-Anwendung abgerufen werden.
- Der Azure IoT Central V3-Connector ist auf die allgemein verfügbare REST-API-Oberfläche 1.0 abgestimmt. Alle Connectoraktionen unterstützen das DTDLv2-Format, und die Unterstützung für DTDLv1-basierte Modelle ist veraltet. Die neuesten Informationen und Details zu den letzten Aktualisierungen finden Sie in den Versionshinweisen für die aktuelle Connectorversion.
Voraussetzungen
Zum Ausführen der Schritte in dieser Anleitung ist Folgendes erforderlich:
Ein aktives Azure-Abonnement. Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.
Eine IoT Central-Anwendung, die mit der Vorlage Benutzerdefinierte Anwendung erstellt wurde. Weitere Informationen finden Sie unter Erstellen einer IoT Central-Anwendung und Über Ihre Anwendung.
Auslösen eines Workflows über eine Regel
Um einen Workflow in Power Automate oder Azure Logic Apps auslösen zu können, benötigen Sie zunächst eine Regel in Ihrer IoT Central-Anwendung. Weitere Informationen finden Sie unter Konfigurieren von Regeln.
So fügen Sie denAzure IoT Central V3-Connector als Auslöser in Power Automate hinzu:
- Wählen Sie in Power Automate + Erstellen und anschließend die Registerkarte Benutzerdefiniert aus.
- Suchen Sie nach IoT Central, und wählen Sie den Azure IoT Central V3-Connector aus.
- Wählen Sie in der Liste mit den Triggern die Option When a rule is fired (preview) (Beim Auslösen einer Regel (Vorschauversion)) aus.
- Wählen Sie im Schritt When a rule is fired (Beim Auslösen einer Regel) Ihre IoT Central-Anwendung und die verwendete Regel aus.
So fügen Sie den Azure IoT Central V3- Connector als Auslöser in Azure Logic Apps hinzu:
Wichtig
Trigger im IoT Central Connector funktionieren nicht, es sei denn, die Logik-App verfügt über einen öffentlichen Endpunkt. Weitere Informationen finden Sie unter Überlegungen für eingehenden Datenverkehr zu Logik-Apps über private Endpunkte.
- Wählen Sie im Designer für Logik-Apps die Vorlage Leere Logik-App aus.
- Suchen Sie im Designer nach IoT Central und wählen Sie den Azure IoT Central V3-Connector aus.
- Wählen Sie in der Liste mit den Triggern die Option When a rule is fired (preview) (Beim Auslösen einer Regel (Vorschauversion)) aus.
- Wählen Sie im Schritt When a rule is fired (Beim Auslösen einer Regel) Ihre IoT Central-Anwendung und die verwendete Regel aus.
Nun können Sie Ihrem Workflow weitere Schritte hinzufügen, um Ihr Integrationsszenario zu erstellen.
Ausführen einer Aktion
Sie können Aktionen in einer IoT Central-Anwendung über Power Automate- und Azure Logic Apps-Workflows ausführen. Erstellen Sie zunächst Ihren Workflow, und verwenden Sie einen Connector, um einen Trigger zum Starten des Workflows zu definieren. Verwenden Sie dann den Azure IoT Central V3-Connector als Aktion.
So fügen Sie den Azure IoT Central V3-Connector als Aktion in Power Automate hinzu:
- Wählen Sie in Power Automate im Bereich "Aktion auswählen " die Registerkarte "Benutzerdefiniert " aus.
- Suchen Sie nach IoT Central und wählen Sie den Azure IoT Central V3-Connector.
- Wählen Sie in der Liste mit den Aktionen die gewünschte IoT Central-Aktion aus.
- Schließen Sie im Aktionsschritt die Konfiguration für die ausgewählte Aktion ab. Klicken Sie dann auf Speichern.
Gehen Sie wie folgt vor, um den Azure IoT Central V3 – Vorschau-Connector in Azure Logic Apps als Aktion hinzuzufügen:
- Wählen Sie im Designer für Logik-Apps im Bereich Aktion auswählen die Registerkarte Benutzerdefiniert aus.
- Suchen Sie nach IoT Central, und wählen Sie den Azure IoT Central V3-Connector aus.
- Wählen Sie in der Liste mit den Aktionen die gewünschte IoT Central-Aktion aus.
- Schließen Sie im Aktionsschritt die Konfiguration für die ausgewählte Aktion ab. Klicken Sie dann auf Speichern.
Liste mit Aktionen
Eine vollständige Liste der von dem Konnektor unterstützten Aktionen finden Sie unter Aktionen.
„Create or update a device“ (Gerät erstellen oder aktualisieren)
Verwenden Sie diese Aktion, um ein Gerät in Ihrer IoT Central-Anwendung zu erstellen oder zu aktualisieren.
| Feld | Beschreibung |
|---|---|
| Antrag | Wählen Sie eine Anwendung aus der Liste mit IoT Central-Anwendungen aus. |
| Sicherungsmedium | Die eindeutige ID des Geräts, das erstellt oder aktualisiert werden soll. |
| Genehmigt | Wählen Sie aus, ob für das Gerät die Verbindungsherstellung mit IoT Central genehmigt wurde. |
| Gerätebeschreibung | Eine detaillierte Beschreibung des Geräts. |
| Gerätename | Der Anzeigename des Geräts. |
| Gerätevorlage | Wählen Sie eine Vorlage aus der Liste mit Gerätevorlagen in Ihrer IoT Central-Anwendung aus. |
| Simuliert | Wählen Sie aus, ob es sich um ein simuliertes Gerät handelt. |
Löschen eines Mediums
Verwenden Sie diese Aktion, um ein Gerät aus Ihrer IoT Central-Anwendung zu löschen.
| Feld | Beschreibung |
|---|---|
| Antrag | Wählen Sie eine Anwendung aus der Liste mit IoT Central-Anwendungen aus. |
| Sicherungsmedium | Die eindeutige ID des zu löschenden Geräts. |
„Execute a device command“ (Gerätebefehl ausführen)
Verwenden Sie diese Aktion, um einen Befehl auszuführen, der in einer der Schnittstellen des Geräts definiert ist.
| Feld | Beschreibung |
|---|---|
| Antrag | Wählen Sie eine Anwendung aus der Liste mit IoT Central-Anwendungen aus. |
| Sicherungsmedium | Die eindeutige ID des Geräts, auf dem ein Befehl ausgeführt werden soll. |
| „Device Component“ (Gerätekomponente) | Die Schnittstelle in der Gerätevorlage, die den Befehl enthält. |
| Gerätebefehl | Wählen Sie einen der Befehle für die ausgewählte Schnittstelle aus. |
| Gerätevorlage | Wählen Sie eine Vorlage aus der Liste mit Gerätevorlagen in Ihrer IoT Central-Anwendung aus. |
| „Device Command Request Payload“ (Anforderungsnutzlast für Gerätebefehl) | Sollte für den Befehl eine Anforderungsnutzlast erforderlich sein, fügen Sie sie hier hinzu. |
Hinweis
Eine Gerätekomponente kann erst ausgewählt werden, nachdem eine Gerätevorlage ausgewählt wurde.
Abrufen eines Geräts nach ID
Verwenden Sie diese Aktion, um die Details des Geräts abzurufen.
| Feld | Beschreibung |
|---|---|
| Antrag | Wählen Sie eine Anwendung aus der Liste mit IoT Central-Anwendungen aus. |
| Sicherungsmedium | Die eindeutige ID des Geräts zum Abrufen der Details. |
Die zurückgegebenen Details können in den dynamischen Ausdrücken in anderen Aktionen verwendet werden. Die zurückgegebenen Gerätedetails umfassen: Genehmigt, Textkörper, Gerätebeschreibung, Gerätename, Gerätevorlage, bereitgestellt und simuliert.
„Get device cloud properties“ (Cloudeigenschaften des Geräts abrufen)
Verwenden Sie diese Aktion, um die Cloudeigenschaftswerte für ein bestimmtes Gerät abzurufen.
| Feld | Beschreibung |
|---|---|
| Antrag | Wählen Sie eine Anwendung aus der Liste mit IoT Central-Anwendungen aus. |
| Sicherungsmedium | Die eindeutige ID des Geräts zum Abrufen der Cloudeigenschaften. |
| Gerätevorlage | Wählen Sie eine Vorlage aus der Liste mit Gerätevorlagen in Ihrer IoT Central-Anwendung aus. |
Die zurückgegebenen Cloudeigenschaftswerte können in den dynamischen Ausdrücken in anderen Aktionen verwendet werden.
„Get device properties“ (Geräteeigenschaften abrufen)
Verwenden Sie diese Aktion, um die Eigenschaftswerte für ein bestimmtes Gerät abzurufen.
| Feld | Beschreibung |
|---|---|
| Antrag | Wählen Sie eine Anwendung aus der Liste mit IoT Central-Anwendungen aus. |
| Sicherungsmedium | Die eindeutige ID des Geräts zum Abrufen der Eigenschaften. |
| Gerätevorlage | Wählen Sie eine Vorlage aus der Liste mit Gerätevorlagen in Ihrer IoT Central-Anwendung aus. |
Die zurückgegebenen Eigenschaftswerte können in den dynamischen Ausdrücken in anderen Aktionen verwendet werden.
„Get device telemetry value“ (Gerätetelemetriewert abrufen)
Verwenden Sie diese Aktion, um die Telemetriewerte für ein bestimmtes Gerät abzurufen.
| Feld | Beschreibung |
|---|---|
| Antrag | Wählen Sie eine Anwendung aus der Liste mit IoT Central-Anwendungen aus. |
| Sicherungsmedium | Die eindeutige ID des Geräts zum Abrufen der Telemetriewerte. |
| Gerätevorlage | Wählen Sie eine Vorlage aus der Liste mit Gerätevorlagen in Ihrer IoT Central-Anwendung aus. |
Die zurückgegebenen Telemetriewerte können in den dynamischen Ausdrücken in anderen Aktionen verwendet werden.
„Update device cloud properties“ (Cloudeigenschaften des Geräts aktualisieren)
Verwenden Sie diese Aktion, um die Cloudeigenschaftswerte für ein bestimmtes Gerät zu aktualisieren.
| Feld | Beschreibung |
|---|---|
| Antrag | Wählen Sie eine Anwendung aus der Liste mit IoT Central-Anwendungen aus. |
| Sicherungsmedium | Die eindeutige ID des Geräts, das aktualisiert werden soll. |
| Gerätevorlage | Wählen Sie eine Vorlage aus der Liste mit Gerätevorlagen in Ihrer IoT Central-Anwendung aus. |
| Cloudeigenschaften | Nach dem Auswählen einer Gerätevorlage wird ein Feld für jede Cloudeigenschaft hinzugefügt, die in der Vorlage definiert ist. |
„Update device properties“ (Geräteeigenschaften aktualisieren)
Verwenden Sie diese Aktion, um die beschreibbaren Eigenschaftswerte für ein bestimmtes Gerät zu aktualisieren.
| Feld | Beschreibung |
|---|---|
| Antrag | Wählen Sie eine Anwendung aus der Liste mit IoT Central-Anwendungen aus. |
| Sicherungsmedium | Die eindeutige ID des Geräts, das aktualisiert werden soll. |
| Gerätevorlage | Wählen Sie eine Vorlage aus der Liste mit Gerätevorlagen in Ihrer IoT Central-Anwendung aus. |
| Schreibbare Eigenschaften | Nach dem Auswählen einer Gerätevorlage wird ein Feld für jede beschreibbare Eigenschaft hinzugefügt, die in der Vorlage definiert ist. |
Nächste Schritte
Nachdem Sie nun erfahren haben, wie Sie eine erweiterte Regel in Ihrer Azure IoT Central-Anwendung erstellen, erfahren Sie, wie Sie Gerätedaten in Ihrer Azure IoT Central-Anwendung analysieren.