Konfigurer hændelseshandlere for formularformularer for modeldrevne apps

Formularhændelseshandlere til Power Apps-formularer kan konfigureres for følgende områder i en formular:

En hændelseshandler består af en reference til en JavaScript-webressource og en funktion, der er defineret i den pågældende webressource, som udføres, når hændelsen opstår. Der kan være konfigureret op til 50 separate hændelseshandlere for hvert element.

Konfigurer en hændelseshandler

I følgende procedure beskrives det, hvordan du konfigurerer en hændelseshandler for en formular. Brug lignende trin til at konfigurere en hændelseshandler for en fane, en kolonne eller en IFrame.

1. Log på Power Apps, åbn den ønskede tabel, og åbn derefter formularen i formulardesigneren, hvor du vil konfigurere en hændelseshandler.

2. Afhængigt af bibliotekstilstanden skal du vælge mellem følgende indstillinger:

   • Hvis det bibliotek, der indeholder den funktion, du vil angive som hændelseshandler, allerede er tilgængeligt, skal du vælge fanen Hændelser i ruden med egenskaber til højre under Hovedformular til konto og derefter gå til trin 3.
   • Hvis det bibliotek, der indeholder den ønskede funktion, ikke allerede er tilgængeligt, skal du vælge Formularbiblioteker i navigationsruden til venstre og derefter vælge Tilføj bibliotek:
     1. Vælg Ny på siden Tilføj JavaScript-bibliotek.
     2. Under den nye browserfane skal du fuldføre egenskaberne for at oprette JScript-webressourcen og derefter vælge Gem og derefter vælge Publicer. Flere oplysninger: Opret en JavaScript-webressource
     3. Luk browserfanen, og gå tilbage til listen Tilføj JavaScript-bibliotek .
     4. Vælg JavaScript-webressourcen på listen, vælg Tilføj, og vælg derefter fanen Hændelser .

     Notat

     Du skal muligvis vælge Annuller og derefter vælge Tilføj bibliotek for at opdatere listen.

3. Under fanen Hændelser skal du vælge Hændelseshandler og udfylde følgende oplysninger for at konfigurere formularhændelsen og derefter vælge Udført:

   • Hændelsestype:

     • Ved lagring: Når en post gemmes, efter at et formularfelt er ændret.
     • Ved indlæsning: Når formularen åbnes.

   • Bibliotek: JavaScript-webressourcen.

   • Funktion: Navnet på den funktion i JavaScript-webressourcen, der skal udføres for hændelsen.

   • Aktiveret: Hændelseshandleren er som standard aktiveret. Fjern markeringen i afkrydsningsfeltet Aktiveret , hvis du ikke vil aktivere denne hændelse.

   • Overfør udførelseskontekst som den første parameter: Nogle funktioner kræver, at en udførelseskontekst overføres til funktionen. Vælg Overfør udførelseskontekst som den første parameter , hvis det er påkrævet.

   • Kommasepareret liste over parametre, der overføres til funktionen: Nogle funktioner kan acceptere et sæt parametre for at styre funktionsmåden for en funktion. Listen over parametre kan indeholde variabler eller en anden funktion, som accepteres af funktionsparametrene, der tillades af JavaScript-scriptsproget. Hvis det er nødvendigt at angive parametre, skal du angive dem på kommasepareret liste over parametre, der overføres til funktionen.

   • Afhængigheder af tabelkolonner: For hændelser af typen Ved lagring skal du vælge de kolonner, hvor hændelsen skal udløses, når en post er gemt.

     

4. Gem, og udgiv derefter formularen.

Eksempel på hello-verden for onload-hændelsen

Dette enkle eksempel viser, hvordan du konfigurerer en onloadformularhændelse ved hjælp af parameteroverførsel af en enkelt defineret variabel i hændelseshandleren, som viser en besked, når formularen indlæses.

1. Opret webressourcen ved hjælp af JavaScript-eksemplet Hello world. Flere oplysninger: Opret eller rediger webressourcer til modeldrevne apps for at udvide en app
2. Åbn tabellen Hovedformular til redigering i formulardesigneren. I dette eksempel bruges hovedformularen til den brugerdefinerede tabel Student .
3. Vælg fanen Hændelser i ruden Oplysninger til venstre.
4. Vælg Tilføj bibliotek, vælg den webressource, du har oprettet (i dette eksempel hedder ressourcen javascript-hello-world), og vælg derefter Tilføj.
5. Vælg Ved indlæsning for at udvide den, og vælg derefter Hændelseshandler.
6. Angiv funktionsnavnet (i dette eksempel helloworld) i ruden Konfigurer hændelse, og angiv derefter en parameter, f.eks. på n = "Hello world!".
7. Vælg Udført.
8. Gem og publicer formularen.

