[]
        
(Showing Draft Content)

데이터 객체 셀

데이터 객체 셀 형식을 사용하면 셀에 구조화된 개체 데이터를 표시하고 개체 속성을 인접한 셀로 직접 추출할 수 있습니다.

셀 값이 개체이고 셀 형식이 GC.Spread.Sheets.CellTypes.DataObject로 설정된 경우 기본 제공 단추 image-20260330.bbbbec.png가 셀에 표시됩니다.

단추를 클릭하면 개체 속성의 드롭다운 목록이 표시됩니다. 속성을 선택하면 해당 값이 오른쪽의 인접한 빈 셀에 입력됩니다. 이 작업은 실행 취소를 지원합니다.

dataObject-20260330.9cd8e6.gif

참고: 인접한 셀이 병합되어 있거나 테이블의 일부인 경우 추출에 실패하고 "Cannot insert data" 메시지와 함께 InvalidOperation 이벤트가 발생합니다.

image-20260330.b52d4a.png

데이터 객체 셀 형식은 개체가 셀에 표시되는 방식을 제어하기 위한 서식 문자열을 지원합니다. 서식에서는 PROPERTY 함수 또는 @. 점 연산자를 사용할 수 있습니다.

예제:

// Retrieve object data
sheet.setFormula(1, 1,
  '=FILTERJSON(WEBSERVICE("https://demodata.grapecity.com/northwind/api/v1/Products/1"))'
);

// Apply DataObject cell type with display format
var cellType = new GC.Spread.Sheets.CellTypes.DataObject(
  '=@.productName & " " & @.unitPrice'
);

sheet.setCellType(1, 1, cellType);

데이터 객체 셀 형식은 SpreadJS 디자이너에서도 구성할 수 있습니다.

홈 탭 → 스타일 그룹 → 셀 편집기 → 셀 형식 → 데이터 객체

image-20260421.d155ce.png

개체 속성이 표시되는 방식을 제어하려면 서식 필드에 유효한 서식 문자열을 입력합니다.

image-20260330.f48f6b.png

서식은 유효해야 하며, 그렇지 않으면 적용되지 않습니다.