共用方式為

GetGlobalContext 函數和 ClientGlobalContext.js.aspx (用戶端參考)

  • 發行項

 

發行︰ 2017年1月

適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

使用 Web 資源，以程式設計方式存取權內容資訊時，請使用 GetGlobalContext 函數。 若要在 HTML Web 資源中取得 GetGlobalContext 函數，請包含 ClientGlobalContext.js.aspx 的參照。

GetGlobalContext 函數

GetGlobalContext 功能會傳回 Xrm.Page.context 中找到的相同內容物件。

當您在表單外需要內容資訊，請在 HTML Web 資源中包含 ClientGlobalContext.js.aspx 頁面的參照。

下列範例中，函數會傳回內容物件，不論在表單指令碼中使用或指令碼與 HTML Web 資源搭配使用。

function _getContext() {
 var errorMessage = "Context is not available.";
 if (typeof GetGlobalContext != "undefined")
 { return GetGlobalContext(); }
 else
 {
  if (typeof Xrm != "undefined") {
   return Xrm.Page.context;
  }
  else { throw new Error(errorMessage); }
 }
}

ClientGlobalContext.js.aspx

包含 ClientGlobalContext.js.aspx 頁面的參照時 (檔案位於 Web 資源目錄的根)，可以使用 GetGlobalContext 函數。

注意

如果 HTML Web 資源名稱中不使用反斜線字元模擬資料夾結構，使用此指令碼元素，您可以在頁面中包含此指令碼：<script type="text/javascript" src="ClientGlobalContext.js.aspx"></script>

如果 HTML Web 資源名稱中使用反斜線字元模擬目錄結構，您必須在指令碼元素中反映它。 下列範例適用於名稱為「sdk_/Contoso.htm」的 HTML Web 資源、名稱為「sdk_/Scripts/ContosoScript.js」的 JavaScript Web 資源，以及名稱為「sdk_/Styles/ContosoStyles.css」的 CSS 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 根資料夾的相對路徑，例如，/WebResources/ClientGlobalContext.js.aspx，因為在多組織用戶共享環境中，它可能會造成頁面遺失組織內容。

ClientGlobalContext.js.aspx 頁面包含一些全域事件處理常式。 這些事件處理常式會取消 onselectstart、contextmenu 和 ondragstart 事件。

另請參閱

用戶端程式設計參考
用戶端內容 (用戶端參考)
執行內容 (用戶端參考)
表單指令碼快速參考
撰寫 Microsoft Dynamics 365 表單的程式碼
使用 Xrm.Page 物件模型

Microsoft Dynamics 365

© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權