チュートリアル: CTI イベントのルーティングに対する汎用リスナー アダプターを使用する

公開日: 2016年11月

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

このチュートリアルでは、CTI デスクトップ マネージャーおよび汎用リスナーを Unified Service Desk で使用して、CTI イベントを Unified Service Desk の画像ポップとして表示する方法を説明します。 このチュートリアルでは、CTI 要求を Unified Service Desk に送信する、サンプル CTI シミュレーター アプリケーションを使用します。

このチュートリアルでは、以下の操作を行います。

• CTI コール テスター アプリケーションで指定した電子メール アドレスに基づき、サンプル Microsoft Dynamics 365 データで取引先担当者レコードを検索します。

• Unified Service Desk のセッション内の一致するレコードを表示する、ウィンドウ ナビゲーション ルールを作成します。

このトピックの内容

前提条件

手順 1: Unified Service Desk で CTI デスクトップ マネージャーのホストされたコントロールを構成する

手順 2: CTI イベントが Unified Service Desk で起動されるかテストする

手順 3: CtiLookUpRequest をルーティングするウィンドウ ナビゲーション ルールを定義する

CTI アダプターのテスト

前提条件

• Microsoft .NET Framework 4.5.2

• Unified Service Desk クライアント アプリケーション - ホストされたコントロールをテストするために必要。

• Microsoft Visual Studio 2012 または Visual Studio 2013

• コンピューターにサンプル CTI シミュレーター アプリケーション Visual Studio プロジェクトをダウンロードします。 プロジェクトを構築し、アプリケーション (.exe file) をサンプル アプリケーション プロジェクトの bin\debug フォルダーから実行します。 アプリケーションをテストするために Unified Service Desk クライアントを実行しているのと同じコンピューター上で、USD CTI シミュレーター アプリケーションを実行する必要があります。

手順 1: Unified Service Desk で CTI デスクトップ マネージャーのホストされたコントロールを構成する

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

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

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

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

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

   フィールド	値
   名前	CTITest
   USD コンポーネントの種類	CTI Desktop Manager
   表示グループ	HiddenPanel
   アセンブリ URI	Microsoft.Crm.UnifiedServiceDesk.GenericListener
   アセンブリの種類	Microsoft.Crm.UnifiedServiceDesk.GenericListener.DesktopManager

   注意

   [アセンブリ URI] および [アセンブリの種類] フィールドで指定した値は、[CTI デスクトップ マネージャー] のホストされたコントロールの種類の汎用リスナー値です。

   

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

手順 2: CTI イベントが Unified Service Desk で起動されるかテストする

1. Unified Service Desk クライアントを開始して、Dynamics 365 インスタンスに接続します。 クライアントを設定後、右上隅の [設定] を選択してデバッガ コントロールを表示し、次に [デバッグ出力のクリア] を選択してデスクトップをクリアします。

   

2. USD CTI シミュレーター アプリケーションを開始し、[キー] 列に [電子メール] と入力し、[値] 列で任意の値を指定します。[USD に送信] をクリックします。

   

3. クライアント アプリケーションに画面ポップアップが発生し、CTI イベントが実行されます。 この場合、CTILookUpRequest は USD CTI シミュレーター アプリケーションで指定された値で起動されます。 まだウィンドウ ナビゲーション ルールを適用していないため、何も実行されません。

   

手順 3: CtiLookUpRequest をルーティングするウィンドウ ナビゲーション ルールを定義する

一致が見つかる場合はセッションを作成するウィンドウズ ナビゲーション ルールを作成し、一致する取引先担当者レコードを Unified Service Desk のセッションに表示します。

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

2. 取引先担当者の高度な検索に移動し、アクティブな取引先担当者を検索するクエリを作成します。ここで電子メール、電子メール アドレス 2、または電子メール アドレス 3 フィールドは、someone_c@example.com などの特定の値と等しくなります。

   

3. [Fetch XML の​​ダウンロード] をクリックし、クエリを FetchXML として保存します。

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

