페이지 트리

버전 비교

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.
댓글: 내용 수정 및 버전 추가



page no. 

Showpageid

Start Release No : 7.0.500.20260528-21 / Update Release No :  7.0.500.20260528-21

작성자 :  박주연  / 검수자 :  원강연

1. 기능 설명

a. 업로드 단계에서 용량을 축소해 저장할 수 있도록 Matrix.ShowImageEditor API로 오픈하는 이미지 에디터에 「압축 용량」 입력 필드가 추가되었습니다.

※ 참고: Image 컨트롤로 서버에 이미지를 등록·변경하는 일반 흐름은 이미지 변경하는 방법 가이드를  참고해 주십시오.

b. 이미지 에디터에 붙여넣은 이미지를 삭제하거나 교체할 수 있는 기능도 추가되었습니다.


2. 주요 기능

a. 「압축 용량」 입력 필드 추가

  • Matrix.ShowImageEditor API를 호출하여 이미지 에디터 팝업을 오픈하는 경우에만 압축 용량 입력 필드가 노출됩니다.
  • Image 컨트롤의 이미지 선택 팝업 내 [클립보드 복사]에서 열리는 이미지 에디터는 「압축 용량」 입력 필드가 제공되지 않습니다.


기능

동작

미리보기

압축 용량 값 변경 시 미리보기 화면이 즉시 갱신

압축 용량

목표 용량 (KB) 입력 시 해상도를 자동 축소하여 입력한 용량 (KB) 이하로 저장

원본 용량 표시

붙여 넣은 이미지의 PNG 용량을 입력 필드 우측에 표시 (예: 12.34 KB 형식)


b. 그 외 기능

  • 이미지 삭제·교체 기능은 Matrix.ShowImageEditor API, Image 컨트롤의 이미지 선택 팝업 내 [클립보드 복사] 에서 공통으로 동작합니다.

기능

동작

이미지 삭제

이미지 영역(미리보기 캔버스) 클릭 후 Delete 키를 입력합니다.

이미지 교체

이미지 영역(미리보기 캔버스) 클릭 후 교체할 이미지를 복사하여 Ctrl + V를 통해 붙여넣습니다.


3. 이미지 압축

a. 에디터 열기

아래 예시는 업로드용 버튼(아래 예시의 BTN_UPLOAD)의 클릭 이벤트에서 Matrix.ShowImageEditor API를 호출하여 이미지 에디터를 띄우는 패턴입니다.

    • i-AUD 보고서에 업로드용 버튼(예: BTN_UPLOAD)을 배치한 후, ScriptEditor에서 해당 버튼의 OnClick 이벤트에 Matrix.ShowImageEditor API 호출 코드를 작성합니다. 
    • 보고서 실행 후 사용자가 버튼(예: BTN_UPLOAD)을 클릭하면 이미지 에디터 팝업이 열립니다.

b. 클립보드에 복사된 이미지를 Ctrl+V 로 붙여 넣고, 「압축 용량」 입력 필드 우측에 표시된 현재 이미지의 용량을 확인합니다.

c. 필요 시 「압축 용량」 값을 입력하고 미리보기에서 결과를 확인합니다. 

도움말
title압축 용량 입력 규칙


입력값

동작

0 (기본값)

붙여 넣은 미리보기 이미지를 그대로 업로드 합니다.

양의 정수 N (KB)

파일 크기가 N KB 이하로 이미지 용량을 압축합니다.

    • 음수 / 소수는 입력 필드에서 자동으로 정수로 보정됩니다.

    • 입력 가능한 최댓값은 현재 이미지의 원본 용량으로 자동 설정됩니다. 원본보다 큰 값은 입력할 수 없습니다.

    • 입력 값이 매우 작으면 (예: 1) 해상도가 1×1 픽셀까지 줄어들 수 있습니다. 미리보기에서 결과를 반드시 확인해 주십시오

d. 「압축 용량」 값이 0보다 큰 상태에서 [저장]을 누르면, 미리보기에 보이는 압축 이미지로 업로드할지 묻는 확인창이 표시됩니다. [예] 선택 시 미리보기 상태 그대로 업로드됩니다.


4. 이미지 삭제

a. 이미지 에디터에 이미지가 표시된 상태에서 이미지 영역(미리보기 영역)을 클릭하여 포커스를 둔 후 Delete 키를 누르면 "이미지를 삭제하시겠습니까?" 확인창이 표시됩니다.

