문서
리포트 아이템
Text

Text

텍스트를 표시할 때 사용하는 아이템입니다.

text-item-sample

Basic

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

Design

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

Event

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

Bound

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

Data

이름타입설명필수여부
Datastring아이템에 리포트에 존재하는 데이터를 연결합니다.no
Valuestring아이템에 연결된 데이터에서 표시할 필드를 선택하거나 ContextData를 입력 합니다.no
Link Fieldstring링크기능 사용시 linkUrl 값을 연결할 필드를 선택합니다.no
Merge Rulestring다음행과 병합해야 할 조건을 설정합니다.no

Merge Rule

Table Band 아이템의 Data Row 영역 안에서만 적용되는 규칙입니다.

다음행과 병합해야 할 조건을 설정합니다.

  • 타입: string
  • 기본값: undefined

설명

  • value로 설정하면 다음행의 값이 같은 경우에 자동으로 행을 병합합니다.
  • :필드명 데이터의 필드명으로 설정하면 다음 데이터 행의 설정한 필드명과 데이터가 같은 경우 자동으로 행을 병합합니다.

필드명 설정하기 예시

제조회사쪽 열을 모델명 데이터 필드를 기준으로 자동 행 병합 설정

merge-rule-design

merge-rule-preview

Link

이름타입설명필수여부
LinkUrlstring이 속성에 url 입력하면 미리보기 상태에서 클릭시 웹 브라우저에서 해당 url로 이동합니다.no
LinkTargetstring링크기능 사용시 브라우저의 실행 타겟 (opens in a new tab)을 지정합니다.no

Text

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

이름타입설명필수여부
Wrapboolean표시되는 데이터가 텍스트 아이템의 넓이를 넘어설 경우에 줄바꿈 여부를 설정합니다.yes
Multi Lineboolean텍스트 아이템에서 줄바꿈이 가능하도록 설정합니다.no
Boolean Formatstring텍스트 아이템에 연결된 데이터 타입이 boolean일 경우에 표현 방식을 설정합니다.no
Number Formatstring텍스트 아이템에 연결된 데이터 타입이 number일 경우에 표현 방식을 설정합니다.no
Date Formatstring텍스트 아이템에 연결된 데이터 타입이 Date일 경우에 표현 방식을 설정합니다.no
Text Formatstring텍스트 아이템에 연결된 데이터 타입이 Text일 경우에 표현식을 설정합니다.no
Prefixstring텍스트 아이템에서 표시되는 값에 접두사를 설정합니다.no
Suffixstring텍스트 아이템에서 표시되는 값에 접미사를 설정합니다.no
Textstring텍스트 아이템에 표시될 문구를 설정합니다.no
Richboolean텍스트 아이템에 특정 Html 태그 사용을 허용합니다.yes

Wrap

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

  • 타입: boolean
  • 기본값: false

Multi Line

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

  • 타입: boolean
  • 기본값: false

설명

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

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

Boolean Format

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

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

설명

콜론(:)을 기준으로"false 문구":"true 문구" 표현 방식을 설정합니다.

ℹ️

사용법 예시

  • 미확인:확인 으로 설정
  • 데이터가 false일 경우 "미확인"으로 표기
  • 데이터가 true일 경우 "확인"으로 표기
⚠️

Data Value가 연결되어 있는 경우에만 적용됩니다.

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

Date Format

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

  • 타입: string
  • 기본값: yyyy.MM.dd
ℹ️

사용법 예시

  • yyyy-MM-dd: "2022-01-01"로 표시합니다.
  • yyyy년 MM월 dd일: "2022년 01월 01일"로 표시합니다.
⚠️

Data Value가 연결되어 있는 경우에만 적용됩니다.

Text Format

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

  • 타입: string
  • 기본값: undefined

설명

세미콜론(;)을 기준으로 왼쪽에는 변경될 표현식을 설정하고, 오른쪽에는 javascript string.prototpye.replace() (opens in a new tab) 함수의 두 번째 매개변수와 같은 타입으로 지정합니다.

ℹ️

사용법 예시

  • Mr. 홍길동: ([A-Za-z]*);Mr. $1,
  • 사업자번호: (\d{3})(\d{2})(\d{5});$1-$2-$3
⚠️

Data Value가 연결되어 있는 경우에만 적용됩니다.

Prefix

텍스트 아이템에서 표시되는 값에 접두사를 설정합니다.

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

Data Value가 연결되어 있는 경우에만 적용됩니다.

Suffix

텍스트 아이템에서 표시되는 값에 접미사를 설정합니다.

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

Data Value가 연결되어 있는 경우에만 적용됩니다.

Text

텍스트 아이템에 표시될 문구를 설정합니다.

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

Data Value가 연결되어 있을 경우 연결된 데이터로 표시됩니다.

Rich

텍스트 아이템에서 특정 Html Tag 사용을 허용합니다.

  • 타입: boolean
  • 기본값: false

사용 가능한 태그

  • <b>
  • <u>
  • <span>

사용 가능한 스타일 속성

  • color

예시)

<span style="color:red">텍스트 아이템 문구</span>
⚠️
  1. 허용한 태그 및 스타일 이외의 내용으로 사용시 출력 및 내보내기를 지원하지 않습니다.
  2. 문서 내보내기에서 Rich 속성은 PDF 내보내기만 지원합니다.

Editing

미리보기에서 편집이 가능하도록 설정하는 속성

Editable

텍스트 아이템을 미리보기에서 편집 가능하도록 설정합니다.

  • 타입: boolean
  • 기본값: false

Type

편집기의 종류를 설정합니다.

Internationalization

다국어 관련 정보를 설정하는 속성

Field

다국어 설정에서 연결할 필드를 설정합니다.

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

Data Value가 연결되어 있을 경우 연결된 데이터로 표시됩니다.

Styles

이름타입설명필수여부
Font Familystring아이템의 글꼴을 설정합니다.no
Font Sizenumber아이템의 텍스트 크기를 설정합니다.no
Font Stylestring아이템의 글꼴체를 설정합니다.no
Text Decorationstring아이템의 텍스트에 선 스타일을 설정합니다.no
Font Weightstring아이템의 텍스트 굵기를 설정합니다.no
Colorstring아이템의 텍스트 색상을 설정합니다.no
Background Colorstring아이템의 배경 색상을 설정합니다.no
Text Alignstring아이템의 텍스트 가로 정렬을 설정합니다.no
Vertical Alignstring아이템의 세로 정렬을 설정합니다.no
Writing Modestring아이템의 텍스트가 배치되는 방향을 설정합니다.no
Padding Leftstring아이템의 왼쪽 내부 여백을 설정합니다.no
Padding Topstring아이템의 위쪽 내부 여백을 설정합니다.no
Padding Rightstring아이템의 오른쪽 내부 여백을 설정합니다.no
Padding Bottomstring아이템의 아래쪽 내부 여백을 설정합니다.no
Borderstring아이템의 테두리를 설정합니다.no
Border Leftstring아이템의 왼쪽 테두리를 설정합니다.no
Border Rightstring아이템의 오른쪽 테두리를 설정합니다.no
Border Topstring아이템의 위쪽 테두리를 설정합니다.no
Border Bottomstring아이템의 아래쪽 테두리를 설정합니다.no