Guide pas-à-pas 4 : Affichage d’un enregistrement dans une session de votre application agent

Ce guide étape par étape explique comment afficher des enregistrements dans une session de votre application agent à l’aide de règles de navigation dans la fenêtre et de contrôles de session dans Unified Service Desk. Il présente également l'utilisation de paramètres de remplacement pour afficher dynamiquement le nom du contrôle hébergé basé sur l'enregistrement de compte actuellement affiché. Ce guide pas-à-pas a été créé sur la base du guide précédent, Guide pas-à-pas 3: Affichage d'enregistrements dans votre application agent, pour afficher un enregistrement de compte dans une session lorsque vous sélectionnez l'un des comptes de la fenêtre des résultats de la recherche Compte.

Conditions préalables

• Vous devez avoir effectué le Guide pas-à-pas 1 : Création d'une application agent simple et Guide pas-à-pas 3: Affichage d'enregistrements dans votre application agent. Les configurations que vous avez effectuées dans ces guides pas-à-pas sont nécessaires pour ce guide.

• Ce guide suppose que vous utilisiez les mêmes informations d'identification utilisateur que celles du guide 1 pour vous connecter à l'application agent à la fin du guide pour tester l'application. Si un autre utilisateur doit tester l’application, vous devez attribuer cet utilisateur à la Configuration Contoso. Plus d’informations : Guide pas-à-pas 1 : Création d’une application agent simple

• Vous devez connaître les éléments suivants dans Unified Service Desk :

  • Type de contrôle hébergé Onglets de session. Informations supplémentaires : Onglets Session (Contrôle hébergé)

  • Configuration d’appels à l’action

  • Comment configurer des règles de navigation dans la fenêtre. Plus d’informations : Utiliser les règles de navigation dans la fenêtre dans Unified Service Desk

  • Filtrez l’accès à l’aide de la configuration d’Unified Service Desk. Pour en savoir plus : Gérer l’accès à l’aide de la configuration Unified Service Desk

Dans ce guide pas-à-pas

Étape 1 : création d'un contrôle hébergé de session pour afficher un enregistrement de compte dans une session

Étape 2 : configuration de l'événement pour fermer le contrôle hébergé à partir d'où la recherche a démarré

Étape 3 : création d'un contrôle hébergé Onglets de session

Étape 4 : création d'une règle de navigation dans la fenêtre pour afficher l'enregistrement de compte dans une session

Étape 5 : ajout des contrôles à la configuration

Étape 6 : test de l’application

Conclusion

Étape 1 : création d'un contrôle hébergé de session pour afficher un enregistrement de compte dans une session

Dans cette étape, vous allez créer un contrôle hébergé de session pour afficher un enregistrement de compte dans une session.

1. Connectez-vous à l’instance de Dynamics 365.

2. Accédez à Paramètres>Unified Service Desk.

3. Sélectionnez Contrôles hébergés.

4. Cliquez sur Nouveau.

5. Dans la page Nouveau contrôle hébergé, spécifiez les valeurs suivantes.

   Champ	Valeur
   Nom	Session de compte Contoso
   Nom d’affichage	[[account.name]] Remarque : Nous utiliserons le paramètre de remplacement pour afficher dynamiquement le nom du compte sélectionné en tant que contrôle hébergé nom complet.
   Type de composant USD	Page CRM
   Autoriser plusieurs pages	Non
   Type d'hébergement	WPF interne
   Application globale	Non activée Remarque : cela permet de s’assurer que le contrôle hébergé est bien basé sur une session, c’est-à-dire qu’il ne s’affiche que dans une session.
   Afficher le groupe	MainPanel

   

6. Sélectionnez Enregistrer.

Étape 2 : configuration de l'événement pour fermer le contrôle hébergé à partir d'où la recherche a démarré

