Herstellen einer Verbindung mit Microsoft Dataverse über Workflows in Azure Logic Apps

Gilt für: Azure Logic Apps (Verbrauch + Standard)

Um Aufgaben zu automatisieren, die mit Ihrer Microsoft Dataverse-Datenbank arbeiten, können Sie den Microsoft Dataverse-Connector mit Workflows in Azure Logic Apps verwenden.

Sie können beispielsweise Workflows erstellen, die Zeilen erstellen, Zeilen aktualisieren und andere Vorgänge ausführen. Sie können auch Informationen aus Ihrer Dataverse-Datenbank abrufen und die Ausgabe für andere Aktionen zur Verwendung in Ihren Workflows verfügbar machen. Wenn beispielsweise eine Zeile in Ihrer Dataverse-Datenbank hinzugefügt, aktualisiert oder gelöscht wird, können Sie eine E-Mail mithilfe des Office 365 Outlook-Connectors senden.

Der Dataverse-Connector wurde zuvor als Common Data Service 2.0-Connector und ursprünglich als Dynamics 365-Connector bezeichnet. Sie können den Dataverse-Connector verwenden, um auf Microsoft Dataverse für Microsoft Dynamics 365 Sales, Microsoft Dynamics 365 Customer Service, Microsoft Dynamics 365 Field Service, Microsoft Dynamics 365 Customer Insights – Journeys und Microsoft Dynamics 365 Project Service Automation zuzugreifen.

In diesem Artikel wird gezeigt, wie Sie ihrem Workflow einen Dataverse-Trigger oder eine Aktion hinzufügen und wie Parameteroptionen funktionieren.

Connectorreferenz

Technische Informationen, die auf der Swagger-Beschreibung des Connectors basieren (z. B. Vorgänge, Grenzwerte und andere Details), finden Sie auf der Referenzseite des verwalteten Connectors.

Voraussetzungen

• Ein Azure Konto und ein Abonnement. Falls Sie kein Abonnement besitzen, können Sie sich für ein kostenloses Azure-Konto registrieren.

• Eine Dataverse Data Service-Umgebung und -Datenbank, in der Ihre Organisation Geschäftsdaten in einer Dataverse-Datenbank speichert, verwaltet und freigibt. Weitere Informationen finden Sie in den folgenden Ressourcen:

  • Lernen: Erstellen und Verwalten von Dataverse-Umgebungen

  • Übersicht über Power Platform-Umgebungen

• Grundkenntnisse über Azure Logic Apps sowie die Consumption- oder Standard-Logic-App-Ressource und den Workflow, von dem aus Sie auf Ihre Dataverse-Datenbank zugreifen möchten. Um einen Dataverse-Trigger zu verwenden, benötigen Sie einen leeren Workflow. Um eine Dataverse-Aktion zu verwenden, benötigen Sie einen Workflow, der mit jedem trigger beginnt, der für Ihr Szenario geeignet ist.

  Weitere Informationen finden Sie in den folgenden Ressourcen:

  • Erstellen eines Beispiels für einen Logik-App-Verbrauchs-Workflow

  • Erstellen eines Beispiels für einen Standardlogik-App-Workflow

Hinzufügen eines Dataverse-Triggers

Je nachdem, ob Sie über einen Verbrauchs- oder Standard-Logik-App-Workflow verfügen, führen Sie die entsprechenden Schritte aus:

Hinzufügen einer Dataverse-Aktion

Je nachdem, ob Sie über einen Verbrauchs- oder Standard-Logik-App-Workflow verfügen, führen Sie die entsprechenden Schritte aus:

Testen Ihres Workflows

Führen Sie zum Ausführen ihres Workflows die folgenden Schritte aus:

1. Wählen Sie auf der Designersymbolleiste "Ausführen">Ausführen aus.

2. Reproduzieren Sie die Bedingungen, die der Auslöser erfordert, damit Ihr Workflow ausgeführt werden kann.

Zurückgeben von Zeilen basierend auf einem Filter

Für Aktionen, die Zeilen zurückgeben, z. B. die Aktion " Listenzeilen ", können Sie eine ODATA-Abfrage verwenden, die Zeilen basierend auf dem angegebenen Filter zurückgibt. Beispielsweise können Sie die Aktion so einrichten, dass nur Zeilen für aktive Konten zurückgegeben werden.

