Dela via


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

Händelser initierar all kod på klientsidan. I modelldrivna appar associerar du 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 inte är tillgängliga för att associeras via användargränssnittet tillhandahåller klient-API metoder som kan användas för att koppla händelsehanterare till sådana händelser.

Lägga till eller ta bort händelsehanterarfunktionen i händelsen med hjälp av användargränssnittet

Använd avsnittet Händelsehanterare i dialogrutan Formuläregenskaper för att associera skriptet med en händelse för formulär och kolumner.

Avsnittet Händelsehanterare i Formuläregenskaper.

Massredigeringsformulär

Som standard anropas 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/ange BehaviorInBulkEditForm attributet till Enabled. För närvarande stöds detta endast för OnLoad-händelser.

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

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

Lägga till eller ta bort händelsehanterarfunktionen i händelsen med hjälp av kod

Använd följande metoder för att lägga till och ta bort händelsehanterare för händelser som inte kan associeras 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 anges med hjälp av koden. Mer information: Klient-API-körningskontext

Pipeline för formulärhändelse

Du kan definiera upp till 50 händelsehanterare för varje händelse. Varje händelsehanterare körs i den ordning som den visas i avsnittet Händelsehanterare på fliken Händelser i dialogrutan Formuläregenskaper .

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 känna till sekvensen som en händelsehanterare körs i i förhållande till andra händelsehanterare.

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