Guide pas-à-pas 3: Affichage d’enregistrements dans votre application agent
Ce guide pas-à-pas explique comment afficher des enregistrements dans votre application agent. Dans ce guide pas-à-pas, vous allez afficher tous les enregistrements de comptes et de contacts dans l'instance de l'application pilotée par modèle. Vous allez également créer un bouton de recherche avec des éléments de menu déroulant pour afficher les comptes et les contacts dans l'application agent.
Configuration requise
Vous devez avoir complété Guide pas-à-pas 1 : Création d'une application agent simple. Les configurations que vous avez effectuées dans le guide 1 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 :
Les deux types suivants de contrôle hébergé : Page CRM et Conteneur de barre d'outils. En savoir plus : Types de contrôle hébergé et référence d’action et d’événement
Appel à l’action et comment le configurer. Pour plus d′informations : Appels d’action
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 2 : création d'un contrôle hébergé de type conteneur de barre d'outils
Étape 3 : ajout d'une barre d'outils et association au conteneur de barre d'outils
Étape 5 : ajout des contrôles à la configuration
Étape 6 : test de l’application
Étape 1 : création d'un type de contrôle hébergé Page CRM pour afficher des enregistrements de comptes et de contacts
Dans cette étape, vous allez créer deux contrôles hébergés de type CRM Page pour afficher des enregistrements de comptes et de contacts, respectivement.
Connectez-vous à l’instance de Dynamics 365.
Accédez à Paramètres>Unified Service Desk.
Cliquez sur Contrôles hébergés.
Cliquez sur Nouveau.
Dans la page Nouveau contrôle hébergé, spécifiez les valeurs suivantes :
Champ Valeur Nom Recherche de comptes Contoso Nom complet Contoso : Comptes Type de composant USD Page CRM Autoriser plusieurs pages Non Type d'hébergement WPF interne Application globale Activée Afficher le groupe MainPanel 
Cliquez sur Enregistrer.
Cliquez sur Nouveau pour créer un autre contrôle hébergé pour afficher des enregistrements de contacts.
Dans la page Nouveau contrôle hébergé, spécifiez les valeurs suivantes :
Champ Valeur Nom Recherche de contacts Contoso Nom complet Contoso : Contacts Type de composant USD Page CRM Autoriser plusieurs pages Non Type d'hébergement WPF interne Application globale Activée Afficher le groupe MainPanel 
Cliquez sur Enregistrer.
Étape 2 : création d’un contrôle hébergé de type conteneur de barre d’outils
Les contrôles hébergés de type Conteneur de barre d’outils sont utilisés pour contenir et afficher les barres d’outils du Unified Service Desk. Dans cette section, vous allez créer un contrôle hébergé Conteneur de barre d’outils qui apparaîtra en haut de l’application cliente.
Connectez-vous à l’instance de Dynamics 365.
Accédez à Paramètres>Unified Service Desk.
Cliquez sur Contrôles hébergés.
Cliquez sur Nouveau.
Dans la page Nouveau contrôle hébergé, spécifiez les valeurs suivantes.
Champ Valeur Nom Conteneur de barre d'outils principale Contoso Type de composant USD Conteneur de barre d'outils Afficher le groupe ToolbarPanel 
Cliquez sur Enregistrer.
Étape 3 : ajout d’une barre d’outils et association au conteneur de barre d’outils
Dans cette étape, vous allez créer une barre d’outils, puis l’associer au contrôle hébergé Conteneur de barre d’outils créé à l’étape 2. Cette opération permet d’afficher la barre d’outils dans votre application agent.
Connectez-vous à l’instance de Dynamics 365.
Accédez à Paramètres>Unified Service Desk.
Cliquez sur Barres d'outils.
Cliquez sur Nouveau.
Dans la page Nouvelle barre d'outils, tapez Barre d'outils principale Contoso dans la zone Nom, puis cliquez sur Enregistrer.
Associez la barre d'outils au contrôle hébergé Conteneur de barre d'outils créé à l'étape 2. Dans la barre de navigation, cliquez sur la flèche vers le bas en regard de Barre d'outils principale Contoso, puis cliquez sur Contrôles hébergés.
À la page suivante, cliquez sur Ajouter le contrôle hébergé existant, tapez
Contoso Main Toolbar Containerdans la barre de recherche, puis appuyez sur ENTRÉE ou cliquez sur l'icône de recherche.Dans les résultats de la recherche, cliquez sur Conteneur de barre d'outils principale Contoso pour l'ajouter.
Cliquez sur Enregistrer.
Étape 4 : ajout de boutons de barre d'outils et d'appels à l'action pour afficher des enregistrements
Dans cette étape, vous allez ajouter des boutons à la barre d'outils et associer des appels à l'action aux boutons afin que lorsqu'un utilisateur clique sur le bouton, les enregistrements appropriés s'affichent dans les contrôles hébergés créés à l'étape 1. Vous configurerez le bouton de recherche afin qu'un clic sur le bouton affiche les éléments de sous-menu du compte et du contact, et un clic sur un bouton affiche les enregistrements correspondants.
Une fois que vous avez enregistré la barre d'outils à l'étape 3, la zone Boutons devient disponible. Dans la zone Boutons, cliquez sur + dans l'angle droit pour ajouter un bouton.
Dans la page Nouveau bouton de barre d'outils, spécifiez les valeurs suivantes :
Champ Valeur Nom Bouton de recherche Contoso Texte du bouton RECHERCHER Info-bulle Rechercher les comptes et contacts Ordre 1 
Cliquez sur Enregistrer.
Dans la barre de navigation, cliquez sur la flèche vers le bas en regard de Bouton de recherche Contoso, puis cliquez sur Boutons de barre d'outils.
Note
Vous ajoutez maintenant des boutons de barre d’outils enfants à un bouton de barre d’outils existant pour créer une structure de sous-menu.
Dans la page suivante, cliquez sur Ajouter un nouveau bouton de barre d'outils.
Dans la page Nouveau bouton de barre d'outils, spécifiez les valeurs suivantes.
Champ Valeur Nom Bouton de recherche de comptes Contoso Texte du bouton Compte Commande 1
Le champ Ordre définit l’emplacement des boutons dans la barre d’outils. Les boutons sont disposés de gauche à droite ou de haut en bas par ordre croissant.
Cliquez sur Enregistrer.
Vous allez maintenant ajouter deux appels à l’action : le premier pour afficher les enregistrements de comptes dans le contrôle hébergé créé à l’étape 1 et le deuxième dans le contrôle hébergé Gestionnaire global Contoso pour afficher le contrôle hébergé de compte.
Dans la zone Actions, cliquez sur + dans l'angle droit pour ajouter un appel à l'action.
Dans la zone de recherche de la zone Actions, appuyez sur ENTRÉE ou cliquez sur l'icône de recherche.
Dans la zone des résultats de la recherche, cliquez sur Nouveau dans l'angle inférieur droit pour créer un appel à l'action pour ce bouton de barre d'outils.
Dans la page Nouvel appel à l'action, spécifiez les valeurs suivantes :
Champ Valeur Nom Appel à l’action Contoso : Rechercher un compte Commande 1 Contrôle hébergé Recherche de comptes Contoso Action Trouver Données compte 
Cliquez sur Enregistrer. Le nouvel appel à l’action est ajouté au bouton Bouton de recherche de comptes Contoso.
Vous allez ajouter un autre appel à l'action au bouton pour définir l'attention sur le contrôle hébergé qui affiche les enregistrements de comptes dans l'application cliente. Dans la zone Actions, cliquez sur + dans l'angle droit pour ajouter un appel à l'action.
Dans la zone des résultats de la recherche, cliquez sur Nouveau dans l'angle inférieur droit pour créer un appel à l'action pour ce bouton de barre d'outils.
Dans la page Nouvel appel à l'action, spécifiez les valeurs suivantes.
Champ Valeur Nom Appel à l'action Contoso : Afficher la rechercher de comptes Commande 2 Contrôle hébergé Gestionnaire global Contoso Action ShowTab Données Recherche de comptes Contoso 
Cliquez sur Enregistrer. Le nouvel appel à l’action est ajouté au bouton Bouton de recherche de comptes Contoso.
Accédez au bouton de barre d'outils Bouton de recherche Contoso pour ajouter un bouton enfant pour rechercher et afficher des contacts. Dans la barre de navigation, cliquez sur la flèche vers le bas en regard de Bouton de recherche Contoso, puis sélectionnez Boutons de barre d'outils.
Dans la page suivante, cliquez sur Ajouter un nouveau bouton de barre d'outils.
Dans la page Nouveau bouton de barre d'outils, spécifiez les valeurs suivantes :
Champ Valeur Nom Bouton de recherche de contacts Contoso Texte du bouton Contact Commande 2
Le champ Ordre définit l’emplacement des boutons dans la barre d’outils. Les boutons sont disposés de gauche à droite ou de haut en bas par ordre croissant.
Cliquez sur Enregistrer.
Vous allez maintenant ajouter deux appels à l’action : le premier pour afficher les enregistrements de contacts dans le contrôle hébergé créé à l’étape 1 et le deuxième dans le contrôle hébergé Gestionnaire global Contoso pour afficher le contrôle hébergé de contact.
Dans la zone Actions, cliquez sur + dans l'angle droit pour ajouter un appel à l'action.
Dans la zone de recherche de la zone Actions, appuyez sur ENTRÉE ou cliquez sur l'icône de recherche.
Dans la zone des résultats de la recherche, cliquez sur Nouveau dans l'angle inférieur droit pour créer un appel à l'action pour ce bouton de barre d'outils.
Dans la page Nouvel appel à l'action, spécifiez les valeurs suivantes :
Champ Valeur Nom Appel à l’action Contoso : Rechercher un contact Commande 1 Contrôle hébergé Recherche de contacts Contoso Action Trouver Données contact 
Cliquez sur Enregistrer. Le nouvel appel à l’action est ajouté au bouton de barre d’outils Bouton de recherche de contacts Contoso.
Vous allez ajouter un autre appel à l'action au bouton pour définir l'attention sur le contrôle hébergé qui affiche les enregistrements de contacts dans l'application cliente. Dans la zone Actions, cliquez sur + dans l'angle droit pour ajouter un appel à l'action.
Dans la zone des résultats de la recherche, cliquez sur Nouveau dans l'angle inférieur droit pour créer un appel à l'action pour ce bouton de barre d'outils.
Dans la page Nouvel appel à l'action, spécifiez les valeurs suivantes.
Champ Valeur Nom Appel à l'action Contoso : Afficher la recherche de contacts Commande 2 Contrôle hébergé Gestionnaire global Contoso Action ShowTab Données Recherche de contacts Contoso 
Cliquez sur Enregistrer. Le nouvel appel à l’action est ajouté au bouton de barre d’outils Bouton de recherche de contacts Contoso.
Étape 5 : ajout des contrôles à la configuration
Dans cette étape, vous allez ajouter les appels à l'action, les contrôles hébergés et la barre d'outils 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 : Rechercher un compte | Appel à l’action |
| Appel à l’action Contoso : Afficher la rechercher de comptes | Appel à l’action |
| Appel à l’action Contoso : Rechercher un contact | Appel à l’action |
| Appel à l’action Contoso : Afficher la recherche de contacts | Appel à l’action |
| Recherche de comptes Contoso | Contrôle hébergé |
| Recherche de contacts Contoso | Contrôle hébergé |
| Conteneur de barre d’outils principale Contoso | Contrôle hébergé |
| Barre d'outils principale Contoso | Barre d’outils |
Pour ajouter un contrôle à la configuration :
Connectez-vous à l’instance de Dynamics 365.
Accédez à Paramètres>Unified Service Desk.
Cliquez sur Configuration.
Cliquez sur Configuration Contoso pour ouvrir la définition.
Dans la barre de navigation, cliquez sur la flèche vers le bas en regard de Configuration Contoso, puis sélectionnez Appels à l'action.
À la page suivante, cliquez sur Ajouter un appel à l'action existant, tapez «
Contoso Action Call» dans la barre de recherche, puis appuyez sur ENTRÉE ou cliquez sur l'icône de recherche.Les appels à l'action référencés précédemment sont affichés dans les résultats de la recherche. Ajoutez ces appels à l'action.
De même, ajoutez les contrôles hébergés et la barre d'outils en cliquant sur la flèche vers le bas en regard de Configuration Contoso, puis en cliquant sur Contrôles hébergés et Barres d'outils, respectivement.
Cliquez sur Enregistrer.
Étape 6 : test de l’application
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 à une instance d’application pilotée par modèle avec le client Unified Service Desk.
Votre application agent doit maintenant avoir un bouton RECHERCHER dans la zone de barre d'outils avec deux boutons enfants (Compte et Contact) qui s'affichent lorsque vous cliquez sur la flèche vers le bas.
Cliquez sur Compte ou Contact sous le bouton RECHERCHER pour afficher les enregistrements correspondants de votre instance Dataverse dans des onglets distincts de l’application cliente Unified Service Desk.
Conclusion
Dans ce guide pas-à-pas, vous avez appris à afficher des enregistrements des applications pilotées par modèle dans l’application cliente Unified Service Desk. Vous avez également appris à filtrer l’accès aux contrôles du Unified Service Desk à l’aide de la configuration.
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 4 : Affichage d'un enregistrement dans une session de 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
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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour