標準的 Web アプリケーション (ホストされたコントロール)
公開日: 2016年11月
対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2013、Dynamics CRM 2015、Dynamics CRM 2016
[標準 Web アプリケーション] のホストされたコントロール タイプは、外部の Web ページのような 非 Dynamics 365 ページをホストすることを目的としていることを除いて、[CRM ページ] タイプと類似し、また、外部の Web ページの関連機能に対するスクリプト挿入を提供します。CRM ページ のホストされたコントロールと同様、これらのページは自動化できます。 推奨の自動化方法は、ページで既に定義されているか、DOM を操作する JavaScript 関数の呼び出しを含む JavaScript インジェクションを使用することです。RunScript アクションを使用して、ページから値を取得することもできます。
注意
このホストされたコントロール タイプは、ホストされたアプリケーション ツールキット (HAT) をサポートしていません。このツールキットはホストされたアプリケーションの UI を自動化する作業を容易にします。 HAT には、アプリケーションを自動化するために、データ駆動型アダプター (DDA)、説明的なバインディングと自動化 (Windows ワークフロー) で構成されます。詳細:UII オートメーション アダプターを使用して外部および Web アプリケーションとやり取りする
このトピックの内容
標準 Web アプリケーション (ホストされたコントロール) を作成する
事前定義 UII アクション
定義済みのイベント
標準 Web アプリケーション (ホストされたコントロール) を作成する
新しいホストされたコントロールを作成中、[新しいホストされたコントロールを] 画面は、作成するホストされたコントロールの種類により異なります。 このセクションは、ホストされたコントロールの標準 Web アプリケーションタイプに固有の特定のフィールドに関する情報を提供します。 ホストされたコントロールの作成方法の詳細については、「ホストされたコントロールの作成または編集」を参照してください。
[新しいホストされたコントロール] 画面で以下を実行します。
[Unified Service Desk] 領域で、[標準 Web アプリケーション] を [USD コンポーネントの種類] ドロップ ダウン リストから選択します。
複数ページの許可 ドロップ ダウン リストで、はいを選択して、2 番目の URL が呼び出されるか、ウィンドウ ナビゲーション ルールによりページがタブ移動する際に、ドロップ ダウン リストを自動的に作成します。 これにより、ユーザーはこのコントロールに関連付けられているページ間をすばやく検索できます。なしを選択する場合は、Unified Service Desk がナビゲーション アクションの呼び出しを受信するか、またはページがタブにルーティングされると、現在表示されているページを置き換え、ブラウザーの履歴を更新します。
ホストの種類ドロップ ダウン リストは、このコントロールをホストする方法を指定します。 [IE プロセス] に対して既定値または [内部 WPF] を選択することができます。 詳細については、「ホストされたコントロールのホスティング方法を選択する」を参照してください。
共通プロパティ 領域で、アプリケーションはグローバルチェック ボックスをオンにし、ホストされたコントロールをグローバルとして設定します。 グローバルなホストされたコントロールは、顧客のセッションの外部で表示できます。 エージェントのダッシュ ボード、ウォールまたは検索などのコントロールは、グローバルなホストされたコントロールの一般的な用途です。 グローバルなホストされたコントロールは、セッション固有の状態を持たないため、セッションを変更しても、これら同じグローバルなホストされたコントロールは残ります。 チェック ボックスが選択されていない場合、ホストされたコントロールがセッション ベースになります。 セッション ベースのコントロールは、ユーザー セッションのコンテキストに存在します。 ユーザーが別のセッションに変更された場合は、前のセッションからのすべてのセッションのページは非表示になります。
表示グループフィールドで、ホストされたコントロールが表示されるパネルを指定します。Unified Service Deskで利用できる種々のパネルに関する詳細は、Unified Service Deskのパネルを参照してください。
事前定義 UII アクション
これらは、このホストされたコントロール タイプに使用可能な定義済み UII アクションです。
閉じる
この操作は、ホストされたコントロールを閉じるために使用します。
FireEvent
このホストされたコントロールからユーザー定義イベントを発生させます。
パラメーター |
説明 |
---|---|
名前 |
ユーザー定義イベントの名前。 |
後続のすべての名前と値が等しい組み合わせは、イベントに対するパラメーターとなります。 ユーザー定義イベントの作成方法の詳細については、「ユーザー定義イベントの作成」を参照してください。
GoBack
この操作は、ブラウザー インスタンスの [戻る] ボタンをクリックすることと同じです。
GoForward
この操作は、ブラウザー インスタンスの [進む] ボタンをクリックすることと同じです。
GoHome
この操作は、ブラウザー インスタンスで指定された初期 URL に移動します。
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 |
新しいインスタンスを作成するためのエンティティの論理名です。 |
注意
残りのパラメーターは名前と値のペアで構成する必要があります。 これらは、指定されたエンティティの新しいレコードを作成するための、フォーム内で事前設定される追加の値です。 このアクションの使用に関する詳細については、チュートリアル 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 が渡されます。 |
RunScript
このアクションは、アプリケーションのメイン フレームに JavaScript を挿入します。 このアクションでは、Dynamics 365 クライアント SDK 呼び出しの使用を避ける必要があります。代わりに、[RunXrmCommand] アクションを使用します。
パラメーター |
説明 |
---|---|
データ パラメーターは、フォームに挿入される JavaScript です。 注意 置換パラメーターはスクリプトで使用され、スクリプトが実行される前に置き換えられることに注意してください。 |
SetSize
このアクションは、ホストされたコントロールの高さと幅を明示的に設定します。 これは、パネルのレイアウトで「自動」を使用するときに特に有用です。
パラメーター |
内容 |
---|---|
幅 |
ホストされるコントロールの幅。 |
height |
ホストされたコントロールの高さ。 |
WaitForComplete
このアクション URL の読み込みが完了するまで処理をブロックするのに使用されます。
注意
一部の Web ページ、特に Dynamics 365 ページには、複数のフレームがあります。 このアクションは、メインのフレームのみの完了を待ちます。
パラメーター |
説明 |
---|---|
Milliseconds |
タイムアウトを待機するミリ秒単位で時間を指定するオプションのパラメーター。 |
定義済みのイベント
次の定義済みイベントは、このホストされたコントロールの種類に関連付けられています。
BrowserDocumentComplete
ページの読み込みが完了したときに発生します。[CRM ページ] タイプのホストされたコントロールでは、このイベントはデータが置換パラメーター リストに保存された後に発生します。 このイベントは、複数フレームがそれぞれ [BrowserDocumentComplete] イベントを発生させる場合でも、1 度のみ発生します。
パラメーター |
説明 |
---|---|
url |
読み込みを完了したページの URL。 |
PopupRouted
システムによりポップアップがルートされた後に発生します。
パラメーター |
説明 |
---|---|
url |
ルートされたポップアップの URL です。 |
関連項目
UII アクション
イベント
ホストされたコントロールの定義済みのアクションとイベントの表示
ホストされたコントロールの作成または編集
チュートリアル 2: エージェント アプリケーションに外部 Web ページを表示する
ホストされたコントロールの種類とアクション/イベント リファレンス
Unified Service Desk 2.0
© 2017 Microsoft. All rights reserved. 著作権