다음을 통해 공유

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

  • 아티클

 

게시 날짜: 2017년 1월

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

Xrm.Page.ui에는 양식의 여러 하위 구성 요소에 대한 컬렉션뿐만 아니라 사용자 인터페이스에 대한 정보를 검색하는 속성 및 메서드가 포함되어 있습니다.

Xrm.Page.ui 속성 및 메서드

  • 닫기
    양식을 닫는 메서드입니다.

  • 제어
    페이지에 있는 모든 컨트롤의 컬렉션입니다.

  • formSelector
    formSelector.getCurrentItem 메서드를 사용하여 현재 사용 중인 양식과 사용자가 사용할 수 있는 모든 양식에 대한 정보가 포함되어 있는 formSelector.items 컬렉션에 대한 정보를 검색합니다.

  • getCurrentControl
    양식의 현재 포커스가 있는 컨트롤 개체를 가져오는 메서드입니다.

    참고

    이 메서드는 Microsoft Dynamics CRM 2013 업데이트 롤업 2에서 더 이상 사용되지 않습니다.

  • getFormType
    레코드에 대한 양식 컨텍스트를 가져오는 메서드입니다.

  • navigation.items
    페이지에 있는 모든 탐색 항목의 컬렉션입니다.

  • 양식 알림
    setFormNotification를 사용하여 양식 수준 알림을 표시하고 clearFormNotification를 사용하여 알림을 제거합니다.

  • quickForms
    페이지에 있는 모든 빠른 보기 컨트롤의 컬렉션입니다.

  • refreshRibbon
    표시되는 내용을 제어하는 데이터를 리본이 다시 평가하도록 만드는 메서드입니다.

  • 탭
    페이지에 있는 모든 탭의 컬렉션입니다.

  • 뷰포트 메서드
    ViewPort는 양식 데이터를 포함하는 데이터의 영역입니다. 양식의 본문에 해당하며 페이지의 탐색, 머리글, 바닥글 또는 양식 길잡이 영역은 포함하지 않습니다.getViewPortHeight 및 getViewPortWidth 메서드를 사용하여 ViewPort의 현재 크기를 가져옵니다.

닫기

양식을 닫는 메서드입니다.

Xrm.Page.ui.close()

설명:

HTML Window.close 메서드는 표시되지 않습니다. 양식 창을 닫으려면 이 메서드를 사용해야 합니다. 양식에 저장하지 않은 변경 내용이 있는 경우 창을 닫기 전에 변경 내용을 저장할지 여부를 묻는 메시지가 표시됩니다.

태블릿용 Microsoft Dynamics 365를 사용하면 이 메서드는 뒤로 탐색 단추의 동작을 모방합니다.

제어

페이지에 있는 모든 컨트롤의 컬렉션입니다.

컬렉션 메서드에 대한 정보를 컬렉션(클라이언트 쪽 참조)를 참조하고 컬렉션에 있는 컨트롤 개체에 대한 정보는 Xrm.Page.ui 컨트롤(클라이언트 쪽 참조)를 참조하십시오.

formSelector

formSelector.getCurrentItem 메서드를 사용하여 현재 사용 중인 양식과 사용자가 사용할 수 있는 모든 양식에 대한 정보가 포함되어 있는 formSelector.items 컬렉션에 대한 정보를 검색합니다.

참고

formSelectoritems 집합은 존재하지 않으며 formSelector.getCurrentItem 메서드는 Dynamics 365 모바일 클라이언트(휴대폰 및 태블릿), 그리고 대화식 서비스 허브에는 지원되지 않습니다.

formSelector.getCurrentItem

현재 표시되는 양식에 대한 참조를 반환하는 메서드입니다.

참고

한 양식만 사용할 수 있을 때는 이 메서드는 null를 반환합니다.

  • 반환 값
    유형:개체

formSelector.items

현재 사용자에 액세스할 수 있는 모든 양식 항목의 컬렉션입니다.

참고

이 컬렉션에서는 사용자의 보안 역할과 연결을 공유하는 양식만 사용할 수 있습니다.

컬렉션 메서드에 대한 정보를 컬렉션(클라이언트 쪽 참조)를 참조하고 컬렉션에 있는 항목에 대한 정보는 Xrm.Page.ui.formSelector 항목(클라이언트 쪽 참조)를 참조하십시오.

getCurrentControl

양식의 현재 포커스가 있는 컨트롤 개체를 가져오는 메서드입니다. 웹 리소스와 IFRAME 컨트롤은 이 메서드에서 반환되지 않습니다.

참고

이 메서드는 Microsoft Dynamics CRM 2013 업데이트 롤업 2에서 더 이상 사용되지 않습니다.

이 메서드는 사용자가 마지막 편집한 필드가 라디오 단추 또는 확인란 컨트롤로 서식이 지정된 부울 특성일 때 현재 컨트롤에 대한 참조를 반환하지 않습니다. 또한 이 메서드는 Xrm.Page.ui 컨트롤 setFocus 메서드를 사용한 직후 참조를 반환하지 못합니다.

Xrm.Page.ui.getCurrentControl()
  • 반환 값
    유형:개체

getFormType

레코드에 대한 양식 컨텍스트를 가져오는 메서드입니다.

