테이블, 필드 및 레코드
Base는 테이블의 주문 세트를 포함합니다. 각 테이블 상점 분야 정의, 기록 가치, 선택적인 세포 자료 모체, 자원, 전망 및 색인은 어떤 렌더링 및 조회 논리에 달려 있습니다.
새로운 테이블에는 기록이 없습니다. 기록은 Facade API를 통해 추가되거나 스냅 샷 데이터를 가져올 수 있습니다.
테이블 스냅샷
| 속성 | 유형 | 설명 |
|---|---|---|
| id | string | 테이블 ID입니다. |
| name | string | 테이블 이름입니다. |
| fields | Record\<string, IFieldSnapshot\> | 필드 ID를 키로 사용하는 필드 정의입니다. |
| fieldOrder | string[] | 정렬된 필드 ID 목록입니다. |
| records | Record\<string, IRecordSnapshot\> | 레코드 ID를 키로 사용하는 레코드 데이터입니다. |
| recordOrder? | string[] | 정렬된 레코드 ID 목록입니다. |
| primaryFieldId | string | 기본 필드 ID입니다. |
| views | Record\<string, IViewSnapshot\> | 뷰 ID를 키로 사용하는 뷰입니다. |
| viewOrder | string[] | 정렬된 뷰 ID 목록입니다. |
| resources? | IBaseResources | 옵션, 회원 및 첨부 리소스는 테이블 전체에 공유됩니다. |
필드 스냅샷
| 속성 | 유형 | 설명 |
|---|---|---|
| id | string | 필드 ID입니다. |
| name | string | 필드 이름입니다. |
| description? | string | 필드 설명입니다. |
| type | BaseFieldType | 필드 유형입니다. |
| config | Record\<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)레코드 스냅샷
| 속성 | 유형 | 설명 |
|---|---|---|
| id | string | 레코드 ID입니다. |
| values | Record\<string, BaseCellValue\> | 필드 ID를 키로 사용하는 값입니다. |
| orderKey | string | 안정적인 정렬 키입니다. |
| createdAt | number | 생성 타임스탬프입니다. |
| updatedAt | number | 마지막 업데이트의 타임스탬프. |
| 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',})이 가이드는 어떠셨나요?