대시보드 Export(로컬용)

 학습목표

대시보드를 컴포넌트 별 혹은 전체 Export를 할 수 있습니다.

1. 대시보드 컴포넌트 Export

대시보드를 컴포넌트 별로 Export 할 수 있습니다.

i-Portal에서 Export

1. AUD플랫폼 포탈에서 [내려받기] 버튼을 사용해 내보낼 컴포넌트를 선택합니다.
   
   
   
   
2. [내려받기] 버튼을 사용해서 Export를 사용할 때에는 Excel로 Export가 되며 여러 컴포넌트를 한 번에 Export 할 시, 각각의 컴포넌트가 개별 시트에 생성됩니다.
   
   
   
   
3. 다른 유형의 파일로 컴포넌트를 Export가 필요할 시에는 포탈에서 Export 할 컴포넌트를 마우스 우클릭하여 [내보내기] 목록에서 원하는 파일의 유형을 선택해 내려받을 수 있습니다.
   Export 가능한 파일 유형 : Excel, 한글, PPT, DOC
   
   
   
   
4. Export 된 파일을 확인합니다.
   - Excel
   
   
   
   - 한글
   
   
   
   - PPT
   
   
   
   - DOC
   

2. 대시보드 전체 Export

대시보드 전체를 하나의 이미지 파일로 Export 할 수 있습니다.

컨트롤 생성

1. 대시보드 Export를 사용하기 위한 버튼 컨트롤을 생성합니다.
   - UI BOT > BUTTON > BUTTON
   
   
   
   
2. 생성한 버튼 컨트롤의 속성을 변경합니다.
   - Name : BTN_EXPORT_LOC
   - Text : 대시보드 Export (로컬용)
   - Style > Type : Custom
   - BoxStyle : MGT_BUTTON_EX
   

컨트롤에 Export 스크립트 연결 

1. [편집 그룹 > Script Editor]를 클릭하여 스크립트 에디터 창을 활성화합니다.
   
   
   
   
2. 버튼을 클릭했을 때, 이벤트를 활성화하기 위해 [OnButtonClick] 이벤트를 호출합니다.
   
   
   
   

3. [OnButtonClick] 이벤트에 Export 기능을 활성화하기 위해 스크립트를 작성하고 [저장] 버튼을 클릭하여 스크립트를 저장합니다.
   

   Discription

   사용된 JScript

   Script  원본 펼치기

   /**************************************
    * 버튼 컨트롤이 클릭되는 시점에 발생합니다.
    * * arguments :  
    *		 string	Id (Readonly:False) : 컨트롤이름 
    *		 string	Text (Readonly:False) : 라벨 값 
   **************************************/
    var OnButtonClick  = function(sender, args){
    	
   	if(args.Id == "BTN_EXPORT_LOC") //생성한 버튼 NAME {
   
   		try {
   			var exportControls = []; //컴포넌트를 넣을 배열
   			var objects = Matrix.getAllObjects(); //대시보드의 모든 컴포넌트 가져오기
   			
   			//for문을 사용하여 배열에 출력할 대시보드의 컴포넌트의 Name을 push한다.
   			for(var i = 0; i < objects.length; i++) {
   				exportControls.push(objects[i].Name);
   			}
   			
   			//ExportImage API를 사용하여 컴포넌트의 Name을 push한 배열을 사용하여 Export한다.  
   			Matrix.ExportImage(exportControls, 3, {});
   		}
   		catch(e) {
   			alert("Export Failed\n" + e);
   	};
   };

   ExportImage API

   AUD플랫폼의 자체 API로 이미지 내보내기를 실행하는 API입니다.

   [void]ExportImage :

   ExportImage([string[]] controlNames ,[istudio.enum.CommonEnum.enExportType] exportType ,[object] option)

   인자	설명
   controlNames	내보내기 할 컨트롤 객체 이름 목록(Default: All Controls) 또는 null
   exportType	내보내기 할 파일 유형(2: Excel, 3:HML, 4:PPT, 5:DOC, 6:PNG, 7:PDF)
   option	추가 옵션 (CallBack 함수와 같이 실행 이후 필요한 작업이 있을 시 사용)

4. [실행] 버튼을 클릭하고 클릭 이벤트를 연결한 버튼을 클릭합니다.

   
   
   
   

5. Export가 정상적으로 작동하는지 확인합니다.
   

   Discription

   Export 시 참고할 점

   

   버튼을 눌러 Export시, 대시보드 뒤로 이미지 편집 창이 띄워지게 된다. 이는 로컬에서 이미지화 시켜서 내보내는 일련의 작업을 거치기 때문에 발생하는 현상입니다.

   *ExportImage API는 도중에 취소할 수 없으며, 파일이 서버를 거쳐서 떨어지는 것이 아니라 로컬에서 작업됩니다.

3. Export 가능한 파일 유형  

대시보드를 여러 파일의 유형으로 Export 할 수 있습니다.

Export 파일 유형

1. 대시보드를  Excel 파일로 Export합니다.
   - exportType : 2
   - Matrix.ExportImage(exportControls, 2, {});
   
   
   
   
2. 대시보드를 한글 파일로 Export합니다.
   - exportType : 3
   - Matrix.ExportImage(exportControls, 3, {});
   
   
   
   
3. 대시보드를 파워포인트 파일로 Export합니다.
   - exportType : 4
   - Matrix.ExportImage(exportControls, 4, {});
   
   
   
   
4. 대시보드를 워드 파일로 Export합니다.
   - exportType : 5
   - Matrix.ExportImage(exportControls, 5, {});
   
   
   
   
5. 대시보드를 PNG 파일로 Export합니다.
   - exportType : 6
   - Matrix.ExportImage(exportControls, 6, {});
   
   
   
   
6. 대시보드를 PDF파일로 Export합니다.
   - exportType : 7
   - Matrix.ExportImage(exportControls, 7, {});