Exemplarische Vorgehensweise: Verwenden des allgemeinen Listeneradapters für CTI-Ereignisweiterleitung

Diese exemplarische Vorgehensweise zeigt, wie Sie den CTI Desktop-Manager und den generischen Listener in Unified Service Desk verwenden können, um die CTI-Ereignisse als Screen-Pops in Unified Service Desk darzustellen. Für diese exemplarische Vorgehensweise verwenden wir eine Beispielanwendung des CTI Simulators, die CTI-Anfragen an Unified Service Desk sendet.

In dieser exemplarischen Vorgehensweise werden Sie Folgendes erfahren:

• Suchen Sie nach einem Kontaktdatensatzes in den Beispieldaten anhand einer E-Mail-Adresse, die in der Beispiel CTI Call Tester-Anwendung angegeben ist.

• Erstellen Sie eine Fensternavigationsregel, um den passenden Datensatz in einer Sitzung in Unified Service Desk anzuzeigen.

Anforderungen

• Microsoft .NET Framework 4.6.2

• Unified Service Desk Client-Anwendung; wird für das Testen des gehosteten Steuerelements benötigt.

• Visual Studio 2012 oder Visual Studio 2013

• Laden Sie das Beispiel-CTI Simulator-Anwendung Visual Studio Projekt auf den Computer herunter. Bauen Sie auf das Projekt auf, und führen Sie Anwendung (.exe-datei) im bin\debug-Ordner des Beispielanwendungsprojekts aus. Sie müssen die Anwendung USD CTI Simulator auf demselben Computer ausführen, auf dem auch der Unified Service Desk Client läuft, um die Anwendung zu testen.

Schritt 1: Konfigurieren eines CTI Desktop Manager gehosteten Steuerelements in Unified Service Desk

1. Melden Sie sich bei Unified Service Desk Administrator an.

2. Wählen Sie Gehostete Steuerelemente unter Grundeinstellungen.

3. Wählen Sie + Neu.

4. Geben Sie auf der Seite Neues gehostetes Steuerelement die folgenden Werte an:

   Feld	Wert
   Name	CTITest
   USD-Komponententyp	CTI-Desktop-Manager
   Anzeigegruppe	HiddenPanel
   Assembly-URI	Microsoft.Crm.UnifiedServiceDesk.GenericListener
   Assemblytyp	Microsoft.Crm.UnifiedServiceDesk.GenericListener.DesktopManager

   Notiz

   Die Werte, die in den Feldern Assembly-URI und Assemblytyp angegeben sind, sind die allgemeinen Listenerwerte für den Typ CTI Desktop Manager gehostetes Steuerelement.

5. Klicken Sie auf Speichern, um das gehostete Steuerelement zu erstellen.

Schritt 2: Testen, ob die CTI-Ereignisse in Unified Service Desk ausgelöst werden

1. Starten Sie den Unified Service Desk Client und stellen Sie eine Verbindung zu Ihrer Microsoft Dataverse Instanz her. Nachdem der Client eingerichtet ist, wählen Sie Einstellungen in der oberen rechten Ecke, um das Steuerelement für den Debugger anzuzeigen, und wählen Sie dann Debug-Ausgabe löschen, um den Desktop zu löschen.

   

2. Starten Sie die USD CTI Simulator-Anwendung, geben Sie E-Mail in der Spalte Schlüssel ein, und geben Sie einen Zufallswert in der Spalte Wert an. Klicken Sie auf An USD senden.

   

3. Ein Bildschirmpopup erscheint in der Client-Anwendung, um das CTI-Ereignis verfügbar zu machen. In diesem Fall wird ein CTILookUpRequest initiiert mit dem Wert, der in der USD CTI Simulator-Anwendung angegeben wurde. Da Sie diese noch nicht mit einer Fensternavigationsregel verknüpft haben, wird kein Vorgang ausgeführt.

   

Schritt 3: Definieren einer Fensternavigationsregel, um das CtiLookUpRequest weiterzuleiten

Erstellen Sie eine Fensternavigationsregel, um eine Sitzung zu erstellen, wenn eine Übereinstimmung gefunden wird, und zeigen Sie dann den übereinstimmenden Datensatz des Kontakts in einer Sitzung in Unified Service Desk an.

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

2. Navigieren Sie zur erweiterten Suche für Kontakte und erstellen Sie eine Abfrage, in der Sie nach aktiven Kontakten suchen, bei denen das Feld E-Mail, E-Mail-Adresse 2 oder E-Mail-Adresse 3 einem bestimmten Wert entspricht, z.B. someone_c@example.com.

   

3. Wählen Sie Fetch XML herunterladen, um die Abfrage als FetchXML abzuspeichern.

4. Gehen Sie zur Unified Service Desk-Administrator-App.

5. Wählen Sie Fensternavigationsregeln aus.

6. Wählen Sie + Neu aus.

