Utiliser le contexte d’exécution et le pipeline d’événements de formulaire
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Cette rubrique décrit comment utiliser le pipeline d’événements de formulaire pour gérer plusieurs gestionnaires d’événements pour un événement et, comment utiliser le contexte d’exécution pour réutiliser des fonctionnalités de bibliothèque JavaScript pour divers événements.
Contexte d’exécution
Lorsque vous associez une fonction dans une bibliothèque JavaScript à un gestionnaire d’événements dans Microsoft Dynamics 365, vous pouvez activer l’option Transmettre le contexte d’exécution comme premier paramètre. Le tableau suivant répertorie les méthodes d’objet du contexte d’exécution.
Méthode |
Description |
|---|---|
Renvoie l’objet Xrm.Page.context. Pour plus d'informations, voir Contexte côté client (référence côté client). |
|
Renvoie la valeur indiquant l’ordre dans lequel ce gestionnaire est exécuté. |
|
Renvoie une référence à l’objet sur lequel l’événement s’est produit. |
|
Récupère une variable définie à l’aide de setSharedVariable. |
|
Définit la valeur d’une variable qui peut être utilisée par un gestionnaire une fois que le gestionnaire actuel a terminé. |
Utilisez la méthode getEventSource dans les fonctions pour les rendre plus génériques. Par exemple, si vous avez une fonction qui met un numéro de téléphone en forme, vous pouvez utiliser la méthode getEventSource pour faire référence à l’attribut à l’origine de l’événement onChange. Vos fonctions n’ont pas besoin de référencer un attribut spécifique.
Pipeline d’événements de formulaire
Vous pouvez définir jusqu’à 50 gestionnaires pour chaque événement. Chaque gestionnaire est exécuté dans l’ordre d’affichage dans l’onglet Événements de la boîte de dialogue des propriétés de l’élément du formulaire. Cela correspond à la liste d’éléments <Handler> (FormXml) dans l’élément <Handlers> (FormXml) pour un événement.
Utilisez les méthodes setSharedVariable et getSharedVariable pour passer une variable commune entre les fonctions. Utilisez la méthode getDepth de contexte d’exécution pour connaître la séquence d’exécution d’une fonction par rapport à d’autres gestionnaires.
Voir aussi
Écrire du code pour les formulaires Microsoft Dynamics 365
Utiliser des événements de formulaire et de champ
Utiliser le modèle d’objet Xrm.Page
Utiliser les contrôles IFRAME et de ressource Web dans un formulaire
Utilisation de JavaScript avec Microsoft Dynamics 365
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright