Utiliser le processus Edge WebView2 pour héberger des applications Web

  • Article

Le contrôle de navigateur du processus Edge WebView2 héberge vos contrôles dans plusieurs instances Processus Edge WebView2 et les affiche dans des onglets dans l'application cliente Unified Service Desk. Cela facilite le rapport prévisible et sécurisé de page en vous assurant que si votre application web fonctionne dans Microsoft Edge, elle fonctionnera dans Unified Service Desk.

Les avantages de la méthode d'hébergement du processus Edge WebView2 sont les suivants :

  • Disponible sur les versions prises en charge du système d'exploitation Windows
  • Très fiable
  • Configurations simples pour héberger les applications dans Unified Service Desk
  • Basculer facilement d'un navigateur à l'autre dans toute votre organisation
  • Amélioration des performances et optimisation de la mémoire

En outre, les administrateurs peuvent effectuer les opérations suivantes :

  • Sélectionnez le Processus Edge WebView2 comme type d'hébergement pour l'organisation.
  • Sélectionnez le Processus Edge WebView2 comme type d'hébergement pour certaines applications Web, parallèlement au Processus Chrome.

Paramètres du processus Edge WebView2

Vous pouvez définir le Processus Edge WebView2 sur les contrôles hébergés (contrôles existants et nouveaux) pour héberger les applications. Cela vous permet de choisir les contrôles hébergés qui utilisent le Processus Edge WebView2 selon vos besoins. Informations complémentaires : Créer un contrôle hébergé avec un hébergement de type Edge WebView2

Si vous souhaitez définir un processus Edge WebView pour héberger les applications pour toute une organisation, utilisez l'option UII globale GlobalBrowserMode et spécifiez la valeur EdgeWebView2. Informations complémentaires : Activer Edge WebView2 pour une organisation entière

Si vous souhaitez définir le Processus Edge WebView2 uniquement pour certains agents de votre organisation, dans le fichier UnifiedServiceDesk.exe.config sur leurs bureaux client, ajoutez la clé GlobalBrowserMode avec la valeur EdgeWebView2. Informations complémentaires : Activer Edge WebView2 pour Unified Service Desk sur les bureaux client

Activer le processus Edge WebView2

Vous pouvez activer le Processus Edge WebView2 de l'une des manières suivantes :

  • Créez un contrôle hébergé individuel avec un type d'hébergement de Processus Edge WebView2.
  • Activez-le pour les bureaux client individuels.
  • Activez-le pour toute une organisation.

Ordre de priorité

  • Le fait de définir la valeur d'option UII globale GlobalBrowserMode sur EdgeWebView2 prévaut sur les paramètres individuels de contrôle hébergé.

    Par exemple, certains contrôles hébergés ont un type d'hébergement défini sur EdgeWebView2. Au niveau de l'organisation, définissez l'option UII globale GlobalBrowserMode sur la valeur EdgeWebView2. Dans ce scénario, l'option UII globale est prioritaire et la configuration utilise le processus Edge WebView2 pour héberger les applications.

  • Le fait de définir la clé du mode GlobalBrowserMode sur EdgeWebView2 dans le fichier UnifiedServiceDesk.exe.config pour un bureau client particulier prévaut sur les paramètres de contrôle hébergé individuels.

    Par exemple, certains contrôles hébergés ont leur type d'hébergement défini sur EdgeWebView2. Pour certaines agents, vous avez défini la clé GlobalBrowserMode sur EdgeWebView2 dans le fichier UnifiedServiceDesk.exe.config sur leurs bureaux clients. Le valeur définie dans le fichier UnifiedServiceDesk.exe.config prévaut et la configuration utilise le Processus Edge WebView2 pour héberger les applications.

  • Le fait de définir la clé du mode GlobalBrowserMode sur EdgeWebView2 dans le fichier UnifiedServiceDesk.exe.config pour un bureau client particulier prévaut sur les autres paramètres.

