CRM ページ (ホストされたコントロール)
CRM ページ のホストされたコントロールの種類を使用して、モデル駆動型アプリから URL またはページを読み込みます。 モデル駆動型アプリのページがこの種類のホストされたコントロールに読み込まれると、エンティティからのデータのページが自動的にスキャンされ、置換パラメーターが自動的に入力されます。
このホストされたコントロールタイプは、リスト操作アクションやクイック検索や高度な検索ページを表示する検索アクションなど、ウィンドウの処理に固有の定義済みの UII アクションや多くのイベントを利用できます。
CRM ページのホストされたコントロールを作成する
新しいホストされたコントロールを作成している間、新規ホストされたコントロール 画面のフィールドは、作成するホストコントロールのタイプによって異なります。 このセクションは、CRM ページのホストされたコントロールの種類に固有の特定のフィールドに関する情報を提供します。 詳細情報 : ホストされたコントロールの作成または編集
新規ホストされたコントロール画面で以下を実行します。
Unified Service Desk の領域で、CRM ページを Unified Service Desk コンポーネントの種類ドロップダウン リストから選択します。
データの事前取得を選択して、エンティティ レコードの関連情報をエンティティ レコード ページと一緒にコンテクストに読み込むことができます。 取得されたエンティティ情報は Unified Service Desk コンテキストに入力されるため、これにより、ホストされたコントロールがクライアント アプリケーションに関連するエンティティ情報を迅速に表示できるようになります。 これにより、エージェントが迅速な対応をしたり、顧客との話し合いを開始したりすることができ、重要な対話の時間を節約することができます。
複数ページを許可するドロップダウン リストから、いいえ (既定) を選択して現在表示されているモデル駆動型アプリのページを置き換え、Unified Service Desk がナビゲーション アクション コールを受信するか、またはページがタブにルーティングされると、ブラウザーの履歴を更新します。はいを選択して、2 番目の URL が呼び出されるか、ウィンドウ ナビゲーション ルールによりページがタブ移動する際に、ドロップ ダウン リストを自動的に作成します。これにより、ユーザーはこのコントロールに関連付けられているモデル駆動型アプリのページ間をすばやく検索できます。 また、はいを選択した場合、追加のフィールド最大ブラウザーが、ドロップダウン リストに表示されるページの最大数を指定できるようになります。
ホストの種類ドロップ ダウン リストは、このコントロールをホストする方法を指定します。 Chrome プロセスを有効にします。 詳細情報 : ホストされたコントロールのホスティング方法を選択する
共通プロパティ領域で、グローバルなアプリケーション チェック ボックスをオンにし、ホストされたコントロールをグローバルとして設定します。 グローバルなホストされたコントロールは、顧客のセッションの外部で表示できます。 エージェントのダッシュ ボード、ウォールや検索などのコントロールは、グローバルなホストされたコントロールの一般的な用途です。 グローバルなホストされたコントロールは、セッション固有の状態を持たないため、セッションを変更しても、同じグローバルなホストされたコントロールは残ります。 チェック ボックスが選択されていない場合は、ホストされたコントロールがセッション ベースになります。 セッション ベースのコントロールは、ユーザー セッションのコンテキストに存在します。 ユーザーが別のセッションに変更した場合、前のセッションのページはすべて非表示になります。
表示グループフィールドに、ホストされたコントロールが表示されるパネルが表示されます。 MainPanel は、このホストされたコントロールの種類で最も一般的です。 詳細情報 : Unified Service Desk のパネル、パネル タイプおよびパネル レイアウト
その他の概要フィールドについては、ホストされたコントロールの作成または編集を参照してください。
事前定義 UII アクション
以下は、このホストされたコントロール タイプの定義済みアクションです。
AssociatedView
このアクションはモデル駆動型アプリの関連付けられた特定のビューを読み込みます。 これらのビューは、通常、ナビゲーション バーのエンティティ レコード名の横にある下向き矢印を展開し、関連付けられたエンティティを選択して関連付けます。
| パラメーター | 説明 |
|---|---|
| navItemName | 表示する関連付けられたエンティティ。 例: サポート案件 |
| ID | 関連付けられたエンティティ レコードを表示する、メイン エンティティ レコードの ID。 |
| tabset | モデル駆動型アプリの領域。 例: areaSales または areaService。 |
詳細情報 : 「チュートリアル 7 : エージェント アプリケーションでエージェント スクリプトを構成する」のステップ 5 を参照
閉じる
この操作は、ホストされたコントロールを閉じるために使用します。 CloseActive アクションとは違い、このタブ (ホストされたコントロール) が複数のページを表示している場合、エージェント アプリケーション内のタブに表示されているすべてのページを閉じます。
CloseActive
このホストされたコントロール内のアクティブなウィンドウを閉じるには、このアクションが使用されます。 アクティブなウィンドウがホストされたコントロールに表示される唯一のウィンドウの場合、ホストされたコントロール自体が閉じられます。 CRM ページの種類のホストされたコントロールでは、複数ページに対応しておらず (複数ページの許可 = いいえ)、このアクションは閉じるアクションに相当します。
CloseAndPrompt
このアクションによりホストされたコントロールが閉じられますが、ユーザーには閉じる前に変更を保存するか放棄するよう促します。
DisableToolbarButton
このアクションは、エージェント アプリケーションのツール バーの指定したボタンを無効にします。
| パラメーター | 内容 |
|---|---|
| 説明を参照する | 無効にするツールバー ボタンの名前です。 |
EnableToolbarButton
このアクションは、エージェント アプリケーションのツール バーの指定したボタンを有効にします。
| パラメーター | 内容 |
|---|---|
| 説明を参照する | 有効にするツールバー ボタンの名前です。 |
検索
指定されたエンティティの簡易検索リスト ビューに移動します。
| パラメーター | 内容 |
|---|---|
| 説明を参照する | データ パラメーターには、表示する簡易検索リスト ビューのエンティティの論理名を指定します。 いくつかの特殊なサポート案件の値もあります。 - サポート案件またはインシデントを使用して、サポート案件のための簡易検索一覧ビューを表示します。 - advfind を使用して高度な検索ビューを表示します。 - 活動(複数)または活動(単数)を使用して、活動に使用する簡易検索一覧ビューを表示します。 |
FireEvent
このホストされたコントロールからユーザー定義イベントを発生させます。
| パラメーター | 内容 |
|---|---|
| 名前 | ユーザー定義イベントの名前です。 |
後続のすべての名前/値の組み合わせがイベントのパラメーターとなります。 詳細情報 : ユーザー定義イベントの作成
GetSelectedIds
このアクションは、リストから選択した ID を取得するために使用します。
| パラメーター | 内容 |
|---|---|
| 説明を参照する | データ パラメーターには、選択した ID を取得するリスト名を指定する必要があります。 |
戻り値には、選択した項目を格納している ID のセミコロンで区切った一覧が含まれます。
GetSelectedCount
このアクションは、選択されている項目の数を取得します。 エンティティの実際の ID 一覧を取得するには、GetSelectedIds アクションを使用します。
| パラメーター | 内容 |
|---|---|
| 説明を参照する | データ パラメーターには、選択した ID を取得するためのリスト名を指定する必要があります。 |
戻り値には、選択した品目の数量を表す数値が含まれます。
GoHome
この操作は、ブラウザー インスタンスで指定された初期 URL に移動します。
GoBack
この操作は、ブラウザー インスタンスの [戻る] ボタンを選択することと同じです。
GoForward
この操作は、ブラウザー インスタンスの [進む] ボタンを選択することと同じです。
LoadArea
このアクションはモデル駆動型アプリから特定の領域を読み込みます。 これは、ナビゲーション ウィンドウ内の領域を選択することに相当します (Sales、Service、Marketing など)。 パラメータは選択する領域の名前のみです (例 : areaService)。
| パラメーター | 内容 |
|---|---|
| フレーム | 影響するフレームの名前。 名前を指定しない場合、アクションがページ上で最初に見つかったフレームを自動的にターゲットとします。 |
LookupInfo
Microsoft Dataverse 参照情報ダイアログ ボックスが表示されるため、リストからエンティティを選択できます。
| パラメーター | 内容 |
|---|---|
| AllowFilterOff | 0または1で、フィルター処理が無効になります |
| DefaultType | デフォルトの表示の論理名です。 これは、objecttypes パラメーターで指定した数値のいずれかである必要があります。 |
| DefaultViewId | 0 または 1 で、既定のビューを表示します |
| DisableQuickFind | 0 または 1 で、簡易検索フィールドを表示します |
| DisableViewPicker | 0 または 1で、ビュー セレクターを表示します |
| LookupStyle | 1 つまたは複数 |
| ShowNewButton | 0 または 1で、 新規ボタンを表示します |
| ShowPropButton | 0 または 1で、 プロパティボタンを表示します |
| 参照 | 0 または 1で、ブラウズ モードを使用するかどうかを指定します |
| Currentid | 現在の値の GUID |
| objecttypes | 表示するオブジェクトの種類の一覧です。 例 : 1,2でアカウントや連絡先を表示します。 |
MoveToPanel
この操作により、実行時に CRM ページのホストされたコントロールが別のパネルに移動します。
| パラメーター | 内容 |
|---|---|
| 説明を参照する | データ パラメーターは、ホストされたコントロールを移動するために対象のパネルの名前を指定する必要があります。 例: FloatingPanel。 |
移動
この操作は、モデル駆動型アプリの URL に移動するために使用します。
| パラメーター | 内容 |
|---|---|
| URL | 移動先のURL。 これは必須パラメーターです。 |
| Noscan | このパラメーターが指定されており、True となっている場合、データ パラメーターはページからキャプチャされません。 |
| HideCommandBar | このパラメーターが与えられていて、True の場合、モデル駆動型アプリのコマンド バーを読み込まなくても、内部フレームが表示されます。 |
| HideNavigationBar | このパラメーターが与えられていて、True の場合、モデル駆動型アプリのナビゲーション バーを読み込まなくても、フォームが表示されます。 |
| フレーム | ページ上にフレームが存在する場合、このパラメーターは、メイン ウィンドウを移動させるのではなく、移動するフレームの名前を指定します。 |
| postdata | HTTP POST トランザクションの一部としてサーバーに送信されるデータ。 POST トランザクションは、通常、HTML ページによって収集されたデータの送信に使用されます。 Unified Service Desk では、このデータは、<https://event/?> を使用して発生したイベントから取得されます。 例: [[postdata]+]または、データは、意図した形式のヘッダー タイプでエンコードされた文字列として渡されます。 |
| ヘッダー | サーバーに送信する追加の HTTP ヘッダーを含む文字列値。 postdata パラメーターが 移動 アクションで使用されると、 header パラメーターに適切な値を指定する必要があります。 例: Content-Type:application/x-www-form-urlencodedUnified Service Desk POST イベントが移動アクションをトリガーすると、このパラメーターの規定値は header=[[header]+] になります 複数のヘッダーを追加するには、このパラメーターの値は header=$Multiline(<headers separated by newline>) になります例: header=$Multiline(accessToken;dummyAccessToken==refreshToken;dummyRefreshToken===) |
New_CRM_Page
指定されたエンティティの新しいレコードを作成するページを作成し、そのページを指定したホストされたコントロールのポップアップ ウィンドウとして扱います。 ウィンドウ ナビゲーション ルールは、エンティティ レコードを作成するページが表示される場所を決定するために評価されます。
| パラメーター | 内容 |
|---|---|
| LogicalName | 新しいインスタンスを作成するためのエンティティの論理名です。 |
Note
残りのパラメーターは名前/値のペアで構成する必要があります。 これらは、指定されたエンティティの新しいレコードを作成するための、フォーム内で事前設定される追加の値です。 詳細情報 : チュートリアル 7 : エージェント アプリケーションでエージェント スクリプトを構成する の手順 4
Open_CRM_Page
ID が指定し、識別したエンティティの既存のインスタンスを開き、指定したホストされたコントロールからのポップアップ ウィンドウとしてページを扱います。 ウィンドウのナビゲーションルールでは、ポップアップ ウィンドウを表示する場所が決定されます。
| パラメーター | 内容 |
|---|---|
| LogicalName | 開くエンティティの論理名。 |
| ID | 開くエンティティ レコードの ID。 |
ポップアップ
ホストされたコントロールから URL をポップアップし、ポップアップウィンドウを適切な場所にルーティングするウィンドウ ナビゲーション ルールを実行します。
| パラメーター | 内容 |
|---|---|
| URL | この URL を使用して、表示されているコントロールから要求されたポップアップ ウィンドウであるかのように、ホストされたコントロールからのポップアップをルーティングします。 |
| フレーム | このポップアップ ウィンドウの元となるフレーム。 |
RealignWindow
モニタ上の指定された場所に、ホストされたコントロールを表示します。 ホストされたコントロールは最大 2 台のモニタに表示できます。 この操作は、USDFloatingPanel または USDFloatingToolPanel のパネルの種類に配置されるように構成されているホストされたコントロールのインスタンスに適用されます。
| パラメーター | 説明 |
|---|---|
| screen | ホストされたコントロールを表示する画面を指定します。 有効な値は 1 または 2 です。 このパラメーターを指定しない場合、既定で 1 が渡されます。 |
| left | ホストされたコントロールが表示される対象モニタの画面の左からの位置を、パーセンテージで指定します。 有効な値は 0 ～ 100 です。 このパラメーターを指定しない場合、既定で 0 が渡されます。 |
| top | ホストされたコントロールが表示される対象モニタの画面の右からの位置を、パーセンテージで指定します。 有効な値は 0 ～ 100 です。 このパラメーターを指定しない場合、既定で 0 が渡されます。 |
| width | 対象モニタに表示されるホストされたコントロールのウィンドウの幅を、パーセンテージで指定します。 有効な値は 1 ～ 100 です。 このパラメーターを指定しない場合、既定で 100 が渡されます。 |
| height | 対象モニタに表示されるホストされたコントロールのウィンドウの高さを、パーセンテージで指定します。 有効な値は 1 ～ 100 です。 このパラメーターを指定しない場合、既定で 100 が渡されます。 |
最新のステータスに更新
この操作は、現在のページを更新します。
ReRoute
このアクションは、現在表示されている URL を取得し、ポップアップ ウィンドウとして現在のホストされたコントロールからウィンドウ ナビゲーション ルールを介してそのURLを送信します。
RunScript
このアクションは、アプリケーションのメイン フレームに JavaScript を挿入します。 このアクションでは、Dataverse クライアント SDK 呼び出しの使用を避ける必要があります。代わりに、RunXrmCommand アクションを使用します。
| パラメーター | 内容 |
|---|---|
| 説明を参照する | データ パラメーターは、フォームに挿入される JavaScript です。 注: 置換パラメータはスクリプト内で使用することができ、スクリプトが実行される前に置換されます。 |
RunXrmCommand
このアプリケーションは、Dataverse SDK JavaScript をモデル駆動型アプリ フォームに挿入するために使用されます。
| パラメーター | 内容 |
|---|---|
| 説明を参照する | データ パラメーターは、フォームに挿入される JavaScript です。 注: 置換パラメータはスクリプト内で使用することができ、スクリプトが実行される前に置換されます。 |
SetSize
このアクションは、ホストされたコントロールの高さと幅を明示的に設定します。 これは、パネルのレイアウトで「自動」を使用するときに特に有用です。
| パラメーター | 内容 |
|---|---|
| 幅 | ホストされるコントロールの幅。 |
| 高さ | ホストされたコントロールの高さ。 |
SaveAndClose
このアクションはモデル駆動型アプリ フォームの 「ダーティ」 データを保存し、ホストされたコントロールを終了します。
SaveAll
このアクションは、複数のページを表示できるように (複数ページを許可する = はい)、すべてのフォームのホストされたコントロールを保存します。 ホストされたコントロールが単一ページの表示のみを許可する場合 (Allow Multiple Pages = No)、保存アクションと同等です。
保存
このアクションは現在の CRM ページを保存します。
ToggleRibbon
このアクションはリボンを折りたたみまたは展開します。 移動アクションでリボンを非表示にすると、リボンは表示されず、この操作は動作しません。 このアクションは、リボンが最初から読み込まれているときにのみ動作します。
ToggleNavigation
このアクションは、モデル駆動型アプリ ウィンドウの左側のパネルにあるナビゲーション ウィンドウを折りたたむ、または展開します。 このアクションが動作するためには、ナビゲーションにナビゲーション パネルが含まれている必要があります。
定義済みのイベント
次の定義済みイベントは、このホストされたコントロールの種類に関連付けられています。
ActiveClosed
CloseActive アクションを使用してアクティブ状態のホストされたコントロールを閉じると発生します。
| パラメーター | 内容 |
|---|---|
| URL | ホストされたコントロールが閉じられたときに、そこに表示されていた URL。 |
BrowserDocumentComplete
ページの読み込みが完了したときに発生します。 CRM ページタイプのホストされたコントロールでは、このイベントはデータが置換パラメーター リストに保存された後に発生します。 このイベントは、複数フレームがそれぞれ BrowserDocumentComplete イベントを発生させる場合でも、1 度のみ発生します。
| パラメーター | 内容 |
|---|---|
| url | 読み込みを完了したページの URL。 |
DataReady
エンティティの関連情報が Unified Service Desk コンテキストにロードされると直ちに発生します。 このイベントは BrowserDocumentComplete イベントの前に発生します。 コントロール インスタンスでデータの事前取得オプションがオンの場合、このイベントはイベント データが異なる並列コールでサーバーに取得されると直ちに発生し、ページ全体の読み込みを待機しません。 エンティティ データは事前にフェッチされ、インライン ナビゲーションのために DataReady イベントも発生します。
PageLoadComplete
フレームの読み込みが完了したタイミングで発生します。 このイベントは、 iFrame または フレームがページで使用された際に、ページが読み込まれるたびに複数回発生します。 このイベントは、コードでは個々の BrowserDocumentComplete イベントに対応します。
| パラメーター | 説明 |
|---|---|
| フレーム | 可能な場合、読み込みを完了したフレームの名前。 |
| URL | 読み込みを完了したフレームの URL。 |
PopupRouted
ポップアップ ウィンドウがシステムによってルーティングされた後に発生します。
| パラメーター | 内容 |
|---|---|
| URL | ルーティングされたポップアップ ウィンドウの URL です。 |
RefreshRequested
現在のページでリフレッシュが必要な時に発生します。 リフレッシュは、F5 キーを押すか、アプリケーションでリフレッシュ アクションを呼び出して要求できます。
| パラメーター | 説明 |
|---|---|
| URL | リフレッシュが要求されたときに表示される URL。 |
保存済み
モデル駆動型アプリ ページのレコードが保存された後に発生します。
| パラメーター | 説明設定 |
|---|---|
| newId | 新しく作成されるレコードに割り当てられる ID。 |
Note
モデル駆動型のアプリフォームでは window.IsUSD を使用せず、代わりにこのトピックに記載されている BrowserDocumentComplete イベントやその他のイベントを使用することをお勧めします。
関連項目
CRM ダイアログ (ホストされたコントロール)
UII アクション
イベント
チュートリアル 3: ユーザーのエージェント アプリケーションにレコードを表示する
ホストされたコントロールの種類とアクション/イベント リファレンス
Unified Service Desk の管理者ガイド
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示