Kurze Antwort
Mit Patch() legen Sie Datensätze an oder ändern sie, mit Filter() und LookUp() lesen Sie sie, mit Set() und UpdateContext() speichern Sie Werte in Variablen. Die wichtigsten Formeln für Canvas Apps stehen unten mit Beispielen. Kopieren Sie das passende Beispiel in die genannte Eigenschaft.
Hinweis zur Schreibweise: Die Beispiele sind in englischer Schreibweise. Power Apps zeigt Formeln mit den Trennzeichen Ihres Gebietsschemas an. Bei einem Gebietsschema mit Dezimalkomma, bspw. Deutsch, trennt ein Semikolon die Argumente, das Komma ist Dezimaltrennzeichen, und zwei Semikolons verketten Aktionen. Aus Patch(Orders, Defaults(Orders), {Amount: 12.5}); Back() wird dann Patch(Orders; Defaults(Orders); {Amount: 12,5});; Back(). Power Apps speichert die Formel sprachunabhängig.
Beispieldaten: Orders ist eine SharePoint-Liste mit der Textspalte Title, der Einzelauswahl Status, der Zahlenspalte Amount, der Datumsspalte DueDate und der Textspalte Comment. Customers hat die Textspalten Email, Name und City. Employees ist eine SharePoint-Liste mit der Textspalte Email und der Einzelauswahl Role. Email enthält jeweils den Anmeldenamen (UPN), den User().Email liefert. Products ist eine zweite eingebundene Datenquelle. galOrders ist eine Galerie, die Orders zeigt. Texteingaben wie txtSearch und die Datumsauswahl dtpStart sind klassische Steuerelemente. varJson enthält bspw. den JSON-Text {"name":"Contoso","orders":3}.
Daten lesen
Filter(Orders, Status.Value = "Open")
Filter(Orders, Status.Value = "Open", Amount > 1000)
LookUp(Orders, ID = galOrders.Selected.ID)
LookUp(Customers, Email = User().Email, Name)
Search(Customers, txtSearch.Text, Name, City)
Sort(Orders, DueDate, SortOrder.Descending)
SortByColumns(Orders, "DueDate", SortOrder.Ascending)
First(Filter(Orders, Status.Value = "Open"))
Filter liefert eine Tabelle, LookUp den ersten passenden Datensatz oder Blank(). Mit drittem Argument liefert LookUp einen einzelnen Wert. In SortByColumns steht der Spaltenname als Text in Anführungszeichen. First übernimmt ohne Sortierung die Reihenfolge, in der die Daten kommen. Ob eine Abfrage bei großen Datenmengen vollständig ist, hängt von der Delegierung ab. Search wird bspw. bei SharePoint nicht delegiert. Mehr dazu unter Delegierung in Power Apps.
Daten schreiben mit Patch
Patch(Orders, Defaults(Orders), {Title: txtTitle.Text, Amount: Value(txtAmount.Text)})
Patch(Orders, galOrders.Selected, {Comment: txtComment.Text})
Set(varCustomer, Patch({Name: "Contoso"}, {City: "Cologne"}))
Zum Anlegen erzeugt Defaults() den Grunddatensatz, die Datenquelle in Patch und Defaults muss dieselbe sein. Zum Ändern muss der Grunddatensatz aus der Datenquelle stammen, bspw. aus einer Galerie oder aus LookUp. Patch gibt den geänderten bzw. neuen Datensatz zurück.
Auswahlspalte und Fehlerbehandlung
Für eine SharePoint-Auswahlspalte mit Einzelauswahl übergeben Sie einen Auswahl-Datensatz, bspw. den passenden Eintrag aus Choices(Orders.Status). Voraussetzung: Die Option „Closed“ ist in der Liste angelegt, varOrderId ist eine vorhandene ID.
With(
{
baseOrder: LookUp(Orders, ID = varOrderId),
closedStatus: LookUp(Choices(Orders.Status), Value = "Closed")
},
If(
!IsBlank(baseOrder) && !IsBlank(closedStatus),
Patch(Orders, baseOrder, {Status: closedStatus})
)
)
IfError(
Patch(Orders, galOrders.Selected, {Amount: 400}),
Notify("Saving failed: " & FirstError.Message, NotificationType.Error); false,
true
)
Für IfError muss die Fehlerbehandlung auf Formelebene aktiv sein. In älteren Apps kann sie ausgeschaltet sein.
Mehrere bekannte Datensätze ändern
Die Tabelle mit den Änderungen braucht pro Grunddatensatz genau eine Zeile in derselben Reihenfolge. Voraussetzung: Zwei vorhandene, unterschiedliche IDs und die Option „Overdue“.
With(
{
firstOrder: LookUp(Orders, ID = varFirstOrderId),
secondOrder: LookUp(Orders, ID = varSecondOrderId),
overdueStatus: LookUp(Choices(Orders.Status), Value = "Overdue")
},
If(
!IsBlank(firstOrder) && !IsBlank(secondOrder) && !IsBlank(overdueStatus),
Patch(
Orders,
Table(firstOrder, secondOrder),
Table({Status: overdueStatus}, {Status: overdueStatus})
)
)
)
Prüfen Sie bei einer Tabellenänderung das Ergebnis für jeden Datensatz. Mehrere Datensätze werden nicht als eine gemeinsame Transaktion gespeichert. Rechnen Sie bei Fehlern damit, dass einzelne Datensätze bereits gespeichert wurden.
Patch oder SubmitForm?
SubmitForm(frmOrder)prüft das Formular und speichert die Werte seiner Datenkarten. Danach läuftOnSuccessbzw.OnFailure.Patch()schreibt genau die Felder, die Sie angeben, direkt an die Datenquelle, auch ohne Formular.
Sammlungen
ClearCollect(colCart, {Product: "Performance Check", Quantity: 1})
Collect(colCart, {Product: "Approval Toolkit", Quantity: 2})
Clear(colCart)
RemoveIf(colCart, Quantity = 0)
ClearCollect(colOpenOrders, Filter(Orders, Status.Value = "Open"))
AddColumns(colCart, DoubleQuantity, Quantity * 2)
AddColumns liefert eine neue Tabelle, colCart bleibt unverändert. Seit Power Apps 3.24042 schreiben Sie Spaltennamen in AddColumns ohne Anführungszeichen, Power Apps hat bestehende Apps automatisch umgestellt.
Bei ClearCollect aus einer Datenquelle kann die geladene Auswahl durch das Datenzeilenlimit (standardmäßig 500) abgeschnitten sein.
Variablen
Set(varUserEmail, User().Email)
UpdateContext({locShowDialog: true})
Navigate(scrDetails, ScreenTransition.Fade, {locOrderId: galOrders.Selected.ID})
With(
{varNet: Value(txtAmount.Text)},
varNet * 1.19
)
Faustregel: Set für Werte, die die ganze App braucht, UpdateContext für Werte eines Bildschirms, With für Zwischenergebnisse in einer Formel.
Benannte Formeln
In der Eigenschaft Formulas des App-Objekts legen Sie berechnete Werte fest, die sich an anderer Stelle nicht überschreiben lassen:
UserEmail = User().Email;
UserInfo = LookUp(Employees, Email = UserEmail);
ShowAdminTools = UserInfo.Role.Value = "Admin";
Benannte Formeln werden bei Bedarf berechnet und neu berechnet, wenn sich ihre Abhängigkeiten ändern. Sie dürfen keine Verhaltensfunktionen wie Patch oder Set enthalten, Zirkelbezüge sind nicht erlaubt. Verwenden Sie App.Formulas für berechnete Werte und OnStart für Startaktionen mit Nebenwirkung. Microsoft empfiehlt benannte Formeln als Alternative zu Variablen in OnStart, weil viel Logik in OnStart das Laden der App verzögert.
ShowAdminTools steuert nur die Anzeige. Den Zugriff auf Daten regeln Sie über Berechtigungen in der Datenquelle.
Eigene Funktionen (User-defined Functions)
Eigene Funktionen stehen ebenfalls in App.Formulas. Sie sind seit September 2025 allgemein verfügbar und setzen die neue Analyse-Engine voraus, die in neuen Apps aktiv ist. Eigene Typen (User-defined Types) sind seit Mai 2026 allgemein verfügbar und seit Power Apps Studio 3.26044 in neuen Apps standardmäßig aktiv.
GrossAmount(net: Number): Number = net * 1.19;
AddToCart(product: Text, quantity: Number): Void = {
Collect(colCart, {Product: product, Quantity: quantity});
Notify("Added to cart", NotificationType.Success)
};
OrderType := Type({Title: Text, Amount: Number, DueDate: Date});
OrderListType := Type([OrderType]);
Verhaltensfunktionen mit Nebenwirkung stehen in geschweiften Klammern. Aufruf bspw. in OnSelect eines Knopfs: AddToCart("Performance Check", 1). Rekursion wird laut Microsoft nicht unterstützt. In bestehenden Apps finden Sie den Schalter unter Einstellungen > Updates > Neu > Benutzerdefinierte Typen.
Text, Zahl und Datum
Text(Today(), "dd.mm.yyyy")
Text(Now(), "dd.mm.yyyy hh:mm")
Text(Now(), "dddd, d. mmmm yyyy", "de-DE")
Text(1234.5, "[$-en-US]#,##0.00", "de-DE")
DateAdd(Today(), 7, TimeUnit.Days)
Text(DateDiff(dtpStart.SelectedDate, Today(), TimeUnit.Days))
Text(Value("12.5", "en-US"))
DateValue("2026-11-16", "en-US")
In Power Fx steht mm im Datumsformat für den Monat, bspw. in dd.mm.yyyy. Direkt nach h bzw. hh oder direkt vor ss steht mm für Minuten. Das ist anders als in Power Automate, dort ist MM der Monat und mm die Minute. Für ein festes Format geben Sie die Sprache des Formats mit [$-en-US] und die Ausgabesprache als drittes Argument an. DateDiff zählt ganze Einheiten.
Galerien, Auswahlfelder und Steuerelemente
SortByColumns(
Filter(Orders, StartsWith(Title, txtSearch.Text)),
"DueDate",
SortOrder.Descending
)
Refresh(Orders)
Choices(Orders.Status)
Reset(txtSearch)
txtSearch ist eine klassische Texteingabe. Für eine Vorauswahl verwenden Sie bei einem klassischen Dropdown die Eigenschaft Default und bei einem Kombinationsfeld DefaultSelectedItems.
Meldungen und Navigation
Notify("Saved", NotificationType.Success)
Notify("Please fill in all required fields", NotificationType.Warning, 4000)
Navigate(scrDetails, ScreenTransition.Cover)
Back()
Concurrent(
ClearCollect(colCustomers, Customers),
ClearCollect(colProducts, Products)
)
Concurrent kann die Wartezeit bei unabhängigen Abrufen verkürzen. Jedes ClearCollect bleibt durch das Datenzeilenlimit begrenzt.
JSON
Set(varCartJson, JSON(colCart, JSONFormat.IndentFour))
Text(ParseJSON(varJson).name)
Text(Value(ParseJSON(varJson).orders))
JSON erzeugt Text und gehört in eine Verhaltensformel, bspw. OnSelect. ParseJSON liefert ohne Typangabe einen dynamischen Wert. Konvertieren Sie die benötigten Felder mit der passenden Funktion, bspw. Text(), Value(), Boolean() oder DateValue(), oder geben Sie als zweites Argument einen passenden Typ an. Die Feldnamen müssen genau wie im JSON geschrieben sein. Fehlende Felder und null ergeben Blank().
Zum Testen setzen Sie in OnSelect eines Knopfs Set(varJson, "{""name"":""Contoso"",""orders"":3}") ein und wählen den Knopf einmal aus. Die beiden Label-Beispiele liefern Contoso und 3.
Quellen
- Microsoft Learn (de-de): Patch (öffnet in neuem Tab) · Filter, Search und LookUp (öffnet in neuem Tab) · Sort und SortByColumns (öffnet in neuem Tab) · Choices (öffnet in neuem Tab) · IfError (öffnet in neuem Tab) · Table (öffnet in neuem Tab) · With (öffnet in neuem Tab) · Set (öffnet in neuem Tab) · App-Objekt (öffnet in neuem Tab) · AddColumns (öffnet in neuem Tab) · Text (öffnet in neuem Tab) · DateAdd und DateDiff (öffnet in neuem Tab) · DateValue (öffnet in neuem Tab) · Notify (öffnet in neuem Tab) · JSON (öffnet in neuem Tab) · ParseJSON (öffnet in neuem Tab) · Globale Unterstützung (öffnet in neuem Tab) (Trennzeichen) · Collect, Clear und ClearCollect (öffnet in neuem Tab) · UpdateContext (öffnet in neuem Tab) · Navigate und Back (öffnet in neuem Tab) · Concurrent (öffnet in neuem Tab) · Refresh (öffnet in neuem Tab) · Reset (öffnet in neuem Tab)
- Microsoft Learn: SharePoint-Listen in Power Apps (öffnet in neuem Tab) (de-de, 01.05.2026)
- Microsoft Learn: Verbindung mit SharePoint, delegierbare Funktionen (öffnet in neuem Tab) (de-de, 17.10.2026)
- Power Platform-Blog: Power Apps User Defined Functions GA (öffnet in neuem Tab) (02.09.2025)
- Power Platform-Blog: Power Fx User Defined Types generally available (öffnet in neuem Tab) (13.05.2026)