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 vers 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 handle d’événement de lien vers la destination. La propriété de 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 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 créer un lien et des pages de destination vers lesquelles vous souhaitez créer un lien dans l’expérience Agent Workspace 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 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 consommer 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 Agent Workspace 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 de l’interpréteur de commandes d’application que l’expérience avec les modèles de page.

3. Passez à 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 apparaissent 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. Complétez chaque champ de paramètre obligatoire 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 l’exécution 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 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, consultez la documentation de configuration et d’API pour le 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 Q&A 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 Agent Workspace 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 Expérience de test UX. Étant donné qu’elle utilise la même interface utilisateur de l’interpréteur de commandes de l’application Agent Workspace que l’Agent Workspace de base, vous pouvez utiliser les modèles de page à partir de l’Agent Workspace de base.

Ensuite, sélectionnez le panneau d’administration de l’espace de travail de test, recherchez un enregistrement de configuration d’application UX sans itinéraires ni pages d’application UX, puis cliquez sur Ouvrir.

Comme le montre l’exemple, dans , Générateur d'IUvous avez créé une page nommée Centre d’analyse qui est basée sur le modèle de page Centre d’analyse de l’Agent Workspace de base. Ensuite, vous sélectionnez l’option permettant de copier uniquement le contenu 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 le relais de destination pour l’événement Visualisation du rapport cliquée . 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	@payload.* valeur
Table (obligatoire)	@payload.table
listTitle	@payload.listTitle (en anglais seulement)
query	@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, 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.* .

Maintenant, vous revenez à la page Centre d’analyse. Dans l’événement Visualisation du rapport cliquée , 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 le relais de destination . La saisie prédictive vous aide à renseigner 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 configuré Visualisation du rapport sélectionné