GetGlobalContext 関数および ClientGlobalContext.js.aspx (クライアント API 参照)

  • [アーティクル]

特定のクライアント、組織、または モデル駆動型アプリ インスタンスのユーザーなどへのグローバル コンテキスト情報に対するアクセス権を取得するために、Web リソース でプログラミングをするときは、GetGlobalContext 関数を使用します。

HTML Web リソース内の GetGlobalContext 関数に対するアクセス権を取得するには、ClientGlobalContext.js.aspx への参照を含めます。

重要

ClientGlobalContext.js.aspx への参照を含めても Xrm オブジェクトは HTML Web リソースでは利用可能になりません。 したがって、Xrm.* メソッドを含むスクリプトは HTML Web リソースではサポートされません。 parent.Xrm.* は、HTML Web リソースがフォーム コンテナーに読み込まれた場合に機能します。 ただし、それ以外の場所では (たとえば、HTML Web リソースを SiteMap の一部として読み込んだ場合など)、parent.Xrm.* も機能しません。

GetGlobalContext 関数

GetGlobalContext 関数は Xrm.Utility.getGlobalContext メソッドが戻すのと同じコンテキスト オブジェクトを戻します。これは、そのコンテキスト オブジェクトに Xrm.Utility.getGlobalContext で利用可能なものと同じプロパティおよびメソッドがあることを意味します。 詳細: Xrm.Utility.getGlobalContext

ClientGlobalContext.js.aspx

GetGlobalContext 関数を使用することができるようにするには、Web リソース ディレクトリのルートにある ClientGlobalContext.js.aspx ページへの参照を含める必要があります。

  • HTML Web リソース名でスラッシュ文字を使用してフォルダー構造をシミュレートしていない場合は、このスクリプトを直接参照して含めることができます。 たとえば、次のようになります。

    <head>
  <title>HTML Web Resource</title>
  <script src="ClientGlobalContext.js.aspx" type="text/javascript" ></script>

</head>

  • ディレクトリ構造をシミュレートするために HTML Web リソース名にバックスラッシュ文字を使用している場合、スクリプト要素にこれを反映する必要があります。 以下は、sdk_/Styles/ContosoStyles.css という名前の CSS Web リソースを使用する、sdk_/Contoso.htm と呼ばれる HTML Web リソースおよび sdk_/Scripts/ContosoScript.js と呼ばれる JavaScript Web リソースの例です。

    <head>
  <title>HTML Web Resource</title>
  <script src="../ClientGlobalContext.js.aspx" type="text/javascript" ></script>

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

注意

/WebResources/ClientGlobalContext.js.aspx などのルート WebResources フォルダーを含む相対パスを使用することは推奨されません。マルチ テナント環境ではページから組織コンテンツが失われる可能性があります。

ClientGlobalContext.js.aspx ページには一部のグローバル イベント ハンドラーが含まれます。 これらのイベント ハンドラーは、onselectstart、contextmenu、および ondragstartイベントをキャンセルします。

Xrm.Utility.getGlobalContext
クライアント API オブジェクト モデルについて
モデル駆動型アプリのための Web リソース

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。