1. Öffnen Sie im Designer in der Aktion die Liste der erweiterten Parameter , und wählen Sie den Parameter " Filterzeilen" aus.

   

2. Geben Sie im Parameter "Filterzeilen ", der nun in der Aktion angezeigt wird, einen ODATA-Abfrageausdruck ein, z. B.:

   statuscode eq 1

   

Weitere Informationen finden Sie in der folgenden Dokumentation:

• Zeilen auflisten
• $filter Systemabfrageoptionen

Zurückgeben von Zeilen basierend auf einer Sortierreihenfolge

Für Aktionen, die Zeilen zurückgeben, z. B. die Aktion " Listenzeilen ", können Sie eine ODATA-Abfrage verwenden, die Zeilen in einer bestimmten Reihenfolge zurückgibt, die je nach den zeilen variiert, die von der Aktion zurückgegeben werden. Beispielsweise können Sie die Aktion so einrichten, dass die Zeilen nach dem Kontonamen sortiert werden.

1. Öffnen Sie im Designer in der Aktion die Liste der erweiterten Parameter , und wählen Sie den Parameter "Sortieren nach " aus.

   

2. Geben Sie im Parameter " Sortieren nach ", der nun in der Aktion angezeigt wird, den Spaltennamen ein, der für die Sortierung verwendet werden soll, z. B. "Name":

   

Weitere Informationen finden Sie in der folgenden Dokumentation:

• Zeilen auflisten
• $orderby Systemabfrageoptionen

Felddatentypen

In einem Trigger oder einer Aktion muss der Datentyp eines Feldwerts mit dem erforderlichen Datentyp des Felds übereinstimmen. Diese Anforderung gilt, ob Sie den Wert manuell eingeben oder den Wert aus der dynamischen Inhaltsliste auswählen.

Angenommen, Sie haben eine Tabelle mit dem Namen "Aufgaben". Diese Tabelle enthält Felder, die nur für diese Tabelle gelten, während andere Tabellen über eigene Felder verfügen. Für die Beispieltabelle Aufgaben beschreibt die folgende Tabelle einige Beispielfeldtypen und die Datentypen, die diese Felder für ihre Werte benötigen.

Nehmen Wir für die Beispieltabelle "Aufgaben" an, dass Sie die Aktion " Neue Zeile hinzufügen " verwenden, um eine neue Zeile zu erstellen, die anderen Entitätszeilen zugeordnet ist, insbesondere eine Benutzerzeile und eine Kontozeile. In dieser Aktion müssen Sie also die IDs und Nachschlagetypen für diese Entitätszeilen mithilfe von Werten angeben, die den erwarteten Datentypen für die relevanten Eigenschaften entsprechen.

• Basierend auf der Eigenschaft "Owner ", die eine Benutzer-ID angibt, und der Eigenschaft "Owner Type ", die den systemusers Nachschlagetyp angibt, ordnet die Aktion die neue Zeile einem bestimmten Benutzer zu.

• Basierend auf der Eigenschaft "Regarding ", die eine Zeilen-ID angibt, und der Eigenschaft "Regarding Type ", die den accounts Nachschlagetyp angibt, ordnet die Aktion die neue Zeile einem bestimmten Konto zu.

Die resultierende Aktion sieht wie im folgenden Beispiel aus:

Problembehandlung

Anrufe aus mehreren Umgebungen

Der Dataverse-Connector speichert Informationen über die Logik-App-Workflows, die Benachrichtigungen über Änderungen von Datenbankentitäten abrufen und benötigen, indem die callbackregistrations-Entität in Ihrer Dataverse-Datenbank verwendet wird. Wenn Sie eine Dataverse-Organisation kopieren, werden auch alle Webhooks kopiert. Wenn Sie Ihre Organisation kopieren, bevor Sie Workflows deaktivieren, die Ihrer Organisation zugeordnet sind, zeigen alle kopierten Webhooks auch auf dieselben Logik-App-Workflows, die dann Benachrichtigungen von mehreren Organisationen erhalten.

