Uitvoeringscontext en de formuliergebeurtenispipeline gebruiken
Gepubliceerd: januari 2017
Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
In dit onderwerp wordt beschreven hoe u het Formuliergebeurtenispipeline kunt gebruiken voor het beheren van meerdere gebeurtenishandlers voor een gebeurtenis en hoe u de uitvoeringscontext kunt gebruiken om JavaScript-bibliotheekfuncties te hergebruiken voor verschillende gebeurtenissen.
Uitvoeringscontext
Wanneer u een functie in een JavaScript-bibliotheek koppelt aan een gebeurtenishandler in Microsoft Dynamics 365, kunt u de optie Uitvoeringscontext doorgeven als eerste parameter inschakelen. De volgende tabel toont de objectmethoden van de uitvoeringscontext.
Methode |
Beschrijving |
|---|---|
Retourneert het Xrm.Page.context-object. Zie Clientcontext (clientreferentie) voor meer informatie. |
|
Retourneert een waarde die de volgorde aangeeft waarin deze handler wordt uitgevoerd. |
|
Retourneert een verwijzing naar het object waarbij de gebeurtenis is opgetreden. |
|
Haalt de variabelenset op met setSharedVariable. |
|
Stelt de waarde van een variabele in die door een hander kan worden gebruikt nadat de huidige handler is voltooid. |
Gebruik de methode getEventSource in functies om deze generieker te maken. Als u bijvoorbeeld een functie hebt die een telefoonnummer opmaakt, kunt u de methode getEventSource gebruiken om te verwijzen naar elk gewenst kenmerk die de gebeurtenis onChange heeft veroorzaakt. Uw functies hoeven niet naar een specifiek kenmerk te verwijzen.
Formuliergebeurtenispipeline
U kunt maximaal 50 handlers definiëren voor elke gebeurtenis. Elke handler wordt uitgevoerd in de volgorde waarin deze op het tabblad Gebeurtenissen van het dialoogvenster met eigenschappen van het formulierelement wordt weergegeven. Dit komt overeen met de lijst van elementen <Handler> (FormXml) in het element <Handlers> (FormXml) voor een gebeurtenis.
Gebruik de methoden setSharedVariable en getSharedVariable om een algemene variabele tussen functies door te geven. Gebruik de methode getDepth van de uitvoeringscontext om de volgorde te weten te komen waarin een functie wordt uitgevoerd in relatie tot andere handlers.
Zie ook
Code schrijven voor Microsoft Dynamics 365-formulieren
Formulier- en veldgebeurtenissen gebruiken
Het objectmodel Xrm.Page gebruiken
IFRAME en webresourcebesturingselementen op een formulier gebruiken
JavaScript gebruiken met Microsoft Dynamics 365
Microsoft Dynamics 365
© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht