CTI コントロールの作成

[アーティクル]
03/06/2017

公開日: 2016年11月

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

エージェントの状態及びコールの状態を管理するため、コンピューターテレフォニー統合 (CTI) セッションは以下のユーザーインターフェイス (UI) のコントロールが必要です。

エージェントの状態管理コントロール: 現在のエージェントの状態を User Interface Integration (UII) デスクトップ内 (Unified Service Deskなど) に表示します。このコントロールは CTI システムと関連付ける必要はありませんが、関連付ける場合は CTI エージェントの状態を、エージェントデスクトップのビジュアル状態である現在のエージェントの状態にマッピングできます。
コールコントロール: 電話をかけ、電話に応答し、電話を保留にし、他のエージェントに電話を転送、または電話を切るためにエージェントが使用できるボタンが用意されています。

これらのコントロールは両方とも、通常の UII のホストされたコントロールで、HostedControl または HostedWpfControl クラスのいずれかから継承されます。また、両方のコントロールを 1 つの UII のホストされたコントロールに結合することを選択できます。詳細:Unified Service Desk での UII のホストされたコントロールの使用

CTI コントロールを実装するためのインターフェイス

以下のインターフェイスを使用して、CTI コントロールのユーザーインターフェイスを実装します。

ICtiAgentStateControl

ICtiAgentStateControl インターフェイスは、エージェントの状態情報の処理や表示に使用するホストされたコントロールを説明する、特別なインターフェイスです。このインターフェイスには、エージェントの状態をセットするために使用する、SetAgentState メソッドが含まれます。

IDesktopUserActionsConsumer

IDesktopUserActionsConsumer インターフェイスは CTI 専用ではありませんが、通常は CTI コントロールがデスクトップ操作にアクセスするために使用します。以下の 2 つのメンバーがあります。

DesktopLoadingComplete: デスクトップの読み込みが完了したとき起動します。これは、主要なデスクトップ UI スレッドから別々のスレッドに立てられます。
SetDesktopUserActionsAccess: ICtiEnabledControlConsumer インターフェイスを実装したホストされたコントロールで、デスクトップローダーがそれ自身にポインターをセットするために使用します。これはデスクトップインターフェイス (シェル) に対するポインターです。

このインターフェイスを実装すると、次の例に示すように、すべてのユーザーに対するアクセス権を取得できます。

bool AppExistsInUI(string applicationName);
bool CloseDynamicApplication(string applicationName);
bool CloseSession();
bool CloseSession(Session sessionToClose);
bool CreateDynamicApplication(string applicationName);
WorkflowData GetCurrentWorkflowState();
bool SetFocusOnApplication(string applicationName);
string UserDefinedCommand(string command, string request);

ICtiEnabledControlConsumer

ICtiEnabledControlConsumer インターフェイスは、CtiCallStateManager および CtiAgentStateManager に対するポインターを受け入れるホストされたコントロールを説明します。

このインターフェイスには、以下の関数を実行するためのメソッド定義があります。

SetManagers: このインターフェイスを実装するコントロールが初期化される時に UII が呼び出します。
SessionCloseEvent: セッションがクローズするときに UII が呼び出します。

ICtiEnabledControlConsumer インターフェイスは IsManagersSet プロパティを使用して、SetManagers メソッドが正常に呼出されたかをセットまたは取得します。

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

Microsoft Dynamics 365 にサインインします。
ナビゲーションバーで、Microsoft Dynamics 365 > [設定] > [Unified Service Desk] を選択します。
[Unified Service Desk] ページで、[ホストされたコントロール] をクリックします。
[ホストされたコントロール] ページで、[新規] をクリックします。

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

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

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

次の方法で共有