Créer un contrôle hébergé avec un hébergement de type Edge WebView2

  1. Connectez-vous à Dynamics 365.

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

  3. Sélectionnez Contrôles hébergés. La page affiche les contrôles hébergés disponibles.

  4. Cliquez sur Nouveau.

  5. Dans la page Nouveau contrôle hébergé, spécifiez les détails et sélectionnez Processus Edge WebView2 depuis le menu déroulant Type d'hébergement.

    Contrôle hébergé Processus Edge WebView2.

  6. Sélectionnez Enregistrer.

Activer Edge WebView2 pour Unified Service Desk sur le bureau client

  1. Accédez au répertoire dans lequel Unified Service Desk est installé et double-cliquez pour ouvrir le fichier UnifiedServiceDesk.exe.config.
    Exemple de chemin d’accès : C:\Program Files\Microsoft Dynamics CRM USD\USD

  2. Dans la section <appSettings>, ajoutez la nouvelle clé.
    <add key="GlobalBrowserMode" value="EdgeWebView2"/>

  3. Enregistrez le fichier.

Activer Edge WebView2 pour une organisation entière

  1. Connectez-vous à Dynamics 365.

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

  3. Dans la page Options UII actives, sélectionnez Nouveau.

  4. Dans le champ Option globale, sélectionnez Autres.

  5. Dans le champ Nom, tapez GlobalBrowserMode.

  6. Dans le champ Valeur, saisissez EdgeWebView2.

  7. Sélectionnez Enregistrer.

L'action de RunScript est asynchrone dans le processus Edge WebView2

Le navigateur Microsoft Edge prend en charge uniquement les opérations asynchrones, et l'action RunScript sera asynchrone. Si votre exécution du code personnalisé dépend de la valeur de retour fournie par l'action RunScript qui injecte JavaScript dans le principal cadre de l'application, puis l'exécution de votre code personnalisé peut être un échec.

Par exemple, votre code personnalisé a une action RunScript qui injecte JavaScript dans le cadre principal de l'application suivie d'une opération ou d'une autre action RunScript. L'action RunScript est appelée et renvoie la valeur après l'injection JavaScript. Si l’opération suivante ou une autre action RunScript est exécutée selon la valeur de retour fournie par l’action RunScript exécutée, les opérations suivantes de votre code personnalisé seront un échec.

Exemple de scénario

Lorsque vous ouvrez un incident, vérifiez s'il est ouvert depuis 10 jours, voire plus, puis affichez un message dans une boîte de dialogue. Lorsque vous exécutez une action dans la boîte de dialogue, la page d'appel téléphonique est ouverte pour d'autres opérations.

Pour exécuter ce scénario, vous devez disposer d'un appel à l'action qui exécute une action RunScript et renvoie une valeur pour l'opération suivante. Les données de l'appel à l'action calcule le nombre de jours pendant lesquels un incident est ouvert.

Maintenant, vous devez créer un appel à l'action comme ExecuteOnDataAvailable, et le champ de données doit avoir la valeur de retour du premier appel à l'action. Ainsi, la valeur renvoyée aura le formulaire [[$Return.ActionCallName]]. Cette action garantit qu'après l'exécution de la première action et le retour disponible, cet appel à l'action sera exécuté.

Ensuite, vous devez créer un appel à action ultérieur pour afficher le nombre de jours pendant lesquels un incident a été en mode ouvert. Le champ de données utilisera la valeur de renvoi du premier appel à l’action, à savoir [[$Return.ActionCallName]].

Vous devez créer un autre appel à action pour ouvrir la page d'appel téléphonique et exécuter l'opération suivante. Après avoir vu le message, vous sélectionnez le bouton OK sur la boîte de dialogue, et cela entraîne l'ouverture de la page de l'appel téléphonique.

Découvrons les configurations nécessaires pour créer ce scénario.

Étape 1 : Créer un contrôle hébergé

  1. Accédez à Paramètres>Unified Service Desk>Contrôles hébergés.

  2. Cliquez sur Nouveau.

  3. Ajoutez les détails suivants et enregistrez le contrôle hébergé.

    Champ valeur
    Nom Incident
    Nom d’affichage [[incident.title]]
    Type de composant Unified Service Desk Page Unified Interface
    Type d'hébergement Processus Edge WebView2
    Afficher le groupe MainPanel

