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’itinéraire de l’application 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 le lien vers la destination ne prennent pas en charge le lien vers la gestion d’événement de destination. La propriété du lien du composant a priorité sur le lien vers le gestionnaire d’événements de destination.

Rôle requis : ui_builder_admin

Pourquoi et quand exécuter cette tâche

Pour configurer une action d’événement pour 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 créer un lien 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 système de basefichier . Si vous créez une page à partir d’un modèle de page, vous ne devez copier que le contenu du modèle. N’y faites pas référence. Pour plus d’informations sur la différence entre la copie et le référencement 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 en savoir plus 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 requis et facultatifs pour 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 les 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 pages 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 appropriées. Tous les paramètres d’état ou les 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 de l’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 pertinent 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 s’affichent pour chacun des paramètres sur la page de destination à laquelle l’itinéraire mène. Les paramètres requis 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 le montre 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 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 parvenez toujours pas à trouver 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 de 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 ajouter une nouvelle Next Experience 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 les questions-réponses de l’analyse, 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 Tester l’expérience 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 l’espace de travail de test, recherchez un enregistrement de configuration d’application UX sans acheminement ni page d’application UX, puis cliquez sur Ouvrir.

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

Vous 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 la destination Relais pour l’événement Visualisation du rapport cliqué . Lorsqu’une question dans les questions-réponses de l’analyse 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. Dans le champ Routage , vous voyez que la destination est censée ê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 des charges utiles correspondantes

Paramètre	Valeur @payload.*
Table (obligatoire)	@payload.table
listTitle	@payload.listTitle
requête	@payload.query
disableInlineEditing	aucun

Ensuite, vous accédez à Menu > Créer une page et créez une page basée sur le modèle Liste simple. Supposons que vous nommiez la page Liste d’enregistrements. Vous suivez ensuite un processus similaire à celui que vous avez suivi lors de la création de la page Centre d’analyse. Cette fois-ci, dans les dernières étapes du processus, vous devez ajouter table en tant que paramètre obligatoire et listTitle, query et disableInlineEditing en tant que 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à passés dans les valeurs @context.props.* .

Vous revenez maintenant à la page Centre d’analyse. Dans l’événement Visualisation du rapport cliqué , vous ajoutez un nouveau gestionnaire d’événements. Ensuite, sélectionnez la page de liste Enregistrement 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 Lien vers la destination . La saisie prédictive vous aide à remplir ces champs.

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

L’exemple suivant montre une page 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 Visualisation des rapports cliqué configuré