Wijmo 블로그 MESCIUS 기술 블로그 ·

CollectionView trackChanges로 수정된 행만 서버에 저장하기 | Wijmo

그리드에서 몇 줄만 수정했는데 저장 버튼을 누르면 전체 데이터를 서버로 보내야 할까요? 행마다 추가·수정·삭제 여부를 Dirty 플래그로 직접 관리하다 보면 코드가 금방 복잡해집니다. Wijmo CollectionView의 trackChanges 속성을 켜면 컬렉션이 변경 이력을 대신 기록하므로, FlexGrid에서 바뀐 행만 모아 서버에 한 번에 보내는 일괄 저장(Batch Save) 로직을 몇 줄로 작성할 수 있습니다. 이 글에서는 처음 구현하는 개발자도 따라 할 수 있도록 단계별로 정리합니다.

⭐
Key Points
이 글에서 다루는 핵심 내용
01
CollectionView.trackChanges = true 로 추가·수정·삭제 이력 추적을 활성화하는 방법
02
itemsAdded , itemsEdited , itemsRemoved 로 변경 유형별 행을 구분해 가져오는 방법
03
변경 건수를 요약하고 수정된 행을 formatItem 으로 눈에 띄게 표시하는 방법
04
변경분만 fetch 로 일괄 전송한 뒤 clearChanges() 로 추적 목록을 비우는 저장 흐름
05
변경 추적이 정상 동작하기 위한 조건(CollectionView 메서드 사용)과 주의점

trackChanges로 추가·수정·삭제된 행을 추적하는 원리

CollectionView는 trackChanges 를 true 로 설정하면 데이터 변경을 추적해 itemsAdded , itemsEdited , itemsRemoved 세 컬렉션( ObservableArray )에 담아 둡니다. 기본값은 false 이므로 명시적으로 켜야 합니다. 서버에서 데이터를 받아 로컬에서 수정한 뒤, 사용자가 확인한 시점에 변경분만 서버에 반영하는 패턴에 적합합니다.

속성/메서드 설명
trackChanges 변경 추적 여부 (기본값 false )
itemsAdded 추가된 항목 목록
itemsEdited 수정된 항목 목록
itemsRemoved 삭제된 항목 목록
clearChanges() 위 세 목록을 모두 비움

추가·수정·삭제된 행을 서로 다른 배지로 구분하는 데이터 그리드 개념도

한 가지 중요한 조건이 있습니다. CollectionView는 editItem / commitEdit , addNew / commitNew , remove 같은 CollectionView 메서드를 통해 이뤄진 변경만 추적하며, 원본 배열을 직접 수정한 변경은 추적하지 않습니다. FlexGrid는 셀 편집·새 행 추가·Delete 키 삭제 시 내부적으로 이 메서드들을 호출하므로, 그리드 UI로 편집하는 한 별도 코드 없이 추적됩니다.

💡 SUMMARY
Wijmo CollectionView는 trackChanges를 켜면 추가·수정·삭제된 항목을 itemsAdded·itemsEdited·itemsRemoved로 구분해 제공합니다.

예제: FlexGrid에서 변경된 행만 서버로 일괄 저장 구현하기

STEP 1: Wijmo 라이브러리 CDN 참조 추가

이 예제에서는 코어와 FlexGrid, 한국어 문화권 스크립트만 필요합니다.

STEP 2: 그리드를 렌더링할 HTML 컨테이너 만들기

그리드를 그릴 div , 저장·되돌리기 버튼, 변경 건수와 전송 payload를 보여 줄 영역을 준비합니다.

STEP 3: 데이터 준비 및 trackChanges 켜기

CollectionView 를 만들고 trackChanges 를 켠 뒤 FlexGrid에 연결합니다. 행 추가·삭제를 허용하려면 allowAddNew , allowDelete 를 사용합니다.

이제 그리드에서 셀을 수정하면 view.itemsEdited 에, 새 행을 입력하면 view.itemsAdded 에, 행을 선택해 Delete 키를 누르면 view.itemsRemoved 에 항목이 쌓입니다.

STEP 4: 변경 요약·행 강조·일괄 저장까지 완성하기

STEP 3의 코드에 세 가지를 더합니다. 첫째, 컬렉션 변경 시 건수를 요약합니다. 둘째, formatItem 에서 itemsEdited / itemsAdded 에 포함된 행의 배경색을 바꿉니다. 셋째, 저장 버튼에서 변경분만 fetch 로 전송하고 성공하면 clearChanges() 를 호출합니다.

실행 결과

