Définir des événements de carte

Un mappage d’événements dans 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 : 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 sur lequel vous avez cliqué doit être mappé à un gestionnaire d’événements. Le gestionnaire d’événements effectue un clic sur un bouton lorsqu’il est sélectionné par un utilisateur. Par exemple, vous ajoutez une ressource de données, telle qu’un formulaire, et demandez à un gestionnaire d’événements d’avertir l’utilisateur lorsque le formulaire se charge correctement.

Types d'événements

Les types d’événements disponibles dépendent du composant. Par exemple, des événements d’action déclarative sont disponibles pour des composants spécifiques, tels que les composants Barre d’actions et 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 pouvez utiliser 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, utilisez un événement de page. Le tableau suivant décrit chaque type d’événement disponible et fournit quelques exemples sur Générateur d'IU la façon dont vous pouvez utiliser les événements.

Tableau 1. Types et descriptions d’é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, par exemple 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 de page suivants : Mappages d’événements de 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 de ces mappages d’événements sont Page ready (Prêt pour la page) et Page property (Propriété de la 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 d’événements de variantes. Ces mappages d’événements sont enregistrés dans l’enregistrement de variante, qui se trouve 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 à partir des ressources de données héritées. Les mappages d’événements de variante sont utilisés comme des relais afin que les événements répartis à partir des composants sur votre page puissent être relayés jusqu’aux gestionnaires d’événements de session utilisateur. Les mappages sont créés automatiquement lors d’une sauvegarde de 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é à l’événement Lien vers la destination au niveau du canevas, 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 sources pour les mappages d’événements de variantes. Vous pouvez sélectionner +Ajouter pour créer de nouveaux événements expédiés pour votre page. Configurez l’étiquette de l’événement pour remplir automatiquement le nom de l’événement et les champs 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 parent 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 réparti. É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 expédiés pour votre page. Les événements géré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 géré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 selon vos besoins. 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 notifier 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	Liez des éléments de données pour Générateur d'IU 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 Now 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 à Lier un événement à une action déclarative.