Lier un événement à une autre page

Ajoutez un lien vers le gestionnaire d’événements de Générateur d'IU destination afin qu’une action d’événement puisse ouvrir une autre page. Vous pouvez également configurer le gestionnaire d’événements pour qu’il suive l’itinéraire de l’application jusqu’à la page souhaitée.

Avant de commencer

Vous devez disposer d’une page d’espace de travail qui contient un composant destiné à ouvrir une autre page lorsqu’un utilisateur clique dessus. La vue d’ensemble du tableau de bord est un exemple d’un tel composant. Les composants tels que Lien vers la destination ne prennent pas en charge le descripteur d’événement lien vers la destination. La propriété de lien du composant a priorité sur le gestionnaire d’événements de lien vers la destination.

Rôle requis : ui_builder_admin

Pourquoi et quand exécuter cette tâche

Pour configurer une action d’événement afin d’ouvrir une autre page, vous devez savoir quelle page vous souhaitez ouvrir, quels sont les paramètres obligatoires et facultatifs pour cette page, et quelles valeurs de charge utile définir sur le gestionnaire d’événements pour transmettre les paramètres requis à la page de destination.

Conseil :

Vous pouvez trouver des exemples des composants à partir desquels vous souhaitez lier et des pages de destination vers lesquelles vous souhaitez créer un lien dans l’expérience d’Espace de travail d’agent de base. Ceci Next Experience est fourni dans le .système de base Si vous créez une page à partir d’un modèle de page, vous ne devez copier que le contenu du modèle. Ne le référencez pas. Pour en savoir plus sur la différence entre copier et référencer un modèle de page, reportez-vous à la section Créer une page à partir d'un modèle.

Procédure

1. Ouvrez votre expérience dans Générateur d'IU.
2. Facultatif : Si la page de destination n’existe pas dans votre expérience, créez-en une.
   Pour plus d’informations sur la création de pages, reportez-vous à la section Créer une page dans Générateur d'IU. Veillez à définir les paramètres obligatoires et facultatifs de la page afin de pouvoir l’utiliser comme destination. Si un composant particulier de la page est une destination, vous devez inclure ce composant. Vous devez également configurer les propriétés sur le composant pour utiliser les paramètres de page avec des valeurs @context.props.<parameter-name> .

   Vous pouvez envisager de créer la page à partir d’un modèle de page. L’expérience Espace de travail d’agent de base dispose de plusieurs modèles de page qui sont déjà configurés pour être des destinations pour d’autres composants. Si vous créez une page de destination à partir d’un modèle, les composants sont déjà configurés avec les propriétés correctes. Tous les paramètres d’état nécessaires ou les scripts clients sont également copiés. Vous devez ajouter les paramètres de la page. Vous pouvez copier ces paramètres à partir de la liste connexe Chemins de l’application UX sur l’enregistrement de configuration de l’application Agent [sys_ux_app_config] de l’expérience qui contient les modèles de page.

   Pour vous assurer que les pages que vous créez fonctionnent de manière fiable en tant que destinations dans votre expérience, votre expérience doit avoir la même interface utilisateur d’interpréteur de commandes d’application que l’expérience avec les modèles de page.

3. Basculez vers la page que vous souhaitez lier à la page de destination.
4. Accédez au composant approprié et sélectionnez-le.
5. Sélectionnez l'onglet Événements.
6. Sélectionnez + Ajouter un mappage d’événements.
7. Sélectionnez l’événement que vous souhaitez utiliser.
8. Sélectionnez + Ajouter un gestionnaire d’événements.
9. Dans la section Gestionnaires d’événements hérités, sélectionnez Lien vers la destination.
   
10. Cliquez sur Sélectionner la destination.
    
11. Développez Pages et sélectionnez la page de l’expérience vers laquelle vous souhaitez créer un lien.
    Des champs apparaissent pour chacun des paramètres sur la page de destination à laquelle mène l’itinéraire. Les paramètres obligatoires sont marqués d’un astérisque (*).
