Lier un événement à une page

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 5 minutes de lecture
  • Utilisez des mappages d’événements de page pour lier des éléments Générateur d'IU de données afin de pouvoir ajouter des actions d’événement à votre page.

    Avant de commencer

    Rôle requis : ui_builder_admin

    Pourquoi et quand exécuter cette tâche

    Vous pouvez lier un événement à une page à l’aide des types d’événements suivants :
    • Mappages d’événements de page. Ajoutez, supprimez ou désactivez les notifications d’alerte sur votre page.
    • Mappages d’événements de variantes. Ajoutez, supprimez ou désactivez les notifications d’alerte sur votre variante de page.
    • Événements expédiés. Créez des événements répartis pour que votre page crée des mappages d’événements relayés qui modélisent les événements après un gestionnaire d’événements parent. Sélectionnez un gestionnaire d’événements parent cible pour modéliser les champs de charge utile après celui-ci.
    • Événements traités. Un événement géré est un événement qui est exposé et disponible pour utilisation par d’autres utilisateurs. Une fois que vous avez créé un événement géré, il est disponible sous et peut être utilisé par Page event mappings d’autres utilisateurs. Vous pouvez également configurer des champs de charge utile que vous créez manuellement ou choisir un modèle pour votre événement géré, comme une boîte de dialogue modale d’ouverture ou de fermeture.

    Procédure

    1. Accédez à la Tout > Cadre de travail Now Experience > Générateur d'IU.
    2. Ouvrez une expérience dans laquelle travailler ou créez une expérience en sélectionnant Créer > Expérience.
    3. Ouvrez ou créez une page.
      Pour plus d’informations sur la création d’une page dans Générateur d'IU, voir Créer une page dans le générateur d’IU.
    4. Mettez en surbrillance le corps de la page dans l’arborescence de contenu.

      Le corps est la ligne de niveau supérieur de l’arborescence de contenu. Lorsque vous mettez en surbrillance l’ensemble de la page, vous pouvez ajouter des événements au niveau de la page.

      Flèche pointant vers l’option de corps dans l’arborescence de contenu.
    5. Dans le panneau de configuration, sélectionnez l’onglet Événements .
      Panneau de configuration avec l’onglet Événements.
    6. Ajoutez un gestionnaire d’événements de l’une des façons suivantes.
      Pour ajouter ce gestionnaire d’événementsEffectuez cette action
      Mappages d'événements de la page Page ready Événement source :
      1. Sélectionnez Ajouter un gestionnaire d’événements.
      2. Pour ajouter, supprimer ou supprimer des notifications d’alerte de la page, choisissez un gestionnaire d’événements dans Page-level event handlers. Vous pouvez ajouter, supprimer ou supprimer des notifications d’alerte sur votre page.
      3. Pour ajouter le gestionnaire d’événements à votre page, sélectionnez Ajouter.
      Page property changed Événement source :
      1. Sélectionnez Ajouter un nouveau gestionnaire d’événements.
      2. Choisissez un gestionnaire d’événements dans Page-level event handlers. Vous pouvez ajouter, supprimer ou supprimer des notifications d’alerte sur votre page. Vous pouvez également choisir Définir l’état de chargement pour afficher le mot Chargement sur votre page afin que les utilisateurs puissent voir que la page est en cours de chargement. Vous pouvez également sélectionner Mettre à jour le paramètre d’état du client pour modifier le nom de l’état du client.
      3. Pour ajouter le gestionnaire d’événements à votre page, cliquez sur Ajouter.
      Mappage des variantes d'événements Mappage des variantes d'événements

      Vous devez disposer d’une page de variante pour effectuer un mappage d’événements de variante. Les mappages d’événements de variante disponibles dépendent de la page de variante. Si la page de variante comporte une liste, vous pouvez ajouter des gestionnaires d’événements pour des éléments tels que Ligne cliquée, Élément de navigation, et ainsi de suite. Lorsque la variante dispose d’un Viewport, vous pouvez avoir différents gestionnaires d’événements à configurer.

      1. Sélectionnez Ajouter des mappages d’événements. Par exemple, vous pouvez ajouter un nouveau gestionnaire d’événements pour la ligne sélectionnée.
      2. Sélectionnez un gestionnaire d’événements dans la liste des gestionnaires d’événements hérités disponibles ou des gestionnaires d’événements locaux tels que la source de données de l’interpréteur de commandes de l’application UXR.
      3. Pour ajouter le gestionnaire d’événements à votre variante, sélectionnez Ajouter.

      Options de gestionnaire d’événements de variante.

      • Ces mappages d’événements se trouvent 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.
      • Ces mappages d’événements sont utilisés comme des relais afin que les événements qui sont répartis à partir des composants sur votre page soient relayés vers les gestionnaires de session utilisateur.
      • Ces mappages sont automatiquement créés lors d’une sauvegarde de page lorsque vous avez mappé l’événement réparti d’un composant à un autre événement. Par exemple, lorsque vous mappez un Button clicked événement à l’événement Link to destination , l’événement crée un événement de relais réparti et un mappage d’événement de variante après l’enregistrement de la page.
      Événements expédiés
      1. Sélectionnez Événements expédiés.
      2. Sélectionnez l’icône +Ajouter..
      3. Dans l’écran Ajouter un événement , procédez comme suit :
        • Saisissez une étiquette pour votre événement.
        • Sélectionnez un gestionnaire d’événements parent cible.
      4. Pour ajouter le gestionnaire d’événements à vos événements répartis, sélectionnez Ajouter.

        Créez une boîte de dialogue d’événement.

      5. Le nouveau gestionnaire d’événements que vous avez créé apparaît dans Événements expédiés. L’exemple suivant montre comment ajouter un gestionnaire d’événements Link to destination .

        Gestionnaire d’événements ajouté aux événements expédiés.

      • Ces événements se trouvent 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.

      • Pour créer de nouveaux événements répartis pour votre page, sélectionnez l’icône +Ajouter.. 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 souvent utilisés pour créer des mappages d’événements de relais. Vous pouvez sélectionner un Target parent event handler modèle des 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 source pour les mappages d’événements de page.

      • Pour créer de nouveaux événements répartis pour votre page, sélectionnez l’icône +Ajouter.. Ces événements 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.

    7. Sélectionnez Enregistrer.
    8. Pour prévisualiser votre page et tester l’événement de ressource de données que vous avez configuré, sélectionnez le bouton Aperçu.