Konfigurere hændelseshandlere for en formular
Dette emne gælder for Dynamics 365 Customer Engagement (on-premises). Du kan finde Power Apps-versionen af dette emne under: Konfigurere formularhændelseshandlere i modelbaserede apps
Formularhændelseshandlere til Dynamics 365 Customer Engagement (on-premises)-formularer kan konfigureres for følgende områder i en formular:
| Element | Hændelse | Beskrivelse |
|---|---|---|
| Formular | OnLoad |
Sker, når formularen indlæses. |
OnSave |
Sker, når dataene gemmes. | |
| Fane | TabStateChange |
Sker, når fanen udvides eller skjules. |
| Felt | OnChange |
Sker, når data i feltet ændres, og kontrolelementet mister fokus. |
| IFRAME | OnReadyStateComplete |
Sker, når indholdet af en IFRAME indlæses. |
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 afvikles, når hændelsen sker. Der kan være konfigureret op til 50 separate hændelseshandlere for hvert element.
Vigtigt
Hvis en hændelseshandler konfigureres forkert, kan det medføre scriptfejl, der kan betyde, at formularen ikke indlæses eller ikke fungerer korrekt. Hvis du ikke er den, der har udviklet scriptet, skal du sørge for, at du helt præcis forstår, hvilke konfigurationsindstillinger scriptet kræver.
Undlad at konfigurere en scripthændelseshandler ved hjælp af et bibliotek, der ikke kommer fra en kilde, du har tillid til. Scripts kan bruges til at udføre en handling, som en bruger kan udføre, og et script, der er dårligt skrevet, kan ødelægge ydelsen af en formular i betydeligt omfang.
Når du har konfigureret en hændelseshandler, skal du altid teste, om den virker korrekt.
Sådan konfigurerer du en hændelseshandler
I formulareditoren skal du vælge elementet med den hændelse, du vil konfigurere en handler for.
Under Fanen Startside i gruppen i Rediger skal du vælge Skift egenskaber eller blot dobbeltklikke på elementet.
I dialogboksen for elementegenskaber skal du vælge fanen Hændelser.
Udvid området Formularbiblioteker. Hvis det bibliotek, der indeholder den funktion, du vil angive som hændelseshandleren, ikke allerede vises, kan du tilføje biblioteket.
Sådan føjer du et formularbibliotek til en hændelseshandler:
I sektionen Formularbiblioteker i Hændelsesliste skal du vælge Tilføj.
Find JavaScript-webressourcen på listen over tilgængelige webressourcer. Vælg den, og vælg derefter Tilføj.
Hvis den JavaScript-webressource, du skal bruge, ikke findes, skal du vælge Ny for at åbne en ny formularwebressource og oprette en.
Sådan opretter du en javascript-webressource:
Angiv følgende egenskaber i webressourceformularen:
Egenskab Værdi Navn Krævet. Skriv navnet på webressourcen. Vist navn Krævet. Skriv navnet, der skal vises på listen over webressourcer. Beskrivelse Valgfrit. Angiv en beskrivelse af webressourcen. Skriv Krævet. Vælg Script (JScript). Sprog Valgfrit. Vælg et af de tilgængelige sprog for din organisation. 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.
Bemærk
Da denne enkle teksteditor ikke indeholder nogen funktioner til at kontrollere, om scriptet er korrekt, skal du generelt altid forsøge at bruge et separat program som f.eks. Visual Studio til at redigere scripts og derefter overføre dem.
Vælg Gem, og luk webressourcedialogboksen.
Den webressource, du har oprettet, kan nu vælges i dialogboksen Opslagspost. Vælg Tilføj for at lukke dialogboksen.
I sektionen Hændelseshandlere skal du vælge den hændelse, for hvilken du vil angive en hændelseshandler.
Vælg Tilføj for at åbne dialogboksen Egenskaber for handler.
Under fane Detaljer skal du vælge det rette bibliotek og skrive navnet på den funktion, der skal køres for begivenheden.
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. Markér Overfør konteksten for udførelse som første parameter, hvis det er nødvendigt.
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 i Kommasepareret liste over parametre, der overføres til funktionen.
Under fanen Afhængigheder skal du tilføje de felter, som scriptet afhænger af, området Afhængige felter.
Vælg OK for at lukke dialogen Egenskaber for handler.
Når hændelshandleren er angivet, skal du blot justere den rækkefølge, i hvilken funktionen eksekveres i forhold til andre funktioner, ved at bruge de grønne pile til at flytte den op eller ned.
Vælg OK for at lukke dialogen for elementegenskaber.
Vælg Gem for at gemme dine ændringer. Vælg Udgiv for at udgive formularen.
Bemærk
Du kan bruge brugergrænsefladen til at ændre den rækkefølge, som scriptene indlæses i, ved hjælp af de grønne op- og ned-pile, men scriptene indlæses faktisk ikke sekventielt.