Freigeben über

Verwenden des Edge WebView2-Prozesses zum Hosten von Webanwendungen

  • Artikel

Das Edge WebView2 Prozess Browser-Steuerelement hostet Ihre Steuerelemente in individuellen Edge WebView2-Prozessinstanzen und zeigt diese in der Unified Service Desk Client Anwendung. Es vereinfacht und sichert das vorhersagbare Seitenrendering, indem es sicherstellt, dass wenn Ihre Webanwendung in Microsoft Edge funktioniert, sie ebenfalls in Unified Service Desk funktioniert.

Die Vorteile der Verwendung der Edge WebView2-Prozess gehosteten Methode sind wie folgt:

  • Verfügbar für unterstützte Versionen des Windows-Betriebssystems
  • Äußerst zuverlässig
  • Einfache Konfigurationen zum Hosten der Anwendungen in Unified Service Desk
  • Wechseln Sie nahtlos in Ihrer gesamten Organisation von einem Browser zum anderen
  • Verbesserte Leistung und Speicheroptimierung

Administratoren können außerdem Folgendes ausführen:

  • Wählen Sie den Edge-WebView2 Prozess als Hosting-Typ für die Organisation aus.
  • Wählen Sie neben dem Chrome-Prozess den Edge WebView2-Prozess als Hosting-Typ für ausgewählte Webanwendungen aus.

Edge WebView2-Prozess Einstellungen

Sie können den Edge WebView2 Prozess für die gehosteten Steuerelemente (vorhandene und neue) festlegen, um Anwendungen zu hosten. Dadurch können Sies die Partner Steuerelemente auf Edge WebView2-Prozess basierend auf den Anforderungen verwenden. Weitere Informationen: Erstellen eines gehosteten Steuerelement Hostingtyp als Edge WebView2

Wenn Sie den Edge WebView2-Prozess einstellen möchten, um die Anwendungen für die gesamte Organisation zu hosten, verwenden Sie die Option GlobalBrowserMode Global Ull Option und definieren Sie den Wert als Edge WebView2 angezeigt. Weitere Informationen: Edge WebView2 für die gesamte Organisation aktivieren

Wenn Sie den Edge WebView2-Prozess nur für einige Agents in Ihrer Organisation festlegen möchten, fügen Sie in der Datei UnifiedServiceDesk.exe.config den Schlüssel GlobalBrowserMode mit dem Wert EdgeWebView2 hinzu. Weitere Informationen: Aktivieren Sie Edge WebView2 für Unified Service Desk auf Clientdesktop

Edge WebView2-Prozess aktivieren

Sie können den Edge WebView2-Prozess auf eine der folgenden Arten aktivieren:

  • Erstellen eines gehosteten Steuerelement mit dem Hostingtyp Edge WebView2 Prozess.
  • Aktivieren für individuellen Client Desktop.
  • Edge für eine gesamte Organisation aktivieren.

Rangfolge

  • Das Festlegen des globalen UII-Optionswert GlobalBrowserMode als EdgeWebView2 hat Vorrang vor den einzelnen Einstellungen des gehosteten Steuerelements.

    Bei einigen gehosteten Steuerelementen ist beispielsweise der Hostingtyp auf EdgeWebView2 eingestellt. Auf der Organisationsebene legen Sie den GlobalBrowserMode Global UII Optionswert als EdgeWebView2 hinzu. In diesem Szenario hat die globale UII-Option Vorrang und die Konfiguration verwendet Edge WebView2 Prozess, um die Anwendung zu hosten.

  • Den GlobalBrowserMode Modusschlüssel auf EdgeWebView2 in der Datei UnifiedServiceDesk.exe.config für einen bestimmten Desktop-Client festlegen, dieser hat Vorrang über die einzelnen Einstellungen das gehostete Steuerelements.

    Bei einigen gehosteten Steuerelementen ist beispielsweise ihr Hostingtyp auf EdgeWebView2 eingestellt. Bei einigen Agenten haben Sie in den Clientdesktops dem Modusschlüssel GlobalBrowserMode auf EdgeWebView2 in der Datei UnifiedServiceDesk.exe.config gesetzt. Der Wertsatz in der UnifiedServiceDesk.exe.config hat Vorrang und Konfiguration verwenden den Edge WebView2-Prozess, um Anwendungen zu hosten.

  • Den GlobalBrowserMode Modusschlüssel auf EdgeWebView2 in der Datei UnifiedServiceDesk.exe.config für einen bestimmten Desktop-Client festlegen, dieser hat Vorrang über die einzelnen Einstellungen das gehostete Steuerelements.

