[]
SpreadJS는 데이터 매니저(DataManager) 라는 구조화된 런타임 데이터 모델링 엔진을 제공합니다.
데이터 매니저는 SpreadJS의 핵심 데이터 계층입니다.
테이블 시트, 간트 시트, 리포트 시트, 데이터 차트와 같은 최신 SpreadJS 컴포넌트는 이 엔진에서 정의된 구조화된 데이터 모델을 사용합니다.
데이터 매니저는 데이터를 다음과 같이 정의합니다.
구성
구조화
관계 설정
유효성 검사
계산
표시용 데이터 준비
각 Workbook 인스턴스에는 정확히 하나의 데이터 매니저 인스턴스가 포함됩니다.
다음과 같이 접근할 수 있습니다.
var dataManager = spread.dataManager();GC.Data.DataManager는 독립적으로 생성할 수 있지만, 수동으로 생성한 인스턴스는 Workbook과 연결되지 않습니다. SpreadJS 컴포넌트는 Workbook이 소유한 데이터 매니저에서만 동작합니다.
데이터 매니저는 다음을 담당합니다.
구조화된 테이블 관리
스키마 및 열 동작 정의
테이블 간 관계 설정
계층 구조 및 계산 필드 지원
표시 및 컴포넌트 바인딩용 View 생성
이는 원시 데이터 소스와 UI 컴포넌트 사이에 데이터 모델링 계층을 제공합니다.
개념적으로 객체 구조는 다음과 같습니다.
Workbook
└─ DataManager (1 per Workbook)
├─ Table (multiple)
│ ├─ Schema (1 per Table)
│ │ └─ Columns (multiple)
│ └─ View (multiple)
└─ Relationship (multiple)이 구조는 SpreadJS의 모든 구조화 데이터 기반 컴포넌트의 기반이 됩니다.
SpreadJS는 구조화 데이터를 정의하고 작업하기 위한 두 가지 환경을 제공합니다.
테이블과 모델은 DataManager API를 사용하여 프로그래밍 방식으로 정의합니다.
런타임에서는 다음 작업을 수행할 수 있습니다.
Workbook의 데이터 매니저 접근
테이블 생성
스키마 정의
관계 설정
View 생성
디자이너는 동일한 데이터 모델을 정의하기 위한 시각적 구성 환경을 제공합니다.
디자이너에서는 데이터 원본 패널을 통해 다음 작업을 수행할 수 있습니다.
구조화된 테이블 정의
스키마 및 열 동작 구성
관계 설정
계층 구조 데이터 활성화
유효성 검사 및 서식 규칙 적용
구성된 데이터 미리 보기
디자이너에서 수행한 모든 구성은 런타임 데이터 매니저와 직접 매핑됩니다.
디자이너는 별도의 데이터 시스템을 제공하지 않으며, 코드에서 사용할 수 있는 동일한 테이블, 스키마 및 관계를 위한 시각적 작성 계층을 제공합니다.
디자이너에서 데이터 모델을 구성하는 방법에 대한 자세한 내용은 디자이너 문서를 참고하세요.
테이블 시트 및 간트 시트와 같은 구조화 컴포넌트는 단순한 데이터 배열 이상을 필요로 합니다. 이러한 컴포넌트는 다음에 의존합니다.
명시적인 테이블 정의
열 메타데이터
데이터 형식 및 유효성 검사 규칙
테이블 간 관계
표시용 View 정의
데이터 매니저를 사용하면 다음 작업을 수행할 수 있습니다.
컴포넌트에 바인딩하기 전에 구조화된 데이터 준비
다중 테이블 시나리오를 위한 관계형 데이터 모델 정의
계층 구조 및 계산 필드 구성
하나의 테이블을 여러 컴포넌트에서 재사용
데이터 모델링과 UI 표시 분리
데이터 매니저에서 테이블이 정의되면 다음 작업에 사용할 수 있습니다.
테이블 시트 또는 간트 시트에 바인딩
리포트 시트의 데이터 원본으로 사용
데이터 차트 시각화 구동
동일한 Workbook 내 여러 컴포넌트에서 재사용
데이터 매니저 사용은 일반적으로 다음 순서를 따릅니다.
Workbook의 데이터 매니저 가져오기
하나 이상의 테이블 생성
스키마 및 열 동작 정의
관계 설정(여러 테이블 사용 시)
표시용 하나 이상의 View 생성
구조화 컴포넌트에 View 바인딩
이 문서는 각 핵심 객체를 독립적으로 탐색할 수 있도록 유지하면서도 이러한 모델링 흐름을 따르도록 구성되어 있습니다.
이 문서는 데이터 매니저의 핵심 모델링 개념을 중심으로 구성되어 있습니다.
다음 두 가지 방식으로 탐색할 수 있습니다.
구조화된 데이터 모델을 처음부터 구축하는 경우 다음 순서로 읽어보세요.
이 경로는 일반적인 전체 모델링 프로세스를 반영합니다.
특정 개념을 찾고 있는 경우:
Table – 구조화된 데이터 집합 컨테이너
Schema – 구조 정의 계층
Relationship – 테이블 간 모델링
View – 표시용 프로젝션
Operations – 데이터 조회 및 동기화
각 섹션은 필요에 따라 독립적으로 읽을 수 있습니다.
다음 섹션에서는 다음 내용을 설명합니다.
데이터 매니저에 접근하고 사용하는 방법
테이블을 생성하고 구성하는 방법
스키마 및 열이 데이터 동작을 정의하는 방법
관계를 사용하여 여러 테이블을 연결하는 방법
View가 표시 및 바인딩을 제어하는 방법
동기화 및 추적과 같은 데이터 동작을 구성하는 방법
각 섹션에는 실제 사용 패턴을 보여주는 설명과 실행 가능한 예제가 포함되어 있습니다.