Erstellen eines CTI-Konnektors

Die CTI Connector-Komponente in Ihrem angepassten CTI-Adapter enthält die Logik für die Verbindung zu und die Kommunikation mit einem externen CTI-System. CTI Connector besteht aus der Schnittstelle ICtiControl, die die Klasse CtiHostedControl enthält, die Methoden und Ereignisse enthält, die von der Komponente CTI Desktop Manager aufgerufen und abgehört werden.

CTI Connector unterstützt zwei Modelle der Interaktion mit CTI-Systemen:

• Das erste Modell ist ein dienstbasiertes Abrufsystem. In diesem Modell definiert der Entwickler eine Service-Verbindung zu einer Upstream CTI-Interaktionsquelle und ruft den Ursprung für Aktualisierungen und Ereignisse ab. Dieses Modell wird für CTI-Quellen vorgezogen, die Zugriff auf Ereignisse und CTI-Aktionen über Webdienste gewähren. In diesem Modell muss das richtige Threadingmodell berücksichtigt werden, um asynchrone Kommunikationen mit dem Upstream CTI-Webdienst zu unterstützen.

• Das zweite Modell verwendet ein instanziiertes oder statisches Objekt, das ein Rückruf- oder ein Benachrichtigungssystem verwendet. Dies Modell wird für CTI-Quellen, die ein API bieten, bevorzugt. Wie beim Abfragemodell sollte die asynchrone Unterstützung über Threading in Betracht gezogen werden, um Auswirkungen auf Unified Service Desk zu vermeiden.

  Das UII CTI Framework unterstützt nur eine Instanz der CTI Connector Komponente.

Definieren eines CTI-Konnektors

CTI Connector implementiert die Schnittstelle ICtiControl. Um einen CTI Connector zu definieren, verwenden Sie die CRM SDK Visual Studio Projektvorlage. Laden Sie die CRM SDK-Vorlagen aus dem Visual Studio Katalog herunter,und doppelklicken Sie auf die Datei CRMSDKTemplates.vsix, um die Vorlage in Visual Studio zu installieren.

Notiz

Die Vorlage funktioniert, wenn Sie Microsoft .NET Framework 4.6.2 und Visual Studio 2012, Visual Studio 2013 oder Visual Studio 2015 haben. Außerdem benötigen Sie den NuGet Package Manager für Visual Studio 2012, Visual Studio 2013 oder Visual Studio 2015.

Die CTI Connector-Vorlage bietet vorverdrahtete Ereignisse und Methoden, mit deren Hilfe Sie einen CTI Connector definieren können.

1. Starten Sie Visual Studio und erstellen Sie ein neues Projekt.

2. Im Dialogfeld Neues Projekt:

   1. Erweitern Sie in der Liste der installierten Vorlagen Visual C# und wählen Sie CRM SDK-Vorlagen>Unified Service Desk>USD CTI Connector.

   2. Geben Sie den Namen und den Standort des Projekts an, und klicken Sie auf OK.

   

3. Rechtsklicken Sie in Lösungsexplorer auf die CtiConnector.cs-Datei, und wählen Sie Code anzeigen aus, um den Code anzuzeigen.

4. Implementieren Sie erforderlichen Methoden und Ereignisse. Für Beispielcode, der zeigt, wie ein CTI Connector erstellt wird, laden Sie das UII SDK herunter und installieren Sie es, und suchen Sie dann den Ordner UII\SampleCode\UII\CCA\Source Code\Cti Root. Weitere Informationen zu den Methoden und Ereignissen, die für einen CTI Connector implementiert werden müssen, finden Sie in der ICtiControl Schnittstelle.

5. Speichern Sie das Projekt und bauen Sie es auf (Aufbauen>Lösung aufbauen). Nachdem das Projekt erfolgreich aufgebaut wurde, wird eine Assembly (.dll-Datei) mit denselben Namen wie dem Projekt (außer wenn Sie diesen in den Projekteigenschaften geändert haben) im \bin\debug-Ordner Ihres Projekts erstellt.

   Notiz

   Notieren Sie den Namen der Klasse, die verwendet wird, um das CTI gehostete Steuerelement in der CtiConnector.cs-Datei zu erstellen. Sie benötigen diese Informationen im nächsten Schritt.

6. Kopieren Sie diese Datei in das Installationsverzeichnis Ihrer Unified Service Desk Client-Anwendung (in der Regel C:\Program Files\Microsoft Dynamics CRM USD\USD). Diese Datei wird zum Testen und für die Verwendung des CTI Connectors von Ihrer Unified Service Desk Client-Anwendung aus benötigt.

Konfigurieren eines gehosteten Steuerelements für CTI Connector in Unified Service Desk

Nachdem Sie Ihr Steuerelement für den CTI Connector erstellt haben, müssen Sie es in Unified Service Desk konfigurieren.

Notiz

Im CTI Connector Projekt können Sie auch Ihre CTI Desktop Manager Komponente definieren. Sie müssen in Unified Service Desk zwei separate gehostete Steuerelemente erstellen, jeweils eines für den CTI Connector und den CTI Desktop Manager, nachdem Sie den Code für letzteren in der Visual Studio hinzugefügt haben. Weitere Informationen: Erstellen eines CTI Desktop Managers

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

2. Klicken Sie auf der Navigationsleiste auf Dynamics 365>Einstellungen>Unified Service Desk.

3. Wählen Sie auf der Seite Unified Service Desk die Option Gehostete Steuerelemente aus.

4. Wählen Sie auf der Seite Gehostete SteuerelementeNeu.

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

   Feld	Wert
   Name	CTIConnector
   USD-Komponententyp	Gehostete CCA-Anwendung
   Gehostete Anwendung	Gehostetes Steuerelement
   Anwendung ist global	Markiert
   Anzeigegruppe	HiddenPanel
   Adapter	Keinen Adapter verwenden
   Assembly-URI	Dies ist der Name der Assemblydatei (.dll), die Sie im vorherigen Schritt der erstellt haben.
   Assemblytyp	Dies ist der Name der Montage-Datei (.dll), gefolgt von einem Punkt, und dann der Klassenname Ihres CTI Connectors. Wenn der Name Ihrer .dll-Datei beispielsweise MyCtiConnector und der Name der Klasse Ihres CTI-Projekts CtiConnector lautet, geben Sie den folgenden Wert in dieses Feld ein: MyCtiConnector.CtiConnector.

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

Siehe auch

Erstellen eines CTI Desktop ManagersErstellen eines CTI-SteuerelementsUII Computer Telephony Integration (CTI) FrameworkBeispielhafte Vorgehensweise: Generischen Listener-Adapter für CTI-Ereignisse verwenden