Erstellen eines gehosteten Steuerelement Hostingtyp als Edge WebView2

  1. Bei Dynamics 365 anmelden

  2. Gehen Sie zu Einstellungen>Unified Service Desk.

  3. Gehostete Steuerelemente auswählen. Die Seite zeigt verfügbare gehostete Steuerelemente an.

  4. Wählen Sie Neu.

  5. Klicken Sie auf der Seite Neues gehostete Steuerelement die Details an und wählen Sie dann Edge WebView2 Prozess aus und Hosting-Typ vom Dropdownmenü.

    Gehostetes Edge-WebView2-Prozesssteuerelement.

  6. Wählen Sie Speichern.

Aktivieren Sie Edge WebView2 für Unified Service Desk auf dem Clientdesktop

  1. Navigieren Sie zum Verzeichnis, in dem Sie Unified Service Desk installiert haben und doppelklicken Sie die Datei, um UnifiedServiceDesk.exe.config zu öffnen.
    Beispielpfad: C:\Program Files\Microsoft Dynamics CRM USD\USD

  2. Geben Sie im Abschnitt <appSettings> den neuen Schlüssel ein.
    <add key="GlobalBrowserMode" value="EdgeWebView2"/>

  3. Speichern Sie die Datei.

Edge WebView2 für eine gesamte Organisation aktivieren

  1. Bei Dynamics 365 anmelden

  2. Gehen Sie zu Einstellungen>Unified Service Desk>Optionen.

  3. Klicken Sie auf der Seite Aktive UII-Optionen auf Neu.

  4. Wählen Sie Andere für das Kontrollkästchen Globale Option aus.

  5. Geben Sie im Feld Name GlobalBrowserMode ein.

  6. Geben Sie im Feld Wert den Wert EdgeWebView2 ein.

  7. Wählen Sie Speichern aus.

RunScript-Aktion ist asynchron im Edge WebView2 Prozess

Der Microsoft Edge Browser unterstützt nur die asynchronen Vorgänge und die RunScript-Aktion wird asynchron. Wenn die Ausführung von benutzerdefiniertem Code vom Rückgabewert abhängig ist, der von der RunScript-Aktion bereitgestellt wird, die JavaScript im Hauptframe der Anwendung einfügt, schlägt die Ausführung des benutzerdefinierten Codes möglicherweise fehl.

Beispielsweise hat Ihr benutzerdefinierter Code eine RunScript-Aktion, die JavaScript in der Anwendung verknüpft, die von einem Vorgang oder einer anderen RunScript-Aktion gefolgt wird. Die RunScript-Aktion wird ausgelöst und ein Wert nach der JavaScript-Einfügung wird zurückgegeben. Wenn der nachfolgende Vorgang oder basierend auf dem Rückgabewert der ausgeführten RunScript-Aktion eine andere RunScript Aktion anhand des Rückgabewerts ausgeführt wird, schlägt der nachfolgende Vorgang des benutzerdefinierten Codes fehl.

Beispielszenario

Immer wenn Sie einen Fall öffnen möchten, muss sichergestellt werden, dass die Anfrage für 10 oder mehr Tage geöffnet ist und dann eine Nachricht im Dialogfeld angezeigt wird. Wenn Sie in dem Dialogfeld eine Aktion ausführen, wird die Telefonanrufsseite für weitere Vorgänge geöffnet.

Um das oben erwähnte Szenario ausführen zu können, müssen Sie einen Aktionsanruf mit der eine RunScript Aktion ausfgeführt wird und einem Wert für die folgenden Aktionen zurückgibt. Die Daten im Aktionsanruf berechnen die Anzahl der Tage mit ein, die eine Anfrage offen ist.

