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

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

Unified Service Desk ではデバッガーの種類のホストされたコントロールが用意され、これにより、成功裏にエージェントアプリケーションを構築し、構成内の問題をトラブルシューティングに役立つ、Unified Service Desk 構成に関する主要な情報を得られます。詳細 : Unified Service Desk の問題をデバッグする

このチュートリアルは、エージェントアプリケーションのためのデバッガーのホストされたコントロールを構成する方法を示します。

前提条件

チュートリアル 1: 統一インターフェイスアプリの単純エージェントアプリケーションの構築およびチュートリアル 3: エージェントアプリケーション内の統一インターフェイスアプリのレコードを表示するを完了済みである必要があります。このチュートリアルでは、それらのチュートリアルで完了する構成が必要です。
このチュートリアルは、チュートリアル 1 でエージェントアプリケーションにサインインするために使用したのと同じユーザー資格情報を、チュートリアルの最後にアプリケーションをテストするために使用することを想定しています。別のユーザーがアプリケーションをテストする場合は、そのユーザーを Contoso 構成に割り当てる必要があります。詳細 : チュートリアル 1: 統一インターフェイスアプリの単純エージェントアプリケーションを構築する
Unified Service Desk で以下を参照する必要があります。
- デバッガーのホストされたコントロール。詳細 : デバッガー (ホストされたコントロール)
- アクションコールおよびその構成方法。詳細: アクションコール
- Unified Service Desk 構成を使用したアクセスのフィルター。詳細 : Unified Service Desk 構成を使用したアクセスの管理を参照してください

このチュートリアル内

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

ステップ 2: デバッガーのホストされたコントロールを表示するための、ツールバーボタンとアクションコールを追加する

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

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

まとめ

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

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

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

フィールド	値
名前	Contoso デバッガー
並べ替え順序	3
表示名	Contoso デバッガー
USD コンポーネントの種類	デバッガー
表示グループ	MainPanel

保存を選択します。

ツールバーボタンを Contoso メインツールバー (チュートリアル 3: ユーザーのエージェントアプリケーションに統一インターフェイスアプリのレコードを表示するで作成される) に追加してから、ステップ 1 で作成した Contoso デバッガーのホストされたコントロールを表示するための、ボタン用アクションコールを追加します。

Unified Service Desk 管理者にサインインします。
基本設定でツールバーを選択します。
Contoso メインツールバーを選択します。
ボタン領域で、+ 新しいツールバーボタン をクリックしてツールバーボタンを追加します。

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

フィールド	値
件名	Contoso デバッガーボタン
ボタンテキスト	デバッガー
順序	3 注: 順序フィールドは、ツールバーのボタンの場所を定義します。ボタンは左から右、または上から下に、昇順で配置されます。

保存を選択します。
アクション 領域で、 既存のアクションコールを追加する を選択して、ボタンにアクションコールを作成します。 レコードの検索 ウィンドウが表示されます。
検索アイコンを選択し、+ 新しいアクションコールを選択します。

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

フィールド	値
名前	Contoso アクションコール: デバッガーの表示
受注	1
ホストされたコントロール	Contoso グローバルマネージャー
アクション	CallDoAction
データ	action=default application=Contoso デバッガー

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

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

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

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

コントロール名	コントロールの種類
Contoso アクションコール: デバッガーの表示	アクションコール
Contoso デバッガー	ホストされたコントロール

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

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

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

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

エージェントアプリケーションのツールバー領域に、デバッガーボタンが表示されるようになりました。このボタンを選択すると、デバッガーコントロールが表示されます。

エージェントアプリケーションのデバッガー。