次の方法で共有

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

  • [アーティクル]

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

前提条件

このチュートリアル内

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

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

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

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

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

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

まとめ

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

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

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

  2. 設定>Unified Service Desk に移動します。

  3. ホストされたコントロール を選択します。

  4. 新規 を選択します。

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

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

    セッション スコープのホストされたコントロールの作成。

  6. 保存 を選びます。

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

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

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

    ホストされたコントロールのイベントを設定。

  2. イベント ページで、BrowserDocumentComplete を選択します。

  3. BrowserDocumentComplete ページで、Active Actions 領域の + を選択して、イベントにアクション コールを追加します。

  4. 検索ボックスで検索アイコンを選択するか、Enter キーを押し、検索結果ボックスの右下隅にある新規を選択します。

    イベントへのアクション コールの追加。

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

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

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

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

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

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

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

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

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

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

  3. 拡張機能 XML フィールドで XML を更新します。 詳細については、会話インジケーター XML を参照してください。

  4. 保存を選択します。

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

この手順では、ユーザーが検索結果ウィこの手順では、ユーザーが検索結果ウィンドウでいずれかのアカウントを選択したときにセッションでレコードを表示するウィンドウ ナビゲーション ルールを作成します。

  1. 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. 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 構成に割り当てたのと同じユーザー資格情報を使用して、Unified Service Desk を構成した Dynamics 365 インスタンスにサインインします。 Unified Service Desk クライアント アプリケーションを使用して Dataverse インスタンスに接続する方法に関する詳細は、Unified Service Desk クライアントを使用して CRM インスタンスに接続するを参照してください。

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

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

    セッションに表示されている取引先企業のレコード。

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

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

結論

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

Note

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

関連項目

チュートリアル 1: 単純エージェント アプリケーションの構築

チュートリアル 2: エージェント アプリケーションに外部 Web ページを表示する

チュートリアル 3: ユーザーのエージェント アプリケーションにレコードを表示する

チュートリアル 6: エージェント アプリケーションで、デバッガのホストされたコントロールを構成する

チュートリアル 7: エージェント アプリケーションでエージェントスクリプトを構成する

Unified Service Desk の構成チュートリアル