Dans cette étape, vous allez configurer l'événement BrowserDocumentComplete du contrôle hébergé Session de compte Contoso afin que lorsqu'il est chargé, le contrôle hébergé parent à partir duquel l'utilisateur a sélectionné pour ouvrir le compte, Recherche de comptes Contoso, soit fermé. Le contrôle hébergé Recherche de comptes Contoso a été créé dans Guide pas-à-pas 3 : Affichage d'enregistrements dans votre application agent. Cette opération permet de s'assurer que l'utilisateur ne peut pas ouvrir d'autres informations de compte dans le même onglet de session.

1. Dans la barre de navigation, sélectionnez la flèche vers le bas en regard du contrôle hébergé Session de compte Contoso, puis sélectionnez Événements.

   

2. Dans la page Événements, sélectionnez BrowserDocumentComplete.

3. Dans la page BrowserDocumentComplete, sélectionnez + dans la zone Actions actives pour ajouter un appel à l'action à l'événement.

4. Dans la zone de recherche, sélectionnez l'icône de recherche ou appuyez sur ENTRÉE, puis sélectionnez Nouveau dans l'angle inférieur droit de la zone des résultats de recherche.

   

5. Dans la page Nouvel appel à l’action, spécifiez les valeurs suivantes.

   Champ	Valeur
   Nom	Appel à l'action Contoso : Fermer la recherche de comptes
   Contrôle hébergé	Recherche de comptes Contoso
   Pour	Fermer

   

6. Sélectionnez Enregistrer pour ajouter l'appel à l'action à l'événement BrowserDocumentComplete.

Étape 3 : création d'un contrôle hébergé Onglets de session

Pour afficher des enregistrements dans des sessions de votre application agent, une instance du type de contrôle hébergé Onglets de session doit être configurée dans votre application agent.

1. À la page des contrôles hébergés, sélectionnez Nouveau.

2. Dans la page Nouveau contrôle hébergé, spécifiez les valeurs suivantes.

   Champ	Valeur
   Nom	Onglet de session Contoso
   Type de composant USD	Onglets de session

   

3. Mettez à jour le XML dans le champ Extensions XML. Pour en savoir plus, voir XML d'indicateur de conversation instantanée.

4. Sélectionnez Enregistrer.

Étape 4 : création d'une règle de navigation dans la fenêtre pour afficher l'enregistrement de compte dans une session

Dans cette étape, vous allez créer une règle de navigation dans la fenêtre qui affiche l'enregistrement dans une session lorsque l'utilisateur sélectionnez l'un des comptes dans la fenêtre des résultats de recherche.

1. Connectez-vous à l’instance de Dynamics 365.

2. Accédez à Paramètres>Unified Service Desk.

3. Sélectionnez Règles de navigation dans la fenêtre.

4. Cliquez sur Nouveau.

5. Dans la page Nouvelle règle de navigation dans la fenêtre, spécifiez les valeurs suivantes.

   Champ	Valeur
   Nom	Règle de session de compte Contoso
   Commande	5
   De	Recherche de comptes Contoso
   Entité	compte
   Type d'itinéraire	Fenêtre contextuelle
   Destination	Onglet
   Pour	Créer une session
   Onglet Cible	Session de compte Contoso
   Onglet Afficher	Session de compte Contoso
   Masquer la barre de commandes	Non
   Masquer la barre de navigation	Oui

   

6. Sélectionnez Enregistrer.

Étape 5 : ajout des contrôles à la configuration

Dans cette étape, vous allez ajouter l'appel à l'action, l'événement, les contrôles hébergés et la règle de navigation dans la fenêtre créés dans ce guide pas-à-pas à la Configuration Contoso pour montrer ces contrôles à l'utilisateur attribué à la configuration. Configuration Contoso a été créé dans Guide pas-à-pas 1 : Création d'une application agent simple.

Ajoutez les éléments suivants à la Configuration Contoso.