Étape 2 : Créer deux appels à l'action

  1. Accédez à Paramètres>Unified Service Desk>Appels à l’action.

  2. Cliquez sur Nouveau.

  3. Ajoutez les détails suivants et enregistrez l'appel à l'action.

    Champ valeur
    Nom FindNoOfDaysCaseBeingOpened
    Commande 1
    Contrôle hébergé Incident
    Pour RunScript
    Données function findAge(dateString)
    {
    if("[[incident.statuscode]]".indexOf("1") > -1){
    var date1 =new Date(dateString);
    var date2 =new Date();
    var timeDiff = Math.abs(date2.getTime() - date1.getTime());
    var diffDays = Math.ceil(timeDiff / (1000 * 3600 * 24));
    return diffDays.toString();
    }
    return 0;
    }
    findAge("[[incident.createdon]]");

  4. Répétez les étapes 2 et 3 pour créer un autre appel à l'action, cette fois en utilisant les détails suivants.

    Champ valeur
    Nom DaysValue
    Ordre 2
    Contrôle hébergé Gestionnaire global CRM
    Pour ExecuteOnDataAvailable
    Données [[$Return.FindNoOfDaysCaseBeingOpened]]

Étape 3 : Créer deux appels à l’action, et rajoutez-les sous l’appel à l’action DaysValue

  1. Accédez à Paramètres>Unified Service Desk>Appels à l'action.

  2. Cliquez sur Nouveau.

  3. Ajoutez les détails suivants et enregistrez l'appel à l'action.

    Champ valeur
    Nom DisplayMessageForCaseOpen
    Contrôle hébergé Gestionnaire global CRM
    Pour DisplayMessage
    Données text=Nbre de jours pendant lesquels l’incident est en mode ouvert : [[$Return.FindNoOfDaysCaseBeingOpened]]
    caption=Case is open

  4. Répétez les étapes 2 et 3 pour créer un autre appel à l'action, cette fois en utilisant les détails suivants.

    Champ valeur
    Nom OpenPhoneCallPage
    Contrôle hébergé PhoneCall
    Pour New_CRM_Page
    Données LogicalName=phonecall
    description=Long pending case more than 9 days
    subject=Long pending case
    Condition "[[$Return.FindNoOfDaysCaseBeingOpened]]">9

  5. Dans la liste d’appels à l’action, sélectionnez l’appel à l’action DaysValue.

  6. Dans la barre de navigation, en regard de l'appel à l'action DaysValue, sélectionnez le chevron fermant (>), et sélectionnez Appel à sous-action.

  7. Sélectionnez AJOUTER L'APPEL À L'ACTION EXISTANT. Dans le champ de recherche, saisissez DisplayMessageForCaseOpen, puis l'icône Rechercher.

  8. Sélectionnez l'appel à l'action qui apparaît.

  9. Répétez les étapes 7 et 8, cette fois en entrant OpenPhoneCallPage pour l'appel à l'action.

  10. Enregistrez les modifications.

Étape 4 : Ajouter les appels à l'action à l'événement PageReady

  1. Accédez à Paramètres>Unified Service Desk>Événements.

  2. Sélectionnez l'événement PageReady pour le contrôle hébergé Incident depuis la liste d'événements.

  3. Sur la page d'événement, sous la zone Actions actives, sélectionnez le signe plus (+) pour ajouter des appels à l'action.

  4. Dans la zone de recherche qui s'affiche, saisissez FindNoOfDaysCaseBeingOpened et sélectionnez l'icône de recherche et l'appel à l'action. L'appel à l'action s'affiche sous la zone Actions actives.

  5. Répétez l'étape 4, cette fois en entrant DaysValue dans le champ de recherche.

  6. Enregistrez les modifications.

Se déconnecter des sessions lors de l'utilisation du processus Edge WebView2

Pour se déconnecter des sessions lors de l'utilisation du Processus Edge WebView2, vous devez configurer l'URL de déconnexion à l'aide de l'action Naviguer sur le contrôle hébergé. Par exemple, l'URL de déconnexion de l'application pilotée par modèle est url=/main.aspx?signout=1.

Activer la boîte de dialogue de confirmation avec Processus Edge WebView2

