Integrieren in Power Platform und Logic Apps mithilfe des Azure Digital Twins-Connectors

Sie können Azure Digital Twins mithilfe des Azure Digital Twins Power Platform-Connectors in einen Microsoft Power Platform- oder Azure Logic Apps-Flow integrieren.

Der Connector ist ein Wrapper um die Azure Digital Twins-Datenebenen-APIs für Zwillings-, Modell- und Abfragevorgänge, mit denen der zugrunde liegende Dienst mit Microsoft Power Automate, Microsoft Power Apps und Azure Logic Apps kommunizieren kann. Der Connector bietet Benutzern eine Möglichkeit, ihre Konten zu verbinden und eine Reihe von vordefinierten Aktionen zum Erstellen ihrer Apps und Workflows zu nutzen.

Eine Einführung in den Connector, einschließlich einer kurzen Demo, sehen Sie sich das folgende IoT-Showvideo an:

Eine grundlegende exemplarische Vorgehensweise finden Sie auch im Blogbeitrag Vereinfachen der Erstellung automatisierter Workflows und Apps, die von Azure Digital Twins unterstützt werden. Weitere Informationen zum Connector, einschließlich einer vollständigen Liste der Aktionen des Connectors und deren Parameter, finden Sie in der Referenzdokumentation zu Azure Digital Twins-Connectors.

Voraussetzungen

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen. Melden Sie sich mit Ihrem Konto beim Azure-Portal an.

Damit Sie in diesem Artikel mit Azure Digital Twins arbeiten können, benötigen Sie eine Azure Digital Twins-Instanz und die erforderlichen Berechtigungen, um sie zu verwenden. Wenn Sie über eine bereits eingerichtete Azure Digital Twins-Instanz verfügen, können Sie diese nutzen und zum nächsten Abschnitt springen. Befolgen Sie andernfalls die Anleitung unter Einrichten einer Instanz und der Authentifizierung. Die Anweisungen enthalten Informationen, mit denen Sie überprüfen können, ob jeder Schritt erfolgreich abgeschlossen wurde.

Notieren Sie sich nach dem Einrichten Ihrer Instanz den Hostnamen der Instanz. Sie finden den Hostnamen im Azure-Portal.

Schließlich müssen Sie alle Power Platform-Dienste einrichten, bei denen Sie den Connector verwenden möchten.

Einrichten des Connectors

Richten Sie für Power Automate und Power Apps zuerst die Verbindung ein, bevor Sie einen Flow erstellen. Führen Sie die folgenden Schritte aus, um die Verbindung in Power Automate und Power Apps hinzuzufügen.

1. Wählen Sie im linken Navigationsmenü Verbindungen aus (in Power Automate unter der Überschrift Daten ). Wählen Sie auf der Seite Verbindungen die Option + Neue Verbindung aus.
2. Suchen Sie nach Azure Digital Twins, und wählen Sie den Connector Azure Digital Twins (Vorschau) aus.
3. Wenn der Connector den ADT-Instanznamen anfragt, geben Sie den Hostnamen Ihrer Instanz ein.
4. Geben Sie Ihre Authentifizierungsdetails ein, wenn Sie aufgefordert werden, die Einrichtung der Verbindung abzuschließen.
5. Um zu überprüfen, ob die Verbindung erstellt wurde, suchen Sie auf der Seite Verbindungen danach.

Für Logic Apps können Sie die integrierte Azure Digital Twins-Verbindung verwenden, wenn Sie im nächsten Abschnitt einen Flow erstellen . Weitere Informationen zu integrierten Connectors finden Sie unter Integrierte Connectors in Azure Logic Apps.

Erstellen eines Datenflusses

Sie können Azure Digital Twins in Power Automate-Flows, Logic Apps-Flows oder Power Apps-Anwendungen integrieren. Mit dem Azure Digital Twins-Connector und über 700 anderen Power Platform-Connectors können Sie Daten von anderen Systemen in Ihren Zwillingen erfassen oder auf Systemereignisse reagieren.

Führen Sie die folgenden Schritte aus, um einen Beispielflow mit dem Connector in Power Automate zu erstellen.