7. Geben Sie im Fenster Neue Fensternavigationsregel die folgenden Werte an.

   Feld	Wert
   Name	CTITestRoute
   Reihenfolge	50
   Von	CTITest Dies ist der Name des CTI Desktop Manager gehosteten Steuerelements.
   Richtung	Beide

8. Speichern Sie die Regel. Das aktiviert den Rest der Steuerelemente auf der Seite.

9. Fügen Sie nun die FetchXML-Abfrage hinzu, die zuvor für diese Regel gespeichert wurde. Wählen Sie unter CTI-Suchen hinzufügen aus.

10. Geben Sie im Fenster Neue CTI-Suche folgende Werte an:

• Name: CTIContactSearch

• Auftrag:1

• FetchXML:

  
  <fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false">  
    <entity name="contact">  
      <attribute name="fullname" />  
      <attribute name="parentcustomerid" />  
      <attribute name="telephone1" />  
      <attribute name="emailaddress1" />  
      <attribute name="contactid" />  
      <order attribute="fullname" descending="false" />  
      <filter type="and">  
        <condition attribute="statecode" operator="eq" value="0" />  
        <filter type="or">  
          <condition attribute="emailaddress1" operator="eq" value="[[cti.Email]]" />  
          <condition attribute="emailaddress2" operator="eq" value="[[cti.Email]]" />  
          <condition attribute="emailaddress3" operator="eq" value="[[cti.Email]]" />  
        </filter>  
      </filter>  
    </entity>  
  </fetch>  
  

  Anmerkung

  Die Adresse someone_c@example.com wurde durch [[cti.Email]] ersetzt, damit die Suche auf der Grundlage des für den Schlüssel Email in der Anwendung Unified Service Desk CTI Simulator angegebenen Wertes ausgeführt wird.

11. Speichern Sie den CTI-Suchweg, und kehren Sie zur Fensternavigationsregel zurück.

12. Wählen Sie unter Einzelne Übereinstimmung im Feld Entscheidung die Option Sitzung erstellen, Übereinstimmung laden, dann Aktion ausführen.

13. Klicken Sie unter Einzelne Übereinstimmung im Feld Aktion auf das Nachschlagesymbol, um einen Wert auszuwählen, und klicken Sie dann auf + Neu.

14. Erstellen Sie auf der Seite + Neuer Aktionsaufruf einen Aktionsaufruf, um den Kontaktdatensatz zu öffnen, indem Sie folgende Werte angeben.

    Feld	Value
    Name	CTIOpenContact
    Gehostetes Steuerelement	CRM Globaler Manager
    Aktion	Open_CRM_Page
    Daten	Id=[[$Context.Id]] LogicalName=[[$Context.LogicalName]]

15. Speichern Sie den Aktionsaufruf, und schließen Sie die Aktionsaufrufseite, um zur Fensternavigationsregel-Definitionsseite zurückzukehren.

16. Im Bereich Ergebnis:

    1. Im Feld Ziel wählen Sie Registerkarte, um den übereinstimmenden Kontaktdatensatz in einer Registerkarte anzuzeigen.

    2. Wählen Sie im Feld Registerkarte "Ziel" das gehostete Steuerelement Kontakt aus. Das gehostete Steuerelement Kontakt wurde erstellt, als Sie eine Unified Service Desk-Beispielanwendung auf Ihrem Server Dataverse mit dem Tool Package Deployer bereitstellten. Weitere Informationen finden Sie unter Unified Service Desk-Beispielanwendungen für den CRM-Server mithilfe des Package Deployer bereitstellen.

    3. Wählen Sie im Feld Registerkarte "Anzeigen" das gehostete Steuerelement Kontakt aus

    

17. Speichern Sie die Fensternavigationsregel.

Testen des CTI-Adapters

1. Starten Sie den Unified Service Desk Client und stellen Sie eine Verbindung zu Ihrer Dataverse Instanz her. Nachdem der Client eingerichtet ist, wählen Sie Einstellungen in der oberen rechten Ecke, um das Steuerelement für den Debugger anzuzeigen, und wählen Sie dann Debug-Ausgabe löschen, um den Desktop zu löschen.

   

2. Starten Sie die USD CTI Simulator-Anwendung, geben Sie E-Mail in der Spalte Schlüssel ein, und geben Sie eine gültige E-Mail--ID für den Kontakt an, den Sie suchen möchten. In diesem Fall geben Sie in der Spalte Wert eine someone_d@example.com ein. Wählen Sie An USD senden.

   

3. Der passende Datensatz wird in einer Sitzung in Unified Service Desk angezeigt.

   

4. Überprüfen Sie das Debugger gehostete Steuerelement, um die Ereignisse anzuzeigen, die als Ergebnis der CTI-Suche ausgelöst wurden. Überprüfen Sie außerdem die Registerkarte Datenparameter, um die Kontextinformationen in der $Context-Variablen und CTI-Information unter der CTI-Variablen anzuzeigen.

Siehe auch

Integrate with CTI systems
UII Computer Telephony Integration (CTI) Framework