チュートリアル 4: エージェント アプリケーション内のセッションに Microsoft Dynamics 365 のレコードを表示する

公開日: 2016年11月

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

このチュートリアルは、ウィンドウ ナビゲーション ルールと Microsoft Dynamics 365 のセッション コントロールを使用して、エージェント アプリケーション内のセッションに Unified Service Desk レコードを表示する方法を示します。 また、現在表示されている取引先企業レコードに基づき、置換パラメータを使用して、ホストされたコントロールの名前を動的に表示する方法を示します。 このチュートリアルは、以前の最初のチュートリアル、チュートリアル 3: ユーザーのエージェント アプリケーションに Microsoft Dynamics 365 レコードを表示する に基づき、[取引先企業] 検索結果ウィンドウ内の取引先企業のいずれかをクリックするときに、セッション内の取引先企業レコードを表示します。

前提条件

• チュートリアル 1: 単純エージェント アプリケーションの構築 および チュートリアル 3: ユーザーのエージェント アプリケーションに Microsoft Dynamics 365 レコードを表示するを完了しておく必要があります。 このチュートリアルでは、これらのチュートリアルで完成した構成が必要です。

• このチュートリアルは、チュートリアル 1 でエージェント アプリケーションにサインインするために使用したのと同じユーザー資格情報を、チュートリアルの最後にアプリケーションをテストするために使用することを想定しています。 別のユーザーがアプリケーションをテストする場合は、そのユーザーを [Contoso 構成] に割り当てる必要があります。詳細:チュートリアル 1: 単純エージェント アプリケーションの構築

• Unified Service Desk で以下を参照する必要があります。

  • [セッション タブ] タイプのホストされたコントロールです。詳細:セッション タブ (ホストされたコントロール)

  • アクション コールの構成方法

  • ウィンドウ ナビゲーション ルールの構成方法。詳細:統合サービス デスクでのウィンドウ ナビゲーションの規則の使用

  • Unified Service Desk 構成を使用するフィルター アクセス。詳細:「TechNet: Unified Service Desk コンフィギュレーションを使用したアクセスの管理」を参照してください。

このチュートリアル内

ステップ 1: セッションに取引先企業レコードを表示するために、セッション スコープのホストされたコントロールを作成する

ステップ 2: 検索元からのホストされたコントロールを閉じるようにイベントを構成する

ステップ 3: セッション タブのホストされたコントロールの作成

ステップ 4: セッションの取引先企業レコードを表示するウィンドウ ナビゲーション ルールを作成する

ステップ 5: 構成にコントロールを追加

ステップ 6: アプリケーションをテストする

まとめ

ステップ 1: セッションに取引先企業レコードを表示するために、セッション スコープのホストされたコントロールを作成する

このステップでは、セッションに取引先企業レコードを表示するために、セッション スコープのホストされたコントロールを作成します。

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

2. [設定] > [Unified Service Desk] の順に移動します。

3. ホストされたコントロールをクリックします。

4. [新規] をクリックします。

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

   フィールド	値
   名前	Contoso 取引先企業セッション
   表示名	[[account.name]] 注意 置換パラメーターを使用して、選択した取引先企業の名前を、ホストされたコントロールの表示名として動的に表示します。
   USD コンポーネントの種類	Dynamics 365 ページ
   複数ページの許可	不可
   ホストの種類	内部 WPF
   アプリケーションはグローバル	未確認 注意 これによりホストされたコントロールがセッション スコープ、つまりセッションのみに表示されるようになります。
   表示グループ	MainPanel

   

6. 保存 をクリックします。

ステップ 2: 検索元からのホストされたコントロールを閉じるようにイベントを構成する

この手順では、[Contoso の取引先企業セッション] のホストされたコントロール上の [BrowserDocumentComplete] イベントを構成し、それが読み込まれるとき、ユーザーがクリックしてオープンした取引先企業 [Contoso の取引先企業の検索] の、親のホストされたコントロールが閉じられるようにします。[Contoso の取引先企業の検索] のホストされたコントロールは、チュートリアル 3: ユーザーのエージェント アプリケーションに Microsoft Dynamics 365 レコードを表示するで作成されました。 これにより、ユーザーは同じセッション タブ内の他の取引先企業情報はオープンできなくなります。

1. ナビゲーション バーで、[Contoso の取引先企業セッション] のホストされたコントロールの隣の下向き矢印をクリックし、[イベント] をクリックします。

   

2. イベント ページで、[BrowserDocumentComplete] をクリックします。

3. [BrowserDocumentComplete] ページで、[アクティブなアクション] 領域の [+] をクリックして、イベントにアクション コールを追加します。

4. 検索ボックスで、検索アイコンをクリックまたは ENTER キーを押し、検索結果ボックスの右下隅の [新規] をクリックします。

   

5. [新しいアクション コール] ページで、次の値を指定します。

   フィールド	値
   名前	Contoso アクション コール: 取引先企業検索の終了
   ホストされたコントロール	Contoso 取引先企業検索
   アクション	閉じる​​

   

6. [保存] をクリックし、アクション コールを [BrowserDocumentComplete] イベントに追加します。

ステップ 3: セッション タブのホストされたコントロールの作成