Si vous effectuez une action sur un onglet d'application dans une session Unified Service Desk et fermez la session, l'option UII EdgeWebView2ConfirmationDialog affichera une boîte de dialogue afin que vous puissiez confirmer l'enregistrement et la fermeture d'une session.

La boîte de dialogue de confirmation s'affiche si cette option UII a été ajoutée ou si la valeur est définie sur Vrai. Si cette option n'a pas été ajoutée ou si la valeur est définie sur False, la boîte de dialogue de confirmation ne s'affiche pas.

Pour ajouter l'option EdgeWebView2ConfirmationDialog UII

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

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

  3. Dans la page Options UII actives, sélectionnez Nouveau.

  4. Dans le champ Option globale, sélectionnez Autres.

  5. Dans le champ Nom, tapez EdgeWebView2ConfirmationDialog. Dans le champ Valeur, saisissez True.

  6. Sélectionnez Enregistrer.

Gestion du protocole URI dans le processus Edge WebView2

Si vous utilisez le processus Edge WebView2, vous voudrez peut-être bloquer la navigation de protocole au sein de l'application cliente Unified Service Desk ou peut-être ouvrir l'application dans une fenêtre distincte en dehors de l'application cliente Unified Service Desk. Utilisez les règles de navigation dans les fenêtres pour bloquer ou ouvrir l'application en dehors de l'application cliente Unified Service Desk.

Ajoutez l'URL dans les Règles de navigation dans la fenêtre et définissez Action sur Aucune pour empêcher la navigation ou définissez Afficher à l'extérieur pour afficher l'application en dehors de l'application cliente Unified Service Desk.

Par exemple, vous avez intégré un téléphone logiciel à Unified Service Desk et utilisé le type d'hébergement Edge WebView2 pour héberger des applications web. Lorsqu’un agent sélectionne le numéro de téléphone dans la page Contact ou Compte, vous souhaitez lancer l’appel à l’aide du téléphone logiciel au lieu de Skype. Vous créez la règle de navigation dans les fenêtres et définissez Action sur Aucune pour bloquer le protocole Skype. Vous pouvez créer des appels à l'action spécifiques ultérieurs en tant qu'appels de sous-action de cette règle de navigation dans les fenêtres pour lancer l'appel à l'aide du téléphone logiciel.

Pour créer une règle de navigation dans la fenêtre

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

  2. Développez Dynamics 365.

  3. Sélectionnez Administrateur de Unified Service Desk.

  4. Sous Paramètres de base, sélectionnez Règles de navigation dans la fenêtre.

  5. Sur la page Règles de navigation dans la fenêtre actives, sélectionnez Nouveau.

  6. Spécifiez les valeurs suivantes sur la page Nouvelles règles de navigation dans la fenêtre.

    Onglet Champ Value
    Général Nom Protocole téléphonique

    ou

    Protocole Skype
    Général URL Tél :

    ou

    skype :
    Résultat Type d’itinéraire Fenêtre contextuelle
    Résultat Pour Aucune ou Afficher à l’extérieur

  7. Sélectionnez Enregistrer.

À présent, lorsqu'un agent sélectionne le nombre dans la page Contact ou Compte, selon la règle de navigation de la fenêtre, le processus Edge WebView2 bloque ou ouvre l'application en dehors de l'application cliente Unified Service Desk.

Définir le focus sur une page web en utilisant le Processus Edge WebView2

Avec le Processus Edge WebView2, si vous souhaitez définir le focus sur la page web automatiquement, vous devez créer un appel à l'action avec une action comme RunScript et Data avec une fonction JavaScript : window.top USDEdgeWebView2SetFocus(). Après avoir créé l'appel à l'action, ajoutez-la à l'événement PageReady pour la Page Unified Interface et à l'événement BrowserDocumentComplete dans le cas du contrôle hébergé pour la Page CRM.

Modifier un PDF dans le processus Edge WebView2

Le Processus Edge WebView2 prend en charge la possibilité de modifier un fichier PDF en ligne si le PDF comporte des champs modifiables.

Activer la prise en charge de la langue dans le processus Edge WebView2

