次の方法で共有

CTI コネクタの作成

  • [アーティクル]

カスタム 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 コネクタの定義

CTI コネクタは、ICtiControl インターフェイスを実装します。 CTI コネクタを定義するには、CRM SDK Visual Studio プロジェクト テンプレートを使用します。 CRM SDK テンプレート を Visual Studio ギャラリーから ダウンロード し、CRMSDKTemplates.vsix ファイルをダブルクリックして、Visual Studio でテンプレートをインストールします。

Note

テンプレートは、Microsoft .NET Framework 4.6.2 および Visual Studio 2012、Visual Studio 2013、または Visual Studio 2015 がある場合に動作します。 さらに、Visual Studio 2012、Visual Studio 2013、Visual Studio 2015 の NuGet パッケージ マネージャーが必要です。

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

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

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

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

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

    USD CTI コネクタの作成。

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

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

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

    Note

    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 で構成する必要があります。

Note

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

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

  2. ナビゲーション バーで、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 イベントに対して汎用リスナー アダプターを使用する