Configurer des gestionnaires d’événements pour un formulaire
Cette rubrique s’applique à Dynamics 365 Customer Engagement (on-premises). Pour la version Power Apps de cette rubrique, consultez : Configurer des gestionnaires d’événements de formulaire d’application basée sur un modèle
Des gestionnaires d’événements de formulaires pour Dynamics 365 Customer Engagement (on-premises) peuvent être configurés pour les zones suivantes dans un formulaire :
| Élément | Événement | Description |
|---|---|---|
| Formulaire | OnLoad |
Se produit lors du chargement du formulaire. |
OnSave |
Se produit lors de l’enregistrement des données. | |
| Onglet | TabStateChange |
Se produit lorsque l’onglet est développé ou réduit. |
| Champ | OnChange |
Se produit lorsque les données du champ sont modifiées et que le contrôle n’est plus activé. |
| IFRAME | OnReadyStateComplete |
Se produit lors du chargement du contenu d’un IFRAME. |
Un gestionnaire d’événements consiste en une référence à une ressource web JavaScript et à une fonctionnalité définie dans cette ressource web qui s’exécute lorsque l’événement se produit. Chaque élément peut comporter jusqu’à 50 gestionnaires d’événements configurés.
Important
La configuration incorrecte d’un gestionnaire d’événements peut entraîner des erreurs de script qui peuvent provoquer l’échec ou un fonctionnement incorrect du formulaire. Si vous n’êtes pas développeur de script, vous devez impérativement connaître les options de configuration requises par le script.
Ne configurez pas un gestionnaire d’événements de script en utilisant une bibliothèque qui ne provient pas d’une source dans laquelle vous avez confiance. Des scripts peuvent être utilisés pour effectuer une action qu’un utilisateur peut effectuer, et un script mal entré peut réellement dégrader les performances d’un formulaire.
Après avoir configuré un gestionnaire d’événements, vérifiez toujours qu’il fonctionne correctement.
Configurer un gestionnaire d’événements
Dans l’éditeur de formulaires, sélectionnez l’élément avec l’événement pour lequel vous souhaitez configurer un gestionnaire.
Sous l’Onglet Accueil, dans le groupe Modifier, sélectionnez Modifier les propriétés ou double-cliquez sur l’élément.
Dans le dialogue des propriétés de l’élément, sélectionnez l’onglet Événements.
Développez la zone Bibliothèques de formulaires. Si la bibliothèque contenant la fonctionnalité que vous souhaitez définir comme gestionnaire d’événements n’est pas répertoriée, ajoutez-la.
Pour ajouter une bibliothèque de formulaires à un gestionnaire d’événements :
Dans la section Bibliothèques de formulaires de Liste d’événements, sélectionnez Ajouter.
Recherchez la ressource web JavaScript dans la liste des ressources web disponibles. Sélectionnez-la, puis sélectionnez Ajouter.
Si la ressource Web JavaScript dont vous avez besoin n’existe pas, sélectionnez Nouveau pour ouvrir un nouveau formulaire de ressource Web et en créer une.
Pour créer une ressource Web JavaScript :
Dans le formulaire de ressource Web, définissez les propriétés suivantes :
Propriété Valeur Nom Obligatoire. Entrez le nom de la ressource web. Nom d’affichage Obligatoire. Entrez le nom à afficher dans la liste des ressources web. Description Facultatif. Entrez une description de la ressource web. Type Obligatoire. Sélectionnez Script (JScript). Langue Facultatif. Choisissez une des langues disponibles pour votre organisation. Si vous avez un script, il est fortement recommandé d’utiliser le bouton Parcourir pour rechercher le fichier et le télécharger.
Sinon, vous pouvez sélectionner le bouton Éditeur de texte et coller ou taper le contenu du script dans la boîte de dialogue Modifier le contenu.
Note
Comme cet éditeur de texte simple ne fournit pas de fonctionnalité permettant de vérifier la précision du script, essayez toujours d’utiliser une application distincte comme Visual Studio pour modifier des scripts et les télécharger.
Sélectionnez Enregistrer et fermez la boîte de dialogue de la ressource Web.
À ce stade, la ressource Web que vous avez créée est sélectionnée dans la boîte de dialogue Rechercher un enregistrement. Sélectionnez Ajouter pour fermer la boîte de dialogue.
Dans la section Gestionnaire d’événements, sélectionnez l’événement auquel vous souhaitez attribuer un gestionnaire d’événements.
Sélectionnez Ajouter pour ouvrir la boîte de dialogue Propriétés du gestionnaire.
Sous l’onglet Détails, choisissez la bibliothèque appropriée et tapez le nom de la fonctionnalité qui doit être exécutée pour l’événement.
Par défaut, le gestionnaire d’événements est activé. Désactivez la case à cocher Activée si vous ne souhaitez pas activer cet événement.
Certaines fonctionnalités nécessitent la transmission d’un contexte d’exécution à la fonctionnalité. Sélectionnez Transmettre le contexte d’exécution comme premier paramètre si nécessaire.
Certaines fonctionnalités peuvent accepter un ensemble de paramètres pour contrôler le comportement d’une fonctionnalité. S’ils sont obligatoires, entrez-les dans la Liste séparée par des virgules des paramètres transmis à la fonction.
Sous l’onglet Dépendances, ajoutez les champs dont le script dépend dans la zone Champs dépendants.
Sélectionnez OK pour fermer la boîte de dialogue Propriétés du gestionnaire.
Lorsque le gestionnaire d’événements est entré, vous pouvez modifier l’ordre dans lequel la fonctionnalité sera exécutée par rapport aux autres fonctionnalités en utilisant les flèches vertes pour la déplacer vers le haut ou vers le bas.
Sélectionnez OK pour fermer la boîte de dialogue des propriétés de l’élément.
Sélectionnez Enregistrer pour enregistrer vos modifications. Sélectionnez Publier pour publier le formulaire.
Note
Bien que l’interface utilisateur (UI) vous permette d’ajuster l’ordre de chargement des scripts en utilisant les flèches vertes haut et bas, les scripts ne sont en fait pas chargés de manière séquentielle.