Konfigurera händelsehanterare i ett formulär
Det här ämnet gäller för Dynamics 365 Customer Engagement (on-premises). En Power Apps-version för det här ämnet finns i: Konfigurera händelsehanterare för formulär i modellstyrda appar
Händelsehanterare för Dynamics 365 Customer Engagement (on-premises)-formulär kan konfigureras för följande områden i ett formulär:
| Element | Händelse | Beskrivning |
|---|---|---|
| Formulär | OnLoad |
Inträffar när formuläret läses in. |
OnSave |
Inträffar när data sparas. | |
| Tabb | TabStateChange |
Inträffar när fliken visas eller döljs. |
| Fält | OnChange |
Inträffar när data i fältet ändras och kontrollen förlorar fokus. |
| IFRAME | OnReadyStateComplete |
Inträffar när du läser in innehållet i en IFRAME. |
En händelsehanterare består av en referens till en JavaScript-webbresurs och en funktion som har definierats inom den webbresurs och som ska köras när händelsen inträffar. Varje element kan ha upp till 50 separata händelsehanterare konfigurerade.
Viktigt!
Konfigurera en händelsehanterare felaktigt kan orsaka skriptfel som kan medföra att formuläret inte laddas eller fungerar korrekt. Om du inte är utvecklare av skriptet kontrollerar du att du förstår vilka konfigurationsalternativ som skriptet kräver.
Konfigurera inte en skripthändelsehanterare som använder ett bibliotek som inte kommer från tillförlitliga källor. Skript kan användas för att utföra någon åtgärd som en användare kan utföra och ett dåligt skrivet skript kan avsevärt skada prestanda i ett formulär.
När du har konfigurerat en händelsehanterare ska du alltid testa och kontrollera att den fungerar korrekt.
Konfigurera en händelsehanterare
Markera elementet med händelsen du vill konfigurera en hanterare för i formulärredigeraren.
På Startfliken i gruppen Redigera väljer du Ändra egenskaper eller dubbelklickar helt enkelt på elementet.
Markera i egenskapsdialogrutan för element på fliken Händelser.
Expandera området för Formulärbibliotek. Lägg till biblioteket om biblioteket som innehåller funktionen som du vill ange som händelsehanteraren inte redan finns.
Så här lägger du till ett formulärbibliotek i en händelsehanterare:
I avsnittet Formulärbibliotek under Händelselista, väljer du Lägg till.
Leta upp JavaScript-webbresursen i listan över tillgängliga webbresurser. Välj detta alternativ och välj sedan Lägg till.
Om den JavaScript-webbresurs du behöver inte finns väljer du Ny för att öppna ett nytt webbresursformulär och skapar resursen.
Skapa en webbresurs för JavaScript:
Ange följande egenskaper i webbresursformuläret:
Egenskap Värde Namn Obligatoriska. Ange namnet på webbresursen. Visningsnamn Obligatoriska. Skriv namnet som ska visas i listan över webbresurser. Beskrivning Valfritt. Ange en beskrivning av webbresursen. Typ Obligatoriska. Välj Skript (JScript). Språk Valfritt. Välj ett av de tillgängliga språken för din organisation. Om du har fått ett skript, rekommenderar vi att du använder knappen Bläddra för att leta reda på filen och ladda upp den.
Du kan också välja knappen Textredigerare och klistra in eller skriva in innehållet i skriptet i dialogrutan Redigera innehåll.
Kommentar
Eftersom den här enkla textredigeraren inte innehåller några funktioner för att kontrollera riktigheten i skriptet, bör du i allmänhet alltid försöka använda ett separat program som exempelvis Visual Studio för att redigera skript och sedan överföra dem.
Välj Spara och stäng dialogrutan för webbresurser.
I dialogrutan Sök efter post markeras webbresursen du har skapat. Stäng dialogrutan genom att välja Lägg till.
I avsnittet Händelsehanterare, markera den händelse du vill ställa in en händelsehanterare för.
Välj Lägg till för att öppna dialogrutan Egenskaper för hanterare.
På fliken Information, välj rätt bibliotek och ange namnet på den funktion som ska köras för händelsen.
Som standard aktiveras händelsehanteraren. Rensa kryssrutan Aktiverad om du inte vill aktivera den här händelsen.
Vissa funktioner kräver att en körningskontext ska skickas till funktionen. Välj Skicka körningskontext som första parameter om det behövs.
Vissa funktioner kan acceptera en uppsättning parametrar för att styra en funktion. Om dessa krävs, ange dem i Kommaavgränsad lista över parametrar som ska skickas till funktionen.
På fliken Beroenden, lägg till alla fält som skriptet är beroende av i området Beroende fält.
Välj OK om du vill stänga dialogrutan Egenskaper för hanterare.
Du kan justera ordningen där funktionen ska utföras i förhållande till andra funktioner genom att använda de gröna pilarna för att flytta den uppåt eller nedåt när händelsehanteraren anges.
Välj OK för att stänga egenskapsdialogrutan för element.
Välj Spara för att spara dina ändringar. Om du vill publicera formuläret väljer du Publicera.
Kommentar
Du kan välja i vilken ordning skript ska läsas in med hjälp av de gröna uppåt- och nedåtpilarna i användargränssnittet, men skripten läses inte in i ordning.