Définir des événements de carte

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 5 minutes de lecture
  • 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 sur le bouton cliqué doit être mappé à un gestionnaire d’événements. Le gestionnaire d’événements effectue une action d’activation du 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 sont basés sur le 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 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. La table suivante 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 d’événements et descriptions
    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’intégralité de la page. Vous pouvez configurer les événements de page suivants :
    • 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 d’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 variantes, 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 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 d’un enregistrement de page lorsque vous avez mappé l’événement expédié 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 sources 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 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 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 calqués sur 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 en tant que modèle, sélectionnez un modèle et modifiez les champs si nécessaire.

    Volet d’événements au niveau de la page qui affiche les options d’ajout d’événements de page, de variante, expédiés et gérés.

    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 des 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 la récupération 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 la récupération des données a échoué.

    Options d’événement pour une ressource de données.

    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’action déclarative

    Lier des éléments Générateur d'IU de données 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 Now Platform® déclarative. Par 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.