다음을 통해 공유

클라이언트 쪽 컨텍스트(클라이언트 쪽 참조)

  • 아티클

 

게시 날짜: 2016년 11월

적용 대상: Dynamics CRM 2015

코드는 많은 변수가 디자인 타임에 알려져 있지 않은 컨텍스트에서 작동해야 합니다. 컨텍스트 개체는 조직, 사용자 또는 페이지에 전달된 매개 변수에 대한 정보를 검색하는 메서드를 제공합니다.

컨텍스트 개체는 Xrm.Page.context를 참조하여 양식에서 사용할 수 있습니다.

양식 외부에서 실행되는 웹 리소스의 경우 GetGlobalContext 함수를 사용하여 컨텍스트 개체를 검색합니다.

컨텍스트 속성 및 메서드

  • 클라이언트
    어떤 클라이언트가 사용 중이고 클라이언트가 서버에 연결되었는지 여부, 어떤 종류의 장치를 사용 중인지 결정하는 데 사용할 수 있는 getClient, getClientState 및 getFormFactor 메서드에 대한 액세스를 제공합니다.

  • getClientUrl
    응용 프로그램에 액세스하는 데 사용한 기본 URL을 반환합니다.

  • getCurrentTheme
    사용자가 선택한 현재 Microsoft Office Outlook 테마를 나타내는 문자열을 반환합니다.

  • getIsAutoSaveEnabled
    조직에서 자동 저장을 사용하는지 여부를 반환합니다.

  • getOrgLcid
    조직의 기본 언어를 표시하는 언어 코드 식별자(LCID) 값을 반환합니다.

  • getOrgUniqueName
    조직의 이름에 고유한 텍스트 값을 반환합니다.

  • getQueryStringParameters
    페이지에 전달된 쿼리 문자열 인수를 나타내는 키 값 쌍의 사전 개체를 반환합니다.

  • getTimeZoneOffsetMinutes
    현지 시간과 표준 협정 세계시(UTC) 간의 차이를 반환합니다.

    이 메서드는 Microsoft Dynamics CRM Online 2015 업데이트 1에서 소개되었습니다.

  • getUserId
    현재 사용자에 대한 SystemUser.Id 값의 GUID를 반환합니다.

  • getUserLcid
    사용자가 기본 설정 언어로 선택한 프로비전된 언어를 나타내는 LCID 값을 반환합니다.

  • getUserName
    현재 사용자의 이름을 반환합니다.

  • getUserRoles
    사용자가 연결된 각 보안 역할 또는 사용자가 연결된 팀의 GUID 값을 나타내는 문자열 배열을 반환합니다.

  • prependOrgName
    조직 이름을 지정된 경로에 추가합니다.

  • 제거된 메서드
    제거된 메서드는 사용되지 않거나 다른 메서드로 교체됩니다. 이러한 메서드를 스크립트에서 사용하지 않도록 해야 합니다.

    getAuthenticationHeader 및 getServerUrl 메서드는 Microsoft Dynamics CRM 2011에서 더 이상 사용되지 않으며 더 이상 Microsoft Dynamics CRM 2015 및 Microsoft Dynamics CRM Online 2015 업데이트에서 제공되지 않습니다.

    isOutlookClient 및 isOutlookOnline 메서드는 Microsoft Dynamics CRM 2013에서 더 이상 사용되지 않으며 더 이상 Microsoft Dynamics CRM 2015 및 Microsoft Dynamics CRM Online 2015 업데이트에서 제공되지 않습니다.

클라이언트

Microsoft Dynamics CRM 2013 및 Microsoft Dynamics CRM Online에서는 클라이언트에 대한 정보를 얻기 위해 getClient 및 getClientState 메서드를 포함하는 클라이언트 개체를 추가했습니다.

Microsoft Dynamics CRM Online 2015 업데이트 1에 getFormFactor 메서드가 추가되었습니다.

getClient

스크립트가 실행되는 클라이언트를 나타내는 값을 반환합니다.

