Pentaho 5.0 Reporting by Example: Beginner's Guide

Chapter 1. What is Pentaho Report Designer?

In this chapter, we will explain what Pentaho Report Designer (PRD) is, and we will discuss its engine and its Graphical User Interface (GUI). We will also discuss the advantages that its open source license entails.

We will describe the two most common uses of PRD, which are embedding in Java projects and publishing to the Pentaho BA Server.

We will present the principal types of reports: Transactional Reporting, Tactical Reporting, Strategic Reporting, and Helper Reporting. As we will see throughout this book, PRD supports all of these types of reports.

Later, we will list the main features of PRD; this includes inserting charts (sparklines and JFreeCharts), a variety of export formats, parameterization, style expressions, crosstab reports, interactive reports, Java API, integration with the Pentaho suite, and abstraction layers.

We will make a brief review of the landmarks in the evolution of PRD and its different versions.

At the end of the chapter, we will display a series of PRD reports in order to show the scope of the potential capacities that PRD possesses.

Pentaho Reporting is a technology that allows you to design and build reports for the Pentaho BA platform and other application servers. Pentaho Report Designer (PRD) is a graphics tool that implements the report-editing function. The project from which PRD originated was originally called JFreeReport.

PRD is an open source tool licensed under the GNU Lesser General Public License (GNU LGPL). This license provides the four basic freedoms of free software and the GNU GPL. And the L (Lesser) in LGPL indicates that this software can be used as part of or in combination with proprietary software, which provides greater flexibility for different licenses and software to coexist.

Note

For more information about free software and the GNU project, visit http://www.gnu.org/.

To read more about the GNU GPL and GNU LGPL licenses, visit http://www.gnu.org/licenses/licenses.en.html.

PRD contains a Java-based report engine that provides scalability, portability, and integration. Additionally, the editor's UI is implemented with Swing widgets, which give it a friendly, multiplatform look and feel. This UI is very intuitive, and it allows you to become familiar with the tools quickly.

PRD lets you create simple reports, wizard-based reports, advanced reports, reports with charts, subreports, parameterized reports, and others. Once a report has been created, PRD lets you export it in a variety of formats, such as PDF, Excel, HTML, and CSV, or preview it using Swing.

Since the beginning, PRD has benefitted from multiple contributions from the community, and currently the community supporting this project is growing and becoming more stable and contributing regularly in the form of code, wikis, documentation, forums, bug reports, tutorials, and so on.

Note

Here are some interesting links about PRD:

Official blog: http://www.on-reporting.com
Bug tracker: http://jira.pentaho.com/browse/PRD
Forum: http://forums.pentaho.com/forumdisplay.php?78-Pentaho-Reporting
Wiki: http://wiki.pentaho.com/display/Reporting/Report+Designer

PRD has two typical uses as follows:

It can be embedded in Java projects in desktop and web applications. In this book, we will develop a good example of how to embed PRD reports in web applications.
It can, in a few steps, publish reports to the Pentaho BA Server to be used from there. It can, furthermore, be embedded in other application servers. These points will also be addressed in this book.

Types of reports

There are various categories that reports can be grouped into. From our perspective, the following categories are the most important:

Transactional reports: Data for these reports comes from transactions and their objective is to present data at a very detailed and granular level. This type of report is usually used in an organization's day-to-day business. Examples of this kind of report are sales receipts, purchase orders, and so on.
Tactical reports: Data for these reports comes from summaries of transactional data. The level of summary is low, usually not more than daily or weekly. This type of report contains information to support short-term decision making. For example, a stock inventory allows us to place orders to replace merchandise.
Strategic reports: These reports commonly used data sources clean, reliable and stable, for example of a data warehouse, and their goal is to create business information. This kind of report supports medium and long-term decision making and is usually highly summarized; it allows for parameterization and includes charts and subreports. For example, a seasonal analysis of sales lets us determine what marketing campaigns should be carried out at given periods of time.
Helper reports: Data for these reports comes from diverse origins and contains information that may not be normalized, including photos, images, and bar codes. This kind of report is not aimed at supporting decision making but serves a variety of interests. Examples of this kind of report are technical product descriptions, letterheads, ID cards, and so on.

Note

Defining data

Data is an expression that describes some characteristic of an entity. For example, in saying that a box is black, we are specifying data (black) regarding a characteristic (color) of an entity (box).

Defining information

Information is obtained through data processing. Data can be processed through summary, classification, grouping, and ordering.

Main features of Pentaho Report Designer

The following are some of PRD's principal characteristics:

