Eclipse BIRT 1. 도구개요 2. 설치및실행 3. 주요기능 4. 활용예제
1. 도구개요 1.1 도구정보요약 도구명소개특징주요기능 BIRT (http://www.eclipse.org/birt/) Eclipse 기반의리포팅도구 라이선스 Eclipse Public License v1.0 Actuate 사의 BIRT 기술플랫폼을 Open Source 화하여주로 Java 나 JavaEE 기반의애플리케이션의 rich client 나웹애플리케이션으로데이터시각화및보고서생성 Eclipse 기반의 Stand-alone 애플리케이션인 BIRT Designer 로설치가능하고, 기존에사용중인 Eclipse 에플러그인방식으로설치가능 데이터베이스연결을통한보고서생성가능 WYSIWYG 방식리포트 UI 디자인 데이터소스연결을통한차트와보고서생성 HTML, PPT, DOC, XLS 등다양한방식으로내보내기 실행환경 Windows, Linux, MacOS 사전설치도구 JDK 1.6+ 카테고리 구현 ( 리포팅 ) 최신버전 4.4.1 (2014.10) 관련도구 Eclipse, Jasper Report 2
1. 도구개요 1.2 스크린캡쳐및주요기능 Eclipse 플랫폼상에서 WYSIWYG 방식으로리포트파일생성 파일, RDBMS, NoSQL DBMS 등다양한데이터소스지원 HTML, PPT, DOC, XLS, PDF 등다양한포맷으로익스포트가능 3
2. 설치및실행 세부목차 2.1 사전설치사항확인 2.2 다운로드 2.3 설치 2.4 실행 4
2. 설치및실행 2.1 사전설치사항확인 (1/2) Windows 의경우아래와같이 Command 창에서 java version 을실행하여설치된 JDK 버전을확인한다. BIRT 를사용하려면 JDK 1.6 이상이필요하다. 5
2. 설치및실행 2.1 사전설치사항확인 (2/2) 아래와같이에러가나는경우, 탐색기의 C:\Program Files 폴더또는 C:\Program Files (x86) 폴더에서 Java 폴더가있는지확인한다. Java 폴더가있다면, 그아래의 jdk/bin 디렉토리에서 java version 실행 Java 폴더가없다면, JDK 를다운받아설치한다. 6
2. 설치및실행 2.2 다운로드 (1/4) http://www.eclipse.org/birt 에접속하여, 좌측의 Download 클릭 7
2. 설치및실행 2.2 다운로드 (2/4) Eclipse BIRT 는 All-in-One, Framework, RCP Designer 세가지의설치옵션을제공한다. Framework 는기존의 Eclipse 환경에플러그인으로추가하는방식이고, RCP Descigner 는 BIRT Designer 기능만있는가벼운 RCP 버전이다. All-in-One 으로다운로드한다. 8
2. 설치및실행 2.2 다운로드 (3/4) 우측의 OS 목록에서사용자의 OS 에맞는 OS 를클릭한다. 사용자의 OS 에맞는파일을선택한다. 본자료에서는 Windows 64-bit 를기준으로진행한다. 9
2. 설치및실행 2.2 다운로드 (4/4) Mirror 사이트를선택할수있다. 미러를선택하여클릭하면다운로드화면으로이동한다. 파일저장 을선택하고 확인 을클릭한다. 10
2. 설치및실행 2.3 설치 (1/1) 다운로드받은파일의압축을푸는것으로설치가완료된다. D:\ 에압축을풀고폴더명을 Eclipse-Luna-ReportDesigner 로변경 11
2. 설치및실행 2.4 실행 (1/4) D:\Eclipse-Luna-ReportDesigner\eclipse.exe 실행 12
2. 설치및실행 2.4 실행 (2/4) workspace 를 D:\Eclipse-Luna-ReportDesigner\workspace 로설정 13
2. 설치및실행 2.4 실행 (3/4) workspace 를 D:\Eclipse-Luna-ReportDesigner\workspace 로설정 14
2. 설치및실행 2.4 실행 (4/4) 최초실행시나오는 Welcome 뷰가보이면성공 우상단의 Workbench 를눌러작업화면으로변환 15
3. 주요기능 세부목차 3.1 데이터소스연결 3.2 데이터셋생성 3.3 테이블작성 3.4 차트작성 3.5 그리드작성 3.6 스타일 3.7 Web Application 연동 16
3. 주요기능 3.1 데이터소스연결 BIRT 는여러유형의데이터소스와연동하여보고서를작성할수있다. 일반적인 JDBC 와로컬파일연결도지원하고, NoSQL 데이터베이스인 Hive 와 MongoDB 도지원한다. 4. 활용예제에서직접데이터소스를연결해본다. 17
3. 주요기능 3.2 데이터셋생성 BIRT 는데이터소스에서실제데이터를추출하고이를보고서에연동한다. 추출한데이터는데이터셋으로저장되며 JDBC API 의 ResultSet 과유사하다고보면이해하기쉽다. 보고서생성시이데이터셋내의컬럼을 Drag&Drop 해서보고서에사용할수있다. 18
3. 주요기능 3.3 테이블작성 Palette 의 Report Items 에는 Drag&Drop 방식으로보고서에추가할수있는여러가지컨트롤이준비되어있다. 데이터셋에저장된컬럼을테이블에 Drag&Drop 해서데이터를표형태로보여줄수있다. Drag&Drop 19
3. 주요기능 3.4 차트작성 차트는데이터셋에저장된데이터를여러가지그래프로보여준다. 20
3. 주요기능 3.5 그리드작성 그리드는보고서작성시행 / 열레이아웃을사용할수있게해주어짜임새있는보고서를만들수있게해준다. 21
3. 주요기능 3.6 스타일 워드나아래한글의스타일처럼 BIRT 도스타일을만들어두고필요한요소에적용할수있다. 22
3. 주요기능 3.7 Web Application 연동 BIRT Runtime 을이용해서 Web Application 에서 BIRT 를사용할수있다. 23
세부목차 4.1 예제소개 4.2 프로젝트및리포트생성 4.3 데이터소스연결 4.4 데이터셋생성 4.5 테이블만들기 4.6 차트만들기 4.7 Web Application 연동 24
4.1 예제소개 본예제는 Eclipse BIRT 의주요기능과일반적인개발에서필요한상황위주로 BIRT 의기능을설명한다. 데이터소스연결및데이터셋생성은 MySQL 데이터베이스에있는테이블을 JDBC Driver 로연결하는법을알아보고, Eclipse BIRT 보고서작성에사용되는필요한테이블, 차트등의사용을위한실제데이터는학습용으로 Eclipse BIRT 에내장된데이터소스를활용한다. 작성한보고서를 BIRT Runtime Engine 을이용해서 Tomcat 웹애플리케이션에서 BIRT 보고서를미리보기한다. 25
4.2 프로젝트및리포트생성 (1/5) 2. 설치및실행 을마치고 Eclipse BIRT 가실행된상태에서 Perspective 를 Report Design 으로전환한다. 우상단의 Open Perspective 버튼을클릭하고 Report Design 을선택한다. Open Perspective 창에 Report Design 이나오지않으면, 메인메뉴 >Window> Open Perspective>Other 를통해 Report Design Perspective 로전환한다. 26
4.2 프로젝트및리포트생성 (2/5) 메인메뉴 >File>New>Project 를클릭해서, Report Project 를선택하고 Next 클릭 New Report Project 창에서 Project name 란에 BirtExample 입력하고 Finish 클릭 27
4.2 프로젝트및리포트생성 (3/5) 좌하단 Navigator 뷰에 BirtExample 프로젝트가생성되어표시된다. BirtExample 을우클릭 >New>Report 클릭 28
4.2 프로젝트및리포트생성 (4/5) New Report 창에서 File name 에 first-report.rptdesign 입력후 Next 클릭 여러가지템플릿을사용할수있고, 본자료에서는 Blank Report 를선택해서백지상태에서리포트를만들어본다. 29
4.2 프로젝트및리포트생성 (5/5) 리포트가생성되면 BIRT 화면이아래와같이보고서를작성할수있는상태로세팅된다. 30
4.3 데이터소스연결 (1/8) 본자료에서는연결할테이블이 MySQL 데이터베이스에있다고전제하며, MySQL 데이터베이스에서테이블을생성하고데이터를입력하는방법은 MySQL 관련자료를참조한다. http://dev.mysql.com/downloads/connector/j/ 에서아래와같이 Platform Independent 를선택하고 MySQL 의 JDBC 드라이버를다운로드한다. 31
4.3 데이터소스연결 (2/8) 다운받은파일의압축을풀면, 아래와같이 JDBC 드라이버 jar 파일을얻을수있다. 나중에 Eclipse BIRT 에서데이터소스연결시아래의 jar 파일을지정한다. 32
4.3 데이터소스연결 (3/8) 리포트에사용할데이터를가져오기위해데이터소스를연결한다. 화면좌상단의뷰에서 Data Explorer 탭을선택하고, Data Sources 를우클릭해서 New Data Source 를클릭한다. 33
4.3 데이터소스연결 (4/8) New Data Source 창에서여러가지데이터소스에대한연결을설정할수있다. 본자료에서는 MySQL 데이터베이스를 JDBC 로연결하는방법으로데이터소스를설정한다. JDBC Data Source 를클릭하고, Data Source Name 에 JDBC-Example 을입력하고 Next 클릭 34
4.3 데이터소스연결 (5/8) New JDBC Data Source Profile 창에서 Manage Drivers 클릭 Manage JDBC Drivers 창에서 Add 클릭 35
4.3 데이터소스연결 (6/8) 앞에서다운받은 jar 파일을선택후열기클릭 Manage JDBC Drivers 창에아래와같이 MySQL JDBC Connector 가등록된다. OK 클릭 36
4.3 데이터소스연결 (7/8) New JDBC Data Source Profile 창의 Driver Class 창에서 com.mysql.jdbc.driver 를선택하고, MySQL 데이터베이스의 Database URL, User Name, Password 를입력하고, Test Connection 을클릭한다. 테스트여결성공을확인하고, OK 를누르고, Create a new data source 창에서 Finish 를클릭한다. 37
4.3 데이터소스연결 (8/8) 아래와같이 JDBC-Example 데이터소스가생성되었다. 38
4.4 데이터셋생성 (1/12) Data Explorer 의 Data Sets 을우클릭하고 New Data Set 클릭 Data Set Name 을입력하고 Next 클릭 39
4.4 데이터셋생성 (2/12) Query Text 에데이터를추출할 SQL 작성후 Finish 클릭 SQL 작성시좌측의 Available Items 에서 Query Text 로 Drag&Drop 도가능 물음표 (?) 를사용해서 Java 의 PreparedStatement 처럼파라미터제공가능 40
4.4 데이터셋생성 (3/12) 데이터셋에포함될 Columns 을확인할수있다. 41
4.4 데이터셋생성 (4/12) 왼쪽항목에서 Preview Results 를클릭하면가져올데이터셋의결과를미리볼수있다. OK 클릭 42
4.4 데이터셋생성 (5/12) Data Explorer>Data Sets 에새데이터셋이생성된것을확인할수있다. 생성된 Data Set 의값은복사되어온고정값이아니며, 리포트미리보기할때마다실제데이터베이스에있는값을새로읽어온다. 43
4.4 데이터셋생성 (6/12) 앞에서만든데이터셋은 MySQL 데이터베이스를 JDBC Driver 를통해데이터소스로연결해서데이터셋을생성하는법을알아보기위한예제이고, 실제리포팅작성에사용할데이터는 Eclipse BIRT 에학습용으로내장된데이터소스를활용한다. 일단 Eclipse BIRT 내에데이터셋이생성되면그데이터셋의출처가어디인지와관계없이데이터셋을다루는방법은동일하다. 44
4.4 데이터셋생성 (7/12) Data Explorer>Data Sources 를우클릭한후 New Data Source 클릭 New Data Source 창에서 Classic Models Inc. Sample Database 선택 Data Source Name 에 Tutorial-Sample 입력후 Next 클릭 45
4.4 데이터셋생성 (8/12) Finish 클릭 46
4.4 데이터셋생성 (9/12) Tutorial-Sample 데이터소스가추가되었다. 47
4.4 데이터셋생성 (10/12) Data Explorer 의 Data Sets 을우클릭하고 New Data Set 클릭 Data Source Selection 에서 Tutorial- Sample 을선택하고, Data Set Name 에 Customers 를입력하고 Next 클릭 48
4.4 데이터셋생성 (11/12) Query Text 에아래와같이 SELECT * FROM CUSTOMERS WHERE COUNTRY = USA 입력후 Finish 클릭 49
4.4 데이터셋생성 (12/12) Edit Data Set 창에서 OK 클릭 Data Explorer > Data Sets 에 Customers 데이터셋생성확인 50
4.5 테이블만들기 (1/13) 좌상단뷰에서 Palette 를선택하고, Report Items 에있는 Table 을 Drag 하여우측의리포트에디터뷰에 Drop 한다. Drag&Drop 51
4.5 테이블만들기 (2/13) 열의개수와 detail 의개수를지정하고 Next 클릭 Number of details 는행의수가아니라표시할데이터셋의숫자를의미 52
4.5 테이블만들기 (3/13) Data Set Binding 은테이블생성후에도설정할수있으므로, Finish 를클릭 53
4.5 테이블만들기 (4/13) 아래화면과같이 3 개의열과 Header Row, Detail Row, Footer Row 로이루어진테이블이생성된다. Detail Row 는앞의과정에서입력한 Number of details 의수만큼생성 54
4.5 테이블만들기 (5/13) Data Explorer>Data Sets>Customers 아래의 CUSTOMERNAME 컬럼과 PHONE 컬럼을아래와같이 Detail Row 의각컬럼에 Drag&Drop 한다. Drag&Drop Detail Row 의컬럼에 Drop 하면해당컬럼의 Header Row 는자동으로세팅 결과적으로아래와같이구성된다. 55
4.5 테이블만들기 (6/13) View Report 아이콘을클릭하고 View Report in Web Viewer 클릭 56
4.5 테이블만들기 (7/13) 아래와같은미리보기화면을확인할수있다. 57
4.5 테이블만들기 (8/13) 정렬을하기위해마우스로테이블을선택하고, 하단의 Property 창에서 Sorting 탭을클릭하고, Add 클릭 마우스를테이블위에가져가면왼쪽에 Table 아이콘이뜨며이아이콘을클릭하면테이블을선택할수있다. 58
4.5 테이블만들기 (9/13) Key 의셀렉트박스를클릭해서 CUSTOMERNAME 클릭후 OK 클릭 59
4.5 테이블만들기 (10/13) Preview 를하면아래와같이 CUSTOMERNAME 기준으로정렬되어나온다. 60
4.5 테이블만들기 (11/13) Border 를설정하기위해아무아이템이없는셀에서드래그를시작해서모든셀을포함하여테이블전체선택 61
4.5 테이블만들기 (12/13) Property Editor 뷰의 Properties 탭에서 Border 선택 Width 에서 Thin 을선택하고, 아래의 All Borders 선택 레이아웃뷰에보더표시 Border 생성 62
4.5 테이블만들기 (13/13) Preview 를하면아래와같이 BORDER 가표시되어나온다. 63
4.6 차트만들기 (1/13) New Data Set 을클릭하고, 아래의쿼리로 ChartData 라는데이터셋을생성한다. SELECT Products.ProductLine, sum(orderdetails.quantityordered) as TOTALORDERS FROM OrderDetails, Products WHERE Products.ProductCode=OrderDetails.ProductCode GROUP BY Products.ProductLine ORDER BY Products.ProductLine 64
4.6 차트만들기 (2/13) Palette 에서 Chart 를리포트에디터로 Drag&Drop 한다. 65
4.6 차트만들기 (3/13) New Chart 창의좌측 Select Chart Type 에서 Pie 차트선택후 Next 66
4.6 차트만들기 (4/13) Use Data from 에서 ChartData 를선택하면아래와같이차트에사용할데이터값을미리볼수있다. 67
4.6 차트만들기 (5/13) 데이터미리보기에서 PRODUCTLINE 을 Drag 해서 Category Definition 에 Drop 한다. 68
4.6 차트만들기 (6/13) 데이터미리보기에서 TOTALORDERS 를 Drag 해서좌측의 Slice Size Definition 에 Drop 한다. 69
4.6 차트만들기 (7/13) 데이터설정을마치면아래와같이구성된다. Next 클릭 70
4.6 차트만들기 (8/13) 좌측의 Title 을클릭하고 Chart Title 에 제품종류별주문량 입력후 Appl 클릭 71
4.6 차트만들기 (9/13) 좌측의 Value Series 을클릭하고하단의 Show Series Labels 를체크하면 Chart Preview 에데이터값이표시된다. 72
4.6 차트만들기 (10/13) 우측의스크롤바를내리면하단에버튼 3 개가나온다. Titles 창에서 Visible 을체크해제하면 Chart Preview 에서 Series 가안보인다. Series 가안보임 73
4.6 차트만들기 (11/13) 하단의 Labels 버튼을클릭하고, Series Labels 창의우측중앙에서 Category Data 를선택한후 Add 를클릭하고 Up 버튼을클릭하여, Values 창이아래와같이 Category Data 아래에 Value Data 가오게한다. 74
4.6 차트만들기 (12/13) New Chart 창에서 Finishi 를누르고, 아래와같이차트를 Resize 한다. 75
4.6 차트만들기 (13/13) Preview 로마지막페이지를보면아래와같이차트가추가되었음을확인할수있다 76
4.7 Web Appication 연동 (1/7) Eclipse BIRT 는리포트파일인 *.rptdesign 파일만있으면웹브라우저에서쉽게미리보기할수있는 Birt Runtime Engine 을제공한다. http://download.eclipse.org/birt/downloads/ 에서아래와같이 BIRT Runtime 을다운로드한다. 77
4.7 Web Appication 연동 (2/7) 압축을풀고 WebViewerExample 폴더를 TOMCAT_HOME/webapps 아래에복사하고폴더이름을 Birt 로변경한다. Tomcat 서버측 78
4.7 Web Appication 연동 (3/7) Tomcat 을구동하고, TOMCAT_SERVER_URL:PORT/webapps/Birt 에접속 아래와같은화면이나오면 Birt Runtime Engine 의설치성공 View Example 클릭 79
4.7 Web Appication 연동 (4/7) Sample 리포트를확인할수있다. 주소창에있는 report=test.rptdesign 으로 rptdesign 파일을지정하면, BIRT Runtime Engine 이제공하는 Servlet 을통해미리보기가가능하다. report 에지정할경로는 Birt 폴더를기준으로상대경로로지정가능하다. 80
4.7 Web Appication 연동 (5/7) 앞의예제에서작성했던 first-report.rptdesign 파일을 TOMCAT_HOME/webapps/Birt/report/ 폴더아래로복사한다. 81
4.7 Web Appication 연동 (6/7) http://localhost:8080/birt/frameset? report=report/firstreport.rptdesign& format=pdf 에접속하면앞에서만든 first-report 리포트를브라우저에서 PDF 미리보기로볼수있다. 82
4.7 Web Appication 연동 (7/7) BIRT Runtime Engine 에서제공하는 Servlet 에대한사용법은 http://www.eclipse.org/birt/documentation/integrating/viewer-usage.php 를참조한다. 83