문서
email
이메일 아이템
테이블 밴드
개요

개요

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

tableband-item-sample

ℹ️

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

🔥

테이블 아이템의 셀안에 테이블 아이템을 포함할 수 없습니다.

테이블 밴드 디자인

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

사용 예시

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

table-band-item-design

Basic

이름타입설명필수여부
Namestring아이템에 고유한 이름을 설정합니다.no
Visibleboolean아이템의 표시 여부를 설정합니다.yes

Event

이름타입설명필수여부
OnGetVisibleEmailItemVisibleCallback아이템의 표시 여부를 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다.no

Bounds

이름타입설명필수여부
Widthnumber아이템의 넓이를 설정합니다.no

Data

이름타입설명필수여부
Datastring아이템에 리포트에 존재하는 데이터를 연결합니다.no
Sort Fieldstring아이템에 연결된 데이터에서 정렬 기준 필드를 설정합니다.no
Sort Directionnumber정렬 방향을 설정합니다.no

Sort Field

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

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

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

Sort Direction

정렬 방향을 설정합니다.

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

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

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 Topstring아이템의 위쪽 내부 여백을 설정합니다.no
Padding Bottomstring아이템의 아래쪽 내부 여백을 설정합니다.no

Cell Item

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

Cell

이름타입설명필수여부
Rowreadonly number표 아이템 안에서 셀 아이템의 행의 인덱스를 표시한다.yes
Colreadonly number표 아이템 안에서 셀 아이템의 열의 인덱스를 표시한다.yes
Rowspannumber셀 아이템의 행 병합 개수를 지정한다.no
Colspannumber셀 아이템의 열 병합 개수를 지정한다.no

Row

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

  • 타입: readonly number

Col

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

  • 타입: readonly number

Rowspan

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

  • 타입: number
  • 기본값: 0

Colspan

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

  • 타입: number
  • 기본값: 0