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

[アーティクル]
04/19/2023

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: デバッガーの種類のホストされたコントロールを作成する

Dynamics 365 インスタンスにサインインします。
設定>Unified Service Desk に移動します。
ホストされたコントロールをクリックします。
新規を選択します。

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

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

デバッガーにホストされたコントロールの作成。

保存をクリックします。

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

Dynamics 365 インスタンスにサインインします。
設定>Unified Service Desk に移動します。
ツールバーをクリックします。
Contoso メインツールバーをクリックします。
ボタン領域で、+ をクリックしてツールバーボタンを追加します。

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

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

保存をクリックします。
アクション領域で、+ をクリックしてボタンのためにアクションコールを作成します。
検索ボックスで、ENTER キーを押すか検索アイコンをクリックしてから、検索結果ウィンドウの右下隅の新規をクリックして、アクションコールを作成します。

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

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

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

保存をクリックします。

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

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

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

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

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

Dynamics 365 インスタンスにサインインします。
設定>Unified Service Desk に移動します。
構成をクリックします。
Contoso 構成をクリックして定義をオープンします。
ナビゲーションバーで、Contoso 構成の隣の下矢印をクリックし、アクションコールを選択します。
次のページで、既存のアクションコールを追加をクリックし、検索バーに Contoso Action Call: Show Debugger と入力してから、ENTER キーを押すか、検索アイコンをクリックします。
検索結果で、追加するアクションコール名をクリックします。
同様に、Contoso 構成の隣の下矢印をクリックし、ホストされたコントロールをクリックして、ホストされたコントロールを追加します。
保存をクリックします。

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

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

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

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