Guide pas-à-pas 2 : Affichage de pages Web et d’URL externes dans votre application agent

Ce guide pas-à-pas explique comment afficher une page web ou une URL externe dans votre application agent. Dans ce guide pas-à-pas, vous apprendrez à afficher le guide Unified Service Desk, qui est accessible en ligne à l’adresse https://go.microsoft.com/fwlink/?LinkID=856273, dans l’application cliente.

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 premier guide pas-à-pas sont nécessaires pour ce guide.

• Ce guide suppose que vous utilisiez les mêmes informations d’identification utilisateur que celles utilisées à la fin du guide 1 pour vous connecter à l’application agent. 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 concepts suivants dans Unified Service Desk :

  • Ces deux types des contrôles hébergés : Application web standard 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

  • Configuration d’appels à l’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 contrôle hébergé pour afficher la page web

É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 d’un bouton de barre d’outils et d’appels à l’action pour afficher la page web

É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é pour afficher la page web

Dans cette étape, vous allez créer un contrôle hébergé de type Application web standard pour afficher la page web.

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	Aide Contoso
   Nom complet	Aide Contoso
   Type de composant Unified Service Desk	Application web standard
   Autoriser plusieurs pages	Non
   Type d’hébergement	Processus Chrome
   Application globale	Activée
   Afficher le groupe	MainPanel

5. 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 type de contrôle hébergé Conteneur de barre d’outils qui apparaît dans la zone des barres d’outils 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 À propos de Contoso
   Type de composant Unified Service Desk	Conteneur de barre d’outils
   Afficher le groupe	AboutPanel

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 À propos de 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. Dans la barre de recherche, tapez « Contoso About Toolbar Container ». Sélectionnez l’enregistrement à partir de la liste, et sélectionnez Ajouter.

8. Sélectionnez Enregistrer.

Étape 4 : ajout d’un bouton de barre d’outils et d’appels à l’action pour afficher la page web

Dans cette étape, ajoutez un bouton à la barre d’outils et associez un appel à l’action au bouton afin que lorsque quelqu’un clique sur le bouton, la page web spécifiée s’affiche dans le contrôle hébergé créé à l’étape 1.

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	Afficher l’aide Contoso
   Texte du bouton	Afficher l’aide

4. Sélectionnez Enregistrer pour sauvegarder l’enregistrement. Après avoir enregistré, la zone Actions est activée.

5. Ajoutez deux appels à l’action pour spécifier l’URL de la page web à laquelle accéder pour le contrôle hébergé créé à l’étape 1 En outre, créez un autre appel à l’action pour le contrôle hébergé Gestionnaire global Contoso pour afficher le contrôle hébergé créé à l’étape 1 dans l’application agent. Dans la zone Actions, sélectionnez Ajouter l’appel à l’action existant. Le volet Rechercher des incidents s’affiche.

6. Sélectionnez l’icône de recherche dans la zone de recherche dans la zone Actions, puis sélectionnez + Nouvel appel à l’action.

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

   Champ	Valeur
   Nom	Appel à l’action Contoso : Afficher l’aide
   Commande	1
   Contrôle hébergé	Aide Contoso
   Pour	Navigate
   Données	url=https://learn.microsoft.com/dynamics365/unified-service-desk/unified-service-desk?view=dynamics-usd-4.1

8. Sélectionnez Enregistrer.

9. Sélectionnez le bouton de retour dans le navigateur pour revenir au bouton Afficher l’aide Contoso.

10. Sélectionnez Ajouter l’appel à l’action existant dans la zone Actions. Le volet Rechercher des incidents s’affiche.

11. Tapez le nom de l’action que vous avez créé dans la zone de recherche. Sélectionnez l’enregistrement à partir de la liste, et sélectionnez Ajouter.

12. Répétez les étapes 5 et 6 pour créer un autre appel à l’action avec les détails suivants :

    Champ	Valeur
    Nom	Appel à l’action Contoso : Contrôle hébergé Afficher l’aide
    Commande	2
    Contrôle hébergé	Gestionnaire global Contoso
    Pour	ShowTab
    Données	Aide Contoso

13. Répétez les étapes 8 à 11.

14. Sélectionnez Enregistrer. Le nouvel appel à l’action est ajouté au bouton Afficher l’aide Contoso. Vous pouvez voir les deux appels à l’action ajoutés au bouton de la barre d’outils.

    

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

Dans cette étape, ajoutez 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 : Afficher l’aide	Appel à l’action
Appel à l’action Contoso : Contrôle hébergé Afficher l’aide	Appel à l’action
Aide Contoso	Contrôle hébergé
Conteneur de barre d’outils À propos de Contoso	Contrôle hébergé
Barre d’outils À propos de 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. Saisissez Appel à l’action Contoso dans la zone de recherche. Les deux 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 Contoso dans la zone de recherche. Les deux 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 Association, puis sélectionnez Barres d’outils.

10. Sélectionnez Ajouter la barre d’outils existante. Le volet Rechercher des incidents s’affiche.

11. Saisissez Barre d’outils À propos de 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 Afficher l’aide dans l’angle supérieur droit :

Le fait de cliquer sur Afficher l’aide affiche l’URL web spécifiée dans l’application Unified Service Desk.

Conclusion

Dans ce guide pas-à-pas, vous avez appris à afficher une page web dans l’application cliente de 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 3 : Affichage des enregistrements des applications Unified Interface 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