개요

반복되는 데이터 내용의 표시가 필요할 때 사용하는 밴드 아이템입니다.

band-item

밴드 디자인

밴드 아이템을 생성할 때 연결할 데이터와 관련 필드 목록을 불러와 설정합니다.

사용 예시

사용할 Band Data를 선택합니다.
필드 목록에서 사용할 데이터를 > 화살표로 선택합니다.
Band 필드에서 왼쪽에서 오른쪽 순으로 불러와지는 데이터의 순서를 지정합니다.
Create 버튼을 통해 테이블 밴드를 생성합니다.

band-item-design

Basic

이름	타입	설명	필수여부
Name	string	아이템에 고유한 이름을 설정합니다.	no
Tag	string	아이템에 태그값을 설정합니다.	no
Visible	boolean	아이템의 표시 여부를 설정합니다.	yes
Page Break	PageBreakMode	아이템을 출력하기 전에 페이지를 어떻게 나눌 것인지 대해 설정합니다.	no

Excel

셀 배치나 병합 혹은 셀 수식을 적용할 수 있는 속성

이름	타입	설명	필수여부
Row	number	밴드 아이템의 행 위치값을 설정합니다.	yes
Col	number	밴드 아이템의 열 위치값을 설정합니다.	yes
Col Count	number	밴드 아이템의 열 갯수를 설정합니다.	yes

Col Count

밴드 아이템의 열 갯수를 설정합니다.

타입: number
기본값: 5

Event

이름	타입	설명	필수여부
OnGetStyles	ReportItemStyleCallback	아이템에 적용되는 스타일을 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다.	no
OnGetVisible	ReportItemVisibleCallback	아이템의 표시 여부를 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다.	no

Data

이름	타입	설명	필수여부
Data	string	아이템에 리포트에 존재하는 데이터를 연결합니다.	no
Max Row Count	number	아이템이 Band에 해당되는 경우 데이터가 표시될 수 있는 최대행을 설정합니다.	no
Sort Field	string	데이터 행의 정렬 기준 필드를 설정합니다.	no
Sort Direction	string	데이터 행의 정렬 방향을 설정합니다.	no

Sort Field

데이터 행의 정렬 기준 필드를 설정합니다.

타입: string
기본값: undefined

ℹ️

동작 조건 Sort Direction 속성이 설정되어야 동작합니다.

Sort Direction

데이터 행의 정렬 방향을 설정합니다.

타입: ascending | descending
기본값: undefined

ℹ️

동작 조건 Sort Field 속성이 설정되어야 동작합니다.

Band

반복적으로 표시할 데이터 영역에 대한 속성

이름	타입	설명	필수여부
Section Count	number	`Data Row` 영역에서 몇 개의 `단`으로 나눌지 설정합니다.	yes
Section Layout	string	`Data Row` 영역에서 `단`나누기할 때 데이터의 방향을 설정합니다.	yes
Section Gap	number	`Data Row` 영역에서 `단`나누기 간격을 설정합니다.	yes
Rows Per Page	number	페이지당 `Data Row`에 출력될 행의 수를 설정합니다.	no
Max Rows Per Page	number	페이지당 `Data Row`에 출력될 최대 행의 수를 설정합니다.	no
Repeat Master Row	boolean	마스터 디테일 형태에서 마스터 데이터의 반복 출력 여부를 설정합니다.	yes
End Row Count	number	데이터행 수와 상관없이 마지막 페이지에 표시돼야 할 행의 수를 설정합니다.	no
Max End Row Count	number	마지막 페이지에 표시돼야 할 데이터의 빈 행의 개수를 설정합니다.	no
End Row Message	number	`Data Row`에서 빈 행 출력 시 첫줄에 표시 할 문구를 설정합니다.	no
Repeat Header	boolean	`Data Row`에서 데이터의 길이가 페이지를 넘어갈 경우 항상 `Header` 영역을 표시할 것인지 설정합니다.	yes
Always Header	boolean	페이지내에서 푸터 영역만 단일로 출력될 경우 `Header` 영역을 표시할 것인지 설정합니다.	yes
No Split	boolean	체크하면 테이블 밴드를 다른 페이지에 분리하여 표시합니다.	yes
Empty Data Header Visible	boolean	밴드 아이템에 연결한 데이터가 존재하지 않을 경우 `Header` 영역을 표시할 것인지 설정합니다.	yes
Empty Data Footer Visible	boolean	밴드 아이템에 연결한 데이터가 존재하지 않을 경우 `Footer` 영역을 표시할 것인지 설정합니다.	yes
End Row Merged	boolean	체크하면 데이터가 없는 빈 행들을 합쳐서 하나의 박스로 보이게 합니다.	yes

Section Count

Data Row 영역에서 몇 개의 단으로 나눌지 설정합니다.

타입: number
기본값: 1
최솟값: 1

Section Layout

Data Row 영역에서 단나누기할 때 데이터의 방향을 설정합니다.

타입: string
기본값: downAcross

Section Gap

Data Row 영역에서 단나누기 간격을 설정합니다.

타입: number
기본값: 10

Rows Per Page

페이지당 Data Row에 출력될 행의 수를 설정합니다.

타입: number
기본값: undefined

Max Rows Per Page

페이지당 Data Row에 출력될 최대 행의 수를 설정합니다.

타입: number
기본값: undefined

Repeat Master Row

마스터 디테일 형태에서 마스터 데이터의 반복 출력 여부를 설정합니다.

타입: boolean
기본값: false

End Row Count

데이터행 수와 상관없이 마지막 페이지에 표시돼야 할 행의 수를 설정합니다.

타입: number
기본값: undefined

End Row Message

Data Row에서 빈 행 출력 시 첫줄에 표시 할 문구를 설정합니다.

타입: string
기본값: undefined

Max End Row Count

마지막 페이지에 표시돼야 할 데이터의 빈 행의 개수를 설정합니다.

타입: number
기본값: undefined

Repeat Header

Data Row에서 데이터의 길이가 페이지를 넘어갈 경우 항상 Header 영역을 표시할 것인지 설정합니다.

타입: boolean
기본값: true

Always Header

페이지내에서 푸터 영역만 단일로 출력될 경우 Header 영역을 표시할 것인지 설정합니다.

타입: boolean
기본값: true

Empty Data Header Visible

밴드 아이템에 연결한 데이터가 존재하지 않을 경우 Header 영역을 표시할 것인지 설정합니다.

타입: boolean
기본값: false

Empty Data Footer Visible

밴드 아이템에 연결한 데이터가 존재하지 않을 경우 Footer 영역을 표시할 것인지 설정합니다.

타입: boolean
기본값: false

End Row Merged

체크하면 데이터가 없는 빈 행들을 합쳐서 하나의 박스로 보이게 합니다.

타입: boolean
기본값: false

Styles

이름	타입	설명	필수여부
Font Family	string	아이템의 글꼴을 설정합니다.	no
Font Size	number	아이템의 텍스트 크기를 설정합니다.	no
Font Weight	string	아이템의 텍스트 굵기를 설정합니다.	no
Color	string	아이템의 텍스트 색상을 설정합니다.	no
Background Color	string	아이템의 배경 색상을 설정합니다.	no

Box HEADER