Vorgänge durchführen

Abgeschlossen

Zusätzlich zu den grundlegenden Vorgängen zum Erstellen, Aktualisieren, Löschen und Abfragen von Dataverse-Daten gibt es auch andere benutzerdefinierte Aktionen, die verwendet werden können. Bei diesen Aktionen kann es sich um generische Hilfslogiken handeln wie AISummarize oder benutzerdefinierte Logik, die für eine Lösung spezifisch ist. Beispielsweise können Sie eine Aktion ScheduleVisit durchführen, und bei einem Anruf wird ein verfügbarer Techniker gefunden und dem Besuch zugewiesen. Sie können bei der Verwendung von Aktionen Eingabeinformationen bereitstellen und Ergebnisse als Ausgabe zurückgeben. Sie kümmern sich allgemein nicht um die Logik, die die Aktion intern zur Ausführung der Aufgabe verwendet. Ein wesentlicher Vorteil solcher Aktionen ist, dass sie von mehreren Flows und Apps genutzt werden können und die Arbeit stets auf die gleiche Art und Weise erledigt wird. Wenn eine Änderung der Logik benötigt wird, müssen Sie nur die Aktion ändern. Dann werden alle Apps und Flows die Änderung verwenden.

Diese Aktionen können nativ in Dataverse sein, von Code-First-Entwicklern mit der Funktion Benutzerdefinierte API von Dataverse erstellt oder mit sofortigen Low-Code-Plug-Ins mit Power Fx erstellt werden. Wenn Sie eine Aktion zur Erstellung Ihres Cloud-Flows verwenden, wissen Sie nicht unbedingt, wie sie erstellt wurde, sondern nur, dass sie für die Einbindung in Ihren Cloud-Flow verfügbar ist. Aktionen können verwendet werden, um Datenänderungen vorzunehmen, wie z. B. das Erstellen oder Aktualisieren von Zeilen in Dataverse, oder sie können einfach wiederverwendbare Logik umfassen.

Aktionen können gebunden oder ungebunden sein. Gebundene Aktionen zielen auf eine bestimmte Tabellenzeile ab. Bei Verwendung einer gebundenen Aktion müssen Sie einen Verweis auf die Zeile dieser Tabelle bereitstellen. Ungebundene Aktionen sind nicht an eine bestimmte Tabelle gebunden und werden ohne den Kontext einer bestimmten Tabelle oder Zeile genutzt. Der Dataverse-Konnektor bietet zwei Operationen: Eine gebundene Aktion ausführen und Eine ungebundene Aktion ausführen, mit denen Sie die Aktionen aufrufen können. Wählen Sie für diesen Schritt eine gebundene oder eine ungebundene Aktion aus, wenn Sie Ihren Cloud-Flow erstellen.

Screenshot mit „Ungebundene Aktion ausführen“

Ein Low-Code-Ersteller kann ein Low-Code-Plug-In verwenden, um eine Aktion zum Durchführen einer Berechnung zu erstellen. Verwenden Sie zum Beispiel Eingaben aus ausgewählten Währungsspalten einer Tabelle, um eine Schuldenquote zu berechnen. Von dort aus können Sie Logik hinzufügen, um basierend auf den Ergebnissen der Berechnungen Richtlinien durchzusetzen. Im folgenden Beispiel wird eine ungebundene Aktion in Power Automate angezeigt, die diesen Zweck hat.

Screenshot der Schaltfläche „Speichern“

In der folgenden Übung senden Sie mit einer Aktion in einem Cloud-Flow wöchentlich eine E-Mail mit zusammenfassenden Informationen zu aktiven Spendenaktionen. Sie müssen die Aktion zunächst als Low-Code-Plug-In erstellen.

Übung – Ein Low-Code-Plug-In erstellen und es aus einem Cloud-Flow verwenden

In dieser Übung erstellen Sie ein sofortiges Low-Code-Plug-In, mit dem die durchschnittlichen Spenden für eine Spendenaktion berechnet werden. Dann rufen Sie diese Logik über einen Cloud-Flow auf.

Voraussetzungen

Auf eine Umgebung mit Dataverse mit installierten Beispiel-Apps zugreifen, wenn Sie die folgenden Übungen durchführen möchten

