Xrm.Page.ui quickForms(클라이언트 쪽 참조)

아티클
04/18/2017

게시 날짜: 2017년 1월

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

Xrm.Page.ui.quickForms 모음은 새로운 양식 렌더링 엔진("터보 양식"이라고도 함)을 사용할 때 Microsoft Dynamics 365 양식에서 모든 빠른 보기 컨트롤과 구성 컨트롤에 액세스하는 메서드를 제공합니다. 빠른 보기 컨트롤은 기본 양식의 관련 엔터티에 대한 정보를 볼 수 있게 하기 위해 Microsoft Dynamics 365의 기본 양식에 추가된 빠른 보기 양식입니다. 빠른 보기 컨트롤의 구성 컨트롤의 데이터는 편집할 수 없습니다. 빠른 보기 컨트롤과 빠른 보기 양식에 대한 자세한 내용은 TechNet: 빠른 보기 양식 만들기 및 편집 참조

참고

이 기능은 CRM Online 2016 업데이트 1 및 CRM 2016 서비스 팩 1(온-프레미스)에서 소개되었습니다.

이 항목은 Dynamics 365에 새 양식 렌더링 엔진을 사용할 경우에만 적용 가능합니다.Dynamics 365에 레거시 양식 렌더링("양식을 새로 고침"이라고도 함)을 사용하는 경우 표준 컨트롤 개체를 사용하여 빠른 보기 컨트롤 및 해당 구성 컨트롤에 액세스할 수 있습니다. Xrm.Page.ui 컨트롤(클라이언트 쪽 참조)을 참고하십시오.

중요

Dynamics 365의 레거시 양식에 대한 중단이 발표되었을 때 레거시 양식 렌더링을 사용하는 경우 즉시 새 양식 렌더링 엔진을 사용하도록 해야 합니다. 레거시의 빠른 보기 컨트롤에 액세스하는 방법과 새로운 양식 렌더링이 다르기 때문에 새 양식 엔진으로 전환했을 때 이 항목에 기술된 메서드를 사용하기 위해 빠른 보기 컨트롤을 대상으로 기존 코드를 업데이트하고 테스트해야 합니다. 레거시 양식 렌더링의 사용 중단에 대한 자세한 내용은 레거시 양식 렌더링 옵션 제거을 참조하십시오.

이 항목의 내용

quickForms 모음 메서드

quickForms 개체 메서드

quickForms 모음 메서드

quickForms 모음은 양식에 있는 모든 빠른 보기 컨트롤에 대한 액세스를 제공합니다.quickForms 모음은 Dynamics 365의 모든 표준 메서드의 모음을 지원합니다.컬렉션(클라이언트 쪽 참조) 참조

다음 예제에서는 9b85e46f-ca6e-4313-af04-4290e3c6ab8b#BKMK_get 메서드를 사용하여 빠른 보기 컨트롤 인스턴스의 인덱스 값(정수) 또는 이름(문자열)를 인수로 지정하여 quickForms 모음의 빠른 보기 컨트롤 인스턴스를 검색하는 방법을 설명합니다.

quickViewControl = Xrm.Page.ui.quickForms.get(arg)

quickForms 개체 메서드

quickForms 개체는 빠른 보기 컨트롤 인스턴스를 나타냅니다. 양식에서 빠른 보기 컨트롤 인스턴스에 대해 다음 메서드를 사용할 수 있습니다.

getControl
getControlType
getName
getParent
getVisible
레이블 메서드
isLoaded
새로 고침

getControl

빠른 보기 컨트롤의 구성 컨트롤을 가져옵니다.

quickViewControl.getControl()

빠른 보기 컨트롤의 구성 요소 컨트롤의 이름 또는 인덱스 값으로 인수를 전달하여 구성 요소 컨트롤 모음의 단일 컨트롤에 액세스할 수 있습니다. 예: quickViewControl.getControl("firstname") 또는 quickViewControl.getControl(0)

반환 값
유형: 인수 없이 메서드를 사용할 때 개체 모음. 또는 인수로 메서드를 사용할 때 개체.
설명
빠른 보기 컨트롤에 구성 컨트롤을 검색한 다음 구성 컨트롤 데이터를 변경하지 않는 구성 컨트롤의 Dynamics 365 컨트롤에 대해 지원되는 메서드 중 하나를 사용할 수 있습니다. 빠른 보기 컨트롤의 구성 컨트롤이 읽기 전용이기 때문입니다. 예를 들어, quickViewControl.getControl(0).getAttribute()를 사용할 수 있습니다. Dynamics 365 컨트롤에 대해 지원되는 메서드에 대한 자세한 내용은 Xrm.Page.ui 컨트롤(클라이언트 쪽 참조)을 참조 하십시오.

중요

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getAttribute 또는 구성 컨트롤의 데이터 관련 메서드는 기본 양식이 로드될 때 이에 바인딩하는 빠른 보기 양식이 완전히 로드되지 않았기 때문에 기본 양식f451f339-bcee-4260-9904-abc8c0efa153#BKMK_OnloadEvent에서 작동하지 않을 수도 있습니다. 바인딩된 빠른 보기 양식이 완전히 로드되었는지 확인할 수 있도록 하려면 빠른 보기 컨트롤 인스턴스에 대해 isLoaded 메서드를 사용해야 합니다. 추가 정보: isLoaded