b. [예] 선택 시 파일명·「압축 용량」 값(0)·우측 원본 용량 표시가 모두 초기 상태로 돌아갑니다.

      • 단, 텍스트 입력란에 커서가 있을 때는 이미지 삭제가 아니라 해당 입력란의 문자가 지워집니다. 이미지를 삭제하려면 반드시 이미지 영역을 먼저 클릭해 포커스를 옮긴 뒤 Delete 키를 누르십시오.

5. 이미지 교체

a. 이미지 에디터에 이미지가 표시된 상태에서 다른 이미지를 클립보드에 복사한 후, 이미지 영역(미리보기 영역)을 클릭하여 포커스를 둔 후 Ctrl + V 를 누르면 새 이미지로 즉시 교체됩니다.

b. 이미지 교체 시 파일명·「압축 용량」 값(0)은 초기 상태로 돌아가고, 우측의 원본 용량 표시는 새 이미지 기준으로 갱신됩니다.


도움말
titleMatrix.ShowImageEditor

Matrix.ShowImageEditor는 서버에 이미지를 업로드하는 이미지 에디터 팝업을 표시하는 API입니다.

  • 서버 업로드 경로: {REPORTPATH}/WEB_IMAGES
코드 블럭
languagejs
Matrix.ShowImageEditor(function (p) {
	// callback function
	// p.FolderName;
	// p.ImageName;
	// p.ImageWidth;
	// p.ImageHeight;
});


※ CallBack 함수로 넘어오는 파라미터

변수명데이터 형식설명
FolderNamestring서버에 저장된 이미지 경로(reports 폴더 하위)
ImageNamestring이미지 이름 ( 예: sample.png)
ImageWidthnumber이미지 너비 (단위 : px)
ImageHeightnumber이미지 높이 (단위 : px)



참고사항
title주의 사항
  • 이번 핫핏스 이전에 이미 보고서에 저장되어 있는 이미지는 자동으로 압축되지 않습니다. 압축 기능은 이번 핫핏스 이후 새로 붙여 넣어 업로드하는 이미지에만 적용됩니다.

  • 「압축 용량」 의 기본값은 0 (압축 안 함) 이므로, 명시적으로 값을 입력하지 않는 한 기존과 동일하게 동작합니다.

  • 이미지 압축해상도를 줄이는 방식으로 동작합니다. 입력한 값이 작을수록 이미지가 더 흐려질 수 있으니 미리보기에서 결과를 확인해 주십시오.

  • 압축한 이미지를 i-AUD 보고서 내 큰 영역에 배치하면 흐릿하게 보일 수 있습니다. 입력값을 단계적으로 조정하며 미리보기에서 결과를 확인한 뒤 저장해 주십시오.
  • 한 번 압축되어 저장된 이미지는 원본으로 되돌릴 수 없습니다. 원본 파일이 필요한 경우 별도로 보관해 주십시오.


  • 변경 사항

    변경 전변경 후릴리즈 번호

    Matrix.ShowImageEditor API로 오픈한 이미지 에디터 (압축 UI / 삭제·교체 동작 없음)


    Image 컨트롤 > [이미지 선택] > [클립보드 복사] 로 오픈한 이미지 에디터 (삭제·교체 불가)

    Matrix.ShowImageEditor API로 오픈한 이미지 에디터 (압축 UI + 삭제·교체 동작 추가)


    Image 컨트롤 > [이미지 선택] > [클립보드 복사] 로 오픈한 이미지 에디터 (삭제·교체 동작 추가)


    7.0.500.20260528-21





기능 정보
  •  API Open
  •  UI Open
  •  Read Only
  •  Not Use
  •  Hidden
  •  Not Recommend
  •  해당 없음
시작 버전 정보
  • 7.0.500.20260528-21


정보
title샘플 정보
  • 샘플 URL :
  • 샘플 파일

첨부 파일
patterns.*jsp,.*zip,.*xml,.*js,.*mtsd,.*xlsx,.*xlsb,.*mtzb,.*mtvx,.*mtx,.*mtxz,.*mtsz


페이지 속성
hiddentrue


정보
titleBCRM 정보


(BCRM#G2107) 이미지 업로드 시 용량 자동으로 줄일 수 있는 방법 문의