Définir des événements de carte

Un mappage d’événements Générateur d'IU est le processus qui vous permet de mapper la charge utile ou les valeurs contextuelles d’un événement à l’objet ou au gestionnaire qui agit sur cet événement. Les quatre types d’événements sont les suivants : composant, page, ressource de données et action déclarative.

Le mappage d'événements est un processus important au sein de Générateur d'IU. Lorsque vous créez des pages avec des composants, vous avez besoin de ces composants pour effectuer des actions pour les utilisateurs. Par exemple, si vous ajoutez un composant de bouton à la page, un événement de clic sur un bouton doit être mappé à un gestionnaire d’événements. Le gestionnaire d’événements effectue une action de clic sur le bouton lorsqu’il est sélectionné par un utilisateur. Par exemple, lorsque vous ajoutez une ressource de données, telle qu’un formulaire, et qu’un gestionnaire d’événements avertit l’utilisateur lorsque le formulaire se charge correctement.

Types d'événements

Les types d’événements disponibles dépendent du composant. Par exemple, les événements d’action déclarative sont disponibles pour des composants spécifiques, tels que la barre d’actions et les composants de liste.

Vous choisissez un type d’événement en fonction de l’action que vous souhaitez effectuer sur votre page. Par exemple, si vous souhaitez lier une action à un composant, tel qu’un bouton chargeant une page Web, vous utiliserez un événement de composant. Si vous souhaitez qu’un événement s’applique à l’ensemble de votre page, comme l’ajout d’une notification d’alerte à une page, vous utilisez un événement de page. Le tableau suivant décrit chaque type d’événement disponible dans Générateur d'IU et fournit des exemples sur la façon dont vous pouvez utiliser les événements.

Tableau 1. Types et descriptions des événements

Type d'événement	Description
Événements de composant	Action que vous configurez pour un composant. Vous configurez un gestionnaire d’événements pour configurer l’action de ce composant. Par exemple, ajoutez un gestionnaire d’événements pour appliquer une action à un bouton, comme accéder à une page Web. Pour plus d’informations sur la liaison d’événements à des composants, reportez-vous à la section Lier un événement à un composant.
Événements de page	Événement de page qui effectue une action pour l’ensemble de la page. Vous pouvez configurer les événements suivants de la page : Mappages d’événements de la page. Ces mappages d’événements sont enregistrés dans l’enregistrement de définition de page, qui se trouve dans la table [sys_ux_macroponent]. Les événements sources pour ces mappages d’événements sont Page prête et Propriété de page. Ils sont définis pour votre page. Les gestionnaires disponibles pour ces mappages d’événements sont les suivants : Événements de session utilisateur Événements au niveau de la page Source de données de l'interpréteur de commandes de l'application UXR Scripts clients définis sur la page Opérations à partir des ressources de données locales et héritées Mappages des variantes d’événements. Ces mappages d’événements sont enregistrés dans l’enregistrement de variante, que vous pouvez trouver dans la table [sys_ux_screen]. Les événements sources de ces mappages d’événements sont tous les événements répartis qui sont définis pour votre page. Les gestionnaires disponibles pour ces mappages d’événements sont les événements au niveau du canevas, la source de données de l’interpréteur de commandes de l’application UXR et les opérations des ressources de données héritées. Les mappages d’événements de variantes sont utilisés comme relais afin que les événements répartis à partir des composants de votre page puissent être relayés jusqu’aux gestionnaires d’événements de session utilisateur. Les mappages sont créés automatiquement lors de l’enregistrement d’une page lorsque vous avez mappé l’événement réparti d’un composant à un gestionnaire de session utilisateur. Par exemple, en mappant un événement Bouton cliqué au niveau du canevas Lien vers l’événement de destination , l’événement crée un événement de relais réparti et un mappage d’événement de variante lorsque la page est enregistrée. Événements expédiés. Ces événements sont enregistrés dans la table [sys_ux_event]. L’enregistrement de définition de page contient des références à l’enregistrement [sys_ux_event]. Ces événements servent d’événements source pour les mappages d’événements de variantes. Vous pouvez sélectionner +Ajouter pour créer de nouveaux événements répartis pour votre page. Configurez l’étiquette de l’événement pour remplir automatiquement les champs de nom d’événement et de charge utile pour votre nouvelle sys_ux_event. Ces événements sont utilisés pour créer des mappages d’événements de relais. Vous pouvez sélectionner un gestionnaire d’événements principal cible pour modéliser les champs de charge utile après l’événement sélectionné. Vous pouvez également créer manuellement des champs de charge utile pour votre événement expédié. Événements traités. Ces événements sont enregistrés dans la table [sys_ux_event]. L’enregistrement de définition de page contient des références à l’enregistrement [sys_ux_event]. Ces événements servent d’événements sources pour les mappages d’événements de page. Vous pouvez sélectionner +Ajouter pour créer de nouveaux événements répartis pour votre page. Les événements traités ne sont pas modélisés d’après les gestionnaires d’événements parents. Les champs de charge utile pour les événements traités sont créés manuellement. Pour utiliser les champs de charge utile d’un gestionnaire existant comme modèle, sélectionnez un modèle et modifiez les champs si nécessaire. Pour plus d’informations sur la liaison d’un événement à une page, reportez-vous à la section Lier un événement à une page.
Événements de ressources de données	Événements mappés aux ressources de données pour fournir des notifications sur le moment où les données sont extraites. Extraction de données lancée. Lorsqu’un événement de ressource de données est déclenché, le gestionnaire d’événements exécute le processus d’extraction des données. Récupération des données réussie. Lorsqu’un événement de ressource de données est déclenché, le gestionnaire d’événements exécute le processus pour avertir un utilisateur lorsque l’extraction des données est terminée avec succès. Échec de l’extraction des données. Lorsqu’un événement de ressource de données est déclenché, le gestionnaire d’événements exécute le processus pour notifier un utilisateur si l’extraction des données a échoué. Pour plus d’informations sur la liaison d’un événement à une ressource de données, reportez-vous à la section Lier un événement à une ressource de données.
Événements d’actions déclaratives	Lier des éléments de données à l’intérieur Générateur d'IU pour ajouter des actions d’événement à une action déclarative. Vous configurez un mappage d’événements d’action déclarative dans la table d’affectation d’action ServiceNow AI Platform® déclarative. Pour obtenir un exemple, accédez à Rechercher > sys_declarative_action_assignment.liste puis recherchez et ouvrez une action déclarative existante. Dans Générateur d'IU, vous liez un événement à l’action déclarative. Pour plus d’informations sur l’utilisation des événements d’action déclarative, reportez-vous à la section Lier un événement à une action déclarative.