Übung – Abruftrigger implementieren

  • 10 Minuten

In dieser Übung erstellen Sie für den benutzerdefinierten Konnektor einen Abruftrigger 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.

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

Hinweis

Sie können den Konnektor, den Sie in Lerneinheit 4: Einen Webhook-Trigger implementieren erstellt und geändert haben, verwenden. Wenn Sie diese Übung abgeschlossen haben, können Sie mit Aufgabe 2 fortfahren.

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.

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 > 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. Öffnen Sie die Lösung Trigger für Contoso invoicing, die Sie importiert haben.

    Ihnen sollte die benutzerdefinierte Konnektorkomponente Trigger für Contoso invoicing angezeigt werden.

    Screenshot der hervorgehobenen Komponente der Contoso invoicing triggers

  9. Navigieren Sie 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 fügen Sie ihn dann für die zukünftige Verwendung in Ihren Editor ein.

  12. Kehren Sie zum Power Apps-Entwicklerportal 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. Öffnen Sie den benutzerdefinierten Konnektor Contoso invoicing triggers.

  15. Wählen Sie Bearbeiten aus.

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

  16. Geben Sie contosoinvoicing.azurewebsites.net in Host ein.

  17. Wählen Sie Konnektor aktualisieren aus.

  18. Wählen Sie Test > + Neuer Konnektor 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 dann 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 ListInvoice 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: Abruftrigger hinzufügen

Wenn Sie die vorherige Aufgabe übersprungen haben, gehen Sie zu Ihrem benutzerdefinierten Konnektor Contoso invoicing triggers, und wählen Sie Bearbeiten aus.

  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 (Umfrage)

    • Beschreibung – Wenn eine Rechnung erstellt wird (Umfrage)

    • Vorgangs-ID – InvoiceCreatedPoll

    • Triggertyp – Abfrage

    Screenshot der Eigenschaften des Konnektor-Triggers

  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.

    • Verb – GET

    • URL - https://contosoinvoicing.azurewebsites.net/ListInvoices?fromDate=

  6. Wählen Sie die Chevron-Schaltfläche neben fromDate und dann die Option Bearbeiten aus.

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

  7. Wählen Sie internal für Visibility und dann die Schaltfläche Zurück aus.

    Screenshot der Option für die Sichtbarkeit des Parameters, die auf „internal“ festgelegt ist

  8. Scrollen Sie nach unten zum Abschnitt Antwort, und wählen Sie + Standardantwort hinzufügen aus.

  9. Fügen Sie den folgenden JSON-Code in das Feld Text ein, und wählen Sie dann Importieren aus.

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

    Screenshot zu „Standardantwort importieren“

  10. Navigieren Sie zum Abschnitt Triggerkonfiguration, und geben Sie die folgenden Werte an:

    • Wählen Sie den Abfrageparameter aus, um die Statusänderung zu überwachen – fromDate

    • Hiermit wählen Sie einen Wert aus, der an den ausgewählten Abfrageparameter übergeben wird. Sie können Ausdrücke auswählen ‑ @{triggerBody().invoices[0].createDate}

    • Sammlung mit Triggerdaten auswählen - @triggerBody().invoices

    Screenshot des Abschnitts „Triggerkonfiguration“ mit Werten

  11. Wählen Sie die Schaltfläche Konnektor aktualisieren oben im Bildschirm aus, und warten Sie, bis der Konnektor aktualisiert wird.

Aufgabe 3: Den Trigger testen

Wenn Sie Lerneinheit 4: Einen Webhook-Trigger implementieren bereits abgeschlossen und den Cloud-Flow Rechnung erstellen erstellt haben, fahren Sie mit Schritt 14 fort.

  1. Navigieren Sie zum Power Apps-Entwicklerportal, 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 > Cloud-Flow aus.

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

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

  5. Wählen Sie + 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 kopiert haben, und wählen Sie dann Erstellen aus.

    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. Halten Sie diese Browser-Registerkarte oder dieses Fenster offen.

  14. Starten Sie ein neues Browserfenster, und wechseln Sie zu https://make.powerapps.com/

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

  16. Wählen Sie Lösungen aus, und öffnen Sie dann die Lösung Contoso Invoicing ‑ Triggers aus.

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

  18. Geben Sie als Namen Invoice notification poll ein, und klicken Sie auf Überspringen.

  19. 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

  20. Wählen Sie den Trigger Wenn eine Rechnung erstellt wird (Umfrage) aus.

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

  21. Wählen Sie die Schaltfläche ... Menü des Triggers aus, und stellen Sie dann sicher, dass Verbindungsreferenzen ausgewählt ist.

    Screenshot des Abschnitts „Verbindungsreferenzen“

  22. Wählen Sie + Neuer Schritt aus.

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

  24. 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“

  25. Wählen Sie Speichern aus, und warten Sie dann, bis der Flow gespeichert wurde.

  26. Wählen Sie Testen aus.

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

  28. Wechseln Sie zur Browserregisterkarte oder zum Browserfenster des Flows Rechnung erstellen.

  29. Wählen Sie Testen aus.

  30. Wählen Sie Manuell > Testen aus.

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

  32. Wählen Sie Fertig aus.

  33. Der Flow sollte erfolgreich ausgeführt werden. Wählen Sie Bearbeiten aus.

    Screenshot des erfolgreichen Flows mit dem Symbol „Bearbeiten“

  34. Wählen Sie erneut Testen aus.

  35. Wählen Sie Manuell > Testen aus.

  36. Geben Sie 8.800 für Menge ein, und wählen Sie dann Flow ausführen aus.

  37. Wählen Sie Fertig aus. Der Flow sollte erneut erfolgreich ausgeführt werden.

  38. Wechseln Sie zum Flow Rechnungs-Benachrichtigungsabfrage. Dieser Flow sollte erfolgreich ausgeführt werden.

    Hinweis

    Im Gegensatz zu einem Webhook-Trigger kann es ungefähr eine Minute dauern, um herauszufinden, ob der Flow erfolgreich ausgeführt wurde oder nicht.

  39. Erweitern Sie den Aktionsschritt Zusammenstellen.

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

  40. Überprüfen Sie die Ausgaben, und wählen Sie dann die Schaltfläche aus.

    Screenshot der Ausgaben der Flowaktion „Zusammenstellen“

    Sie sollten zwei Ausführungsergebnisse für die beiden von Ihnen erstellten Rechnungen sehen.

    Screenshot mit Details des Flowausführungsverlaufs