Nom du contrôle	Type de contrôle
Appel à l'action Contoso : Fermer la recherche de comptes	Appel à l'action
BrowserDocumentComplete	Événement du contrôle hébergé Session de compte Contoso
Session de compte Contoso	Contrôle hébergé
Onglet de session Contoso	Contrôle hébergé
Règle de session de compte Contoso	Règle de navigation dans la fenêtre

Pour ajouter un contrôle à la configuration :

1. Connectez-vous à l’instance de Dynamics 365.

2. Accédez à Paramètres>Unified Service Desk.

3. Sélectionnez Configuration.

4. Sélectionnez Configuration Contoso pour ouvrir la définition.

5. Dans la barre de navigation, sélectionnez la flèche vers le bas en regard de Configuration Contoso, puis sélectionnez Appels à l'action.

6. À la page suivante, sélectionnez Ajouter un appel à l'action existant, tapez « Contoso Action Call: Close Accounts Search » dans la barre de recherche, puis appuyez sur ENTRÉE ou sélectionnez l'icône de recherche.

7. Dans la zone de résultats de recherche, sélectionnez l'appel à l'action pour l'ajouter à la Configuration Contoso.

8. De même, ajoutez l’événement, les contrôles hébergés et la règle de navigation dans la fenêtre en sélectionnant la flèche vers le bas en regard de Configuration Contoso, puis en sélectionnant sur ÉvénementsContrôles hébergés et Règles de navigation dans la fenêtre, respectivement.

9. Cliquez sur Enregistrer.

Étape 6 : test de l’application

1. Démarrez l’application cliente Unified Service Desk et connectez-vous à l’instance de Dynamics 365 où vous avez configuré Unified Service Desk en utilisant les mêmes informations d’identification utilisateur que vous avez attribuées à la Configuration Contoso dans Guide pas-à-pas 1 : Création d’une application agent simple. Pour plus d’informations sur la connexion à une instance de Dataverse à l’aide de l’application cliente Unified Service Desk, voir Se connecter à l’instance de CRM avec le client Unified Service Desk.

2. Pour afficher les enregistrements de compte de votre instance de Dataverse, sélectionnez la flèche vers le bas en regard du bouton Rechercher dans la barre d’outils, puis sélectionnez Compte.

3. Sélectionnez l'un des enregistrements de compte pour afficher les informations de compte respectives dans une session. Ces informations s'affichent dans un onglet de session. Notez que le nom de l'onglet de contrôle hébergé contenant l'enregistrement de compte affiche automatiquement le nom du compte car précédemment vous avez utilisé des paramètres de remplacement pour afficher dynamiquement le nom du compte actif plutôt qu'une valeur statique.

   

4. Si vous ouvrez un autre enregistrement de compte, il sera affiché dans une autre session de votre application cliente. Pour ouvrir un autre compte, sélectionnez la flèche vers le bas en regard du bouton Rechercher, sélectionnez Compte, puis sélectionnez un nom de compte pour afficher les informations de compte dans une autre session.

   

Conclusion

Dans ce guide pas-à-pas, vous avez appris à utiliser le contrôle hébergé de session et les règles de navigation dans la fenêtre pour afficher des enregistrements dans une session de votre application agent. Vous avez également appris à filtrer l’accès aux contrôles du Unified Service Desk à l’aide de la configuration.

Note

Passez au guide pas-à-pas suivant pour présenter des informations de session améliorées dans votre application agent : Guide pas-à-pas 5 : Affichage d'informations de session améliorées avec le nom de la session et les données de vue d'ensemble.

Voir aussi

Guide pas-à-pas 1 : Création d'une application agent simple

Guide pas-à-pas 2 : Affichage d’une page Web externe dans votre application agent

Guide pas-à-pas 3: Affichage d'enregistrements dans votre application agent

Guide pas-à-pas 6 : Configuration du contrôle hébergé Débogueur dans votre application agent

Guide pas-à-pas 7 : Configuration de la génération de scripts d’agent dans votre application agent

Guides pas-à-pas pour la configuration de Unified Service Desk