Verwenden von Ausführungskontext und der Formularereignispipeline
Veröffentlicht: Januar 2017
Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
In diesem Thema wird beschrieben, wie die Formularereignispipeline verwendet wird, um mehrere Ereignishandler für ein Ereignis zu verwalten, und wie Ausführungskontext verwendet wird, um JavaScript-Bibliotheksfunktionen für verschiedene Ereignisse wiederzuverwenden.
Ausführungskontext
Wenn Sie eine Funktion in einer JavaScript-Bibliothek zu einem Ereignishandler in Microsoft Dynamics 365 zuordnen, können Sie die Option Ausführungskontext als ersten Parameter übergeben aktivieren. Die folgende Tabelle enthält die Ausführungskontextobjektmethoden.
Methode |
Beschreibung |
|---|---|
Gibt das Objekt Xrm.Page.context zurück. Weitere Informationen finden Sie unter Clientseitiger Kontext (clientseitige Referenz). |
|
Gibt einen Wert zurück, der die Reihenfolge angibt, in der dieser Handler ausgeführt wird. |
|
Gibt einen Verweis auf das Objekt zurück, auf dem das Ereignis aufgetreten ist. |
|
Ruft eine Variable ab, die mithilfe von setSharedVariable festgelegt wurde. |
|
Legt den Wert für eine Variable fest, die von einem Handler verwendet werden kann, nachdem der aktuelle Handler seine Ausführung beendet hat. |
Verwenden Sie die Methode getEventSource in den Funktionen, um sie generischer zu machen. Sie können beispielsweise bei einer Funktion, die eine Telefonnummer formatiert, die getEventSource-Methode verwenden, um auf ein beliebiges Attribut zu verweisen, welches das Ereignis onChange verursacht hat. Die Funktionen brauchen nicht auf ein bestimmtes Attribut zu verweisen.
Formularereignispipeline
Sie können bis 50 Handler für jedes Ereignis Handler definieren. Jeder Handler wird in der Reihenfolge ausgeführt, die auf der Registerkarte Ereignisse des Dialogfelds für Formularelement-Eigenschaften angezeigt wird. Dabei entspricht dies der Liste der <Handler> (FormXml)-Elemente im <Handlers> (FormXml)-Element für ein Ereignis.
Verwenden Sie die Methoden setSharedVariable und getSharedVariable, um eine gemeinsam genutzte Variable zwischen Funktionen zu übergeben. Verwenden Sie die Ausführungskontextmethode getDepth, um die Sequenz zu ermitteln, in der eine Funktion relativ zu anderen Handlern ausgeführt wird.
Siehe auch
Schreiben von Code für Microsoft Dynamics 365-Formulare
Formular- und Feldereignisse verwenden
Verwenden des Xrm.Page-Objektmodells
Verwenden von IFRAME- und Webressourcen-Steuerelementen in einem Formular
Verwendung von JavaScript mit Microsoft Dynamics 365
Microsoft Dynamics 365
© 2017 Microsoft. Alle Rechte vorbehalten. Copyright