次の方法で共有

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

  • [アーティクル]

 

公開日: 2016年11月

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

このチュートリアルでは、エージェント アプリケーションに Microsoft Dynamics 365 レコードを表示する方法を示します。 このチュートリアルでは、Dynamics 365 インスタンス内のすべての取引先企業および取引先担当者レコードを表示します。 また、エージェント アプリケーションで取引先企業および取引先担当者を表示するための、ドロップダウン メニュー付きの検索ボタンを作成します。

前提条件

このチュートリアル内

ステップ 1: 取引先企業および取引先企業レコードを表示する、Dynamics 365 ページの種類のホストされたコントロールを作成する

ステップ 2: ツールバー コンテナーの種類のホストされたコントロールを作成する

ステップ 3: ツールバーを追加し、ツールバー コンテナーに添付する

ステップ 4: Dynamics 365 レコードを表示するためのツールバー ボタンとアクション コールを追加する

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

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

まとめ

ステップ 1: 取引先企業および取引先企業レコードを表示する、Dynamics 365 ページの種類のホストされたコントロールを作成する

このステップでは、取引先企業および取引先担当者レコードを表示する、2 種類の Dynamics 365 ページ の種類のホストされたコントロールを作成します。

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

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

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

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

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

    フィールド

    値

    名前

    Contoso 取引先企業検索

    [表示名]

    Contoso: 取引先企業

    USD コンポーネントの種類

    Dynamics 365 ページ

    複数ページの許可

    不可

    ホストの種類

    内部 WPF

    アプリケーションはグローバル

    チェック済み

    表示グループ

    MainPanel

    アカウントを表示するホストされたコントロールを作成

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

  7. 取引先担当者レコードを表示する、別のホストされたコントロールを作成するため、[新規] をクリックします。

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

    フィールド

    値

    名前

    Contoso の取引先担当者検索

    [表示名]

    Contoso: 取引先担当者

    USD コンポーネントの種類

    Dynamics 365 ページ

    複数ページの許可

    不可

    ホストの種類

    内部 WPF

    アプリケーションはグローバル

    チェック済み

    表示グループ

    MainPanel

    取引先担当者を表示するホストされたコントロールを作成

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

ステップ 2: ツールバー コンテナーの種類のホストされたコントロールを作成する

ツールバー コンテナーの種類のホストされたコントロールを使用して、Unified Service Desk のツールバーを保持および表示します。 このセクションでは、クライアント アプリケーションの上部に表示される、[ツールバー コンテナー] のホストされたコントロールを作成します。

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

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

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

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

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

    フィールド

    値

    名前

    Contoso メイン ツールバー コンテナー

    USD コンポーネントの種類

    ツール バー コンテナ

    表示グループ

    ToolbarPanel

    ツール バー コンテナーのホストされたコントロール

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

ステップ 3: ツールバーを追加し、ツールバー コンテナーに添付する

このステップでは、ツールバーを作成して、手順 2 で作成したツールバー コンテナーのホストされたコントロールにツールバーをアタッチします。 これが行われるのは、エージェント アプリケーションのツール バーを表示するためです。

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

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

  3. ツール バーをクリックします。

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

  5. [新しいツールバー] ページで、[Contoso メイン ツールバー] を [名前] ボックスに入力し、次に [保存] をクリックします。

  6. 手順 2 で作成したツールバー コンテナーのホストされたコントロールにツールバーをアタッチします。 ナビゲーション バーで、[Contoso メイン ツールバー] の隣の下矢印をクリックしてから、[ホストされたコントロール] をクリックします。

  7. 次のページで、[ホストされた既存のコントロールを追加] をクリックし、検索バーに Contoso Main Toolbar Container と入力してから、ENTER キーを押して検索アイコンをクリックします。

  8. 検索結果から 追加する [Contoso メイン ツールバー コンテナー] を選択します。

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

ステップ 4: Dynamics 365 レコードを表示するためのツールバー ボタンとアクション コールを追加する

