작성자 : 장민지 / 검수자 : -
Release No. 7.0.500.20260122-11
개요
서버에 이미지를 업로드하고, 이를 Image 컨트롤에 연결하여 보고서에 활용하는 방법을 설명합니다.
업로드된 이미지는 서버의 공용 경로에 저장되어 다른 보고서에서도 재사용할 수 있습니다.
설정 화면 실행
1. Image 컨트롤 생성
2. 우측 속성 영역의 [Image] > 더보기 버튼 클릭
OnImage
마우스 오버 시 이미지를 변경하려면 [OnImage] 속성을 설정합니다.
화면 구성 설명
1. 이미지 목록
서버에 등록된 이미지 파일들을 보여줍니다.
[Preview] 탭(미리보기) 또는 [List] 탭(목록형)을 선택할 수 있습니다.
이미지 우클릭 시 해당 파일을 다운로드 또는 삭제할 수 있습니다.
2. 선택한 이미지 정보
선택된 이미지의 상세 정보(파일명, 크기, 미리보기 등)를 표시합니다.
3. 이미지 추가
서버 업로드 경로: {ContextRoot}/reports/WEB_IMAGES
- 클립보드 복사: 복사한 이미지 파일 붙여넣기 및 파일명 지정
추가: 로컬 PC에 저장된 이미지 파일 업로드
파일명 지정 방법
추가 버튼을 누르기 전,
[원본 파일명] 체크: 로컬 PC의 파일명 그대로 서버에 저장합니다.
[원본 파일명] 해제: 시스템이 생성한 고유한 난수 코드로 파일명이 자동 변환되어 저장됩니다.
이미지 등록 및 적용하기
Step 1. 이미지 파일 업로드
Case 1. 로컬 파일 업로드하여 적용하기
- [추가] 버튼을 클릭합니다.
- 파일 탐색기 창이 열리면 업로드할 이미지 파일((jpg, png, gif 등)을 선택하고 [열기]를 누릅니다.
Case 2. 클립보드 이미지 붙여넣기
- PC에서 캡처 도구 등을 사용해 이미지를 복사합니다.
- [클립보드 복사] 버튼을 클릭합니다.
- '이미지 저장' 팝업창이 뜨면 [Ctrl + v] 키를 눌러 이미지를 붙여넣기 합니다.
- 저장할 파일명을 입력하고 [확인]을 누릅니다.
Step 2. 이미지 파일 선택 및 적용
- 이미지 목록에 추가된 파일을 선택합니다.
- 하단의 [확인] 버튼을 클릭하면 컨트롤에 이미지가 적용됩니다.
개발자를 위한 Tip
Q1. 초기화는 어디에서 설정하나요?
A1. 변수 선언이나 UI 초기 세팅은 [OnDocumentLoadComplete] 시점에 작성하는 것이 가장 적절합니다.
Q2. 데이터 후처리는 어디에서 설정하나요?
A2. 데이터를 받아온 후 특정 셀의 색상을 바꾸거나 계산을 해야 한다면 [OnDataBindEnd] 시점이 적절합니다. 데이터가 화면에 뿌려진 직후이기 때문입니다.




