레코드, 연결 및 계층

기록은 작업, 고객 또는 주문과 같은 하나의 비즈니스 객체를 나타냅니다. Facade API는 기록에 적용되는 작업을 다룹니다. 일괄 작성, 페이지를 읽고, 다른 테이블을 연결하고, 부모 - 어린이 기록을 정리합니다.

레코드 생성 및 읽기

TypeScript
const base = univerAPI.getActiveBase()if (!base) throw new Error('Open a Base first')const table = base.insertTable('Tasks', { primaryFieldName: 'Title' })const titleId = table.getPrimaryFieldId()const records = table.addRecords([  { values: { [titleId]: 'Write documentation' } },  { values: { [titleId]: 'Review examples' } },])records[0].setValue(titleId, 'Publish documentation')const page = table.queryRecords({ offset: 0, limit: 20 })console.log(page.total, page.records)

기록 값은 기본적으로 필드 ID에 의해 키 입력됩니다. 데이터가 필드 이름에 의해 키가되면 univerAPI.Enum.BaseFieldKeyEnum.Name를 통과합니다. queryRecords() 쿼리는 이미 로컬로로드 된 데이터 만 해당합니다. 백엔드에서 페이지를 fetch하지 않습니다. viewId을 사용하여 보기 범위 내에서 레코드를 읽거나 주문 설정 sort에서 기록합니다.

table.deleteRecords(recordIds)와 일괄 처리를 삭제하거나 record.duplicate()로 레코드를 복제합니다. 두 작업 모두 명령 시스템을 통해 이동하므로 undo 및 redo가 지원됩니다.

레코드 검색

선택한 필드 내에서 텍스트 검색:

TypeScript
const matches = table.search({ query: 'documentation', fieldIds: [titleId], limit: 20 })console.log(matches)

다른 테이블 연결

다음 예제는 각 작업을 프로젝트로 연결:

TypeScript
const projects = base.insertTable('Projects', { primaryFieldName: 'Name' })const project = projects.addRecord({ [projects.getPrimaryFieldId()]: 'Website' })const projectField = table.addField('Project', univerAPI.Enum.BaseFieldType.RecordLink, {  field: { config: { targetTableId: projects.getId(), multiple: false } },})records[0].setLinkedRecordIds(projectField.getId(), [project.getId()])console.log(records[0].getLinkedRecordIds(projectField.getId()))

Linked Targets는 동일한 Base에 속해야 합니다. multiple: true를 설정하여 하나의 연결 레코드, displayFieldId가 표시된 라벨을 선택하고 pickerFieldIds는 피커에서 추가 컨텍스트를 공급합니다. 내부 저장 문자열을 직접 생성하는 것보다 링크 API를 통해 ID를 읽고 작성하십시오.

부모·자식 레코드

다음 예제는 API가 문서 작업의 자녀를 검토합니다.

TypeScript
const parent = records[0]const parentFieldId = table.getHierarchyFieldId()const child = parent.addChild(parentFieldId, { [titleId]: 'Check API examples' })console.log(child.getParent(parentFieldId)?.getId())child.setParent(parentFieldId, null)

첫 번째 아이를 추가하면 필요한 부모 링크 필드를 만듭니다. getChildren(), getAncestors() 및 getDescendants()를 사용하여 관계를 다시 읽을 수 있습니다. 계층은 5 레벨 깊이가 될 수 있습니다. 레코드는 자신의 부모가 될 수 없으며 주기가 거부됩니다. 잘못된 작업 던지기로 오류를 잡고 UI의 유용한 메시지를 제시하십시오.

Hierarchy는 테이블 데이터의 일부이므로 전환 또는 필터링 조회는 변경하지 않습니다. 기초 Facade 문서 나머지 방법.

이 가이드는 어떠셨나요?

© 2026 DreamNum Co., Ltd.