Händelser i formulär och rutnät i modelldrivna appar

Händelser i formulär och rutnät initierar all kod på klientsidan i modelldrivna appar. Du associerar en specifik funktion i ett JavaScript-bibliotek (skriptwebbresurs) som ska köras när en händelse inträffar. Den här funktionen kallas för händelsehanterare. Varje händelsehanterare anger en enskild funktion i ett JavaScript-bibliotek och alla parametrar som kan skickas till funktionen.

Du kan bara associera händelsehanterare till vissa händelser med hjälp av användargränssnittet. För händelser som du inte kan associera via användargränssnittet tillhandahåller klient-API metoder som du kan använda för att koppla händelsehanterare.

Lägga till eller ta bort händelsehanterarfunktioner i formulär med hjälp av användargränssnittet

Så här lägger du till eller tar bort händelsehanterarfunktioner för händelser i det nya enhetliga gränssnittet:

  1. Gå till Power Apps.

  2. I det vänstra navigeringsfönstret väljer du Data och sedan Tabeller.

  3. I listan med tabeller väljer du den tabell där du vill lägga till händelsehanterarna.

  4. Välj fliken Formulär i kommandofältet och välj sedan det formulär där du vill lägga till händelsehanteraren.

    Skärmbild av fliken Formulär som visar listan över formulär för en tabell i Power Apps.

  5. Välj fliken Händelser . Du ser både händelsehanterarna Vid spara och Vid inläsning .

    Skärmbild av fliken Händelser som visar händelsehanterare för formuläret Vid spara och Vid inläsning.

  6. Om du vill lägga till en händelsehanterare för ändringshändelsen väljer du kolumnen och väljer sedan fliken Händelse .

    Skärmbild av kolumnen Händelser som visar händelsehanterarinställningarna vid ändring.

Massredigeringsformulär

Som standard körs inte händelsehanterare när ett formulär är i massredigeringsläge.

Om du vill aktivera en händelsehanterare i massredigeringsläge ändrar du formulär-XML genom att hitta det relevanta event elementet och skapa eller ange BehaviorInBulkEditForm attributet till Enabled. För närvarande stöds det här beteendet endast för OnLoad-händelser.

Mer information om xml-anpassning av formulär finns i När du vill redigera anpassningsfilen, Anpassa formulär och XML-schema för formulär.

Använd metoden för att avgöra när en händelsehanterare körs i ett formulär i massredigeringsläge getFormType .

Lägga till eller ta bort händelsehanterarfunktioner med hjälp av klient-API-kod

Använd följande metoder för att lägga till och ta bort händelsehanterare för händelser som du inte kan associera via användargränssnittet:

Evenemang Händelsehanterare
Attributet OnChange addOnChange- och removeOnChange-metoder
Formulär onload formContext.ui addOnLoad och removeOnLoad-metoder
Formuläret har lästs in formContext.ui addLoaded och removeLoaded-metoder
Formulärdata OnLoad formContext.data addOnLoad och removeOnLoad-metoder
Formulär påspara addOnSave- och removeOnSave-metoder
Uppslagskontroll PreSearch addPreSearch och removePreSearch-metoder
kbsearch control OnResultOpened addOnResultOpened och removeOnResultOpened-metoder
kbsearch-kontroll OnSelection addOnSelection- och removeOnSelection-metoder
kbsearch control PostSearch addOnPostSearch- och removeOnPostSearch-metoder

Viktigt!

Körningskontexten skickas automatiskt som den första parametern till funktioner som du anger med hjälp av koden. Mer information finns i Körningskontext för klient-API.

Pipeline för formulärhändelse

Du kan definiera upp till 50 händelsehanterare för varje händelse. Avsnittet Händelsehanterare på fliken Händelser i dialogrutan Formuläregenskaper visar ordningen på händelsehanterare och varje händelsehanterare körs i den ordningen.

Använd metoderna setSharedVariable och getSharedVariable för att skicka en gemensam variabel mellan händelsehanterare (funktioner). Använd metoden getDepth för körningskontext för att förstå sekvensen av händelsehanterarkörning i förhållande till andra händelsehanterare.

Förstå klient-API-objektmodellen
Klient-API-körningskontext
Händelser (klient-API-referens)