편집 가능한 표 개체 및 메서드(클라이언트 쪽 참조)
게시 날짜: 2017년 1월
적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
이벤트 처리기를 설정하여 편집 가능한 표에서 데이터가 선택, 변경, 저장될 때 편집 가능한 표가 트리거하는 이벤트를 구독할 수 있습니다. 편집 가능한 표는 편집 불가능한 표가 지원하는 클라이언트 쪽 메서드의 대부분을 지원합니다. 추가 정보: Dynamics 365에서 편집 가능한 표 사용
참고
편집 가능한 표는 Dynamics 365용 2016년 12월 업데이트(온라인 및 온-프레미스)에서 도입되었습니다.
이 항목의 내용
편집 가능한 표 이벤트
편집 가능한 표 메서드
편집 가능한 표 이벤트
편집 가능한 표는 클라이언트 쪽 스크립트를 등록하고 실행하는 데 사용할 수 있는 다음과 같은 이벤트를 지원합니다. 엔터티에 대해 편집 가능한 표 또는 읽기 전용 표를 활성화하는 데 사용되는 Microsoft Dynamics 365 페이지의 이벤트 탭을 사용하여 이러한 이벤트를 등록할 수 있습니다.
OnRecordSelect
OnChange
OnSave
중요
실행 컨텍스트 getFormContext 메서드를 사용하여 이벤트 처리기를 실행할 수 있는 편집 가능한 표 GridCell 또는 양식 필드에서 작동할 수 있는 공통 이벤트 처리기를 만들 수 있습니다.추가 정보:getFormContext
OnRecordSelect
편집 가능한 표에서 단일 행(레코드)을 선택하면 OnRecordSelect 이벤트가 발생합니다. 사용자가 같은 행의 다른 셀을 선택하거나 여러 행을 선택하면 이 이벤트는 발생하지 않습니다.
OnChange
OnChange 이벤트는 편집 가능한 표에서 셀의 값이 변경되고 셀이 포커스를 잃을 때 발생합니다.setValue 메서드를 사용하여 특성 값이 업데이트될 때 이 이벤트가 일어날 수도 있습니다.
OnSave
서버에 업데이트된 정보를 보내기 전에 다음이 발생하는 경우 OnSave 이벤트가 발생합니다.
레코드 선택에 변경이 있습니다.
사용자가 편집 가능한 표의 저장 단추를 사용하여 저장 작업을 명시적으로 트리거합니다.
사용자는 보류 중인 변경 내용이 있는 동안 편집 가능한 표에서 정렬, 필터링, 그룹화, 페이지 매김, 또는 탐색 작업을 적용합니다.
OnSave 이벤트에 대해 고려할 몇 가지 중요한 점은 다음과 같습니다.
사용자가 같은 레코드의 여러 열을 순서대로 편집하면 최적의 성능 및 양식 동작 호환성을 위해 OnSave 이벤트는 한 번만 발생합니다.
편집 가능한 표 및 상위 양식에는 별도의 저장 단추가 있습니다. 하나의 저장 단추를 클릭하더라도 다른 하나에는 변경 내용이 저장되지 않습니다.
편집 가능한 표는 탐색 작업이 컨텍스트 밖에서 수행될 때 보류 중인 변경 내용을 저장하지 않습니다. 컨트롤에 저장되지 않은 데이터는 손실될 수 있습니다. 따라서 해당 OnSave 이벤트가 발생하지 않을 수 있습니다. 예를 들어 양식 조회 필드 또는 리본을 사용하여 다른 레코드로 이동할 때 발생할 수 있습니다.
편집 가능한 표에서 새로 고침 단추를 누르면 모든 보류 중인 변경이 삭제되고 OnSave 이벤트가 발생하지 않습니다.
편집 가능한 표 컨트롤에는 자동 저장 타이머가 구현되지 않습니다.
편집 가능한 표는 중복 검색 규칙을 억제합니다.
편집 가능한 표 메서드
편집 가능한 표는 일기 전용 표에서 지원하는 일부 새 메서드와 대부분의 기존 메서드를 지원합니다.
GridControl
표
GridRow
GridRowData
GridEntity
GridAttribute
GridCell
GridControl
편집 가능한 표 컨트롤의 이름을 안다면 다음 코드를 사용하여 액세스할 수 있습니다. 예를 들어, 기본 계정 양식의 CONTACTS 하위 표에 액세스하려면:
var contactsGrid = Xrm.Page.getControl("Contacts");
팁
양식 편집기를 열지 않고 양식에서 표 컨트롤의 이름을 식별하려면 브라우저 개발자 도구 사용의 정보를 참조하십시오.
편집 가능한 표는 getEntityName 및 getGrid의 읽기 전용 표 컨트롤을 지원합니다.
표
편집 가능한 표는 GridControl.getGrid 메서드에서 반환되는 Grid에 대해 getRows, getSelectedRows, 및 getTotalRecordCount의 메서드를 지원합니다.
GridRow
편집 가능한 표는 Grid.getRows 및 Grid.getSelectedRows 메서드에서 반환되는 GridRow에 대해 getData 메서드를 지원합니다.
GridRow는 편집 가능한 표의 행에서 작업하는 방법을 제공하는 data 모음도 지원합니다. 모음에서 데이터에 액세스하는 데 사용되는 메서드에 대한 정보는 컬렉션(클라이언트 쪽 참조)을 참조하십시오.
GridRowData
편집 가능한 표는 GridRow.getData 메서드에서 반환되는 GridRowData에 대해 getEntity 메서드를 지원합니다.
GridRowData는 행에 포함된 모든 특성 모음을 포함하여 편집 가능한 표 열에 표시되는 레코드에 대한 특정 정보를 검색하는 메서드도 제공합니다. 특성 데이터는 편집 가능한 표에 표시되는 열로 제한됩니다. 모음에서 데이터에 액세스하는 데 사용되는 메서드에 대한 정보는 컬렉션(클라이언트 쪽 참조)을 참조하십시오.
GridEntity
편집 가능한 표는 GridRowData.getEntity 메서드에서 반환되는 GridEntity에 대해 다음의 메서드를 지원합니다.
GridRowData.getEntity 메서드를 사용하는 것 외에 GridRowData.entity 개체에 직접 액세스하여 GridEntity를 검색할 수 있습니다.
GridEntity는 또한 편집 가능한 표에서 엔터티 특성 모음을 사용하는 메서드를 제공하는 attributes 모음도 제공합니다. 각 특성(GridAttribute)은 편집 가능한 표의 셀 데이터를 표시하고 특성과 관련된 모든 셀에 대한 참조를 포함합니다. 모음에서 데이터에 액세스하는 데 사용되는 메서드에 대한 정보는 컬렉션(클라이언트 쪽 참조)을 참조하십시오.
GridAttribute
GridAttribute 는 선택된 표 행의 특성에 대해 getName, getRequiredLevel, setRequiredLevel, getValue, 및 setValue의 메서드를 지원합니다.
Grid.getSelectedRows 메서드를 사용하여 편집 가능한 표에서 선택한 행을 검색할 수 있습니다.
GridAttribute는 또한 특성과 관련된 셀 모음을 사용하는 방법을 제공하는 선택된 표 행의 특성에 대한 controls 모음도 지원합니다. 선택한 표 행의 각 셀(GridCell)은 편집할 수 있는 표에서 특성에 연결된 양식의 컨트롤과 유사합니다. 모음에서 데이터에 액세스하는 데 사용되는 메서드에 대한 정보는 컬렉션(클라이언트 쪽 참조)을 참조하십시오.
팁
성능상의 이유로 편집할 수 있는 표의 행(레코드)은 레코드가 선택되기 전에는 편집할 수 없습니다. 편집을 위해 사용자가 표에서 단일 레코드를 선택해야 합니다. 편집할 수 있는 표에서 레코드를 선택하면 데이터를 편집할 때 데이터 보안과 유효성을 보장하기 위해 Dynamics 365에서 레코드에 대한 사용자 액세스, 레코드의 활성 여부, 필드 유효성 검사 등 많은 사항을 내부적으로 평가합니다. 편집 가능한 상태의 표에서 레코드에 액세스하기 위해 OnRecordSelect 이벤트를 getFormContext와 함께 사용하는 것을 고려하십시오.
GridCell
setNotification 및 clearNotification 이외에 GridCell도 컨트롤에 대해 다음 메서드를 지원합니다.
참고
편집 가능한 표는 한 번에 여러 개의 알림을 표시할 수 없습니다.
getDisabled
셀을 사용할 수 없는지 여부(읽기 전용)를 반환합니다.
gridCellObj.getDisabled()
- 반환 값
유형: 부울. 셀을 사용할 수 없으면 true, 그렇지 않으면 false입니다.
setDisabled
셀을 사용할 수 없는지 여부를 설정합니다.
gridCellObj.setDisabled(bool)
인수
유형: 부울. 셀을 사용할 수 없어야 하면 true, 그렇지 않으면 false입니다.설명
읽기 전용 셀을 편집할 수 있도록 설정하면 레코드를 저장할 때 오류가 발생할 수 있습니다. 서버에서 필드가 읽기 전용으로 간주되는 경우 값을 수정하면 오류가 발생할 수 있습니다. 이는 사용자에게 레코드 쓰기 권한이 없거나, 레코드를 사용하지 못하도록 설정되어 있거나, 사용자게 필요한 필드 수준 액세스 권한이 없는 경우 발생할 수 있습니다.
getLabel
셀이 포함된 열의 레이블을 반환합니다.
gridCellObj.getLabel()
- 반환 값
유형: 문자열. 열의 레이블입니다.
참고 항목
표(읽기 전용) 개체 및 메서드(클라이언트 쪽 참조)
Dynamics 365에서 편집 가능한 표 사용
Microsoft Dynamics 365
© 2017 Microsoft. All rights reserved. 저작권 정보