또한, 새 양식 렌더링 엔진을 사용하여 양식의 빠른 보기 컨트롤의 구성 요소 컨트롤을 검색하는 방법은 레거시 양식에 따라 다릅니다. 따라서 레거시 양식을 사용하고 빨리 보기 컨트롤의 구성 요소 컨트롤을 대상으로 하는 코드의 경우 Dynamics 365의 새 양식 렌더링 엔진을 사용할지 결정할 때 코드를 업데이트해야 합니다.

getControlType

빠른 보기 컨트롤을 분류하는 문자열 값을 반환합니다.

quickViewControl.getControlType()

빠른 보기 컨트롤의 경우, 메서드는 quickform을 반환합니다.

빠른 보기 컨트롤의 구성 요소 컨트롤의 경우, 메서드는 컨트롤의 실제 범주를 반환합니다. 가능한 반환 값에 대한 자세한 내용은 51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getControlType을 참조하십시오.

getName

빠른 보기 컨트롤에 할당된 이름을 반환합니다.

quickViewControl.getName()

반환 값
유형: 문자열. 빠른 보기 컨트롤의 이름입니다.

getParent

컨트롤이 들어 있는 섹션 개체에 대한 참조를 반환합니다.

컨트롤 형식: 모두.

quickViewControl.getParent()

반환 값
유형:Xrm.Page.ui 섹션(클라이언트 쪽 참조) 개체.

getVisible

빠른 보기 컨트롤이 현재 표시되는지 여부를 나타내는 값을 반환합니다.

참고

이 컨트롤에 대한 포함하는 섹션 또는 탭이 표시되지 않는 경우 이 메서드는 계속 true를 반환할 수 있습니다. 컨트롤이 실제로 표시되는지 확인하려면 포함하는 요소의 가시성도 확인해야 합니다.

quickViewControl.getVisible()

반환 값
유형: 부울. 빠른 보기 컨트롤을 볼 수 있으면 True, 그렇지 않으면 false입니다.

레이블 메서드

getLabel 및 setLabel 메서드를 사용하여 빠른 보기 컨트롤에 대한 레이블을 가져오거나 변경합니다.

getLabel

빠른 보기 컨트롤의 레이블을 반환합니다.

quickViewControl.getLabel()

반환 값
유형: 문자열. 빠른 보기 컨트롤의 레이블입니다.

setLabel

빠른 보기 컨트롤의 레이블을 설정합니다.

quickViewControl.setLabel("label")

인수
유형: 문자열. 빠른 보기 컨트롤의 새 레이블입니다.

isLoaded

빠른 보기 컨트롤의 구성 요소 컨트롤에 대한 데이터 바인딩이 완전한지 여부를 반환합니다.

quickViewControl.isLoaded()

반환 값
유형: 부울. 구성 요소 컨트롤에 대한 데이터 바인딩이 완전하면 true고, 그렇지 않으면 false입니다.
설명
컨트롤이 바인딩되는 빠른 보기 양식이 완전히 로드되지 않아 빠른 보기 컨트롤의 구성 요소 컨트롤에 대한 데이터 바인딩이 기본 양식 f451f339-bcee-4260-9904-abc8c0efa153#BKMK_OnloadEvent에서 완전하지 않을 수 있습니다. 따라서 51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getAttribute 또는 구성 요소 컨트롤의 특정 데이터 관련 메서드가 작동하지 않을 수 있습니다. 빠른 보기 컨트롤에 대한 isLoaded 메서드를 사용하면 빠른 보기 컨트롤의 구성 요소 컨트롤에 대한 데이터 바인딩 상태를 확인할 수 있습니다.

다음 샘플 코드에서는 isLoaded 메서드를 사용하여 바인딩 상태를 확인하고 빠른 보기 컨트롤의 구성 요소 컨트롤에 바인딩된 특성의 값을 검색하는 방법에 대해 설명합니다.

function getAttributeValue() {
    var quickViewControl = Xrm.Page.ui.quickForms.get("<QuickViewControlName>");
    if (quickViewControl != undefined)
    {
        if (quickViewControl.isLoaded())
        {
            // Access the value of the attribute bound to the constituent control
            var myValue = quickViewControl.getControl(0).getAttribute().getValue();
            console.log(myValue);
            return;
        }
        else
        {
            // Wait for some time and check again
            setTimeout(getAttributeValue, 10);
        }
    }
    else
    {
        console.log("No data to display in the quick view control.");
        return;
    }    
}

새로 고침

빠른 보기 컨트롤에 표시되는 데이터를 새로 고칩니다.

quickViewControl.refresh()

참고 항목

클라이언트 쪽 프로그래밍 참조
양식 스크립팅 빠른 참조
Xrm.Page.ui(클라이언트 쪽 참조)
Xrm.Page.ui 컨트롤(클라이언트 쪽 참조)
Microsoft Dynamics 365 양식용 코드 작성
Xrm.Page 개체 모델 사용

Microsoft Dynamics 365

다음을 통해 공유

Xrm.Page.ui quickForms(클라이언트 쪽 참조)

이 항목의 내용

quickForms 모음 메서드

quickForms 개체 메서드

getControl

getControlType

getName

getParent

getVisible

레이블 메서드

getLabel

setLabel

isLoaded

새로 고침

참고 항목

추가 리소스