CTI コネクタの作成

 

公開日: 2016年11月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2013、Dynamics CRM 2015、Dynamics CRM 2016

カスタム CTI アダプターの CTI コネクタ コンポーネントには、外部 CTI システムと接続して通信するためのロジックが含まれています。CTI コネクタ は、ICtiControl インターフェイスで構成され、これには CTI デスクトップ マネージャー コンポーネントがコールおよびリスンするメソッドおよびイベントを含む、CtiHostedControl クラスが含まれます。

CTI コネクタ は CTI システムとの 2 つの対話モデルをサポートしています。

• 最初のモデルはサービス ベースのポーリング システムです。 このモデルで、開発者は上流 CTI 対話ソースのためのサービス接続を定義し、更新およびイベントのためにそのソースをポーリングします。 このモデルは、Web サービスを通じてイベントおよび CTI アクションにアクセスできる、CTI ソースの場合で好まれます。 このモデルでは、上流 CTI Web サービスとの非同期通信をサポートする、適切なスレッド モデルを考慮する必要があります。

• 2 番目のモデルは、コールバックまたはイベント通知システムを使用する、インスタンス オブジェクトまたは静的オブジェクトを使用します。 このモデルは API を提供する CTI ソースで好まれます。 ポーリング モデルの場合、Unified Service Desk に影響を与えないようにするため、スレッドを介した非同期サポートの提供を考慮する必要があります。

UII CTI フレームワークは、CTI コネクタ コンポーネントのインスタンスを 1 つのみサポートしています。

このトピックの内容

CTI コネクタの定義

Unified Service Desk で CTI コネクタのホストされたコントロールを構成する

CTI コネクタの定義

CTI コネクタ は ICtiControl インターフェイスを実装します。CTI コネクタ を定義するには、次のいずれかの方法で Dynamics 365 SDK Microsoft Visual Studio プロジェクト テンプレートを使用します。

• Visual Studio ギャラリーから CRM SDK テンプレートをダウンロードする。CRMSDKTemplates.vsix ファイルをダブルクリックして、Visual Studioにテンプレートをインストールします。

• CRM SDK をダウンロードしてインストールします。 このテンプレート ファイル、CRMSDKTemplates.vsixは、SDK\Templates フォルダーにあります。 ファイルをダブルクリックして、Visual Studio にテンプレートをインストールします。

注意

テンプレートは、Microsoft .NET Framework 4.5.2 および Microsoft Visual Studio 2012、Visual Studio 2013、または Visual Studio 2015 がある場合に動作します。 また、Visual Studio 2012、Visual Studio 2013、または Visual Studio 2015 用の NuGet Package Managerが必要です。

CTI コネクタ テンプレートでは、CTI コネクタ を定義するために役立つ、接続済みイベントおよびメソッドが用意されています。

1. Visual Studio を起動し、新しいプロジェクトを作成します。

2. 新しいプロジェクト ダイアログ ボックスで以下を実行します。

   1. インストール済みのテンプレートの一覧から、[Visual C#] を展開し、[Dynamics 365 SDK のテンプレート] > [Unified Service Desk] > [USD CTI コネクタ] を選択します。

   2. プロジェクトの名前と場所を指定し、[OK] をクリックします。

      

3. [ソリューション エクスプローラ] で、CtiConnector.cs ファイルを右クリックし、[コードの表示] を選択してにコードを表示します。

4. 必須のメソッドおよびイベントを実装します。CTI コネクタの作成方法を示すサンプル コードの場合、UII SDK をダウンロードおよびインストールし、次に UII\SampleCode\UII\CCA\Source Code\Cti Root フォルダーに移動します。CTI コネクタに実装するメソッドおよびイベントの詳細については、ICtiControlを参照してください。

5. プロジェクトを保存してプロジェクトを作成します ([ビルド] > [ソリューションの作成])。 プロジェクトが正常に作成されると、プロジェクトの \bin\debug フォルダーにあるプロジェクト (プロジェクトのプロパティを変更していない場合) と同じ名前で、アセンブリ (.dll ファイル) が生成されます。

   注意

   CtiConnector.cs ファイルで CTI コントロールを作成するために使用する、クラスの名前を記録します。 次の手順でこの情報が必要です。

6. このファイルを Unified Service Desk クライアント アプリケーションのインストール ディレクトリ (通常、C:\Program Files\Microsoft Dynamics CRM USD\USD) にコピーします。 このファイルはテストおよび Unified Service Desk クライアント アプリケーションから CTI コネクタ を使用するために必要です。

Unified Service Desk で CTI コネクタのホストされたコントロールを構成する

CTI コネクタ コントロールの作成後、それを Unified Service Desk で構成する必要があります。

注意

また、CTI コネクタ プロジェクトを使用すると、CTI デスクトップ マネージャー コンポーネントを定義できます。CTI コネクタ および CTI デスクトップ マネージャー 用の、2 つの個別のホストされたコントロールを作成する必要があります。Visual Studio で後者にコードを追加後、Unified Service Desk で作成します。詳細:CTI デスクトップ マネージャーの作成

1. Microsoft Dynamics 365 にサインインします。

2. ナビゲーション バーで、Microsoft Dynamics 365 > [設定] > [Unified Service Desk] を選択します。

3. [Unified Service Desk] ページで、[ホストされたコントロール] を選択します。

4. [ホストされたコントロール] ページで、[新規] を選択します。

5. [新しいホストされたコントロール] ページで、次の値を指定します。

   フィールド	値
   名前	CTIConnector
   USD コンポーネントの種類	CCA ホステッド アプリケーション
   ホステッド アプリケーション	ホストされたコントロール
   アプリケーションはグローバル	チェック済み
   表示グループ	HiddenPanel
   アダプター	アダプターを使用しない
   アセンブリ URI	これは、以前の手順で作成したアセンブリ ファイル (..dll) の名前です。
   アセンブリの種類	これは、後ろにドット、次に CTI コネクタ のクラス名が付いたアセンブリ ファイル (.dll) の名前です。 たとえば、.dll ファイル名が MyCtiConnector で、CTI プロジェクトのクラス名が CtiConnector である場合、このフィールドに MyCtiConnector.CtiConnector という値を入力します。

6. [保存] を選択して、ホストされたコントロールを作成します。

関連項目

CTI デスクトップ マネージャーの作成
CTI コントロールの作成
UII コンピューター テレフォニー統合 (CTI) フレームワーク
チュートリアル: CTI イベントのルーティングに対する汎用リスナー アダプターを使用する

Unified Service Desk 2.0

© 2017 Microsoft. All rights reserved. 著作権