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 ページのホストされたコントロールの種類に固有の特定のフィールドに関する情報を提供します。 ホストされたコントロールの作成方法の詳細については、「ホストされたコントロールの作成または編集」を参照してください。

[新しいホストされたコントロール] 画面で以下を実行します。

• 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

このアクションは、エージェント アプリケーションのツール バーの指定したボタンを有効にします。

パラメーター	内容
	有効にするツールバー ボタンの名前。

検索

指定されたエンティティの簡易検索リスト ビューに移動します。

パラメーター	内容
	データ パラメーターには、表示する簡易検索リスト ビューのエンティティの論理名を指定します。 いくつかの特殊なサポート案件の値もあります。 [サポート案件] または [インシデント] を使用して、サポート案件のための簡易検索一覧ビューを表示します。 [advfind] を使用して高度な検索ビューを表示します。 [活動] または [活動] を使用して、活動のための簡易検索一覧ビューを表示します。

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. 著作権