[]
        
(Showing Draft Content)

데이터 매니저

SpreadJS는 데이터 매니저(DataManager) 라는 구조화된 런타임 데이터 모델링 엔진을 제공합니다.

데이터 매니저는 SpreadJS의 핵심 데이터 계층입니다.

테이블 시트, 간트 시트, 리포트 시트, 데이터 차트와 같은 최신 SpreadJS 컴포넌트는 이 엔진에서 정의된 구조화된 데이터 모델을 사용합니다.

데이터 매니저는 데이터를 다음과 같이 정의합니다.

  • 구성

  • 구조화

  • 관계 설정

  • 유효성 검사

  • 계산

  • 표시용 데이터 준비

Workbook 인스턴스에는 정확히 하나의 데이터 매니저 인스턴스가 포함됩니다.

다음과 같이 접근할 수 있습니다.

var dataManager = spread.dataManager();

GC.Data.DataManager는 독립적으로 생성할 수 있지만, 수동으로 생성한 인스턴스는 Workbook과 연결되지 않습니다. SpreadJS 컴포넌트는 Workbook이 소유한 데이터 매니저에서만 동작합니다.

SpreadJS에서 데이터 매니저의 역할

데이터 매니저는 다음을 담당합니다.

  • 구조화된 테이블 관리

  • 스키마 및 열 동작 정의

  • 테이블 간 관계 설정

  • 계층 구조 및 계산 필드 지원

  • 표시 및 컴포넌트 바인딩용 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 내 여러 컴포넌트에서 재사용

데이터 모델링 워크플로

데이터 매니저 사용은 일반적으로 다음 순서를 따릅니다.

  1. Workbook의 데이터 매니저 가져오기

  2. 하나 이상의 테이블 생성

  3. 스키마 및 열 동작 정의

  4. 관계 설정(여러 테이블 사용 시)

  5. 표시용 하나 이상의 View 생성

  6. 구조화 컴포넌트에 View 바인딩

이 문서는 각 핵심 객체를 독립적으로 탐색할 수 있도록 유지하면서도 이러한 모델링 흐름을 따르도록 구성되어 있습니다.

이 문서를 탐색하는 방법

이 문서는 데이터 매니저의 핵심 모델링 개념을 중심으로 구성되어 있습니다.

다음 두 가지 방식으로 탐색할 수 있습니다.

모델링 흐름 따라가기

구조화된 데이터 모델을 처음부터 구축하는 경우 다음 순서로 읽어보세요.

  1. DataManager 가져오기

  2. 테이블 생성

  3. 스키마 정의

  4. 테이블 관계

  5. View

  6. 테이블 작업

  7. SpreadJS 컴포넌트와의 통합

이 경로는 일반적인 전체 모델링 프로세스를 반영합니다.

핵심 객체별 탐색

특정 개념을 찾고 있는 경우:

  • Table – 구조화된 데이터 집합 컨테이너

  • Schema – 구조 정의 계층

  • Relationship – 테이블 간 모델링

  • View – 표시용 프로젝션

  • Operations – 데이터 조회 및 동기화

각 섹션은 필요에 따라 독립적으로 읽을 수 있습니다.

이 문서에서 다루는 내용

다음 섹션에서는 다음 내용을 설명합니다.

  • 데이터 매니저에 접근하고 사용하는 방법

  • 테이블을 생성하고 구성하는 방법

  • 스키마 및 열이 데이터 동작을 정의하는 방법

  • 관계를 사용하여 여러 테이블을 연결하는 방법

  • View가 표시 및 바인딩을 제어하는 방법

  • 동기화 및 추적과 같은 데이터 동작을 구성하는 방법

각 섹션에는 실제 사용 패턴을 보여주는 설명과 실행 가능한 예제가 포함되어 있습니다.