다음을 통해 공유

GetGlobalContext 함수 및 ClientGlobalContext.js.aspx(클라이언트 쪽 참조)

  • 아티클

 

게시 날짜: 2017년 1월

적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

컨텍스트 정보에 액세스하기 위한 웹 리소스를 프로그래밍할 때는 GetGlobalContext 함수를 사용합니다. HTML 웹 리소스에서 GetGlobalContext 함수를 가져오려면 ClientGlobalContext.js.aspx에 대한 참조를 포함합니다.

GetGlobalContext 함수

GetGlobalContext 함수는 Xrm.Page.context에 있는 것과 동일한 컨텍스트 개체를 반환합니다.

양식 외부에서 컨텍스트 정보가 필요하면 HTML 웹 리소스에 있는 ClientGlobalContext.js.aspx 페이지에 대한 참조를 포함합니다.

다음 예제에서는 양식 스크립트 또는 HTML 웹 리소스와 함께 사용하는 스크립트에서 사용할 때 컨텍스트 개체를 반환하도록 설계된 함수를 보여줍니다.

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 페이지에 대한 참조를 포함할 때는 GetGlobalContext 함수를 사용할 수 있습니다.

참고

폴더 구조를 시뮬레이션하기 위해 HTML 웹 리소스 이름에서 백슬래시 문자를 사용하지 않는 경우 <script type="text/javascript" src="ClientGlobalContext.js.aspx"></script> 스크립트 요소를 사용하여 페이지에 이 스크립트를 포함할 수 있습니다.

디렉터리 구조를 시뮬레이션하기 위해 HTML 웹 리소스 이름에서 백슬래시 문자를 사용하는 경우 스크립트 요소에 이를 반영해야 합니다. 다음 예제는 ‘sdk_/Contoso.htm’이라는 HTML 웹 리소스 및 ‘sdk_/Styles/ContosoStyles.css’라는 CSS 웹 리소스를 가진 ‘sdk_/Scripts/ContosoScript.js’라는 JavaScript 웹 리소스에 대한 것입니다.

<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. All rights reserved. 저작권 정보