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

公開日: 2016年11月

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

このチュートリアルでは、エージェント アプリケーションに Web ページまたは外部 URL を表示する方法を示します。 このチュートリアルでは、Unified Service Desk 管理ガイドを表示する方法を学習します。これはクライアント アプリケーションの https://technet.microsoft.com/library/dn499779.aspx でオンラインで利用できます。

前提条件

• チュートリアル 1: 単純エージェント アプリケーションの構築 を完了しておく必要があります。 このチュートリアルでは、最初のチュートリアルで完成した構成が必要です。

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

• Unified Service Desk の以下の概念を理解しておく必要があります。

  • これらの二つの種類のホストされたコントロールは、標準的な Web アプリケーションとツールバー コンテナーです。詳細:ホストされたコントロールの種類とアクション/イベント リファレンス

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

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

このチュートリアル内

ステップ 1: Web ページを表示するためのホストされたコントロールを作成する

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

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

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

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

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

まとめ

ステップ 1: Web ページを表示するためのホストされたコントロールを作成する

この手順では、Web ページを表示するための、標準的な Web アプリケーション タイプのホストされたコントロールを作成します。

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

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

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

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

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

   フィールド	値
   名前	Contoso のヘルプ
   表示名	Contoso のヘルプ
   USD コンポーネントの種類	標準 Web アプリケーション
   複数ページの許可	いいえ
   ホストの種類	内部 WPF
   アプリケーションはグローバル	チェック済み
   表示グループ	MainPanel

   

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

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

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

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

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

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

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

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

   フィールド	値
   名前	Contoso 関連ツールバー コンテナー
   USD コンポーネントの種類	ツール バー コンテナ
   表示グループ	AboutPanel

   

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

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

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

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

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

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

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

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

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

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

8. 検索結果から [Contoso 関連ツールバー コンテナー] を選択します。

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

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

この手順では、ツールバー上にボタンを追加し、そのボタンにアクション コールを追加して、ボタンがクリックされたときに、手順 1 で作成したホストされたコントロールに、指定した Web ページが表示されるようにします。

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

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

   フィールド	値
   名前	Contoso 表示ヘルプ
   ボタン テキスト	表示ヘルプ

   

3. [保存] をクリックしてレコードを保存し、[アクション] 領域を有効にします。

4. 手順 1 で作成したホストされたコントロールについて、2 つのアクション コールを追加して、移動先の Web ページの URL を指定します。 また、Contoso グローバル管理者がホストするコントロールにもう 1 つのアクション コールを作成して、手順 1 で作成したホスト コントロールをエージェント アプリケーションに表示します。

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

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

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

   

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

   フィールド	値
   名前	Contoso アクション コール: ヘルプの表示
   受注	1
   ホストされたコントロール	Contoso のヘルプ
   アクション	移動
   データ	url=https://technet.microsoft.com/library/dn499779.aspx

   

8. 保存 をクリックします。 新しいアクション コールが [Contoso 表示ヘルプ] ボタンに追加されます。

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

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

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

    フィールド	値
    名前	Contoso アクション コール: ヘルプ表示のホストされたコントロール
    受注	2
    ホストされたコントロール	Contoso グローバル マネージャー
    アクション	ShowTab
    データ	Contoso のヘルプ

    

12. 保存 をクリックします。 新しいアクション コールが [Contoso 表示ヘルプ] ボタンに追加されました。 ツールバー ボタンに追加された両方のアクション コールを表示できます。

    

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

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

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

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

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

2. ナビゲーション バーで、Microsoft Dynamics 365 をクリックし、次に [設定] を選択します。

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

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

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

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

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

8. 両方のアクション コールが、検索結果に表示されます。 両方を追加します。

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

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

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

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

エージェント アプリケーションの右上隅に [表示ヘルプ] ボタンが表示されます。

[表示ヘルプ] をクリックすると Unified Service Desk アプリケーション内に指定した Web URL が表示されます。

まとめ

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

関連項目

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

Unified Service Desk 2.0

© 2017 Microsoft. All rights reserved. 著作権