Aufgabe – Low-Code-Plug-In erstellen

  1. Wechseln Sie zum Power Platform Maker Portal, und wählen Sie die richtige Umgebung aus.

  2. Wählen Sie Apps aus der linken Navigation aus. Klicken Sie auf die Option Alle, und starten Sie dann die Dataverse Accelerator App.

    Screenshot der Dataverse Accelerator App

  3. Wählen Sie die Option Sofort-Plug-In erstellen aus.

  4. Geben Sie als Anzeigename Durchschnittliche Spende berechnen ein, und klicken Sie dann auf die Schaltfläche Neuer Eingabeparameter.

    Screenshot der Schaltfläche „Neuen Eingabeparameter hinzufügen“

  5. Geben Sie TargetFundraiser als Beschriftung ein. Wählen Sie dann als Datentyp EntityReference und Sample_fundraiser aus, und klicken Sie auf die Schaltfläche Neuer Ausgangsparameter.

    Screenshot der Schaltfläche „Neuen Ausgabeparameter hinzufügen“

  6. Geben Sie als Beschriftung AverageDonation ein, und wählen Sie als Datentyp Decimal aus.

  7. Fügen Sie diesen Ausdruck in das Feld Ausdruck ein, und klicken Sie dann auf die Schaltfläche Speichern.

    {AverageDonation: LookUp(Fundraisers, sample_fundraiserid = TargetFundraiser.sample_fundraiserid).'Total Donations' / CountIf(Donations, Regarding = TargetFundraiser)}

    Screenshot mit dem Ausdruck

  8. Sie erhalten nun eine Fundraiser-ID, mit der Sie das Plug-In testen können. Starten Sie eine neue Browsersitzung, navigieren Sie dann zum Power Platform Maker Portal, und wählen Sie dann die richtige Umgebung aus.

  9. Wählen Sie Apps aus der linken Navigation aus. Klicken Sie auf die Option Alle, und starten Sie dann die Anwendung Fundraiser.

  10. Wählen Sie in der linken Navigation Fundraisers aus, und öffnen Sie den Scholarship Fund.

  11. Wählen Sie zu der URL, und kopieren Sie dann die ID dieses Fundraisers.

    Screenshot der Datensatz-ID

  12. Sie können die Fundraiser-Anwendung schließen.

  13. Wechseln Sie zurück zum Plug-In, und wählen Sie die Schaltfläche Testen aus.

  14. Fügen Sie die kopierte ID in das Feld Wert ein, und wählen Sie dann Ausführen aus.

    Screenshot der Schaltfläche „Test ausführen“

  15. Das Plug-In sollte erfolgreich ausgeführt werden und die durchschnittliche Spende angeben.

    Screenshot des Plug-In-Ergebnisses

  16. Sie können die Dataverse Accelerator App schließen.

Aufgabe – Flow erstellen und das Plug-In verwenden