Jetzt müssen Sie noch einen Aktionsanruf von Aktionen als ExecuteOnDataAvailable erstellen und das Datenfeld muss den Rückgabewert des ersten Aktionsanrufs haben. Das bedeutet, dass der Rückgabewert das Formular [[$Return.ActionCallName]] hat. Dadurch wird sichergestellt, dass die erste Aktion ausgeführt wird und der Aktionsanruf ausgeführt wird.

Anschließend müssen Sie einen Voraktionsanruf erstellen, um so die Anzahl der Tage anzuzeigen, die eine Anfrage im geöffneten Status ist. Das Datenfeld verwendet den Rückgabewert des ersten Aktionsaufrufs, d.h. [[$Return.ActionCallName]].

Sie müssen einen anderen Voraktionsanruf erstellen, um die Telefonanrufsseite zu öffnen und die folgenden Aktionen auszuführen. Nach Anzeige der Nachricht wählen Sie die Schaltfläche OK im Dialog aus. Damit wird die Telefonanrufsseite geöffnet.

Sehen wir uns an, welche Konfigurationen Sie benötigen, um das Szenario auszuführen.

Schritt 1: Erstellen Sie ein gehosteten Steuerelement

  1. Klicken Sie auf Einstellungen>Unified Service Desk>Gehostete Steuerelemente.

  2. Wählen Sie Neu.

  3. Fügen Sie die folgenden Details hinzu und speichern Sie dann das gehostete Steuerelement.

    Feld Wert
    Name Vorfall
    Anzeigename [[incident.title]]
    Unified Service Desk – Komponententyp Seite der Einheitlichen Oberfläche
    Hosting-Typ Edge WebView2-Prozess
    Anzeigegruppe MainPanel

Schritt 2: Erstellen Sie zwei Handlungsaufforderungen

  1. Gehen Sie zu Einstellungen>Unified Service Desk>Aktionsanrufe.

  2. Wählen Sie Neu.

  3. Fügen Sie die folgenden Details hinzu und speichern Sie dann den Aktionsanruf.

    Feld Wert
    Name FindNoOfDaysCaseBeingOpened
    Auftrag 1
    Gehostetes Steuerelement Vorfall
    Aktion RunScript
    Daten 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. Wiederholen Sie die Schritte 2 und 3, um einen weiteren Aktionsaufruf zu erstellen, diesmal mithilfe der folgenden Details.

    Feld Wert
    Name DaysValue
    Bestellung 2
    Gehostetes Steuerelement CRM Globaler Manager
    Aktion ExecuteOnDataAvailable
    Daten [[$Return.FindNoOfDaysCaseBeingOpened]]

Schritt 3: Erstellen Sie zwei Aktionsanrufe, und fügen Sie sie unter dem DaysValue-Aktionsanruf hinzu

  1. Gehen Sie zu Einstellungen>Unified Service Desk>Aktionsanrufe.

  2. Wählen Sie Neu.

  3. Fügen Sie die folgenden Details hinzu und speichern Sie dann den Aktionsanruf.

    Feld Wert
    Name DisplayMessageForCaseOpen
    Gehostetes Steuerelement CRM Global Manager
    Aktion DisplayMessage
    Daten text=Anzahl der Tage mit Fall im geöffneten Status: [[$Return.FindNoOfDaysCaseBeingOpened]]
    caption=Case ist geöffnet

  4. Wiederholen Sie die Schritte 2 und 3, um einen weiteren Aktionsaufruf zu erstellen, diesmal mithilfe der folgenden Details.

    Feld Wert
    Name OpenPhoneCallPage
    Gehostetes Steuerelement PhoneCall
    Aktion New_CRM_Page
    Daten LogicalName=phonecall
    description=Long Anfrage anhängiger mehr als 9 Tage dauern
    subject=Lang anhängiger Fall
    Erkrankung "[[$Return.FindNoOfDaysCaseBeingOpened]]">9

  5. Wählen Sie in der Liste der Aktionsanrufen, den Aktionsaufruf DaysValue aus.

  6. In der Navigationsleiste neben dem Aktionsanruf DaysValue, wählen Sie die schließende spitze Klammer (>), und wählen Sie Voraktions-Anruf aus.

  7. Wählen Sie VORHANDENEN AKTIONSANRUF HINZUFÜGEN. Im Feld Suche wählen Sie DisplayMessageForCaseOpen aus und wählen Sie dann das Symbol Suchen.

  8. Wählen Sie den angezeigten Aktionsaufruf aus.

  9. Wiederholen Sie die Schritte 7 und 8, diesmal geben Sie OpenPhoneCallPage für den Aktionsaufruf ein.

  10. Speichern Sie die Änderungen.

