Summary

요약정보를 표시할 때 사용하는 아이템 입니다.

summary-item

Basic

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

Excel

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

이름	타입	설명	필수여부
Row	number	셀의 행 위치값을 설정합니다.	yes
Col	number	셀의 열 위치값을 설정합니다.	yes
Row Span	number	셀의 행 병합을 설정합니다.	no
Col Span	number	셀의 열 병합을 설정합니다.	no
Format	string	셀에 값에 관련된 표현 형식을 설정합니다.	no

Event

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

Bound

이름	타입	설명	필수여부
Rotation	number	아이템의 회전 각도를 설정합니다.	no

Rotation

아이템의 회전 각도를 설정합니다.

타입: number
기본값: undefined

Data

이름	타입	설명	필수여부
Data	string	아이템에 리포트에 존재하는 데이터를 연결합니다.	no
Value	string	아이템에 연결된 데이터에서 표시할 필드를 선택하거나 ContextData를 입력 합니다.	no
Expression	string	아이템에 연결된 데이터를 어떤 방법으로 표현할 지 표현식을 설정합니다.	no

Expression

요약 아이템에 표시되는 모양을 지정한다.

타입: string
기본값: undefined

설명

요약 아이템에 Band Data가 연결되어 있을 경우 특정 필드의 여러 개의 값을 합계 | 합산 | 최소 | 최대 | 평균 값으로 요약하여 표시한다.

ℹ️

사용법 예시

order

// 요약 아이템의 Data 속성에 `order` 데이터로 Value 속성에 `money` 필드로 설정
[
    { "orderId" : 1, "money": 10000 },
    { "orderId" : 2, "money": 20000 },
    { "orderId" : 3, "money": 30000 },
]

Expression 설정

합계: Sum(money) = 60000 으로 표시
합산: Count(money) = 3 으로 표시
최소: Min(money) = 10000 으로 표시
최대: Max(money) = 30000 으로 표시
평균: Avg(money) = 20000 으로 표시
필드값: Group(money) = 10000 으로 표시

그룹에서 요약 아이템을 사용하는 경우 그룹 내 첫번째 데이터행을 표시할 수 있습니다.

ℹ️

사용법 예시

order

// 요약 아이템의 Data 속성에 `order` 데이터로 Value 속성에 `money` 필드로 설정
[
    { "orderId" : 1, "money": 10000 },
    { "orderId" : 2, "money": 20000 },
    { "orderId" : 3, "money": 30000 },
]

Expression 설정

그룹 내 첫번쩨 데이터행: Group(money) = 10000 으로 표시

Text

텍스트 아이템에서 사용되는 속성

이름	타입	설명	필수여부
Wrap	boolean	표시되는 데이터가 텍스트 아이템의 넓이를 넘어설 경우에 줄바꿈 여부를 설정합니다.	yes
Multi Line	boolean	텍스트 아이템에서 줄바꿈이 가능하도록 설정합니다.	no
Number Format	string	요약 아이템에 연결된 데이터 타입이 `number`일 경우에 표현 방식을 설정합니다.	no

Wrap

표시되는 데이터가 텍스트 아이템의 넓이를 넘어설 경우에 줄바꿈 여부를 설정합니다. 이때 Width가 명시적으로 입력되지 않은 경우 wrap 속성은 적용되지 않습니다.

타입: boolean
기본값: false

Multi Line

텍스트 아이템에서 줄바꿈이 가능하도록 설정합니다.

타입: boolean
기본값: false

설명

true로 설정할 경우 문자열에 줄바꿈 기능의 문자가 포함된 경우 출력시 해당 위치에서 줄바꿈 됩니다. 줄바꿈 문자는 아래와 같습니다.

<br> | <br/>
이스케이프 문자: \r | \n | \r\n

Number Format

텍스트 아이템에 연결된 데이터 타입이 number일 경우에 표현 방식을 설정합니다.

타입: string
기본값: #,##0

설명

0의 의미는 고정된 자리를 의미하고, #은 가변 자리를 의미합니다.

ℹ️

사용법 예시
#,##0.### 의 경우

100 -> 100
10000 -> 10,000
100.1 -> 100.1
1000.12 -> 1,000.12
1000.1234 -> 1,000.123
1000.1237 -> 1,000.124

#,##0.000 의 경우

100 -> 100.000
10000 -> 10,000.000
100.1 -> 100.100
1000.12 -> 1,000.120
1000.1234 -> 1,000.123
1000.1237 -> 1,000.124

#,##0.0## 의 경우

100 -> 100.0
10000 -> 10,000.0
100.1 -> 100.1
1000.12 -> 1,000.12
1000.1234 -> 1,000.123
1000.1237 -> 1,000.124

Styles

이름	타입	설명	필수여부
Border	string	아이템의 테두리를 설정합니다.	no
Border Left	string	아이템의 왼쪽 테두리를 설정합니다.	no
Border Right	string	아이템의 오른쪽 테두리를 설정합니다.	no
Border Top	string	아이템의 위쪽 테두리를 설정합니다.	no
Border Bottom	string	아이템의 아래쪽 테두리를 설정합니다.	no
Font Family	string	아이템의 글꼴을 설정합니다.	no
Font Size	number	아이템의 텍스트 크기를 설정합니다.	no
Font Style	string	아이템의 글꼴체를 설정합니다.	no
Text Decoration	string	아이템의 텍스트에 선 스타일을 설정합니다.	no
Font Weight	string	아이템의 텍스트 굵기를 설정합니다.	no
Color	string	아이템의 텍스트 색상을 설정합니다.	no
Background Color	string	아이템의 배경 색상을 설정합니다.	no
Text Align	string	아이템의 텍스트 가로 정렬을 설정합니다.	no
Vertical Align	string	아이템의 세로 정렬을 설정합니다.	no
Padding	string	아이템의 왼쪽 내부 여백을 설정합니다.	no

Image Barcode