개요

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

simpleband-item-sample

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
Empty Data Header Visible	boolean	밴드 아이템에 연결한 데이터가 존재하지 않을 경우 `Header` 영역을 표시할 것인지 설정합니다.	yes
Empty Data Footer Visible	boolean	밴드 아이템에 연결한 데이터가 존재하지 않을 경우 `Footer` 영역을 표시할 것인지 설정합니다.	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

Max End Row Count

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

타입: number
기본값: undefined

End Row Message

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

타입: string
기본값: 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

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

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

Plot Lines HEADER