このステップでは、ツールバー上にボタンを追加し、そのボタンにアクション コールをアタッチして、ボタンがクリックされたときに、手順 1 で作成したホストされたコントロールに、適切な Dynamics 365 レコードが表示されるようにします。 ボタンをクリックすると、取引先企業および取引先担当者サブメニュー項目を表示し、ボタンをクリックすると、それぞれのDynamics 365レコードが表示されるように検索ボタンを構成します。

  1. ステップ 3 でツールバーを保存すると、[ボタン] 領域が使用できるようになります。[ボタン] 領域で、右隅の [+] をクリックしてボタンを追加します。

  2. [新しいツールバー ボタン] ページで、次の値を指定します。

    フィールド

    値

    名前

    Contoso 検索ボタン

    ボタン テキスト

    検索

    ツールヒント

    Dynamics 365 の取引先担当者と取引先企業を検索する

    受注

    1

    検索ツールバー ボタンの作成

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

  4. ナビゲーション バーで、Contoso 検索ボタンの隣の下矢印をクリックし、ツールバー ボタンをクリックします。

    注意

    既存のツール バー ボタンに子のツールバー ボタンを追加し、サブメニュー構造を作成します。

  5. 次のページで、[新規 ツールバー ボタンの追加] をクリックします。

  6. [新しいツールバー ボタン] ページで、次の値を指定します。

    フィールド

    値

    名前

    Contoso 取引先企業検索ボタン

    ボタン テキスト

    取引先​​企業

    受注

    1

    注意

    [受注] フィールドは、ツールバーのボタンの場所を定義します。 ボタンは左から右、または上から下に、昇順で配置されます。
    ![取引先企業のサブメニューのツール バー ボタンを作成](images/Dn864889.64761667-8edc-4748-8262-d06ef14ec5b2(USD.2).jpeg "取引先企業のサブメニューのツール バー ボタンを作成")

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

    2. ここで、2 つのアクション コールを追加します。まず、ステップ 1 で作成したホストされたコントロールに取引先企業レコードを表示するもの、2 番目に、Contoso グローバル マネージャーのホストされたコントロール上で、取引先企業のホストされたコントロールを表示するものです。

      [アクション] 領域で、右隅の [+] をクリックして、アクション コールを追加します。

    3. 検索ボックスの [アクション] 領域で、ENTER キーを押すか検索アイコンをクリックします。

    4. 検索結果ボックスの右下隅で [新規] をクリックし、このツールバー ボタンのためのアクション コールを作成します。

      [新規] を選択してアクション コールを作成

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

      フィールド

      値

      名前

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

      受注

      1

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

      Contoso 取引先企業検索

      アクション

      検索

      データ

      取引先企業

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

    6. 保存 をクリックします。 新しいアクション コールが [Contoso 取引先企業検索ボタン] ボタンに追加されました。

    7. クライアント アプリケーションで取引先企業レコードを表示するホストされたコントロールに、フォーカスを設定するための別のアクション コールをボタンに追加します。[アクション] 領域で、右隅の [+] をクリックして、アクション コールを追加します。

    8. 検索結果ボックスの右下隅で [新規] をクリックし、このツールバー ボタンのためのアクション コールを作成します。

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

      フィールド

      値

      名前

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

      受注

      2

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

      Contoso グローバル マネージャー

      アクション

      ShowTab

      データ

      Contoso 取引先企業検索

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

    10. 保存 をクリックします。 新しいアクション コールが [Contoso 取引先企業検索ボタン] ボタンに追加されました。

    11. [Contoso 検索ボタン] ツールバー ボタンに移動し、取引先担当者の検索および表示のための子のボタンを追加します。 ナビゲーション バーで、[Contoso 検索ボタン] の隣の下矢印をクリックし、[ツールバー ボタン] を選択します。

    12. 次のページで、[新規 ツールバー ボタンの追加] をクリックします。

    13. [新しいツールバー ボタン] ページで、次の値を指定します。

      フィールド

      値

      名前

      Contoso 取引先担当者検索ボタン

      ボタン テキスト

      取引先​​担当者

      受注

      2

      注意

      [受注] フィールドは、ツールバーのボタンの場所を定義します。 ボタンは左から右、または上から下に、昇順で配置されます。
      ![取引先担当者の検索ツールバー ボタンを作成](images/Dn864889.39889e52-83d4-4d2e-8f2e-790ded9a9d54(USD.2).jpeg "取引先担当者の検索ツールバー ボタンを作成")

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

      2. ここで、2 つのアクション コールを追加します。まず、ステップ 1 で作成したホストされたコントロールに取引先担当者レコードを表示するもの、2 番目に、Contoso グローバル マネージャーのホストされたコントロール上で、取引先担当者のホストされたコントロールを表示するものです。

        [アクション] 領域で、右隅の [+] をクリックして、アクション コールを追加します。

      3. 検索ボックスの [アクション] 領域で、ENTER キーを押すか検索アイコンをクリックします。

      4. 検索結果ボックスの右下隅で [新規] をクリックし、このツールバー ボタンのためのアクション コールを作成します。

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

        フィールド

        値

        名前

        Contoso アクション コール: 取引先担当者検索

        受注

        1

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

        Contoso の取引先担当者検索

        アクション

        検索

        データ

        取引先担当者

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

      6. 保存 をクリックします。 新しいアクション コールが [Contoso 取引先担当者検索ボタン] ツールバーボタンに追加されました。

      7. クライアント アプリケーションで、取引先担当者レコードを表示するホストされたコントロールにフォーカスを設定するための、別のアクション コールをボタンに追加します。[アクション] 領域で、右隅の [+] をクリックして、アクション コールを追加します。

      8. 検索結果ボックスの右下隅で [新規] をクリックし、このツールバー ボタンのためのアクション コールを作成します。

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

        フィールド

        値

        名前

        Contoso アクション コール: 取引先担当者検索の表示

        受注

        2

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

        Contoso グローバル マネージャー

        アクション

        ShowTab

        データ

        Contoso の取引先担当者検索

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

      10. 保存 をクリックします。 新しいアクション コールが [Contoso 取引先担当者検索ボタン] ツールバーボタンに追加されました。

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

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

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

      コントロール名

      コントロールの種類

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

      アクション コール

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

      アクション コール

      Contoso アクション コール: 取引先担当者検索

      アクション コール

      Contoso アクション コール: 取引先担当者検索の表示

      アクション コール

      Contoso 取引先企業検索

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

      Contoso の取引先担当者検索

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

      Contoso メイン ツールバー コンテナー

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

      Contoso メイン ツールバー

      ツール バー

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

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

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

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

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

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

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

      7. 以前一覧表示されていたアクション コールが検索結果に表示されます。 これらのアクション コールを追加します。

      8. 同様に、[Contoso 構成] の隣の下矢印をクリックし、[ホストされたコントロール] および [ツールバー] をそれぞれクリックし、ホストされたコントロールとツールバーを追加します。

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

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

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

      エージェントのアプリケーションのツールバー領域に、[検索] ボタンと、下向き矢印をクリックすると表示される 2 つの子のボタン ([取引先企業] と [取引先担当者]) が加わりました。

      取引先企業および取引先企業レコードの表示

      [検索] ボタンの下の [取引先企業] または [取引先担当者] をクリックし、Unified Service Desk クライアント アプリケーション内の別々のタブに、Dynamics 365 インスタンスからのそれぞれのレコードを表示します。

      Dynamics 365 で表示される取引先担当者レコード

      まとめ

      このチュートリアルでは、Unified Service Desk クライアント アプリケーション内に、Dynamics 365 レコードを表示する方法を学習しました。 また、構成を使用して Unified Service Desk コントロールに対するアクセスをフィルター処理する方法も学習しました。

      関連項目

      チュートリアル 1: 単純エージェント アプリケーションの構築
      チュートリアル 2: エージェント アプリケーションに外部 Web ページを表示する
      チュートリアル 4: エージェント アプリケーション内のセッションに Microsoft Dynamics 365 のレコードを表示する
      チュートリアル 5: セッション名と概要データを表示することにより、拡張セッション情報を表示する
      チュートリアル 6: エージェント アプリケーションで、デバッガのホストされたコントロールを構成する
      チュートリアル 7: エージェント アプリケーションでエージェントスクリプトを構成する
      統合サービス デスクの構成チュートリアル

      Unified Service Desk 2.0

      © 2017 Microsoft. All rights reserved. 著作権