GetGlobalContext function and ClientGlobalContext.js.aspx (Client API reference)
Use the GetGlobalContext function when programming with web resources to gain access to the global context information such as the information specific to the client, organization or user for your model-driven apps instance.
To get access to the GetGlobalContext function in your HTML web resource, include a reference to ClientGlobalContext.js.aspx.
Important
Including a reference to ClientGlobalContext.js.aspx does not make the Xrm object available in HTML web resources. Therefore, scripts containing Xrm.*
methods aren't supported in HTML web resources. parent.Xrm.*
will work if the HTML web resource is loaded in a form container. However, for other places, such as loading an HTML web resource as part of the SiteMap, parent.Xrm.*
also won't work.
GetGlobalContext function
The GetGlobalContext function returns the same context object as returned by the Xrm.Utility.getGlobalContext method, which implies that the context object will have the same properties and methods as available for Xrm.Utility.getGlobalContext. More information: Xrm.Utility.getGlobalContext
ClientGlobalContext.js.aspx
You must include a reference to the ClientGlobalContext.js.aspx page located at the root of the web resources directory to be able to use the GetGlobalContext function.
If you are not using slash characters in HTML web resource names to simulate a folder structure, you can include this script by directly referring to it. For example:
<head> <title>HTML Web Resource</title> <script src="ClientGlobalContext.js.aspx" type="text/javascript" ></script> </head>
If you are using backslash characters in HTML web resource names to simulate a directory structure, you must reflect this in your script element. The following example is for an HTML web resource named sdk_/Contoso.htm and a JavaScript web resource named sdk_/Scripts/ContosoScript.js with a CSS web resource named sdk_/Styles/ContosoStyles.css.
<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>
Note
Using a relative path including the root WebResources folder, for example, /WebResources/ClientGlobalContext.js.aspx, is not recommended because it can cause the page to lose organization context in a multi-tenant environment.
The ClientGlobalContext.js.aspx page will include some global event handlers. These event handlers will cancel the onselectstart, contextmenu, and ondragstart events.
Related articles
Xrm.Utility.getGlobalContext
Understand Client API object model
Web resources for model-driven apps
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기