Übung – Webhook-Trigger implementieren

  • 10 Minuten

In dieser Übung erstellen Sie für den benutzerdefinierten Konnektor einen Webhook-Trigger für eine vorhandene API namens Contoso Invoicing.

Wichtig

Verwenden Sie eine Testumgebung mit bereitgestelltem Microsoft Dataverse. Wenn Sie keine Testumgebung haben, können Sie sich für den Community-Plan anmelden.

Hinweis

Laden Sie die folgende Datei auf Ihren lokalen Computer herunter, um diese Übung Contoso Invoicing Triggers abzuschließen. Wählen Sie die Schaltfläche „Herunterladen“ im mittleren rechten Teil des Bildschirms aus.

Aufgabe 1: Die Lösung mit dem benutzerdefinierten Konnektor importieren

In dieser Aufgabe importieren Sie eine nicht verwaltete Lösung, die einen vorgefertigten benutzerdefinierten Konnektor für die API zu Contoso Invoicing enthält.

  1. Navigieren Sie zum Power Apps Maker Portal, und stellen Sie sicher, dass Sie sich in der richtigen Umgebung befinden.

  2. Wählen Sie Lösungen > Lösung importieren aus.

  3. Wählen Sie Durchsuchen aus.

  4. Wählen Sie die Lösung ContosoInvoicingTriggers_1_0_0_0.zip und dann Öffnen aus.

  5. Wählen Sie Weiter aus.

  6. Wählen Sie Importieren aus, und warten Sie dann, bis der Import abgeschlossen ist. Nach Abschluss des Imports sollte eine Erfolgsmeldung angezeigt werden.

  7. Wählen Sie Alle Anpassungen veröffentlichen aus, und warten Sie dann, bis die Veröffentlichung abgeschlossen ist.

  8. Wählen Sie die Lösung Contoso-Import-Trigger aus, die Sie importiert haben, und öffnen Sie sie.

    Ihnen sollte die benutzerdefinierte Konnektorkomponente Contoso invoicing triggers angezeigt werden.

    Screenshot des hervorgehobenen Contoso invoicing triggers

  9. Navigieren Sie auf einer neuen Registerkarte zu Contoso Invoicing.

  10. Wählen Sie den Link API-Schlüssel aus.

    Screenshot des hervorgehobenen Links „API-Schlüssel“

  11. Kopieren Sie den API-Schlüssel, und speichern Sie ihn in einem Editor. Sie werden ihn in dieser Übung mehrfach verwenden.

  12. Kehren Sie zum Power Apps Maker Portal zurück, und stellen Sie sicher, dass Sie sich in der Umgebung befinden.

  13. Wählen Sie Lösungen aus, und öffnen Sie dann die Lösung Contoso invoicing triggers.

  14. Wählen Sie den benutzerdefinierten Konnektor Contoso invoicing triggers aus, um ihn zu öffnen.

  15. Wählen Sie Bearbeiten aus.

    Screenshot eines Pfeils, der auf die Schaltfläche „Konnektor bearbeiten“ verweist

  16. Geben Sie contosoinvoicing.azurewebsites.net für Host ein.

  17. Wählen Sie Konnektor aktualisieren aus.

  18. Wählen Sie Testen > + Neue Verbindung aus.

    Screenshot eines Pfeils, der auf die Schaltfläche „Neue Verbindung hinzufügen“ verweist

  19. Fügen Sie den API-Schlüssel ein, und wählen Sie Verbindung erstellen aus.

    Screenshot der Schaltfläche „Verbindung erstellen“

  20. Wählen Sie Aktualisieren aus. Die von Ihnen erstellte Verbindung sollte automatisch ausgewählt werden.

  21. Scrollen Sie nach unten zum Abschnitt Vorgänge, wählen Sie ListInvoices und dann Vorgang testen aus.

    Screenshot eines Pfeils, der auf die Schaltfläche „Vorgang testen“ verweist

    Ihnen sollte eine Liste der Rechnungen im Abschnitt Text angezeigt werden.

    Screenshot einer Liste der Rechnungen im Abschnitt „Text“

  22. Navigieren Sie nicht von dieser Seite weg.

Aufgabe 2: Webhook-Trigger hinzufügen

