Grundlagen der Erstellung von Power Fx-Funktionen

  • 5 Minuten

Die Erstellung von Funktionen in Dataverse ist jetzt aufgrund von Low-Code-Power Fx und einer intuitiven Nutzungsoberfläche einfacher. Funktionen sind wiederverwendbare Lösungsobjekte, die serverseitig in Dataverse Logik ausführen. Dies macht sie zu leistungsstarken Tools zur Optimierung Ihrer Apps. Sie können Funktionen aus Canvas-Apps, modellgesteuerten Apps, benutzerdefinierten Seiten, Flows usw. aufrufen.

Wenn Sie mit Power Fx-Funktionen noch nicht vertraut sind, gehen Sie in den folgenden Abschnitten die wichtigsten Faktoren durch, die beim Erstellen einer Funktion zu berücksichtigen sind.

Haupteigenschaften einer Power Fx-Funktion

Dies sind die Haupteigenschaften einer Power Fx-Funktion:

  • Anzeigename (erforderlich): Der Anzeigename Ihrer Funktion. Klare, aussagekräftige Namen sind bei der Verwaltung mehrerer Funktionen sehr hilfreich. Überlegen Sie sich eine einheitliche Namenskonvention, um für mehr Übersichtlichkeit zu sorgen. Beachten Sie, dass Sie den Namen nach dem Erstellen der Funktion nicht mehr ändern können.

  • Schemaname: Der logische Name des Systems für die Funktion. Der Schemaname wird automatisch vom System generiert, wenn Sie einen Anzeigenamen eingeben. Wie der Anzeigename können Sie ihn später nicht mehr ändern.

  • Description (erforderlich): Eine kurze Erläuterung der Funktionsweise Ihrer Funktion. Das Hinzufügen einer klaren Beschreibung hilft anderen (und Ihnen), den Zweck der Funktion zu verstehen. Ähnlich wie der Name können Sie diese Eigenschaft nach der Erstellung nicht mehr ändern.

  • Formel (erforderlich): Hier geben Sie Ihren Power Fx-Ausdruck für die Ausführung von Aktionen oder Berechnungen ein. Während Sie schreiben, hilft IntelliSense Ihnen dabei, Probleme zu erkennen. Eine rote Unterstreichung gibt an, dass in Ihrer Formel ein Fehler aufgetreten ist. Sie können den Mauszeiger über den unterstrichenen Teil bewegen – und IntelliSense teilt Ihnen mit, wo das Problem liegt.

  • Tabellenreferenzen (optional): Sie können Ihre Funktion mit bis zu fünf Dataverse-Tabellen verknüpfen, sodass Sie Daten mit Filter() oder LookUp() abrufen können. Denken Sie daran, dass Funktionen im Benutzerkontext ausgeführt werden. Stellen Sie daher sicher, dass die Benutzenden, die die Funktion aufrufen, auf die referenzierten Tabellen zugreifen können. Funktionen können die Sicherheit von Dataverse nicht außer Kraft setzen.

  • Parameters (optional): Funktionen können Eingabeparameter (zum Senden von Daten an die Funktion) und Ausgabeparameter (zum Zurückgeben von Ergebnissen) verwenden. Diese Parameter funktionieren ähnlich wie Variablen, da sie dynamische Eingaben akzeptieren. So sind Ihre Funktionen flexibel und in verschiedenen Apps wiederverwendbar.

    Screenshot der Eingabe‑ und Ausgabeparameter

Unterstützte Parametertypen

Ihre Funktion kann die folgenden Datentypen akzeptieren und zurückgeben:

  • Boolescher Wert
  • Zeichenfolge
  • Gleitkommazahl
  • Dezimalzahl
  • DateTime
  • Ganzzahl

Bitte beachten

Beachten Sie beim Arbeiten mit Power Fx-Funktionen die folgenden Punkte:

  • Einige Power Fx-Formeln haben Einschränkungen oder werden in Dataverse-Funktionen nicht unterstützt. Bevor Sie beginnen, überprüfen Sie die Liste der unterstützten Funktionen, um Überraschungen zu vermeiden.
  • Sie können Funktionen in Dataverse-Lösungen speichern, sodass sie zwischen Umgebungen portierbar sind. Wenn Sie in einer verwalteten Lösung arbeiten, gelten möglicherweise Einschränkungen beim Ändern oder Löschen vorhandener Funktionen.
  • Wenn Ihre Funktion von anderen Dataverse-Tabellen oder -Funktionen abhängt, achten Sie auf etwaige Abhängigkeiten, insbesondere wenn Sie Lösungen zwischen Umgebungen verschieben.
  • Verfolgen Sie, wo Ihre Funktion von Personen verwendet wird (z. B. in Apps oder Flows), um zu vermeiden, dass Abhängigkeiten unterbrochen werden, wenn Sie sie später ändern.
  • Versionsverwaltungsfunktionen sind nicht automatisch. Ziehen Sie daher in Betracht, die Dokumentation zu pflegen, wenn Sie Änderungen vornehmen.
  • Löschen Sie Ihre Funktionen nicht aus dem Bereich Lösungen, da dies zu verwaisten Komponenten führen könnte. Löschen Sie Funktionen stattdessen im Bereich Funktionen in Power Apps. Wählen Sie dazu die gewünschte Funktion aus, und wählen Sie dann die Option Löschen auf der Befehlsleiste.

Mit diesen Grundlagen sind Sie bestens gerüstet, um Ihre eigenen Power Fx-Funktionen zu erstellen. Haben Sie Spaß bei der Funktionserstellung – und vergessen Sie nicht das Erkunden und Experimentieren.