Lier un événement à une page

Utilisez les mappages d’événements de page pour lier les é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. Ajouter, supprimer ou effacer les notifications d’alerte sur votre page.
• Mappages des variantes d’événements. Ajouter, supprimer ou effacer 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 traité est un événement qui est exposé et disponible pour être utilisé 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é, par exemple ouvrir ou fermer une boîte de dialogue modale.

Procédure

1. Accédez à la Tous > 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.
   Consultez Configurer la façon dont les utilisateurs interagissent avec vos applications dans Générateur d'IU pour plus d'informations.
3. Ouvrez ou créez une page.
   Pour plus d’informations sur la création d’une page dans , consultez Créer une page dansGénérateur d'IU UI Builder.
4. Mettez le corps de la page en surbrillance 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.

   
5. Dans le panneau de configuration, sélectionnez l’onglet Événements .
   
6. Ajoutez un gestionnaire d’événements de l’une des façons suivantes.

   Pour ajouter ce gestionnaire d’événements	Effectuez cette action
   Mappages d'événements de la page	Page ready Événement source : Sélectionnez Ajouter un gestionnaire d’événements. Pour ajouter, supprimer ou effacer les notifications d’alerte de la page, choisissez un gestionnaire d’événements dans Page-level event handlers. Vous pouvez ajouter, supprimer ou effacer les notifications d’alerte sur votre page. Pour ajouter le gestionnaire d’événements à votre page, sélectionnez Ajouter. Page property changed Événement source : Sélectionnez Ajouter un nouveau gestionnaire d’événements. Choisissez un gestionnaire d’événements dans Page-level event handlers. Vous pouvez ajouter, supprimer ou effacer les 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 le paramètre Mettre à jour l’état du client pour modifier le nom de l’état du client. 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 avoir 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 ajoutez des gestionnaires d’événements pour des éléments tels que Ligne sélectionnée, Élément de navigation, etc. Lorsque la variante dispose d’un Viewport, vous pouvez avoir différents gestionnaires d’événements à configurer. Sélectionnez Ajouter des mappages d’événements. Par exemple, vous pouvez ajouter un nouveau gestionnaire d’événements pour Ligne sélectionnée. 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. Pour ajouter le gestionnaire d’événements à votre variante, sélectionnez Ajouter. Ces mappages d’événements se trouvent 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. Ces mappages d’événements sont utilisés en tant que relais afin que les événements répartis à partir des composants de votre page soient relayés aux gestionnaires de session utilisateur. Ces mappages sont automatiquement créés sur 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 une variante de mappage d’événement après l’enregistrement de la page.
   Événements expédiés	Sélectionnez Événements expédiés. Sélectionnez . Sur l’écran Créer un événement , effectuez les actions suivantes : Saisissez une étiquette pour votre événement. Sélectionnez un gestionnaire d’événements parent cible. Pour ajouter le gestionnaire d’événements à vos événements expédiés, sélectionnez Ajouter. 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 . 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 variante. Pour créer de nouveaux événements expédiés pour votre page, sélectionnez . 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 souvent utilisés pour créer des mappages d’événements de relais. Vous pouvez en sélectionner un Target parent event handler 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. Pour créer de nouveaux événements expédiés pour votre page, sélectionnez . Ces événements 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.

7. Sélectionnez Enregistrer.
8. Pour prévisualiser votre page et tester l’événement de ressource de données que vous configurez, sélectionnez