Pentaho 8 reporting for java developers create pixel perfect analytical reports using reporting tools

Pentaho 8 Reporting for Java Developers Create pixel-perfect analytical reports using reporting tools Francesco Corti BIRMINGHAM - MUMBAI Pentaho 8 Reporting for Java Developers Copyright © 2017 Packt Publishing All rights reserved No part of this book may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, without the prior written permission of the publisher, except in the case of brief quotations embedded in critical articles or reviews Every effort has been made in the preparation of this book to ensure the accuracy of the information presented However, the information contained in this book is sold without warranty, either express or implied Neither the author, nor Packt Publishing, and its dealers and distributors will be held liable for any damages caused or alleged to be caused directly or indirectly by this book Packt Publishing has endeavored to provide trademark information about all of the companies and products mentioned in this book by the appropriate use of capitals However, Packt Publishing cannot guarantee the accuracy of this information First published: September 2017 Production reference: 1120917 Published by Packt Publishing Ltd Livery Place 35 Livery Street Birmingham B3 2PB, UK ISBN 978-1-78829-899-5 www.packtpub.com Credits Author Copy Editor Francesco Corti Safis Editing Reviewers Project Coordinator Ruben Oliva Ramos Nidhi Joshi Juan Tomas Oliva Ramos Commissioning Editor Proofreader Amey Varangaonkar Safis Editing Acquisition Editor Indexer Viraj Madhav Tejal Daruwale Soni Content Development Editor Graphics Cheryl Dsa Tania Dutta Technical Editor Production Coordinator Dinesh Pawar Arvindkumar Gupta About the Author Francesco Corti is an enthusiastic consultant in software solutions and loves working in developer, sales, and customers teams Proud of the role of a software engineer, he is often involved in pre-sales presentations, public speaking, and IT courses Developing software, designing architectures, and defining solutions in ECM/BPM and BI are his favorite areas of interest He has completed dozens of projects, from very small ones to more complex ones, in almost 20 years of experience A product evangelist at Alfresco, Francesco represents the famous open source ECM in the developer community In addition to helping developers adopt Alfresco technologies, he often helps Alfresco to improve the developer experience through talks, articles, blogging, user demonstrations, recorded demonstrations, or the creation of sample projects He is the inventor and principal developer of Alflytics (previously named Alfresco Audit Analytics and Reporting), the main business intelligence solution over Alfresco ECM, entirely based on the Pentaho suite He authored the Pentaho Reporting video course with more than 40 videos and courses on the Pentaho Reporting Designer and SDK Francesco has specialty and principal experiences in enterprise content management solutions with Alfresco ECM and Hyland OnBase (he is an OnBase certified installer); business process management solutions with Activiti, JBPM, and Hyland OnBase; data capture solutions with Ephesoft, Hyland OnBase, and custom software; record management solutions with O'Neil software and custom software (using Alfresco ECM and Hyland OnBase); and portal and collaboration with Liferay and MS SharePoint About the Reviewers Ruben Oliva Ramos is a computer systems engineer from Tecnologico de Leon Institute, with a master's degree in computer and electronic systems engineering, teleinformatics, and networking specialization from the University of Salle Bajio in Leon, Guanajuato, Mexico He has more than 5 years of experience in developing web applications to control and monitor devices connected with Arduino and Raspberry Pi using web frameworks and cloud services to build the Internet of Things applications He is a mechatronics teacher at the University of Salle Bajio and teaches students of the master's degree in design and engineering of mechatronics systems Ruben also works at Centro de Bachillerato Tecnologico Industrial 225 in Leon, Guanajuato, Mexico, teaching subjects such as electronics, robotics and control, automation, and microcontrollers at Mechatronics Technician Career; he is a consultant and developer for projects in areas such as monitoring systems and datalogger data using technologies (such as Android, iOS, Windows Phone, HTML5, PHP, CSS, Ajax, JavaScript, Angular, and ASP.NET), databases (such as SQlite, MongoDB, and MySQL), web servers (such as Node.js and IIS), hardware programming (such as Arduino, Raspberry pi, Ethernet Shield, GPS, and GSM/GPRS, ESP8266), and control and monitor systems for data acquisition and programming He has authored the book Internet of Things Programming with JavaScript by Packt Publishing He is also involved in monitoring, controlling, and the acquisition of data with Arduino and Visual Basic NET for Alfaomega I would like to thank my savior and lord, Jesus Christ, for giving me the strength and courage to pursue this project; my dearest wife, Mayte; our two lovely sons, Ruben and Dario; my dear father, Ruben; my dearest mom, Rosalia; my brother, Juan Tomas; and my sister, Rosalia, whom I love, for all their support while reviewing this book, for allowing me to pursue my dream, and tolerating not being with them after my busy day job Juan Tomas Oliva Ramos is an environmental engineer from the university of Guanajuato, with a master's degree in administrative engineering and quality He has more than 5 years of experience in management and development of patents, technological innovation projects, and development of technological solutions through statistical control of processes He is a teacher of statistics, entrepreneurship, and technological development of projects since 2011 He has always maintained an interest for the improvement and the innovation in the processes through the technology He became an entrepreneurship mentor and technology management consultant and started a new department of technology management and entrepreneurship at Instituto Tecnologico Superior de Purisima del Rincon He has worked on the book Wearable Designs for Smart Watches, Smart TVs and Android Mobile Devices He has developed prototypes through programming and automation technologies for the improvement of operations, which have been registered for patents I want to thank God for giving me the wisdom and humility to review this book I want to thank Ruben, for inviting me to collaborate on this adventure I also thank my wife, Brenda, our two magic princesses, Regina and Renata, and our next member, Tadeo All of you are my strengths and happiness, and my desire is to be for the best for you Pentaho Reporting SDK nightly build Once the Pentaho Reporting artifact has been built, all the Pentaho Reporting libraries will be available in it, as described in Chapter 1, Introduction to Pentaho Reporting In this section, you are going to learn how to use the nightly build in your Java projects, using Pentaho Reporting in its latest (and possibly unstable) release for evaluation purpose Assuming that you have an existing Java project using Pentaho Reporting, let's see in the following sections how to update it to use the nightly build As an example, you can use one of the examples available in the GitHub repository at h ttps://github.com/fcorti/pentaho-8-reporting-for-java-developers To prepare the project, copy it into a working folder As an example, you could use the project stored in the Chapter 03 - Getting started with Reporting SDK/pentahoreporting-web-app folder Updating the pom.xml file The very first task to prepare the existing project is to change the pom.xml file Opening pom.xml with an editor, you will see that all the Pentaho dependencies point to 8.0-SNAPSHOT Of course, nothing really changes if your project uses a different version For all the Pentaho dependencies, update the version tags to the nightly build version In our example, you will use 8.1-SNAPSHOT Again, nothing really changes if your project uses a different version Saving the pom.xml file is all that is required to update the Java project Adding the nightly build libraries If you'd run the build of the project now, the Apache Maven client would try to download all the Pentaho dependencies in their newest version, requested from the pom.xml file (in our example, 8.1-SNAPSHOT) Considering that the newest version would not be published yet in the Pentaho's Sonatype Nexus Repository, an error would occur and your build would fail To solve this issue, there is a workaround, which is adding the Pentaho newest dependencies into your local Apache Maven repository In brief, when Apache Maven looks for a dependency, it first looks into the local repository (in the m2/repository folder), and if not found there, it tries to download it from the remote repository By adding the newest Pentaho dependencies into your local Apache Maven repository, you will skip the need to go to the remote repository, avoiding the failure Be aware that this is a workaround to enable you to use the latest (and possibly unstable) Pentaho Reporting nightly build Adding libraries to a local Maven repository is not a best practice and should be limited as much as possible To install a library or an artifact in general to a local Apache Maven repository, there is a command similar to the following one: mvn install:install-file -Dfile=path/to/artifact/name.jar -DgroupId= -DartifactId= -Dversion= -Dpackaging=jar By using this command for each Pentaho dependency, you can update your local Apache Maven repository with the nightly build The following is the command list to run, to add all the requested dependencies, to build with success all the examples described in this book: mvn install:install-file -Dfile=./reportdesigner/lib/classic-core-8.1-SNAPSHOT.jar -DgroupId=pentaho-reportingengine -DartifactId=pentaho-reporting-engine-classic-core -Dversion=8.1SNAPSHOT -Dpackaging=jar mvn install:install-file -Dfile=./report-designer/lib/classic-extensions-8.1SNAPSHOT.jar -DgroupId=pentaho-reporting-engine DartifactId=pentaho-reporting-engine-classic-extensions -Dversion=8.1SNAPSHOT -Dpackaging=jar mvn install:install-file -Dfile=./report-designer/lib/wizard-core-8.1SNAPSHOT.jar -DgroupId=pentaho-reporting-engine DartifactId=pentaho-reporting-engine-wizard-core -Dversion=8.1SNAPSHOT -Dpackaging=jar mvn install:install-file -Dfile=./report-designer/lib/libbase-8.1SNAPSHOT.jar -DgroupId=pentaho-library -DartifactId=libbase Dversion=8.1-SNAPSHOT -Dpackaging=jar mvn install:install-file -Dfile=./report-designer/lib/libdocbundle-8.1SNAPSHOT.jar -DgroupId=pentaho-library -DartifactId=libdocbundle Dversion=8.1-SNAPSHOT -Dpackaging=jar mvn install:install-file -Dfile=./report-designer/lib/libfonts-8.1SNAPSHOT.jar -DgroupId=pentaho-library -DartifactId=libfonts Dversion=8.1-SNAPSHOT -Dpackaging=jar mvn install:install-file -Dfile=./report-designer/lib/libformat-8.1SNAPSHOT.jar -DgroupId=pentaho-library -DartifactId=libformat Dversion=8.1-SNAPSHOT -Dpackaging=jar mvn install:install-file -Dfile=./report-designer/lib/libformula-8.1SNAPSHOT.jar -DgroupId=pentaho-library -DartifactId=libformula Dversion=8.1-SNAPSHOT -Dpackaging=jar mvn install:install-file -Dfile=./report-designer/lib/libloader-8.1SNAPSHOT.jar -DgroupId=pentaho-library -DartifactId=libloader Dversion=8.1-SNAPSHOT -Dpackaging=jar mvn install:install-file -Dfile=./report-designer/lib/librepository-8.1SNAPSHOT.jar -DgroupId=pentaho-library -DartifactId=librepository - Dversion=8.1-SNAPSHOT -Dpackaging=jar mvn install:install-file -Dfile=./report-designer/lib/libserializer-8.1SNAPSHOT.jar -DgroupId=pentaho-library -DartifactId=libserializer Dversion=8.1-SNAPSHOT -Dpackaging=jar mvn install:install-file -Dfile=./report-designer/lib/libxml-8.1SNAPSHOT.jar -DgroupId=pentaho-library -DartifactId=libxml Dversion=8.1-SNAPSHOT -Dpackaging=jar mvn install:install-file -Dfile=./report-designer/lib/legacy-charts-8.1SNAPSHOT.jar -DgroupId=pentaho-reporting-engine DartifactId=pentaho-reporting-engine-legacy-charts -Dversion=8.1SNAPSHOT -Dpackaging=jar mvn install:install-file -Dfile=./report-designer/lib/classic-extensions-xpath8.1-SNAPSHOT.jar -DgroupId=pentaho-reporting-engine DartifactId=pentaho-reporting-engine-classic-extensions-xpath Dversion=8.1-SNAPSHOT -Dpackaging=jar mvn install:install-file -Dfile=./report-designer/lib/classic-extensions-pmd8.1-SNAPSHOT.jar -DgroupId=pentaho-reporting-engine DartifactId=pentaho-reporting-engine-classic-extensions-pmd Dversion=8.1-SNAPSHOT -Dpackaging=jar mvn install:install-file -Dfile=./report-designer/lib/classic-extensions-kettle8.1-SNAPSHOT.jar -DgroupId=pentaho-reporting-engine DartifactId=pentaho-reporting-engine-classic-extensions-kettle Dversion=8.1-SNAPSHOT -Dpackaging=jar mvn install:install-file -Dfile=./report-designer/lib/classic-extensionsmondrian-8.1-SNAPSHOT.jar -DgroupId=pentaho-reporting-engine DartifactId=pentaho-reporting-engine-classic-extensions-mondrian Dversion=8.1-SNAPSHOT -Dpackaging=jar mvn install:install-file -Dfile=./report-designer/lib/classic-extensions-olap4j8.1-SNAPSHOT.jar -DgroupId=pentaho-reporting-engine - DartifactId=pentaho-reporting-engine-classic-extensions-olap4j Dversion=8.1-SNAPSHOT -Dpackaging=jar Compiling and running the project Now that your Java project is updated to the newest Pentaho Reporting version, and the local Apache Maven repository contains the available nightly build, you can build it as usual, running the mvn clean package command from a Terminal Using this workaround, you will be able to try the very last version of Pentaho Reporting in its nightly build containing the latest enhancements and features Getting help from the community As an open source project, Pentaho Reporting has a community of people and organizations who contribute by answering questions, providing translations, filing and fixing bugs, writing documentation, and of course, by contributing code To make sure you can find what you need to engage the Pentaho Reporting community, the following is a list of online places and tools to help you get started Asking questions and helping others Today, there are two primary methods of communication in the Pentaho Reporting community The first and most widely used method is Pentaho Reporting forums These forums are located at http://forums.pentaho.org/ under the main category Pentaho Reporting You can search and read forum discussions, or sign up for an account and ask your own questions Another main method of communication is Pentaho's IRC channel, set up by Pentaho community members This channel is located on the FreeNode IRC (https ://freenode.net/), as channel ##pentaho If you don't have an IRC client, feel free to join the channel using the FreeNode WebChat (http://webchat.freenode.net) A large number of active Pentaho community members are available to answer technical questions Online documentation While the reading this book, you have already seen that Pentaho has a website dedicated to documentation and it is available at https://help.pentaho.com/ In the documentation's website, you will find all the available content about the latest version, and also the content related to the previous versions Pentaho hosts a wiki, which contains community documentation for Pentaho's various projects You can find the wiki at http://wiki.pentaho.com, which contains links to Pentaho Reporting documentation, as well as tech tips that walk you through specific use cases As a wiki, community members may contribute their own tech tips or documentation around any of the Pentaho projects Pentaho also hosts a sub-domain dedicated to the Pentaho Reporting community at http://reporting.pentaho.org, which contains information about the latest releases and download links Also, Javadoc for the latest versions of Pentaho's open source projects is hosted online at http://javadoc.pentaho.com Pentaho Reporting Javadoc can be found at http://javadoc.pentaho.com/reporting/ Submitting bugs and viewing backlogs To submit a bug, or view Pentaho Reporting's backlog, you can visit Pentaho's JIRA bug tracking system at http://jira.pentaho.com Pentaho Reporting is broken into two main projects: the Pentaho Reporting Engine and the Pentaho Report Designer Each project contains a road map link, containing a list of prioritized activities that Pentaho and the open source community are working on Contributing code If you'd like to add a new feature to Pentaho Reporting or fix a bug, the source code for the Reporting Engine and Report Designer is easily accessible Pentaho maintains the reporting project in a GitHub repository at https://github.com/pentaho/pent aho-reporting The reporting engine's core source code is located in the engine subfolder, and the Report Designer is located in the designer subfolder By going to https://github.com/pentaho/pentaho-reporting/releases, you can browse the dozens of releases and version changes, using your browser One of the many types of contributions Pentaho receives is translated message bundles These message bundles are located in the reporting projects, and can be found by searching for the messages.properties files in each project For instance, there are many of these files in the engine project Enterprise support Pentaho offers an enterprise edition of Pentaho Reporting, which includes direct customer support, as well as additional functionality, such as enterprise auditing within Pentaho's Business Analytics Platform If you are working in an enterprise and would like to purchase an enterprise license, you can contact Pentaho directly by visiting http://www.pentaho.com Subscription customers have access to Pentaho which contains many articles and enterprise documentation on all of Pentaho's products Pentaho works with a large set of partners to offer consulting, which may include everything from setting up your reporting server to writing custom functionality that your business requires What to do once you become an expert Did you see how powerful Pentaho Reporting is? And it is still given for free after several years Can you imagine how much effort has been invested from a bunch of developers to reach this level of maturity? How much of your precious time has been saved, thanks to the use of tools like Pentaho Reporting? How many things you will learn attending the forums, the chat, learning from the public documentation or the blog posts written from real experts? Now it's probably your time to benefit from all of this, but don't forget to give something to the others, once you reach the point where you are a Pentaho Reporting expert Help the others in the same way as someone else helped you This makes the community valuable Summary In this chapter, you learnt how to build and use the Pentaho Reporting nightly build, with Pentaho Report Designer and the Pentaho dependencies in your Java projects In the last topic of this book, you went through all the ways to find documentation, resources, support, meet the community, and so on, as a new developer and expert in Pentaho Reporting Thank you for taking the time to read this book My hope is that now you feel comfortable with Pentaho Reporting and feel excited to try new projects using it Enjoy! .. .Pentaho 8 Reporting for Java Developers Create pixel- perfect analytical reports using reporting tools Francesco Corti BIRMINGHAM - MUMBAI Pentaho 8 Reporting for Java Developers. .. An example of report localization using Java Subreports using Java Subreports using Java An example of subreport using Java Cross tab using Java Cross tabs using Java An example of cross tab using Java Summary 14... Working with formulas Creating a formula The formula syntax Formula datatypes Formula operators The available formula categories Date or time formulas Database formulas Information formulas Logical formulas