Thiết kế một report trong Openbravo ERP(How to develop a report)

I. Giới thiệu:
  Tạo report (Báo cáo) là một công việc không thể thiếu trong việc phát triển ứng dụng, đặc biệt là đối với Openbravo ERP. Các quyết định quan trọng hoạch định chiến dịch kinh doanh thường được dựa trên các báo cáo, thống kê nên các báo cáo phải nêu rõ ràng, chắt lọc và trình bày các thông tin chính xác. Bài viết này giới thiệu về thư việc JasperReports và công cụ thiết kế report iReport. JasperReports là một sản phẩm mã nguồn mở được cung cấp bởi JasperSoft. Sau khi thiết kế xong report JasperReports tạo ra một định dạng trung gian, một file xml với phần mở rộng là. Jrxml. Phần mềm này cho phép bạn xuất report ra nhiều định dạng khác nhau như html, pdf, excel và csv. Và iReport là một công cụ đồ họa mã nguồn mở xây dựng báo cáo mà bạn có thể sử dụng để thiết kế và phát triển JasperReports.

Quá trình phát triển một report đơn gian bao gồm 3 bước sau:
- Tạo ra file gốc JasperReport jrxml. Sử dụng iReport.
- Nhúng report (File. Jrxml) vào Openbravo ERP.
- Biên dịch ứng dụng để việc tích hợp báo cáo có hiệu lực

2. Cấu hình Report
Bạn có thể tải về ireport phiên bản mới nhất tại đây http://sourceforge.net/projects/ireport/
Sau khi cài đặt bạn cần cung cấp cho iReport dirver JDBC và kết nối thông tin cho cơ sở dữ liệu của bạn.  Bạn cần phải thêm driver JDBC vào phần classpath trong iReport của bạn  Điều này có thể được thực hiện bằng cách lựa chọn   Tool/Options/Classpath

Ở đây tôi dùng Posgresql nên tôi sử dụng gói trên driver trên (Lưu ý : Đối với các phiên bản postgresql có thể tải các gói driver tại đây http://jdbc.postgresql.org/download.html)

Tiếp theo bạn tạo chuỗi kết nối đến database mà bạn sử dụng cho Openbravo ERP, Bạn mở ireport ra sau đó vào phần Report Datasources --> Chọn New --> Chọn tiếp Database JDBC connection --> Sau đó bạn điền các thông tin tương tư như hình sau với database sử dụng là Postgresql:

Để kiểm tra bạn có thể nhấn nút test và nhận được thông báo như sau:

3. Viết một template jasparRepot
 Giả sử tôi sẽ tạo một report để hiển thị danh sách các sản phẩm
 Để tạo mới một report trong ireport bạn vào File/ New --> Chọn report , sau đó bạn chọn một template có sẵn. Hoặc bạn có thể chọn một mẫu trống hoàn toàn.
--> Bạn chọn Launch Report Wizard
- Cửa sổ mới yêu cầu bạn chọn nơi lưu file report (Tôi lưu tại thư mục chứa report của Openbravo: \src\org\openbravo\erpCommon\ad_reports) và đặt tên cho report (Tôi đặt tên là productlist):
--> Chọn Next --> Ở cửa sổ tiếp theo bạn nhập câu truy vấn SQL
Tại đây bạn có thể sử dụng chức năng Design Query để tạo ra một truy vấn SQL, hoặc bạn có thể gõ trực tiếp câu truy vấn vào ô Query (SQL)
- Cửa sổ tiếp yêu cầu bạn chọn các trường dữ liệu sẽ được xuất ra ngoài báo cáo:
- Chọn Next => Bảng tiếp theo Chọn Group , trong ví dụ của chúng ta là một ứng dụng đơn giản nên phần này không cần thiết (Bạn có thể tham khảo trong các tài liệu hướng dẫn của iReport)
=> Sau đó chọn Next, rồi Finish sau đó màn hình sẽ load ra giao diện đồ họa để thiết kế report.
Bạn có thể tùy ý thiết kế các trường report, ví dụ tôi thiết kế đơn giản như sau:
- Sau khi thiết kế xong bạn chọn nut Save để lưu lại.

-----------------Tới đây bạn đã kết thúc việc thiết kế một Report đơn giản!

4. Đăng ký report vừa tạo với Openbravo ERP

- Đăng nhập vào Openbravo ERP với quyền System Administrator
- Bạn tạo mới một Module tên là ReportModule (Hoặc tên gì đó cũng được). Các tạo mới một module trong OB ERP bạn có thể tham khảo ở đường dẫn sau: http://minhbangchu.blogspot.com/2010/07/tao-moi-va-ong-goi-mot-module-trong.html

- Sau khi bạn tạo thành công module bạn vào phần Application Dictionary || Report and Process  => Chọn New để tạo một record mới:
=>Bạn nhập các trường thông tin tương tự như sau:

• Search Key: RPT_MPRODUCT
• Name: Product List Report
• Bạn đánh dấu check vào ô Jasper Report
• JR Template Name: Nhập đường dẫn thư file report mà bạn mới tạo: @basedesign@/org/openbravo/erpCommon/ad_reports/produclist.jrxml

5. Đưa report vừa tạo vào một menu

- Bạn vào General Setup || Application || Menu và nhấn nút New để tạo mới.
=> Ở cửa sổ này bạn nhập các thông tin như sau:

• Name: Product List Report
• Action: Process
• Process: Product List Report

Cuối cùng lưu record này lại.

6. Biên dịch lại Openbravo ERP

Bước cuối cùng là biên dịch lại Openbravo ERP của bạn , để hiệu lực hóa báo cáo mà bạn vừa thêm vào. Để thực hiện biên dịch bạn sử dụng cấu trúc lệnh ant sau:
ant compile.development -Dtab='XX'
-----------> Sau khi quá trình biên dịch thành công, bạn khởi động lại Tomcat và đăng nhập lại Openbravo ERP bằng quyền Openbravo Admin truy cập vào report mà bạn vừa tạo.

Chúc bạn thành công!
-----------------------------------------------------------------------------------------------------------
Tài liệu tham khảo:
http://wiki.openbravo.com/wiki/ERP/2.50/Developers_Guide/How_to_develop_a_report