Matrix.ExportImageEx, ScriptAPI 추가
Start Release No : / Update Release No :
프로젝트명 : (BCRM#D2467) [i-AUD] Matrix.ExportImage()로 Group 컨트롤을 이미지로 다운받을 때 제대로 나오지 않는 현상
작성자 : 김예슬 / 검수자 : 이경륜
| 기능 정보 |
|
|
|
|
|
|
|---|
기능 설명
ExportImageEX(controlNames, exportType, option)
개요
'ExportImageEx' API는 보고서 내의 컨트롤들을 이미지 형식으로 내보내는 기능을 제공합니다.
기존의 'ExportImage'함수를 대체하면서 발생하던 오류를 수정한 향상된 API 입니다.
이를 통해 원하는 형식의 확장자로 이미지를 공유하거나 문서화할 수 있습니다.
API 구조
ExportImageEx(controlNames, exportType, option)
| parameter | Data Type | Default Value | 설명 |
|---|---|---|---|
| controlNames | string[] | controlNames | 이미지로 내보내기 할 컨트롤명을 배열로 전달 빈 배열을 전달받으면, 현재 Form 의 전체 컨트롤들을 이미지로 내보낸다 |
| exportType | number | 6 | 내보내기 할 파일의 확장자를 전달 ( enum 값 ) |
| option | object ( optional ) | { fileName: Matrix.GetReportInfo().NAME, useDocHeaderTitle: true callbackFunc: null } | 내보내기 할 파일명과 내보내기가 끝난 뒤 실행되는 콜백 함수를 객체의 형태로 전달 # fileName : 다운로드 되는 파일명 # useDocHeaderTitle : exportType 유형이 문서형인 경우, 문서 타이틀에 [다운로드 파일명] 과 동일한 제목을 사용할 지 여부 옵션 ( Default : true ) ※ 텍스트 변경 불가 # callbackFunc : 작업이 마무리 된 후, 호출되는 함수 |
ExportImageEx 함수에서 지원하는 exportType 형식입니다.
| exportType | 파일 형식 |
|---|---|
| 2 | Excel |
3 | HML |
| 4 | PPT |
| 5 | DOC |
| 6 | PNG |
| 7 |
사용 예시
function callback(){
console.log('image export operation has been successfully completed !!');
}
/**************************************
* 버튼 컨트롤이 클릭되는 시점에 발생합니다.
* * arguments :
* string Id (Readonly:False) : 컨트롤이름
* string Text (Readonly:False) : 라벨 값
**************************************/
var OnButtonClick = function(sender, args){
Matrix.ExportImageEx(['Chart'], 6, {
fileName: Matrix.GetReportInfo().NAME,
useDocHeaderTitle: true,
callbackFunc: callback
});
};
적용 화면
| 컨트롤 한 개만 출력 | 여러 컨트롤들을 출력 |
|---|---|
이미지 크기는 컨트롤의 크기입니다. |
이미지 크기는 form의 크기입니다. 또한, 배경색은 form의 배경색과 동일합니다. |
필수 옵션
- 기존의 ExportImage 함수도 사용 가능하나, API 문서에는 ExportImageEx 함수만 제공됩니다.
제약 사항
- Chart 컨트롤을 내보냈을 때 차트의 형태가 제대로 표현되지 않는 경우에는 차트의 Animation 속성을 조절해 주세요.
- HighChart-Ex 컨트롤을 이미지로 내보내기 위해서는 차트 스크립트에 accessibility: { enabled: false } 속성을 추가하셔야 합니다.
변경 전/후 제품 버전 | 변경 전(제품 버전) |
|---|---|
변경 전 |
다양한 옵션들이 존재했으나 이 옵션들의 목적을 명확하게 이해하기 어렵거나 원활한 작동에 어려움이 있었음 |
변경 후 |
목적이 명확하고 실용적인 옵션들을 유지하여 개선함 |
