Xrm.Page 개체 모델 사용
게시 날짜: 2017년 1월
적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
양식 스크립트를 작성하는 경우 다음 작업을 수행하는 Xrm.Page 네임스페이스의 개체와 상호 작용합니다.
특성 값을 가져오거나 설정합니다.
사용자 인터페이스 요소를 표시하고 숨깁니다.
특성 당 여러 개의 컨트롤을 참조합니다.
엔터티 당 여러 개의 양식에 액세스합니다.
양식 탐색 항목을 조작합니다.
비즈니스 프로세스 흐름 제어와 상호 작용합니다.
추가 예제는 양식 스크립팅 빠른 참조를 참조하십시오.
이 항목의 내용
Xrm.Page 개체 계층 구조
실행 컨텍스트
Collections(컬렉션)
개체 설명
특성
컨텍스트
컨트롤
엔터티
formSelector
탐색
프로세스
섹션
스테이지
단계
탭
Xrm.Page 개체 계층 구조
다음 그림과 같이 Xrm.Page는 다음 표에 설명된 세 가지 개체에 대한 네임스페이스 컨테이너를 제공합니다.
개체 |
설명 |
|---|---|
context |
조직, 사용자 또는 쿼리 문자열의 양식에 전달된 매개 변수에 대한 정보를 검색하는 메서드를 제공합니다. |
data |
양식은 물론 비즈니스 프로세스 흐름 제어에서 데이터를 관리하기 위해 엔터티 데이터와 메서드에 대한 액세스 권한을 제공합니다 |
ui |
양식의 여러 하위 구성 요소에 대한 컬렉션뿐만 아니라 사용자 인터페이스에 대한 정보를 검색하는 메서드가 포함되어 있습니다. |
.jpeg "Xrm.Page 개체 모델")
실행 컨텍스트
이벤트 처리기에 대한 함수를 등록하는 경우 첫 번째 매개 변수로 실행 컨텍스트 개체를 함수에 전달하는 옵션도 있습니다. 이 개체에는 다른 이벤트 처리기와 공유하려는 변수와 저장 이벤트를 관리할 수 있는 메서드가 포함되어 있습니다. 자세한 내용은 실행 컨텍스트(클라이언트 쪽 참조)과 이벤트 인수 저장(클라이언트 쪽 참조)을 참조하십시오.
Collections(컬렉션)
다음 표는 Xrm.Page 개체 모델 컬렉션에 대해 설명합니다. 컬렉션에서 사용할 수 있는 메서드에 대한 정보는 컬렉션(클라이언트 쪽 참조)을 참조하십시오.
징수 |
설명 |
|---|---|
attributes |
Xrm.Page.data.entity.attributes 컬렉션은 양식에서 사용할 수 있는 각 엔터티 특성에 대한 액세스를 제공합니다. 양식에 추가된 필드에 해당하는 특성만 사용할 수 있습니다. |
controls |
세 가지 개체에는 컨트롤 컬렉션이 포함되어 있습니다.
|
navigation.items |
Xrm.Page.ui.navigation.items 컬렉션은 양식 편집기의 탐색 영역을 사용하여 정의된 탐색 항목에 대한 액세스를 제공합니다.TechNet: 업데이트된 양식 양식의 경우 사용자는 명령 모음을 사용하여 이동합니다.TechNet: 기본 양식에서 양식의 왼쪽에 있습니다. |
formSelector.items |
엔터티에 대해 여러 개의 양식이 제공되면 보안 역할을 사용하여 각 양식에 연결할 수 있습니다. 사용자와 연결된 보안 역할을 통해 사용자가 여러 개의 양식을 볼 수 있을 경우 Xrm.Page.ui.formSelector.items 컬렉션은 해당 사용자가 사용할 수 있는 각 양식 정의에 대한 액세스를 제공합니다. |
tabs |
하나 이상의 탭을 사용하여 각 양식을 구성할 수 있습니다.Xrm.Page.ui.tabs 컬렉션은 이러한 각 탭에 대한 액세스를 제공합니다. |
sections |
하나 이상의 섹션을 사용하여 각 양식 탭을 구성할 수 있습니다. 탭 sections 컬렉션은 이러한 각 섹션에 대한 액세스를 제공합니다. |
비즈니스 프로세스 흐름 컬렉션
Xrm.Page.data.process 내의 스테이지와 단계에 대한 컬렉션은 동일한 컬렉션 구조를 기반으로 하지만 컬렉션에서 항목을 추가하거나 이동하는 것을 허용합니다.
프로세스.getStages 메서드를 사용하여 스테이지 컬렉션에 액세스합니다.스테이지.getSteps 메서드를 사용하여 단계 컬렉션에 액세스합니다.
개체 설명
각 개체는 여러 메서드를 담당하여 데이터를 가져오거나, 개체 속성을 가져오기 또는 설정하거나, 작업을 수행합니다.
특성
각 특성은 양식에 필드로 추가된 엔터티 특성에 해당합니다. 일반적으로 양식에 필드로 추가된 엔터티 특성만 사용할 수 있습니다. 필드의 각 인스턴스는 컨트롤입니다. 필드는 양식에 여러 번 추가할 수 있으며, 동일한 특성을 참조하는 컨트롤을 여러 개 만듭니다.
참고
복합 특성에는 특별한 동작이 있습니다.추가 정보:복합 특성에 대한 스크립트 작성
특성은 유형별로 분류됩니다.getAttributeType 메서드를 사용하여 특성의 유형을 확인할 수 있습니다.
모든 특성은 일반적인 메서드를 몇 개 공유하지만 특정 메서드는 특정 특성 유형에만 사용할 수 있습니다. 자세한 내용은 Xrm.Page.data.entity 특성(클라이언트 쪽 참조)을 참조하십시오.
참고
특성 유형 정보는 양식에서 특성의 동작을 나타냅니다. 응용 프로그램에 정의된 필드 유형 또는 AttributeMetadata 유형과 일치할 필요는 없습니다. 특정 필드 유형의 특성은 서식이 지정된 방법에 따라 다르게 동작할 수 있습니다.
다음 표에는 특성 스키마 유형 및 서식 옵션의 각 유형에 대해 기대하는 특성 유형 문자열 값이 나와 있습니다.
응용 프로그램 필드 유형 |
서식 옵션 |
특성 유형 |
|---|---|---|
통화 |
해당 없음 |
money |
날짜 및 시간 |
날짜 및 시간, 날짜만 |
datetime |
10진수 |
해당 없음 |
decimal |
부동 소수점 수 |
해당 없음 |
double |
조회 |
해당 없음 |
lookup |
여러 줄 텍스트 |
해당 없음 |
memo |
옵션 집합 |
해당 없음 |
optionset |
한 줄 텍스트 |
전자 메일, 텍스트, 주식 종목 코드, Url, 전화 |
string |
한 줄 텍스트 |
텍스트 영역 |
memo |
상태 |
해당 없음 |
optionset |
상태 설명 |
해당 없음 |
optionset |
두 개 옵션 |
라디오 단추 두 개, 확인란, 목록 |
boolean |
정수 |
없음, 기간 |
integer |
정수 |
언어, 표준 시간대 |
optionset |
컨텍스트
Xrm.Page.context는 조직, 사용자 또는 쿼리 문자열의 양식에 전달된 매개 변수에 대한 정보를 검색하는 메서드를 제공합니다. 자세한 내용은 클라이언트 쪽 컨텍스트(클라이언트 쪽 참조)을 참조하십시오.
컨트롤
양식에 있는 HTML 요소를 나타냅니다. 어떤 컨트롤은 특정 특성에 바인딩되어 있는 반면 다른 컨트롤은 양식에 추가된 IFRAME, 웹 리소스 또는 하위 표와 같은 컨트롤에 언바인딩되어 있다고 표시될 수 있습니다.
IFrame, 웹 리소스 및 하위 표 컨트롤에 대해 코드에서 특정 컨트롤 이름을 사용합니다. 이러한 컨트롤은 특성에 바인딩되지 않습니다. 컨트롤이 특성에 바인딩되어 있는 경우 코드에서 특정 컨트롤 이름을 포함하지 마십시오. 여러 컨트롤이 특성에 바인딩되면 런타임에 컨트롤 이름을 확인하며 컨트롤 이름은 양식에 있는 컨트롤 위치에 따라 다를 수 있습니다.
특성에 바인딩된 컨트롤과 관련된 대부분의 작업의 경우 특성 컨트롤 컬렉션을 사용하거나 섹션의 컨트롤 컬렉션을 통해 컨트롤에 액세스합니다. 이름으로 컨트롤을 참조하는 것보다 컬렉션의 컨텍스트에 따라 컨트롤에 대한 참조를 얻게 됩니다. 이 경우 이름은 중요하지 않습니다. 특성 특성에 바인딩되어 있는 모든 컨트롤에서 작업을 수행하기 위해 함수를 만드는 방법은 특성 제어에 대해 찾은 예제를 참조하십시오.
참고
복합 특성에는 특별한 동작이 있습니다.추가 정보:복합 특성에 대한 스크립트 작성.
참고
Microsoft Dynamics 365 외부의 대부분의 스크립트 개발 작업의 경우 개발자는 document.getElementById 메서드를 사용하여 페이지 요소를 참조하는 데 익숙해질 수 있습니다.Microsoft Dynamics 365 양식 스크립트의 경우 이 메서드는 지원되지 않습니다. 특성은 데이터를 저장하고 컨트롤은 단지 양식에서 특성을 보여 주는 방식임을 알고 있어야 합니다. 특성에 바인딩된 컨트롤의 경우 양식에서 데이터에 액세스하는 익숙한 방식을 조정해야 할 수 있습니다.
컨트롤은 유형별로 분류됩니다.51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getControlType 메서드를 사용하여 컨트롤의 유형을 확인할 수 있습니다. 특정 컨트롤 메서드는 특정 유형의 컨트롤에서만 사용할 수 있습니다. 예를 들어 51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_addOption 메서드는 옵션 집합으로 표시되는 컨트롤에서만 사용할 수 있습니다. 자세한 내용은 Xrm.Page.ui 컨트롤(클라이언트 쪽 참조)을 참조하십시오.
엔터티
Xrm.Page.data.entity는 메서드를 제공하여 페이지, save 메서드 및 양식에 포함된 모든 특성 모음에 표시된 레코드에 대한 특정 정보를 검색합니다. 자세한 내용은 Xrm.Page.data.entity(클라이언트 쪽 참조)을 참조하십시오.
formSelector
Xrm.Page.ui.formSelector에는 현재 사용자가 사용할 수 있는 양식을 쿼리하는 기능을 제공하는 항목 모음이 포함됩니다.bcf42b09-b672-4f4b-b866-ea7b24cc3ae0#BKMK_navigate 메서드를 사용하여 현재 양식을 닫고 다른 양식을 엽니다. 자세한 내용은 Xrm.Page.ui.formSelector 항목(클라이언트 쪽 참조)을 참조하십시오.
탐색
어떤 메서드도 포함되지 않습니다. 항목 모음을 통해 탐색 항목에 대한 액세스를 제공합니다.
프로세스
비즈니스 프로세스 흐름의 속성을 검색하는 메서드를 포함합니다.추가 정보:프로세스 메서드
섹션
섹션에는 섹션이 포함된 탭에 액세스할 뿐만 아니라 표시되는 방식을 관리하는 메서드가 포함되어 있습니다. 또한 섹션은 컨트롤 모음을 통해 섹션 내 컨트롤에 대한 액세스를 제공합니다.추가 정보:Xrm.Page.ui 섹션(클라이언트 쪽 참조)
스테이지
각 프로세스에는 프로세스 getStages 메서드를 사용하여 액세스할 수 있는 스테이지의 컬렉션이 있습니다.
한 스테이지는 활성 스테이지입니다.추가 정보:비즈니스 프로세스 흐름의 구조
단계
단계는 스테이지 동안 수집할 데이터의 개별 항목을 나타냅니다. 각 단계에는 스테이지 getSteps 메서드를 사용하여 액세스할 수 있는 단계의 컬렉션이 있습니다.추가 정보:비즈니스 프로세스 흐름의 구조
특수 접두어 “header_process_<컨트롤 이름>”을 사용하여 컨트롤 이름을 참조하여 비즈니스 프로세스 흐름 제어의 활성 단계 내에서 단계 컨트롤에 액세스할 수 있습니다. 예를 들어 purchaseprocess 특성을 나타내는 단계를 숨기려면 다음을 사용합니다.
Xrm.Page.getControl("header_process_purchaseprocess").setVisible(false);
탭
탭은 페이지에서 섹션의 그룹입니다. 여기에는 탭의 제시 방식을 변경하는 메서드가 포함되어 있습니다. 섹션 모음을 통해 탭의 섹션에 액세스합니다. 자세한 내용은 Xrm.Page.ui 탭(클라이언트 쪽 참조)을 참조하십시오.
참고 항목
양식 스크립팅 빠른 참조
휴대폰 및 태블릿용 Dynamics 365에 대한 스크립트 작성 및 디버깅
Microsoft Dynamics 365 양식용 코드 작성
복합 특성에 대한 스크립트 작성
비즈니스 프로세스 흐름에 대한 스크립트 작성
Microsoft Dynamics 365에서 JavaScript 사용
클라이언트 쪽 프로그래밍 참조
클라이언트 쪽 프로그래밍 참조
Microsoft Dynamics 365용 JavaScript 라이브러리
엔터티 양식 사용자 지정
Microsoft Dynamics 365
© 2017 Microsoft. All rights reserved. 저작권 정보