보고서 JScript에서 i-AUD ExcelExportServiceCall API 사용 시 엑셀의 스타일과 포함되는 컨트롤 등을 설정할 수 있습니다.
- workbook Json 객체를 동적으로 생성하여 내보내기 시의 엑셀 workbook 속성을 미리 설정할 수 있습니다.
- ExcelExportServiceCall API 기본 설명과 예시는 아래를 참고하세요.
아래 캡처 화면은 7.0.500.20241212-11 버전입니다.
사이트별 버전에 따른 API 문서 확인 방법은 [i-AUD] AUD API 매뉴얼을 제공합니다. 를 참고하세요.
기본
가이드 - 기본
attribute key | attribute value type | example | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
FontName | string | var WORKBOOK = { "FontName": "맑은 고딕", "FontSize": 11, "WorkSheets": [ { "Name": grid_name, "DisplayGridlines": "false", "Ranges": [ { "Range": "A1", "Value": "■ Report Name : " + Matrix.GetReportInfo().NAME, "ColSpan": 5 }, { "Range": "A2", "Value": "■ Printer : " + Matrix.GetUserInfo().UserName, "ColSpan": 5 } ], "Controls": [ { "Name": grid_name, "Range": "A5" } ] } ] }; | |||||||||||||||||||||||||||||
FontSize | number | ||||||||||||||||||||||||||||||
WorkSheets | Array<WorkSheet>
| ||||||||||||||||||||||||||||||
Styles(optional) | Array<Style> ※ 심화 가이드를 참고하세요 |
내보내기 가능한 컨트롤 타입
- Grid 계열 (DataGrid, TreeGrid, OlapGrid)
- Chart 계열(Chart, PieChart, ScatterChart, Polygon Chart)
- MXGrid
- Image
차트 내보내기 - ImageExport
ImageExport의 경우, 내보내기 하는 컨트롤이 Chart인 경우 반드시 true로 설정하셔야 합니다. 차트는 이미지로만 내보내기 가능합니다.
컨트롤 내보내기
컨트롤을 내보내기하는 경우, 해당 컨트롤의 스타일은 workbook 객체에서 설정할 수 없습니다. 컨트롤의 스타일은 보고서 화면에서 보이는 대로 적용되어 내보내기됩니다.
심화(셀 스타일 지정하기)
가이드 - 심화(셀 스타일 지정하기)
MXGrid 컨트롤을 이용하여 보다 쉽게 셀 별로 스타일을 지정할 수 있습니다.
가이드 순서
- MXGrid Designer에서 사용할 스타일을 셀 별로 설정합니다.
- 보고서를 저장한 후 조회하여 화면을 확인한 다음 보고서를 로컬로 저장합니다.
- 압축 파일 내의 json2 파일을 오픈합니다.
- 1번에서 설정한 스타일을 json2 파일에서 확인합니다.
- JSON 객체 설정 시 Range 스타일을 적용합니다. (두 가지 방법)
- MXGrid Designer에서 사용할 스타일을 셀 별로 설정합니다.
- i-AUD Designer에서 MXGrid 컨트롤을 생성합니다.
- MXGrid 우클릭 > 디자인 메뉴를 선택하여 MXGrid Designer를 오픈하여, 원하는 셀 스타일을 미리 설정하여 저장합니다.
- i-AUD Designer에서 MXGrid 컨트롤을 생성합니다.
- 보고서를 저장한 후 조회하여 화면을 확인한 다음 보고서를 로컬로 저장합니다.
- i-AUD Designer에서 MXGrid에서 정상적으로 표시되었음을 확인 후, 보고서를 저장합니다.
- "다른 이름으로 저장" 기능을 이용하여 보고서를 로컬로 다운로드합니다.
- i-AUD Designer에서 MXGrid에서 정상적으로 표시되었음을 확인 후, 보고서를 저장합니다.
- 압축 파일 내의 json2 파일을 오픈합니다.
- 로컬로 다운로드된 파일을 압축해제하기 위해, 확장자를 mtsd → zip으로 변경합니다.
- 압축을 푼 후, resource/iGRID_DESIGN/ 하위의 json2 파일을 오픈합니다.
- 로컬로 다운로드된 파일을 압축해제하기 위해, 확장자를 mtsd → zip으로 변경합니다.
- 1번에서 설정한 스타일을 json2 파일에서 확인합니다.
- json2 파일의 첫 번째 레벨 attribute인 Styles를 검색합니다.
- 아래와 같이 1번에서 설정한 스타일을 확인하실 수 있습니다.
- json2 파일의 첫 번째 레벨 attribute인 Styles를 검색합니다.
- JSON 객체 설정 시 Range 스타일을 적용합니다. (두 가지 방법)
- Styles attribute에 스타일을 추가 후, Range의 Style에 스타일 이름을 설정합니다. (Styles type: Array<Style>)
- Range Style에 스타일 객체를 바로 설정합니다.
a와 b 방법 모두를 적용한 코드 예시
var WORKBOOK = { "FontName":"맑은 고딕" , "FontSize" : 10 , "Styles": [ { "Font": "font-family:궁서체;font-size:24;font-color:#FFC00000;font-weight:bold;", "Horizontal": "center", "Vertical": "center", "Name": "S3" }, ] , "WorkSheets": [ { "Name":"Sheet1" , "DisplayGridlines":"false" , "Ranges": [ {"Range" : "B9", "Value" : "1번 그리드", "ColSpan": 5, "Style": "S3"}, {"Range" : "B18", "Value" : "1번 그리드", "ColSpan": 5, "Style": { "Font": "font-family:궁서체;font-size:18;font-color:#FF7030A0;", "Fill": "solid,#FFDBDBDB", "Horizontal": "center", "Vertical": "center" } }, ] } ] }; Matrix.getObject('BTN_EXPORT_EXCEL').OnClick = function(s, e){ Matrix.ExcelExportServiceCall(WORKBOOK ,null ,function(e){ if(e.Success == false){ alert("export fail::" + e.Message); return; } // download file var row = e.DataSet.GetTable(0).GetRow(0); var folderName = row.GetValue("FolderName"); var fileName = row.GetValue("FileName"); var nowText = Matrix.GetDateTime().ToString("yyyy-MM-dd HH:mm:ss"); // download.maf 주소 Matrix.DownloadFile(folderName + "/" , fileName , Matrix.GetReportInfo().NAME + "_" + nowText + ".xlsx", true, null); }); };
- 결과 화면