1. Wählen Sie in Power Automate im linken Navigationsmenü die Option Meine Flows aus. Wählen Sie + Neuer Flow und Sofortiger Cloudflow aus.
2. Geben Sie einen Flownamen ein, und wählen Sie In der Liste der Trigger manuell einen Flow auslösen aus. Erstellen Sie den Flow.
3. Fügen Sie dem Flow einen Schritt hinzu, und suchen Sie nach Azure Digital Twins , um die Verbindung zu finden. Wählen Sie die Azure Digital Twins-Verbindung aus.
4. Es wird eine Liste aller Aktionen angezeigt, die mit dem Connector verfügbar sind. Wählen Sie eine davon aus, um mit den Azure Digital Twins-APIs zu interagieren.
5. Sie können Ihren Workflow weiterhin bearbeiten oder weitere Schritte hinzufügen, indem Sie andere Connectors verwenden, um Ihr Integrationsszenario zu erstellen.

Führen Sie die folgenden Schritte aus, um einen Beispielflow mit dem Connector in Power Apps zu erstellen.

1. Wählen Sie in Power Apps im linken Navigationsmenü + Erstellen aus. Wählen Sie Leere App aus, und folgen Sie den Anweisungen, um eine neue App zu erstellen.
2. Wählen Sie im App-Generator im linken Navigationsmenü die Option Daten aus. Wählen Sie Daten hinzufügen aus, und suchen Sie nach Azure Digital Twins , um die Datenverbindung zu finden. Wählen Sie die Azure Digital Twins-Verbindung aus.
3. Jetzt stehen die Aktionen des Azure Digital Twins-Connectors als Funktionen zur Verwendung in Ihrer App zur Verfügung.
4. Sie können ihre Anwendung weiterhin mit Zugriff auf Azure Digital Twins-Daten erstellen. Weitere Informationen zum Erstellen von Power Apps finden Sie unter Übersicht über das Erstellen von Apps in Power Apps.

Führen Sie die folgenden Schritte aus, um einen Beispielflow mit dem Connector in Logic Apps zu erstellen.

1. Navigieren Sie im Azure-Portal zu Ihrer Logik-App. Wählen Sie im linken Navigationsmenü Workflows und + Hinzufügen aus. Befolgen Sie die Anweisungen, um einen neuen Workflow zu erstellen.
2. Wählen Sie Ihren neuen Flow aus, und geben Sie in den Designer ein.
3. Fügen Sie Ihrer App einen Trigger hinzu.
4. Wählen Sie Vorgang auswählen aus, um eine Aktion aus dem Azure Digital Twins-Connector hinzuzufügen. Suchen Sie auf der Registerkarte Azure nach Azure Digital Twins, um die Datenverbindung zu finden. Wählen Sie die Azure Digital Twins-Verbindung aus.
5. Es wird eine Liste aller Aktionen angezeigt, die mit dem Connector verfügbar sind. Wählen Sie eine davon aus, um mit den Azure Digital Twins-APIs zu interagieren.
6. Nachdem Sie eine Aktion aus dem Azure Digital Twins-Connector ausgewählt haben, werden Sie aufgefordert, Authentifizierungsdetails einzugeben, um die Verbindung zu erstellen.
7. Sie können Ihren Workflow weiterhin bearbeiten oder weitere Schritte hinzufügen, indem Sie andere Connectors verwenden, um Ihr Integrationsszenario zu erstellen.

Einschränkungen und Vorschläge

Hier sind einige Einschränkungen des Connectors und Vorschläge für die Arbeit mit ihnen aufgeführt.

• Einige Connectoraktionen (z. B. Modell hinzufügen) erfordern eine Eingabe in Form einer Literalzeichenfolge, die mit @beginnt. In diesen Fällen escapen Sie das @ Zeichen, indem Sie stattdessen verwenden @@ . Dadurch wird verhindert, dass der Literalwert als JSON-Ausdruck interpretiert wird.
• Da Azure Digital Twins dynamische Schemaantworten verarbeitet, sollten Sie den von den APIs empfangenen JSON-Code analysieren, bevor Sie ihn in Ihrer Anwendung verwenden. Hier ist beispielsweise eine Reihe von Aufrufen, die die Daten analysieren, bevor der dtId Wert extrahiert wird: Set(jsonVal, AzureDigitalTwins.GetTwinById("your_twin_id").result); Set(parsedResp, ParseJSON(jsonVal)); Set( DtId, Text(parsedResp.'$dtId'));.

Nächste Schritte

Weitere Informationen zu Power Platform-Connectors, einschließlich deren Verwendung in Workflows für mehrere Produkte, finden Sie in der Dokumentation zu Power Platform- und Azure Logic Apps-Connectors.