Freigeben über


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

getContext

Gibt das Objekt Xrm.Page.context zurück. Weitere Informationen finden Sie unter Clientseitiger Kontext (clientseitige Referenz).

getDepth

Gibt einen Wert zurück, der die Reihenfolge angibt, in der dieser Handler ausgeführt wird.

getEventSource

Gibt einen Verweis auf das Objekt zurück, auf dem das Ereignis aufgetreten ist.

getSharedVariable

Ruft eine Variable ab, die mithilfe von setSharedVariable festgelegt wurde.

setSharedVariable

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