Webpage (HTML) の Web リソース

  • [アーティクル]

 

公開日: 2017年1月

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

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

このトピックの内容

HTML web リソースの機能

HTML web リソースの制限

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

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

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 xmlns="http://www.w3.org/1999/xhtml">
<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 リソース ファイルの種類を使用する一連の関連ファイルを Microsoft Dynamics 365 外で作成できます。 常に相対パスを使用し、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.htmHTML 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 用 Microsoft Dynamics 365 のユーザーのためにもダウンロードされるので、ユーザーはオフライン作業中に Web リソースのコンテンツにアクセスできます。

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

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

パラメーター

名前

説明

typename

エンティティ名

エンティティの名前。

type

エンティティの種類コード

特定の組織内のエンティティを一意に識別する整数です。

id

オブジェクトの GUID

レコードを表す GUID です。

orgname

組織名

組織の一意の名前です。

userlcid

ユーザー言語コード

現在のユーザーが使用している言語コードの識別子です。

orglcid

組織言語コード

組織の基本言語を表す言語コードの識別子です。

data

任意のデータ パラメーター

渡すことのできる任意の値です。

formid

フォーム ID

フォーム ID を表す GUID です。

entrypoint

エントリ ポイント

文字列値。 このパラメーターは、エンティティのユーザー定義のヘルプ コンテンツとして開かれる Web リソースにオプション値として渡されます。 有効にした場合、ユーザー定義のヘルプ URL には、formまたはhierarchychartのいずれかの値が含まれます。詳細:ユーザー定義のヘルプの内容を追加する

pagemode

内部のみで使用

セキュリティ

内部のみで使用

tabSet

内部のみで使用

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

関連項目

Microsoft Dynamics 365 の Web リソース
アクセス可能な Web リソースの作成
CSS Web リソース
スクリプト (JScript) Web リソース
データ (XML) Web リソース
画像 (JPG、PNG、GIF、ICO) の Web リソース
Silverlight (XAP) の Web リソース
スタイルシート (XSL) Web リソース

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 著作権