対話型サービスハブページ (ホストされたコントロール)

[アーティクル]
05/15/2017

公開日: 2016年11月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2013、Dynamics CRM 2015、Dynamics CRM 2016

[対話型サービスハブページ] のホストされたコントロールの種類を使用して、両方のアプリケーションの機能を統合するために、Unified Service Desk 内の対話型サービスハブをホストします。対話型サービスハブでは直感的なインターフェースを提供し、顧客に関連した重要な情報がすべて 1 つの場所に表示されるため、顧客サポートエージェントは注意を要する情報に集中できます。

注意

この機能は Unified Service Desk 2.1 に導入されています。

対話型サービスハブフォームが [対話型サービスハブページ] のホストされたコントロール内に読み込まれると、データに対して自動的にそのページをスキャンし、自動的にUnified Service Deskに置き換えパラメーターが入力されます。[対話型サービスハブページ] のホストされたコントロールは、対話型サービスハブページの処理に固有の、多数の定義済み UII アクションとイベントを公開します。これには、リスト操作アクション、簡易検索や高度な検索のページを表示する検索アクションなどが含まれます。

Unified Service Desk はサンプルパッケージ、対話型サービスハブ、を提供し、これは、Unified Service Desk内で対話型サービスハブページの簡単な統合方法を示しています。詳細情報: TechNet: Unified Service Desk 2.1 サンプルアプリケーション

注意

既存の Dynamics 365 ページ] タイプのホストされたコントロールを [対話型サービスハブページ] に変換し、Dynamics 365 フォームではなく、対話側サービスハブアプリケーションが使用する対話型エクスペリエンスフォームを表示することができます。ただし、その際に考慮事項がいくつかあります。詳細については、「ブログ: Unified Service Desk での対話中心フォームのサポート」を参照してください

このトピックの内容

対話型サービスハブページのホストされたコントロールの作成

事前定義 UII アクション

定義済みのイベント

対話型サービスハブページのホストされたコントロールの作成

新しいホストされたコントロールを作成中、[新しいホストされたコントロールを] 画面は、作成するホストされたコントロールの種類により異なります。このセクションでは、[対話型サービスハブページ] のホストされたコントロールの種類に固有の特定のフィールドに関する情報を提供します。ホストされたコントロールの作成方法の詳細については、「ホストされたコントロールの作成または編集」を参照してください。

対話型サービスハブページのホストされたコントロール

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

[Unified Service Desk] 領域で、[対話型サービスハブページ] を [USD コンポーネントの種類] ドロップダウンリストから選択します。
[複数ページの許可]ドロップダウンリストから、[なし] (既定) を選択して現在表示されている対話型サービスハブページを置き換え、Unified Service Desk がナビゲーションアクションの呼び出しを受信するか、またはページがタブにルーティングされると、ブラウザーの履歴を更新します。**[はい]を選択して、2 番目の URL が呼び出されるか、ウィンドウナビゲーションルールによりページがタブ移動する際に、ドロップダウンリストを自動的に作成します。これにより、ユーザーはこのコントロールに関連付けられている対話型サービスハブページ間をすばやく検索できます。また、[はい]を選択した場合、追加のフィールド[最大ブラウザー]**が、ドロップダウンリストに表示されるページの最大数を指定できるようになります。
[IE プロセス] はこのホストされたコントロールの種類の既定の [ホストの種類] で、その他のいずれかのホストの種類を選択することはできません。Unified Service Desk でサポートされるホスト方法については、ホストされたコントロールのホスティング方法を選択するを参照してください。
[アプリケーションがグローバル] チェックボックスを選択して、ホストされたコントロールをグローバルとして設定します。グローバルなホストされたコントロールは、顧客のセッションの外部で表示できます。エージェントのダッシュボード、ウォールまたは検索などのコントロールは、グローバルなホストされたコントロールの一般的な用途です。グローバルなホストされたコントロールは、セッション固有の状態を持たないため、セッションを変更しても、これら同じグローバルなホストされたコントロールは残ります。チェックボックスが選択されていない場合、ホストされたコントロールがセッションベースになります。セッションベースのコントロールは、ユーザーセッションのコンテキストに存在します。ユーザーが別のセッションに変更された場合は、前のセッションからのすべてのセッションのページは非表示になります。
[表示グループ] フィールドに、ホストされたコントロールが表示されるパネルが表示されます。[MainPanel] は、このホストされたコントロールの種類で最も一般的です。Unified Service Deskで利用できる種々のパネルに関する詳細は、Unified Service Desk でのパネル、パネルの種類、およびパネルのレイアウトを参照してください。
[アプリケーションは動的] リストから [はい] または [いいえ] を選択して、これが動的にホストされたコントロールであるかどうかを指定します。動的にホストされたコントロールによってエージェントは要求に応じて、UI を使用またはプログラムコードのいずれかを使用して、ホストされたコントロールを開始または終了できます。詳細: 動的な Unified Service Desk のホストされたコントロール

