チュートリアル 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 アプリケーション タイプのホストされたコントロールを作成します。
Microsoft Dynamics 365 にサインインします。
[設定] > [Unified Service Desk] の順に移動します。
ホストされたコントロールをクリックします。
[新規] をクリックします。
[新しいホストされたコントロール] ページで、次の値を指定します。
フィールド
値
名前
Contoso のヘルプ
表示名
Contoso のヘルプ
USD コンポーネントの種類
標準 Web アプリケーション
複数ページの許可
いいえ
ホストの種類
内部 WPF
アプリケーションはグローバル
チェック済み
表示グループ
MainPanel
.jpeg "標準的 Web アプリケーションのホストされたコントロール")
保存 をクリックします。
ステップ 2: ツールバー コンテナーの種類のホストされたコントロールを作成する
ツールバー コンテナーのホストされたコントロールを使用して、Unified Service Desk のツールバーを保持および表示します。 このセクションでは、クライアント アプリケーションのツールバー領域に表示される、[ツールバー コンテナー] の種類のホストされたコントロールを作成します。
Microsoft Dynamics 365 にサインインします。
[設定] > [Unified Service Desk] の順に移動します。
ホストされたコントロールをクリックします。
[新規] をクリックします。
[新しいホストされたコントロール] ページで、次の値を指定します。
フィールド
値
名前
Contoso 関連ツールバー コンテナー
USD コンポーネントの種類
ツール バー コンテナ
表示グループ
AboutPanel
.jpeg "ツール バー コンテナーのホストされたコントロール")
保存 をクリックします。
ステップ 3: ツールバーを追加し、ツールバー コンテナーに添付する
このステップでは、ツールバーを作成して、手順 2 で作成したツールバー コンテナーのホストされたコントロールにツールバーをアタッチします。 これが行われるのは、エージェント アプリケーションのツール バーを表示するためです。
Microsoft Dynamics 365 にサインインします。
[設定] > [Unified Service Desk] の順に移動します。
ツール バーをクリックします。
[新規] をクリックします。
[新しいツールバー] ページで、[Contoso 関連ツールバー] を [名前] ボックスに入力し、次に [保存] をクリックします。
手順 2 で作成したツールバー コンテナーのホストされたコントロールにツールバーをアタッチします。 ナビゲーション バーで、[Contoso 関連ツールバー] の隣の下矢印をクリックしてから、[ホストされたコントロール] をクリックします。
次のページで、[ホストされた既存のコントロールを追加] をクリックし、検索バーに Contoso About Toolbar Container と入力してから、ENTER キーを押して検索アイコンをクリックします。
検索結果から [Contoso 関連ツールバー コンテナー] を選択します。
保存 をクリックします。
ステップ 4: Web ページを表示するためのツールバー ボタンとアクション コールを追加する
この手順では、ツールバー上にボタンを追加し、そのボタンにアクション コールを追加して、ボタンがクリックされたときに、手順 1 で作成したホストされたコントロールに、指定した Web ページが表示されるようにします。
ステップ 3 でツールバーを保存すると、[ボタン] 領域が使用できるようになります。[ボタン] 領域で、右隅の [+] をクリックしてボタンを追加します。
[新しいツールバー ボタン] ページで、次の値を指定します。
フィールド
値
名前
Contoso 表示ヘルプ
ボタン テキスト
表示ヘルプ
![[新規] ツールバー ボタンの作成](images/dn864929.d43eae12-f42f-4e21-9d5e-d46755ea209d(usd.2).jpeg "[新規] ツールバー ボタンの作成")
[保存] をクリックしてレコードを保存し、[アクション] 領域を有効にします。
手順 1 で作成したホストされたコントロールについて、2 つのアクション コールを追加して、移動先の Web ページの URL を指定します。 また、Contoso グローバル管理者がホストするコントロールにもう 1 つのアクション コールを作成して、手順 1 で作成したホスト コントロールをエージェント アプリケーションに表示します。
[アクション] 領域で、右隅の [+] をクリックして、アクション コールを追加します。
検索ボックスの [アクション] 領域で、ENTER キーを押すか検索アイコンをクリックします。
検索結果ボックスの右下隅で [新規] をクリックし、このツールバー ボタンのためのアクション コールを作成します。
![[新規] を選択してアクション コールを作成](images/dn864929.62e7ea61-1bf4-4cb5-b2a4-fcfda96b78f1(usd.2).jpeg "[新規] を選択してアクション コールを作成")
[新しいアクション コール] ページで、次の値を指定します。
フィールド
値
名前
Contoso アクション コール: ヘルプの表示
受注
1
ホストされたコントロール
Contoso のヘルプ
アクション
移動
データ
url=https://technet.microsoft.com/library/dn499779.aspx
.jpeg "Unified Service Desk でアクション コールを作成")
保存 をクリックします。 新しいアクション コールが [Contoso 表示ヘルプ] ボタンに追加されます。
クライアント アプリケーションで Web ページを表示するホストされたコントロールに、フォーカスを設定するための別のアクション コールをボタンに追加します。[アクション] 領域で、右隅の [+] をクリックして、アクション コールを追加します。
検索結果ボックスの右下隅で [新規] をクリックし、このツールバー ボタンのためのアクション コールを作成します。
[新しいアクション コール] ページで、次の値を指定します。
フィールド
値
名前
Contoso アクション コール: ヘルプ表示のホストされたコントロール
受注
2
ホストされたコントロール
Contoso グローバル マネージャー
アクション
ShowTab
データ
Contoso のヘルプ
.jpeg "Unified Service Desk でアクション コールを作成")
保存 をクリックします。 新しいアクション コールが [Contoso 表示ヘルプ] ボタンに追加されました。 ツールバー ボタンに追加された両方のアクション コールを表示できます。
.jpeg "ツールバー ボタンに追加されたアクション コール")
ステップ 5: 構成にコントロールを追加
この手順では、このチュートリアルで作成した、アクション コール、ホストされたコントロール、およびツールバーを [Contoso 構成] に追加し、構成に対して割り当てられたユーザーがこれらのコントロールを表示できるようにします。[Contoso 構成] は チュートリアル 1: 単純エージェント アプリケーションの構築で作成されました。
以下を [Contoso 構成] に追加します。
コントロール名 |
コントロールの種類 |
|---|---|
Contoso アクション コール: ヘルプの表示 |
アクション コール |
Contoso アクション コール: ヘルプ表示のホストされたコントロール |
アクション コール |
Contoso のヘルプ |
ホストされたコントロール |
Contoso 関連ツールバー コンテナー |
ホストされたコントロール |
Contoso 関連ツールバー |
ツール バー |
コントロールを構成に追加するには以下を実行します。
Microsoft Dynamics 365 にサインインします。
ナビゲーション バーで、Microsoft Dynamics 365 をクリックし、次に [設定] を選択します。
[設定] > [Unified Service Desk] の順に移動します。
構成をクリックします。
[Contoso 構成] をクリックして定義をオープンします。
ナビゲーション バーで、[Contoso 構成] の隣の下矢印をクリックし、[アクション コール] を選択します。
次のページで、[既存のアクション コールを追加] をクリックし、検索バーに Contoso Action Call と入力してから、ENTER キーを押すか、検索アイコンをクリックします。
両方のアクション コールが、検索結果に表示されます。 両方を追加します。
同様に、[Contoso 構成] の隣の下矢印をクリックし、[ホストされたコントロール] および [ツールバー] をそれぞれクリックし、ホストされたコントロールとツールバーの両方を追加します。
保存 をクリックします。
ステップ 6: アプリケーションをテストする
Unified Service Desk クライアント アプリケーションを起動し、チュートリアル 1: 単純エージェント アプリケーションの構築で [Contoso 構成] に割り当てたのと同じユーザー資格情報を使用して、Unified Service Desk を構成した Dynamics 365 インスタンスにサインインします。Unified Service Desk クライアント アプリケーションを使用して Dynamics 365 インスタンスに接続することに関する詳細は、「TechNet: Unified Service Desk クライアントを使用して CRM インスタンスに接続する」を参照してください。
エージェント アプリケーションの右上隅に [表示ヘルプ] ボタンが表示されます。
![Unified Service Desk の [ヘルプ] ボタンを表示する](images/dn864929.9f83b053-5396-4628-8edd-835e6d5d4112(usd.2).jpeg "Unified Service Desk の [ヘルプ] ボタンを表示する")
[表示ヘルプ] をクリックすると Unified Service Desk アプリケーション内に指定した Web URL が表示されます。
.jpeg "クライアント アプリケーションで表示するヘルプ")
まとめ
このチュートリアルでは、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. 著作権