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