Webpage (HTML) の Web リソース

Web ページ (HTML) の Web リソースを使用して、クライアント拡張のためのユーザー インターフェイス要素を作成します。

HTML web リソースの機能

HTML Web リソースはユーザーのブラウザーにストリームされるので、ユーザーのブラウザーで表示される任意のコンテンツを含めることができます。

HTML web リソースの制限

  • サーバーで実行する必要のあるコードを HTML Web リソースに含めることはできません。 ASP.NET のページを HTML Web リソースとしてアップロードすることはできません。

  • HTML Web リソースでは、限られた数のクエリ文字列パラメーターのみ受け取ることができます。 詳細: HTML Web リソースへのパラメーターの引き渡し

HTML Web リソースでテキスト エディターを使用する

Web リソース フォームに付属のテキスト エディターは、非常に単純な HTML の編集に使用します。 高度な HTML ドキュメントの場合は、外部エディターでコードを編集し、参照ボタンを使用してファイルのコンテンツをアップロードする必要があります。

たとえば、スクリプトを使用してページのコンテンツを表示する複雑な HTML ページの先頭部分は次のようになります。

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
 <title></title>
 <script src="Script/Script.js" type="text/javascript"></script>
 <link href="CSS/Styles.css" rel="stylesheet" type="text/css" />
</head>
<body onload="SDK.ImportWebResources.showData()">
 <div id="results" />
</body>
</html>

テキスト エディターでドキュメントを開いて保存した後、この HTML は次のように変更されます。

<HTML><HEAD><TITLE></TITLE>
<META charset=utf-8></HEAD>
<BODY contentEditable=true onload=SDK.ImportWebResources.showData()>
<SCRIPT type=text/javascript src="Script/Script.js"></SCRIPT>
 <LINK rel=stylesheet type=text/css href="CSS/Styles.css">
<DIV id=results></DIV></BODY></HTML>

管理ソリューションの Web リソースの編集の禁止

テキスト エディターで変更される Web リソースには HTML 用の機能があるため、管理プロパティを使用して、複雑な HTML Web リソースをマネージド ソリューションに対してカスタマイズ可能なリソースとして設定することをお勧めします。 ソリューションのウィンドウに Web リソースを表示する場合は、管理プロパティダイアログ ボックスを使用してカスタマイズ可能プロパティを false に設定します。

HTML Web リソースからの他の Web リソースの参照

いずれかの Web リソース ファイルの種類を使用する一連の関連ファイルを Dynamics 365 for Customer Engagement 外で作成できます。 常に相対パスを使用し、Web サイトのフォルダー構造を反映する一貫性のある命名規則を使用して各 Web リソースをインポートすると、Web リソースとしてインポートされた関連する CSS、XML、JScript、イメージ、および Silverlight のファイルへのリンクが HTML Web リソースで維持されます。

たとえば、次の [フォルダー]/ファイル構造を使用する Web アプリケーション プロジェクトを作成するとします。

  • page.htm

  • [Styles]

    • style.css
  • [Scripts]

    • script.js

    これらのファイルを Web リソースとしてインポートする場合、ソリューション発行者のカスタマイズの接頭辞は "new" で、次の方法で名前を付けることができます。

  • new_/page.htm

  • new_/Styles/style.css

  • new_/Scripts/script.js

    このパターンに従うと、new_/page.htm HTML Web リソースでは、以下の例に示すように、相対パスを使用する最も一般的な方法で他のファイルを参照できます。

<script src="Scripts/script.js" type="text/javascript"></script>
<link href="Styles/style.css" rel="stylesheet" type="text/css" />

ソリューションのすべての Web リソースでは、ソリューション発行者のカスタマイズの接頭辞は仮想ルート フォルダーになります。 カスタマイズの接頭辞を変更する場合、HTML Web リソース内の相対パスは変更されません。

注意

  • フォームに追加された HTML Web リソースは、フォームに読み込まれた JavaScript ライブラリによって定義されたグローバル オブジェクトを使用できません。 HTML Web リソースは、parent.Xrm.Page または parent.Xrm.Utility を使用することによって、フォーム内の Xrm.Page または Xrm.Utility オブジェクトとやりとりできますが、フォーム スクリプトによって定義されたグローバル オブジェクトはその親を使用してアクセスできません。 HTML Web リソースは、フォームに読み込まれたスクリプトに左右されないようにするために、HTML Web リソース内で必要とするライブラリを読み込む必要があります。
    • web リソース間のコードに含まれる参照は、ソリューションの依存関係として追跡されません。

また、Web リソースは オフライン アクセス対応 Microsoft Office Outlook 用 Dynamics 365 のユーザーのためにもダウンロードされるので、ユーザーはオフライン作業中に Web リソースのコンテンツにアクセスできます。

HTML Web リソースへのパラメーターの引き渡し

HTML Web リソースでは、次の表に示すパラメーターのみ受け取ることができます。

パラメーター Name 内容
typename エンティティ名 エンティティの名前。
種類 エンティティの種類コード 特定の組織内のエンティティを一意に識別する整数です。
ID オブジェクトの GUID レコードを表す GUID です。
orgname 組織名 組織の一意の名前です。
userlcid ユーザー言語コード 現在のユーザーが使用している言語コードの識別子です。
orglcid 組織言語コード 組織の基本言語を表す言語コードの識別子です。
data 任意のデータ パラメーター 渡すことのできる任意の値です。
formid フォーム ID フォーム ID を表す GUID です。
entrypoint エントリ ポイント 文字列値。 このパラメーターは、エンティティのユーザー定義のヘルプ コンテンツとして開かれる Web リソースにオプション値として渡されます。 有効にした場合、ユーザー定義のヘルプ URL は、「form」または「hierarchychart」のいずれかの値を含みます。
pagemode 社外秘。
セキュリティ 社外秘。
tabSet 社外秘。

data パラメーターの複数の値を渡すには、data パラメーターの値でパラメーターをエンコードしてから、スクリプトを使用して複数のパラメーターをデコードするロジックを HTML Web リソースに含める必要があります。 「サンプル: データ パラメーターを使用した Web リソースへの複数の値の引き渡し」トピックでは、複数のパラメーター値の引き渡しに対処する 1 つの方法を示しています。

関連項目

Dynamics 365 Customer Engagement (on-premises) の Web リソース
アクセス可能な Web リソースの作成
スタイルシート (CSS) ウェブ リソースを使用する
スクリプト (JScript) Web リソースの使用
データ (XML) Web リソースの使用
画像 (JPG、PNG、GIF、ICO) Web リソースの使用
スタイル シート (XSL) Web リソースの使用