Le Processus Edge WebView2 prend en charge la possibilité de changer de langue sur les pages Web dans Unified Service Desk. Pour changer de langue, vous devez ajouter l'Option UII EdgeWebView2Language.

Pour ajouter l'option UII EdgeWebView2Language

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

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

  3. Cliquez sur Options.

  4. Dans la page Options UII actives, sélectionnez Nouveau.

  5. Pour le champ Option globale, sélectionnez Autres.

  6. Pour le champ Nom, tapez EdgeWebView2Language.

  7. Pour le champ Valeur, entrez le code de paramètres régionaux. Pour plus d’informations, consultez Codes de langue

    Note

    Seuls les paramètres régionaux disponibles dans le chemin <C :\Program Files \Microsoft Dynamics CRM USD\USD\locales> sont pris en charge.

  8. Sélectionnez Enregistrer.

Ajouter des paramètres à l’aide du processus Edge WebView2

Le navigateur Microsoft Edge propose de nombreuses options qui peuvent être utilisées sur les pages web dans Unified Service Desk. L’option EdgeWebView2AdditionalBrowserArguments permet d’ajouter les paramètres.

Pour ajouter l’option EdgeWebView2AdditionalBrowserArguments UII

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

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

  3. Cliquez sur Options.

  4. Dans la page Options UII actives, sélectionnez Nouveau.

  5. Pour le champ Option globale, sélectionnez Autres.

  6. Pour le champ Nom, tapez EdgeWebView2AdditionalBrowserArguments.

  7. Pour le champ Valeur, saisissez un paramètre de processus Edge WebView2 valide.

    Le format pour ajouter les paramètres est :
    --force-ui-direction:rtl;--force-text-direction:rtl;--log-level:3.

    Notez que les paramètres sont séparés par des points-virgules. Pour plus d’informations, consultez Commutateurs de ligne de commande Chrome

  8. Sélectionnez Enregistrer.

Déboguer le processus Edge WebView2

Vous pouvez déboguer le processus Edge WebView2 de deux manières :

  • À distance

  • Localement

Déboguer le processus Edge WebView2 à distance

Lorsque vous voulez accéder et déboguer toutes les instances du processus Edge WebView2 s’exécutant sur un bureau à distance, vous devez avoir accès à distance au débogage avec le numéro de port.

Utilisez l’option UII EdgeWebView2RemoteDebuggingPort et ajoutez le numéro de port comme valeur. Après avoir défini cette valeur, depuis le navigateur web, accédez au <IP address>:<\port number> du bureau distant. Vous pouvez voir toutes les instances du processus Edge WebView2 s’exécutant sur ce bureau et procéder au débogage.

Déboguer le processus Edge WebView2 au niveau local

Lorsque vous voulez accéder et déboguer à toutes les instances du processus Edge WebView2 s’exécutant sur un bureau localement, vous devez avoir accès avec le numéro de port pour vous connecter.

Utilisez l’option UII EdgeWebView2RemoteDebuggingPort et ajoutez le numéro de port comme valeur. Après avoir défini cette valeur, depuis le navigateur web, accédez au localhost:<\port number> du bureau local. Vous pouvez voir toutes les instances du processus Edge WebView2 s’exécutant sur ce bureau et procéder au débogage.

En outre, dans l’application cliente Unified Service Desk, vous pouvez déboguer une instance du processus Edge WebView2 en utilisant le raccourci clavier F12 pour ouvrir les Outils pour développeurs. Pour plus d’informations, consultez Gérer les options dans Unified Service Desk

Pour ajouter l’option EdgeWebView2RemoteDebuggingPort UII

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

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

  3. Dans la page Options UII actives, sélectionnez Nouveau.

  4. Pour le champ Option globale, sélectionnez Autres.

  5. Pour le champ Nom, tapez EdgeWebView2RemoteDebuggingPort. Pour le champ Valeur, entrez le numéro de port (par exemple, 1030).

  6. Sélectionnez Enregistrer.

Voir aussi

Créer ou modifier un contrôle hébergé
Types de contrôle hébergé et référence d’action/événement
Gérer les contrôles hébergés, les actions et les événements