본문 바로가기

Java/[Servlet/JSP]

iReport

출처 : http://soulcinder.egloos.com/128409

회사에서 진행하는 프로젝트에 사용하게 된 리포트툴입니다.
깔끔한 UI와 오픈소스로 무료배포인게 가장 큰 매력이었구요..
국내에 제대로 된 자료를 찾기 어려워서(버전이 낮은 것은 있더군요.)
직접 익힌 iReport 사용법을 소개하고자 합니다.
사용한 버전이 1.3.1 이지만 최근에 릴리즈된 2.0.1버전이랑 별 차이가 없어서
사용했던 버전에 2.0.1버전에 추가한 내용을 합해서 설명하겠습니다.

iReport 를 사용하기 위해서는 Sun Java 2 SDK 1.5 이상의 버전과
Runtime Environment (JRE) 필요하고 jasper 파일을 컴파일 하기 위해서는
Java 2(JDK)가 필요합니다.

우선은 아래 링크를 따라가서 iReport를 다운 받습니다.

http://sourceforge.net/projects/ireport/
2007년9월12일 현재 가장 최근에 릴리즈된 버전이 2.0.1버전 이네요
파일명 :  iReport-2.0.1.tar.gz

적당한 위치에 다운 받으시면 됩니다.(전 그냥 바탕화면에 다운 받았습니다)
1.3 대 버전때는 인스톨을 해야 했는데
2.0 대 버전으로 넘어오면서는 인스톨 하지않고 실행이 되더군요.

자 여기까지 제대로 하셨다면 iReport 로딩 화면(분홍색꽃무늬) 보실수 있을겁니다.






















iReport를 사용하기 위해서는 자신의 jdk-lib 안에 있는 jar파일(dt.jar , tools.jar)과
한국어를 사용하기 위해서 iTextAsian.jar를 Classpath에 추가해 줘야 합니다.
(iTextAsian.jar는 밑에 첨부 파일로 올렸습니다)


























제가 쓰는 환경에 맞게 Weblogic(웹서버)에서 제공하는 JDK을 이용하였고
Weblogic에서 iReport를 사용하기 위해서 임의로 ireport-lib라는 폴더를 새로만들어
폴더 안에 iReport의 library들과 함께 iTextAsian를 추가 했습니다.

첨부파일 :  iTextAsian.jar



iReport는 default로 MySQL을 지원합니다.
저는 Oracle을 쓰기 때문에 따로 Oracle드라이버를 추가 시켜주었습니다.












저처럼 따로 LIB를 만들어 주신다면 그쪽에도 추가 시켜주어야 합니다.

자. jar파일을 추가 해 주셨다면 다음은 iReport 화면으로 돌아갑니다.
상단 메뉴바에서 Data - Connections/Data Source를 클릭하거나 
Toolbar 2번째 줄 맨끝에 있는 원통에 플러그 꼽는 아이콘을 클릭합니다(;;)

그러면 다음과 같은 화면이 나옵니다.


































여기서 NEW를 클릭하게 되면 datasource type을 고르라고 하는데
Database JDBC connection을 선택하고 NEXT를 클릭 합니다. (다른것은 안해봣음;;)

자 이제 Connections properties란 창이 하나뜨는게 보이네요.
여기서 자신이 연결한 Database에 대한 설정을 해줍니다.
 
 * Name - 앞으로 표시 될 이 Database의 이름을 말합니다.
 * JDBC Driver - 전 오라클 사용을 위해 oracle.jdbc.driver.OracleDriver를 선택합니다.
 * JDBC URL - 이부분은 직접 써넣어도 되지만 자동 세팅 할수 있기 때문에 스킵합니다.
 * Server Address - 자신이 연결한 Database의 주소를 써줍니다 (ex. 192.68.41.1)
 * Database - 자신이 연결한 Database의 이름을 써줍니다.(ex: ora92)
                  => 주소와 Database 이름 써넣은후 Wizard를 클릭하면 URL이 세팅 됩니다.
 * User Name - Database 연결 하는 User ID를 말합니다.
 * Password - Database 연결 하는 비밀번호를 말합니다.
  (Save password를 체크 하지 않으면 Database 연결시 마다 비번를 입력해야 합니다.)

자 다 설정 하셨으면 Test버튼을 클릭해서 Connection test successful!이 뜨면
제대로 연결이 된것 입니다.
Save 하면 추가된 Datasource를 확인 할수 있습니다.
여러개를 추가할 수 있고 그 중 하나를 Default로 지정해야 합니다
(따로 Default를 지정하지 않으면 가장 마지막에 만든 Datasource가 default가 됩니다.)

이로써 iReport에 Database를 연결하는 방법은 끝났습니다.



iReport를 실행시키고 위에 메뉴바에 보면 Options에서 Settings..를 클릭합니다.
그럼 밑에 보이는 그림과 같은 Options창이 뜹니다.

































1. General

 iReport에 대한 기본적인 Option을 선택해 주는 부분이다.
 이부분은 저도 그냥 그대로 썼습니다.

2. Compiler

 iReport의 Compile에 대한 Option을 정해주는 부분인데 Dafault compilation directory에
 자신의 컴파일하거나 실행한 파일들을 저장해 줍니다.
 (ex : *.jasper(컴파일시) , *.pdf , *.excel 등등)

































참고로 저는 iReport 폴더 안에 compile이란 새폴더를 만들어서 거기에 저장을 했습니다.

3. Backup

 저장시 백업에 대한 option을 선택해 주는 부분입니다.
 - No Backup : 말그래도 백업 안하는거죠
 - Replace Extension with .bak : 파일명에 확장자가 bak으로 저장됩니다. (xxx.bak)
 - Append .bak to existing extension : 파일명.jasper에 bak이 붙습니다. (xxx.jasper.bak)

































4. External Programs

  이 부분은 출력시 나타낼 수 있는 Viewer들을 연결해 주는 부분입니다.
  저는 PDF랑 HTML이랑 XLS부분만 연결했습니다.
  연결방법은 그냥 Browse를 선택해서 연결해 주면 됩니다.

































위에 External Editor는 외부 에디터 프로그램을 연결하는거 같은데..
 해보지 않아서 잘 모르겠습니다.

 우선 여기까지만 해주셨다면 iReport의 기본적인 준비 단계는 완료 되었습니다.
 다양한 출력방식중에서 하나를 고르실때는 상단 메뉴바에서 Build 를 클릭후에
 나오는 것들 중에 하나를 고르시면 됩니다. 그중 JRViewer는 기본적으로 제공되는
 preview로 jasper파일 이외에 실행 파일은 남기지 않습니다.
 다른 preview선택시 예를들어 PDF preview를 선택하셨다면 실행후 아까 설정하신
 저장 폴더에 PDF파일이 저장이 됩니다.