문서
sheet
시트 아이템
Text

Text

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

text-item

Basic

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

Excel

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

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

Formula

셀의 값에 관련된 수식을 설정합니다.

  • 타입: string
  • 기본값: undefined

수식 적용 예시

셀 지정 표현식

  • sum("셀 위치값", "셀 위치값")

적용예시)

sum(A1, B1, C1)
A1, B1, C1의 각 셀의 값을 합계 수식으로 설정하는 예시


셀 범위 표현식

  • sum("범위 시작 셀 위치값":"범위 끝 셀 위치값")

적용예시)

sum(A1:C1)
A1 부터 C1 범위의 셀을 합계 수식으로 설정하는 예시


수식 디자인 적용 예시

  1. Formula 속성에 sum("셀위치", "셀위치", ...) 등으로 합계 수식을 설정합니다.

Formula Sum

  1. 적용 모습을 확인합니다.

Formula Sum Preview

밴드에서 수식 적용 예시

밴드 아이템에서는 설정한 데이터에 따라 데이터 행의 갯수가 동적이므로 특정 표현식을 써서 원하는 데이터 밴드 내의 셀 정보를 가져올 수 있습니다.

밴드의 데이터 행에서 현재 행 표현식 사용

현재 데이터행 표현식

  • 밴드기준의 셀 열 위치 + #

적용예시)

B#*C#
데이터 로우 영역에서 데이터가 출력되는 행 기준으로 B열 * C열 수식을 설정한 예시

  1. Formula 속성에 (셀의 열위치 + #) * (셀의 열위치 + #) 표현식으로 데이터 행의 B열 C열을 곱하는 수식을 설정합니다.

Formula Data Current Row

  1. 적용 모습을 확인합니다.

Formula Data Current Row Preview


밴드의 푸터 영역에서 데이터행 표현식 사용

푸터에서 특정 데이터행 표현식

  • 밴드 기준의 셀 열 위치 + 행 숫자

적용예시)

D1
밴드 기준에서 데이터 행 D열의 첫번째 행의 값


푸터에서 마지막 데이터행 표현식

  • 밴드 기준의 셀 열 위치 + _

적용예시)

D_
밴드 기준에서 데이터 행 D열의 마지막 행의 값

  1. Formula 속성에 sum(D1:D_) 표현식으로 데이터 행의 D열의 첫행부터 마지막행까지 합계를 구하는 수식을 설정합니다.

Formula Footer

  1. 적용 모습을 확인합니다.

Formula Footer Sum Preview


Format

셀에 값에 관련된 표현 형식을 설정합니다.

  • 타입: string
  • 기본값: undefined

Event

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

Bound

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

Rotation

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

  • 타입: number
  • 기본값: undefined

Data

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

Link Field

링크기능 사용시 linkUrl 값을 연결할 필드를 선택합니다.

  • 타입: string
  • 기본값: undefined

Merge Rule

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

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

  • 타입: string
  • 기본값: undefined

설명

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

Link

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

Text

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

이름타입설명필수여부
Wrapboolean표시되는 데이터가 텍스트 아이템의 넓이를 넘어설 경우에 줄바꿈 여부를 설정합니다.yes
Multi Lineboolean텍스트 아이템에서 줄바꿈이 가능하도록 설정합니다.no
Textstring텍스트 아이템에 표시될 문구를 설정합니다.no

Wrap

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

  • 타입: boolean
  • 기본값: false

Multi Line

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

  • 타입: boolean
  • 기본값: false

설명

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

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

Text

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

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

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

Editing

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

Editable

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

  • 타입: boolean
  • 기본값: false

Type

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

Internationalization

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

Field

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

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

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

Styles

이름타입설명필수여부
Borderstring아이템의 테두리를 설정합니다.no
Border Leftstring아이템의 왼쪽 테두리를 설정합니다.no
Border Rightstring아이템의 오른쪽 테두리를 설정합니다.no
Border Topstring아이템의 위쪽 테두리를 설정합니다.no
Border Bottomstring아이템의 아래쪽 테두리를 설정합니다.no
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
Paddingstring아이템의 왼쪽 내부 여백을 설정합니다.no