개요

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

tableband-item-sample

ℹ️

테이블 밴드에서 각각의 셀은 하나의 리포트 아이템만 사용 가능합니다.

💡

몇 번째 밴드인지 순서 정보가 섹센헤드에 표시됩니다.

tableband-section-head

테이블 밴드 디자인

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

사용 예시

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

table-band-item-design

Basic

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

Design

이름	타입	설명	필수여부
Design Border	boolean	아이템의 디자인 가능한 경계 영역의 표시를 설정합니다.	yes
Design Width	number	아이템의 디자인 가능한 경계 영역의 넓이를 설정합니다.	no
Design Height	number	아이템의 디자인 가능한 경계 영역의 높이를 설정합니다.	no

Event

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

Bounds

이름	타입	설명	필수여부
Width	number	아이템의 넓이를 설정합니다.	no
Height	number	아이템의 높이를 설정합니다.	no
Left	number	아이템의 위치를 부모 요소 기준으로 "왼쪽"에서 설정합니다.	no
Right	number	아이템의 위치를 부모 요소 기준으로 "오른쪽"에서 설정합니다.	no

Data

이름	타입	설명	필수여부
Data	string	아이템에 리포트에 존재하는 데이터를 연결합니다.	no
Value	string	아이템에 연결된 데이터에서 표시할 필드를 설정합니다.	no
Max Row Count	number	아이템이 Band에 해당되는 경우 데이터가 표시될 수 있는 최대행을 설정합니다.	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
Always Header	boolean	`Data Row`에서 데이터의 길이가 페이지를 넘어갈 경우 항상 `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의 데이터가 다음 페이지로 넘어갈 경우, Band Header영역을 반복해서 표시할 것인지 설정합니다.

타입: boolean
기본값: true

Always Header

페이지 상단에 Band Footer영역만 존재할 경우, Band Header영역을 표시할 것인지 설정합니다.

타입: boolean
기본값: true

Empty Data Header Visible

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

타입: boolean
기본값: false

Empty Data Footer Visible

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

타입: boolean
기본값: false

End Row Merged

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

타입: boolean
기본값: false

Sub Band

서브 밴드 카테고리는 서브 밴드 페이지에서만 사용할 수 있습니다.

서브 밴드 페이지에서 마스터 밴드와 연결해야 할 정보에 대한 속성

이름	타입	설명	필수여부
Master Band Name	string	일반 페이지에서 연결할 마스터 밴드 `name` 속성값을 설정합니다.	yes
Master Band Key Fields	string	연결한 마스터 밴드에서 마스터 디테일 관계의 기준이 되는 데이터 필드를 설정합니다.	yes
Sub Band Key Fields	string	연결한 마스터 밴드의 Master Band Key Fields 속성의 데이터 필드와 관계가 있는 서브 밴드 쪽 데이터 필드를 설정합니다.	yes

Master Band Name

일반 페이지에서 연결할 마스터 밴드 name 속성값

타입: string
기본값: undefined

Master Band Key Fields

연결한 마스터 밴드에서 마스터 디테일 관계의 기준이 되는 데이터 필드 설정값

타입: string
기본값: undefined

Sub Band Key Fields

연결한 마스터 밴드의 Master Band Key Fields 속성의 데이터 필드와 관계가 있는 서브 밴드 쪽 데이터 필드 설정값

타입: string
기본값: undefined

Table

테이블 구성에 대한 속성

이름	타입	설명	필수여부
Col Count	number	테이블 밴드의 열의 개수를 지정합니다.	yes

Col Count

테이블 밴드의 열의 개수를 지정합니다.

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

Styles

이름	타입	설명	필수여부
Font Family	string	아이템의 글꼴을 설정합니다.	no
Font Size	number	아이템의 텍스트 크기를 설정합니다.	no
Font Weight	string	아이템의 텍스트 굵기를 설정합니다.	no
Color	string	아이템의 텍스트 색상을 설정합니다.	no
Background Color	string	아이템의 배경 색상을 설정합니다.	no
Padding Left	string	아이템의 왼쪽 내부 여백을 설정합니다.	no
Padding Top	string	아이템의 위쪽 내부 여백을 설정합니다.	no
Padding Right	string	아이템의 오른쪽 내부 여백을 설정합니다.	no
Padding Bottom	string	아이템의 아래쪽 내부 여백을 설정합니다.	no

Cell Item

표 아이템 안에 구성되는 셀 아이템입니다.

Cell

이름	타입	설명	필수여부
Row	readonly number	표 아이템 안에서 셀 아이템의 행의 인덱스를 표시한다.	yes
Col	readonly number	표 아이템 안에서 셀 아이템의 열의 인덱스를 표시한다.	yes
Rowspan	number	셀 아이템의 행 병합 개수를 지정한다.	no
Colspan	number	셀 아이템의 열 병합 개수를 지정한다.	no
Apply End Styles	boolean	true로 설정 할 경우 마지막으로 표시되는 셀 스타일로 모든 셀의 스타일을 적용합니다.	no
Auto Merge	boolean	true로 설정할 경우 같은 데이터가 연속으로 표시되는 셀을 자동으로 병합합니다.	no

Row

표 아이템 안에서 셀 아이템의 행의 인덱스를 표시합니다.

타입: readonly number

Col

표 아이템 안에서 셀 아이템의 열의 인덱스를 표시합니다.

타입: readonly number

Rowspan

셀 아이템의 행 병합 개수를 지정한다.

타입: number
기본값: 0

Colspan

셀 아이템의 열 병합 개수를 지정한다.

타입: number
기본값: 0

Apply End Styles

true로 설정할 경우 마지막으로 표시되는 셀 스타일로 모든 셀의 스타일을 적용합니다.

타입: boolean
기본값: false

Auto Merge

true로 설정할 경우 같은 데이터가 연속으로 표시되는 셀을 자동으로 병합합니다.

타입: boolean
기본값: false

Styles

이름	타입	설명	필수여부
Cell Align	string	셀안의 아이템의 좌우 정렬을 설정합니다.	no
Vertical Align	string	셀안의 아이템의 수직 정렬을 설정합니다.	no
Background Color	string	셀의 배경 색상을 설정합니다.	no
Padding	string	셀의 내부 여백을 설정합니다.	no
Padding Left	string	셀의 왼쪽 내부 여백을 설정합니다.	no
Padding Top	string	셀의 위쪽 내부 여백을 설정합니다.	no
Padding Right	string	셀의 오른쪽 내부 여백을 설정합니다.	no
Padding Bottom	string	셀의 아래쪽 내부 여백을 설정합니다.	no
Border	string	아이템의 테두리를 설정합니다.	no
Border Left	string	아이템의 왼쪽 테두리를 설정합니다.	no
Border Right	string	아이템의 오른쪽 테두리를 설정합니다.	no
Border Top	string	아이템의 위쪽 테두리를 설정합니다.	no
Border Bottom	string	아이템의 아래쪽 테두리를 설정합니다.	no

DETAILS HEADER