Xrm.Page.ui.getFormType()

  • 반환 값
    유형:숫자

    다음 표는 반환 값에 해당하는 양식 유형을 나열합니다.

    값

    양식 유형

    0

    정의되지 않음

    1

    만들기

    2

    업데이트

    3

    읽기 전용

    4

    사용 안 함

    6

    대량 편집

    참고

    빨리 만들기 양식은 1을 반환합니다. 값 5는 제거된 빨리 만들기의 이전 유형에 사용되었습니다.

페이지에 있는 모든 탐색 항목의 컬렉션입니다.

참고

이 컬렉션은 태블릿용 Microsoft Dynamics 365에 없습니다.

컬렉션 메서드에 대한 정보를 컬렉션(클라이언트 쪽 참조)를 참조하고 컬렉션에 있는 항목에 대한 정보는 Xrm.Page.ui.navigation 항목(클라이언트 쪽 참조)를 참조하십시오.

양식 알림

setFormNotification를 사용하여 양식 수준 알림을 표시하고 clearFormNotification를 사용하여 알림을 제거합니다.

clearFormNotification

양식 수준 알림을 제거하려면 이 메서드를 사용합니다.

Xrm.Page.ui.clearFormNotification(uniqueId)

  • 매개 변수

    • uniqueId
      유형: 문자열. 알림을 설정하기 위해 setFormNotification와 함께 사용된 메시지에 대한 고유 식별자입니다.

  • 반환 값
    유형: 부울. 메서드가 성공하면 True이고, 그렇지 않으면 false입니다.

  • 설명
    이 메서드는 업데이트된 엔터티에만 사용할 수 있습니다.

setFormNotification

양식 수준 알림을 표시하려면 이 메서드를 사용합니다. 알림의 개수를 표시하고 clearFormNotification를 사용하여 제거될 때까지 표시됩니다. 알림 영역의 높이는 제한이 있으므로 새 메시지는 맨 위에 추가됩니다. 아래로 스크롤하여 아직 제거되지 않은 이전 메시지를 볼 수 있습니다.

Xrm.Page.ui.setFormNotification(message, level, uniqueId);

  • 매개 변수

    • message
      유형: 문자열. 메시지의 텍스트입니다.

    • level
      유형: 문자열. 메시지의 수준입니다.

      수준은 메시지를 표시하는 방법을 정의합니다.

      • ERROR: 알림은 시스템 오류 아이콘을 사용합니다.

      • WARNING: 알림은 시스템 경고 아이콘을 사용합니다.

      • INFO: 알림은 시스템 정보 아이콘을 사용합니다.

    • uniqueId
      유형: 문자열. 알림을 제거하기 위해 clearFormNotification와 함께 사용된 메시지에 대한 고유 식별자입니다.

  • 반환 값
    유형: 부울. 메서드가 성공하면 True이고, 그렇지 않으면 false입니다.

  • 설명
    이 메서드는 업데이트된 엔터티에만 사용할 수 있습니다.

quickForms

새 양식 렌더링 엔진("터보 양식"이라고도 함)을 사용하는 양식의 모든 빠른 보기 컨트롤 컬렉션입니다. 이 컬렉션에 대해 지원되는 메서드 및 속성과 컬렉션 내의 개체에 대한 정보는 Xrm.Page.ui quickForms(클라이언트 쪽 참조) 참조

refreshRibbon

표시되는 내용을 제어하는 데이터를 리본이 다시 평가하도록 만드는 메서드입니다.

Xrm.Page.ui.refreshRibbon()

  • 반환 값
    유형: 없음

    설명: 이 함수는 일반적으로 리본 <EnableRule> (RibbonDiffXml)이 양식에 있는 값에 따라 달라질 때 사용됩니다. 코드가 규칙에서 사용하는 값을 변경한 후 이 메서드를 사용하여 규칙을 적용할 수 있도록 리본이 양식에 있는 데이터를 강제로 다시 평가하도록 합니다.

탭

페이지에 있는 모든 탭의 컬렉션입니다.

컬렉션 메서드에 대한 정보를 컬렉션(클라이언트 쪽 참조)를 참조하고 컬렉션에 있는 항목에 대한 정보는 Xrm.Page.ui 탭(클라이언트 쪽 참조)를 참조하십시오.

뷰포트 메서드

ViewPort는 양식 데이터를 포함하는 데이터의 영역입니다. 양식의 본문에 해당하며 페이지의 탐색, 머리글, 바닥글 또는 양식 길잡이 영역은 포함하지 않습니다.getViewPortHeight 및 getViewPortWidth 메서드를 사용하여 ViewPort의 현재 크기를 가져옵니다.

참고

이러한 메서드는 태블릿용 Microsoft Dynamics 365에서 작동하지 않습니다.

getViewPortHeight

뷰포트의 높이를 픽셀 단위로 가져오는 메서드입니다.

Xrm.Page.ui.getViewPortHeight()
  • 반환 값
    유형:숫자

getViewPortWidth

뷰포트의 너비를 픽셀 단위로 가져오는 메서드입니다.

Xrm.Page.ui.getViewPortWidth()
  • 반환 값
    유형:숫자

참고 항목

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

Microsoft Dynamics 365

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