🎉 리얼리포트 1.8.8 버전이 출시되었습니다. 자세히 보기 →
문서
리포트 아이템
Table Band
개요

개요

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

tableband-item-sample

ℹ️

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

테이블 밴드 디자인

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

사용 예시

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

table-band-item-design

Basic

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

Design

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

Event

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

Bounds

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

Data

이름타입설명필수여부
Datastring아이템에 리포트에 존재하는 데이터를 연결합니다.no
Valuestring아이템에 연결된 데이터에서 표시할 필드를 설정합니다.no
Max Row Countnumber아이템이 Band에 해당되는 경우 데이터가 표시될 수 있는 최대행을 설정합니다.no

Sort Field

정렬 기준 필드를 설정합니다.

  • 타입: string
  • 기본값: undefined
ℹ️

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

Sort Direction

정렬 방향을 설정합니다.

  • 타입: ascending | descending
  • 기본값: undefined
ℹ️

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

Band

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

이름타입설명필수여부
Section CountnumberData Row 영역에서 몇 개의 단으로 나눌지 설정합니다.yes
Section LayoutstringData Row 영역에서 단나누기할 때 데이터의 방향을 설정합니다.yes
Section GapnumberData Row 영역에서 단나누기 간격을 설정합니다.yes
Rows Per Pagenumber페이지당 Data Row에 출력될 행의 수를 설정합니다.no
Max Rows Per Pagenumber페이지당 Data Row에 출력될 최대 행의 수를 설정합니다.no
Repeat Master Rowboolean마스터 디테일 형태에서 마스터 데이터의 반복 출력 여부를 설정합니다.yes
End Row Countnumber데이터행 수와 상관없이 마지막 페이지에 표시돼야 할 행의 수를 설정합니다.no
Max End Row Countnumber마지막 페이지에 표시돼야 할 데이터의 빈 행의 개수를 설정합니다.no
End Row MessagenumberData Row에서 빈 행 출력 시 첫줄에 표시 할 문구를 설정합니다.no
Always HeaderbooleanData Row에서 데이터의 길이가 페이지를 넘어갈 경우 항상 Header 영역을 표시할 것인지 설정합니다.yes
No Splitboolean체크하면 테이블 밴드를 다른 페이지에 분리하여 표시합니다.yes
Empty Data Header Visibleboolean밴드 아이템에 연결한 데이터가 존재하지 않을 경우 Header 영역을 표시할 것인지 설정합니다.yes
Empty Data Footer Visibleboolean밴드 아이템에 연결한 데이터가 존재하지 않을 경우 Footer 영역을 표시할 것인지 설정합니다.yes
End Row Mergedboolean체크하면 데이터가 없는 빈 행들을 합쳐서 하나의 박스로 보이게 합니다.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 Namestring일반 페이지에서 연결할 마스터 밴드 name 속성값을 설정합니다.yes
Master Band Key Fieldsstring연결한 마스터 밴드에서 마스터 디테일 관계의 기준이 되는 데이터 필드를 설정합니다.yes
Sub Band Key Fieldsstring연결한 마스터 밴드의 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 Countnumber테이블 밴드의 열의 개수를 지정합니다.yes

Col Count

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

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

Styles

이름타입설명필수여부
Font Familystring아이템의 글꼴을 설정합니다.no
Font Sizenumber아이템의 텍스트 크기를 설정합니다.no
Font Weightstring아이템의 텍스트 굵기를 설정합니다.no
Colorstring아이템의 텍스트 색상을 설정합니다.no
Background Colorstring아이템의 배경 색상을 설정합니다.no
Padding Leftstring아이템의 왼쪽 내부 여백을 설정합니다.no
Padding Topstring아이템의 위쪽 내부 여백을 설정합니다.no
Padding Rightstring아이템의 오른쪽 내부 여백을 설정합니다.no
Padding Bottomstring아이템의 아래쪽 내부 여백을 설정합니다.no

Cell Item

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

Cell

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

Row

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

  • 타입: readonly number

Col

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

  • 타입: readonly number

Rowspan

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

  • 타입: number
  • 기본값: 0

Colspan

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

  • 타입: number
  • 기본값: 0

Apply End Styles

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

  • 타입: boolean
  • 기본값: false

Auto Merge

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

  • 타입: boolean
  • 기본값: false
DETAILSHEADER