Reporting algorithm: PRD avoids compiling reports, a method that other reporting tools use, and combining the report layout with data as it is acquired. Initially, the algorithm calculates and determines how to separate the data into groups, subgroups, and so on, and calculates the height, width, position, and style of the elements (text, images, and so on); later, the data is placed where it belongs in order to obtain the desired output.
Diverse data sources: This includes JDBC (this allows access to most databases), Pentaho Metadata, Pentaho Data Integration, OLAP, XML, in-line table, Sequence Generator, Query Scripting, Java Method Invocation, Hibernate, Open ERP, CDA, and so on.
Diverse output formats: These are PDF, Excel, Excel 2007, HTML, RTF, CSV, XML, and Text. PRD renders reports with high image quality.
Insertable objects: PRD lets you add text fields, labels, images, charts, subreports, shapes, lines, sparklines, hyperlinks, bar codes, and other objects to your reports. Objects are inserted in the UI by simply dragging and dropping.
Charts: There are two categories of charts that can be added to reports in PRD; they are as follows:
- Sparklines: These are inline charts. PRD supports bar, line, and pie sparklines.
- JFreeChart charts: These are traditional charts. PRD supports bar, line, area, pie, multipie, barline, ring, bubble, scatter-plot, XY-bar, XY-line, XY-area, extended XY-line, waterfall, radar, and XY-area-line charts.
Parameterization: PRD allows you to define parameters that can be used in different parts of the report; for example, as a filter for a SQL query, as the text of a label, as part of a formula, and as a style attribute, among others. Regarding the type of presentation, PRD provides the following widgets to supply parameter values: drop-down menus, simple-value lists, multivalue lists, radio buttons, checkboxes, single selection buttons, multiselection buttons, textboxes, text areas, and date pickers.
Formulas and style expressions: PRD allows you to assign a style property according to the value of a formula, expression, or fixed value. For example, if the value of the field "quantity" is greater than 50, you can make the background color of a given shape green. You can also use formulas to create new fields and calculate their values.
Crosstab report: PRD lets you create powerful reports based on cross tabs using a simple wizard.
Interactive reports: PRD lets you add interactivity to your reports, making it possible to expand/collapse groups, add hyperlinks to other reports, and so on.
Wizard: PRD includes a wizard that lets you create a report through simple and intuitive steps.
Publication: From the PRD UI, you can publish directly to the Pentaho BA Server.
Java API: PRD includes a very extensive API that lets you execute, create, and modify reports without using the UI.
Extendibility: PRD lets you add new functionality through the incorporation of plugins.
Stylesheet support: PRD supports internal storage or external access to CSS3 stylesheets.
Integration with the Pentaho suite: PRD is easily integrated with the other tools in the Pentaho suite, including Pentaho Data Integration (PDI) and C-Tools (CDF and CDA).
Pentaho Data Integration: PDI implements a transformation step that lets you execute and parameterize PRD reports; this allows you to implement mailing and report bursting, among many other possibilities.
Community Dashboard Framework (CDF): This implements a component for working with PRD reports. Community Data Access (CDA) can be added as a plugin PRD, with the goal that our reports can get their data from a CDA connection.
Abstraction layers: When an end user creates a report, they usually see the process as a whole. The process of creating a report in PRD can be separated into three parts: the selection of data source to use, the design/layout of the report, and the final presentation format. PRD defines two layers of abstraction between these three parties, allowing each party to become independent of the other and the report to be adapted to different contexts and needs. For example, if a report is created based on a data source developed in MySQL and is later published to a Pentaho BA Server connected to a PostgreSQL production database, the report will be adapted to this context and will be able to be executed without change.

The following illustration demonstrates before to publish in Pentaho BA Server using MySQL and a presentation in PDF:

Main features of Pentaho Report Designer

The following diagram illustrates after to publish in Pentaho BA Server using PostgreSQL and a presentation in HTML:

History

Landmarks in the evolution of PRD are as follows:

