Matrix.ExportImageEx, ScriptAPI 추가
기능 설명
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, useProgressBar: true, callbackFunc: null } | 내보내기 할 파일명과 내보내기가 끝난 뒤 실행되는 콜백 함수를 객체의 형태로 전달
|
exportType
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,
useProgressBar: true,
callbackFunc: callback
});
};
적용 화면
| 컨트롤 한 개만 출력 | 여러 컨트롤들을 출력 |
|---|---|
이미지 크기는 컨트롤의 크기입니다. |
이미지 크기는 form의 크기입니다. 또한, 배경색은 form의 배경색과 동일합니다. |
필수 옵션
- 기존의 ExportImage 함수도 사용 가능하나, API 문서에는 ExportImageEx 함수만 제공됩니다.
제약 사항
- Chart 컨트롤을 내보냈을 때 차트의 형태가 제대로 표현되지 않는 경우에는 차트의 Animation 속성을 조절해 주세요.
- HighChart-Ex 컨트롤을 이미지로 내보내기 위해서는 차트 스크립트에 accessibility: { enabled: false } 속성을 추가하셔야 합니다.
변경 전/후 제품 버전 | 변경 전(제품 버전) |
|---|---|
변경 전 |
다양한 옵션들이 존재했으나 이 옵션들의 목적을 명확하게 이해하기 어렵거나 원활한 작동에 어려움이 있었음 |
변경 후 |
목적이 명확하고 실용적인 옵션들을 유지하여 개선함 |
| 기능 정보 |
|
|
|
|
|
|
|
|---|---|---|---|---|---|---|---|
| 시작 버전 정보 |
| ||||||
참고 자료