하위 표를 위한 스크립트 작성

 

게시 날짜: 2017년 1월

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

하위 표에서 데이터를 로드할 때 스크립트를 실행하도록 이벤트 처리기를 설정할 수 있습니다. 이는 선택한 보기를 변경하고 표에 표시되는 데이터를 참조하는 방법을 제공합니다.

중요

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

이 항목의 내용

Subgrid OnLoad 이벤트

하위 표 개체 모델

Subgrid OnLoad 이벤트

하위 표는 양식에서 비동기적으로 로드되므로 양식 OnLoad 이벤트의 하위 표에 있는 데이터에 안정적으로 액세스할 수 없습니다. 하지만 하위 표의 OnLoad 이벤트에 대한 이벤트 처리기를 설정할 수 있습니다. 이 이벤트는 표의 데이터를 새로 고칠 때마다 발생하며 여기에는 사용자가 표의 열을 정렬할 때가 포함됩니다.

이 이벤트에 대해 새 이벤트 처리기를 추가할 사용자 인터페이스가 없으므로 이렇게 하려면 다른 이벤트, 일반적으로 양식 OnLoad 이벤트에 있는 코드를 사용하여 GridControl.addOnLoad 메서드를 사용해야 합니다. 이 이벤트에 대한 이벤트 처리기를 제거하려면 GridControl.removeOnLoad 메서드를 사용합니다.

하위 표 개체 모델

아래 다이어그램은 양식의 하위 표에서 액세스할 수 있는 개체를 보여 줍니다.

하위 표 컨트롤은 이 컨텍스트에서 GridControl라고 부릅니다.Xrm.Page.ui 컨트롤인 하위 표에는 refresh 메서드 외에 모든 컨트롤에 사용할 수 있는 모든 메서드가 있습니다.

GridControl는 SelectedControl 매개 변수가 선택될 때 사용할 수 있는 <CrmParameter> (RibbonDiffXml)를 사용하는 명령 모음 또는 리본 작업이나 규칙에 전달되는 동일한 개체입니다.

ViewSelector를 사용하여 보기 변경

하위 표가 보기 선택기를 표시하도록 구성되었을 때 현재 보기를 가져오거나 설정할 수 있습니다.GridControl.getViewSelector 메서드를 사용하여 보기 선택기에 액세스한 다음 ViewSelector.getCurrentViewgetCurrentView 및 ViewSelector.setCurrentView 메서드를 사용하여 조회 개체가 있는 현재 보기를 가져오거나 설정합니다.

표에서 데이터 가져오기

GridControl.getGrid 메서드를 사용하여 표에 액세스합니다.Grid.getRows 메서드 또는 Grid.getSelectedRows 메서드를 사용하여 GridRow 개체의 컬렉션을 가져옵니다. 그런 다음 GridRow.getData, GridRowData.getEntity 및 GridEntity.getEntityReference 메서드를 함께 변경하여 행에 있는 각 레코드에 대한 참조에 액세스할 수 있습니다.

참고 항목

표(읽기 전용) 개체 및 메서드(클라이언트 쪽 참조)
컬렉션(클라이언트 쪽 참조)
Microsoft Dynamics 365 양식용 코드 작성
클라이언트에서 Microsoft Dynamics 365 확장

Microsoft Dynamics 365

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