context.client.getClient()

제거된 isOutlookClient 메서드 대신 이 메서드를 사용합니다.

  • 반환 값
    유형: 문자열

    반환된 값은 다음과 같습니다.

    클라이언트

    값

    브라우저

    웹

    Outlook

    Outlook

    휴대폰

    휴대폰

getClientState

제거된 isOutlookOnline 메서드 대신 이 메서드를 사용합니다.

클라이언트의 상태를 나타내는 값을 반환합니다.

context.client.getClientState()

  • 반환 값
    유형: 문자열

    가능한 값은 다음과 같습니다.

    클라이언트

    반환된 값

    웹, Outlook, 휴대폰

    온라인

    Outlook, 모바일

    오프라인

getFormFactor

이 메서드를 사용하여 사용 중인 장치 종류에 대한 정보를 얻습니다.

context.client.getFormFactor()

  • 반환 값
    유형: 숫자

    가능한 값은 다음과 같습니다.

    값

    양식 요소

    0

    알 수 없음

    1

    데스크톱

    2

    태블릿

    3

    전화

  • 설명
    이 메서드는 Microsoft Dynamics CRM Online 2015 업데이트 1에서 소개되었습니다.

getClientUrl

응용 프로그램에 액세스하는 데 사용한 기본 URL을 반환합니다.

context.getClientUrl()

제거된 getServerUrl 메서드 대신 이 메서드를 사용합니다.

반환된 값은 다음 표에 나열된 것과 비슷합니다.

클라이언트

값

Microsoft Dynamics CRM(온-프레미스)

http(s)://server/org

Microsoft Dynamics CRM Online

https://org.crm.dynamics.com

오프 라인일 때 Outlook용 Microsoft Dynamics CRM(오프라인 액세스 가능)

https://localhost:2525
  • 반환 값
    유형: 문자열

getCurrentTheme

사용자가 선택한 현재 Microsoft Office Outlook 테마를 나타내는 문자열을 반환합니다.

참고

이 함수는 태블릿용 Microsoft Dynamics CRM에서 작동하지 않습니다.

context.getCurrentTheme()
  • 반환 값
    유형: 문자열

이 정보를 사용하여 Outlook용 Microsoft Dynamics CRM에서 보았을 때 HTML 및 Silverlight 웹 리소스에 적합한 테마를 선택합니다. 다음 표는 이 메서드에서 반환될 수 있는 값을 나열합니다.

참고

양식은 Microsoft Office 테마의 변경 내용에 적용되지 않으므로 Microsoft Office 테마에 적용할 수 있는 유일한 경우는 HTML 웹 리소스를 사용하여 탐색에서 페이지를 표시할 때입니다. 이 시나리오에서도 시각적 차이를 감지하기 어려울 수 있습니다.

값

테마

기본값

Microsoft Dynamics 365 웹 응용 프로그램

Office12Blue

Outlook용 Microsoft Dynamics CRM2007 또는 2010 블루 테마

Office14Silver

Outlook용 Microsoft Dynamics CRM2007 또는 2010 실버 또는 블랙 테마

getIsAutoSaveEnabled

이 메서드는 Microsoft Dynamics CRM 2015 및 Microsoft Dynamics CRM Online 2015 업데이트의 새로운 기능입니다.

조직에서 자동 저장을 사용하는지 여부를 반환합니다.

context.getIsAutoSaveEnabled()

  • 반환 값
    유형: 부울

    참고

    이 함수는 페이지를 열 때 설정된 값을 반환합니다. 이 값을 사용하여 코드를 테스트할 때 새 값을 가져오려면 값을 변경한 후에 페이지를 새로 고쳐야 합니다.

    추가 정보:TechNet: 자동 저장 관리

getOrgLcid

조직의 기본 언어를 표시하는 LCID 값을 반환합니다.

context.getOrgLcid()

  • 반환 값
    유형: 숫자

    예: 1033은 영어를 나타냅니다.유효한 로캘 ID 값은 LCID(로캘 ID) 차트에서 확인할 수 있습니다.

    1033