[はい] を選択する場合、[ユーザーは閉じることができる] チェックボックスが使用できるようになります。ユーザーがこのホストされたコントロール閉じるには、このチェックボックスを選択します。

その他の [全般] フィールドについては、「ホストされたコントロールの作成または編集」を参照してください。

事前定義 UII アクション

これらは、このホストされたコントロールタイプの定義済みアクションです。

注意

[対話型サービスハブページ] タイプのホストされたコントロールは、[Dynamics 365 ページ] タイプのホストされたコントロールがサポートするすべての UII アクションをサポートします。ただし、一部の UII アクションは、最初に [対話型サービスハブページ]の種類のホストされたコントロールのインスタンスを作成し保存する場合には使用できません。ホストされたコントロールインスタンスに対するそれ以降のいずれかの更新プログラムでは不明な UII のアクションを追加します。

AssociatedView

このアクションによって、対話型サービスハブの特定の関連ビューが読み込まれます。これらのビューは、通常、ナビゲーションバーのエンティティレコード名の横にある下向き矢印をクリックし、関連付けられたエンティティを選択して関連付けます。

パラメーター	内容
navItemName	表示する関連付けられたエンティティ。例: Cases
Id	関連付けられたエンティティレコードを表示する、メインエンティティレコードの ID。
tabset	Dynamics 365 の領域。例: areaSales または areaService。

閉じる

この操作は、ホストされたコントロールを閉じるために使用します。[CloseActive] アクションとは違い、このタブ (ホストされたコントロール) が複数のページを表示している場合、エージェントアプリケーション内のタブに表示されているすべてのページが閉じられます。

CloseActive

このホストされたコントロール内のアクティブなウィンドウを閉じるには、このアクションが使用されます。アクティブなウィンドウがホストされたコントロールに表示される唯一のウィンドウの場合、ホストされたコントロール自体が閉じられます。ホストされたコントロールでは複数ページは許可しない場合 ([複数ページの許可] = No)、このアクションは [閉じる] アクションに相当します。

CloseAndPrompt

このアクションでは、ホストされたコントロールを閉じる前に変更の保存または破棄が求められます。

検索

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

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

データパラメーターには、表示する簡易検索リストビューのエンティティの論理名を指定します。いくつかの特殊なサポート案件の値もあります。

case または incident を使用して、サポート案件のための簡易検索一覧ビューを表示します。
advfind を使用して高度な検索ビューを表示します。
activities または activity を使用して、活動のための簡易検索一覧ビューを表示します。

FireEvent

このホストされたコントロールからユーザー定義イベントを発生させます。

パラメーター	内容
name	ユーザー定義イベントの名前。

後続のすべての名前と値が等しい組み合わせは、イベントに対するパラメーターとなります。ユーザー定義イベントの作成方法の詳細については、「ユーザー定義イベントの作成」を参照してください。

GetSelectedCount

このアクションは、選択されている項目の数を取得します。エンティティの実際の ID 一覧を取得するには、GetSelectedIds アクションを使用します。

パラメーター	説明
	データパラメーターには、選択した ID を取得するためのリスト名を指定する必要があります。

戻り値には、選択した品目の数量を表す数値が含まれます。

GetSelectedIds

このアクションは、リストから選択した ID を取得するために使用します。

パラメーター	説明
	データパラメーターには、選択した ID を取得するためのリスト名を指定する必要があります。

戻り値には、選択した項目を格納している ID のセミコロンで区切った一覧が含まれます。

GoBack

このアクションは、対話型サービスハブの戻るボタンをクリックすることと同じで、対話型サービスハブのナビゲーションスタックに戻ります。

GoHome

このアクションによって、Dynamics 365 のユーザーによって指定されたホームページに移動します。

MoveToPanel

このアクションを使用して、ホストされたコントロールを実行時にパネル間で移動します。