2002: David Gilbert (author of JFreeChart) implements the first version of JFreeReport. Soon after, Thomas Morgner becomes the lead developer. The JFreeReport project is very successful and many people begin to contribute to it.
2006: Thomas joins Pentaho, changing the name to Pentaho Reporting. Thomas becomes a developer for the Pentaho Reporting Engine and other suite tools.
January 2006: Pentaho announces that Pentaho Report Designer (PRD) Wizard is available for creating reports. Mike D'Amour becomes the initial author of this wizard.
June 2006: Martin Schmid contributes the first version of PRD to the community. From this point forward, the designer is developed in parallel with the engine.
November 2006: (BA Server, Version 1.6) Pentaho Reporting is integrated with the Pentaho Metadata Engine to create ad hoc reports.
April 2007: The Pentaho team joins OpenOffice.org to distribute a reports solution for the OOo database tool. This project is led by Thomas Morgner and comes to be known as the Pentaho Reporting Flow Engine.
December 2007: The development of version 1.0 of the PRD Classic Engine begins.
March 2008: A native data source is added for Pentaho Data Integration.
June 2008: The Olap4j data source is added; it provides connectivity to Mondrian and other OLAP sources and the possibility of executing MDX queries. Implementing cross tabs is discussed.
June 2009: PRD supports Rich Text Format (RTF) and script-based data sources are added (Scriptable Datasource).
June 2010: The Table of Contents component is added.
October 2010: The Drill Linking characteristic is added.
November 2010: Execution environment information is available via ENV Fields.
December 2010: The development of the Community Data Access (CDA) data source begins.
January 2011: PRD cache development begins.
July 2011: Sparklines are added.
November 2011: Version Checker is added.
April 2011: 10 years since the creation of JFreeReports.

The evolution of different versions of PRD can be seen in SourceForge via the link http://sourceforge.net/projects/pentaho/files/Report%20Designer/ as follows:

2007 – November: Version 1.6
2008 – June: Version 1.7
2009 – January: Version 2.0
2009 – August: Version 3.0
2009 – November: Version 3.5
2010 – March: Version 3.6
2010 – December: Version 3.7
2011 – March: Version 3.8
2012 – May: Version 3.9
2013 – Version 5.0

Examples of typical reports

In the following sections, we present a series of PRD reports typically included as examples of Pentaho solutions and in the sample reports of PRD.

The buyer report

The buyer report is found at the following location in the top menu:

Help | Sample Reports | Operational Reports | Buyer Report

This report presents an analysis of the products belonging to each product line grouped by the vendor. For each product, it shows a sparkline with information about the sales of this product in the last three years. This report allows the end user to select the product line to be displayed.

As can be seen in the top part of the report, there are two selectors for passing parameters to the report:

The selectors will then show a report of the product line (Choose a Line:) indicated in the parameter, in this case Trains, and its visualization format will be the one chosen in Output Type, in this case HTML (Paginated).

To show information about each product, this report uses sparklines, text, numbers, and monetary values (in dollars):

Also, an image has been placed in the report title (see the first screenshot of this section).

The income statement

The income statement report is found at the following location in the top menu:

Help | Sample Reports | Financial Reports | Income Statement

This report shows the current income statement of the company and shows calculations of totals and subtotals, grouping each item in its respective category (Revenue, Cost of Goods, and so on).The default for the Output Type parameter value has been set to PDF, so when it is executed, it will download the file Income Statement.pdf. If you prefer to view the report in another format, you only have to change the value of the Output Type parameter.

This report has an image as a background.

The inventory list

The inventory list report is found at the following location in the top menu:

Help | Sample Reports | Operational Reports | Inventory List

This report shows information about the stock of products and allows the end user to select one or more product lines that need to be shown.

This report uses bar codes:

It uses hyperlinks (drill through) to other reports:

If you click on the values in the field SKU, a new tab will open displaying a report with additional information about this SKU. In this case, if we click on S12_1099, a report shown in the following screenshot will appear:

It also uses links of web pages:

If you click on the values in the field Name, a new web browser tab opens with a web page that searches for Google Images.

This report uses conditional formatting, that is, the background color of the field On Hand is determined according to certain values and conditions. This allows for the viewing of the statuses of the reports through indicators in a very simple way, that is, the indicator is green when the values are good, yellow when they are acceptable, and red when they are bad.

Invoice

The invoice report is found at the following location in the top menu:

Help | Sample Reports | Production Reports | Invoice

This report shows all the invoices that have been issued to customers. Each invoice is presented on a separate page, and the end user has the ability to select the client they want to analyze.

This report, showing Payment History , uses sub-reports.

Product Sales

The product sales report is found at the following location in the top menu:

Help | Sample Reports | Oper ational Reports | Product Sales

This report shows information about sales made to the customers. On the left-hand side, a pie chart shows the percentage of sales made to each customer and on the right-hand side, a sub-report shows a list of the amount of sales in detail.

It is important to point out that the parameter selectors are related, that is, once a value is chosen for Line, only products belonging to that line will be shown in the options of the selector Product:

Top N Customers

This report is found at the following location in the top menu:

Help | Sample Reports | Operational Reports | Top N Customers

This report shows an analysis of the top N customers; here N can be defined via a parameter. It also displays information amount and percentage of the total sales, and uses a table and two bar charts.