위 라이브 데모에서 셀을 수정하고, 마지막 빈 행에 새 데이터를 입력하고, 행 머리글을 클릭해 Delete 키로 삭제해 보세요. 수정된 행은 노란색, 추가된 행은 초록색으로 표시되고 상단 요약의 건수가 바뀝니다. 저장 버튼을 누르면 변경분만 JSON으로 전송되며, 성공했을 때만 clearChanges() 로 이력이 비워집니다.

변경된 행만 화살표를 통해 서버 데이터베이스로 전송하는 흐름도

💡 SUMMARY
Wijmo FlexGrid 편집 후 변경된 행만 모아 서버에 한 번에 전송하는 일괄 저장 패턴을 CollectionView로 구현할 수 있습니다.

변경 추적 구현 시 알아둘 주의사항

  • 전송 성공 후에 clearChanges() 호출: 전송이 실패했는데 먼저 초기화하면 변경 이력이 사라집니다. 위 예제처럼 응답을 확인한 뒤 호출하세요.
  • 원본 배열 직접 수정은 추적되지 않음: data[0].price = 100 처럼 배열을 직접 바꾸면 추적 대상이 아닙니다. 코드로 값을 바꿀 때는 editItem / commitEdit 을 거치세요.
  • 식별 키 포함: 서버가 수정·삭제 대상을 찾으려면 id 같은 키 필드가 항목에 있어야 합니다.
  • 서버 연동 전용 컬렉션: OData·REST 데이터 소스용 컬렉션( ODataCollectionView 등)도 같은 변경 추적 속성을 상속하며, 서버 연동 시에는 해당 클래스의 commitChanges 같은 메서드를 함께 확인해 보세요.
💡 SUMMARY
Wijmo의 변경 추적은 별도 라이브러리 없이 CollectionView 속성만으로 동작해 Dirty 행 관리 코드를 줄여 줍니다.

자주 묻는 질문 (FAQ)

Q01

Wijmo CollectionView의 trackChanges는 무엇이고 어떤 역할을 하나요?

trackChanges 를 true 로 설정하면 CollectionView가 추가·수정·삭제된 항목을 각각 itemsAdded , itemsEdited , itemsRemoved 컬렉션에 기록합니다. 기본값은 false 입니다.
Q02

FlexGrid에서 수정·추가·삭제된 행만 따로 가져오려면 어떻게 하나요?

FlexGrid의 itemsSource 에 trackChanges: true 인 CollectionView를 연결하세요. 사용자가 그리드에서 편집하면 view.itemsEdited , view.itemsAdded , view.itemsRemoved 에 해당 행의 데이터 객체가 쌓이므로 slice() 로 복사해 사용하면 됩니다.
Q03

CollectionView에서 변경된 데이터만 서버로 전송하는 방법은 무엇인가요?

세 목록을 하나의 객체로 묶어 fetch 의 body 에 JSON.stringify 로 담아 전달합니다. 응답이 성공하면 view.clearChanges() 를 호출해 추적 목록을 초기화하세요. 그러면 다음 저장에는 새 변경분만 전송됩니다.
Q04

그리드 편집 내용을 일괄 저장(Batch Save)하기에 적합한 JavaScript 그리드는 무엇인가요?

Wijmo FlexGrid는 CollectionView와 함께 쓰면 변경 유형별 목록을 기본 제공하므로 일괄 저장 구조를 단순하게 만들 수 있습니다. 별도의 Dirty 플래그 관리 코드를 작성하지 않아도 된다는 점이 장점입니다.
Q05

변경 추적을 켜면 성능에 영향이 있나요?

변경 이력을 추가로 기록하는 만큼 약간의 관리 비용이 있지만, 이는 trackChanges 를 켠 경우에만 발생합니다. 정확한 영향은 데이터 규모와 편집 빈도에 따라 달라지므로 실제 환경에서 측정해 보시기 바랍니다.
Q06

AG Grid와 Wijmo의 데이터 변경 추적 방식은 어떻게 다른가요?

Wijmo는 데이터 소스인 CollectionView 자체가 변경 목록을 관리하는 구조이며, 그리드와 데이터 계층이 분리되어 있어 같은 컬렉션을 여러 컨트롤이 공유할 수 있습니다. 다른 그리드 제품의 변경 추적 방식은 각 제품의 공식 문서에서 별도로 확인해 비교하시기 바랍니다.

MESCIUS Wijmo

지금 바로 Wijmo 를 무료로 체험해 보세요

30일 무료 체험판으로 모든 기능을 직접 확인하세요.

Wijmo 무료 체험판 다운로드