12. Renseignez chaque champ de paramètre requis et les champs de paramètre applicables avec une valeur @payload.* appropriée.
    Si les développeurs de votre composant ont inclus des valeurs de charge utile par défaut dans votre événement, vous pouvez en sélectionner une via la saisie semi-automatique. Comme indiqué dans l’exemple suivant, la valeur de la charge utile peut ne pas correspondre au nom du paramètre.

    

    Remarque :

    Vous avez la possibilité de créer un lien vers une URL externe au lieu de spécifier un itinéraire d’application.

    Si aucune valeur par défaut n’est fournie, ou si vous ne pouvez pas déterminer quelles valeurs sont correctes pour certains champs, reportez-vous à la documentation de configuration et d’API du composant dans le Site ServiceNow® Developer. Si vous ne trouvez toujours pas les valeurs @payload.* nécessaires, contactez Service et assistance client.

    Conseil :

    Si vous créez votre composant de liaison en créant une page à partir d’un modèle de page Espace de travail d’agent de base, le composant contient des gestionnaires d’événements de relais Lien vers la destination. Ces gestionnaires d’événements ne fonctionnent pas. Cependant, ils contiennent les valeurs @payload.* applicables pour les paramètres.

Configuration des gestionnaires d’événements pour un composant d’analyse Q&A

Supposons que vous souhaitiez ajouter une nouvelle Next Experience page avec un composant de questions-réponses d’analyse. Commencez par créer la page à partir du modèle de page Centre d’analyse fourni dans l’expérience Espace de travail d’agent de base. Ensuite, vous créez une page cible pour le premier des trois événements dans les questions-réponses d’Analytics, puis vous configurez un gestionnaire d’événements pour cet événement.

En accédant à Cadre de travail Now Experiences > Expériences, vous voyez l’application Test experience UX. Étant donné qu’il utilise la même interface utilisateur de l’interpréteur de commandes de l’application Espace de travail d’agent que l’Espace de travail d’agent de base, vous pouvez utiliser les modèles de page de l’Espace de travail d’agent de base.

Sélectionnez ensuite le panneau d’administration de Test workspace, recherchez un enregistrement de configuration d’application UX sans acheminements ni pages d’application UX, puis cliquez sur Ouvrir.

Sélectionnez le composant Questions et réponses d’analyse 1 et ouvrez l’onglet Événements . À partir d’ici, vous pouvez ouvrir le gestionnaire d’événementsLien vers le relais de destination pour l’événement Visualisation de rapport cliquée . Lorsqu’une question dans l’analyse Q&A renvoie un rapport, vous pouvez déclencher cet événement en cliquant sur une valeur dans le rapport. Lorsque vous cliquez sur une valeur, la liste des enregistrements qui contribuent à cette valeur s’affiche également. Dans le champ Itinéraire , vous voyez que la destination devrait être une page basée sur le modèle de page Liste simple. Vous voyez également les paramètres de la page auxquels correspondent les valeurs @payload.* et que le champ Titre peut être renseigné avec @payload.listTitle.

Tableau 1. Paramètres de la page de destination de la liste simple suggérée et charges utiles correspondantes

Paramètre	@payload.* valeur
Table (obligatoire)	@payload.table
listTitle	@payload. Titre de liste
requête	@payload.requête
disableInlineEditing	aucun

Ensuite, vous accédez à Menu > Créer une page et créer une page basée sur le modèle Liste simple. Supposons que vous nommez la page en tant que liste d’enregistrements. Vous suivez ensuite un processus similaire à celui de la page Centre d’analyse. Cette fois, dans les dernières étapes du processus, vous ajouterez table comme paramètre obligatoire et listTitle,requête et disableInlineEditing comme paramètres facultatifs.

Étant donné que cette page contient déjà un composant Liste, lorsque vous ouvrez l’onglet Configuration de ce composant, vous voyez que les paramètres sont déjà transmis dans les valeurs @context.props.* .

Vous revenez maintenant à la page Analytics Center (Centre d’analyse). Dans l’événement Visualisation de rapport cliquée , vous ajoutez un nouveau gestionnaire d’événements. Ensuite, vous sélectionnez la page de liste d’enregistrements que vous avez créée et ajoutez les valeurs @payload.* dans les champs table, listTitle et query , en suivant les informations que vous avez obtenues du gestionnaire d’événements Lien vers le relais de destination. Le typage prédictif vous aide à remplir ces champs.

Une fois que vous avez cliqué sur OK et ajouté @payload.listTitle comme titre, le gestionnaire d’événements est terminé. Vous pouvez maintenant supprimer le gestionnaired’événements du relais Lien vers la destination pour cet événement.