페이지 트리

버전 비교

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



page no. 

Showpageid

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

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

1. 기능 설명

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

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

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


2. 주요 기능

a. 화면 설명

[이미지 에디터 화면 추가]

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

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

Image Added


기능

동작

미리보기

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

압축 용량

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

원본 용량 표시

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


b. 그 외 기능

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

기능

동작

이미지 삭제

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

이미지 교체

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


3. 이미지 압축

a. 보고서에서 ScriptEditor를 열어,  에디터 열기

ImageSelector 등 다른 경로에서 이미지 에디터가 열리는 경우 「압축 용량」 입력 필드가 출력되지 않습니다

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

  • 해당 API 경로에서만 압축 용량 입력 필드와 삭제 안내 라벨이 노출됩니다.
  • 띄우는 패턴입니다.

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

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

    [이미지 붙여넣고 현재 이미지 용량 부분 이미지 추가]Image Added

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

    Image Added

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


    입력값

    동작

    0 (기본값)

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

    양의 정수 N (KB)

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

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

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

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

    d. 「압축 용량」 값이 0보다 큰 상태에서 [저장] 버튼을 클릭하여 업로드합니다.

    저장하면 미리보기에 보이는 이미지가 그대로 업로드 됩니다

    을 누르면, 미리보기에 보이는 압축 이미지로 업로드할지 묻는 확인창이 표시됩니다. [예] 선택 시 미리보기 상태 그대로 업로드됩니다.


    4. 이미지 삭제

    Image Added

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

    b. [예] 선택 시 화면이 초기 상태로 돌아가고, 입력 값도 함께 초기화됩니다.파일명·「압축 용량」 값(0)·우측 원본 용량 표시가 모두 초기 상태로 돌아갑니다.

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

    5. 이미지 교체

    Image Added

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

    b. 이미지 교체 시 「압축 파일명·「압축 용량」 값은 0 으로, 값(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 컨트롤 > [이미지 선택] > [클립보드 복사] 로 오픈한 이미지 에디터 (삭제·교체 불가)

      Image Added

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

      Image Added


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

      Image Added

      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) 이미지 업로드 시 용량 자동으로 줄일 수 있는 방법 문의