Schritt 4: Fügen Sie den Aktionsaufruf der Seite PageReady hinzu

  1. Gehen Sie zu Einstellungen>Unified Service Desk>Ereignisse.

  2. Wählen Sie das PageReady-Ereignis für das gehostete Steuerelement Vorfall der Liste der Ereignisse aus.

  3. Auf der Ereignisseite unter dem Bereich Aktive Aktionen klicken Sie auf das Plus-Zeichen (+), um Aktionsaufrufe hinzuzufügen.

  4. Ein Suchfeld wird angezeigt, geben Sie FindNoOfDaysCaseBeingOpened ein und wählen Sie dann das Symbol suchen aus und wählen Sie Aktionsanruf aus. Der Aktionsanruf wird unter dem Berich Aktive Aktionen angezeigt.

  5. Wiederholen Sie Schritt 4 und geben Sie dieses Mal DaysValue im Suchfeld ein.

  6. Speichern Sie die Änderungen.

Melden Sie von Sitzungen ab, wenn Sie den Edge WebView2-Prozess verwenden

Um sich von Sitzungen abzumelden, wenn Sie den Edge WebView2 Prozess verwenden, müssen sie die Abmeldungs-URL mithilfe der Aktion Navigieren des gehosteten Steuerelements konfigurieren. Die Abmelde-URL für die modellgesteuerte App lautet beispielsweise url=/main.aspx?signout=1.

Aktivieren Sie das Bestätigungsdialogfeld mit Edge WebView2 Prozess

Wenn Sie in einer Unified Service Desk-Sitzung eine Aktion auf einer App-Registerkarte ausführen und die Sitzung schließen, wird die EdgeWebView2ConfirmationDialog UII-Option ein Dialogfeld anzeigen, in dem Sie das Speichern und Schließen einer Sitzung bestätigen können.

Der Bestätigungsdialog wird angezeigt, wenn diese UII-Option hinzugefügt wurde oder der Wert als True definiert ist. Der Bestätigungsdialog wird nicht angezeigt, wenn diese UII-Option nicht hinzugefügt wurde oder der Wert als False definiert ist.

So fügen Sie die EdgeWebView2ConfirmationDialog UII-Option hinzu

  1. Melden Sie sich bei der Dynamics 365 Instanz an.

  2. Gehen Sie zu Einstellungen>Unified Service Desk>Optionen.

  3. Klicken Sie auf der Seite Aktive UII-Optionen auf Neu.

  4. Wählen Sie Andere für das Kontrollkästchen Globale Option.

  5. Geben Sie im Feld Name den Text EdgeWebView2ConfirmationDialog ein. Geben Sie im Feld Wert den Wert true ein.

  6. Wählen Sie Speichern aus.

Behandeln des URI-Protokolls in Edge WebView2 Prozess

Wenn Sie den Edge WebView2 Prozess verwenden, möchten Sie möglicherweise die Protokollnavigation in der Unified Service Desk-Client-Anwendung blockieren oder die Anwendung in einem separaten Fenster außerhalb der Unified Service Desk-Client-Anwendung öffnen. Verwenden Sie die Fensternavigationsregeln, um eine Anwendung zu blockieren oder außerhalb der Unified Service Desk-Client-Anwendung zu öffnen.

