CRM ダイアログ (ホストされたコントロール)
ダイアログで作業するには、CRM ダイアログのホストされたコントロール タイプを使用します。 CRM ダイアログのホストされたコントロールで StartDialog アクションを呼び出し、Unified Service Desk 内でダイアログを開始することができます。
CRM ダイアログのホストされたコントロールを作成する
新しいホストされたコントロールを作成中、新しいホストされたコントロールを画面は、作成するホストされたコントロールの種類により異なります。 このセクションは、CRM ダイアログのホストされたコントロールのタイプに固有の特定のフィールドに関する情報を提供します。 ホストされたコントロールの作成方法の詳細については、「ホストされたコントロールの作成または編集」を参照してください。
新しいホストされたコントロール画面で以下を実行します。
Unified Service Desk 領域で、CRM ダイアログを USD コンポーネントの種類ドロップ ダウン リストから選択します。
ホストの種類ドロップ ダウン リストは、このコントロールをホストする方法を指定します。 内部 WPF (既定値) または IE プロセスを選択することができます。 詳細については、「ホストされたコントロールのホスティング方法を選択する」を参照してください。
共通プロパティ領域で、アプリケーションはグローバルチェック ボックスをオンにし、ホストされたコントロールをグローバルとして設定します。 グローバルなホストされたコントロールは、顧客のセッションの外部で表示できます。 エージェントのダッシュ ボード、ウォールまたは検索などのコントロールは、グローバルなホストされたコントロールの一般的な用途です。 グローバルにホストされたコントロールは、セッション固有の状態を持たないため、セッションを変更しても、これら同じグローバルにホストされたコントロールは残ります。 チェック ボックスが選択されていない場合、ホストされたコントロールがセッション ベースになります。 セッション ベースのコントロールは、ユーザー セッションのコンテキストに存在します。 ユーザーが別のセッションに変更された場合は、前のセッションからのすべてのセッションのページは非表示になります。
表示グループフィールドに、ホストされたコントロールが表示されるパネルが表示されます。 MainPanel は、このホストされたコントロールの種類で最も一般的です。 Unified Service Desk で利用できる種々のパネルの詳細については、Unified Service Desk のパネルを参照してください。 その他の概要フィールドについては、「ホストされたコントロールの作成または編集」を参照してください。
事前定義 UII アクション
これらは、このホストされたコントロール タイプの定義済みアクションです。
閉じる
この操作は、ホストされたコントロールを閉じるために使用します。
FireEvent
このホストされたコントロールからユーザー定義イベントを発生させます。
| パラメーター | 説明 |
|---|---|
| 名前 | ユーザー定義イベントの名前。 |
後続のすべての名前と値が等しい組み合わせは、イベントに対するパラメーターとなります。 ユーザー定義イベントの作成の詳細については、「ユーザー定義イベントの作成」を参照してください。
MoveToPanel
このアクションを使用して、ホストされたコントロールを実行時にパネル間で移動します。
| パラメーター | 内容 |
|---|---|
| アプリ | 移動するホストされたコントロールの名前。 |
| パネル | ホストされたコントロールのターゲット パネルです。 |
New_CRM_Page
指定されたエンティティの新規レコードを作成するためのページを作成し、そのページを指定したホストされたコントロールのポップアップとして扱います。 エンティティ レコードを作成するページが表示される場所を決定するため、ウィンドウ ナビゲーション ルールが評価されます。
| パラメーター | 説明 |
|---|---|
| LogicalName | 新しいインスタンスを作成するためのエンティティの論理名です。 |
Note
残りのパラメーターは名前と値のペアで構成する必要があります。 これらは、指定されたエンティティの新しいレコードを作成するための、フォーム内で事前設定される追加の値です。 このアクションの使用方法の詳細については、「チュートリアル 7: エージェント アプリケーションでエージェントスクリプトを構成する のステップ 4」を参照してください。
Open_CRM_Page
ID によって指定されて認識されたエンティティの既存のインスタンスを開き、指定したホストされたコントロールからポップアップとしてそのページを取り扱います。 ウィンドウのナビゲーション規則が評価され、そのポップアップを表示する場所が決定されます。
| パラメーター | 説明 |
|---|---|
| LogicalName | 開くエンティティの論理名。 |
| ID | 開くエンティティ レコードの ID。 |
ポップアップ
ホストされたコントロールから URL がポップアップし、ポップアップを適切な場所にルーティングするために、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 が渡されます。 |
SetSize
このアクションは、ホストされたコントロールの高さと幅を明示的に設定します。 これは、パネルのレイアウトで「自動」を使用するときに特に有用です。
| パラメーター | 内容 |
|---|---|
| 幅 | ホストされるコントロールの幅。 |
| 高さ | ホストされたコントロールの高さ。 |
StartDialog
このアクションにはいくつかのパラメーターを指定できますが、特定のレコードに関連付けられていないダイアログに関しては、名前パラメーターだけを指定できます。
| パラメーター | 内容 |
|---|---|
| 件名 | Microsoft Dataverse の設定>プロセスセクションに表示されるダイアログの名前。 |
| DialogId | また、ID によってダイアログを指定することもできます。 DialogId パラメーターを指定した場合、アクションでこのパラメーターが名前パラメーターの代わりに使用されます。 |
| エンティティ | これは、ダイアログの実行対象のエンティティの種類です。 これは、DialogId パラメーターを使用している場合に必要です。 名前パラメーターを使用している場合は、必要ありません。 |
| ID | これが、ダイアログ セッションが適用されるエンティティの ID です。 このパラメーターが指定されていない場合は、システムの、適切な種類の最初のエントリに対してダイアログが実行されます。 |
ダイアログが終了すると、ウィンドウを閉じるよう、ユーザーにメッセージが表示されます。 ユーザーが肯定すると、Unified Service Desk のタブも閉じますが、これは仕様によるものです。
定義済みのイベント
次の定義済みイベントは、このホストされたコントロールの種類に関連付けられています。
BrowserDocumentComplete
ページの読み込みが完了したときに発生します。 CRM ページタイプのホストされたコントロールでは、このイベントはデータが置換パラメーター リストに保存された後に発生します。 このイベントは、複数フレームがそれぞれ BrowserDocumentComplete イベントを発生させる場合でも、1 度のみ発生します。
| パラメーター | 説明 |
|---|---|
| URL | 読み込みを完了したページの URL。 |
PopupRouted
システムによりポップアップがルートされた後に発生します。
| パラメーター | 内容 |
|---|---|
| url | ルートされたポップアップの URL です。 |
関連項目
CRM ページ (ホストされたコントロール)
UII アクション
イベント
Unified Service Desk の構成チュートリアル
ホストされたコントロールの種類とアクション/イベント リファレンス
Unified Service Desk の管理者ガイド
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示