Webpage (HTML) の Web リソース
Web ページ (HTML) の Web リソースを使用して、クライアント拡張のためのユーザー インターフェイス要素を作成します。
HTML web リソースの機能
HTML Web リソースはユーザーのブラウザーにストリームされるので、ユーザーのブラウザーで表示される任意のコンテンツを含めることができます。
HTML web リソースの制限
サーバーで実行する必要のあるコードを HTML Web リソースに含めることはできません。 ASP.NET のページを HTML Web リソースとしてアップロードすることはできません。
HTML Web リソースでは、限られた数のクエリ文字列パラメーターのみ受け取ることができます。 HTML Web リソースへのパラメーターの引き渡し
フォームにコントロールとして埋め込まれた HTML ウェブリソースは、パフォーマンス上の理由で、フォームのランタイムによって再読み込みされる場合があります。 たとえば、タブのナビゲーション中にフォームのランタイムがコントロールを破棄して再初期化する場合があります。
HTML Web リソースでテキスト エディターを使用する
Web リソース フォームに付属のテキスト エディターは、非常に単純な HTML の編集に使用します。 高度な HTML ドキュメントの場合は、外部エディターでコードを編集し、参照ボタンを使用してファイルのコンテンツをアップロードする必要があります。
たとえば、スクリプトを使用してページのコンテンツを表示する複雑な HTML ページの先頭部分は次のようになります。
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://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 リソース ファイルの種類を使用する一連の関連ファイルをモデル駆動型アプリ外で作成できます。 常に相対パスを使用し、Web サイトのフォルダー構造を反映する一貫性のある命名規則を使用して各 Web リソースをインポートすると、Web リソースとしてインポートされた関連する CSS、JScript、イメージ、および Silverlight のファイルへのリンクが HTML Web リソースで維持されます。
たとえば、次の [フォルダー]/ファイル構造を使用する Web アプリケーション プロジェクトを作成するとします。
page.htm
[Styles]
- style.css
[Scripts]
- script.js
これらのファイルを Web リソースとしてインポートする場合、ソリューション発行者のカスタマイズの接頭辞は "new" で、次の方法で名前を付けることができます。
new_/page.htmnew_/Styles/style.cssnew_/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 リソースはオフライン アクセス対応 Dynamics 365 for Microsoft Office Outlook のユーザー用としてもダウンロードされるので、ユーザーはオフライン作業中に Web リソースのコンテンツにアクセスできます。
HTML Web リソースへのパラメーターの引き渡し
HTML Web リソースでは、次の表に示すパラメーターのみ受け取ることができます。
| パラメーター | 件名 | 内容 |
|---|---|---|
| typename | テーブル名 | テーブルの名前です。 |
| 種類 | テーブルの種類コード | 特定の組織内のテーブルを一意に識別する整数。 |
| ID | オブジェクトの GUID | レコードを表す GUID です。 |
| orgname | 組織名 | 組織の一意の名前です。 |
| userlcid | ユーザー言語コード | 現在のユーザーが使用している言語コードの識別子です。 |
| orglcid | 組織言語コード | 組織の基本言語を表す言語コードの識別子です。 |
| data | 任意のデータ パラメーター | 渡すことのできる任意の値です。 |
| formid | フォーム ID | フォーム ID を表す GUID です。 |
| entrypoint | エントリ ポイント | 文字列値。 このパラメーターは、テーブルのユーザー定義のヘルプ コンテンツとして開かれる Web リソースにオプション値として渡されます。 有効にした場合、ユーザー定義のヘルプ URL は、「form」または「hierarchychart」のいずれかの値を含みます。 |
| pagemode | 内部のみで使用 | |
| セキュリティ | 社外秘。 | |
| tabSet | 社外秘。 |
複数の値がデータ パラメーターで渡された場合、自動的にエンコードされます。 ロジックも、HTML Web リソースのスクリプトを使用して複数のパラメーターをデコードするために含める必要があります。 サンプル: データ パラメーターを使用した Web リソースへの複数の値の引き渡し トピックでは、複数のパラメーター値の引き渡しに対処する 1 つの方法を示しています。
注意
クエリ文字列に含まれるすべての文字が検証され、渡されるパラメーターの有効性が確認されます。 無効であることが判明したパラメーターがある場合、要求は失敗します。 たとえば、角かっこで囲まれたテキスト値を渡すと、無効なパラメーターの種類と見なされます。
参照
Web リソース
アクセス可能な Web リソースの作成
スタイル シート (CSS) Web リソースの使用
JavaScript Web リソースの使用
データ (XML) Web リソースの使用
画像 (JPG、PNG、GIF) Web リソースの使用
スタイル シート (XSL) Web リソースの使用
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示