HTML actions

This report is found at the following location in the top menu:

Help | Sample R eports | Advanced | HTML Actions

This report shows a list of products grouped by the vendor and provides information about their code, name, purchase price, and so on. Furthermore, it lets us expand or collapse the different groups. That is, if you click on + Autoart Studio Design, all the child nodes collapse.

This report lets us search for the models of the cars we choose in Google Images. For example, choose 1966 Shelby Cobra 427 S/C as shown in the following screenshot:

Click on the get values button. You will see that all the auto models will be shown in the following screenshot:

Click on the Call Web Service button; a new web browser window will open with a web page that searches for Google Web.

Filter reviews by

All

Amazon verified reviews

rgillespi Dec 15, 2014

easy to read/comprehend, hope it's enough to get me a job

Amazon Verified review

Devashish Rao Feb 07, 2014

This is a Good Book. Detailed step by step explanation is given for implementing report using Pentaho.Recommended for Beginners as well as freshers.Devashish RaoPentaho Developer and Analyst.

Rodrigo Porto Jan 10, 2014

For me, the PRD was one of the tools of Pentaho suite more obscure and difficult to use.It "was" until I started reading this book.The book follows a great didactic to clarify and teach all the features of this great Pentaho tool.Strongly recommend this book for both beginners and those who already have plenty of experience in Pentaho reporting.

Will Gorman Nov 29, 2013

It’s been four years since I published Pentaho Reporting 3.5 for Java Developers. A lot has changed in Pentaho Reporting since then, so it’s great to see a new book now available from Packt, Pentaho 5.0 Reporting by Example: Beginner’s Guide, co-authored by Mariano Mattio and Dario Bernabeu. This book has a different purpose than the Java Developer book, it’s focus is a deeper dive into examples to quickly bring folks up to speed on the various capabilities of Pentaho Reporting.For those who already are familiar with the basics of Pentaho Reporting, I would still recommend this book for a couple of reasons. First, Chapter 12 covers both content linking and sparklines, very useful features for your every day reports. Second, one of the newest features in Pentaho Reporting 5.0 is stylesheets. In Chapter 13, this book does a great job at an initial introduction to get you started on this powerful capability.Thanks Mariano and Dario for this great contribution!

Wesley Seidel Carvalho Jan 09, 2014

I've been working for at least a 4 year old with Pentaho and its ecosystem.During this period I have followed developments of the tools and support materials for learning, among them some books.Recently I acquired this book and even having worked with Pentaho Reporting, could still learn more from this book. I liked a lot of the approach in the use of the database "sakila" of the Mysql to illustrate the various possibilities of the tool.The examples are really useful. In addition, the book covers well the possibilities of the tool.Teaches since the creation of simpler report by creating parameterized reports and the use of charts, sparklines, and even create and apply CSS and the use of crosstabs.With regard to programming, teaches since how to configure an application server, with tomcat, until the creation of a "Dynamic Web Project" in eclipse, the use of the PRD library and use the models created in the tool.Anyway, this is a great book to have for the use of the PRD and as a possible reference.Congratulations to the authors, and thank you for this contribution.

Pentaho 5.0 Reporting by Example: Beginner's Guide: Learn to use the power of Pentaho for Business Intelligence reporting in a series of simple, logical stages. From installation in Windows or Linux right through to publishing your own Java web application, it's all here.

What do you get with a Packt Subscription?

Pentaho 5.0 Reporting by Example: Beginner's Guide

Chapter 1. What is Pentaho Report Designer?

Note

Note

Types of reports

Note

Main features of Pentaho Report Designer

History

Examples of typical reports

The buyer report

The income statement

The inventory list

Invoice

Product Sales

Top N Customers

HTML actions

Summary

Page 1 of 5

Key benefits

Description

Who is this book for?

What you will learn

Product Details

What do you get with a Packt Subscription?

Product Details

Frequently bought together

Table of Contents

Recommendations for you

Customer reviews

Filter reviews by

People who bought this also bought

About the authors

FAQs

Pentaho 5.0 Reporting by Example: Beginner's Guide: Learn to use the power of Pentaho for Business Intelligence reporting in a series of simple, logical stages. From installation in Windows or Linux right through to publishing your own Java web application, it's all here.

What do you get with a Packt Subscription?

Key benefits

Description

Who is this book for?

What you will learn

Product Details

What do you get with a Packt Subscription?

Product Details

Packt Subscriptions

Frequently bought together

Table of Contents

Recommendations for you

Customer reviews

Filter reviews by

People who bought this also bought

About the authors

FAQs