5. [新規] をクリックし、[新しいウィンドウ ナビゲーション ルール] ウィンドウで、以下の値を指定します。

   フィールド	値
   名前	CTITestRoute
   受注	50
   差出人	CTITest 注意 これが CTI デスクトップ マネージャーのホストされたコントロールの名前です。
   通信方向	両方

   .jpeg "CTI イベントのルーティングのための新しいウィンドウ ナビゲーション ルール")

   6. ルールを保存します。 これにより、ページの残りのコントロールが有効になります。

   7. ここで、このルールに対して、保存済みの FetchXML クエリを追加します。[CTI 検索] 領域で、追加を選択します。

   8. [新しい CTI 検索] ウィンドウで、以下の値を指定します。

      フィールド	値
      名前	CTIContactSearch
      受注	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> 注意 アドレス someone_c@example.com は [[cti.Email]] で置換され、検索は Unified Service Desk CTI シミュレーター アプリケーション内の [電子メール] キーのために指定した値に基づき実行されます。

      .jpeg "取引先担当者の CTI 検索を定義")

      9. CTI 検索ルールを保存して、ウィンドウ ナビゲーション ルールに戻ります。

      10. [1 つの一致項目] の**[決定]** フィールドで、[セッションの作成、一致項目の読み込み後、アクション実行] を選択します。

      11. **[1 つの一致項目]の[アクション]フィールドで、検索アイコンをクリックし、値を選択し、[新規]**をクリックします。

      12. 新しいアクション コール ページで、次の値を指定して、取引先担当者レコードを開くアクション コールを作成します。

          フィールド	値
          名前	CTIOpenContact
          ホストされたコントロール	Dynamics 365 グローバル マネージャー
          目的	Open_CRM_Page
          データ	Id=[[$Context.Id]]LogicalName=[[$Context.LogicalName]]

          

      13. アクション コールを保存し、アクション コール ページを閉じて、ウィンドウ ナビゲーション ルール定義ページに戻ります。

      14. [結果] 領域で以下を実行します。

          1. [宛先] フィールドで [タブ] を選択して、一致する取引先担当者レコードをタブに表示します。

          2. 対象のタブフィールド で、取引先担当者のホストされたコントロールを選択します。パッケージ展開機能ツールを使用して、Dynamics 365サーバーにサンプルUnified Service Desk アプリケーションを展開した際に、取引先担当者のホストされたコントロールが作成されます。 詳細については、「Package Deployerを使用したサンプルUnified Service Desk アプリケーションの CRM サーバーへの展開」を参照してください。

          3. タブの表示フィールドで、取引先担当者のホストされたコントロールを選択します。

          

      15. ウィンドウ ナビゲーション ルールを保存します。

      CTI アダプターのテスト

      1. Unified Service Desk クライアントを開始して、Dynamics 365 インスタンスに接続します。 クライアントを設定後、右上隅の [設定] を選択してデバッガ コントロールを表示し、次に [デバッグ出力のクリア] を選択してデスクトップをクリアします。

         

      2. USD CTI シミュレーター アプリケーションを開始し、[キー] 列に [電子メール] と入力し、検索する取引先担当者の有効な電子メール ID を指定します。 この場合、 [値] 列に someone_d@example.com と入力します。[USD に送信] をクリックします。

         

      3. 一致する取引先担当者レコードにが Unified Service Desk のセッションに表示されます。

         

      4. CTI 検索の結果として発生するイベントを表示するには、デバッガのホストされたコントロールをチェックします。 また、$Context 変数にコンテキスト情報を表示し、CTI 変数に CTI 情報を表示するには、[データ パラメーター] タブをチェックします。

      関連項目

      CTI アダプターを使用して CTI システムと統合する
      UII コンピューター テレフォニー統合 (CTI) フレームワーク

      Unified Service Desk 2.0

      © 2017 Microsoft. All rights reserved. 著作権