Befolgen Sie diese Schritte, um einen Webhook-Trigger hinzuzufügen:

  1. Wählen Sie Definition aus.

    Screenshot der ausgewählten Registerkarte „Definition“

  2. Scrollen Sie nach unten zum Abschnitt Trigger, und wählen Sie + Neuer Trigger aus.

  3. Geben Sie die folgenden Werte an:

    • Zusammenfassung – Wenn eine Rechnung erstellt wird

    • Beschreibung – Wenn eine Rechnung erstellt wird

    • Vorgangs-ID – InvoiceCreated

    • Triggertyp – Webhook

    Screenshot der neuen Triggerwerte für Zusammenfassung, Beschreibung, Vorgangs-ID und Triggertyp

  4. Navigieren Sie zum Abschnitt Anforderung, und wählen Sie + Aus Beispiel importieren aus.

    Screenshot eines Pfeils, der auf die Schaltfläche „Aus Beispiel importieren“ verweist

  5. Geben Sie die folgenden Werte ein, und klicken Sie dann auf Importieren. Bei anderen APIs erhalten Sie das Beispiel aus der API-Dokumentation.

    • Verb – POST

    • URL - https://contosoinvoicing.azurewebsites.net/NewInvoiceNotification/

      Hinweis

      Fügen Sie den abschließenden Schrägstrich in die URL ein.

    • Text

       {
 "targetUrl":"https://webhook.site"
 }

    Screenshot der Eigenschaften des Anforderungsbeispiels

  6. Scrollen Sie zu Triggerkonfiguration, und wählen Sie dann targetUrl für Rückruf-URL-Parameter aus. Diese Auswahl ermöglicht, dass die Ziel-URL zur Laufzeit vom benutzerdefinierten Konnektor ausgefüllt wird.

    Screenshot des Trigger-Bestätigungsfensters

  7. Scrollen Sie nach oben zum Abschnitt Anfrage, wählen Sie Text und dann Bearbeiten aus.

    Screenshot eines Pfeils, der auf die Schaltfläche „Text bearbeiten“ verweist

  8. Wählen Sie targetUrl und anschließend Bearbeiten aus.

    Screenshot eines Pfeils, der auf die Schaltfläche „Ziel-URL bearbeiten“ verweist

  9. Wählen Sie Ja für Ist erforderlich und dann internal für Visibility aus.

    Screenshot der Eigenschaftsfelder der Ziel-URL

  10. Wählen Sie die Schaltfläche Zurück aus.

    Screenshot eines Pfeils, der auf die Schaltfläche „Zurück“ verweist

  11. Wählen Sie erneut die Schaltfläche Zurück aus.

  12. Scrollen Sie nach unten zum Abschnitt Webhook-Antwort, geben Sie Rechnung für Beschreibung ein, und wählen Sie dann + Aus Beispiel importieren aus. Die Webhook-Antwort definiert, was an Ihren Flow gesendet wird, wenn das auslösende Ereignis auftritt.

    Screenshot eines Pfeils, der auf die Schaltfläche „Beispielantwort importieren“ verweist

  13. Fügen Sie das folgende JSON-Beispiel in das Feld Text ein, und wählen Sie dann Importieren aus.

     {
 "invoiceId": "1933",
 "date": "2021-01-26T04:02:52.1490835+00:00",
 "amount": 5000,
 "accountId": "1001",
 "accountName": "Wing Tips",
 "status": "Invoiced",
 "typeId": 1,
 "purchaseOrderId": "3002",
 "tags": "New Account;Special Pricing"
 }

    Screenshot zu Eigenschaftendetails für „Beispielantwort importieren“

  14. Wählen Sie Konnektor aktualisieren aus.

    Hinweis

    Wenn Sie die Fehlermeldung erhalten, dass „alle Pfade mit '/' beginnen müssen“, öffnen Sie Swagger, suchen Sie die Zeile mit '':{}, und löschen Sie sie dann.

  15. Wählen Sie Schließen aus.