Fügen Sie die URL zu den Fensternavigationsregeln hinzu und setzen Sie Aktion auf Keine, um die Navigation zu blockieren. Legen Sie Außen zeigen fest, um die Anwendung außerhalb der Unified Service Desk-Client-Anwendung anzuzeigen.

Sie haben beispielsweise ein Softphone mit Unified Service Desk integriert und verwenden den Hostingtyp Edge WebView2 zum Hosten von Webanwendungen. Wenn ein Agent eine Telefonnummer auf der Kontakt- oder Firmaseite auswählt, sollte ein Anruf mit dem Softphone und nicht mit Skype eingeleitet werden. Erstellen Sie die Fensternavigationsregel und legen Sie Aktion auf Keine fest, um das Skype-Protokoll zu blockieren. Jetzt können Sie bestimmte Handlungsaufforderungen als Teilhandlungsaufforderungen dieser Fensternavigationsregel erstellen, um dann einen Anruf mit dem Softphone einzuleiten.

Um eine Fensternavigationsregel zu erstellen

  1. Melden Sie sich bei der Dynamics 365 Instanz an.

  2. Erweitern Sie Dynamics 365.

  3. Wählen Sie Unified Service Desk Administrator.

  4. Wählen Sie Fensternavigationsregeln unter Grundlegende Einstellungen aus.

  5. Wählen Sie Neu auf der Seite Aktive Fensternavigationsregeln aus.

  6. Geben Sie auf der Seite Neue Fensternavigationsregeln die folgenden Werte an.

    Registerkarte Feld Value
    Allgemein Name Telefon-Protokoll

    oder

    Skype-Protokoll
    Allgemein Url tel:

    oder

    Skype:
    Ergebnis Routentyp Popup
    Ergebnis Aktion Keine oder Außen zeigen

  7. Wählen Sie Speichern aus.

Wenn jetzt ein Mitarbeiter die Nummer auf der Kontakt- oder Firmaseite auswählt, blockiert der Edge WebView2-Prozess basierend auf der Fensternavigationsregel die Anwendung oder öffnet diese außerhalb der Unified Service Desk-Client-Anwendung.

Den Fokus auf die Webseite legen, wenn Edge WebView2 Prozess verwendet wird

Wenn Sie bei Verwendung von Edge WebView2 zum Hosten von Webanwendungen in Unified Service Desk den Fokus automatisch auf der Webseite festlegen möchten, müssen Sie einen Aktionsanruf mit der Aktionen RunScript und Daten mit einer JavaScript-Funktion - window.top USDEdgeWebView2SetFocus() erstellen. Nachdem Sie den Aktionsanruf erstellt haben, fügen Sie ihn im Fall einer Seite der einheitlichen Oberflächen dem PageReady-Ereignis hinzu und im Fall dem gehosteten Steuerelement CRM-Seite einem BrowserDocumentComplete-Ereignis hinzu.

Ein PDF in Edge WebView2-Prozess bearbeiten

Edge WebView2 Prozess unterstützt die Möglichkeit, eine PDF-Datei inline zu bearbeiten, wenn die PDF bearbeitbare Felder enthält.

Aktivieren Sie die Sprachunterstützung in Edge WebView2 Process

Edge WebView2 Prozess unterstützt die Möglichkeit, die Sprache auf Webseiten innerhalb von Unified Service Desk zu wechseln. Um die Sprache zu wechseln, müssen Sie die EdgeWebView2Language UII-Option hinzufügen.

So fügen Sie die EdgeWebView2Language UII-Option hinzu

  1. Melden Sie sich bei der Dynamics 365 Instanz an.

  2. Gehen Sie zu Einstellungen>Unified Service Desk.

  3. Klicken Sie auf Optionen.

  4. Klicken Sie auf der Seite Aktive UII-Optionen auf Neu.

  5. Wählen Sie im Feld Globale Option Andere aus.

  6. Geben Sie im Feld Name EdgeWebView2Language ein.

  7. Geben Sie im Feld Wert den Gebietsschemacode ein. Weitere Informationen: Sprachencodes

    Notiz

    Nur die Gebietsschemata unter dem Pfad <C:\Program Files\Microsoft Dynamics CRM USD\USD\locales> werden unterstützt.

  8. Wählen Sie Speichern.