In dieser Aufgabe verwenden Sie das Plug-In, das Sie erstellt haben.

  1. Navigieren Sie zu Power Automate, und wählen Sie die gleiche Umgebung aus, in der Sie das Plug-In erstellt haben.

  2. Wählen Sie Erstellen im linken Navigationsbereich aus, und klicken Sie dann auf Geplanter Cloud-Flow.

    Screenshot mit der Schaltfläche zum Erstellen eines geplanten Cloud-Flows

  3. Geben Sie als Flow-Namen Wöchentlicher Fundraiser-Bericht ein, wählen Sie aus, dass er jede Woche wiederholt und montags ausgeführt werden soll, und klicken Sie dann auf die Option Erstellen.

    Screenshot des Dialogfelds „Flow erstellen“

  4. Wählen Sie die Schaltfläche Neuen Schritt einfügen und dann Aktion hinzufügen aus.

    Screenshot der Schaltfläche „Eine Aktion hinzufügen“

  5. Suchen Sie nach Listenzeilen, und wählen Sie Zeilen auflisten vom Microsoft Dataverse-Konnektor aus. Befolgen Sie wenn nötig zur Herstellung der Verbindung die Anweisungen.

  6. Ändern Sie den Aktionsnamen in Fundraiser auflisten, und wählen Sie als Tabellenname Fundraisers aus.

    Screenshot mit der Aktion „Zeilen auflisten“

  7. Wählen Sie die Schaltfläche Neuen Schritt einfügen und dann Aktion hinzufügen aus.

  8. Suchen Sie nach Initialisieren, und klicken Sie auf die Option Variable initialisieren.

  9. Ändern Sie den Namen der Aktion in Durchschnittswerte initialisieren, geben Sie als Name Spendendurchschnittswerte ein, und wählen Sie dann als Typ Array aus.

    Screenshot der Aktion „Variable initialisieren“

  10. Wählen Sie die Schaltfläche Neuen Schritt einfügen und dann Aktion hinzufügen aus.

  11. Suchen Sie nach „Ungebundene Aktion ausführen“, und wählen Sie die Option Eine ungebundene Aktion ausführen aus dem Microsoft Dataverse-Konnektor aus.

  12. Ändern Sie den Namen des Schritts in Durchschnitt berechnen, wählen Sie das Plug-In CaluculateAverageDonation aus, das Sie für den Aktionsnamen erstellt haben, und klicken Sie dann auf die Schaltfläche Alle anzeigen.

    Screenshot mit der ungebundenen Aktion

  13. Geben Sie / in das Feld Item/TargetFundraiser/Sample_fundraiser ein, und wählen Sie dann Dynamischen Inhalt eingeben aus.

    Screenshot der Option „Dynamischen Inhalt einfügen“

  14. Suchen Sie nach dem Fond, und wählen Sie dann Fundraiser aus dem Bereich Dynamischer Inhalt aus.

    Screenshot mit dem eindeutigen Bezeichner der Spendenaktion.

  15. Power Automate erstellt eine For Each und platziert die Aktion „Durchschnitt berechnen“ in „For Each“.

  16. Wählen Sie For each aus, und ändern Sie den Namen in For each fundraiser.

  17. Wählen Sie die Schaltfläche Neuen Schritt einfügen unter der Aktion Durchschnitt berechnen aus, und klicken Sie dann auf die Option Aktion hinzufügen.

    Screenshot mit der Erstellung von Schaltfläche „For each“ und der Schaltfläche „Aktion hinzufügen“

  18. Suchen Sie nach Anhängen und wählen Sie An Array-Variable anfügen aus.

  19. Benennen Sie die Aktion An den Spendendurchschnitt anhängen um, wählen Sie als Name Spendendurchschnitte aus, und fügen Sie diesen JSON in das Feld Wert ein. Sie fügen diesem JSON die dynamischen Werte hinzu.

    {"Name":, "Total Donation":, "Average Donation":}

  20. Geben Sie / nach Name: ein, und wählen Sie dann die Option Dynamischen Inhalt einfügen aus.

    Screenshot der Aktion „An Array anfügen“ und der Option „Dynamischen Inhalt einfügen“

  21. Wählen Sie im Bereich „Dynamischer Inhalt“ Name aus.

  22. Geben Sie / nach Total Donations: ein, und wählen Sie dann die Option Dynamischen Inhalt einfügen aus.

  23. Wählen Sie im Bereich „Dynamischer Inhalt“ Total Donations aus.

  24. Geben Sie / nach Durchschnittliche Spende: ein, und wählen Sie dann die Option Dynamischen Inhalt einfügen aus.

  25. Wählen Sie im Bereich „Dynamischer Inhalt“ AverageDonation aus.

  26. Das „Für alle“ sollte nun wie in diesem Bild aussehen. Wählen Sie die Option Neuen Schritt einfügen außerhalb der Aktion For each fundraiser aus, und klicken Sie dann auf die Option Aktion hinzufügen.

    Screenshot der Schaltfläche „Aktion hinzufügen“ außerhalb von „Für alle“

  27. Suchen Sie nach der HTML-Tabelle, und wählen Sie Eine HTML-Tabelle erstellen vom Datenoperation-Konnektor aus.

  28. Geben Sie / in das Feld „Von“ ein, und wählen Sie Dynamischen Inhalt eingeben aus.

  29. Wählen Sie im Bereich „Dynamischer Inhalt“ Spendendurchschnittswerte aus.

  30. Wählen Sie die Schaltfläche Neuen Schritt einfügen nach der Aktion HTML-Tabelle erstellen aus, und klicken Sie dann auf die Option Aktion hinzufügen.

    Screenshot mit der Schaltfläche „Aktion hinzufügen“ nach der Aktion „HTML-Tabelle erstellen“

  31. Suchen Sie nach E-Mail senden, und wählen Sie E-Mail senden (V2) aus. Befolgen Sie wenn nötig zur Herstellung der Verbindung die Anweisungen.

  32. Benennen Sie die Aktion „E-Mail senden“ in Bericht senden um, geben Sie die E-Mail-Adresse Ihres Benutzers für „An“ ein, und geben Sie als Betreff Spendenbericht ein.

  33. Geben Sie / in das Textfeld ein, und wählen Sie dann Dynamischen Inhalt einfügen aus.

  34. Wählen Sie Ausgabe von „HTML-Tabelle erstellen“ aus dem dynamischen Inhaltsbereich aus.

    Screenshot mit Anzeige des E-Mail-Texts

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

  36. Navigieren Sie nicht von dieser Seite weg.

Aufgabe – Flow testen

  1. Wählen Sie die Schaltfläche Testen aus.

    Screenshot der Schaltfläche „Flow testen“

  2. Wählen Sie die Option Manuell und dann Testen aus.

  3. Wählen Sie Flow ausführen aus.

  4. Wählen Sie Fertig aus.

  5. Die Flowausführung sollte erfolgreich durchgeführt worden sein.

    Screenshot mit einer erfolgreichen Flowausführung

  6. Navigieren Sie zu Outlook.

  7. Sie sollten die vom Flow versendete Spendenaktionsbericht-E-Mail erhalten.

  8. Der Bericht sollte wie in dieser E-Mail aussehen.

    Screenshot mit dem Bericht