Um unerwünschte Benachrichtigungen zu beenden, löschen Sie die callbackregistrations Entität aus der Organisation, die diese Benachrichtigungen sendet, indem Sie die folgenden Schritte ausführen:

1. Identifizieren und melden Sie sich bei der Dataverse-Organisation an, aus der Sie Benachrichtigungen entfernen möchten.

2. Suchen Sie im Chrome-Browser die Rückrufregistrierung, die Sie löschen möchten.

   1. Überprüfen Sie die allgemeine Liste aller Rückrufregistrierungen unter dem folgenden OData-URI, um die Daten in der callbackregistrations-Entität anzuzeigen.

      https://{organization-name}.crm{instance-number}.dynamics.com/api/data/v9.0/callbackregistrations:

      Hinweis

      Wenn keine Werte zurückgegeben werden, sind Sie möglicherweise nicht berechtigt, diesen Entitätstyp anzuzeigen, oder Sie haben sich nicht bei der richtigen Organisation angemeldet.

   2. Filtern Sie nach dem logischen Namen entityname der auslösenden Entität und dem Benachrichtigungsereignis, das Ihrem Logik-App-Workflow (Nachricht) entspricht. Jeder Ereignistyp wird der Nachrichten-ganzzahl wie folgt zugeordnet:

      Ereignistyp	Nachrichteninteger
      Create	1
      Löschen	2
      Update	3
      ErstellenOderAktualisieren	4
      ErstellenOderLöschen	5
      AktualisierenOderLöschen	6
      ErstellenAktualisierenLöschen	7

      Das folgende Beispiel zeigt, wie Sie nach Create-Benachrichtigungen für eine Entität mit dem Namen nov_validation filtern können, indem Sie den folgenden OData-URI einer Beispielorganisation verwenden:

      https://fabrikam-preprod.crm1.dynamics.com/api/data/v9.0/callbackregistrations?$filter=entityname eq 'nov_validation' and message eq 1

      

      Hinweis

      Wenn mehrere Trigger für dieselbe Entität oder dasselbe Ereignis vorhanden sind, können Sie die Liste mithilfe zusätzlicher Filter wie z. B. der createdon Attribute _owninguser_value filtern. Der Name des Eigentümerbenutzers erscheint unter /api/data/v9.0/systemusers({id}).

   3. Nachdem Sie die ID für die Rückrufregistrierung gefunden haben, die Sie löschen möchten, führen Sie die folgenden Schritte aus:

      1. Öffnen Sie in Ihrem Chrome-Browser die Chrome-Entwicklertools (Tastatur: F12).

      2. Wählen Sie im Fenster oben die Registerkarte "Konsole " aus.

      3. Geben Sie an der Eingabeaufforderung diesen Befehl ein, der eine Anforderung zum Löschen der angegebenen Rückrufregistrierung sendet:

         fetch('http://{organization-name}.crm{instance-number}.dynamics.com/api/data/v9.0/callbackregistrations({ID-to-delete})', { method: 'DELETE'})

         Von Bedeutung

         Stellen Sie sicher, dass Sie die Anforderung von einer Nicht-Unified Client Interface (UCI)-Seite vornehmen, z. B. von der OData- oder API-Antwortseite selbst. Andernfalls kann die Logik in der app.js Datei diesen Vorgang beeinträchtigen.

   4. Um zu bestätigen, dass die Rückrufregistrierung nicht mehr vorhanden ist, überprüfen Sie die Liste der Rückrufregistrierungen.

Doppelte Entität "callbackregistrations"

In Standardworkflows startet der Microsoft Dataverse-Trigger unter bestimmten Bedingungen, z. B. Instanzrelocation oder Anwendungsneustart, eine duplizierte Ausführung, wodurch eine duplizierte callbackregistrations Entität in Ihrer Dataverse-Datenbank erstellt wird. Wenn Sie einen Standardworkflow bearbeiten, der mit einem Dataverse-Trigger beginnt, überprüfen Sie, ob diese callbackregistrations Entität dupliziert ist. Wenn das Duplikat vorhanden ist, löschen Sie die duplizierte callbackregistrations Entität manuell.

Verwandte Inhalte

• Verwaltete Connectoren für Azure Logic Apps
• Integrierte Konnektoren für Azure Logic Apps
• Was sind Connectors in Azure Logic Apps