Parameter mit Edge WebView2-Prozess hinzufügen

Der Microsoft Edge-Browser bietet viele Optionen, die auf den Webseiten in Unified Service Desk verwendet werden können. Die Option EdgeWebView2AdditionalBrowserArguments hilft beim Hinzufügen der Parameter.

So fügen Sie die EdgeWebView2AdditionalBrowserArguments UII-Option hinzu

  1. Melden Sie sich bei der Dynamics 365 Instanz an.

  2. Gehen Sie zu Einstellungen>Unified Service Desk.

  3. Klicken Sie auf Optionen.

  4. Klicken Sie auf der Seite Aktive UII-Optionen auf Neu.

  5. Wählen Sie im Feld Globale Option Andere aus.

  6. Geben Sie im Feld Name EdgeWebView2AdditionalBrowserArguments ein.

  7. Geben Sie für das Feld Wert einen gültigen Edge WebView2-Prozessparameter ein.

    Das Format zum Hinzufügen der Parameter lautet:
    --force-ui-direction:rtl;--force-text-direction:rtl;--log-level:3.

    Beachten Sie, dass die Parameter durch Semikolons getrennt sind. Weitere Informationen: Chromium-Befehlszeilenoptionen

  8. Wählen Sie Speichern.

Edge WebView2-Prozess debuggen

Sie können den Edge WebView2-Prozess auf zwei Arten debuggen:

  • Remote

  • Lokal

Edge WebView2-Prozess remote debuggen

Wenn Sie alle Instanzen des Edge WebView2-Prozesses, die auf einem Desktop ausgeführt werden, remote debuggen und darauf zugreifen möchten, benötigen Sie einen Remote-Zugriff für das Debuggen sowie eine Portnummer.

Verwenden Sie die UII-Option EdgeWebView2RemoteDebuggingPort und fügen Sie die Portnummer als Wert hinzu. Wenn Sie diesen Wert festgelegt haben, gehen Sie vom Webbrowser aus zu <IP address>:<\port number> des Remote-Desktops. Sie sehen alle Instanzen des ausgeführten Edge WebView2-Prozesses auf diesem Desktop und können ihn dann debuggen.

Edge WebView2-Prozess lokal debuggen

Wenn Sie alle Instanzen des Edge WebView2-Prozesses, die auf einem Desktop ausgeführt werden, lokal debuggen und darauf zugreifen möchten, benötigen Sie einen Zugriff sowie eine Portnummer für das Verbinden.

Verwenden Sie die UII-Option EdgeWebView2RemoteDebuggingPort und fügen Sie die Portnummer als Wert hinzu. Wenn Sie diesen Wert festgelegt haben, gehen Sie vom Webbrowser aus zu localhost:<\port number> des lokalen Desktops. Sie sehen alle Instanzen des ausgeführten Edge WebView2-Prozesses auf diesem Desktop und können ihn dann debuggen.

Sie können auch in der Client-Anwendung des Unified Service Desk eine Instanz des Edge WebView2-Prozesses debuggen, indem Sie mit der Taste F12 die Entwicklertools öffnen. Weitere Informationen finden Sie unter: Verwalten von Optionen in Unified Service Desk

So fügen Sie die EdgeWebView2RemoteDebuggingPort-UII-Option hinzu

  1. Melden Sie sich bei der Dynamics 365 Instanz an.

  2. Gehen Sie zu Einstellungen>Unified Service Desk>Optionen.

  3. Klicken Sie auf der Seite Aktive UII-Optionen auf Neu.

  4. Wählen Sie im Feld Globale Option Andere aus.

  5. Geben Sie im Feld Name EdgeWebView2RemoteDebuggingPort ein. Im Feld Wert geben Sie die Portnummer ein (z. B. 1030).

  6. Wählen Sie Speichern.

Siehe auch

Erstellen oder Bearbeiten eines gehosteten Steuerelements
Typen gehosteter Steuerelemente und Referenz zu Aktionen/Ereignissen
Verwalten von gehosteten Steuerelementen, Aktionen und Ereignissen