Aufrufen einer Funktion aus App, Fluss, Code oder einer anderen Funktion (Vorschau)

[Dieses Thema ist eine Vorabdokumentation und kann geändert werden.]

Sie können Funktionen in Dataverse aus einer Canvas-App, einer benutzerdefinierten Seite in einer modellgesteuerten App, einem Fluss, Code oder einer anderen Funktion aufrufen.

Aufrufen einer Funktion aus einer Canvas-App oder einer benutzerdefinierten Seite

1. Wählen Sie im Bereich "Funktionen " in Power Apps (make.powerapps.com) die Funktion aus, die Sie über eine Canvas-App oder benutzerdefinierte Seite aufrufen möchten.
2. Wählen Sie " Codeausschnitt kopieren " auf der Befehlsleiste aus.
3. Fügen Sie die kopierte Formel in einen Texteditor wie Notepad oder an einen leicht zugänglichen Ort ein und speichern Sie sie.
4. In Power Apps Studio:
   1. Erstellen oder Bearbeiten einer Canvas-App oder benutzerdefinierten Seite in Power Apps Studio.
   2. Wählen Sie im linken Navigationsbereich auf der Registerkarte " Datenquellen " die Option " Daten hinzufügen" aus, suchen Sie im Dataverse-Connector nach der Option "Umgebung ", und wählen Sie sie aus.
   3. Fügen Sie die folgenden Komponenten in den Zeichenbereich ein:
      • Fügen Sie Eingabesteuerelemente hinzu, die dem Datentyp der einzelnen Parameter entsprechen, z. B. Zahleneingaben.
      • Fügen Sie eine Schaltfläche hinzu, um die Funktion aufzurufen.
      • Fügen Sie ein Ausgabesteuerelement hinzu, das dem Datentyp Ihres Parameters entspricht, wie z. B. eine Zahleneingabe.
5. Wählen Sie die von Ihnen erstellte Schaltfläche aus, und geben Sie in der OnSelect-Eigenschaft Ihre Funktion ein, z. B. Environment.new_calculatesum.
6. Ordnen Sie jeden Eingabeparameter Value den entsprechenden Eingabereglern zu.
   • Wenn Ihre Funktion lautet Environment.new_CalculateSum({ X: Value, Y: Value });, könnte sie wie folgt umgeschrieben werden: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
   • Um die Ausgabe der Funktion "Ergebnis" festzulegen, aktualisieren Sie die Formel auf "Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))")".
7. Wählen Sie das Ausgabesteuerelement aus, und legen Sie die Eigenschaft „Value“ mit der Formel 'result.z' fest.

Zeigen Sie eine Vorschau Ihrer App an, geben Sie Eingabewerte 1 und 2 ein, und wählen Sie die Schaltfläche aus. Das Ergebnis sollte im Ausgabefeld angezeigt werden.

Aufrufen von Funktionen aus einem Power Automate-Cloudfluss

1. Fügen Sie in einem Cloudfluss eine neue Aktion aus dem Microsoft Dataverse-Connector hinzu.
2. Wählen Sie die Aktion mit dem Namen "Ungebundene Aktion ausführen" aus.
3. Wählen Sie Ihre Funktion aus. Die Funktion hat einen eindeutigen Namen mit einem Präfix.
4. Geben Sie Werte für alle Eingabeparameter an (falls vorhanden).

Aufrufen von Funktionen aus der Dataverse-Web-API

Führen Sie die Schritte für die Abschnitte für ungebundene Aktionen im Artikel zum Aufrufen benutzerdefinierter APIs aus dem Web-API-Artikel aus (je nach dem geeigneten Bereich des Plug-Ins).

Aufrufen vorhandener Funktionen aus neuen Funktionen

Verwenden Sie die Syntax, um eine vorhandene Funktion in einer neuen Funktion aufzurufen: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Da die Ausgabe immer ein Datensatz ist, verwenden Sie die Punktnotation, um auf die Ausgabeparameter zuzugreifen. Wenn die Funktion "ExistingFunction" beispielsweise zwei Ausgabeparameter wie "out1" und "out2" aufweist, können Sie auf beide Arten darauf zugreifen:

• Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out1
• Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out2

Einschränkungen bei Funktionen in Dataverse

• Das Umgebungssprachenobjekt muss gelesen werden, um auf neue Funktionen in vorhandenen Canvas-Apps zuzugreifen. Für alle Funktionen, die erstellt wurden, nachdem Sie die Datenquelle der Umgebungstabelle zu einer vorhandenen Canvas-App hinzugefügt haben, müssen Sie das Power Fx-Umgebungssprachenobjekt entfernen und erneut hinzufügen. Anschließend wird die aktualisierte Liste der Funktionen als Aktionen angezeigt.
• Verschachtelte Unterstützung Funktionen können nur Microsoft-Aktionen aufrufen, die von Microsoft aus Power Fx-Ausdrücken veröffentlicht wurden.
• Einige Collect Szenarien erfordern Patch. Es gibt einige Szenarien, in denen Collect() dies nicht funktioniert. Die Problemumgehung besteht darin, Patch() wie im hier gezeigten Beispiel zum Auffüllen der Spalte zu verwenden.

Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

Fehler beheben und Hilfe zu Ihren Funktionen erhalten

Wenn Beim Erstellen oder Ausführen der Funktion Probleme auftreten, verwenden Sie die trace() Funktion zum Debuggen oder gehen Sie zu Einschränkungen mit Funktionen in Dataverse für häufige Probleme, die auftreten können.

Debuggen mithilfe der Trace()-Funktion

1. Um die Ablaufverfolgungsfunktion zu debuggen, stellen Sie sicher, dass Sie das Plug-In und die Verfolgung der benutzerdefinierten Workflowaktivitäten aktivieren.
2. Wechseln Sie zu Power Apps (make.powerapps.com), wählen Sie oben rechts das Zahnradsymbol " Einstellungen " und dann " Erweiterte Einstellungen" aus.
3. Wählen Sie Einstellungen > Überwachung > globale Überwachungseinstellungen aus.
4. In der Registerkarte Anpassungen müssen Sie sicherstellen, dass Protokollierung im Plug-In-Ablaufverfolgungsprotokoll aktivieren auf Alle festgelegt ist.

Nachdem Sie die Nachverfolgung aktiviert haben, können Sie mit der Verwendung von Trace()-Funktionen beginnen, um Power Fx-Formeln zu debuggen. Erfahren Sie mehr darüber, wie Sie die Trace()-Funktion in einem Power Fx-Ausdruck verwenden: Trace-Funktion – Power Platform.

Kontakt zu Hilfe und Support

Für Probleme mit Funktionen, die in Microsoft Dataverse-Low-Code-Plug-Ins nicht behandelt werden, und bekannte Probleme, z. B. nicht dokumentierte Fehler, verwenden Sie Hilfe + Support. Schließen Sie die folgenden Informationen ein:

• Problemtyp: Dataverse Web-API und SDK.
• Problemuntertyp.

Verwandte Artikel

Beispielfunktionen

Erstellen und Verwenden von Funktionen in Microsoft Dataverse