Partager via


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

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

    Créer un contrôle hébergé pour afficher des comptes.

  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

    Créer un contrôle hébergé pour afficher des contacts.

  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

    Contrôle hébergé de conteneur de barre d’outils.

  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

    Créer le bouton de la barre d’outils Recherche.

  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.

    Créer un bouton de barre d’outils pour le sous-menu Rechercher un compte.

  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.

    Choisissez Nouveau pour créer un 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
    Action Trouver
    Données compte

    Nouvel appel à l’action dans Unified Service Desk.

  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

    Créer un nouvel appel à l’action pour le bouton de la barre d’outils Afficher la rechercher de comptes.

  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.

    Créer un bouton de barre d’outils pour la recherche de contacts.

  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

    Créer un nouvel appel à l’action pour le bouton de la barre d’outils de recherche Rechercher un 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

    Créer un nouvel appel à l’action pour le bouton de la barre d’outils de recherche Afficher un contact.

  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.

Afficher les enregistrements de compte et de contact.

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.

Enregistrements de contact affichés.

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