Lier un événement à une autre page

Ajoutez un lien vers le gestionnaire d’événements de destination afin Générateur d'IU 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’App Route jusqu’à la page souhaitée.

Avant de commencer

Vous devez avoir 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 gestionnaire d’événement Lien vers la destination. La propriété de lien du composant a priorité sur le gestionnaire d’événements 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 requis 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 Espace de travail d’agent de base. Ceci Next Experience est fourni dans le fichier 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 plus d’informations sur la différence entre la copie et la référence d’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. Assurez-vous de 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 la 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 comporte 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 ou scripts clients nécessaires 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 dans l’expérience vers laquelle vous souhaitez créer un lien.
    Des champs apparaissent pour chacun des paramètres de la page de destination vers 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ètres 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 illustré 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 chemin d’application.

    Si aucune valeur par défaut n’est fournie, ou si vous ne parvenez 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. Toutefois, ils contiennent les valeurs @payload.* applicables pour les paramètres.

Configuration des gestionnaires d’événements pour un composant de questions-réponses d’analyse

Supposons que vous souhaitiez prendre une nouvelle Next Experience page et ajouter une page avec un composant de questions-réponses d’analyse. Tout d’abord, vous créez la page à partir du modèle de page du 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 Analytics Q&A, puis vous configurez un gestionnaire d’événements pour cet événement.

En accédant à Cadre de travail Now Experiences > Expériences, l’application Expérience de test UX s’affiche. Étant donné qu’elle utilise la même interface utilisateur d’interpréteur de commandes d’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 l’espace de travail de test, recherchez un enregistrement de configuration d’application UX sans acheminements ni pages d’application UX, puis cliquez sur Ouvrir.

Comme le montre l’exemple, dans le , vous avez créé une page nommée Centre d’analyse Générateur d'IU, basée sur le modèle de page Centre d’analyse de l’Espace de travail d’agent de base. Ensuite, vous sélectionnez l’option permettant de copier uniquement le contenu du modèle de page.

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, une liste des enregistrements qui contribuent à cette valeur s’affiche également. Dans le champ Itinéraire , vous voyez que la destination doit ê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 liste simple suggérée et charges utiles correspondantes

Paramètre	@payload.* valeur
Table (obligatoire)	@payload.table
listTitle	@payload.listTitle
query	@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 de liste simple. Supposons que vous nommez la page en tant que liste d’enregistrements. Vous suivez ensuite un processus similaire à celui de la création de la page Centre d’analyse. Cette fois, dans les dernières étapes du processus, vous ajouterez la table comme paramètre requis et listTitle, query 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 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 requête , en suivant les informations que vous avez obtenues du gestionnaire d’événements du relais Lien vers la destination . La saisie prédictive vous aide à renseigner ces champs.

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

L’exemple suivant montre une page du centre d’analyse. Sur cette page, vous pouvez entrer une requête pour les incidents par priorité et obtenir un rapport en conséquence. En outre, en cliquant sur une colonne, vous déclenchez un événement Visualisation du rapport cliquée . Le gestionnaire d’événements vous permet d’afficher une liste simple des incidents dans le rapport.

Figure 1. Déclenchement de l’événement configuré Visualisation du rapport cliquée