フォーム上で IFRAME および Web リソース コントロールを使用する

公開日: 2017年1月

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

IFRAME と Web リソースは、HTML IFRAME 要素を使用して、ページ内に他のページから埋め込まれたコンテンツを制御します。

ASP.NET ページなど、別の Web サイトのコンテンツをフォームに表示するには、IFRAME を使用します。 別のエンティティ フォームに埋め込まれた IFrame 内のエンティティ フォームを表示することはサポートされていません。

Web リソースのコンテンツをフォームに表示するには、次のいずれかの Web リソースを使用できます。

• Webpage (HTML) の Web リソース

• Silverlight (XAP) の Web リソース

• 画像 (JPG、PNG、GIF、ICO) の Web リソース

以降のセクションでは、これらのコントロールで静的コンテンツ以外も表示させるために使用するオプションについて説明します。

このトピックの内容

クロスフレーム スクリプトを制限するかどうかを選択する

レコードに関するコンテキスト情報を渡す

フォーム データを渡す

URL を変更する

クロスフレーム スクリプトを制限するかどうかを選択する

IFRAME で表示されるコンテンツを完全には信頼しない場合は、[サポートされている場合はクロスフレーム スクリプトを制限します] オプションを使用します。 このオプションを選択すると、次の表に示す属性が IFRAME で設定されます。

ドメイン間での IFRAME 通信の有効化

異なるドメインにコンテンツを含むIFRAMEの通信を有効化する場合があります。Window.postMessage は、Internet Explorer 8以降のInternet Explorerのバージョンでこの機能を提供するブラウザー メソッドです。Google Chrome、Mozilla Firefox と Apple Safari でもサポートされます。postMessage の使用方法の詳細については、次のブログ記事を参照してください。

• Cross domain calls to the parent CRM 2011 form (親 CRM 2011 フォームに対するクロス ドメイン呼び出し)

• Cross-Document Messaging and RPC (クロス ドキュメント メッセージングと RPC)

レコードに関するコンテキスト情報を渡す

コントロール内で定義される URL にパラメーターを渡すことで、コンテキスト情報を提供できます。 フレームに表示されるページは、渡されるパラメーターを処理できる必要があります。IFRAME または Web リソースが、[パラメーターとして、レコードのオブジェクトの種類コードおよび一意の識別子を渡します。] オプションを使用して構成されている場合は、次の表のすべてのパラメーターが渡されます。 対応するフォーム XML 要素は、<PassParameters> (FormXml) です。

次の表のすべてのパラメーターが渡されるかどうかを指定できます。

言語コードは 4 桁または 5 桁のロケール ID です。 有効なロケール ID 値については、「Locale ID (LCID) Chart (ロケール ID (LCID) の一覧)」で確認することができます。

例

次のサンプルは、パラメーターのない URL の表示方法を示しています。

http://myserver/mypage.aspx

次のサンプルは、パラメーターのない URL の表示方法を示しています。

http://myserver/mypage.aspx?id=%7bB2232821-A775-DF11-8DD1-00155DBA3809%7d&orglcid=1033&orgname=adventureworkscycle&type=1&typename=account&userlcid=1033

渡されたパラメーターを読み取る

通常、渡されたパラメーターは、ターゲットの .aspx ページで HttpRequest.QueryString プロパティを使用して読み取られます。HTML ページでは、JavaScript で window.location.search プロパティを使用してパラメーターにアクセスできます。 詳細については、「HttpRequest.QueryString プロパティ」および「検索文字」を参照してください。

フォーム データを渡す

他の Web サイトに渡すデータが格納されている属性で getValue メソッドを使用し、他のページが使用できるクエリ文字列引数の文字列を構成します。 次に、フィールド OnChange イベント、IFRAME OnReadyStateComplete イベント、または タブ TabStateChange イベント、および setSrc メソッドを使用して、IFRAME または Web リソースの src プロパティにパラメーターを追加します。

データを Silverlight Web リソースに渡すのにデータ パラメーターを使用している場合は、データ パラメーターを通じて渡される値を、getData メソッドと setData メソッドを使用して操作できます。 Web ページ (HTML) の Web リソースの場合は、setSrc メソッドを使用して querystring パラメーターを直接操作します。

OnLoad イベントは使用しないでください。IFRAMES と Web リソースは非同期に読み込みを行うため、Onload イベント スクリプトが終了する前に、フレームの読み込みが終了しないことがあります。 この場合、変更した IFRAME または Web リソースの src プロパティが、IFRAME または Web リソースの URL プロパティの既定値で上書きされる可能性があります。

URL を変更する

フォーム内のデータや、ユーザーがオフラインかどうかなどの考慮事項に応じて、IFRAME のターゲットを変更すると有効な場合があります。IFRAME のターゲットは動的に設定できます。

例

次のサンプルで、オプション セット フィールドの onChange イベントを使用して、IFRAME の src プロパティおよび任意のパラメーターを設定する方法を示します。

//Get the value of an option set attribute
var value = Xrm.Page.data.entity.attributes.get("new_pagechooser").getValue();
var newTarget = "";
//Set the target based on the value of the option set
switch (value) {
    case 100000001:
        newTarget = "http://myServer/test/pageOne.aspx";
        break;
    default:
        newTarget = "http://myServer/test/pageTwo.aspx";
        break;
}
//Get the default URL for the IFRAME, which includes the 
// query string parameters
var IFrame = Xrm.Page.ui.controls.get("IFRAME_test");
var Url = IFrame.getSrc();
// Capture the parameters
var params = Url.substr(Url.indexOf("?"));
//Append the parameters to the new page URL
newTarget = newTarget + params;
// Use the setSrc method so that the IFRAME uses the
// new page with the existing parameters
IFrame.setSrc(newTarget);

関連項目

Microsoft Dynamics 365 フォームのコードを記述する
Microsoft Dynamics 365 での JavaScript の使用
フォーム スクリプトの簡易参照

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 著作権