Guide pas-à-pas 3 : Affichage des enregistrements des applications pilotées par modèle (applications Unified Interface) dans votre application agent

Ce guide pas-à-pas explique comment afficher des enregistrements des applications pilotées par modèle dans votre application agent. Dans ce guide pas-à-pas, vous allez afficher tous les enregistrements de comptes et de contacts dans l’instance des applications pilotées 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 parcouru le Guide pas-à-pas 1 : Création d’une application agent simple pour les applications Unified Interface 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. En savoir plus : Guide pas-à-pas 1 : Création d’une application agent simple pour les applications Unified Interface

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

  • Les deux types suivants de contrôle hébergé : Page Unified Interface 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 Unified Interface 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 Unified Interface pour afficher des enregistrements de comptes et de contacts

Dans cette étape, vous allez créer deux contrôles hébergés de type Page Unified Interface pour afficher des enregistrements de comptes et de contacts, respectivement.

1. Connectez-vous à l’administrateur de Unified Service Desk.

2. Sélectionnez Contrôles hébergés sous Paramètres de base.

3. Sélectionnez + Nouveau.

4. 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 Unified Service Desk	Page Unified Interface
   Autoriser plusieurs pages	Non
   Pré-récupérer les données	Activée
   Application globale	Activée
   Afficher le groupe	MainPanel

5. Sélectionnez Enregistrer.

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

7. 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 Unified Service Desk	Page Unified Interface
   Autoriser plusieurs pages	Non
   Pré-récupérer les données	Activée
   Application globale	Activée
   Afficher le groupe	MainPanel

8. Sélectionnez 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’administrateur de Unified Service Desk.

2. Sélectionnez Contrôles hébergés sous Paramètres de base.

3. Sélectionnez + Nouveau.

4. 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 Unified Service Desk	Conteneur de barre d’outils
   Afficher le groupe	ToolbarPanel

5. Sélectionnez 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’administrateur de Unified Service Desk.

2. Sélectionnez Barres d’outils sous Paramètres de base.

3. Sélectionnez + Nouveau.

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

5. Associez la barre d’outils au contrôle hébergé Conteneur de barre d’outils créé à l’étape 2. Sélectionnez l’onglet Association, puis sélectionnez Contrôles hébergés.

6. Sélectionnez Ajouter le contrôle hébergé existant. Le volet Rechercher des incidents s’affiche.

7. Saisissez Conteneur de barre d’outils principale Contoso dans la zone de recherche. Sélectionnez l’enregistrement à partir de la liste, et sélectionnez Ajouter.

8. Sélectionnez Enregistrer.

Étape 4 : ajout de boutons de barre d’outils et d’appels à l’action pour afficher des enregistrements à partir des applications Unified Interface.

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. Lorsque vous enregistrez la barre d’outils à l’étape 3, sélectionnez l’onglet Général.

2. Dans la zone Boutons, sélectionnez + Bouton de nouvelle barre d’outils.

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

4. Cliquez sur Enregistrer.

5. Sélectionnez l’onglet Association, puis sélectionnez Bouton de la 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.

6. Dans la page suivante, cliquez sur + Nouveau bouton de barre d’outils.

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

8. Sélectionnez Enregistrer.

9. 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, sélectionnez Ajouter l’appel à l’action existant. Le volet Rechercher des incidents s’affiche.

10. Sélectionnez l’icône de recherche et cliquez sur + Nouvel appel à l’action.

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
    Pour	Find
    Données	compte

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

13. Sélectionnez le bouton de retour dans le navigateur pour revenir à la page Bouton de recherche de comptes Contoso.

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

    Répétez les étapes 9 et 11 et 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
    Pour	ShowTab
    Données	Recherche de comptes Contoso

15. Sélectionnez Enregistrer.

16. Répétez l’étape 13, puis sélectionnez Ajouter l’appel à l’action existant. Le volet Rechercher des incidents s’affiche.

17. Saisissez Appel à l’action Contoso dans la zone de recherche. Sélectionnez l’action que vous avez créée aux étapes 11 et 14, puis sélectionnez Ajouter.

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

18. Accédez au bouton de barre d’outils Bouton de recherche Contoso pour ajouter un bouton enfant pour rechercher et afficher des contacts. Sélectionnez l’onglet Boutons de barre d’outils.

19. Sélectionnez Ajouter le bouton de nouvelle barre d’outils.

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

21. Sélectionnez Enregistrer.

22. 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, sélectionnez Ajouter l’appel à l’action existant. Le volet Rechercher des incidents s’affiche.

23. Sélectionnez l’icône de recherche et cliquez sur + Nouvel appel à l’action.

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
    Pour	Find
    Données	contact

25. Sélectionnez Enregistrer.

26. Sélectionnez le bouton de retour dans le navigateur pour revenir au bouton Bouton de recherche Contoso.

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

    Répétez les étapes 22 et 23 et 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
    Pour	ShowTab
    Données	Recherche de contacts Contoso

28. Sélectionnez Enregistrer.

29. Sélectionnez le bouton de retour dans le navigateur pour revenir au bouton Bouton de recherche Contoso.

30. Sélectionnez Ajouter l’appel à l’action existant. Le volet Rechercher des incidents s’affiche.

31. Les appels d’action que vous avez créés s’affichent. Sélectionnez les appels à l’action et cliquez sur Ajouter.

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

32. Sélectionnez Enregistrer.

É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 pour les applications Unified Interface.

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’administrateur de Unified Service Desk.

2. Sélectionnez Configuration sous Paramètres avancés.

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

4. Sélectionnez l’onglet Contrôles hébergés, évènements et appels à l’action.

5. Sélectionnez les points de suspension (...) dans la section Appels à l’action, sélectionnez Ajouter un appel à l’action existant. Le volet Rechercher des incidents s’affiche.

6. Tapez le nom de l’appel à l’action mentionné dans le tableau ci-dessus dans la zone de recherche. Les appels à l’action sont affichés dans les résultats de la recherche. Sélectionnez l’enregistrement à partir de la liste, et sélectionnez Ajouter.

7. Sélectionnez les points de suspension (...) dans la section Contrôles hébergés, sélectionnez Ajouter un contrôle hébergé existant. Le volet Rechercher des incidents s’affiche.

8. Tapez le nom du contrôle hébergé mentionné dans le tableau ci-dessus dans la zone de recherche. Les contrôles hébergés sont affichés dans les résultats de la recherche. Sélectionnez l’enregistrement à partir de la liste, et sélectionnez Ajouter.

9. Sélectionnez l’onglet Barres d’outils, règles de navigation dans la fenêtre et recherches d’entités.

10. Sélectionnez les points de suspension (...) dans la section Barres d’outils, puis sélectionnez Ajouter la barre d’outils existante. Le volet Rechercher des incidents s’affiche.

11. Saisissez Barre d’outils principale Contoso dans la zone de recherche. Sélectionnez l’enregistrement à partir de la liste, et sélectionnez Ajouter.

12. 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 les applications Unified Interface. 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 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

Prise en charge des applications Unified Interface dans Unified Service Desk

Page Unified Interface (contrôle hébergé)

Guides pas-à-pas de configuration de Unified Service Desk et Unified Interface

Guide pas-à-pas 1 : Création d’une application agent simple pour les applications Unified Interface

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

Guide pas-à-pas 4 : Affichage d’un enregistrement des applications Unified Interface 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