エージェント アプリケーションのセッションにレコードを表示するには、[セッション タブ] の種類のホストされたコントロールをエージェント アプリケーションで構成する必要があります。

1. ホストされたコントロール ページで、[新規] をクリックします。

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

   フィールド	値
   名前	Contoso セッション タブ
   USD コンポーネントの種類	セッション タブ

   

3. 保存 をクリックします。

ステップ 4: セッションの取引先企業レコードを表示するウィンドウ ナビゲーション ルールを作成する

この手順では、ユーザーが検索結果ウィンドウ内の取引先企業のいずれかをクリックするときに、セッションのレコードを表示する、ウィンドウ ナビゲーション ルールを作成します。

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

2. [設定] > [Unified Service Desk] の順に移動します。

3. ウィンドウ ナビゲーション ルールをクリックします。

4. [新規] をクリックします。

5. [新しいウィンドウ ナビゲーション ルール] ページで、次の値を指定します。

   フィールド	値
   名前	Contoso 取引先企業セッション ルール
   受注	5
   差出人	Contoso 取引先企業検索
   エンティティ	取引先企業
   ルーティングの種類	ポップアップ
   バックアップ先	タブ
   アクション	セッションの作成
   対象のタブ	Contoso 取引先企業セッション
   タブの表示	Contoso 取引先企業セッション
   コマンド バーの非表示	いいえ
   ナビゲーション バーの非表示	はい

   

6. 保存 をクリックします。

ステップ 5: 構成にコントロールを追加

このステップでは、このチュートリアルで構成した、アクション コール、ホストされたコントロール、およびウィンドウ ナビゲーション ルールを [Contoso 構成] に追加し、構成に対して割り当てられたユーザーがこれらのコントロールを表示できるようにします。[Contoso 構成] は チュートリアル 1: 単純エージェント アプリケーションの構築で作成されました。

以下を [Contoso 構成] に追加します。

コントロールを構成に追加するには以下を実行します。

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

2. [設定] > [Unified Service Desk] の順に移動します。

3. 構成をクリックします。

4. [Contoso 構成] をクリックして定義をオープンします。

5. ナビゲーション バーで、[Contoso 構成] の隣の下矢印をクリックし、[アクション コール] を選択します。

6. 次のページで、[既存のアクション コールを追加] をクリックし、検索バーに Contoso Action Call: Close Accounts Search と入力してから、ENTER キーを押すか、検索アイコンをクリックします。

7. 検索結果ボックスで、アクション コールをクリックし、それを [Contoso 構成] に追加します。

8. 同様に、[Contoso 構成] の隣の下向き矢印をクリックし、[イベント]、[ホストされたコントロール] および [ウィンドウ ナビゲーション ルール] をそれぞれクリックし、イベント、ホストされたコントロール、およびウィンドウ ナビゲーション ルールを追加します。

9. 保存 をクリックします。

ステップ 6: アプリケーションをテストする

1. Unified Service Desk クライアント アプリケーションを起動し、チュートリアル 1: 単純エージェント アプリケーションの構築 で [Contoso 構成] に割り当てたのと同じユーザー資格情報を使用して統合サービス デスクを構成した、Dynamics 365 インスタンスにサインインします。Unified Service Desk クライアント アプリケーションを使用して Dynamics 365 インスタンスに接続することに関する詳細は、「TechNet: Unified Service Desk クライアントを使用して CRM インスタンスに接続する」を参照してください。

2. Dynamics 365 インスタンスから取引先企業レコードを表示するには、ツールバーの [検索] ボタンの隣の下向き矢印をクリックし、[取引先企業] をクリックします。

3. 取引先企業レコードのいずれかをクリックして、セッションに目的の取引先企業を表示します。上方はセッション タブの下に表示されます。 取引先企業レコードを含むホストされたコントロールのタブ名に、取引先企業名が自動的に表示されることに注意してください。これは、静的値の代わりに現在の取引先企業名を動的に表示する、置換パラメーターを事前に使用していたからです。

   

4. 別の取引先企業レコードを開く場合、クライアント アプリケーションの他のセッションに表示されます。 別の取引先企業を開くには、[検索] ボタンの隣の下矢印をクリックし、[取引先企業] をクリックし、次にアカウント名をクリックして、別のセッションに取引先企業情報を表示します。

   

まとめ

このチュートリアルでは、セッションのホストされたコントロールおよびウィンドウ ナビゲーション ルールを使用して、エージェント アプリケーションのセッションに Dynamics 365 レコードを表示する方法を学習しました。 また、構成を使用して Unified Service Desk コントロールに対するアクセスをフィルター処理する方法も学習しました。

関連項目

チュートリアル 1: 単純エージェント アプリケーションの構築
チュートリアル 2: エージェント アプリケーションに外部 Web ページを表示する
チュートリアル 3: ユーザーのエージェント アプリケーションに Microsoft Dynamics 365 レコードを表示する
チュートリアル 6: エージェント アプリケーションで、デバッガのホストされたコントロールを構成する
チュートリアル 7: エージェント アプリケーションでエージェントスクリプトを構成する
統合サービス デスクの構成チュートリアル

Unified Service Desk 2.0

© 2017 Microsoft. All rights reserved. 著作権