Test hændelsen ved at afspille en modeldrevet app, der indeholder formularen. Når hovedformularen indlæses, viser en besked den modale dialogboksmeddelelse "Hello world!" I dette eksempel skal brugeren vælge OK for at afvise beskeden for at fortsætte med at bruge formularen.

Hello world JavaScript-eksempel

function helloworld(n) {
alert(n);
}

Konfigurer en hændelseshandler ved hjælp af den klassiske oplevelse

1. I den klassiske formulareditor skal du vælge elementet med den hændelse, du vil konfigurere en handler for.

2. Under Fanen Startside i gruppen i Rediger skal du vælge Skift egenskaber eller blot dobbeltklikke på elementet.

3. I dialogboksen for elementegenskaber skal du vælge fanen Hændelser.

4. Udvid området Formularbiblioteker. Hvis det bibliotek, der indeholder den funktion, du vil angive som hændelseshandler, ikke allerede er angivet, skal du tilføje biblioteket.

5. Sådan føjer du et formularbibliotek til en hændelseshandler:

   1. I sektionen Formularbiblioteker i Hændelsesliste skal du vælge Tilføj.

   2. Find JavaScript-webressourcen på listen over tilgængelige webressourcer. Vælg den, og vælg derefter Tilføj.

      Hvis den JavaScript-webressource, du har brug for, ikke findes, skal du vælge Ny for at åbne en ny webressourceformular og oprette en.

   3. Hvis du vil oprette en JavaScript-webressource, skal du se Opret en JavaScript-webressource.

   4. Den webressource, du har oprettet, er nu valgt i dialogboksen Slå række op . Vælg Tilføj for at lukke dialogboksen.

6. I sektionen Hændelseshandlere skal du vælge den hændelse, for hvilken du vil angive en hændelseshandler.

7. Vælg Tilføj for at åbne dialogboksen Egenskaber for handler.

8. Under fanen Detaljer skal du vælge det relevante bibliotek og skrive navnet på den funktion, der skal udføres for hændelsen.

9. Hændelseshandleren er aktiveret som standard. Fjern markeringen i afkrydsningsfeltet Aktiveret, hvis du ikke vil aktivere denne hændelse.

   Visse funktioner kræver, at der overføres en eksekveringskontekst til funktionen. Vælg Overfør udførelseskontekst som den første parameter , hvis det er påkrævet.

   Visse funktioner kan acceptere et sæt parametre til at styre funktionsmåden af en funktion. Hvis disse er påkrævet, skal du angive dem på kommasepareret liste over parametre, der overføres til funktionen.

10. På fanen Afhængigheder skal du tilføje alle kolonner, som scriptet afhænger af, i området Afhængige kolonner .

11. Vælg OK for at lukke dialogen Egenskaber for handler.

12. Når hændelseshandleren angives, kan du justere den rækkefølge, funktionen udføres i i forhold til andre funktioner, ved hjælp af de grønne pile til at flytte den op eller ned.

13. Vælg OK for at lukke dialogen for elementegenskaber.

14. Vælg Gem for at gemme dine ændringer. Vælg Udgiv for at udgive formularen.

Opret en JavaScript-webressource

1. Angiv følgende egenskaber i webressourceformularen:

   Egenskab	Værdi
   Navn	Påkrævet. Skriv navnet på webressourcen.
   Vis navn	Påkrævet. Skriv navnet, der skal vises på listen over webressourcer.
   Beskrivelse	Valgfrit. Angiv en beskrivelse af webressourcen.
   Type	Påkrævet. Vælg Script (JScript).
   Sprog	Valgfrit. Vælg et af de tilgængelige sprog for din organisation.

2. Hvis du har fået tildelt et script, anbefaler vi på det kraftigste, at du bruger knappen Gennemse til at finde filen og overføre den.

Ellers kan du vælge knappen Teksteditor og indsætte eller skrive indholdet af scriptet i dialogboksen Rediger indhold.

3. Vælg Gem , og luk websidesiden.

Næste trin

Gennemgang: Skriv dit første klientscript
Bruge hovedformularen og dens komponenter