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

[アーティクル]
06/27/2024

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

前提条件

ユーザーは、チュートリアル 1: 統一インターフェイスアプリの単純エージェントアプリケーションを構築するを完了する必要があります。このチュートリアルでは、最初のチュートリアルで完成した構成が必要です。
このチュートリアルは、チュートリアル 1 の最後にエージェントアプリケーションにサインインするために使用したのと、同じユーザー資格情報を使用することを想定しています。別のユーザーがアプリケーションをテストする場合は、そのユーザーを Contoso 構成に割り当てる必要があります。詳細 : チュートリアル 1: 統一インターフェイスアプリの単純エージェントアプリケーションを構築する
Unified Service Desk で以下の概念を理解しておく必要があります。
- これらの二つの種類のホストされたコントロールは、標準的な Web アプリケーションとツールバーコンテナーです。詳細 : ホストされたコントロールの種類とアクション/イベントリファレンス
- アクションコールの構成方法
- Unified Service Desk 構成を使用したアクセスのフィルター。詳細 : Unified Service Desk 構成を使用したアクセスの管理を参照してください

このチュートリアル内

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

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

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

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

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

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

まとめ

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

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

Unified Service Desk 管理者にサインインします。
基本設定で、ホストされたコントロールを選択します。
+ 新規を選択します。

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

フィールド	値
名前	Contoso のヘルプ
[表示名]	Contoso のヘルプ
Unified Service Desk コンポーネントの種類	標準 Web アプリケーション
複数ページの許可	なし
ホストの種類	Chrome プロセス
アプリケーションはグローバル	チェック済み
表示グループ	MainPanel

保存を選択します。

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

Unified Service Desk 管理者にサインインします。
基本設定で、ホストされたコントロールを選択します。
+ 新規を選択します。
新しいホストされたコントロールページで、次の値を指定します。

フィールド値

名前 Contoso 関連ツールバーコンテナー

Unified Service Desk コンポーネントの種類ツールバーコンテナ

表示グループ AboutPanel
保存を選択します。

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

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

Unified Service Desk 管理者にサインインします。
基本設定でツールバーを選択します。
+ 新規を選択します。
新しいツールバーページで、Contoso 関連ツールバーを名前ボックスに入力し、次に保存を選択します。
手順 2 で作成したツールバーコンテナーのホストされたコントロールにツールバーをアタッチします。関連タブを選択してから、ホストされたコントロールを選択します。
ホストされた既存のコントロールを追加を選択します。 レコードの検索 ウィンドウが表示されます。
検索バーで [Contoso About Toolbar Container] と入力します。リストのレコードを選択し、追加を選択します。
保存を選択します。

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

手順 3 でツールバーを保存した後、全般タブを選択します。
ボタン領域の + 新しいツールバーボタンを選択します。
新しいツールバーボタンページで、次の値を指定します。

フィールド値

名前 Contoso 表示ヘルプ

ボタンテキスト表示ヘルプ
保存する場合は保存を選択します。保存した後、アクション領域が有効になっています。
手順 1 で作成したホストされたコントロールについて、2 つのアクションコールを追加して、移動先の Web ページの URL を指定します。また、Contoso グローバル管理者がホストするコントロールにもう 1 つのアクションコールを作成して、手順 1 で作成したホストコントロールをエージェントアプリケーションに表示します。 アクション エリアで既存のアクションコールの追加を選択します。 レコードの検索 ウィンドウが表示されます。
アクション エリアの検索ボックスで検索アイコンを選択し、+ 新しいアクションコールを選択します。

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

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

フィールド	値
名前	Contoso アクションコール: ヘルプの表示
受注	1
ホストされたコントロール	Contoso のヘルプ
目的	Navigate
データ	url=https://learn.microsoft.com/dynamics365/unified-service-desk/unified-service-desk?view=dynamics-usd-4.1

保存を選択します。
ブラウザの [戻る] ボタンを選択して、Contoso ヘルプボタンに戻ります。
アクション エリアで既存のアクションコールの追加を選択します。 レコードの検索 ウィンドウが表示されます。
検索ボックスで、以前に作成したアクションの名前を入力します。リストのレコードを選択し、追加を選択します。

手順 5 と 6 を繰り返して、次の詳細を含む別のアクション呼び出しを作成します。

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

手順 8 〜 11 を繰り返します。
保存を選択します。新しいアクションコールが Contoso 表示ヘルプボタンに追加されました。ツールバーボタンに追加された両方のアクションコールを表示できます。

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

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

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

コントロール名	コントロールの種類
Contoso アクションコール: ヘルプの表示	アクションコール
Contoso アクションコール: ヘルプ表示のホストされたコントロール	アクションコール
Contoso のヘルプ	ホストされたコントロール
Contoso 関連ツールバーコンテナー	ホストされたコントロール
Contoso 関連ツールバー	ツールバー

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

Unified Service Desk 管理者にサインインします。
詳細設定で、構成を選択します。
Contoso 構成を選択して定義をオープンします。
ホストされたコントロール、イベント、アクションコール タブを選択します。
操作の呼び出しセクションで、省略記号 (...) を選択し、既存の操作の呼び出しを追加を選択します。 レコードの検索 ウィンドウが表示されます。
検索ボックスに、Contoso アクションコールと入力します。両方のアクションコールが、検索結果に表示されます。リストのレコードを選択し、追加を選択します。
ホストされたコントロール セクションで、省略記号 (...) を選択し、既存のホストされたコントロールを追加を選択します。 レコードの検索 ウィンドウが表示されます。
検索ボックスにContosoと入力します。ホストされたコントロールが両方とも検索結果に表示されます。リストのレコードを選択し、追加を選択します。
関連タブを選択してから、ツールバーを選択します。
既存のツールバーを追加を選択します。 レコードの検索 ウィンドウが表示されます。
Contoso ツールバーと検索ボックスに入力します。リストのレコードを選択し、追加を選択します。
保存を選択します。

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

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

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

Unified Service Desk の [ヘルプ] ボタンを表示する。