CRM ページ (ホストされたコントロール)
公開日: 2016年11月
対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2013、Dynamics CRM 2015、Dynamics CRM 2016
CRM ページのホストされたコントロールの種類を使用して、Dynamics 365 から URL またはページを読み込みます。Dynamics 365 ページがこの種類のホストされたコントロールに読み込まれると、エンティティからのデータのページが自動的にスキャンされ、置換パラメーターが自動的に入力されます。
この種類のホストされたコントロールは、Dynamics 365 ウィンドウの処理に固有の、多数の定義済み UII アクションとイベントを公開します。これには、リスト操作アクション、簡易検索や高度な検索のページを表示する検索アクションなどが含まれます。
このトピックの内容
CRM ページのホストされたコントロールを作成する
事前定義 UII アクション
定義済みのイベント
CRM ページのホストされたコントロールを作成する
新しいホストされたコントロールを作成中、[新しいホストされたコントロールを] 画面は、作成するホストされたコントロールの種類により異なります。 このセクションは、CRM ページのホストされたコントロールの種類に固有の特定のフィールドに関する情報を提供します。 ホストされたコントロールの作成方法の詳細については、「ホストされたコントロールの作成または編集」を参照してください。
.jpeg "Dynamics 365 ページのホストされたコントロール")
[新しいホストされたコントロール] 画面で以下を実行します。
Unified Service Desk 領域で、CRM ページ を USD コンポーネントの種類ドロップダウン リストから選択します。
[複数ページの許可]ドロップダウン リストから、[なし] (既定) を選択して現在表示されているDynamics 365ページを置き換え、Unified Service Deskがナビゲーション アクションの呼び出しを受信するか、またはページがタブにルーティングされると、ブラウザーの履歴を更新します。**[はい]を選択して、2 番目の URL が呼び出されるか、ウィンドウ ナビゲーション ルールによりページがタブ移動する際に、ドロップ ダウン リストを自動的に作成します。 これにより、ユーザーはこのコントロールに関連付けられているDynamics 365ページ間をすばやく検索できます。 また、[はい]を選択した場合、追加のフィールド[最大ブラウザー]**が、ドロップダウン リストに表示されるページの最大数を指定できるようになります。
ホストの種類ドロップ ダウン リストは、このコントロールをホストする方法を指定します。[IE プロセス] (既定値) または **[内部 WPF]**を選択することができます。 詳細については、「ホストされたコントロールのホスティング方法を選択する」を参照してください。
共通プロパティ 領域で、アプリケーションはグローバルチェック ボックスをオンにし、ホストされたコントロールをグローバルとして設定します。 グローバルなホストされたコントロールは、顧客のセッションの外部で表示できます。 エージェントのダッシュ ボード、ウォールまたは検索などのコントロールは、グローバルなホストされたコントロールの一般的な用途です。 グローバルなホストされたコントロールは、セッション固有の状態を持たないため、セッションを変更しても、これら同じグローバルなホストされたコントロールは残ります。 チェック ボックスが選択されていない場合、ホストされたコントロールがセッション ベースになります。 セッション ベースのコントロールは、ユーザー セッションのコンテキストに存在します。 ユーザーが別のセッションに変更された場合は、前のセッションからのすべてのセッションのページは非表示になります。
[表示グループ] フィールドに、ホストされたコントロールが表示されるパネルが表示されます。[MainPanel] は、このホストされたコントロールの種類で最も一般的です。Unified Service Deskで利用できる種々のパネルに関する詳細は、Unified Service Desk でのパネル、パネルの種類、およびパネルのレイアウトを参照してください。
その他の [全般] フィールドについては、「ホストされたコントロールの作成または編集」を参照してください。
事前定義 UII アクション
これらは、このホストされたコントロール タイプの定義済みアクションです。
AssociatedView
このアクションは Dynamics 365 の関連付けられた特定のビューを読み込みます。 これらのビューは、通常、ナビゲーション バーのエンティティ レコード名の横にある下向き矢印をクリックし、関連付けられたエンティティを選択して関連付けます。
パラメーター |
説明 |
|---|---|
navItemName |
表示する関連付けられたエンティティ。 例: サポート案件 |
ID |
関連付けられたエンティティ レコードを表示する、メイン エンティティ レコードの ID。 |
tabset |
Dynamics 365 の領域。 例: areaSales または areaService。 |
このアクションの使用に関する詳細については、チュートリアル 7: エージェント アプリケーションでエージェントスクリプトを構成するのステップ 5 を参照してください。
閉じる
この操作は、ホストされたコントロールを閉じるために使用します。[CloseActive] アクションとは違い、このタブ (ホストされたコントロール) が複数のページを表示している場合、エージェント アプリケーション内のタブに表示されているすべてのページが閉じられます。
CloseActive
このホストされたコントロール内のアクティブなウィンドウを閉じるには、このアクションが使用されます。 アクティブなウィンドウがホストされたコントロールに表示される唯一のウィンドウの場合、ホストされたコントロール自体が閉じられます。[CRM ページ] の種類のホストされたコントロールでは、複数ページは許可されず ([複数ページの許可] = No)、このアクションは [閉じる] アクションに相当します。
CloseAndPrompt
このアクションはホストされたコントロールを終了しますが、閉じる前に保存または変更を破棄することが求められます。
DisableToolbarButton
このアクションは、エージェント アプリケーションのツール バーの指定したボタンを無効にします。
パラメーター |
説明 |
|---|---|
無効にするツールバー ボタンの名前。 |
EnableToolbarButton
このアクションは、エージェント アプリケーションのツール バーの指定したボタンを有効にします。
パラメーター |
内容 |
|---|---|
有効にするツールバー ボタンの名前。 |
検索
指定されたエンティティの簡易検索リスト ビューに移動します。
パラメーター |
内容 |
|---|---|
データ パラメーターには、表示する簡易検索リスト ビューのエンティティの論理名を指定します。 いくつかの特殊なサポート案件の値もあります。
|
FireEvent
このホストされたコントロールからユーザー定義イベントを発生させます。
パラメーター |
説明 |
|---|---|
名前 |
ユーザー定義イベントの名前。 |
後続のすべての名前と値が等しい組み合わせは、イベントに対するパラメーターとなります。 ユーザー定義イベントの作成方法の詳細については、「ユーザー定義イベントの作成」を参照してください。
GetSelectedIds
このアクションは、リストから選択した ID を取得するために使用します。
パラメーター |
説明 |
|---|---|
データ パラメーターには、選択した ID を取得するためのリスト名を指定する必要があります。 |
戻り値には、選択した項目を格納している ID のセミコロンで区切った一覧が含まれます。
GetSelectedCount
このアクションは、選択されている項目の数を取得します。 エンティティの実際の ID 一覧を取得するには、GetSelectedIds アクションを使用します。
パラメーター |
説明 |
|---|---|
データ パラメーターには、選択した ID を取得するためのリスト名を指定する必要があります。 |
戻り値には、選択した品目の数量を表す数値が含まれます。
GoHome
この操作は、ブラウザー インスタンスで指定された初期 URL に移動します。
GoBack
この操作は、ブラウザー インスタンスの [戻る] ボタンをクリックすることと同じです。
GoForward
この操作は、ブラウザー インスタンスの [進む] ボタンをクリックすることと同じです。
LoadArea
このアクションは Dynamics 365 から特定の領域を読み取ります。 これは、ナビゲーション ウィンドウ内の領域を選択することに相当します (Sales、Service、および Marketing など)。 唯一のパラメーターはクリックする領域の名前です。 例: [areaService]。
パラメーター |
説明 |
|---|---|
フレーム |
影響するフレームの名前。 名前を指定しない場合、ページ上で最初に見つかったフレームを自動的にターゲットとします。 |
LookupInfo
リストからエンティティを選択することをユーザーに許可するため、Dynamics 365 参照情報ダイアログ ボックスを表示します。
パラメーター |
説明 |
|---|---|
AllowFilterOff |
「0」または「1」で、フィルター処理を無効にすることをユーザーに許可します |
DefaultType |
デフォルトの表示の論理名です。 これは、objecttypes パラメーターで指定した数値のいずれかである必要があります。 |
DefaultViewId |
「0」または「1」で、デフォルトの表示を表示します |
DisableQuickFind |
「0」または「1」で、簡易検索フィールドを表示します |
DisableViewPicker |
「0」または「1」で、ビュー セレクターを表示します |
LookupStyle |
1 つまたは複数 |
ShowNewButton |
「0」または「1」で、新しいボタンを表示します |
ShowPropButton |
「0」または「1」で、プロパティ ボタンを表示します |
参照 |
「0」または「1」で、ブラウズ モードを使用するかどうかを指定します。 以下は、これを「1」に設定した場合です。 |
Currentid |
現在の値の GUID |
objecttypes |
表示するオブジェクトの種類の一覧です。 これらは、Dynamics 365 の etc の種類です。 例:「1,2」でアカウントや連絡先を表示します。 |
MoveToPanel
この操作により、実行時に CRM ページのホストされたコントロールが別のパネルに移動します。
パラメーター |
内容 |
|---|---|
データ パラメーターは、ホストされたコントロールを移動するために対象のパネルの名前を指定する必要があります。 例: FloatingPanel。 |
移動
この操作は、Dynamics 365 URL に移動するために使用します。
パラメーター |
説明 |
|---|---|
url |
移動先のURL。 これは必須パラメーターです。 |
Noscan |
このパラメーターが指定されており、Trueの場合、データ パラメーターはページからキャプチャされません。 |
HideCommandBar |
このパラメーターが与えられていて、[True] の場合、Dynamics 365ページ コマンド バーを読み込まなくても、内部フレームが表示されます。 |
HideNavigationBar |
このパラメーターが与えられていて、[True] の場合、Dynamics 365ナビゲーション バーを読み込まなくても、フォームが表示されます。 |
フレーム |
ページ上にフレームが存在する場合、このパラメーターは、メイン ウィンドウを移動させるのではなく、移動するフレームの名前を指定します。 |
postdata |
HTTPPOST トランザクションの一部としてサーバーに送信されるデータ。POST トランザクションは、通常、HTML ページによって収集されたデータの送信に使用されます。Unified Service Deskでは、このデータは、"http://event/?"を使用して発生したイベントから取得されます。 例: [[postdata]+] または、データは、意図した形式のヘッダー タイプでエンコードされた文字列として渡されます。 |
ヘッダー |
サーバーに送信する追加の HTTP ヘッダーを含む文字列値。postdata パラメーターがNavigate アクションで使用されると、header パラメーターに適切な値を指定する必要があります。 例: Content-Type:application/x-www-form-urlencoded Unified Service Desk POST イベントが Navigate アクションをトリガーする場合、このパラメーターの既定値は header=[[header]+] にする必要があります |
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 が渡されます。 |
最新の情報に更新
この操作は、現在のページを更新します。
ReRoute
このアクションは、現在表示されている URL を取得し、ポップアップとして現在のホストされたコントロールからウィンドウ ナビゲーション ルールを介してそのURLを送信します。
RunScript
このアクションは、アプリケーションのメイン フレームに JavaScript を挿入します。 このアクションでは、Dynamics 365 クライアント SDK 呼び出しの使用を避ける必要があります。代わりに、[RunXrmCommand] アクションを使用します。
パラメーター |
説明 |
|---|---|
データ パラメーターは、フォームに挿入される JavaScript です。 注意 置換パラメーターはスクリプトで使用され、スクリプトが実行される前に置き換えられることに注意してください。 |
RunXrmCommand
このアクションは、Dynamics 365 SDK の JavaScript を Dynamics 365 フォームに挿入するのに使用します。
パラメーター |
説明 |
|---|---|
データ パラメーターは、フォームに挿入される JavaScript です。 注意 置換パラメーターはスクリプトで使用され、スクリプトが実行される前に置き換えられることに注意してください。 |
SetSize
このアクションは、ホストされたコントロールの高さと幅を明示的に設定します。 これは、パネルのレイアウトで「自動」を使用するときに特に有用です。
パラメーター |
内容 |
|---|---|
幅 |
ホストされるコントロールの幅。 |
height |
ホストされたコントロールの高さ。 |
SaveAndClose
このアクションは Dynamics 365 フォームのダーティ データを保存し、ホストされたコントロールを終了します。
SaveAll
このアクションは、複数のページを表示できるように ([Allow Multiple Pages] = Yes)、すべてのフォームのホストされたコントロールを保存します。 ホストされたコントロールが単一ページの表示のみを許可する場合 ([Allow Multiple Pages] = No)、[保存] アクションと同等です。
保存
このアクションは現在の CRM ページを保存します。
ToggleRibbon
このアクションはリボンを折りたたみまたは展開します。[移動] アクションでリボンを非表示にする場合、リボンは表示されず、この操作は動作しません。 このアクションは、リボンが最初から読み込まれているときにのみ動作します。
ToggleNavigation
このアクションは、Dynamics 365 ウィンドウの左側のパネルにあるナビゲーション ウィンドウを折りたたみまたは展開します。 このアクションが動作するためには、ナビゲーションにナビゲーション パネルが含まれている必要があります。
定義済みのイベント
次の定義済みイベントは、このホストされたコントロールの種類に関連付けられています。
ActiveClosed
CloseActive を使用してアクティブなホストされたコントロールを閉じると発生します。
パラメーター |
説明 |
|---|---|
url |
ホストされたコントロールが閉じられたときに、そこに表示されていた URL。 |
BrowserDocumentComplete
ページの読み込みが完了したときに発生します。[CRM ページ] タイプのホストされたコントロールでは、このイベントはデータが置換パラメーター リストに保存された後に発生します。 このイベントは、複数フレームがそれぞれ [BrowserDocumentComplete] イベントを発生させる場合でも、1 度のみ発生します。
パラメーター |
説明 |
|---|---|
url |
読み込みを完了したページの URL。 |
PageLoadComplete
フレームの読み込みが完了したタイミングに発生します。 このイベントは、IFRAME または フレームがページで使用されたときに、ページが読み込まれるたびに複数回発生します。 このイベントは、コードでは個々の BrowserDocumentComplete イベントに対応します。
パラメーター |
説明 |
|---|---|
フレーム |
可能な場合、読み込みを完了したフレームの名前。 |
url |
読み込みを完了したフレームの URL。 |
PopupRouted
システムによりポップアップがルートされた後に発生します。
パラメーター |
説明 |
|---|---|
url |
ルートされたポップアップの URL です。 |
RefreshRequested
現在のページでリフレッシュが必要な時に発生します。 リフレッシュは、F5 キーを押すか、アプリケーションでリフレッシュ アクションを呼び出して要求できます。
パラメーター |
説明 |
|---|---|
url |
リフレッシュが要求されたときに表示される URL。 |
保存済み
Dynamics 365 ページのレコードが保存された後に発生します。
パラメーター |
説明 |
|---|---|
newId |
新しく作成されるレコードに割り当てられる ID。 |
関連項目
CRM ダイアログ (ホストされたコントロール)
UII アクション
イベント
チュートリアル 3: ユーザーのエージェント アプリケーションに Microsoft Dynamics 365 レコードを表示する
ホストされたコントロールの種類とアクション/イベント リファレンス
Microsoft Dynamics CRM 用 Unified Service Desk の管理者ガイド
Unified Service Desk 2.0
© 2017 Microsoft. All rights reserved. 著作権