getOrgUniqueName

조직의 이름에 고유한 텍스트 값을 반환합니다.

context.getOrgUniqueName()

  • 반환 값
    유형: 문자열

    예: 조직 이름 값에 해당

    "adventureworkscycle"

getQueryStringParameters

페이지에 전달된 쿼리 문자열 인수를 나타내는 키 값 쌍의 사전 개체를 반환합니다.

context.getQueryStringParameters()
  • 반환 값
    유형: 개체

getTimeZoneOffsetMinutes

현지 시간과 표준 협정 세계시(UTC) 간의 차이를 반환합니다.

참고

이 메서드는 Microsoft Dynamics CRM Online 2015 업데이트 1에서 소개되었습니다.

context.getTimeZoneOffsetMinutes()
  • 반환 값
    유형: 숫자

getUserId

현재 사용자에 대한 SystemUser.Id 값의 GUID를 반환합니다.

context.getUserId()

  • 반환 값
    유형: 문자열

    예제:

    "{B05EC7CE-5D51-DF11-97E0-00155DB232D0}"

getUserLcid

사용자가 기본 설정 언어로 선택한 Microsoft Dynamics CRM언어 팩를 나타내는 LCID 값을 반환합니다.

context.getUserLcid()

  • 반환 값
    유형: 숫자

    예: 1041은 일본어를 나타냅니다.유효한 로캘 ID 값은 LCID(로캘 ID) 차트에서 확인할 수 있습니다.

    1041

getUserName

현재 사용자의 이름을 반환합니다.

context.getUserName()
  • 반환 값
    유형: 문자열

getUserRoles

사용자가 연결된 각 보안 역할 또는 사용자가 연결된 팀의 GUID 값을 나타내는 문자열 배열을 반환합니다.

보안 역할에 대한 자세한 내용은 Microsoft Dynamics CRM 2015의 엔터티에 대한 액세스를 제어하기 위해 역할 기반 보안을 사용할 수 있는 방법를 참조하십시오.

context.getUserRoles()

  • 반환 값
    종류: 배열

    예: 이 사용자는 자신의 사용자 계정에 연결된 보안 역할을 하나만 갖습니다. 단일 값을 갖는 이 배열의 JSON 표현:

    ["cf4cc7ce-5d51-df11-97e0-00155db232d0"]

prependOrgName

조직 이름을 지정된 경로에 추가합니다.

context.prependOrgName(sPath)

  • 인수
    유형: 문자열

    리소스에 대한 로컬 경로입니다.

  • 반환 값
    유형: 문자열

    반환된 값은 이 패턴을 따릅니다.

    "/"+ OrgName + sPath

제거된 메서드

제거된 메서드는 사용되지 않거나 다른 메서드로 교체됩니다. 이러한 메서드를 스크립트에서 사용하지 않도록 해야 합니다.

다음 메서드는 Microsoft Dynamics 365의 이전 버전에서 더 이상 사용되지 않으며 현재 버전에서 더 이상 제공되지 않습니다.

  • getAuthenticationHeader
    이 메서드는 더 이상 존재하지 않는 Microsoft Dynamics CRM 4.0 웹 서비스의 사용을 지원했습니다.

  • getServerUrl
    이 메서드는 getClientUrl로 대체되었습니다.

  • isOutlookClient
    이 메서드는 클라이언트.getClient로 대체되었습니다.

  • isOutlookOnline
    이 메서드는 클라이언트.getClientState로 대체되었습니다.

참고 항목

GetGlobalContext 함수 및 ClientGlobalContext.js.aspx(클라이언트 쪽 참조)
양식 스크립팅 빠른 참조
Microsoft Dynamics CRM 2015 양식용 코드 작성
Xrm.Page 개체 모델 사용
클라이언트 쪽 프로그래밍 참조

© 2017 Microsoft. All rights reserved. 저작권 정보