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

  • 아티클

 

게시 날짜: 2016년 11월

적용 대상: Dynamics CRM 2015

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

Xrm.Page.ui 속성 및 메서드

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

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

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

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

    참고

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

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

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

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

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

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

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

닫기

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

Xrm.Page.ui.close()

설명:

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

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

제어

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

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

formSelector

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

참고

formSelectoritems 컬렉션은 존재하지 않으며 formSelector.getCurrentItem 메서드는 태블릿용 Microsoft Dynamics CRM에서 작동하지 않습니다.

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

    사용 안 함

    5

    빨리 만들기(더 이상 사용되지 않음)

    6

    대량 편집

    11

    읽기 최적화됨(더 이상 사용되지 않음)

    참고

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

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

참고

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

컬렉션 메서드에 대한 정보를 컬렉션(클라이언트 쪽 참조)를 참조하고 컬렉션에 있는 항목에 대한 정보는 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입니다.

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

refreshRibbon

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

Xrm.Page.ui.refreshRibbon()

  • 반환 값
    유형: 없음

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

탭

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

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

뷰포트 메서드

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

참고

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

getViewPortHeight

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

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

getViewPortWidth

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

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

참고 항목

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

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