Aufgabe 3: Den Trigger testen

  1. Navigieren Sie zum Power Apps Maker Portal, und stellen Sie sicher, dass Sie sich in der Umgebung befinden.

  2. Wählen Sie Lösungen aus, und öffnen Sie dann die Lösung Contoso invoicing triggers.

  3. Wählen Sie + Neu > Automatisierung > Cloud-Flow > Sofort aus.

  4. Geben Sie Rechnung erstellen für den Namen ein, und wählen Sie dann Einen Flow manuell auslösen unter Trigger und dann Erstellen aus.

    Screenshot eines Pfeils, der auf den Trigger „Einen Flow manuell auslösen“ verweist

  5. Erweitern Sie den Trigger, und wählen Sie dann + Eingabe hinzufügen aus.

  6. Wählen Sie Zahl für den Eingabetyp aus.

    Screenshot eines Pfeils, der auf den Eingabetyp „Zahl“ verweist

  7. Geben Sie Menge für den Eingabenamen ein, und wählen Sie dann + Neuer Schritt aus.

    Screenshot eines Pfeils, der auf die Schaltfläche „Neuen Flowschritt hinzufügen“ verweist

  8. Wählen Sie die Registerkarte Benutzerdefiniert und dann den benutzerdefinierten Konnektor Contoso Invoicing aus.

    Screenshot eines Pfeils, der auf den benutzerdefinierten Konnektor verweist

  9. Wählen Sie die Aktion Rechnung hinzufügen aus.

  10. Geben Sie Contoso-Verbindung im Feld Verbindungsname ein, fügen Sie den API-Schlüssel ein, den Sie in Aufgabe 1: Eine Lösung mit dem benutzerdefinierten Konnektor importieren kopiert haben, und wählen Sie dann Erstellen aus. Sie müssen in beiden Flows denselben API-Schlüssel verwenden, sonst wird Ihr Trigger-Flow nicht ausgeführt.

    Screenshot der Schaltfläche „Verbindung erstellen“

  11. Wählen Sie das Feld Betrag und dann Betrag im Bereich Dynamischer Inhalt aus.

    Screenshot der Ausgabe des Felds „Betrag“ aus dem vorherigen Schritt

  12. Wählen Sie Speichern aus.

  13. Wählen Sie die Schaltfläche <- Zurück aus.

  14. Stellen Sie sicher, dass Sie sich immer noch in der Lösung Contoso Invoicing - Triggers befinden.

  15. Wählen Sie + Neu > Automatisierung > Cloud-Flow > Automatisiert aus.

  16. Geben Sie als Flownamen Rechnungsbenachrichtigung ein, und klicken Sie auf Überspringen.

  17. Wählen Sie die Registerkarte Benutzerdefiniert und dann den benutzerdefinierten Konnektor Contoso Invoicing aus.

    Screenshot eines Pfeils, der auf den Trigger des benutzerdefinierten Konnektors verweist

  18. Wählen Sie den Trigger Wenn eine Rechnung erstellt wird aus.

  19. Wählen Sie + Neuer Schritt aus.

  20. Suchen Sie nach Zusammenstellen, und wählen Sie dann die Aktion Zusammenstellen aus.

  21. Wählen Sie das Feld Eingaben und dann Text im Bereich Dynamischer Inhalt aus.

    Screenshot des Felds „Eingabe“ und des Texts aus dem Bereich „Dynamischer Inhalt“

  22. Wählen Sie Speichern aus.

  23. Wählen Sie Testen aus.

  24. Wählen Sie Manuell > Testen aus. Der Flow wird gestartet, und Sie sollten auf Benachrichtigungen warten.

  25. Öffnen Sie ein neues Browserfenster, und wechseln Sie zu https://make.powerapps.com/

  26. Stellen Sie sicher, dass Sie die richtige Umgebung ausgewählt haben.

  27. Wählen Sie Lösungen aus, und öffnen Sie dann Contoso Invoicing - Triggers.

  28. Öffnen Sie den Cloud-Flow Rechnung erstellen.

  29. Wählen Sie Bearbeiten aus.

  30. Wählen Sie Testen aus.

  31. Wählen Sie Manuell > Testen aus.

  32. Wählen Sie Fortsetzen aus.

  33. Geben Sie 5.500 für Betrag ein, und wählen Sie dann Flow ausführen aus.

  34. Wählen Sie Fertig aus.

  35. Wechseln Sie zum Flow Rechnungsbenachrichtigung. Der Flow sollte erfolgreich ausgeführt werden.

  36. Erweitern Sie die Aktion Zusammenstellen.

    Screenshot eines Pfeils, der auf die Aktion „Zusammenstellen“ verweist

    Die Eingaben und Ausgaben sollten den Betrag anzeigen, den Sie im Flow Rechnung erstellen ausgewählt haben.

    Screenshot der Eingaben und Ausgaben der Aktion „Zusammenstellen“