#블록 확장 개요

NocoBase 2.0에서는 블록 확장 메커니즘이 크게 간소화되었습니다. 개발자는 해당 FlowModel 기본 클래스를 상속하고 관련 인터페이스 메서드(주로 renderComponent() 메서드)를 구현하기만 하면 블록을 빠르게 사용자 정의할 수 있습니다.

#블록 분류

NocoBase는 블록을 세 가지 유형으로 분류하며, 설정 인터페이스에서 그룹별로 표시합니다.

• 데이터 블록(Data blocks): DataBlockModel 또는 CollectionBlockModel을 상속하는 블록
• 필터 블록(Filter blocks): FilterBlockModel을 상속하는 블록
• 기타 블록(Other blocks): BlockModel을 직접 상속하는 블록

블록의 그룹은 해당 기본 클래스에 의해 결정됩니다. 분류 로직은 상속 관계를 기반으로 하며, 별도의 설정이 필요하지 않습니다.

#기본 클래스 설명

시스템은 확장을 위한 네 가지 기본 클래스를 제공합니다.

#BlockModel

기본 블록 모델은 가장 범용적인 블록 기본 클래스입니다.

• 데이터에 의존하지 않는 순수 표시용 블록에 적합합니다.
• 기타 블록 그룹으로 분류됩니다.
• 개인화된 시나리오에 적용할 수 있습니다.

#DataBlockModel

**데이터 블록 모델(데이터 테이블에 바인딩되지 않음)**은 사용자 정의 데이터 소스를 위한 블록입니다.

• 데이터 테이블에 직접 바인딩되지 않으며, 데이터 가져오기 로직을 사용자 정의할 수 있습니다.
• 데이터 블록 그룹으로 분류됩니다.
• 적용 시나리오: 외부 API 호출, 사용자 정의 데이터 처리, 통계 차트 등

#CollectionBlockModel

컬렉션 블록 모델은 데이터 테이블에 바인딩해야 하는 블록입니다.

• 데이터 테이블 모델에 바인딩해야 하는 기본 클래스입니다.
• 데이터 블록 그룹으로 분류됩니다.
• 적용 시나리오: 목록, 폼, 칸반 보드 등 특정 데이터 테이블에 명확하게 의존하는 블록

#FilterBlockModel

필터 블록 모델은 필터 조건을 구성하는 데 사용되는 블록입니다.

• 필터 조건을 구성하기 위한 모델 기본 클래스입니다.
• 필터 블록 그룹으로 분류됩니다.
• 일반적으로 데이터 블록과 연동됩니다.

#기본 클래스 선택 방법

기본 클래스를 선택할 때는 다음 원칙을 따를 수 있습니다.

• 특정 데이터 테이블에 바인딩해야 하는 경우: CollectionBlockModel을 우선적으로 선택합니다.
• 사용자 정의 데이터 소스를 사용하는 경우: DataBlockModel을 선택합니다.
• 필터 조건을 설정하고 데이터 블록과 연동해야 하는 경우: FilterBlockModel을 선택합니다.
• 어떻게 분류해야 할지 모르겠다면: BlockModel을 선택합니다.

#빠른 시작

사용자 정의 블록을 생성하는 데는 세 가지 단계만 거치면 됩니다.

1. 해당 기본 클래스(예: BlockModel)를 상속합니다.
2. renderComponent() 메서드를 구현하여 React 컴포넌트를 반환하도록 합니다.
3. 플러그인에 블록 모델을 등록합니다.

자세한 예시는 블록 플러그인 작성하기를 참조하세요.