次の方法で共有

チュートリアル 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: セッションに取引先企業レコードを表示するために、セッション スコープのホストされたコントロールを作成する

ステップ 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 取引先企業検索

    アクション

    閉じる​​

    Unified Service Desk でアクション コールを作成

  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 構成] に追加します。

コントロール名

コントロールの種類

Contoso アクション コール: 取引先企業検索の終了

アクション コール

BrowserDocumentComplete

Contoso アカウント セッションのホストされたコントロール用イベント

Contoso 取引先企業セッション

ホストされたコントロール

Contoso セッション タブ

ホストされたコントロール

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

    Unified Service Desk での複数のセッション

まとめ

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

注意

次のチュートリアルを実行し、エージェント アプリケーション チュートリアル 5: セッション名と概要データを表示することにより、拡張セッション情報を表示するの拡張セッション情報を用意します。

関連項目

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

Unified Service Desk 2.0

© 2017 Microsoft. All rights reserved. 著作権