Définir des événements de carte

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 5 minutes de lecture
  • Un mappage d’événements est Générateur d'IU 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é sur un bouton 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, les événements d’action déclarative sont disponibles pour des composants spécifiques, tels que la barre d’action 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 devez utiliser un événement de composant. Si vous souhaitez qu’un événement s’applique à l’ensemble de votre page, par exemple l’ajout d’une notification d’alerte à une page, 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 composants Action que vous configurez pour un composant. Vous configurez un gestionnaire d’événements pour configurer cette action de composant. Par exemple, ajoutez un gestionnaire d’événements pour appliquer une action pour 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 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 pour ces mappages d’événements sont Page prête et 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 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 des variantes d’événements.
      • 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 pour 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 variante 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 sur 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 sélectionné à 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 variante.

      • 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 renseigner automatiquement le nom de l’événement et les champs de charge utile de 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 Target 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 expédiés 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 traité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 au besoin.

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

    Pour plus d’informations sur la liaison d’un événement à une page, consultez 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 s’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 la récupération des données a échoué.

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

    Pour en savoir plus 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 les é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 Now Platform® déclarative. Pour obtenir un exemple, accédez à Rechercher > sys_declarative_action_assignment.list , 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.