パラメーター	内容
アプリ	移動するホストされたコントロールの名前。
パネル	ホストされたコントロールのターゲットパネルです。

移動

このアクションは、対話型サービスハブ URL にナビゲートするために使用されます。

パラメーター	内容
url	移動先のURL。これは必須パラメーターです。
Noscan	このパラメーターが指定されており、Trueの場合、データパラメーターはページからキャプチャされません。
HideCommandBar	このパラメーターが与えられていて、[True] の場合、対話型サービスハブのコマンドバーを読み込まなくても、内部フレームが表示されます。
HideNavigationBar	このパラメーターが与えられていて、[True] の場合、対話型サービスハブのナビゲーションバーを読み込まなくても、フォームが表示されます。
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=incident
title=Sample Case

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 を対話型サービスハブフォームに挿入するために使用されます。

パラメーター	内容
	データパラメーターは、フォームに挿入される JavaScript です。注意置換パラメーターはスクリプトで使用され、スクリプトが実行される前に置き換えられることに注意してください。

上書き保存

このアクションは、対話型サービスハブフォームの現在のデータを保存します。

SaveAll

このアクションは、複数のページを表示できるように ([Allow Multiple Pages] = Yes)、すべてのフォームのホストされたコントロールを保存します。ホストされたコントロールが単一ページの表示のみを許可する場合 ([Allow Multiple Pages] = No)、[保存] アクションと同等です。

SaveAndClose

このアクションは対話型サービスハブフォームの現在のデータを保存し、ホストされたコントロールを終了します。

SetSize

このアクションは、ホストされたコントロールの高さと幅を明示的に設定します。これは、パネルのレイアウトで「自動」を使用するときに特に有用です。

パラメーター	説明
width	ホストされるコントロールの幅。
height	ホストされたコントロールの高さ。

定義済みのイベント

次の定義済みイベントは、このホストされたコントロールの種類に関連付けられています。

ActiveClosed

CloseActive を使用してアクティブなホストされたコントロールを閉じると発生します。

パラメーター	内容
url	ホストされたコントロールが閉じられたときに、そこに表示されていた URL。

DataReady

対話型サービスのページのデータが置換パラメーターリストに保存されると発生します。

パラメーター	内容
url	ページの URL。

NavigationRequested

ナビゲーションが対話型サービスハブ内で発生すると発生します。

パラメーター	内容
url	ナビゲーションされるページの URL。

RefreshRequested

現在のページでリフレッシュが必要な時に発生します。リフレッシュは、F5 キーを押すか、アプリケーションでリフレッシュアクションを呼び出して要求できます。

パラメーター	内容
url	リフレッシュが要求されたときに表示される URL。

保存済み

対話型サービスハブページのレコードが保存された後に発生します。

パラメーター	内容
newId	新しく作成されるレコードに割り当てられる ID。

次の方法で共有

対話型サービスハブページ (ホストされたコントロール)

このトピックの内容

対話型サービスハブページのホストされたコントロールの作成

事前定義 UII アクション

AssociatedView

閉じる

CloseActive

CloseAndPrompt

検索

FireEvent

GetSelectedCount

GetSelectedIds

GoBack

GoHome

MoveToPanel

移動

New_CRM_Page

Open_CRM_Page

ポップアップ

RealignWindow

最新の情報に更新します

ReRoute

RunScript

RunXrmCommand

上書き保存

SaveAll

SaveAndClose

SetSize

定義済みのイベント

ActiveClosed

DataReady

NavigationRequested

RefreshRequested

保存済み

関連項目

その他のリソース

次の方法で共有

対話型サービス ハブ ページ (ホストされたコントロール)

このトピックの内容

対話型サービス ハブ ページ のホストされたコントロールの作成

事前定義 UII アクション

AssociatedView

閉じる

CloseActive

CloseAndPrompt

検索

FireEvent

GetSelectedCount

GetSelectedIds

GoBack

GoHome

MoveToPanel

移動

New_CRM_Page

Open_CRM_Page

ポップアップ

RealignWindow

最新の情報に更新します

ReRoute

RunScript

RunXrmCommand

上書き保存

SaveAll

SaveAndClose

SetSize

定義済みのイベント

ActiveClosed

DataReady

NavigationRequested

RefreshRequested

保存済み

関連項目

その他のリソース

対話型サービスハブページ (ホストされたコントロール)

対話型サービスハブページのホストされたコントロールの作成