Freigeben über

Eingabeaufforderungen in Microsoft Dataverse erstellen und verwenden (Vorschauversion)

  • Artikel

[Dieses Thema ist Teil der Dokumentation zur Vorabversion und kann geändert werden.]

Fuktionen in Microsoft Dataverse erstellen und verwenden. Funktionen verwenden Power Fx, um einen bestimmten Satz von Befehlen serverseitig in Dataverse auszuführen.

Wichtig

  • Dies ist eine Vorschauversion.
  • Funktionen in der Vorschauversion sind nicht für den Produktionseinsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen stehen vor dem offiziellen Release zur Verfügung, damit Kunden früher Zugriff darauf erhalten und Feedback geben können.

Anforderungen

Mitgliedschaft in der Sicherheitsrolle Systemanpasser in der Power Platform-Umgebung.

Funktion in einer Lösung erstellen

  1. Gehen Sie zu Power Apps, und wählen Sie dann Lösungen im linken Navigationsbereich. Wenn sich das Element nicht im linken Seitenbereich befindet, wählen Sie …Mehr und dann das gewünschte Element aus.
  2. Öffnen Sie die gewünschte Lösung oder erstellen Sie eine neue Funktion.
  3. Wählen Sie auf der Befehlsleiste Neu>Automation>Funktiton aus.
  4. Geben Sie die folgenden Informationen in das erscheinende Dialogfeld Neue Funktion ein.
    • Geben Sie einen Anzeigenamen und eine Beschreibung für Ihre Funktion an.
    • Wählen Sie Neuer Eingabeparameter und/oder Neuer Ausgabeparameter aus, und geben Sie dann einen Namen und Datentyp für den Parameter an. Fügen Sie nach Bedarf weitere Eingabe- und Ausgabeparameter hinzu.
    • In der Liste Tabellenverweise können Sie optional Tabellen auswählen. Sie können auf die Dataverse Tabellen verweisen, indem Sie Datensammlungsfunktionen wie Filter() und LookUp() verwenden.
    • Geben Sie den Power Fx Ausdruck im Kästchen Formel ein.
  5. Wählen Sie Speichern.
  6. Fügen Sie die Funktion hinzu.

Verweisen Sie auf Eingabeparameter in der Formel anhand ihrer Namen.

Auf Ausgabeparameter muss in geschweiften Klammern verwiesen werden, z. B. { Out: "Return value" }.

Trinkgeld

  • Beachten Sie die Intellisense im Feld Formel. Rot unterstrichen ist ungültig. Gelb unterschlängelt bedeutet, dass Ihre Logik möglicherweise von Delegationseinschränkungen betroffen ist. Vermeiden Sie Delegationsprobleme durch die Verwendung delegierbarer Funktionen.
  • Erweitern Sie Erweiterte Optionen, um Ihren Schemanamen zu überprüfen.

Beispiel-Funktionen

In diesem Abschnitt finden Sie einige Beispielfunktionen.

Summe aus zwei Ganzzahlen berechnen

  1. Geben Sie einen Anzeigenamen wie z. B. new_calculateSum, und eine Beschreibung ein.

  2. Fügen Sie zwei Eingabeparameter x und y (beide vom Datentyp Integer) und einen Ausgabeparameter z (Datentyp Integer) hinzu.

  3. Geben Sie im Formularfeld folgende Formel ein:
    { z:x+y }

    Funktion, die zwei Zahlen multipliziert.

  4. Fügen Sie die Funktion hinzu.

Neuen Titel der Artikeltabelle hinzufügen

  1. Erstellen Sie zwei Eingabeparameter title und url (beide mit String-Datentypen) und eine Ausgabevariable, message (Datentyp string).
  2. Wählen Sie die Tabelle Wissens-Verbundartikel in der Dropdownliste Tabellenverweise aus.
  3. Geben Sie im Formularfeld folgende Formel ein:
Collect('Knowledge Federated Articles',  
   { 
    Title: title, 
    URL: url 
    } 
    ); 
{ 
    message: "New Article title added: " & title 
}

Überprüfen Sie, ob eine Eingabezeichenfolge die Zeichenfolgen Ihrer Wahl enthält

  1. Erstellen Sie einen Eingabeparameter DocumentTextInput (mit Zeichenfolgendatentyp) und eine Ausgabevariable mit dem Namen result (Datentyp string).
  2. Geben Sie im Formularfeld folgende Formel ein:
{
    result: If("Confidentiality" in DocumentTextInput && "Dispute Resolution" in DocumentTextInput && "Governing Law" in DocumentTextInput && "Termination" in DocumentTextInput, 

    "Document is compliant.", 
    "Document is missing one or more compliance clauses." 
    ) 
}

Berechnen Sie den Preis für einen Hotelaufenthalt

  1. Erstellen Sie sechs Eingabeparameter: Nächte, Zimmer, Steuern, Rabatt, Zimmerservice, Ratepro Nacht (alle mit String-Datentyp) und eine Ausgabevariable, Preis (Datentyp Float).
  2. Geben Sie im Formularfeld folgende Formel ein:
{ 
   price: ((nights*rooms*ratepernight)*(1+(tax/100))*(1-(discount/100)))+roomservice 

}

Weitere Funktionsbeispiele

Weitere Beispielfunktionen finden Sie unter Beispielfunktionen (Vorschauversion).

Funktion bearbeiten, testen oder löschen

Eine Funktion bearbeiten

  1. Wählen Sie Ihre Funktion im Bereich Funktionen aus.
  2. Wählen Sie Bearbeiten in der Befehlsleiste.
  3. Ändern Sie die Formel, und speichern Sie diese.

Eine Funktion testen

  1. Wählen Sie die Funktion im Bereich Funktionen aus.
  2. Wählen Sie Test in der Befehlsleiste.
  3. Geben Sie Werte für die Eingabeparameter an, die in der Funktion definiert sind, und wählen Sie dann Ausführen.

Ein erfolgreicher Test gibt eine OData-Antwort zurück, die Informationen wie den Organisations-URI, den Funktionsnamen sowie Ausgabeparameter und -werte enthält.

Eine Funktion testen

Trinkgeld

Verwenden Sie Ausgabeparameter, um das erwartete Verhalten und die erwarteten Ergebnisse zu validieren. Andernfalls beobachten Sie beim Testen nur Erfolg oder Misserfolg.

Eine Funktion löschen

Wichtig

Löschen Sie Ihre Funktionen während des Vorschauzeitraums nicht aus dem Lösungsbereich, da dies zu verwaisten Komponenten führen kann. Funktionen sollten gelöscht werden, indem Sie im linken Navigationsbereich zu Power App (make.powerapps.com) >Funktionen wechseln.

  1. Wählen Sie Funktionen im linken vertikalen Navigationsbereich und dann Ihre Funktion aus. Wenn sich das Element nicht im linken Seitenbereich befindet, wählen Sie …Mehr und dann das gewünschte Element aus.
  2. Wählen Sie in der Befehlsleiste Löschen aus.

Funktionen in Microsoft Dataverse (Vorschauversion)