테이블, 필드 및 레코드

Base는 테이블의 주문 세트를 포함합니다. 각 테이블 상점 분야 정의, 기록 가치, 선택적인 세포 자료 모체, 자원, 전망 및 색인은 어떤 렌더링 및 조회 논리에 달려 있습니다.

새로운 테이블에는 기록이 없습니다. 기록은 Facade API를 통해 추가되거나 스냅 샷 데이터를 가져올 수 있습니다.

테이블 스냅샷

속성유형설명
idstring테이블 ID입니다.
namestring테이블 이름입니다.
fieldsRecord\<string, IFieldSnapshot\>필드 ID를 키로 사용하는 필드 정의입니다.
fieldOrderstring[]정렬된 필드 ID 목록입니다.
recordsRecord\<string, IRecordSnapshot\>레코드 ID를 키로 사용하는 레코드 데이터입니다.
recordOrder?string[]정렬된 레코드 ID 목록입니다.
primaryFieldIdstring기본 필드 ID입니다.
viewsRecord\<string, IViewSnapshot\>뷰 ID를 키로 사용하는 뷰입니다.
viewOrderstring[]정렬된 뷰 ID 목록입니다.
resources?IBaseResources옵션, 회원 및 첨부 리소스는 테이블 전체에 공유됩니다.

필드 스냅샷

속성유형설명
idstring필드 ID입니다.
namestring필드 이름입니다.
description?string필드 설명입니다.
typeBaseFieldType필드 유형입니다.
configRecord\<string, unknown\>필드 유형에 특정한 Config.
defaultValue?BaseCellValue새 레코드의 기본값입니다.
system?boolean의 필드가 시스템에 의해 관리 여부.
readonly?boolean값이 읽기 전용인지 여부입니다.

필드 유형

일반적인 필드 유형으로는 text, number, currency, progress, rating, checkbox, singleSelect, multiSelect, person, group, date, attachment, formula, createdAt, updatedAt, createdBy, updatedBy가 있습니다.

응용 코드에서 Facade enums를 사용:

TypeScript
const field = table.addField('Due date', univerAPI.Enum.BaseFieldType.Date)

레코드 스냅샷

속성유형설명
idstring레코드 ID입니다.
valuesRecord\<string, BaseCellValue\>필드 ID를 키로 사용하는 값입니다.
orderKeystring안정적인 정렬 키입니다.
createdAtnumber생성 타임스탬프입니다.
updatedAtnumber마지막 업데이트의 타임스탬프.
createdBy?string생성자 ID입니다.
updatedBy?string마지막 업데이트자의 ID.

Facade 예제

TypeScript
const table = base.insertTable('Tasks', { primaryFieldName: 'Title' })const title = table.getPrimaryField()const status = table.addField('Status', univerAPI.Enum.BaseFieldType.SingleSelect)const record = table.addRecord({  [title.getId()]: 'Write guide',  [status.getId()]: 'In progress',})

이 가이드는 어떠셨나요?

© 2026 DreamNum Co., Ltd.