Lier un événement à une page

Utilisez les mappages d’événements de page pour y 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 la page. Ajoutez, supprimez ou effacez les notifications d’alerte sur votre page.
• Mappages d’événements de variantes. Ajoutez, supprimez ou effacez les notifications d’alerte sur votre variante de page.
• Événements expédiés. Créez des événements répartis pour votre page afin de créer 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 principal 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 Page event mappings que d’autres utilisateurs peuvent l’utiliser. 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é, tel qu’une boîte de dialogue modale Ouvrir ou fermer.

Procédure

1. Accédez à la Tout > Cadre de travail Now Experience > Générateur d'IU.
2. Ouvrez une expérience pour y travailler ou créez une expérience en sélectionnant Créer > Expérience.
   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 Générateur d'IU, consultez 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 la page entière, 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 des 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 Mettre à jour le paramètre de 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 disposer d’une page de variantes 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 contient 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 comme 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 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 des ressources de données héritées. Ces mappages d’événements sont utilisés comme relais pour que les événements répartis à partir des composants de votre page soient relayés jusqu’aux gestionnaires de session utilisateur. Ces mappages sont automatiquement créés lors d’un enregistrement de page lorsque vous avez mappé l’événement expédié 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	Sélectionnez Événements expédiés. Sélectionnez . Dans l’écran Ajouter un événement , effectuez les actions suivantes : Saisissez une étiquette pour votre événement. Sélectionnez un gestionnaire d’événements principal 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 figurent 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 . 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 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 répartis 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 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.

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 le .