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 1 : création d’un type de contrôle hébergé Page CRM pour afficher des enregistrements de comptes et de contacts

É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 4 : ajout de boutons de barre d’outils et d’appels à l’action pour afficher des enregistrements

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

Étape 6 : test de l’application

Conclusion

É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.

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

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

3. Cliquez sur 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	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

   

6. Cliquez sur Enregistrer.

7. Cliquez sur Nouveau pour créer un autre contrôle hébergé pour afficher des enregistrements de contacts.

8. 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

   

9. 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.

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

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

3. Cliquez sur 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	Conteneur de barre d’outils principale Contoso
   Type de composant USD	Conteneur de barre d’outils
   Afficher le groupe	ToolbarPanel

   

6. 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.

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

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

3. Cliquez sur Barres d’outils.

4. Cliquez sur Nouveau.

5. Dans la page Nouvelle barre d’outils, tapez Barre d’outils principale Contoso dans la zone Nom, puis cliquez sur Enregistrer.

6. 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.

7. À la page suivante, cliquez sur Ajouter le contrôle hébergé existant, tapez Contoso Main Toolbar Container dans la barre de recherche, puis appuyez sur ENTRÉE ou cliquez sur l’icône de recherche.

8. Dans les résultats de la recherche, cliquez sur Conteneur de barre d’outils principale Contoso pour l’ajouter.

9. 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.

1. 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.

2. 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

   

3. Cliquez sur Enregistrer.

4. 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.

5. Dans la page suivante, cliquez sur Ajouter un nouveau bouton de barre d’outils.

6. 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.

   

7. Cliquez sur Enregistrer.

8. 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.

9. Dans la zone de recherche de la zone Actions, appuyez sur ENTRÉE ou cliquez sur l’icône de recherche.

10. 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.

    

11. 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

    

12. Cliquez sur Enregistrer. Le nouvel appel à l’action est ajouté au bouton Bouton de recherche de comptes Contoso.

13. 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.

14. 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.

15. 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

    

16. Cliquez sur Enregistrer. Le nouvel appel à l’action est ajouté au bouton Bouton de recherche de comptes Contoso.

17. 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.

18. Dans la page suivante, cliquez sur Ajouter un nouveau bouton de barre d’outils.

19. 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.

    

20. Cliquez sur Enregistrer.

21. 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.

22. Dans la zone de recherche de la zone Actions, appuyez sur ENTRÉE ou cliquez sur l’icône de recherche.

23. 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.

24. 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

    

25. Cliquez sur Enregistrer. Le nouvel appel à l’action est ajouté au bouton de barre d’outils Bouton de recherche de contacts Contoso.

26. 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.

27. 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.

28. 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

    

29. 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 :

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

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

3. Cliquez sur Configuration.

4. Cliquez sur Configuration Contoso pour ouvrir la définition.

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

6. À 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.

7. 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.

8. 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.

9. 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