ULTIMATE GUIDE JasperReports Server 5.0 JasperReports Server Ultimate Guide Copyright © 2013 Jaspersoft Corporation. All rights reserved. Printed in the U.S.A. Jaspersoft, the Jaspersoft logo, Jaspersoft iReport Designer, JasperReports Library, JasperReports Server, Jaspersoft OLAP, and Jaspersoft ETL are trademarks and/or registered trademarks of Jaspersoft Corporation in the United States and in jurisdictions throughout the world. All other company and product names are or may be trade names or trademarks of their respective owners. This is version 1301-JUG50-11 of the JasperReports Server Ultimate Guide. 2 Table of Contents TABLE OF CONTENTS Chapter 1 Introduction . 9 1.1 Community and Commercial Editions . 9 1.2 About this Guide . 10 1.2.1 Technical Business Analyst . 10 1.2.2 Report Developer . 10 1.2.3 System Developer . 10 1.2.4 System Administrator and Database Administrator . 10 1.3 Other Resources . 11 1.3.1 Standard Documentation . 11 1.3.2 Premium Documentation . 11 1.3.3 Jaspersoft Community Site . 11 1.4 Getting Started . 12 Chapter 2 Ad Hoc Views and Data Exploration . 13 2.1 About the Ad Hoc Editor . 14 2.1.1 User Interface Components . 14 2.1.2 Context Menus . 21 2.2 Working with Ad Hoc Views . 21 2.2.1 Summaries . 21 2.2.2 Setting the Data Format . 22 2.2.3 Custom Fields . 23 2.3 Administering Ad Hoc Views . 24 2.3.1 Administering Topics . 24 2.3.2 Administering Domains . 24 2.3.3 Scalability . 24 Chapter 3 The Report Viewer and Conditional Text . 27 Chapter 4 Dashboards . 31 4.1 User Interface Components . 32 4.2 Context Menus . 33 3 JasperReports Server Ultimate Guide 4.3 Tips and Tricks . 34 Chapter 5 Custom Data Sources . 37 5.1 Data Sources in JasperReports Library . 37 5.1.1 Query Executers . 38 5.2 Overview of the Custom Data Source Examples . 38 5.2.1 Custom Bean Data Source . 38 5.2.2 Webscraper Custom Data Source . 39 5.3 Prerequisites and Installation of the Examples . 40 5.3.1 Java Development Kit . 40 5.3.2 About Apache Ant . 40 5.3.3 Installation . 40 5.4 Creating a Custom Data Source . 41 5.4.1 Implementing the ReportDataSourceService Interface . 41 5.4.2 Defining Custom Data Source Properties . 41 5.4.3 Implementing Optional Interfaces . 42 5.4.4 Creating the Message Catalog . 42 5.4.5 Defining the Custom Data Source in Spring . 43 5.4.6 Configuring the Message Catalog . 44 5.5 Installing a Custom Data Source . 44 Chapter 6 Securing Data in a Domain . 47 6.1 Business Case . 48 6.2 Overview of CZS’s Process . 48 6.3 Sales Domain . 48 6.4 Roles, Users, and Profile Attributes . 50 6.4.1 Roles . 50 6.4.2 Users . 50 6.4.3 Profile Attributes . 50 6.5 Setting Up Testing . 51 6.5.1 Enabling Logging . 52 6.5.2 Creating a Test Report . 52 6.6 Creating a Security File . 53 6.6.1 Row-level Security . ..