JReport Designer User's Guide PDF
JReport Designer User's Guide PDF
JReport Designer User's Guide PDF
This User's Guide describes JReport Designer. JReport Designer is a report development environment
that enables sophisticated report design and presentation of critical business data. Report designers
can easily access data from any data source and generate highly formatted reports to deliver
information to authorized end users in the most relevant and intuitive manner.
This guide is written for report developers or Java application developers that want to embed JReport
reports into their application.
JReport Tutorial
JReport Server
Performance Improvements with the advanced report engine are focused on faster response time
and better scalability. Through internal system tuning and minimizing redundancy, JReport now has a
smaller footprint with faster response time for on-demand report generation, report delivery, and
interactive reporting and analysis.
Faster Expanding/Collapsing Actions in Crosstab. Adjusted the default value for the property
Expand Detail Data on crosstabs to improve the performance.
Reduce SQL calls when Interacting with Cascading Parameters. The unnecessary accesses to
the database are reduced when running reports with cascading parameters.
Use Derby as the Default JReport System Database. JReport changed its default system
database from HSQLDB to Apache Derby to provide better performance and support transactions
with higher reliability.
Support Bind Variables in JReport Server System Database. Bind variables are now supported
in most of JReport Server system databases to improve JReport Server performance.
Reduce the Response Time of a Single Event. Further improved the web control feature by
supporting executing combined actions of changing parameter value, sorting, and filtering that is
triggered by one event.
The Remote Dispatcher Is Enhanced. You can now dispatch RMI Server Pages requests in
multiple server environment without modifying any of your code. For details, see Dispatching
RMI Server Pages requests in multiple server environment in the JReport Server User's Guide.
Usability is improved with a simpler interface and more tools that enhance productivity.
Redesign the UI of Using the Saved Parameter Values When Specifying Parameter Values
for Running or Scheduling Reports. The new UI is more intuitive and easier to use. For details,
see Parameters in the JReport Server User's Guide.
Add Command Buttons to the Report Set/Task/Version Tables. Now on the JReport Console
page, you can handle reports, tasks, or versions with a quicker access of command buttons.
New UI Standard for JReport. JReport Server, JReport Viewer, JReport Studio and JReport Server
Monitor now use a consistent UI standard. Arrangement has also been taken to the presentation of
tabs and options so as to make the UI clearer and nicer.
New Functional Features to provide enhanced capabilities in security, report output and more.
Cached Report Data. JReport now supports Cached Report Data (CRD), which is a cached subset of
data fetched from the database according to certain conditions and is used for retrieving data for
reports instead of the database. Cached Report Data provides several benefits, for example, reports
can be run from a specific point in time such as a month end report or quarter end report without
going back to the DBMS to get the original data, users running a report will all see the same view of
the data, thus the data will not change minute by minute based on current DBMS updates. This can
provide a huge performance advantage and reduce the load on the DBMS when multiple users use
the same query for their reports. For details, see Managing cached report data in the JReport Server
User's Guide.
Support User Defined Resource Properties. By providing the Custom Field feature, user defined
resource properties are supported. For details, see Working with custom fields in the JReport Server
User's Guide.
Use an External Method for Profiling Data. You can now monitor the JReport Server performance
via an external method: JMX MBean API or Web Service API. For details, see Monitoring the server
performance in the JReport Server User's Guide.
Support Global NLS. Now you can create global NLS resources on JReport Server, which can be
shared by all report sets in both JReport Designer and JReport Server to reduce your translation cost.
For details, see NLS Editor and Creating global NLS for report sets in the JReport Server User's Guide.
Support Setting Report Set Status. Users/groups/roles which have the Update Status permission
of a report set can now change the status of the report set to specify whether a report set can be
run. The purpose is to allow report sets to temporarily by made not runnable without having to delete
them and republish them to make them available.
Add a New Server Database Branch. The new database branch is called system database. It
holds resources of the global server scope, such as server.properties, global NLS, etc. The original
system or systables database is now addressed as realm database since it is specific to a realm. The
profiling database remains as before. For details about the three databases, see Data dialog in the
JReport Server User's Guide.
Support Installation on 64-bit Operating Systems. All JReport installers have been upgraded
and can now work on all 64-bit operating systems as well as on 32-bit OSs.
Support Itext 1.5.4. The Itext version JReport supports is now upgraded to 1.5.4.
I18N Support on Server UI. JReport Server now supports the Java I18N standards, so that it can
be adapted to various languages and regions without engineering changes.
Field Format Improvement for Crosstab Drill. Field format now will be kept when drilling in
crosstab.
Enhanced Speed When Opening Reports. Unnecessary calls to the DesignService APIs have been
removed when opening reports in DHTML format, which decreases the number of calls to the
Designer APIs and improves performance.
Categorize Resources in the Field Drop-down List. Now category folders are added to the field
drop-down list of the condition panel so that the resources are easier to pick and duplicate resource
names are avoided in multiple fields.
Redesign the Export Dialog. The new UI is better organized and easier to use. For details, see
Export dialog in the JReport Server User's Guide.
Mark the Resources in Use in the Resource Tree. Resources referenced by the current selected
component are now displayed checked in the resource tree, so that user can easily find out the
resources are being used.
JReport Viewer Dialogs And Menus Are Simplified. When creating a report with the report
wizard, if there is only one cube available in the current catalog, the Data screen is now hidden from
the wizard and this cube will be used to create the report by default. Meanwhile, if there is only one
style available to be applied to any report, all the style related commands, dialog tab and wizard
screen are not displayed now.
Support the Web Action of Linking to a Customized Page. With the new web action
user_popCustomizedPage(), you can get a customized page, which by default shows all the
parameters the current report uses if it has parameters. You can change the parameter values to rerun the report. Meanwhile, you can customize the page to make it display what you need by using
the DHTML API. For details, see the Customized Page dialog in the JReport Server User's Guide.
Support Drill-Up Action and Drill Filter Panel. The drill-up action is now supported on crosstab,
table, and banded object in analytic reporting. In addition, when you perform the drill actions, if any
filters are created, the Drill Filter panel will be displayed, showing the filters. Thus, with the Drill Filter
panel and drill-up action support, you can drill back and forth to change the data scope as required.
For details, see Automatic drilling in the JReport Server User's Guide.
Basic and Advanced Modes of the Filter Dialogs. Filter related dialogs now support two modes:
basic and advanced. The basic mode provides functions for creating simple filter conditions that are
connected by ADD and OR operators. The advanced mode enables the building of more complex filter
conditions via the grouping of conditions. Moreover, a filter inspector is provided for listing all the
filters a report set is using. For details, see Filter dialog in the JReport Server User's Guide.
Support Four New Web Controls. These four types of web controls are added: parameter control,
parameter form control, filter control, and navigation control. For their usages, see Applying web
controls in the JReport Server User's Guide.
Studio Reports Solution is aimed at easier and faster report creation and design, faster report
execution, easier customization, and better presentation style using a newer Rich Internet Application
(RIA) Web 2.0 interface. For details, see Studio Reports in the JReport Server User's Guide.
Scalable Architecture separates layout intensive tasks (rich client) from data intensive tasks
(server).
Business Views as Data Sources for Studio Reports. Business views are used as data sources
for studio reports and are created and managed in JReport Designer. A business view is similar to a
report cube except that there is no hierarchical relationship between the data objects in a business
view. For details, see Business views.
New Ad Hoc Report Wizard Based on AJAX is configurable for both of business and technical
users, facilitates the creation of complex reports with multiple components in a tabular style layout.
The Report Wizard supports new table templates covering all common table structures. It also allows
for easy creation of a report cover page and back page for more formal presentations. For details,
see JReport Studio Wizard in the JReport Server User's Guide.
JReport Studio is the rich internet application (RIA) with robust interactive functions, where you
open and edit studio reports. You can insert components, apply filters, parameters, and CSS styles,
set up links among studio reports, and export and print report results. For details, see Studio Reports
in the JReport Server User's Guide.
Open and Edit Studio Reports in JReport Designer. JReport Designer supports downloading
studio reports from JReport Server, opening, creating and editing studio reports, and publishing
studio reports to server. For details, see Working with studio reports.
Support Client Side Report Layout in JReport Studio/Wizard. In JReport Studio/Wizard, a new
engine is employed to support client side report layout to improve JReport Server performance and
scalability.
JReport Designer
Support Web Service Data Source. JReport now supports web services defined by WSDL 2.0 as
data sources. For details, see Web service data sources.
Support Refreshing XML Schema. You can now modify the XML schema of an existing XML data
source via the Import XML Schema screen of the XML Connection Wizard. Once you finish modifying
and click the newly added Refresh button in the screen, the new schema information will be reloaded
according to what you have changed.
Table Enhancement. A new table structure is provided so each group, detail and summary field can
be held within its own column. In addition, more operations and functions are supported on tables.
For details, see Creating a table report, Managing columns/rows in a table and Table properties.
Catalog Browser Layout Enhancement. Resources in the Catalog Browser are re-organized
according to their relationship to make the resource tree structure clearer.
Customizable Data Sources in Catalog. You can now change the default data source name,
rename and delete the data sources in a catalog freely. For details, refer to Creating a catalog.
Support Inner Join Type. A property - Explicit Inner Join - is added to JDBC connection in the
Catalog Browser for controlling whether to use Explicit Join notation or Implicit Join notation in the
Where clause for inner joins. On some DBMS system, using explicit join notation improves
performance.
Improved Indentation on Nested Groups. When multiple groups are inserted into a banded
object or a table via the report wizard, by default, the indent of the groups is 0 now which means the
groups will not be indented. However, you can customize the group indent according to your own
requirements by setting the Customize group indent option in the Options dialog.
Customize DHTML Display Name for Actions. When customizing the field display names, you can
now further define where the display names will be used in specific components. For details, see
Customizing the field display names.
Define Default View Format When Designing Reports. A property - Default Format for Viewing
Report - is added in the Report Inspector at the report level for predefining the default report view
format. The property works when viewing or directly running the report in JReport Server.
Support More W3C CSS Properties. JReport now supports more W3C CSS 2.1 standard
properties, which allows you to create various CSS styles to change the visual presentation of your
reports. Meanwhile, an option - Show warning message when CSS properties are not supported by
JReport - is added in the Options dialog, for controlling whether to show the unsupported CSS
properties when applying CSS styles.
Refresh the Catalog Reference Table by API. You can now use the method public boolean
refreshReference(CrossReferenceConfigure referenceConfigure) in the Catalog API to refresh the
reference table of a catalog. For details, see Refreshing the reference table of a catalog.
Download Resources from JReport Server. You can now download the resources managed on
JReport Server to your local disk and further modify them in JReport Designer. This is particularly
useful for Web Reports (.wls) to allow you to add additional customizations to the templates using
JReport Designer then republish them to the server. For details, see Downloading resources from
JReport Server.
Consistently Support Hex for Designer Formula Color Picker. The Designer formula color
picker now supports RGB hexadecimal value of colors. It shows the RGB hexadecimal value of the
specified color, or you can enter the RGB hexadecimal value of a color manually.
Customize the Sheet Name for Report in Excel Result. When exporting a report to Excel, you
can now define the sheet name for the report in the exported Excel result file by setting the property
Sheet Name of the report.
Add Postfix Number to Subreport Worksheets in Excel Result. A property - Sheet Name
Postfix - is added on subreport, with which you can define how to add the postfix number to the
sheets in which the subreport will be put when exporting the report to Excel.
Chart Can Be Created Through the Report Wizard Along with the Banded/Crosstab/Table
Using the Same Group and Summary Fields. For details, see Creating a banded report.
Reduce the Memory JRMemoryAppeneder Holds. You can now use the method
setUsedMemoryAppender(boolean use) in the Engine Bean to reduce the memory
JRMemoryAppeneder holds. For details, see Reducing the memory JRMemoryAppender holds.
Formula Control Enhancement on Properties of Crosstab Fields. Most of the properties for
crosstab fields and labels can now be controlled by formulas. JReport automatically filters formulas
that are not supported for a property.
Format for Aggregate Fields in Crosstab Is Now Unified. Rather than setting the format for
detail, each sub-total and each grand-total a single format can be specified for all values for a
crosstab cell.
Support Importing User Defined Formula Classes via UI. You can now import user defined
formula classes in two ways: using the "import" statement or via dialog. The dialog also enables
editing class alias. By providing different aliases one UDF class can be imported more than once. The
imported UDF classes' functions are displayed in the UDF node in the Functions panel of the Formula
Editor. You can perform on UDF functions just like on the other built-in functions. For more, see User
defined formula functions.
Support Displaying Instance Name. A property Instance Name is added to all the objects in the
Report Inspector to show the instance name for each object. The instance name is required when
using the API methods.
Map Enhancement. The Map feature is further improved in several respects: you can now define
the area tips when you import areas from a .shp file in the Select Area Name dialog; in the Reset All
dialog, you can not only reset all the properties for map areas including the labels and summary
fields inside the areas globally, but also choose some specific properties you want to apply global
settings. You can also control whether or not the label for the area will be displayed when the size of
the area is changed to be smaller than the label, by using the option Automatic Filling Labels in the
Map Canvas Setup dialog.
Show the Value Label on the Value Axis in Percent. JReport now provides an option, Show
Percent, in the Format Value(Y)/(Y2) Axis dialog, by controlling whether the value label on the value
(Y)/(Y2) axis of a chart can either be displayed as value, or be shown in percent.
Support New Chart Types. Two new chart types, Bullet Chart and Donut Pie Chart, are now
supported in JReport.
Showing/Hiding Table Columns by Constant Level Formula. The property Invisible on table
columns can now be controlled by constant level formulas.
Support Linking Crosstab and Another Report with Conditions. You can now make a specified
field in a crosstab link with another report with conditions.
Support More Data Source Types for Binding Parameter With Column. When binding a
parameter with a column, you can now select the column in the following data sources: tables and
views, stored procedures, imported SQLs, and user defined data sources. For details, see Creating a
parameter.
Expanding/Collapsing Data Enhancement in Crosstab. With the Expand Data property on
DBFields and formulas added in to a crosstab as dimensions, you can specify which dimensions'
details can be expanded/collapsed in DHTML format. For details, see Expanding/Collapsing a crosstab.
Support Showing/Suppressing Specified Row/Column Subtotals in Crosstabs. In a crosstab,
you can now control which subtotal of rows/columns will be suppressed, and which will be shown, by
using the Suppress Row Subtotal dialog and Suppress Column Subtotal dialog.
Extend Contents in Table Column/Crosstab Field Automatically. When the contents in a table
column/crosstab field needs more space to completely display, you can automatically adjust the
width of the table column/crosstab field according to their contents, by using the property Auto Fit.
Web Control Enhancement. You can now add the value "All" to a list/drop-down list by using the
Insert Fields dialog. Then when All is selected as value of the list/drop-down list at runtime, all filter
actions defined on the list/drop-down list will not take effect, and if you applied some other web
action that needs value from the list/drop-down list, a Null value will be returned.
Link to Multiple Components in a Report. When linking a report with another one, you can
specify multiple components in the target report to be interlinked with the primary report, no matter
if they are based on the same dataset or not, and set separate link conditions for each component.
For details, see Linking a report to another report.
Alternating Line Color Control in a Crosstab. A property group Alternating Line Color is added to
crosstab, which allows you to define a specified color for the fields in the same rows or columns in a
crosstab.
New Look and Feel for JReport Designer. Based on JDK 6, JReport Designer now uses the new
Java Swing look and feel rather than the original Metal look and feel of previous versions.
Support Skip First N in Chart. For details, see Setting Order/Select N condition for category/series
field.
Resolved issues
Item
Case #
Issue
53080
Reports that have a lot of sub-reports now work correctly without throwing a
ClassCastException or getting a page calculation error.
55653
The Export to XML dialog now works with the Only Data option.
55673
Stored procedures now work correctly using the SQL Server 2008 version.
55673
All of the cascading parameters are now listed in the .cat.xml file.
55673
The result of the stored procedure now works according to the user's parameter value
change.
55997
Reduced memory usage when user exports a report to Excel with the Preserve Report
Formatting option checked.
56081
Enabled the outer join function for the queries using XML data sources.
56302
The exported Excel file now works fine after user exports a report to Excel format.
56324
The image quality now stays good in PostScript result format after user's JReport
Designer is upgraded from V7 version.
56383
User can now specify a formula for the Suppress property of a chart object and run the
report on JReport Designer without getting an IndexOutOfBounds exception.
10
56451
11
56924
12
56924
Now the Auto Join setting can be used with XML data sources to automatically join
parent and child data.
13
56979
The user defined density works normally now when user sets only Horizontal Density or
Vertical Density.
14
56993
The fonts of exported PDF files now display normally after user exports reports to PDF
format.
15
57161
When user copies and pastes a query in a catalog, the catalog can be successfully
compiled because in the new query we now generate a different name for
JetUWhereFormula.
16
57213
The exported Excel file now works fine after user exports a chart containing only one
item on the series axis.
17
57284
Now after user exports a chart to HTML file, it shows complete tip information when
user moves the mouse pointer over any text in the graph.
18
57284
The exported Excel file containing a chart report now displays normally after user
saves the file and opens it again.
19
57284
The exported Excel file containing a chart report now displays normally when user
opens it with MS Office 2010 version.
Known issues
Compiling formulas in JReport under JDK 6 or higher gets warnings
Since generic type is introduced to JDK 6 or higher version, when compiling formulas in JReport under
API change
jet.formula.ParamDesc.value has been set to private now. You can use getDisplayValue(DbValue
paramvalue, java.util.Locale locale) instead.
For example:
ParamDesc desc = new ParamDesc();
... ...
desc.getDisplayValue(desc.getValue(), Locale.getDefault());
Features of JReport
Features of JReport
JReport Designer supports report development. JReport Designer provides the following features:
Interactive IDE
JReport Server supports report generation and management. JReport Server has the following
features:
JReport Web supports information delivery. JReport Web has the following features:
Ad hoc reporting
Flexible output formats: PDF, Excel, XML, RTF, e-mail and more
JReport Server is a 100% Java report generation and management tool. It enables efficient
management, sharing, scheduling, versioning, and delivery of reports and enables reporting to be
integrated into the workflow of any Java application. The high-performance engine can scale to any
workload. Report results can be saved to a versioning system, sent to enterprise/workgroup printers,
or e-mailed. With JReport, reports can be viewed in any modern enterprise format including DHTML,
HTML and standard business documents, such as PDF, Excel, and RTF.
JReport Web enables reports to be accessed through a web browser via Dynamic HTML, or AJAX. With
JReport Web technology, reports can be modified using dynamic filter, sort, and drill capabilities. Using
JReport Web's advanced capabilities, users can drag and drop columns to and from an existing report,
dynamically change chart types, pivot crosstabs, add groups, convert report components or create an
entirely new report.
JReport SDK - All JReport functionality can be accessed through Java APIs using JSP pages, servlets,
or standalone applications.
Products information
http://www.jinfonet.com/products/jreport-suite
Release information
http://www.jinfonet.com/products/whats-new
News center
http://www.jinfonet.com/news/jreport-news-highlights
Demo center
http://www.jinfonet.com/products/jreport-demo
Products download center
http://www.jinfonet.com/downloadjreport/
White papers
http://www.jinfonet.com/products/white-papers
JReport product documentation
http://www.jinfonet.com/kbase.htm
JReport Javadoc
http://www.jinfonet.com/kbase.htm
JReport technical support center
http://www.jinfonet.com/support/
import java.io.*;
import java.awt.*;
import jet.api.*;
import jet.jetc.*;
import jet.universe.exception.*;
DesignerUserInfo userInfo=new
DesignerUserInfo("Uid","XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX");
Designer desg
= new Designer(path, cat, userInfo);
desg.setLog(new FileOutputStream(log), "8859_1");
//Opening an Existing Report
report = desg.open(name);
//Getting Handles
handle = desg.getHandles(report, Designer.IMAGE)[0];
//Changing the Property Value
//Change the image "coffee.gif" to "ship-logo.gif"
desg.set(handle, "PictureName", "ship-logo.gif");
//Change the image position
desg.set(handle, "X",
2.24f);
//Change the image width
desg.set(handle, "Width", 4.76f);
desg.exit();
By creating a Designer instance in your Java program, you can modify an existing report or create a report (based
on the existing catalog and query) with the methods provided by Designer API.
jet.bean.*;
java.awt.*;
java.awt.event.*;
javax.swing.*;
Then, we will create an instance. To run with JReport Result Viewer Bean, you should create an instance of it first.
The constructor of JReport Result Viewer Bean has no parameter. After the object is created, set the report name,
set temp path (if not set then the current path will be the default). After runReport(), call the export or print
methods for exporting report result file to multiple output. The important thing is that the report name here is the
report result generated by JReport Engine. In other words, the report result file is generated by JReport Designer,
JReport Engine Bean or JReport Server.
bean = new JRResultViewer();
bean.setShowInfoLevel(bean.vDebug | bean.vError);
bean.setReportName("C:\\JReport\\Designer\\temp\\CustomerAnalysis.rst");
bean.runReport("yes");
bean.exportToPS("C:\\test\\CustomerAnalysis.ps");
bean.exportToRtf("C:\\test\\CustomerAnalysis.rtf");
bean.printReport();
System requirements
Suppported databases
Silent installation
Command-line startup
System requirements
The following table shows the basic system requirements for installing JReport Designer. Check your
system to make sure that all the requirements have been met before installation.
JReport Designer System Requirements
Recommended Requirements Minimum Requirements
OS:
CPU:
Memory:
3 GB
2 GB
Disk:
1 GB free
1 GB free
JDK:
6 or above
6 or above
Create and edit report cubes, business cubes, and business views. These are data sources created in
JReport Designer for ad hoc Page Layout Reports and Web Layout Reports.
Publishing Web Layout Reports and previewing them in JReport Studio also require that JReport
Server has a JReport Server Live license.
Downloading reports which use business views, report cubes or business cubes as data source from
JReport Server also requires that JReport Server has a JReport Server Live license.
See also JReport Server Live license in the JReport Server User's Guide for details about the features
the license controls.
Supported databases
JReport supports all of the current mainstream databases as well as most databases which support
ODBC or JDBC drivers. The following table lists the databases and JDBC drivers that have been tested
with JReport. If you are using any of the databases listed below, you are recommended to use the
corresponding driver version with JReport although any driver which the DBMS supplier recommends is
also fine. Also, if you encounter problems when using a database or driver version that is not listed
here, you can contact Jinfonet Support ([email protected]) for help.
Database
Version
JDBC Driver
Example URL
MS SQL
Server
2005
sqljdbc.jar
com.microsoft.
sqlserver.jdbc.
SQLServerDriver
jdbc:sqlserver://<host>:1433;user=sa;
password=1234;database=test
MS SQL
Server
2000
msbase.jar; msutil.
jar; mssqlserver.jar
com.microsoft.jdbc.
sqlserver.
SQLServerDriver
jdbc:microsoft:sqlserver://<host>:1433
MS SQL
Server
2000
Opta2000.jar
com.inet.tds.TdsDriver jdbc:inetdae7:<host>:1433?
database=test
MS SQL
Server
2000
tds-1.0.3.jar
net.sourceforge.jtds.
jdbc.Driver
jdbc:jtds:sqlserver://<host>:1433/test
Oracle
9i
JDK1.2&1.3:
classes12.zip;
JDK1.4: ojdbc14.jar
oracle.jdbc.driver.
OracleDriver
jdbc:oracle:thin:@<host>:1521:ora9i
Oracle
10.1.0.2.0
(10g)
JDK1.2&1.3:
classes12.zip;
JDK1.4: ojdbc14.jar
oracle.jdbc.driver.
OracleDriver
jdbc:oracle:thin:@<host>:1521:ora9i
Oracle
11.1.0.6.0
(11g)
classes12.jar
oracle.jdbc.
OracleDriver
jdbc:oracle:thin:@<host>:1521:ora11g
DB2
8.1
DB2
8.1
Db2java.zip
com.ibm.db2.jdbc.app. jdbc:db2:test
DB2Driver
DB2
8.2
Db2jcc.jar;
db2jcc_license_cu.jar
(Linux, Unix and
Windows);
db2jcc_license_cisuz.
jar (Linux, Unixand
Windows, z/OS,
OS/390,z/OS, iSeries
etc)
com.ibm.db2.jcc.
DB2Driver
DB2
8.2
Db2java.zip
com.ibm.db2.jdbc.app. jdbc:db2:test
DB2Driver
redbrick.jar
redbrick.jdbc.
RBWDriver
jdbc:rbw:protocol:<host>:5050/test/
ifxjdbc.jar
com.informix.jdbc.
IfxDriver
jdbc:informix-sqli://<host>:1526/
stores_demo:informixserver=DBSC
postgresql-8.0-310.
jdbc3.jar
org.postgresql.Driver
jdbc:postgresql://<host>:5432/test
MySql
mysql-connector-java- com.mysql.jdbc.Driver
5.0.3-bin.jar
RedBrick
warehouse
Informix
9.30
mysql5.0.18win32
jdbc:db2://<host>/test
jdbc:db2://<host>:50000/test
jdbc:mysql://<host>:3306/test
MySql
mysql 4
mysql-connector-java- com.mysql.jdbc.Driver
3.0.14-production-bin.
jar
jdbc:mysql://<host>:3306/test
MySql
mysqlmysql-connector-java- com.mysql.jdbc.Driver
5.0.2-alpha- 3.1.5-gamma-bin.jar
win
jdbc:mysql://<host>:3306/test
MySql
mysql4.1.12win32
mysql-connector-java- com.mysql.jdbc.Driver
3.1.10-bin.jar
jdbc:mysql://<host>:3306/test
MySql
mysql 5
mysql-connector-java- com.mysql.jdbc.Driver
5.0.4-bin.jar
jdbc:mysql://<host>:3306/test
hsqldb.jar
org.hsqldb.jdbcDriver
jdbc:hsqldb:D:\JReport\Demo\db
\SampleDB
HSQL
Sybase
12.5
jconn2.jar
com.sybase.jdbc2.jdbc. jdbc:sybase:Tds:<host>:5000/master
SybDriver
Sybase
12.5
jconn3d.jar
com.sybase.jdbc3.jdbc. jdbc:sybase:Tds:<host>:5000/master
SybDriver
postgresql-8.0-310.
jdbc2.jar
org.postgresql.Driver
jdbc:postgresql://<host>:5432/test
Cache
Cache 4
CacheDB.jar
com.intersys.jdbc.
CacheDriver
jdbc:Cache://<host>:1972/samples
Derby
10.5.1.1
derby.jar
org.apache.derby.jdbc. jdbc:derby:D:\derby\demo\databases
EmbeddedDriver
\toursdb
Note: If you want to use the DB2 app connection, you need to install the client and configure the net
address first.
The Installation Wizard will first find a JVM to get started. If no JVM is found, the JReport installer
will fail to launch. To resolve this issue, you can try either way:
Run the startup batch file from a MS-DOS command prompt. For example, assume that JReport
Designer has been installed in C:\JReport\Designer, you can type the following commands:
C:\>cd JReport\Designer\bin
C:\JReport\Designer\bin>jreport.bat
From the Control Panel, open Add or Remove Programs, and then select JReport Designer 10 to
remove it.
Run uninstaller.exe in <install_root>\_uninst.
Note: The uninstaller removes all files that were generated by the installer, while any files that were
created later by the program are retained. These files should be removed manually.
The Installation Wizard will first find a JVM to get started. If no JVM is found, the JReport installer
will fail to launch. To resolve this issue, you can try either way:
Specify a JVM for Installation Wizard with the option LAX_VM as follows:
$ ./jrpsetup.bin LAX_VM "/home/jdk1.6.0_17/bin/java"
The JDK path should use absolute path and be quoted by "".
Alternatively, you can open a console window, and change the directory to the location of the
uninstaller.sh file. The following are examples of the commands that can be used:
$ cd thepath
Run the uninstaller file:
$ ./uninstaller
Silent installation
JReport provides a file for installing JReport Designer silently without user participation in the
installation process, both on Windows and Unix platforms.
Follow the steps below to install JReport Designer silently:
1. Download the file DesignerInstall.properties from the Jinfonet website.
2. Run the following command, and JReport Designer will be installed in the designated path:
$ ./jrpsetup.bin -i silent -f DesignerInstall.properties
Or $ ./jrpsetup.bin LAX_VM "USER_JAVA_HOME/bin/java" -i silent -f DesignerInstall.
properties (recommended)
Notes:
When installing JReport Designer silently, make sure you do not use overwrite installation, instead,
install it to a new directory.
When you install the Update or Service Pack silently, edit the file update.properties in
<install_root>\help\designer\samples to your own requirements. This file is used to create an
option file (i.e. response file) for the Installation Wizard. It predefines all the information that is
required for the installation.
You can also create a property file and save it as follows:
USER_INSTALL_DIR=/usr/local/JReport/Designer
USER_KEY=UID
USER_PASSWORD=Password
Modify the above lines according to your own environment and configurations.
If the installation is cancelled after you click the Install button on the installation wizard, logs are
created in the logs folder in the installation root directory.
Besides, on a Windows platform, you can choose to specify the log destination that should use absolute
path and log file name when launching the installation wizard:
jrpsetup.exe -D$INSTALL_LOG_NAME$="Install.log" -D$INSTALL_LOG_DESTINATION$="D:\temp"
or
$ ./jrpsetup.bin -D$INSTALL_LOG_NAME$="Install.log" -D$INSTALL_LOG_DESTINATION$="/opt/
temp"
Feel free to send your questions to [email protected].
CatDr.bat/CatDr.sh
This tool is for starting the Catalog Doctor in order to make changes to the catalog.
Usage
java <-Dreporthome=reporthome> jet.builder.JReport [-options] [reportfile]
Options
-help
Print out this message.
-vDebug
Enable output debug message.
-vError
Enable output error message.
-log[:<file>]
Output message to .\<file> or the default.
DJReport.bat/DJReport.sh
This tool is for starting JReport Designer in logging mode. In case of problems, you are requested to
launch JReport Designer with this batch file/script file in order to track detailed log information.
Running this batch file/script file generates log file in the <install_root>\logs directory.
Usage
java <-Dreporthome=reporthome> com.jinfonet.designer.JReport [-options][reportfile]
Options
-help
Print out this message.
-vDebug
Enable output debug message.
-vError
Enable output error message.
EConvert.bat/EConvert.sh
This tool is for removing the evaluation mark from reports. If you have purchased the JReport product
and is successful in running JReport Designer with the new key, but the evaluation watermarks are still
left, you will need to run this batch file to remove the evaluation watermarks. Run the batch file with
the report names to be converted with the full path as parameter.
Usage
java -Dreporthome=<drive>:<path> jet.report.EvlConverter
[[drive:][path][filename] +]
[drive:][path][filename]
Econvert.bat [ReportName.cls]
Example: Econvert.bat C:\JReport\Designer\Demo\Reports\TutorialReports\*.cls
jrenv.bat/jrenv.sh
This tool is for generating the report environment file report.env in the current directory. This file can
help the Jinfonet support staff assist you when you run into problems.
JReport.bat/JReport.sh
This tool is for starting JReport Designer.
Usage
java <-Dreporthome=reporthome> com.jinfonet.designer.JReport [-options][reportfile]
Options
-help
Print out this message.
-vDebug
Enable output debug message.
-vError
Enable output error message.
Note: You may need to set an appropriate -Dfile.encoding option in the file to start JReport
Designer in order to view characters correctly.
JRTutorial.bat/JRTutorial.sh
This tool is for running this batch file to display the tutorial help.
ModelWizard.bat/ModelWizard.sh
-help
Print out this message.
-vDebug
Enable output debug message.
-vError
Enable output error message.
-log[:<file>]
Output message to JGUIEditor.log or .\<file>.
NJReport.bat/NJReport.sh
This tool is for starting JReport Designer without the JIT option.
Usage
java <-Dreporthome=reporthome> com.jinfonet.designer.JReport [-options][reportfile]
Options
-help
Print out this message.
-vDebug
Enable output debug message.
-vError
Enable output error message.
PropConvert.bat/PropConvert.sh
This tool is for converting property values. Running this batch file will display a window from which you
can modify many properties of a selected report file. This is most useful when you want to modify
several properties using the same value at the same time. For example, if a Label and several DBFields
share the same background of blue, and now you want to change them all to transparent, you can
simply use this tool.
rp.bat/rp.sh
This tool is for replacing user ID and license key.
Usage
rp UID Key
rptconv.bat/rptconv.sh
This tool is for converting old report schema to be current version.
Usage
rptconv "-source=source_path" ["-target=destination_path"] [-r] [-s]
Options
-source
Specify the source path of the reports that are to be converted.
-target
Specify the destination path for the converted reports.
-r
Replace the source report with the converted version.
If this option is set, ["-target=destination_path"] will be ignored.
If both "-r" and "-target" are not specified, the converted reports are saved in the same directory as
the source reports and named as "converted_SourceReportName".
-s
Convert all the reports in the specified directory, including the reports in all subdirectories.
Examples
This will convert all the reports in C:\JReport\Designer\demo\reports and in the subdirectories and
save the converted reports to C:\temp. The converted reports take the same file names and directory
structure as source reports.
rptconv "-source=C:\JReport\Designer\demo\reports" "target=C:\temp\*.cls" -s
This will convert all the reports in C:\JReport\Designer\demo\reports and in the subdirectories and
save the converted reports to C:\temp. The converted reports take the same directory structure as
source reports and the suffixes of their file names are all changed to ".cls".
rptconv "-source=C:\JReport\Designer\demo\reports" -r -s
This will convert all the reports in C:\JReport\Designer\demo\reports and in the subdirectories.
The converted reports overwrite the source reports.
rptconv "-source=C:\JReport\Designer\demo\reports"
This will convert all the reports in C:\JReport\Designer\demo\reports. All the converted reports
are saved in the same directory and named as "converted_SourceReportName".
Notes:
There must be one and only one catalog file in the directory where the reports to be converted
reside.
If the reports to be converted contain UDO or UDF, make sure the corresponding classes or jars are
included in the class path of rptconv.bat/rptconv.sh.
Command-line startup
You can launch JReport Designer from the Command Prompt window. This method is optional on some
platforms (Windows for example) and preferred on others. Using command-line startup enables you to
use the command-line syntax options.
java -Dreporthome=path -classpath path jet.builder.JReport -vError -vDebug -help
The command line arguments for JReport Designer are described below. Note that the setup process
creates several startup batch files which may contain additional parameters.
-Dreporthome
Specifies the directory where JReport Designer has been installed. This parameter is required. When
you set the report home, upon launching, JReport will try to find jslc.dat and report.ini files in
<install_root>\bin and check whether they are valid. jslc.dat is the License control file. If you
open report.ini, you will find configuration information, including the temp path, template path and
the help path. JReport uses the temp path for exporting temporary files, so you should make sure
that the temp folder specified in report.ini actually exists.
Assume that JReport Designer has been installed in C:\JReport\Designer, this parameter is Dreporthome=C:\JReport\Designer.
-classpath path
Tells the Java interpreter the class path. It is usually used for appending the JReport Designer lib
path to the Java class path. For example, assume that JReport Designer has been installed in C:
\JReport\Designer and Java (JDK1.x.x) has been installed in C:\java, this parameter is then:
-classpath C:\java\lib\classes.zip;C:\jreport\designer\lib\report.jar;
-Djava.compiler=NONE
Turns off just in time compiling, which sometimes creates problems.
-Djrpt.outer=true
Enables JReport Engine to generate an SQL statement with full outer join syntax instead of with
abbreviated syntax.
-Xmx200m
Sets the maximum Java heap size.
Logging and debugging switches
You can use the following two command switches together to track detail debug and error
information.
-vError - Enables JReport Designer to output error messages. If you start Designer with this
command in the command-line, correspondingly in the LogConfig.properties file, value of the
engine Error level will be set to ERROR and value of the engine Trace level will be set to OFF.
-vDebug - Enables JReport Designer to output information and warning messages. If you start
Designer with this command in the command-line, correspondingly in the LogConfig.properties file,
value of the engine Error level will be set to WARN and value of the engine Trace level will be set to
INFO.
You can specify the log file format, such as Text, or HTML. You can then decide whether or not to
append the log files to an existing file, or to create a new file. You can even specify the log layout
using the abundant options that JReport provides. To do this, you need to edit the file LogConfig.
properties in <install_root>\bin. For detailed information on how to configure logging and
debugging information, see the LogConfig.properites file.
-help
Prints the help message.
Convert a report by opening it directly and then saving it with JReport Designer 10.
A Version 7 or prior report is converted to a flow layout report with a banded object. A banded object
has the same report sections that a Version 7 or prior report template has, however in Version 10 the
sections are called panels. Any other data objects in the Version 7 or prior report are converted to the
corresponding data containers within the banded object.
All converted reports can be used in the same way as a new Version 10 report that contains a banded
object. You can insert other components into the banded panels as described in Component placement.
In addition, the features of Version 10, such as page mode, displays types, CSS styles and so on can
be applied to the converted reports. However, in the converted reports, the layout cannot extend
beyond the banded object as it can for a new report created in Version 10. That is, while you can insert
components into the banded object created as a result of the migration, you cannot insert components
after the banded object. If your reports require this functionality, you will need to re-create the report
as a new report in Version 10.
Note: Migrated reports need to be analyzed to determine how Version 10 functionality can best be
applied. For example, converted reports that share a dataset should be combined into report sets to
take full advantage of Version 10 performance improvements. Contact Jinfonet Professional Services
for assistance if desired.
Menu bar
Toolbars
Inspector panel
Toolbox panel
Design/View area
Menu bar
The following menus are available on the menu bar. Click the links to get details.
File menu
Edit menu
View menu
Insert menu
Format menu
Report menu
Window menu
Help menu
File menu
The File menu contains the following items:
New
Report Set
Creates a report set. For details, see Creating a report set.
Report
Creates a report in the current report set. For details, see Creating a report.
Studio Report
Creates a blank studio report. For details, see Creating a studio report.
Query
Creates a query. For details, see Creating a query.
Business Cube
Creates a business cube. For details, see Creating a business/report cube.
Data Source
Creates a data source. For details, see Data Source Connections.
Open
Opens an existing report set. For details, see Opening a report set.
Open Recent
Lists recently accessed files for you to open.
Close
Closes the active report set.
Close All
Closes all open report sets.
Save
Saves the active report set.
Save As
Saves the active report set with a different name in the current directory.
Save To
Saves the active report set with a different name to another directory. This command will also merge
the report's resources to the other directory by either creating a new .cat file (if there is no .cat file in
that directory), or merging with the existing .cat file (if a .cat file already exists in that directory).
For details about saving report sets in JReport Designer, see Saving a Report Set.
Catalog Management
New Catalog
Creates a catalog file. For details, see Creating a catalog.
Open Catalog
Opens a catalog file. For details, see Opening a catalog.
Save Catalog
Saves the open catalog file.
Save Catalog As
Saves the open catalog file with a different name to another directory.
For details about saving catalogs in JReport Designer, see Saving a catalog.
Import From
Export To
Exports the current report result to JReport Result, HTML, PDF, Excel, Text, RTF, XML, PostScript, Mail,
Fax, or Applet format. For details, see Exporting report results.
Publish and Download
Publish to Server
Publishes resources from their original location to JReport Server. For details, see Publishing
resources remotely.
Publish to Local Directory
Publishes resources from their original location to a local directory. For details, see Publishing
resources locally.
Download from Server
Downloads resources on JReport Server to a local directory. For details, see Downloading resources
from JReport Server.
Options
Opens the Options dialog to configure JReport to suit your requirements.
Page Setup
Opens the Page Setup dialog to set up page properties.
Print Preview
Switches to the view mode for you the preview the report result.
Print
Prints the current report result. For details, see Printing report results.
Exit
Closes JReport Designer. If there are any files not saved, you will be prompted to save them.
Edit menu
The Edit menu contains the following commands:
Undo
Reverses a previous action.
Redo
The counter-operation of Undo.
Cut
Erases an object and places it in the clipboard.
Copy
Copies an object and places it in the clipboard.
Paste
Takes an object from the clipboard and places it into the report.
Delete
Erases an object from the report.
Select All
Selects all the objects in the report.
Find DBField
Finds a specific DBField in the report.
Parameter Order
Sets the parameter order. For details, see Editing the display sequence of parameters.
Freeze Field in Table
If checked, the fields in a table will be stopped from accepting any mouse or keyboard events.
Merge
Merges two or more cells in a table or tabular.
NLS Editor
Shows the NLS Editor for you to edit NLS file. For details, see NLS Editor.
CSS Style
Shows the CSS Editor for you to manage CSS styles. For details, see Managing CSS styles.
View menu
The View menu contains the following commands:
Preview As
Previews the report result in various formats. For details, see Previewing a report.
Toolbar
Specifies whether or not to show the Standard, Format, NLS Language, Insert, View, and Alignment
toolbars. You can customize the toolbars by clicking the Customize item.
Resource View
Specifies whether or not to show the Resource View panel.
Report Inspector
Specifies whether or not to show the Inspector panel.
Catalog Browser
Specifies whether or not to show the Catalog Browser panel.
Toolbox
Specifies whether or not to show the Toolbox panel.
Status Bar
Specifies whether or not to show the status bar.
Page Layout
Specifies whether or not to show the report in page layout style, which displays the page margins and
enables multiple pages to be continuous.
Page Header
Specifies whether or not to show the page header.
Page Footer
Specifies whether or not to show the page footer.
Rulers
Specifies whether or not to show the vertical and horizontal rulers.
Guidelines
Specifies whether or not to show guidelines.
Margin
Specifies whether or not to show page margins.
Grids
Insert menu
The Insert menu contains the following commands:
DBField
Inserts a DBField into a report. For details, see Inserting a DBField in a report.
Formula
Inserts a formula field into a report. For details, see Inserting a formula in a report.
Summary
Inserts a summary field into a report. For details, see Inserting a summary field in a report.
Parameter
Inserts a parameter field into a report. For details, see Inserting a parameter field in a report.
Group
Creates and edits the criteria by which the fields of certain components are grouped and sorted. For
details, see Grouping the data.
Label
Inserts and creates labels into a report.
Text Box
Places and creates a text box into a report.
Image
Places a BMP, JPEG, or GIF image into a report.
Barcode
Inserts a barcode into a report. For details, see Barcodes.
Rank
Inserts a rank object into a report. For details, see Ranks.
Table
Inserts a table into a report. For details, see Inserting a table.
Crosstab
Inserts a crosstab into a report. For details, see Inserting a crosstab.
Chart
Inserts a chart into a report. For details, see Inserting a chart.
Tabular
Inserts a tabular into a report. For details, see Inserting a tabular in a report.
Banded Object
Inserts a banded object into a report. For details, see Inserting a banned object.
Subreport
Inserts a subreport into a report. For details, see Inserting a subreport.
Map
Inserts a map into a report. For details, see Inserting a map.
UDO
Inserts a user defined object into a report. For details, see Inserting a UDO into a report.
Special Fields
Inserts a special field which are not fetched from the database into a report.
Drawing Objects
Draws lines, boxes, arcs, ovals, and round boxes in a report.
Web Controls
Inserts web controls into a report. For details, see Web controls.
Multimedia Objects
Inserts multimedia objects into a report, including flash files, applets, Windows Media files, and
RealMedia files. For details, see Multimedia objects.
Page Break
Inserts a page break after the current page in a report.
Page Panel
Inserts a page panel after the current page in a report.
Format menu
The Format menu contains the following items:
Conditional Formatting
Opens the Conditional Formatting dialog to add some conditional formats to the selected field.
Move
Move Backward
Places the selected object that overlaps one or more objects behind the current overlapping object.
Move To Back
Places the selected object that overlaps one or more objects behind all the overlapping objects.
Move Forward
Brings the selected object that overlaps one or more objects to the front of the current overlapping
object.
Move To Front
Brings the selected object that overlaps one or more objects to the front of all the overlapping
objects.
Align
Left
Shifts the selected object to the left.
Right
Shifts the selected object to the right.
Top
Shifts the selected object to the top.
Bottom
Shifts the selected object to the bottom.
Vertical Center
Aligns the selected object in the center vertically.
Horizontal Center
Aligns the selected object in the center horizontally.
Vertical Distribute Space
Spaces the selected object evenly in a vertical direction.
Horizontal Distribute Space
Spaces the selected object evenly in a horizontal direction.
Left
Aligns the content of the selected object to the left boundary of the object .
Center
Aligns the content of the selected object to the center of the object.
Right
Aligns the content of the selected object to the right boundary of the object.
Justify
Adjusts horizontal spacing so that the content is aligned evenly along both the left and right margins
in the selected object.
Text Style
Bold
Specifies whether or not to bold the text in the selected object.
Italic
Specifies whether or not to italicize the text in the selected object.
Underline
Specifies whether or not to underline the text in the selected object.
Position
Static
Positions the selected object to the default location.
Relative
Positions the selected object to "flow" relating to its surrounding objects.
Absolute
Sets the selected object to the location you specify by dragging and dropping or setting the X and Y
properties.
Report menu
The Report menu contains the following commands:
Dataset Management
Manages existing datasets. For details, see Managing datasets.
Edit Display Name
Specifies the field display names for the Sort, Filter, Search dialogs and the Drill menu items in JReport
Viewer. For details, see Customizing the field display names.
Edit Sort and Filter
Predefines sort and filter conditions for banded objects/tables/charts/crosstabs. For details, see
Predefining sort and filter conditions.
Bursting
Opens the Bursting dialog to enable the current report to become a bursting report.
Window menu
The Window menu contains the following commands:
Cascade
Cascades the design windows of the open report sets.
Tile Horizontally
Tiles the design windows of the open report sets horizontally.
Tile Vertically
Tiles the design windows of the open report sets vertically.
Windows
Adjusts the open report sets.
Note: Besides the above, you may see one or more items labeled file names, and the item
representing the current report set is marked with a check. You can click an item to activate the
window of the report set that it represents.
Help menu
The Help menu contains the following commands:
Tutorial
Displays the JReport Tutorial.
User's Guide
Displays the JReport Designer User's Guide.
Welcome Page
Shows the Welcome Page.
Jinfonet Software Home Page
Accesses Jinfonet Software website.
Online Support
Opens the Jinfonet online support page.
Knowledge Base
Opens the page which directs to the Jinfonet knowledge base.
About JReport
Brings out the About JReport Designer window. This window shows general product information about
JReport Designer.
Toolbars
By default, JReport Designer provides the following toolbars:
Standard toolbar
Format toolbar
Insert toolbar
View toolbar
Alignment toolbar
Notes:
If you want to reset the toolbars to the default, right-click the space on any toolbar and then click
Reset on the shortcut menu.
Standard toolbar
This toolbar by default contains the following buttons:
New Report Set
Creates a new report set. For details, see Creating a report set.
Open
Opens a report set.
Save
Saves the current report set.
Page Setup
Opens the Page Setup dialog to set page properties of the active report in the current report set.
Print
Shows the Print dialog for you to print the active report in the current report set. The dialog varies
according to the printing method you choose.
Preview As
Previews the report result in the specified format. For details, see Previewing a report.
Cut
Erases an object and places it on the clipboard.
Copy
Copies an object and places it on the clipboard.
Paste
Takes an object from the clipboard and places it into the report.
Delete
Deletes the selected object.
Undo
Reverses a previous action.
Redo
The counter-operation of Undo.
Find DBField
Finds specific DBFields in a report.
Freeze Field in Table
Stops the fields in a table from accepting any mouse or keyboard events, or releases the status of
freezing.
Merge and Split
Merges cells in a table or tabular, or split a tabular cell, or unmerge a merged cell in a table.
Format toolbar
This toolbar contains the following buttons and drop-down list boxes by default:
Font Face
Specifies the font face of the text in the selected object.
Font Size
Specifies the font size of the text in the selected object.
Style
Specifies the style group applied to the selected object.
Bold
Specifies whether or not to bold the text in the selected object.
Italic
Specifies whether or not to italicize the text in the selected object.
Underline
Specifies whether or not to underline the text in the selected object.
Justify
Adjusts horizontal spacing so that the content is aligned evenly along both the left and right margins in
the selected object.
Left
Aligns the content of the selected object to the left boundary of the object.
Center
Aligns the content of the selected object to the center of the object.
Right
Aligns the content of the selected object to the right boundary of the object.
Background Color
Specifies the background color of the selected object.
Font Color
Specifies the color of the text in the selected object.
Conditional Formatting
Opens the Conditional Formatting dialog to add some conditional formats to the selected field.
Insert toolbar
Below are the buttons contained in this toolbar by default:
Insert DBField
Inserts a DBField into a report. For details, see Inserting a DBField in a report.
Insert Formula
Inserts a formula field into a report. For details, see Inserting a formula in a report.
Insert Summary
Inserts a summary field into a report. For details, see Inserting a summary field in a report.
Insert Parameter
Inserts a parameter field into a report. For details, see Inserting a parameter field in a report.
Insert Group
Creates and edits the criteria by which the fields of certain components are grouped and sorted. For
details, see Grouping the data.
Insert Label
Inserts a label into a report.
Insert Text Box
Creates and places a text box into a report.
Insert Image
Places a BMP, JPEG, or GIF image into a report.
Insert Barcode
Inserts a barcode into a report. For details, see Barcodes.
Insert Rank
Places a rank object into a report. For details, see Ranks.
Insert Table
View toolbar
The following buttons or drop-down lists are contained in this toolbar by default:
Toolbox
Shows or hides the Toolbox panel.
Catalog Browser
Shows or hides the Catalog Browser.
Inspector
Shows or hides the Report Inspector.
Page Layout
Specifies whether or not to show the report in page layout style, which displays the page margins and
enables multiple pages to be continuous.
Show Hidden Object
Specifies whether or not to show hidden objects.
View Percent Box
Lists percentages with which you can zoom in or out of a report.
Alignment toolbar
The Alignment toolbar provides the following buttons by default:
Align Left
Shifts the selected object to the left.
Align Right
Shifts the selected object to the right.
Align Top
Shifts the selected object to the top.
Align Bottom
Shifts the selected object to the bottom.
Align Vertical Center
Aligns the selected object to the center vertically.
Align Horizontal Center
Aligns the selected object to the center horizontally.
Vertical Distribute Space
Spaces the selected object evenly in a vertical direction.
Horizontal Distribute Space
Spaces the selected object evenly in a horizontal direction.
Move To Back
Places the selected object that overlaps one or more objects behind all the overlapping objects.
Move To Front
Brings the selected object that overlaps one or more objects to the front of all the overlapping objects.
Move Backward
Places the selected object that overlaps one or more objects behind the current overlapping object.
Move Forward
Brings the selected object that overlaps one or more objects to the front of the current overlapping
object.
Change Position
Click the downward triangle to change the position of an object.
Toolbar
The toolbar includes the following buttons:
Views
This button varies according to what view you select. It provides a shortcut menu for you to switch
among the view modes (Query View, Dataset View, and Dataset List View). The Query View mode
lists all available resources for the current report set. The Dataset View mode also lists all these
resources, however with a checkbox left to every resource for you to select (for a dataset coming
from a hierarchical data source, there are no such checkboxes). The Dataset List View mode lists the
resources you have selected in the dataset view mode.
Dataset Filter
Filters out some unnecessary data.
Search Resource
Searches the required resources in the Resource View panel. See the topic below for details.
Edit
This button is for editing the selected object if it is a query, formula, summary or parameter.
According to what you have selected, clicking this button will bring out different dialogs.
Properties
Opens the Properties dialog of the selected object. You can edit the properties as desired.
Link with Editor
If this check button is selected, the Dataset drop-down list will show the dataset bound to the
currently selected object; or else the drop-down list will always show the dataset you have selected
from the drop-down list, until you will select another one.
2. Provide a search condition in the Search Expression text box. Use "*" to stand for any string, and
use "?" to stand for any character.
3. Select the Case Sensitive checkbox if you want JReport to distinguish between uppercase and
lowercase characters when searching.
4. Specify the search scope by selecting the radio button Selected Resources or Search In.
Selected Resources: If you have selected a resource in the resource tree, when you bring out
the Search in Resource Viewer dialog, this radio button is selected and JReport will search for
the resources from the selected resource.
Search In: If it is selected, JReport will search for the resource from the Resource View panel.
5. Click the Search button to search for the resource you want.
The result will be listed in the Search Result panel which has three columns: Resource Name,
Resource Type and Resource Path. You can sort the search result alphabetically by clicking the
column headers. Select a search result from the Search Result panel, the resource node that
contains it will be expanded and with that resource highlighted in the Resource View panel.
Inspector panel
The Inspector panel can be displayed by clicking View > Report Inspector on the menu bar, or the
Report Inspector button
Toolbar
A report set may contain one or more reports, and each report contain a report body. You can use the
toolbar to focus on one of the three levels, namely the report set, report, and report body.
Home
Only shows the current report and its contents (including TOC of the report and datasets used in the
report) in the Report structure panel.
Down
Goes down a level, i.e., clicking this button will switch from the report set level to the report level, or
from the report to the report body.
Up
Goes up a level, i.e., clicking this button will switch from the report body level to the report level, or
from the report to the report set.
Toolbox panel
You can click View > Toolbox on the menu bar, or the Toolbox button
the Toolbox panel.
This panel lists all the objects that can be inserted into a report, which are classified as JReport
Component, Web Control, and Multimedia Object. In fact, it is a shortcut to some items on the Insert
menu. The method to create an object using the Toolbox panel is to drag a button representing that
object from the Toolbox panel to the desired location in the report design window.
on the View
This panel lists all data sources, report sets, and styles belonging to the current catalog file (.cat) in
three tabs: Data, Report Sets, and Styles. This is a useful interface which simplifies the work of report
design and the management of the actual resources you use.
Data tab
In this tab, you can manage data sources and their contents used by the catalog.
Report Sets tab
Manage your report sets in Folder view. You can divide them up into different types. In this way, you
can manage them just like processing files in a file system. You can add, open, delete, move, rename
and search for items. For details, see Report Set Manager.
Styles tab
From the Styles tab, you can create and edit styles. For details, see XSD styles.
Toolbar
New
The first button on the toolbar, which may change according to the currently selected object. Usually,
this button contains a plus sign. Click this button to create a new object of the selected type. For
example, if a query is currently selected, you can click this button to create a new query.
Save Catalog
Saves the current catalog.
Copy
Copies the selected entity to the clipboard.
Paste
Fetches the entity from the clipboard and pastes it in a suitable node.
Delete
Deletes the selected entity.
Configure Reference
Allows you to select data sources and resource types that you want JReport Designer to monitor. For
details, see Using a reference table to clarify resource relationships.
Refresh Reference
Refreshes the reference relationship information in order to make it consistent with the catalog
resources.
Export Reference
Exports the reference relationship information to a text file.
Options
Opens the Options dialog to set options for editing a catalog or reports.
Data Source Driver Manager
Manages cached query results. For details, see Managing cached query results.
Pre-join
Defines the pre-join paths formed by the relationships among the tables in the data source you
specified. For details, see Pre-joins.
Data Mapping Editor
Maps the data values of resources in a catalog to a certain language. For details, see Data Mapping
Editor.
Filter View
Excludes some elements from the view in the Catalog Browser. For details, see Filtering resources.
Search
Searches the required resources in the current catalog. For details, see Searching for resources.
Expand /
Fold
Expands or folds the Properties sheet of the Catalog Browser.
Resource Name
Lists the resource names.
Resource Type
Shows the resource types.
Resource Path
Displays the resource paths.
Design/View area
The Design/View area, or report-designing window, comprises of the following parts:
Title bar
The title bar shows the filename of the report set, and three buttons for you to minimize, maximize and
close the active report set.
Design tab
The Design tab is a WYSIWYG area for laying out your report. You can make use of rulers, grids and
guidelines to position objects.
View tab
The View tab is for previewing the report layout and result. In this tab there is a toolbar which consists
of the following buttons:
First Page
Displays the first page of the report.
Previous Page
Displays the previous page of the report.
Next Page
Displays the next page of the report.
Last Page
Displays the last page of the report.
Toc
Shows the table of contents.
Refresh Data
Updates any changes you created in your data.
Refetch Data
Re-fetches data to re-run the report.
Stop
Click this button if you want JReport to stop generating the report.
Back
Navigates to the last view.
Forward
Navigates forward.
Drag Tool
Drags the page up and down.
Click this button, and place your mouse pointer on any blank area of the report. When the mouse
pointer becomes a small hand, you can drag the page.
Zoom In Tool
Enlarges the page.
Zoom Out Tool
Click to view the page in a smaller size.
Catalogs
A catalog is a report set repository. Every report set must exist within the context of a catalog. A
catalog contains two types of data: a physical file that records data sources and object definitions used
by the reports in the catalog, and the report set files themselves. These two types of data, the report
set files and the catalog file, are stored in the same directory.
JReport Designer supports two formats of catalog files. One is the .cat file, which is in binary, and the
other is the .cat.xml file, which is in XML format. The .cat format catalog can be manipulated (opened,
saved, and edited) only by JReport Designer since it is a proprietary binary file. The XML format catalog
has many advantages. It has more readability and controllability. You can modify the catalog freely,
according to your requirements, without using any other special editor. Howerver, the operation of .cat.
xml format catalog in JReport Designer is the same as that of .cat format catalog. The difference
between these two is the underlying structure in which they are organized. By default, the XML format
catalog feature is not enabled. Contact Jinfonet Support ([email protected]) to upgrade your
license key if desired.
JReport Designer comes with four catalogs: JinfonetGourmetJava, SampleComponents,
SamepleReports and TutorialReports. Both the JinfonetGourmetJava and TutorialReports catalogs are
used for the JReport Tutorial manual, and the rest two are samples for you to learn JReport Designer.
This chapter describes the following topics and tasks related to catalogs:
Advantages of catalogs
Creating a catalog
Saving a catalog
Opening a catalog
Merging catalogs
Maintaining catalogs
A database connection defines the database information from which the catalog retrieves its raw data.
For example, it specifies the driver such as JDBC driver (for JDBC), or the data source name (for JDBCODBC bridge), and the user ID and the password for connecting to the raw data. In this way, a
connection is the gateway to the raw database.
Tables/Views, stored procedures, imported queries (SQL files) and queries are all based on the JDBC
connection. Queries are built using the interactive query designer and are based on the tables/views
from the database. Only after you have added the tables/views to the catalog, can you build queries.
Stored procedures are defined in the database. They function like queries, and can be used as data
sources for reports.
Imported queries, that are SQL statements in an external file, can be added to the catalog and also
function as queries.
Functionally, imported queries (SQL files), stored procedures and queries are all the same. However,
queries depend on the tables/views added, while stored procedures and imported queries (SQL files)
only need to connect with your database (you do not necessarily have to add the database tables).
User data sources (UDS) and hierarchical data sources (HDS) are also like queries, but users write the
code for fetching the records. They are independent from the JDBC connection.
Business/Report cubes are a semantic layer - a view of the data source that you create for a business
analyst to use to create analytic reports. Business cubes are based on tables of a data source, while
report cubes are built from specific queries.
Business views resemble report cubes except that there is no hierarchical relationship between the data
objects in business views. Business views enables end users to create studio reports that are oriented
toward presentation rather than slicing and dicing data.
Parameters are used to control the report content at runtime. They are most often used for entering
data selection criteria.
Formulas and summaries are objects that are computed at runtime.
Containers, styles, special fields, and drawing objects can each be customized by setting a wide range
of object properties.
Advantages of catalogs
The main advantage to catalogs is that they provide a way to organize related reports and make it easy
for these reports to share objects, have a consistent look and feel, and be moved to different systems.
Catalogs also provide these additional benefits:
Creating a catalog
A report set can only exist within a catalog. Therefore you must create and open a catalog before you
create or edit a report.
A catalog is represented at the operating system level as a directory that contains the catalog file (.cat)
as well as the other report objects.
To create a catalog:
1. In JReport Designer, click File > Catalog Management > New Catalog on the menu bar.
If necessary, JReport Designer will prompt you to save changes to the current open catalog. Only
one catalog can be open at a time.
2. In the New Catalog dialog, enter the name for the catalog in the Name field.
3. In the Data Source Name field, input the name for the data source that will be created along with
the catalog (when creating a catalog, by default, a data source will be created in the catalog at the
same time). Make sure the name you give follows the Java class naming rule.
4. Specify the path where to save the catalog in the Directory field. You can also click the chooser
button
In the Catalog Browser, select the data source node, then click the New Data Source button
on the Catalog Browser toolbar.
Click File > New > Data Source on the menu bar.
2. In the New Data Source dialog, specify a name for the data source in the Data Source Name field,
select the connection type, then click OK.
3. Set up the connection according to your requirements.
When multiple data sources are created in a catalog, you need to specify which data source will be the
default one for the catalog (by default, the data source that is created along with the catalog is the
default data source of the catalog). To do this, right-click the data source which you want to use as the
default data source, then click Set as Default on the shortcut menu. A catalog must have one and
To rename a data source, right-click the data source and select Rename from the shortcut menu. In
the renaming box, enter a new name for the data source, then click outside the box to confirm the
change.
To delete a data source, right-click the data source, on the shortcut menu, click Delete. The default
data source cannot be deleted.
Saving a catalog
To save a catalog, click File > Catalog Management on the menu bar, then select from the following
commands:
Save Catalog
Saves the open catalog. The type, name and location were specified on the Input New Catalog Name
dialog when you first created the catalog.
Save Catalog As
Saves the open catalog in the selected alternate format. Options are .cat or .cat.xml. The .cat.xml
file can be in the same directory as the .cat file.
A directory can contain only one catalog file other than the .cat and .cat.xml of the same catalog. To
merge multiple catalog files, see Merging catalogs.
Opening a catalog
You can open a catalog explicitly, by using the Open Catalog command, or you can open it implicitly, by
opening one of the report sets in the catalog. For details about opening a report set, see Opening a
report set.
To open a catalog explicitly:
1. Click File > Catalog Management > Open Catalog on the menu bar.
If necessary, JReport Designer will prompt you to save changes to the current open catalog. Only
one catalog can be open at a time.
2. In the Open Catalog File dialog, browse to and select the catalog you want to open and then click
the Open button.
The Catalog Browser displays that lists the resources in the specified catalog.
Merging catalogs
Two catalogs can be merged. The merge operation occurs when you save a report set to another
directory in which a catalog of the same name already exists.
Merging catalogs
With the checking level specified, you can then start to merge catalogs.
1. Open a report set in the catalog that you want to merge with another catalog.
2. Click File > Save To on the menu bar. The Save To dialog appears.
3. Choose a directory where a catalog of the same name exists, and then save the report. If you
specified the checking level as Identify All Differences or Identify Critical Differences, the Merge
dialog will be displayed for dealing with conflicting resources.
4. Highlight one conflicting resource in the resources to be merged panel, and then select the
operations:
Rename - Renames the selected conflicting resource, and copies it to the target catalog with a
new name.
Replace - Replaces the target catalog with the selected conflicting resource from the source
catalog. In this case, the reports that use this object in the target catalog will be impacted.
Skip - Keeps the value in the target catalog for the selected conflicting resource. In this case,
the report that uses this object in the source catalog will be impacted.
5. Click the Differences button and the Properties Differences dialog appears.
The properties values of the conflicting resource from the two catalogs will be displayed in this
dialog with any differences highlighted. Click the Previous / Next button in the dialog, and it will
go to the previous/next conflicting resource. Click Close to close the dialog.
6. Click the Target Relation button in the Merge dialog.
The name of the resource and its parent node in the target catalog will then be displayed in the
Target Relation dialog.
For example, sometimes a resource is marked in the Merge dialog, but in the Properties
Differences dialog, no difference is shown between the two resources. In this case you can use
this button to check whether the parent nodes of the two resources are different.
7. Click Close to close the Target Relation dialog box and return to the Merge dialog.
8. Click the Merge button when you finish. JReport Designer will save the report according to the
changes that you have made.
9. Publish the catalog and the reports and test to ensure all the reports are working properly.
Notes:
Sometimes, though some objects are marked in the Merge dialog, in the Properties Differences
dialog, you will not find these differences. The reason is that some children of the two objects are
different.
JReport Designer checks parameters based on the whole catalog. For example, assume that there is
a parameter named Param1 in DataSource1 of the source catalog, and there is also a parameter
named Param1 in DataSource2 in the target catalog. These two parameters in different connections
will be checked as a conflicting resource. You must rename the parameter in order to get a correct
result.
To access the Catalog Browser, click View > Catalog Browser on the menu bar. See Catalog Browser
panel for information about the panel.
This section describes the following tasks related to managing resources in a catalog:
Filtering resources
Adding a resource
Although there are a variety of resources in a catalog, the ways you create them are fairly similar select a resource node of the type that you want to create, and then create them using either toolbar
buttons or context menu.
To add a resource:
1. Open the catalog to which you want to add the resource.
2. In the Catalog Browser, expand the data source where the resource will be added, then right-click
a resource node or object of the type that you want to create and select Add XXX. The
appropriate object editor or dialog will then be displayed.
For example, if you want to create a formula, right-click the Formulas node and select Add
Formula. The Formula Editor window will be displayed. Create the formula in the window.
Editing a resource
To edit any of the existing resource in a catalog, locate the resource in the Catalog Browser resource
tree, right-click the resource and select Edit XXX from the shortcut menu. Then, the corresponding
editor or dialog will appear for you to edit the resource.
To copy a resource object, select the resource object, on the toolbar of the Catalog Browser, click
the Copy button
To delete a resource object, right-click the resource object, on the shortcut menu, click Delete.
To rename a resource object, double-click the resource object, edit the resource name, and then
click outside the renaming box to confirm the change.
You can also rename objects by using the Properties sheet:
1. Select the resource object, and click the Expand button
show the Properties sheet.
2. Select the property Name, type a new name in the Value field. You need to enable the editable
mode for the Properties sheet before you can do this, that is, you need to uncheck the option
Forbid editing data object properties in the Options dialog.
Note: Renaming an object may impact the reports that use it. You must be aware of the reports
currently using this object so that you can update those reports.
If the Display Width value is not set in the Catalog Browser, it will be inserted with the width defined
in the template. This is the width you selected when creating the report.
Assume that you have set the Display Width of a field, and you insert the field using the wizard or by
dragging and dropping, its width may be adjusted according to the paper size. However, if you insert
the field in design mode, the defined width will not be changed.
3. In the Properties sheet, change the values of the properties to suit you requirements.
The properties listed in the Properties sheet are the default values for the selected resource. You can
change the property values here, and the next time you insert the resource, the value you specify here
will be used as a default value.
The resources that can have default values are table/view columns, formulas, parameters, summaries,
SQL columns, procedure columns and user data source columns. The query column does not support
this feature.
3. Provide a search condition in the Search Expression text field. Use "*" to stand for any string, and
use "?" to stand for any character.
Note: JReport can only search resources in the leaf node of the catalog resource tree.
4. Select the Case Sensitive checkbox if you want JReport to distinguish between uppercase and
lowercase characters when searching.
5. Specify the search scope by selecting the radio button Selected Resources or Search In.
Selected Resources: JReport will search from the resource you have selected in the Catalog
Browser before you bring out the Search in Catalog dialog.
Search In: Search for the resources from the specified data source. If there are multiple
connections in this catalog, select the data source you want from the drop-down list.
For example, if you want to find the DBField Customer Name in the Queries node, first select the node
, then in the Search dialog, input Customer Name in the Search
in the Catalog Browser, click
Expression field, check the scope as Selected Resource and click the Search button. The results will
then be displayed in the Search Result panel. You can click any of the results to highlight it in the
catalog resource tree.
Filtering resources
JReport allows you to filter the data resources in a catalog and remain only the useful resources for you.
To filter resources in a catalog:
1. In the Catalog Browser, click the Filter View button
appears.
2. Provide a filter condition in the Filter Expression text box. Use "*" to stand for any string, and use
"?" to stand for any character. Also you can leave this text box blank.
3. Select the Case Sensitive checkbox if you want JReport to distinguish between uppercase and
lowercase characters when filtering.
4. In the Select the elements to include in the view panel, select the resources you want to remain in
the Catalog Browser by checking the checkbox in front of each resource.
If you want to select/deselect all the resources under one certain data source, check/uncheck
the checkbox of the data source node.
If you want to select/deselect all the resources in the panel, click the Select All/Deselect All
button.
to open the
2. Check the data sources you want JReport to monitor in the Data Source box.
3. In the Catalog Resource Types box, check the resource types that are to be added to the
reference table.
In order to improve product performance and provide you with more flexibility, JReport allows you
to choose the resource types that you want to monitor by yourself. Note that JReport will only
monitor the referencing relationships among the resource types that you have selected. The
resource types that have not been selected will not be monitored, even if they may have
referencing relationships to the selected resource types. Therefore, if you are not sure that the
resource types you have selected hold all the possible reference relationships within themselves, it
is recommended that you select as many resource types as possible to avoid incomplete
information.
For example, in the Reference Table Configuration dialog, selecting only the formula resource type
means that for a formula, only the formulas referencing this formula will be recorded in the
reference table, although other resources, such as queries, summaries, and reports which are also
using this formula will not be shown in the reference table. If you rename this formula, you will
only be prompted to update the change in the formulas using it, ignoring any other resources also
using it.
4. Click OK. The referencing relationships among the objects of the checked resource types will then
be monitored.
After you have configured a reference table, you can view the referencing relationships for a specific
resource object. To do this:
1. In the Catalog Browser, browse to the resource object with the reference relationships that you
want to view.
2. Right-click the resource object, and then click Reference Entities on the shortcut menu.
3. The Reference Entities dialog will then appear, listing all the catalog entities that are using the
selected resource object.
Note: In the Reference Entities dialog, you can right-click any of the query, formula, parameter or
summary entity which uses the specified resource object to edit it, and right-click any report entity to
open the report.
You can also export the reference table information to a text file. To do this:
1. On the Catalog Browser toolbar, click the Export Reference button
2. In the Save Reference dialog, specify the location where you want to save the file.
3. Click Save to save the file.
Maintaining catalogs
JReport Designer provides a tool - JReport Catalog Doctor for you to maintain catalogs and diagnose
problems with catalogs. After reading through this chapter, you will understand how to use the Catalog
Doctor to diagnose the specific components of catalogs: connections, tables and fields, formulas and
summaries, and queries.
The following topics describe how to use the Catalog Doctor:
Checks whether the raw column of a DBField exists in the database. If it exists, then it checks to see
whether the stored information such as SQL Date type matches the raw column in the database.
Checks to see whether the formulas and summaries have correct syntax. It checks whether the
remapped parameters and DBFields need to be remapped again.
Queries
Checks whether the mapped tables/views referenced by the query exist in the catalog.
Whether the DBFields of the table/view match those saved in the query.
Whether or not the formulas and parameters can be found in the catalog.
Loading a catalog
To load a catalog into the Catalog Doctor for diagnosing, take the following steps:
1. Click File > Open to bring up the Open Catalog File dialog.
2. Select a catalog file, and click Open.
Saving a catalog
To save the open catalog to the current file, click File > Save.
To save the open catalog to another file, click File > Save As.
Merging catalogs
With the Catalog Doctor, you can also merge the resources from two catalogs into one. However,
before merging, you need to first specify at which level the differences between these two catalogs will
be checked by the Catalog Doctor.
To specify the checking level:
1. Click File > Options.
2. In the Merge Catalog box of the Options dialog, specify the checking level.
Does not show the differences between the two catalogs. Any conflicts will remain in the target
catalog.
3. Click OK to accept the setting.
With the checking level specified, you can then start to merge catalogs.
To merge catalogs:
1. Open the target catalog in the Catalog Doctor by clicking File > Open.
2. Click File > Import, and then select the catalog that is to be imported.
3. In the Import From Catalog dialog, select the resources from the catalog, and click OK.
4. The selected resources may conflict with those in the target catalog. The conflicting resources will
be marked with red question marks.
5. Click the Rename button to rename, or the Replace button to replace. You can also click the
Skip button to skip.
6. Click the Differences button to see the property values of the objects in the target catalog and
the sources catalogs. Different property values will be highlighted.
7. Click the Target Relation button to see the relationship between the object and its parent node.
8. Repeat the steps above to manage conflicting resources, and then click the Merge button to
merge the two catalogs. If the connections in the two catalogs connect to different data sources,
you will be asked to modify the existing data source in the target catalog. For safety purposes, it
is better to create a new data source.
9. Click File > Save to save the changes and exit the Catalog Doctor.
10. Launch JReport Designer, and open the merged catalog. The resources you just imported are now
available and new data sources have been created.
Connection
The Catalog Doctor can be used to diagnose connections in the following aspects:
Finding all the mapping tables, views and DBFields in the catalog
In the resource tree, expand the Relational node, then go to the Tables or Views node and reveal it.
All the mapping tables, views and DBFields in the catalog will then be listed. The icon in front of each
object has a specific meaning, which indicates whether the object is valid or not.
The following are descriptions of the icons in front of each object:
: Table
: Table which does not exist in the database
: Table which has invalid fields
: View
: View which does not exist in the database
: View which has invalid fields
: Field
: Field which does not exist
: Field with a name which can be found in the database, but has a type mismatch.
Select an object from the resources tree, right-click and on the shortcut menu click Delete.
To delete a set of mapping tables, views or DBFields, select the objects you want to delete, and click
on the toolbar (or press Delete on your keyboard).
on the toolbar.
Note: The tree is sorted by the validation status of each object (invalid objects are listed
ahead). So, after you have updated a mapping table/view, the order of the objects will probably
change. If the table was invalid and becomes valid after updating, it will be listed after the
invalid objects.
Adding tables/views
or the Add View button
on the toolbar, or on the resource tree
Click the Add Table button
select a table, right-click and select Add Tables from the shortcut menu. In the Add Table/View
dialog, select the tables/views you would like to add, and click Add. To finish adding, click Done.
Adding a DBField
Select a table or a column from the resource tree, right-click and on the shortcut menu click Insert
Column to bring out the Add Column dialog. Then select the column you want and click Add. When
you have finished adding columns, click Done to close the dialog.
Editing a formula/summaries
Select the formula/summary to be edited, and click the Edit button in the Error panel.
Removing formulas/summaries
Select the formulas/summaries that are to be removed, then, do one of the following:
on the toolbar.
Queries
The Catalog Doctor can be used to diagnose queries in the following aspects:
Select an object from the resources tree, right-click and on the shortcut menu click Delete.
JDBC connections: Connects to a relational database via a JDBC driver or JDBC-ODBC bridge.
XML connections: Connects to and transforms an XML hierarchy model to a relational model.
User defined data sources: Through the UDS API, JReport Designer can access data from an external
data source, such as a text file or Lotus Notes, which is not stored in a database or when there is no
JDBC driver available.
Hierarchical data sources: JReport Designer directly supports XML format data source by wrapping
the provided HDS API. JReport Designer's built-in classes can implement the XML format hierarchical
data source interface. You can directly import an XML data source to a catalog using the Catalog
Browser.
Web service data sources: JReport Designer supports web service defined by WSDL 2.0 as data
source. You can directly add a web service data source to a catalog by importing a WSDL file.
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of different data source connections. Open the following report set to see the
connection examples: <install_root>\Demo\Reports\SampleComponents\DataSourceConnections.
cls.
JDBC connections
JDBC is a Java API for executing SQL statements. It consists of a set of classes and interfaces written
in the Java programming language which enables SQL statements to be executed against virtually any
relational database.
The JDBC-ODBC bridge allows ODBC drivers to be used as JDBC drivers. This bridge is a JDBC driver
which implements JDBC operations by translating them into ODBC operations. To ODBC it appears as a
normal application program.
Notes:
In JReport Designer, not all the data types supported by JDBC can be used. The data types that
supported in JReport Designer are: Bit, Tinyint, Smallint, Integer, Bigint, Float, Real, Double,
Number, Decimal, Char, VarChar, LongVarChar, Date, Time, TimeStamp, Binary, LongVarBinary,
Blob, Clob, Array, nVarChar, and Distinct.
For the Blob, Clob, and Array types, you cannot browse their data in the Catalog Browser. And for
the Distinct type, due to a limitation of JDK, the based SQL Type cannot be obtained. So you need to
indicate it manually after you import these types of data.
If you are using a database which supports the JDBC method Statement.setFetchSize(), you can
request the database retrieve a specified number of rows in each read instead of all rows which
minimizes memory usage which can improve performance. It can also avoid Java heap out of memory
errors when doing large queries. JReport provides a property setFetchSize in the JdbcDriversConfig.
properties file for you to do this, which is located in the <install_root>\bin directory.
The following is an example of setting the setFetchSize property in the JdbcDriversConfig.properties file
and detailed description of each property:
DriverName_D1 = MySQL-AB JDBC Driver
Vendor_D1 = MySql.com
Version_D1 = 3.0.8-stable ($Date: 2003/05/19 00:57:19 $, $Revision: 1.27.2.18 $)
setFetchSize_D1 = 5000
DriverName_[Name]
Database driver name that should be used to establish a connection. You can use connection.
getMetaData().getDriverName() to obtain the value.
Vendor_[Name]
The vendor of current JDBC driver. It is a string value.
Version_[Name]
The version of current JDBC driver. You can use connection.getMetaData().getDriverVersion() to
obtain the value.
setFetchSize_[Name]
The number of rows retrieved in each buffer from the database. It is an Integer value that should be
larger than 0 and less than or equal to getMaxRows(). The default value is different according to the
driver in use. You can refer to your own database driver specification.
_[Name]
It is a user-defined name used to mark a group of driver settings different from the other groups.
Specifying where to implement the maximum query run time and number of records
In the JdbcDriversConfig.properties file, you can also specify where the properties, Maximum Rows and
Maximum Duration, will be implemented, on JReport side or on the database side. For details about
usage of these two properties, see Limiting the query run time and number of records.
The following is an example of setting the two properties:
DriverName_D2 = Oracle JDBC driver
Vendor_D2 = Oracle
Version_D2 = 9.2.0.3.0
supportMaxRowPushDown_D2 = true
supportMaxDurPushDown_D2 = true
DriverName_[Name]
Database driver name that should be used to establish a connection. You can use connection.
getMetaData().getDriverName() to obtain the value.
Vendor_[Name]
Version_[Name]
The version of current JDBC driver. You can use connection.getMetaData().getDriverVersion() to
obtain the value.
SupportMaxRowPushDown_[Name]
Specifies where the property Maximum Rows will be implemented, on JReport side or on the
database side. By default, it is set to true, which means the property will take effect on the database
side. If it is set to false, the property will take effect on JReport side.
SupportMaxDurPushDown_[Name]
Specifies where the property Maximum Duration will be implemented, on JReport side or on the
database side. By default, it is set to true, which means the property will take effect on the database
side. If it is set to false, the property will take effect on JReport side.
_[Name]
It is a user-defined name used to mark a group of driver settings different from the other groups.
Notes:
If there are more than one group with the same group marking name, the last group will be adopted.
If the sign # is seen before "DriverName" of a group, or if setFetchSize is given a negative value, the
whole group will be disabled.
3. Click OK to set up the connection, and you will be prompted with a message box showing the
status of connecting to the JDBC driver.
You have four ways to set up a JDBC connection:
Notes:
Upon the finishing of setting up the connection, the Add Table dialog will be displayed, prompting
you to add tables from the database to the connection. If you want to add tables at a later date, click
Done.
When creating any of the above connections, if your database has some special requirements, you
can click the Options button to modify the options according to your requirements.
The following examples show how to set up connections via specific JDBC drivers:
You have already installed the Oracle JDBC driver, and have appended the archive file (ojdbc14.jar)
of the thin driver to the ADDCLASSPATH variable in the file setenv.bat in <designer_install_root>
\bin.
The Oracle database server is with the name p02_wuhb, port number 1521, database orcl, user
name scott and password tiger.
A catalog has been created with a default data source.
Take the following steps to set up a connection which connects JReport Designer to a database via the
Oracle JDBC driver:
1. Start JReport Designer and open the catalog.
2. In the Data tab of the Catalog Browser, expand the node of the default data source, right-click the
Relational node and select Add JDBC Connection from the shortcut menu.
3. In the Get JDBC Connection Information dialog, uncheck the Use ODBC Data Source option.
4. Check the Driver checkbox, and enter the JDBC driver class name oracle.jdbc.driver.
OracleDriver in the Driver text field.
5. In the URL text field, specify the URL in the format jdbc:oracle:thin:@<hostname>:<port>:
<SID>. In this example, enter jdbc:oracle:thin:@p02_wuhb:1521:orcl.
6. Input the user name scott and password tiger respectively.
7. Click OK to set up the connection.
You have already installed the Sybase JDBC driver and have appended the archive file of the driver
to the ADDCLASSPATH variable in the file setenv.bat in <designer_install_root>\bin.
The Sybase database server is with the name SybSever, port number 5000, database pubs2, user
name sa and password 123456.
A catalog has been created with a default data source.
Take the following steps to set up a connection which connects JReport Designer to a database via the
Sybase JDBC driver:
1. Start JReport Designer and open the catalog.
2. In the Data tab of the Catalog Browser, expand the node of the default data source, right-click the
Relational node and select Add JDBC Connection from the shortcut menu.
3. In the Get JDBC Connection Information dialog, uncheck the Use ODBC Data Source checkbox.
4. Check the Driver checkbox, and enter the JDBC driver class name com.sybase.jdbc.SybDriver
into the Driver text field.
5. In the URL text field, specify the URL in the format jdbc:sybase:Tds:<hostname>:<port>/<SID>.
In this example, enter jdbc:sybase:Tds:SybServer:5000/pubs2.
6. Input the user name sa and password 123456 respectively.
7. Click OK to set up the connection.
set ADDCLASSPATH=%JAVAHOME%\lib\tools.jar;C:\bea\wlserver6.1\lib\weblogic.jar;
7. Set up the connection.
a. Start JReport Designer and open the catalog.
b. In the Data tab of the Catalog Browser, expand the node of the default data source, rightclick the Relational node and select Add JDBC Connection from the shortcut menu.
c. In the Get JDBC Connection Information dialog, uncheck Use ODBC Data Source, and check
Use Connection Pool. The string weblogic.jinfonet.pool.Driver will automatically be
displayed in the Driver text field.
d. Fill in the URL jdbc:weblogic:jinfonet:@<hostname>:7001:jinfonetDS, where
@<hostname> is the host name or IP address of the WebLogic Server, 7001 is the port on
which the WebLogic Server listens, and jinfonetDS is the JNDI Name of the data source.
Then, click OK.
Note: The data types longbarbinary and BigDecimal are not supported when a WebLogic Connection
Pool is used.
Model Wizard
Open/Save model file
Define a Java class as a table
Define a method as a column
How to access the instance of the class
OOJDBC Driver
Read the table/column definitions from model file
Return meta-data to JReport
Construct QUERY data
Return record to JReport
The following sections explain how to import different kinds of data sources via OOJDBC into a JReport
catalog:
Where,
Options
Description
Column Name
SQL Type
Returned type of your column name. You can double-click the field and choose the
SQL type you want.
Precision
Precision of the current column. You can click on the field and change it manually.
Scale
Scale of the current column. You can also click on the field and change it manually.
Nullable
Current status of the column (null or not). You can double-click on the field and
choose the current status: Nullable, No Nulls or Nullable Unknown etc.
Currency
Add
Remove
Modify Column
OK
Click to select the path for the table. OOJDBC driver can save and restore the table
you have defined through this path.
4. Click the Remove button to get rid of all the existing columns in the Add Table dialog, and then click the
Add button to add a new column.
5. In the Access Indirect Columns dialog, specify the data type of the column.
In this example, we will add a column of String type, so click java.lang.String in the ReturnType column of
the Methods box, then click the Add button. Click OK to return to the Add Table dialog.
Note: If you want to use dynamic parameter, you can choose the option Is Dynamic in the Access
Indirect Columns dialog. For details, see Example 3: XML file with dynamic parameters.
6. In the Add Table dialog, click Direct Access Path to define the accessing path of the table in the Access
Method dialog.
a. Fill in com.jinfonet.jdbc.xml.XMLReader in the Root Class Name text field, click the Parse button
and check Show Static Methods Only.
b. Click the shown method. In the Parameters box, fill in the default values for param0 and param1 as
required. For example, for param0, fill in file:///C:/JReport/Designer/Demo/Reports/
TutorialReports/employee.xml, then for param1, fill in record employee root employee column
first_name 12 path document.employee.first_name.
Since first_name is required, you should then give the actual tag name here. The number afterwards
is the SQL type of the column. "12" is for String type. For detailed information about Java SQL types,
refer to JDK package java.sql.types.java.
Notes:
In param1, the order of the columns is dependent on the default values given when adding the
column.
The SQL type BINARY, VARBINARY and LONGVARBINARY are not supported.
Now you can see that the column has been added in the Add Table dialog. You can rename the default column
me by editing in the Column Name column. You are recommended to give the name as the actual tag definition in
e .xml file, for example first_name.
Click the OK button, and the table employee will now have been added to the Object Source Wizard.
In the Object Source Wizard, click File > Save. You will then be prompted to save the ODF file. You should
ve it to <install_root>\lib or the directory where the catalog will be. Here we save it as employee.odf.
Notes:
If you use dynamic parameters, that is you check the Is Dynamic option, the syntax of the method is an array
of Boolean values which indicates which parameter is dynamic at runtime. If the parameter is dynamic the value
should be prompted and initialized before executing an SQL. In addition, when you choose the option Is
Dynamic, this parameter will be passed to JReport Designer. After you create a connection in the Catalog
Browser, you will find it in the Parameters node.
The same ODF file cannot exist in both <install_root>\lib and the directory where the catalog is located.
If you have purchased the readable key, you can also save the ODF file (oojdbc data definition file) to XML
format (with extension .odf.xml). For files which have already been saved with an .xml extension, in order to
make them available, you can manually change the extension from .xml to .odf.xml.
3. In the Input New Catalog Name dialog, specify the catalog name, the data source name and the path. The
catalog should be located in the directory where you saved the ODF file. For example, if you saved the ODF
file in C:\odf, the new catalog should be created also in C:\odf.
4. In the Catalog Browser, create a new connection with the Get JDBC Connection Information dialog as follows:
a. Uncheck Use ODBC Data Source.
b. Check the Driver checkbox, then enter com.jinfonet.jdbc.obj.ObjectDriver in the text field that
follows.
c. Type jdbc:jinfonet:object:@Filename in the URL text field. @Filename should be the ODF file name.
In the example, it is jdbc:jinfonet:object:@employee.
d. Click OK to set up the connection.
5. In the Add Table dialog, select the table employee and click Add.
6. Click Done to close the Add Table dialog.
Now, the table employee will have been added into the catalog. You can use it to develop reports as required.
Note: When you publish the catalog and its report sets to JReport Server, whether the ODF file is located in
<install_root>\lib or in the directory where the catalog is located, it will be deployed to the path where the
catalog is located in the server side.
5. Click OK and the table OrgChart will now have been added to the Object Source Wizard.
6. In the Object Source Wizard, click File > Save. You will then be prompted to save the ODF file. You should save it to
<install_root>\lib or to the directory where the catalog will be located. Here, we save it as orgchart.odf.
Note: The same ODF file cannot exist in both <install_root>\lib and the directory where the catalog will be located.
Examples of format
When using certain SQL types, you should input a standard format in the Format cell in the Import XML dialog. There are some examples:
If the time format is like Tue Aug 27 16:04:00 BST 2002, you should select:
Type: TimeStamp
Format: EEE MMM dd hh:mxm:ss zzz yyyy
If the time format is like 2002-11-22 11:09:08, you should select:
Type: TimeStamp
Format: yyyy-MM-dd hh:mm:ss
If the time format is like 11/18/2002 08:20:00, you should select
Type: TimeStamp
Format: M/d/yyyy hh:mm:ss
If the time format is like 1999-12-05, you should select:
Type: date
Format: yyyy-MM-dd
If the time format is like 08:20:00, you should select:
Type: time
Format: hh:mm:ss
If the number is like 50,600, you should select:
Type: integer
Format: ###,###
If the currency is like $50,600, you should select:
Type: integer
Format: $###,###
If you choose the option Is Dynamic, this parameter will be passed to JReport Designer. After you create a new
connection, you will find this parameter in the node Parameters in the Catalog Browser.
The same ODF file cannot exist in both <install_root>\lib and the directory where the catalog is to be
located.
5. Create a new connection in the Get JDBC Connection Information dialog as follows:
6. The Add Table dialog appears prompting you to add the listed tables. Select the table employee1 and click
the Add button. The Dynamic Parameter used in oojdbc tables dialog will then be displayed. Uncheck the
checkbox in the New column and select the parameter path from the drop-down list to bind param0 to the
parameter path.
7. Repeat the above step to add the employee2 table and bind its parameter param0 to the parameter path.
Now the parameters in the two tables will share the same parameter path.
8. Click the New Report Set button
tables.
9. When viewing the report, the Enter Parameter Values dialog will be displayed, asking you to input the
parameter. You will only need to input the path of imported XML file once since the parameter is shared with
the parameters in the two tables.
Preparations
Before the OOJDBC data source works with Java objects, you should do the preparations, which are
detailed in the following two steps:
1. You should define a class that specifies the column name and the method of getting data from this
column. In this example, the class Products.java in demo.zip takes this role. This class file
contains the method public int getProductID(), which implies that the column name is ProductID
and you can get the product ID via this method.
2. You should publish a method to access a group of products. That means OOJDBC needs a result
set with multiple rows, and each row is one of the products, so that you should define a class that
can retrieve the rows. In this example, the file SQLReader.java in demo.zip takes this role. In this
file, there is a static* method JCollection execSQL(String jdbcDriver, String url, String sql), and
this method returns a collection that contains the rows of the products. This collection can be one
of the following three classes java.util.collection for Java2, java.util.Vector for Java1.1 and com.
jinfonet.jdbc.obj.JCollection for both.
Also, the batch files used to start the Model Wizard, JReport Designer and JReport Server should be
modified before you can import the product table and use it to generate reports. To do this:
1. Save demo.zip in <install_root>\help.
2. Add it to the class path of the batch file setenv.bat in <install_root>\bin of both Designer and
Server. The setenv.bat updates the classpath for both ModelWizard and Designer.
jdbc.demo.FilterSQLReader in the Root Class Name field of the Access Method dialog.
Installation
You are required to install the following before you can import EJB using the Model Wizard:
1. Install Java EE. You can download it from http://java.sun.com/javaee/downloads/index.jsp. After
the installation of Java EE, you will find j2ee.jar in <java_ee_install_root>\lib.
2. Install Jaxp1.1. You can download it from http://java.sun.com/xml/download.html. After
installation, you will find three jars xalan.jar, crimson.jar and jaxp.jar in <jaxp1.1_insatll_root>.
3. Install JReport Designer. You will then find the batch file ModelWizard.bat and JReport.bat in
<designer_install_root>\bin, which are for starting JReport Designer and the Model Wizard.
Add the four jars into the class paths of the two batch files or to the ADDCLASSPATH variable in
setenv.bat which is used by both. For example:
...c:\jdk1.6.0_17\bin\java -classpath g:\java\classes;c:\jaxp1.1\xalan.jar;c:
\jaxp1.1\crimson.jar;c:\jaxp1.1\jaxp.jar; com.jinfonet.jdbc.model.wizard.
ModelWizard...
Note: After you have deployed your EJB to the Java EE server, a Jar will be returned in the root
directory. In this example, Java(TM) Pet Store Demo of jps1.0 in Java EE has been used. Note that
versions later than jps1.0 are not supported. After deploying to the Java EE server, estoreClient.jar is
returned to the root directory. Add it to the batch file ModelWizard.bat. For example:
...-classpath "c:\jps1.0\estoreClient.jar;c:\jaxp1.1\xalan.jar;c:\jaxp1.1\crimson.jar;c:
\jaxp1.1\jaxp.jar;..."
first.
4. If you want to use a dynamic parameter, check the option Is Dynamic. The syntax of the method
is: an array of Boolean values to indicate which parameter is dynamic in runtime. If the parameter
is dynamic the value should be prompted and initialized before the SQL is executed.
5. Click Next. In the next dialog, choose create as the method name.
6. Click Next, and now you can see the return type of the method name getCategories defined
previously.
7. Click OK and the table Category will now have been added.
In the Object Source Wizard, select File > Save. You will then be prompted to save the ODF file.
u should save it to <designer_install_root>\lib or the directory where the catalog will be. Here we
ve it as ejb.odf.
Notes:
If specifying to apply dynamic parameters, that is, you check the option Is Dynamic, the parameter
will be passed to JReport Designer. After you create a connection in the Catalog Browser, you will
find the parameter in the Parameters node.
The same ODF file cannot exist in both <designer_install_root>\lib and the directory where the
catalog is located.
4. In the Catalog Browser, create a new connection with the Get JDBC Connection Information dialog
as follows:
a. Uncheck Use ODBC Data Source.
b. Check the Driver checkbox, then enter com.jinfonet.jdbc.obj.ObjectDriver in the text
field that follows.
c. Type jdbc:jinfonet:object:@Filename in the URL text field. @Filename should be the .odf
name you have saved. So in the example, it should be jdbc:jinfonet:object:@ejb.
d. Click OK.
5. In the Add Tables dialog, select the two tables in the Tables box, and click the Add button.
Now, the tables will have been added into the catalog. You can use it to develop reports as required.
Installation
You are required to install the following before you can begin this example:
Install Jaxp1.1. You can download it from http://java.sun.com/xml/download.html. After installation, there
will be three jars xalan.jar, crimson.jar and jaxp.jar in the installroot of Jaxp1.1. Add these three jars into
the class path of the batch files that start both JReport Designer and Model Wizard.
Add some system property values into the batch files. In this example, we set -Djava.naming.factory.
initial="weblogic.jndi.WLInitialContextFactory" -Djava.naming.provider.url="t3://
localhost:7001" to connect to BEA WebLogic Server.
After performing these steps, the batch file that starts the Model Wizard should look something like this:
C:\jdk1.6.0_17\jre\bin\java.exe" "-Dinstall.root=C:\jreport\designer"
-classpath "C:\jreport\designer\lib\report.jar;C:\jreport\designer\lib\resource.jar;
C:\jreport\designer\lib\JREngine.jar;C:\jreport\designer\lib\mail.jar;
C:\jreport\designer\lib\activation.jar;C:\jreport\designer\lib\unicode.zip;
C:\TEMP";"C:\jreport\designer";D:\Weblogic510\lib\weblogicaux.jar;D:\Weblogic510\classes;
w:\sf\lib\xalan.jar;w:\sf\lib\crimson.jar;w:\sf\lib\jaxp.jar;
D:\weblogic510\myserver\ejb_basic_beanManaged.jar
-Dreporthome="C:\jreport\designer"
-Djava.naming.factory.initial= "weblogic.jndi.WLInitialContextFactory"
-Djava.naming.provider.url="t3://localhost:7001"
com.jinfonet.jdbc.model.wizard. ModelWizard %1 %2 %3 %4 %5 %6 %7 %8 %9
Parse button. For DefaultValue, enter JNDI name beanManaged.AccountHome, and select
CastTo as examples.ejb.basic.beanManaged.AccountHome.
Note: After you fill in DefaultValue, you should press Enter in your keyboard, or an error will
occur. Also, before you set CastTo, you should start the BEA WebLogic server. Choose
first, followed with the down arrow. These actions will connect to the server.
4. Check the option Is Dynamic if you want to use dynamic parameters. The syntax of the method is: an
array of Boolean values to indicate which parameter is dynamic at runtime. If the parameter is dynamic,
the value should be prompted and initialized before the SQL is executed.
5. Click Next, and then select the method findAllAccounts as the method name.
6. Click OK, and the table Account will now have been added.
In the Object Source Wizard, select File > Save. You will then be prompted to save the ODF file. You
ould save it to <designer_install_root>\lib or the directory where the catalog will be. Here we save it as
blogic.odf.
Notes:
If you use dynamic parameters, that is, you check the option Is Dynamic , the parameter will be passed to
JReport Designer. After you create a connection in the Catalog Browser, you will find the parameter in the
Parameters node.
The same ODF file cannot exist in both <designer_install_root>\lib and the directory where the
catalog is located.
To import the ODF file into a JReport catalog, take the following steps:
1. Start JReport Designer with the modified batch file.
2. Click File > Catalog Management > New Catalog.
3. In the Input New Catalog Name dialog, specify the catalog name, the data source name and the path.
The catalog should be located in the directory where you saved the ODF file. For example, if you saved
the ODF file in C:\odf, the new catalog should be created also in C:\odf.
4. In the Catalog Browser, create a new connection with the Get JDBC Connection Information dialog as
follows:
a. Uncheck Use ODBC Data Source.
b. Check the Driver checkbox, then enter com.jinfonet.jdbc.obj.ObjectDriver in the text field that
follows.
c. Enter jdbc:jinfonet:object:@File name in the URL text field. @File name should be the .odf name
you saved. In the example, it is jdbc:jinfonet:object:@weblogic.
Now, the table will have been added into the catalog. You can use it to develop reports as required.
Installation
You are required to install the following before you can start developing reports using EJB 2.0:
2. Start the Model Wizard using the modified batch file. The Object Source Wizard will then appear.
3. Click the Add Table button and define a table named Account, and then click the Parse button. The
Add Table dialog will then appear. In this method, only the balance value is stored while creating
EJB objects in Client.java, so you can remove the columns deposit, withdraw, and isIdentical,
leaving only the columns balance and PrimaryKeyString.
4. Click Direct Access Path in the Add Table dialog to define the accessing path of the table in the
Access Method dialog.
a. In the Root Class Name field, enter com.jinfonet.jdbc.ejb.EJBInitializer, and then click the
Parse button. In DefaultValue, enter JNDI name ejb20-beanManaged-AccountHome, check
CastTo and select examples.ejb20.basic.beanManaged.AccountHome.
Note: After you fill in DefaultValue, you should click Enter on your keyboard, or the error
will occur. Also, before you set CastTo, you should start the BEA WebLogic Server. You
should also choose
5. Check the option IsDynamic if you want to use dynamic parameters. The syntax of the method is:
An array of Boolean values to indicate which parameter is dynamic in runtime. If the parameter is
dynamic, the value should be prompted and initialized before executing SQL.
6. Click Next. Then select the function findAllAccounts as the method name.
7. Click OK and the table Account will now have been added.
In the Object Source Wizard, click File > Save. You will then be prompted to save the ODF file. You
ould save it to <designer_install_root>\lib or the directory where the catalog will be. Here we save it
weblogic.odf.
Notes:
If you use dynamic parameters, that is, you check the option Is Dynamic, the parameter will be
passed to JReport Designer. After you create a connection in the Catalog Browser, you will find the
parameter in the Parameters node.
The same ODF file cannot exist in both <designer_install_root>\lib and the directory where the
catalog is located.
b. Check the Driver checkbox, then enter com.jinfonet.jdbc.obj.ObjectDriver in the text field
that follows.
c. Enter jdbc:jinfonet:object:@File name in the URL text field. @File name should be the .odf
name you saved. In the example, it is jdbc:jinfonet:object:@weblogic61.
d. Click OK. The Add Table dialog appears. Select a table to be added, then click Done.
Now, the table will have been added into the catalog. You can use it to develop reports as required.
5. In the Add Table dialog, select the table Employee and click Add.
6. Click Done to close the Add Table dialog.
Now, the table Employee will be added into the catalog. You can use it to develop reports as required.
Note: When you publish the catalog and its reports to JReport Server, whether the ODF file is located
in <install_root>\lib or in the directory where the catalog is located, it will be published to the path
where the catalog is located on the server side.
Tables/Views
Stored procedures
Tables/Views
Tables and views are mapped objects of the tables and views in the raw database that a connection
refers to. Mapped objects have mapped names that can be different from their names in the raw
database. A catalog stores information about the real tables/views mapped, such as the name,
qualifier, and owner.
Since tables/views are only mapped objects, they can be mapped and then re-mapped. That is, the
information of the real tables/views stored in a catalog is changeable. This is useful when you are offline from your database. You will still be able to see the table structure and generate reports. In
addition, when changing the connection, for example, from an Access database to an Interbase, you
will only need to re-map all the tables/views in the catalog as opposed to creating a new catalog.
Right-click the JDBC connection and select Add Tables from the shortcut menu.
Right-click the Tables node of the JDBC connection and select Add Table from the shortcut
menu.
Right-click any folder in the Tables node of the JDBC connection if you have already created
some and select Add Table from the shortcut menu.
Right-click an existing table in the JDBC connection if there is and select New Table from the
shortcut menu.
2. From the Database Catalogs drop-down list, select the required catalog, then specify a schema in
the selected catalog from the Schemas box.
3. Click the Load Tables button. The tables contained in the selected schema will then be displayed
in the Tables box.
4. Check the Include System Tables option if you want to have the system tables available in the
Tables box.
5. Check Include Added Table to make the tables that have been added to the connection available
in the Tables box.
6. Choose the required tables in the Tables box, and then click Add.
To choose consecutive tables, click the first table, press and hold down Shift, and then click the
last table. To choose tables that are not consecutive, press and hold down Ctrl, and then click
each table.
7. Repeat steps 2 to 4 to add tables from other catalogs and schemas.
8. To add certain tables by name or by patterns in their name, select the Table Name Pattern
checkbox. The wildcard % will then be displayed in the text box.
For example, if you want to add tables beginning with AL, you can type AL% (case sensitive) in
the text box, and click the Load Tables button. All the tables beginning with AL in the selected
schema will then be displayed in the Tables box. Choose the tables that are required by clicking
When you have added some tables to a catalog, you can then set up pre-joins between them. For
detailed information, see the chapter Pre-joins.
If you have selected schemas in the Schema tab of the Get JDBC Connection Information dialog
when setting up the connection, when you add tables, by default only the selected schemas will be
listed in the Schemas box of the Add Table dialog, however, you can check the Show All Schemas
option to show all the schemas. It is the same case when adding views.
When adding tables, if the Include Added Table option is checked in the Add Table dialog, when you
click the Add button to add a table that has already been added to the connection once, the Input
Table Name dialog will be displayed, prompting you to give the new table a different name. It is the
same case when adding views.
Refreshing tables/views
The tables/views in your catalog are a temporary deposit to improve the performance when you design
and test your report. Your database keeps changing over the time. However, these will not be reflected
automatically in your catalog. To synchronize your tables/views in the connection and database, you
can choose to refresh the table/view information using the Refresh command on the shortcut menu of
the table/view. Then when the refreshing job is done, a reporting dialog will be shown, summarizing
the changes and operations that have been taken.
Organizing tables/views
You can organize the tables/views, which have been added to a catalog via a JDBC connection, by
arranging them in different folders in the Catalog Browser.
To add a folder:
1. Right-click the Tables/Views node, or any existing folder and select Add Folder from the
shortcut menu.
2. A new folder is added to the Tables/Views node, or in the selected folder. Type a name for the
folder in the editing area, and then click outside to confirm the change.
To move tables/views to a folder:
1. Right-click the table/view you want to move in the Tables/Views node and select Move To from
the shortcut menu.
2. In the Move Table/View dialog, select the folder to which the table/view will be moved, then click
OK.
the table after you delete them or the database has been updated.
To remove a column from a table/view:
1. Select the column you want to remove.
2. Right-click the column and select Delete from the shortcut menu.
To add columns to a table/view:
1. Right-click the table/view to which you want to insert columns, then select Insert Column from
the shortcut menu.
2. In the Add Column dialog, select the required columns from the Columns box.
There will be no available column in the Columns box if you do not delete any in the table/view
before, or no update has been made to the database. That is to say, you cannot add columns that
do not belong to the table/view.
3. Click the Done button to add the columns to the table/view.
Tip: If you want to add all the columns in a table/view at a time, you can also choose to refresh the
table/view, which synchronizes the table/view in catalog with the one in your database.
Stored procedures
A stored procedure is a compiled program, consisting of one or more statements and is saved into a
database. The statement in a stored procedure can be an SQL statement or a control flow statement,
such as an If-else statement or a Loop statement. A stored procedure is stored in the DBMS, so that it
can be called locally or remotely. In addition, a stored procedure can return a value, single result set or
multiple result sets. Currently, JReport supports stored procedures that return a single result set. If a
stored procedure returns more than one result set, the first one will be used by JReport.
As a program, a stored procedure can take parameters. There are three types of parameters: IN, OUT
and INOUT. The IN parameter lets you pass values to the procedure. The OUT parameter returns
values to the caller. The INOUT parameter enables you to pass initial values to the procedure, and then
returns the updated value to the caller.
In addition, JReport Designer provides you with the Data Manager which allows you to control the data
retrieval of your stored procedures that function as queries, including the number of rows to be
displayed and the duration required for the retrieval. It can also keep access information from previous
runs of a stored procedure (for details, see Data Manager).
2. The dialog lists all the stored procedures in the Stored Procedures box in a three-level tree. The
top level is SQL-catalog, the second is SQL-schema and the last level is stored procedures. Select
the required stored procedures, and then click Add.
3. If any of the selected procedure contains parameters, the Stored Procedure Parameters dialog will
appear for you to input the required values. These values will be saved inside the stored
procedure object, and will be used as the default value when executing this procedure. You can
edit the stored procedure parameters at any time. For details, see Editing parameter values.
4. When finished, click the Done button to close the dialog.
When a stored procedure has been added into a catalog, JReport will in turn do the following:
Prompt you to provide the values of IN and INOUT parameters if the stored procedure has them.
Execute the stored procedure once in order to get the result set.
Create the field objects of the procedure object according to the result set returned.
You will then be able to use the field objects to design your reports.
Notes:
Not all database management systems (DBMS) support database stored procedures. In such a case,
you may see nothing in the Procedures box.
When adding a stored procedure, you may get the following error:
[DBS-B]Could not find stored procedure 'test1;1'.
This is because test;1 becomes quoted when JReport Designer finds the semicolon in it. To remove
the quotation marks, you will have to modify your connection information. To do this:
1. Right-click your connection and select Edit Connection from the shortcut menu to bring out the
Get JDBC Connection Information dialog.
2. Select the Qualified tab, then in the Quote Qualifier box, check the User Defined radio button
and remove all the characters from the Extra Characters and Quote Character text boxes.
3. Click OK to confirm the settings.
Due to the unique nature of Oracle stored procedures, you are unable to add them directly into a
JReport Designer connection. Thus, the usage of JReport Designer is limited when you use an Oracle
database. As an alternative, JReport has developed the user data source API which can use a stored
procedure in Oracle. For details, see Oracle stored procedure UDS.
2. This dialog lists all the IN and INOUT parameters in the stored procedures. Double-click the Value
cell to edit the value of each parameter.
3. Double-click the bindParameterName cell to bind the IN and INOUT parameters in the stored
procedure to an existing catalog parameter with the same type. You can input the parameter
name as @parametername. By default, the bound parameter will be the one with the same name
of the IN and INOUT parameter which is automatically created when adding the stored procedure.
4. Click OK to apply the changes to the parameters.
2. In the New Report set dialog, specify the title and layout of the first report in the report set as
required, then click OK.
3. In the Data screen of the report wizard, choose the stored procedure with which you want to build
the report, then follow the report wizard to create the report.
Note: When running a report which is built on a stored procedure, you will need to specify the values
for the IN and INOUT parameters defined in the stored procedure. The values stored inside the stored
procedure object in the catalog will be the default values. For details about specifying the values, see
Editing parameter values in this document.
The SQL files can work like queries in JReport, but there are two basic differences:
A query is based on the tables/views added from a raw database, which means, if you have only set
up a connection, but have not added any tables or views into the catalog, you will not be able to
build a query. However, after you have set up a connection, even if you have not added any tables or
views, you can still import an SQL file into a catalog, and then build reports on it.
Queries built using the interactive query designer will work with other tables/views when you create
or modify a working set. That is, if you design a report using interactively created queries, you can
add additional objects from tables/views into the working set afterwards. However, when you design
a report using an SQL file, you will only be able to use the contents already included in the SQL file.
Due to this, you should make sure that you have included all the required fields in your SQL file.
In addition, JReport Designer provides you with the Data Manager which allows you to control the data
retrieval of your SQL files that function as queries, including the number of rows to be displayed and
the duration required for the retrieval. It can also keep access information from previous runs of an
SQL file.
The format of an SQL file, such as comments, is remained when it is added into a JReport catalog.
You can use parameters in the WHERE clause of an SQL file to filter the dataset. For example, in the
above mentioned SQL file, if you want to use a parameter to return a result set in which the
customer ID is greater than the parameter, then the WHERE clause would be like this:
WHERE (Products."Product Type ID"=Catalog."Product Type ID") AND ("Orders
Detail"."Product ID"=Products."Product ID") AND (Orders."Customer
ID"=Customers."Customer ID") AND (Orders."Order ID"="Orders Detail"."Order ID") AND
( ( Customers.Country='USA' )) AND (Customers."Customer ID" > @id)
Where, id is a parameter created in the catalog.
In addition, you can use constant level formulas in the SQL file to calculate your data.
2. In the New Report set dialog, specify the title and layout of the first report in the report set as
required, then click OK.
3. In the Data screen of the report wizard, choose the SQL file with which you want to build the
XML connections
An XML connection contains relational data which is transformed from an XML data source.
JReport Designer supports parsing of the schema from XML instances, or importing them from XSD and
then transforming them to relational tables. The tables can then be added to the current connection
from the transformed relational tables and accessed in the same way as JDBC-supplied tables.
This section describes the following tasks:
BOOLEAN
BIT
BYTE
TINYINT
UNSIGNEDBYTE
SMALLINT
SHORT
SMALLINT
UNSIGNEDSHORT
INTEGER
INT
INTEGER
UNSIGNEDINT
BIGINT
LONG
BIGINT
UNSIGNEDLONG
DECIMAL
NEGATIVEINTEGER
DECIMAL
NONPOSITIVEINGEGER
DECIMAL
POSITIVEINTEGER
DECIMAL
NONNEGATIVEINTEGER
DECIMAL
INTEGER
DECIMAL
FLOAT
FLOAT
DOUBLE
DOUBLE
DECIMAL
DECIMAL
STRING
VARCHAR
NORMALIZEDSTRING
VARCHAR
TOKEN
VARCHAR
LANGUAGE
VARCHAR
NAME
VARCHAR
NMTOKEN
VARCHAR
NMTOKENS
VARCHAR
NCNAME
VARCHAR
ID
VARCHAR
IDREF
VARCHAR
ENTITY
VARCHAR
IDREFS
VARCHAR
ENTITIES
VARCHAR
ANYSIMPLETYPE
VARCHAR
GYEAR
VARCHAR
GYEARMONTH
VARCHAR
GMONTH
VARCHAR
GMONTHDAY
VARCHAR
GDAY
VARCHAR
DATE
DATE
TIME
TIME
DATETIME
TIMESTAMP
HEXBINARY
BLOB
BASE64BINARY
BLOB
When a ComplexType is being defined, the element of which cannot be declared as an anonymous
ComplexType.
Neither loop nor network structures can be defined in the ComplexType, so direct or indirect
recursion cannot occur when defining a ComplexType. That is, the type of the element declared in
the ComplexType cannot be that defined in the current direct or indirect context.
Only the anonymous attribute definition is supported by JReport Designer.
The following are diagrams show the detail syntax of elements in the above diagram:
Element Declaration::=
SimpleType::=
SimpleType Definition::=
ComplexType::=
ComplexType Definition::=
All::=
Choice::=
Sequence::=
The way to import XML schema from XSD is recommended, because when you import an XML
schema by parsing an XML instance, data types in the schema may not very accurate and all
elements will be parsed in one tree.
The XML schema structure will be parsed to a lot of complex elements which begin with XML root
node. You can specify data types for the imported XML schema if you know data types accurately,
otherwise it will be specified as default of JReport Designer. (For the details about data types and the
XML structures supported by JReport Designer, see the section Importing from an XSD file).
), attribute (
) or a reference of element (
) in the XML
Data Type
Specifies the data type of an element or attribute. The data type is imported when importing the XML
schema from XSD file or given by JReport when parsing from XML source. This property on a reference
of element cannot be modified.
Format Pattern Type
This property is activated when you modify properties for data of Date, Time or DateTime type in the
XML schema. It can be Default or Customized:
If Default is selected, the lexical formats inspired by ISO 8601 will be used for Date, Time or
DateTime data following the specification XML Schema Part 2: Datatypes Second Edition.
If Customized is selected, the Format Pattern dialog will appear for you to specify patterns to format
the Date, Time or DateTime data in the XML schema (for details, see Appendix 1: Details of format
patterns).
Format Pattern
This property is available when you specify to parse data from the XML instance at runtime.
Is Multiple
Indicates whether or not an element occurs more than once in the XML instance. By default, the value
of the Is Multiple property is affected by the value of its maxOccurs property in the XSD: if the value of
maxOccurs property is greater than 1 or unbounded, it is true; otherwise, it is false. You can modify
this property according to your own requirements.
List
Specifies whether or not to set the data type of an element or attribute as List. This property on a
reference of element cannot be modified.
List Delimiter
Specifies the delimiter to separate items in the list. Now only the following delimiters are
supported: , . ; ! / \ | and space. Space will be specified by default.
attribute in the XML schema, the default value you specify here will be applied; otherwise, the value in
the XML schema for this element or attribute will be applied.
Fixed Value
Specifies the fixed value for an element or attribute, which will be applied no matter there is a value for
the element or attribute.
Transformation rules
Transformation rules
When an XML schema is transformed to a relational schema automatically, the following transformation
rules will be applied:
A simple element in the XML schema will be transformed according to the following two rules:
If the Is Multiple property is set to true, elements will be transformed to a relational table.
Contents of the simple element will be transformed to records of a column in the table and the
column is named the same with the element.
If the Is Multiple property is set to false, contents of the simple element will be transformed to
columns in the table transformed from the parent element of the simple element, and columns are
named the same with the simple element.
Note: The value of the Is Multiple property of a simple element is defined by the value of its
maxOccurs property in the XSD. If you modify it and make it not match with the maxOccurs
property in the transformation process, the element will be transformed according to the Is
Multiple property regardless of the maxOccurs property. The following are the two conditions:
Attributes of an element in the XML schema will be transformed to columns in the table, which is
transformed from the element.
A complex element in the XML schema will be transformed to a relational table. Contents of complex
elements may contain three kinds of sub-nodes: text, simple element and sub-complex element.
Each simple element will be transformed to a column in the table according to the rules above.
Each sub-complex element will be transformed to a table according to the rules above.
Here presents four illustrative examples for you to understand the transformation rules more easily:
The following table, named Employee, is the result which is transformed from the simple element
occurred more than once in the XML instance:
In the result, these two columns - NodePrimaryKey and NodeForeignKey are generated by system
automatically in the transformation process, and the column Employee is transformed from contents of
the simple element.
Note: If the value of the maxOccurs property in the XSD is greater than 1 or unbounded, the simple
element will occur more than once in the XML, and the Is Multiple property is true by default, but if you
set Is Multiple to false in the transformation process, only the last element of the simple element in the
XML will be transformed to a column of a table, which is transformed from the parent element of the
simple element.
The following table, named Employees, is the transformed result which is transformed from the parent
element of the simple element:
In the result table, these two columns - NodePrimaryKey and NodeForeignKey are generated by system
automatically in the transformation process, and the column Employee is transformed from the simple
element.
The following table named Employees is transformed from the parent element - Employees:
In the result table, these two columns NodePrimaryKey and NodeForeignKey are generated by system
automatically in the transformation process.
The following table named Employee is transformed from sub-elements - Employee:
In the result table, these two columns NodePrimaryKey and NodeForeignKey are generated by system
automatically in the transformation process and the foreign key in the Employee is mapped to the
primary key in the Employees table.
In the result table, these two columns NodePrimaryKey and NodeForeignKey are generated by system
automatically in the transformation process and the columns- id, Date, Open, Low, Close, Volume are
transformed from sub-elements of the complex element StockMarket.
If the parent and children nodes are transformed to different tables, the parent-child relationship will
be maintained by primary key and foreign key in tables, and this relationship can be reproduced by
applying the join of the primary key and foreign key.
If the children nodes can be transformed to columns, the parent-child relationship in the XML
hierarchical logic will be maintained in the including relationship of table-column.
If Import from XSD is selected from the Schema Type drop-down list,
a. Click the Browse button behind the Schema Name field to specify the schema file.
b. From the Starting Node drop-down list, specify the starting node accordingly.
c. Specify the XML instance file. You can specify the file directly or use a parameter to do this at runtime.
To specify the file directly, check the URI radio button, and click Browse to specify the instance file. To
use a parameter to specify the file at runtime, check the Parameter radio button and then select the
parameter from the Instance drop-down list or click
to create one.
d. Check the Validate with schema before fetching to validate whether or not values in the XML instance
is valid according to the W3C standard and the selected XSD schema.
e. Click the Time Zone and Locale button to specify the time zone and the locale as required.
If Parse from XML Instance is selected from the Schema Type drop-down list, specify the instance file and time
zone and the locale as required.
Adding tables
To add tables which are transformed from an XML file to an XML connection, follow the steps below:
1. Do either of the following:
Right-click the XML connection and select Add Tables from the shortcut menu.
Right-click the Tables node of the XML connection and select Add Table from the shortcut
menu.
Right-click any folder in the Tables node of the XML connection if you have already created
some and select Add Table from the shortcut menu.
Right-click an existing table in the XML connection if there is and select New Table from the
shortcut menu.
2. Click the Load Tables button. The tables contained in the schema that is transformed from the
XML file will then be displayed in the Tables box.
3. Choose the required tables in the Tables box, and then click Add.
To choose consecutive tables, click the first table, press and hold down the SHIFT key, and then
click the last table. To choose tables that are not consecutive, press and hold down CTRL, and
then click each table.
4. After adding the required tables, click Done to close the dialog.
Refreshing tables
The tables in your catalog are a temporary deposit to improve the performance when you design and
test your report. Your data source keeps changing over the time. However, these will not be reflected
automatically in your catalog. To synchronize your tables in the connection and data source, you can
choose to refresh the table information using the Refresh command on the shortcut menu of the table.
Then when the refreshing job is done, a reporting dialog will be shown, summarizing the changes and
operations that have been taken.
Organizing tables
You can organize the tables in an XML connection by arranging them in different folders in the Catalog
Browser.
To add a folder:
1. Right-click the Tables node, or any existing folder and select Add Folder from the shortcut menu.
2. A new folder is added to the Tables node, or in the selected folder. Type a name for the folder in
the editing area, and then click outside to confirm the change.
To move tables to a folder:
1. Right-click the table you want to move in the Tables node and select Move To from the shortcut
menu.
2. In the Move Table dialog, select the folder to which the table will be moved, then click OK.
format defined in the UDS class. You can use parameters predefined in a JReport catalog in the
parameter string, and the format used in the string is "@" + parameter name. For example, if the
parameter string of a UDS is SQL=select * from employee, and you want to use the parameter sql
in a catalog to replace the part after "=" in the string, then the parameter string of the UDS will be
SQL=@sql.
6. Check the Specify Columns option to enable the column definitions list and add column
definitions. If you don't specify the column definitions, JReport will get them from the result set
automatically.
Name
The name of a column. It should have the same validation with a common table column. The
default names for column definitions are column1', column2' etc.
SQLType
The data type of the column.
Precision, Length, Scale, Radix
The default value for each SQL type. Click the cell and modify the value if necessary.
Nullable
Indicates whether the value of the column can be null. X stands for NoNulls, stands for
Nullable and ? stands for Nullable Unknown.
USA...
You will notice that each line sequentially records the name, address, state, region, zip code, country, email address and other information. In this example, you will be shown how to add an UDS using the
data stored in a formatted text file. You can modify this example to meet your requirements.
Name: The name you want to use for identifying the UDS in JReport. Here we use Address.
Class Name: The class name of the UDS. You can type one in or click Browse to select a class
file. Here we use help.AddressListUDS.
Parameter: AddressesList.txt
Note: Every time when running, java.sql.Resultset must return the same meta data (UDS
fields), including the number and order of fields, and the field properties such as column name,
SQL type, precision, scale, nullable, currency, and array.
The getResultSet() method will parse the parameter string, build a connection to the URL, and then
execute the SQL statement.
The releaseResultSet() method will release the resource such as Connection, Statement, and
ResultSet.
For examples of how to create reports using the Java object data interface, JReport provides you with
two demos which are in UDSForJavaBean.zip in <install_root>\help\designer\samples. All the
classes and interfaces the demos require are also compressed in UDSForJavaBean.zip.
Demo 2: Creating reports from Java object UDS with multi-levels of collections
Similar to the code above, other attributes of the Person object are defined by other Java objects, such as currentMailingAddress which is defined by the
Address class.
follows:
Name: pUseFakeData (Specify whether to use generated data when running the report.)
Value Type: Boolean
Prompt Value: True
Name: pNumOfFakeData (Specify the number of data records to generate that will be shown when running the report.)
Value Type: Integer
Prompt Value: Any integer number
JavaBeanDS_DataProvider is used to specify the Java class which implements jreport.uds.javabean.JavaBeanDataProvider interface, and will return
the list of required data objects at runtime in this demo, it is a list of Person objects.
JavaBeanDS_RuntimeDataID is a reserved value used as a key to get data objects from the DataCenter.
GBeanProvider_* are required values for the special data provider - jreport.uds.javabean.GenericBeanDataProvider - which is specified by
JavaBeanDS_DataProvider.
You can use this provider (jreport.uds.javabean.GenericBeanDataProvider) or create your own provider by implementing the interface jreport.uds.javabean.
JavaBeanDataProvider.
7. Click OK to add the UDS.
8. Create a standard banded report with this UDS using the report wizard.
9. Click the View tab to run the report. In the Enter Parameter Values dialog, type 3 as the value of the parameter pNumOfFakeData, and click OK. Three
records will be returned. However, the data you get now is the generated data, because in the parameter string of the UDS, you have specified the value of
the key word GBeanProvider_UseFakeData to true.
10. In order to get the real collection of data objects, the parameter pUseFakeData will be used to control the value of the key GBeanProvider_UseFakeData
value dynamically as follows.
In the Catalog Browser, right-click the UDS Person and click Edit User Defined Data Source on the shortcut menu. In the Edit User Defined Data Source
dialog, modify the value of GBeanProvider_UseFakeData to @pUseFakeData in the Parameter box.
11. Run the report again and specify the value of pUseFakeData as false to get the real collection of data at runtime.
Note: The key word GBeanProvider_RptDataInitializer in the data provider jreport.uds.javabean.GenericBeanDataProvider is used to specify the Java
class name which implements jreport.uds.javabean.RptDataInitializer interface. So if you are using the data provider jreport.uds.javabean.
GenericBeanDataProvider, you just need to provide a class which implements jreport.uds.javabean.RptDataInitializer to return a collection, list, or
array of the data objects according to different reports and parameters. Also, jreport.uds.javabean.GenericBeanDataProvider can recognize vector,
collection and array of objects and retrieve the objects inside of the collection one by one.
init()
This method is called by UDSForJavaBean to ask the data provider to prepare the data collection/list by the given initProperties. Basically, the initProperties
are the name and value pairs parsed from the UDS parameter string.
For example, the GenericBeanDataProvider will get the list of properties with the following keys:
JavaBeanDS_DataProvider
JavaBeanDS_RuntimeDataID
GBeanProvider_BeanClsName
GBeanProvider_UseFakeData
GBeanProvider_NumOfFakeData
GBeanProvider_RptDataInitializer
The values for those keys will be used by GenericBeanDataProvider to prepare the data collection. For example, if the value of GBeanProvider_UseFakeData is
true, the GeneridBeanDataProvider will use the fake data, otherwise it will create an instance by the class name provided by GBeanProvider_RptDataInitializer
and ask the data initializer object to return the collection of data objects.
getMetadataJavaBean()
This method is called back from the UDS to get the bean class in order to construct the meta data for UDS. For GenericBeanDataProvider, the Java bean class
in the collection is passed in by the key GBeanProvider_BeanClsName when you define this data source by UDS.
next()
This method is called back from the UDS to fetch the next data object as a record for the report at runtime. For GenericBeanDataProvider, the init() method
constructs the data object collection, and the next() method is going to check if the collection is a Vector, Collection, or array of objects to determine
automatically how to get the next object from the constructed collection.
exit()
This method is called back from theUDS when the JReport engine closes the result set returned by UDS. For GenericBeanDataProvider, it will call the data
initializer to close if the data is constructed by data initializer.
requireDetails()
This method is called back by the UDS to check if a certain collection attribute from Java bean needs to be displayed in the metadata.
getMaxShareTimes()
The sub-collection attribute from the Java data object could be shared among sub-reports. This is the call-back method from the UDS to determine the
maximum number of times that a certain sub-collection object is going to be shared by the current report. If your report is trying to share the same subcollection of a Java data object more than this specified value, you will get an error at runtime. However, if your report actually needs to be shared less than
the number specified, the data will stay in the buffer without being cleaned.
jreport.uds.javabean.RptDataInitializer
The implementation of this interface will be used by GenericBeanDataProvider to provide the collection of Java objects for different reports and parameters.
getDataCollection()
This method is called by GenericBeanDataProvider to return the data collection object. The input props are passed down from GenericBeanDataProvider and
includes all the values passed down into the init() method of the GenericBeanDataProvider.
close()
This method is called back by GenericBeanDataProvider when exit() function is called there.
Demo 2: Creating reports from Java object UDS with multi-levels of collections
Before running the demo, you need to do the following:
1. Extract UDSForJavaBean.zip which locates in <install_root>\help\designer\samples to <install_root>\help\UDSForJavaBean. You need to create
the UDSForJavaBean directory.
2. Compile all the java files.
javac -classpath <install_root>\help\UDSForJavaBean;<install_root>\lib\JREngine.jar;<install_root>\lib\log4j-1.2.8.
jar; <install_root>\help\UDSForJavaBean\jreport\uds\javabean\*.java
3. Copy data.txt in <install_root>\help\UDSForJavaBean to <install_root>\bin.
4. Add the path <install_root>\help\UDSForJavaBean in the ADDCLASSPATH variable in setenv.bat in the <install_root>\bin directory.
Sometimes, the attributes of a Java object are defined by other lists/collections, such as the Java object SimpleBeanTest in <install_root>\help
\UDSForJavaBean\jreport\uds\javabean\beans. It is defined as follows:
public class SimpleBeanTest implements Serializable {
private String test;
private long l;
private int i;
private int[] intarray;
private Person[] persons;
private Collection addresses;
private Date dMyDate;
}
From the code above, you can see that the Java class SimpleTestBean contains an array of Persons, a collection of addresses and an array of Int values.
For this kind of Java object, JReport Designer can create a report that gets records from the SimpleTestBean, but it cannot show the list of persons information
in the same report. If you want to create such a report - each record comes from the SimpleBeanTest object, and for each record, display the list of persons
information - you have to use the primary report and subreport to implement this function. For how to do it, see the demo below.
5. For the Class Name filed, click the Browse button, go to <install_root>\help\UDSForJavaBean\jreport\uds\javabean, and then choose
UDSForJavaBean.class. The UDS class UDSForJavaBean.class will import the class jreport.uds.javabean.beans.SimpleTestBean with full class name.
6. In the Parameter box, type in the following string:
JavaBeanDS_DataProvider=jreport.uds.javabean.GenericBeanDataProvider
&JavaBeanDS_RuntimeDataID=&GBeanProvider_BeanClsName=jreport.uds.javabean.beans.SimpleBeanTest
&GBeanProvider_UseFakeData=true&GBeanProvider_NumOfFakeData=@pNumOfFakeData
&GBeanProvider_FakeDateSubCollectionInfo=persons,jreport.uds.javabean.beans.Person
&GBeanProvider_RptDataInitializer=&GBeanProvider_ListOfDetailProps=persons,1,30000
All the highlighted names in the parameter string above are the key words for the information required by this UDS and related Java class. See the detailed
explanation below:
The list of property names of sub-collections that will be displayed in the meta-data
How many times that this report is going to share the sub-collection per main object
The timeout for the shared data in the DataCenter in milliseconds (the default value is 1 minute).
In this demo, only the sub-collection property persons will be imported from the SimpleTestBean class, and the share time is 1. If you want to create
another subreport using addresses, you have to specify the value for this key word as the following:
=&GBeanProvider_ListOfDetailProps=persons,1,30000$addresses,1,30000
and different properties are separated by the symbol $.
GBeanProvider_FakeDateSubCollectionInfo
The value of this key word is used to construct the fake data for SimpleTestBean collections. Each Java class can have multiple sub-collection objects,
and it is allowed to not construct the values of these sub-collection objects if you do not want to use it. However, if you do not specify them here in this
parameter string as <property name>,<property class name>$<property name>,<property class name>, the fake data for those sub-collections will
not be constructed, and problems will occur when running the report on fake data.
7. Click OK and the UDS SimpleTestBean is added. In the Catalog Browser, you will see that persons appears in the resource tree in the SimpleTestBean node.
8. Create a report set named MainRpt.cls, and create a standard banded report in it as the primary report based on the UDS SimpleTestBean.
6. For the Class Name text box, click the Browse button, go to <install_root>\help\UDSForJavaBean\jreport\uds\javabean, and then choose
UDSForJavaBean.class.
7. In the Parameter box, type in the following string:
JavaBeanDS_DataProvider=jreport.uds.javabean.
GenericBeanDataProvider&JavaBeanDS_RuntimeDataID=@pRunTimeDataInfo&GBeanProvider_BeanClsName=jreport.uds.javabean.beans.
Person&GBeanProvider_UseFakeData=@pUseFakeData&GBeanProvider_NumOfFakeData=@pNumOfFakeData&GBeanProvider_RptDataInitializer=jreport.
uds.javabean.SubRptCollectionDataInitializer
All the highlighted names in the parameter string above are the key words for the information required by this UDS and related Java class. See the detailed
explanation below:
JavaBeanDS_RuntimeDataID is defined to use a parameter which will be the link point from the subreport to the sub-collections in the primary report
GBeanProvider_RptDataInitializer's value is jreport.uds.javabean.SubRptCollectionDataInitializer, which is our built-in data provider set up especially
for the subreport to return the collection of data by referencing the sub-collection in the primary report. The referencing information is passed via the
parameter value @pRunTimeDataInfo which will be used when we set up the link between the primary report and the subreport.
The class name for GBeanProvider_BeanClsName is Person because the subreport will use the Person object.
Value
pNumOfFakeData
pNumOfFakeData
pUseFakeData
pRunTimeDataInfo
persons (specifies to use the sub-collection persons of the primary report as the data source of the subreport at
runtime)
Name: sql
Prompt Values:
select * from employee
select salary from employee
select employeeid, employeeposition, hiredate, notes, salary, photo from employee
For details about how to create a parameter, see Creating a parameter.
5. Right-click the User Defined node, and then select Add User Defined Data Source from the
shortcut menu.
6. In the Add User Data Source dialog, enter the following information:
Name: employees
Parameter: DRIVER="org.hsqldb.jdbcDriver"&URL="jdbc:hsqldb:C:\\JReport\\Designer\
\Demo\\db\\DemoDB"&USER=sa&PSWD=&SQL=@sql
The UDS employees will now have been added to the catalog.
7. Click
on the Standard toolbar to open an existing report set, and then select File > New >
Report.
8. In the New Report dialog, specify the name and layout of the report as required and then click
Create. Here, we choose to create a table report.
9. In the Data screen of the Table Wizard, check the New radio button and choose the UDS
employees from the User Defined node. Then, click Next to go to the next tab.
10. In the Display screen, add the fields EMPLOYEEID, employees_NOTES, employees_SALARY and
HIREDATE to be displayed in the table, edit their display names to ID, Notes, Salary, Hire Date,
and then click Next.
11. In the Group screen, specify to group on the field EMPLOYEEPOSITION.
12. Skip the Summary screen and in the Layout and Style screen, specify to display the report in the
Warm style.
13. Click Finish to create the report.
14. Click the View tab to view the report. You will then be prompted to enter a parameter.
15. Select select * from employee as the parameter, and you will see that data for all fields has
been retrieved.
16. Go back and run this report again. This time, choose select salary from employee. You will
notice that no groups are divided and the group name changes to NULL. This is because only the
field employees_SALARY has been selected this time. JReport Designer will make no reference to
the employees_Position column, on which the group is based.
Note: To make a dynamic UDS work fine, if the SQL statement at runtime doesn't include all the UDS
columns, you need to make sure that none of the UDS columns' properties is edited, that is the Specify
Columns option in the Add User Data Source dialog should be unchecked, otherwise exceptions will be
produced when the SQL statement is used to generate dynamic report from the UDS.
Troubleshooting
DRIVER=drivername&URL=url&USER=user&PSWD=password&OWNER=owner&PROCNAME=procname&SQL=
sql&REFCURSORINDEX=index&PARAMVALUE=value1,value2,value3
DRIVER=drivername&URL=url&USER=user&PSWD=password&OWNER=owner&PROCNAME=procname&SQL=sql&REFCURSORINDEX=
index&INPARAMVALUE=value1,datatype1,index1;value2,datatye2,index2;Valuen,datatypen,
indexn&OUTPARAM=datatype1,index1; datatypen,indexn
user - The database user on whose behalf the Connection is being made, for instance: scott.
owner - The owner of the procedure, for instance: scott. It can also be left empty.
sql - The SQL statement used to call the procedure or function. For instance, with regards to procedure: {call getAuthor
(?, ?)} and for function: {? = getAuthor(?, ?)}.
index - The index of the output parameter with data type equal to Ref Cursor. The start index is 1.
valueX - The value of the parameter separated by ',' and the data types must correspond to the ones defined in the
DBMS. If valueX should contain a set of values, for example, 10, 20, and 30 together serve as valueX, you will need to
use '\\' to escape the comma.
For example, if the PARAMVALUE part of the PARAMETER string is as follows:
...&PARAMVALUE=10\\,20\\,30,30\\,10\\,23,,a,
Then the parameter values will be parsed as follows:
ParaValue1 =10,20,30
ParaValue2 =30,10,23
ParaValue3 =null
ParaValue4 =a
ParaValue5 =null
Or, instead of typing the parameter values one by one in the above PARAMETER string, you can also use the parameters
in the catalog to substitute the parameter values. For example,
...&PARAMVALUE=@PARAM1,30\\,10\\,23,,a,
In this case, in the Create/Edit Parameter dialog, the prompt value of parameter PARAM1 must be typed as follows:
10\\,20\\,30
datatypeX - The name of the data type mapping to JDBC. The name is the same as the static variable name in java.sql.
types.
IndexX - The index of the input parameter. It is natural number and integer.
If you want to change the connection dynamically, you can define the parameters in this way:
oracle.jdbc.driver.OracleDriver=@driver, jdbc:oracle:thin:@dbserver:1521:orcl=@url, scott=@user,
The PARAMETER string will then be either of the following:
DRIVER=@driver&URL=@url&USER=@user&PSWD=tiger&OWNER=SCOTT&PROCNAME=getAuthor&SQL=
{call getAuthor(?, ?,?}&REFCURSORINDEX=2&PARAMVALUE=0.5,1999-7-10
DRIVER=@driver&URL=@url&USER=@user&PSWD=tiger&OWNER=SCOTT&PROCNAME=getAuthor&SQL={call getAuthor
(?, ?,?}&
REFCURSORINDEX=2&INPARAMVALUE=0.5,datatype,index;1999-7-10,datatype,index
DRIVER=oracle.jdbc.driver.OracleDriver&URL="jdbc:oracle:thin:@222.222.222.45:1521:
orcl815"
&USER=scott&PSWD=tiger&OWNER=SCOTT&PROCNAME=empquery&SQL={call empquery(?,?)}
&REFCURSORINDEX=2&PARAMVALUE=@job1
DRIVER=oracle.jdbc.driver.OracleDriver&URL="jdbc:oracle:thin:@222.222.222.45:1521:
orcl815"
&USER=scott&PSWD=tiger&OWNER=SCOTT&PROCNAME=empquery&SQL={call empquery(?,?)}
&REFCURSORINDEX=2&INPARAMVALUE=@job1
OWNER=SCOTT&PROCNAME=empquery&SQL={call empquery(?,?)}
&REFCURSORINDEX=2&PARAMVALUE=@job1
6. Click OK, and the UDS class will be added into the catalog.
Notes:
The UDS class is in a package named jet.datasource.oracle. When it is being added into the Catalog
Browser, it requires classes in package oracle.jdbc.driver. So before adding it, make sure the class
path contains the package oracle.jdbc.driver.
In the PARAMETER string,
If you do not specify the connection information, the connection defined on the data source, to
which the stored procedure UDS is added will be used as the default connection. In this scenario,
use the third parameter string listed above, and the connection can be changed at runtime via
datasource.xml, Engine API or Server API in JReport Server.
If you use the second PARAMETER string listed above, make sure the parameter value @job1
contain value, datatype, and index.
The procedure must contain one and only one OUT parameter of the REF CURSOR type. If the
procedure doesn't have such a parameter, it cannot be added into the JReport catalog since JReport
cannot create a report without a ResultSet. If it contains additional OUT parameters they will be
ignored.
The default format of Date and Time data type is:
Date: yyyy-MM-dd
Time: hh:MM:ss
Timestamp: yyyy-MM-dd hh:MM:ss.SSS
You can modify the format in the Date Format tab of the Get JDBC Connection Information dialog.
The following are some specific examples of adding Oracle stored procedures UDS to a catalog:
Example 2: Stored procedures declared and defined in a package and package body
DRIVER=oracle.jdbc.driver.OracleDriver&URL="jdbc:oracle:thin:@<hostname>:1521:
oracle8"&USER=scott&PSWD=tiger&
OWNER=SCOTT&PROCNAME=empquery&SQL={call empquery(?,?)}
&REFCURSORINDEX=2&PARAMVALUE="SALESMAN"
DRIVER=oracle.jdbc.driver.OracleDriver&URL="jdbc:oracle:thin:@<hostname>:1521:
oracle8"&USER=scott&PSWD=tiger&
OWNER=SCOTT&PROCNAME=empquery&SQL={call empquery(?,?)}
&REFCURSORINDEX=2&INPARAMVALUE="SALESMAN",varchar,1
OWNER=SCOTT&PROCNAME=empquery&SQL={call empquery(?,?)}
&REFCURSORINDEX=2&PARAMVALUE="SALESMAN"
6. Click the OK button, and the UDS class will then be added into the catalog.
Example 2: Stored procedures declared and defined in a package and package body
Suppose that the Oracle stored procedure is defined as:
CREATE OR REPLACE PACKAGE DEMO_PKG AS
type curtype is ref cursor;
PROCEDURE empquery_proc(p_job in varchar2, cur OUT DEMO_PKG.curtype);
end DEMO_PKG ;
CREATE OR REPLACE PACKAGE BODY DEMO_PKG AS
PROCEDURE empquery_proc(p_job in varchar2, cur OUT DEMO_PKG.curtype) AS
lcur DEMO_PKG.curtype;
begin
open lcur for
select * from EMP WHERE JOB = p_job;
cur:=lcur;
end empquery_proc;
end DEMO_PKG;
To add the stored procedure into a JReport catalog, follow the steps below:
1. Start JReport Designer and open an existing catalog.
2. In the Data tab of the Catalog Browser, expand the data source to which the stored procedure is
to be added, then right-click the User Defined node and select Add User Defined Data Source.
3. In the Name field of the Add User Data Source dialog, specify a name for the UDS.
4. In the Class Name field, input the UDS class jet.datasource.oracle.OracleProcedureUDS.
5. In the Parameter box, enter one of the following:
DRIVER=oracle.jdbc.driver.OracleDriver&URL="jdbc:oracle:thin:@<hostname>:1521:
oracle8"&USER=scott&PSWD=tiger
&OWNER=SCOTT&PROCNAME=empquery_proc&SQL={call demo_pkg.empquery_proc(?,?)}
&REFCURSORINDEX=2&PARAMVALUE="SALESMAN"
DRIVER=oracle.jdbc.driver.OracleDriver&URL="jdbc:oracle:thin:@<hostname>:1521:
oracle8"&USER=scott&PSWD=tiger&
OWNER=SCOTT&PROCNAME=empquery_proc&SQL={call demo_pkg.empquery_proc(?,?)}
&REFCURSORINDEX=2&INPARAMVALUE="SALESMAN",varchar,1
OWNER=SCOTT&PROCNAME=empquery_proc&SQL={call demo_pkg.empquery_proc(?,?)}
&REFCURSORINDEX=2&PARAMVALUE="SALESMAN"
6. Click the OK button. The UDS class will then be added into the catalog.
DRIVER=oracle.jdbc.driver.OracleDriver&URL="jdbc:oracle:thin:@<hostname>:1521:
oracle8"&USER=scott&PSWD=tiger&
OWNER=SCOTT&PROCNAME=deptquery&SQL={? = call deptquery(?)}
&REFCURSORINDEX=1&PARAMVALUE=@p_dname
DRIVER=oracle.jdbc.driver.OracleDriver&URL="jdbc:oracle:thin:@<hostname>:1521:
oracle8"&USER=scott&PSWD=tiger&
OWNER=SCOTT&PROCNAME=deptquery&SQL={? = call deptquery(?)}
&REFCURSORINDEX=1&INPARAMVALUE=@p_dname
6. Click the OK button. The UDS class will then be added into the catalog.
To add the stored procedure into a JReport catalog, follow the steps below:
1. Start JReport Designer and open an existing catalog.
2. In the Data tab of the Catalog Browser, expand the data source to which the stored procedure is
to be added, then right-click the User Defined node and select Add User Defined Data Source.
3. In the Name field of the Add User Data Source dialog, specify a name for the UDS.
4. In the Class Name field, input the UDS class jet.datasource.oracle.OracleProcedureUDS.
5. In the Parameter box, enter one of the following:
DRIVER=oracle.jdbc.driver.OracleDriver&URL="jdbc:oracle:thin:@<hostname>:1521:
oracle8"&USER=scott&PSWD=tiger&
OWNER=SCOTT&PROCNAME=deptquery_func&SQL={? = call shdemo_pkg.deptquery_func(?)}
&REFCURSORINDEX=1&PARAMVALUE="SALES"
DRIVER=oracle.jdbc.driver.OracleDriver&URL="jdbc:oracle:thin:@<hostname>:1521:
oracle8"&USER=scott&PSWD=tiger&
OWNER=SCOTT&PROCNAME=deptquery_func&SQL={? = call shdemo_pkg.deptquery_func(?)}
&REFCURSORINDEX=1&INPARAMVALUE="SALES",varchar,2
&REFCURSORINDEX=1&PARAMVALUE="SALES"
6. Click the OK button. The UDS class will then be added into the catalog.
Troubleshooting
If you get an "ArrayOutOfBound" error or a "Not all variables are bound" error while importing a stored
procedure, you can check the below points:
When you get a NegativeArraySizeException error while running a report designed with a stored
procedure, you can check whether some UDS columns return a negative scale (right-click the UDS
column, select Properties, and then check Scale). If yes, it means that your original table column called
by the stored procedure is likely to be of a Float data type. This returns the wrong Scale for the UDS
column. Follow the steps below to modify the UDS column's scale:
1. Open the Catalog Browser and click the Options button
on the toolbar.
2. In the Category box of the Options dialog, select Catalog, uncheck the option Forbid editing
data object properties, and then click the OK button.
3. Highlight the UDS column name that you are having the problem with and click the Expand
button
on the toolbar to show the Properties sheet. Now you can change the property values,
such as SQL type, precision, and scale to the correct values. For instance, you can change the
negative scale of the problematic column to the correct value.
If you want to specify a schema file for the XML data source file, you must first make sure that
the schema file path specified in the XML data source file is consistent with the path you
specified in the XSD URI field, and that this file actually exists. Click the Load Tree button to
load the structure of the XML file. The root of the file will then be listed in the Root Name field.
Modify the column properties in the Columns box as required.
JReport Designer supports static string inline with multiple parameters, for example:
"http://localhost:8888/jrserver%2fSampleReports%2fSampleReports.cat/StockMarket.
cls?jrs.cmd=jrs.try_vw&jrs.result_type=7&jrs.param$p_Year=2007&jrs.param
$p_Month=2"
It is the URL used to run the sample report StockMarket.cls to the XML format in JReport
Server. Type the URL into the XML URI text field, and click the Load Tree button, the structure
of the returned XML stream will be loaded in the Structure panel (before doing so, make sure
that JReport Server is started). Modify the column properties in the Columns box as required.
The colon ':' and '@' symbols are used to identify JReport parameter names. If these symbols
are used in your XML URI and you do not want JReport to parse them as parameters, you must
add quotation marks to them. For example, when you browse to d:\test\employee.xml, you
can quote it either as "d:\test\employee.xml" or d":"\test\employee.xml.
Note that you should check the No Security Checking option in the Advanced panel in the
JReport Server Administration > Configuration page before parsing this URL. In addition,
JReport parameters can be dynamically referenced in the URI for setting different values at
runtime.
An XML data source file without any schema file is also allowed. That is, you can leave the XSD URI
entry empty. However, the data type VARCHAR will be used for all the columns in the data source.
See details about the XSD file.
JReport Designer also supports dynamic XML URI. The XSD file defines the structure of the XML
format HDS and the XML file in fact only provides the data, so one XSD file can match more than one
XML file. That enables you to develop reports with dynamic XML URI. For details, see Example 1:
Developing a report from an HDS with dynamic XML URI.
When importing the XML file, you have to define the types of some data in the Format column. For
example, if it is Date type, such as 1978-03-12, in the corresponding Format column, type in yyyyMM-dd. If the data is $12,345.32, in the corresponding Format column, type in $##,###.##.
By default, the value of the Scale column is 0. So, for decimal type data, you will have to specify the
scale value in its corresponding Scale column. That is, modify this value to the number of digits that
you want to appear to the right of the decimal point. For example, if the data is 123.23, then in the
Scale column, modify this value to 2.
For the Currency, and Array columns, check them if required.
When specifying a schema file for the XML data source file, due to the schema file being complex,
there are some limitations:
Namespace: Now, only default namespace (3w) is supported by JReport Designer. You can define
a prefix, such as xs, or xsd, but the value of elementFormDefault must be qualified. The value of
attributeFormDefault should be unqualified, but JReport Designer will not allow you to add prefixes
before the attributes of the elements.
Type: If a customized complexType or simpleType is used, do not add the prefix to the value of
the type, while if the built-in simpleType or complexType is used, the prefix must be added.
SchemaSymbols.ATTVAL_BOOLEAN
java.sql.Types.BIT
SchemaSymbols.ATTVAL_INT
java.sql.Types.INTEGER
SchemaSymbols.ATTVAL_SHORT
java.sql.Types.SMALLINT
SchemaSymbols.ATTVAL_BYTE
java.sql.Types.TINYINT
SchemaSymbols.ATTVAL_INTEGER
java.sql.Types.INTEGER
SchemaSymbols.ATTVAL_NONPOSITIVEINTEGER
java.sql.Types.INTEGER
SchemaSymbols.ATTVAL_NEGATIVEINTEGER
java.sql.Types.INTEGER
SchemaSymbols.ATTVAL_NONNEGATIVEINTEGER
java.sql.Types.INTEGER
SchemaSymbols.ATTVAL_UNSIGNEDLONG
java.sql.Types.BIGINT
SchemaSymbols.ATTVAL_LONG
java.sql.Types.BIGINT
SchemaSymbols.ATTVAL_UNSIGNEDINT, //4294967295
java.sql.Types.BIGINT
SchemaSymbols.ATTVAL_UNSIGNEDSHORT, //65535
java.sql.Types.INTEGER
SchemaSymbols.ATTVAL_UNSIGNEDBYTE, //255
java.sql.Types.SMALLINT
SchemaSymbols.ATTVAL_POSITIVEINTEGER
java.sql.Types.INTEGER
SchemaSymbols.ATTVAL_FLOAT
java.sql.Types.FLOAT
SchemaSymbols.ATTVAL_DOUBLE
java.sql.Types.DOUBLE
SchemaSymbols.ATTVAL_DECIMAL
java.sql.Types.DECIMAL
SchemaSymbols.ATTVAL_STRING
java.sql.Types.VARCHAR
SchemaSymbols.ATTVAL_DATE
java.sql.Types.DATE
SchemaSymbols.ATTVAL_TIME
java.sql.Types.TIME
SchemaSymbols.ATTVAL_DATETIME
java.sql.Types.TIMESTAMP
SchemaSymbols.ATTVAL_HEXBINARY
java.sql.Types.LONGVARBINARY
Note: When you import data of List type from an XSD file, you can define the delimiter through the
property List Delimiter in the Report Inspector.
XSD structure supported by JReport Designer
In JReport Designer, not all XSD structures can be supported. The following diagrams show which
structures are supported by JReport Designer.
The ComplexType
The Element type in the diagram can be of simpleType, ref, or complexType (it is different from the
ComplexType in the root of this diagram. It can be global complexType but cannot be the anonymous
one. If you have defined a complexType named A, and in this complexType A redefined an element
as complexType named B, then the elements belong to complexType B must be of the simpleType).
The Attribute type in the diagram should be of the anonymous type or of the schema built-in type,
such as xs:string.
The SimpleType
SimpleType here should be of the schema built-in type, such as xs:string. List type here cannot
support some functions, such as minLength, and maxLength.
The Element
ComplexType here can include both global and anonymous complexType. The anonymous type
means you do not give a name to the type, for example,
<xs:element name="aa">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="Julie P. Adams"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
From the code above, you can see that the simpleType in the element aa has no name specified.
Leaf
A leaf in parallel HDS refers to a column (DBField), nodes that contain no sub-nodes.
Branch
A branch in parallel HDS is a special table that contains leaves or sub-branches.
Parallel branches
If the contents of two branches have no parental relationships, these branches are called parallel
branches.
Note: The way of using a parallel HDS is the same as with general HDS in JReport Designer. There are
however, some key points that you should be aware of when you use a parallel HDS to develop reports.
For details, see Example 2: Developing a report from a parallel HDS.
As hierarchical data sources can only be used to create banded objects, in the New Report dialog,
you can only choose to create a standard banded, horizontal banded or mailing label report using the
report wizard.
Since reports created from HDS are automatically grouped, in the Group screen of the banded report
wizard, you can neither add more groups by fields nor remove the existing ones. However, you can
make changes to the existing group criteria. For example, you can replace a group by field with
another one.
When you want to publish reports created from XML format hierarchical data sources to JReport
Server, the following method is recommended:
1. In the Catalog Browser, select the HDS that is used by the report from the Hierarchical node,
and then expand the Properties sheet.
2. Change the URI property of the HDS to a relative path, for example, leaving only the name of
the XML file.
3. Create a new folder, and copy the report, the catalog, the XML file and the XSD file (if any) to
the newly created folder.
4. Click File > Publish and Download > Publish to Server to publish the folder (for details, see
Publishing resources remotely).
5. Start JReport Server. You will now be able to run the report on it.
The following are some specific examples about developing reports from HDS:
Objects in different branches should be placed in the banded object panel they belong to. That is, a
banded object panel cannot hold objects which belong to different branches.
The children of a branch, including the columns, formulas, summaries, sub-branches, and children of
the sub-branches, can be inserted into any of their parent panels. If the parent panel is shared by
more than one branch, that is, if the parent panel works as a trunk (global panel), it can be shared
by the children of all the branches it holds. However, note that each instance of a panel, such as a
report/page/group header/footer panel, and detail panel, can only hold the children from the same
branch. If you want to insert the children of different branches into the shared global panel, you will
have to create as many instances of this panel as per the number of branches, and then insert the
children of each branch into these panels.
Where a formula/summary can be inserted depends on the branch attributes of the formula/
summary. Generally speaking, when a formula/summary creates relationships with a column, it will
obtain the same branch attributes as those of the related column, and it can be placed in the panels
where the column can be placed.
A global formula, which is not associated with any branch columns, can be placed to any position of
the report.
When you remove a branch using the report wizard, the related panel will also be removed.
A chart based on a field can only be placed in its own panels, which include most of the global
panels, except for the detail panel.
A crosstab must be built upon data of the same branch, and it should be placed in the location
where the branch data resides.
Where a text box object can be inserted depends on the branch attributes of the columns
(formulas/summaries) that it contains. A text box object can hold only the data of the same branch.
If you want to use a WSDL file on your local disk, check the Local File radio button, then click
the Browse button to browse for the file.
If you want to use a WSDL file through a URI, check the URI radio button, then input the URI
string in the text field that follows and specify the user name and password for assessing the
WSDL file.
WSDL file.
7. Check Pre-join if you want to enable the Pre-join feature when building a query or defining join
relationships in business cubes.
8. Click the Security Configuration button to display the Security Configuration Setting dialog to
configure the security policy.
9. Specify the user name and password for the username token to be used in the security policy.
10. Specify the type for the key store from the Key Store Type drop-down list.
11. Click the Browse button next to the Key Store File field to specify the key store file.
12. Input the password in the Key Store Password text field to get the access to the key store file.
13. In the Client Key box, specify the alias name to be used as client signature in the key store, and
set the password for the name.
14. In the Server Key box, specify the alias name and password to be used to get the server-side
certification or public key in the key store.
15. When done, click OK to go back to the Web Service Data Source dialog.
16. Click the OK button in the Web Service Data Source dialog to set up the web service connection.
Note: When you configure the security policy for a web service connection, except for Key Store Type,
all the other options in Security Configuration Setting dialog can be controlled by constant level
formulas. However, the formula control is only available after the web service connection is already set
up, that is when you edit an existing web service connection.
5. Type the number of seconds in the Time Out text field to specify how long to wait to get the
specified service and operation information defined in the WSDL file.
6. When done, click the OK button to accept the changes and exit the dialog.
2. In the Input Message column, select the input message you want to edit, then modify its value in
the text field of the Value column as required. You can either input the value, or define a constant
level formula or parameter to be the value of the input message.
3. Type the number of seconds in the Time Out text field to specify how long to wait for the
operation to complete.
4. When done, click OK to accept the changes and exit the dialog.
Pre-joins
After tables have been added to a catalog, you can now use them to build reports. However, in your
daily work, you may often be dealing with a set of tables in your queries. You will have to define
relationships and create joins among different tables every time you create a new report. For XML data
source, if the parent and children nodes are transformed to different tables, joins will be embodied by
the parent-child relationship, which is maintained by primary key and foreign key in tables.
JReport Designer provides you with a pre-join feature. The pre-join information is one kind of resource
information stored in the catalog. It is saved in a standalone file with the extension .pre, and shares
the same prefix as the catalog file. It is not used at report runtime. In JReport Designer, when you
open a catalog, the pre-join file is opened at the same time. When you save the catalog, the pre-join
file is also saved.
Using the pre-join feature, you can do the following:
Modifying a join
3. Click the button, then in the Select Data Source dialog, select the date source on which the joins will be created
and click OK. The Pre-join Editor window appears.
4. Click the Arrange button to organize the tables that have been added to the catalog.
5. Now you can make joins among tables by using mouse drag and drop. Point to one column in the source table,
press and hold the mouse button, then, move the pointer to the other column in the target table and release the
mouse button. A green line with a join button
will be shown, linking the two columns. This represents that a
join has been created.
6. Repeat the above step to set up more joins.
Modifying a join
Once a join has been established, you can modify it at any time if required. To do this:
1. Double-click the join button
2. If you want an outer join made, check the Outer Join option, then specify the format of the join as
required: SQL92 or Use'+'.
Note: You cannot make outer joins for XML data sources.
3. Edit the join conditions in the Condition panel according to your requirements.
4. When done, click OK to accept the changes.
See also Join Options dialog for details about options in the dialog.
Outer Join
There are two kinds of join formats: SQL92 and Use'+'. With conventional joins, records that do not satisfy the
join condition are eliminated from the result. An outer join preserves these records in the result and replaces
the missing values with nulls. JReport calls the join left (right) outer join if the records in the left (right) side
table are preserved. For example, consider the following two tables:
Table 1
Order
O#
C#
101
001
102
002
103
004
Table 2
Customer
C#
Name
001
GE
002
IBM
003
DELL
The conventional join of Customer.C# = Order.C# will produce the following result:
JoinResult
O#
C#
Name
101
001
GE
102
002
IBM
The left outer join of Customer.C# = Order.C# will produce the following result:
JoinResult
O#
C#
Name
101
001
GE
102
002
IBM
103
004
<null>
The right outer join of Customer.C# = Order.C# will produce the following result:
JoinResult
O#
C#
Name
101
001
GE
102
002
IBM
<null>
003
DELL
The full outer join of Customer.C# = Order.C# will produce the following result:
JoinResult
O#
Order.
C#
Customer.
C#
Name
101
001
001
GE
102
002
002
IBM
<null>
<null>
003
DELL
103
004
<null>
<null>
3. In the Select Pre-join dialog, you will see that all the joins you have made are displayed in the All
Joins box. Choose the joins you want and click
4. Click OK to dismiss the dialog and return to the Save Pre-join Path dialog.
5. Click the New button and follow the steps above to form a new path. You can select Hide Joins
Added in Other Paths to hide the joins that have been used by the existing paths in the All Joins
box.
6. After you have finished specifying paths, click OK in the Save Pre-join Path dialog to confirm the
settings.
7. Click the OK button in the Pre-join Editor.
Notes:
The feature of multiple joins (more than one join existing between two tables) is supported.
In JReport Designer, the joins in one path should never form a loop (any table in this path will have
direct or indirect joins with all the other tables). If you specify a path which forms a loop, JReport
Designer will prompt you to re-select the joins.
You cannot define a path completely having all the same joins as with existing paths. If you have
specified a path that is the same as an existing path, JReport Designer will prompt you to re-select
the joins.
To rename a path:
1. Highlight the path you want to rename in the Pre-join Paths box.
2. In the Rename box, type the new name, and then press Enter to confirm.
If you have made joins and defined at least one path, you can click OK to close the Pre-join Editor
window.
If joins have been made but no path defined,
If there are no join loops among the joins: after you have clicked OK, a default path named Path1
which includes all the joins you have made will be defined by JReport Designer. A message box will
then be displayed to ask whether you accept the default path (click Yes), or you can modify the
default path (click No).
If there are join loops among the joins, after you have clicked OK, the Save Pre-join Path dialog
will appear for you to define at least one path.
Queries
Relational databases typically contain many rows of data, with each row constituting a separate record.
Most relational database queries retrieve only a portion of the records contained in a table. The WHERE
clause qualifies the query command statement to limit the data to specific records from the tables.
Queries are a higher-level object in a catalog. Its concept is similar to that in the database. The
working objects a query can select include tables/views (DBFields), formulas or summaries, and
parameters, and the tables/views it can select from are the mapped tables/views defined in a JReport
catalog. In this way, a query is independent from the raw database. You can use queries to view,
change and analyze data in different ways, and JReport can help you with the building of various
professional reports based on queries. When making a query, you can place criteria or restrictions on
the data to extract only the required data from the database. For example, instead of having to view all
the customers of your company, you can view just the customers from Japan. To do this, you specify
conditions that limit the results to the records with Country field = "Japan".
JReport Designer provides you with an interactive query designer - the Query Editor, to build any
queries as you like. It also enables you to build queries using the pre-join feature.
In addition, JReport Designer provides you with the Data Manager which allows you to control the data
retrieval of your queries, including the number of rows to be displayed and the duration required for
the retrieval. It can also keep access information from previous runs of a query (including imported
SQL, stored procedure and UDS which function as queries).
The following topics describe queries:
Creating a query
Editing a query
Previewing a query
Locking queries
Dynamic queries
Query modifiers
Data Manager
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how queries could be used in a report. For the query example, open
<install_root>\Demo\Reports\SampleComponents\Query.cls.
Creating a query
To create a query in a catalog, follow the steps below:
1. In JReport Designer, open the required catalog, then do either of the following:
In the Catalog Browser, expand the data source in which you want to create the query, then expand
the Relational node in the data source. In the connection node, right-click the Queries sub node and
select Add Query from the shortcut menu.
Click File > New > Query on the menu bar, specify the data source in which the query will be
created, then click OK.
2. In the Input Query Name dialog, give a name for the query and click OK. The Query Editor window
appears.
3. On the Query menu, click Add Table to add tables to the query.
4. Check the columns you want in each table. To select all, click *.
5. Join the tables added to the query as required.
Based on the Auto Join options that are selected in the Query Editor category of the Options dialog,
JReport will join the tables automatically. However, if the pre-join feature is enabled for the data source
connection where the query is created, the auto join settings will not take effect, instead, JReport applies
the pre-joins to the added tables. You can also add more joins among these tables.
6. Create filters on the query.
7. Add some computed columns and formula fields to the query if required.
8. Select Apply from the Query menu to save the query.
When a query has been added to a catalog, you can further edit it to suit your requirements.
Note: Normally, a query returns all the records that match its search criteria without considering whether
there are duplicated ones. You can decide to get only one copy for each record by checking Select Distinct on
the Query menu. When this option is enabled, SQL SELECT statements are treated as SELECT DISTINCT
statements. The query will search for identical records and ensures to return them only once instead of
returning duplicate records from the database.
If JReport Designer needs other tables to bridge the tables you have added, you will be prompted to
decide whether to add another table to the query. For example,
Suppose you've added table A and C to your query, a message box will then appear asking you
whether you want to add table D in order to create links between tables A and C.
Note: The prompt message appears only when the option Show warning message when adding
tables is selected in the Query Editor category of the Options dialog. Otherwise, JReport will add
the bridged table automatically without any prompt.
If there is more than one paths available in the pre-join, as with this case,
You've added table A and C to the query, and there are two paths available - ABC and ADC. JReport
Designer will ask you for the path ABC or ADC.
JReport Designer provides two methods for seeing the path information of a query:
In the Catalog Browser, expand the Properties sheet and select the query that uses the pre-join
path. You will then see a property called Path Name which shows the name of the path used.
In the Query Editor window, click the Show Paths button.
Adding tables to a query that has already been specified a path - If more than one path is suitable
after the tables have been added, the specific path will still be used. That is, you cannot choose
another path to replace the original one.
If the path specified for a query is deleted - In the Query Editor, the Show Paths button will be
disabled.
Editing a query
You can edit queries added to a catalog at any time. To edit a query, in the Data tab of the Catalog
Browser, right-click the query and select Edit Query from the shortcut menu, then in the Query Editor
window, edit the query as required. For example, you can add some extra tables to the query and
define join relationship among these tables.
See also Query Editor window for additional help about options in the window.
This section details how to edit an existing query as follows:
Adding/deleting tables
Adding/deleting tables
2. Select a schema from the Schemas box if the database supports schema. The tables contained
in the selected schema will then be displayed in the Tables box.
3. If required, check Include Added Table to make the tables that have been added to the query
available in the Tables box.
If this option is checked, when you click the Add button to add a table that has already been
added to the query once, the Input Table Name dialog will be displayed, asking you to give the
new table a different name.
4. Select the required tables in the Tables box and then click the Add button (or double-click the
required table to add it to the query).
5. Click the Done button to close the Add Table dialog.
Notes:
For tables added to a query, you can decide whether or not show the full name of the fields (with
table names) by checking the option Show Mapping Names on the Query menu.
After deleting a table from a query, any joins based on the table will be moved.
In the criteria panel, if you do not want to show the table names for the selected columns, you can
uncheck Show Table Names on the Query menu.
To delete a column in a table, select the column in the criteria panel and click Delete Column on
the Column menu. You can also undo the deletion by finding the field in the table and placing a check
mark beside it.
Foreign Keys
If there is a column that is defined as foreign key in one table and a primary key in another at the same
time, these two tables will be joined together.
Primary Keys with Same Names
If a column is defined as a primary key in one table and appears in another at the same time, these two
tables will be joined together.
Same Column Names
Tables with the same column name will be joined together.
Notes:
When adding tables to a query, only when you have clicked the Done button in the Add Table dialog to finish
the operation, can the tables be automatically joined together based on the auto join criteria. If you choose
to exit the Add Table dialog by directly clicking the close button of the dialog, the auto join criteria will not
be applied to the tables you add.
If you have specified to use pre-joins in your queries, the Auto Join feature will not take effect.
Position the mouse pointer over the column that will be the source of the join, then click and hold the left
mouse button while dragging the join away from the source column to the destination column.
Select the columns from two tables while pressing CTRL, and then click Query > Join Columns.
The join relationship is then established between the tables. When more than one relationship is required
between two tables, you can create multiple joins between them.
Editing a join
No matter a join is created automatically or manually, you can further edit it if required. To do this:
1. Double-click the join button
2. Check the Outer Join option to set the join an outer join, then specify the format of the join as required:
SQL92 or Use'+'.
3. Edit the join conditions in the Condition panel according to your requirements.
4. When done, click OK to accept the changes.
See also Join Options dialog for details about options in the dialog.
You just need to type in NY and CA. JReport Designer automatically places the ='xx' (equal sign and
quotes) in the column for you. Below is a list of the syntax available:
Specifying expressions:
The expressions are the main section of the filter. To place a criterion, follow the steps below:
1. Click the Add Condition button to add a condition line.
2. In the field text box, specify the field to be filtered. You can either type in the name of the field
manually or click
to specify the
5. If you want to add more conditions, click the Add Condition button, define the conditions and then
set the relationship between the condition lines as required.
6. When done, click OK to accept the settings.
Notes:
The symbols at the bottom of the Expressions dialog allow you to modify the expression according to
your requirements.
In addition to setting the condition value by selecting from the Field Value tab, you can also type the
value in the Expression text box. If the value is of String type, it should be as 'aaa' with a quote mark.
The quote mark can be typed by yourself or be added by JReport Designer automatically. To have the
quote mark automatically added by JReport Designer, follow the steps below:
1. Click the Options button
2. In the Options dialog, switch to the Query Editor category and check Automatically add
quotation marks on table and column names.
3. Click OK to save the settings.
When you specify the value of a filter condition, you can use sub-queries to narrow down the result
with the second tab Subquery in the Expressions dialog (see Using sub-queries in filters).
See also:
Search Condition dialog for detailed explanation about options in the dialog.
Dynamically filtering queries for additional information about how parameters can be used to filter
queries dynamically.
Syntax
expression----+- = --+- SOME --+-++++++++-
( subselect )
<> -+ ANY
! = --+ ALL
<
--+
>
--+
<= --+
! > --+
>= --+
! < --+
---+
----+
The subselect must specify a single result column and can return any number of values, whether
they are null or not.
False if the specified relationship is false for at least one value returned by the subselect.
Unknown if the specified relationship is not false for any values returned by the subselect and at
least one comparison is unknown because of a null value.
True if the result of the subselect is empty, or if the specified relationship is true for every value
returned by the subselect.
True if the specified relationship is true for at least one value returned by the subselect.
False if the result of the subselect is empty, or if the specified relationship is false for every value
returned by the subselect.
Unknown if the specified relationship is not true for any of the values returned by the subselect
and at least one comparison is unknown because of a null value.
Examples
SELECT qty FROM sales WHERE qty>= ALL (SELECT qty FROM sales)
SELECT BUYERID, ITEM FROM ANTIQUES WHERE PRICE != ANY (SELECT PRICE FROM ANTIQUES);
EXISTS predicate
The EXISTS predicate tests for the existence of certain rows.
Syntax
- [ NOT ] EXISTS--(subselect)
The subselect may specify any number of columns and,
The result is true only if the number of rows specified by the subselect is not zero.
The result is false only if the number of rows specified by the subselect is zero.
Example
SELECT DISTINCT pub_name FROM publishers WHERE EXISTS (SELECT * FROM titles WHERE
pub_id = publishers.pub_id AND type = 'business')
IN predicate
The IN predicate compares a value with a set of values.
Syntax
expression----+-- [NOT] IN --+-- ( subselect )
In the subselect form, the subselect must identify a single result column and may return any number
of values, whether null or not null.
Example
SELECT distinct pub_name FROM publishers WHERE pub_id IN (SELECT pub_id FROM titles
WHERE type = 'business')
The following example explains how to apply a sub-query when filtering a field:
1. Create a query named mainin in the catalog, add the table Customers and select the following
columns: Customers_Customer ID, Customer Name, Customers_City, and Customers_Region.
2. Click Filter on the Query menu to open the Search Condition dialog.
3. Click the Add Condition button to add a condition line.
beside the field text box. In the Expressions dialog, select the column
4. Click
Customers_Customer ID, then close the dialog.
5. Select in as the operator from the operator drop-down list.
6. Click
beside the value text box. In the Expressions dialog, click the Subquery tab. Select an
existing query in the catalog to be the sub-query. If you want to edit the selected query, click the
Edit Subquery button. To create a new sub-query, click the New Subquery button.
Here, we create a new query named subin, add the table Orders, select the column
Orders_Customer ID, and add a condition "Ship Via=Express Delivery" in the Search Condition
dialog.
7. Click OK. The sub-query subin will then be added into the value text box. Click OK to close the
Search Condition dialog.
Now, the sub-query subin will be applied to the filter when you build a report that uses the
Customers_Customer ID column.
You can edit the query statements in the text area as follows:
To check whether it can be parsed back to the structured PSQL query correctly, click Parse. Whether
the query statement is valid or not, a message box will be displayed to show you the result.
To see whether it can be successfully processed, click Execute.
To accept the changes you have made, click OK. JReport Designer will then parse and execute the
query statements and dispose the Query Editor window.
Notes:
If there are parameters in this query, their default values will be used to construct statement.
If JReport Designer fails in parsing or restoring the query statements, a message box will be
displayed asking you whether to apply the changes anyway. If you choose yes, a statement string
will then be recorded in the PSQL query. However, after that, the structured statement may be not
tally with the statement string.
When creating a query using the Query Editor, JReport allows you to copy and paste your own SQL
statement directly in the SQL window as explained above. However, because JReport query parser
follows the SQL 92 standard, sometimes JReport is not able to parse the customized SQL statement. In
this case, a warning message is displayed after you click the OK button in the SQL window asking
whether to continue using the customized SQL statement. If you choose Yes, the customized SQL mode
is enabled, in which all the functions in the Query Editor will be disabled, and you can only edit the
query by modifying the SQL statement in the SQL window.
During the customized SQL mode, you can see the Customized SQL Mode option in the Query menu of
the Query Editor is enabled and checked. By unchecking this option, you can go back to use functions
of the Query Editor, in which case, the customized SQL statement will be lost and the SQL statement
generated by JReport will be applied instead.
Note that you are required to guarantee the correctness of the customized SQL statement since
JReport will not parse it.
2. Input a name for the column in the Computed Column Name text box.
3. Compose your functions for the column.
4. When done, click the OK button to create the computed column.
Notes:
In the lower part of the Create Computed Column dialog, you can see some functions and tables/
columns of the query. These are just for your reference. You can specify the expression by yourself in
the editing text box, only if the expression can be accepted by your database.
The functions in this dialog are not from the JReport system. They are from the database you are
connected to.
If you change your data source, some of these functions may no longer exist. For each database, a
different set of supported functions will be returned. The following functions will help you with writing
an expression.
": Place quotations on long character strings or names that have blanks in them (example: place
quotes on values such as "New York" or "Washington DC").
||: Place fields together in the same Expression menu. (Example: "New York" || "Washington DC").
When you add a formula field, if the table that contains the field doesn't exist in the query, this table
will be automatically added to the query.
You are not able to edit a formula in the Add Formula Field dialog.
After a formula field has been added to a query, if you want to replace it with another one, you can
double-click its name in the criteria panel, and then choose the required field in the Replace Formula
dialog.
Previewing a query
To preview a query, follow the steps below:
1. In the Query Editor window, click the Preview button
dialog will then appear.
Note: If the query has parameters, when you click the OK button, the Enter Parameter
Values dialog will be displayed. After you enter the parameter value, the Preview window will
appear showing the corresponding records.
4. Click
,
,
and
to browse the records. If the type of the result set is
TYPE_FORWARD_ONLY, the last page button will be disabled until you have browsed the last page.
on the toolbar. Click the Stop button
5. To refetch the result set, click the Refetch button
to stop JReport from refetching the result set is required.
6. To print the result set, click the Print button
printing, click the Print Preview button
7. If you want to set up the page parameters, click File > Page Setup.
8. Click File > Close, or the close button of the window to close the Preview window.
Note: In the Preview window, JTable is used to display the result set. When you open the window, the
result set is cached, and when you close the window, the result set is released.
When creating a union query, note that the selecting order should refer to the order in the primary
query. The SQL type and the number of the selected columns should match those in the primary
query. For example, if you select two columns in the primary query, the first one is of Integer type,
and the second one is of String type. Then, in the union query, you should also first select an Integer
column, and then a String type column.
A union query can't support formulas and parameters.
After a union query is set up, you can also modify it at any time.
To modify a union query:
1. Right-click on the primary query and select Edit Query.
2. In the Query Editor, click Query > Union > Select to bring up the Union(s) dialog.
3. To add a union to the query, select a union from the Queries box, and then click
union from a query, select a union from the Union box, and then click
. To remove a
4. In the Union box of the dialog, select the Attribute column to specify the type of the union.
Locking queries
Normally in JReport Designer, queries are free to be shared among reports, which could increase the
potential risk of being changed unexpectedly. When a query is shared by more than one report, it can
be changed by any of those reports, which means you must be very careful to avoid causing impacts to
other reports when you modify the shared query for one report. However, JReport provides you with
the flexibility to lock a query to prevent it from being changed by unauthorized person.
To modify the user information, right-click the query and select Modify User from the shortcut
menu. In the Modify User Information dialog, provide the old user name and password and click OK.
Then, in the Modify Query's Username and Password dialog, type in the new user name and
password as required and click OK.
To remove a user, right-click the query and click Delete User on the shortcut menu. In the Remove
User dialog, provide the user and password information and click OK. The query is then free to be
shared.
Note: A query can be claimed by only one user, that is to say, you can create only one user to a query.
3. Locate the Share property and set its property to true or false. If it is true, the query can be
shared among reports and can be modified. Otherwise, the query is locked and can be neither
used in new reports nor modified by unauthorized person.
Make sure that you have enabled the editable mode for the Properties sheet before editing the
property values, that is to say, you have unchecked the option Forbid editing data object
properties in the Options dialog.
You can also lock or unlock a query in the following way:
1. Right-click the query that has already been claimed by a user and select Set Share Property
from the shortcut menu.
2. In the Set Query's Share Property dialog, provide the user information and check or clear the
Share option as required.
3. Click OK to confirm the change.
Notes:
If a query has not yet been claimed by any user, when you set its Share property in the Properties
sheet, you will be prompted to claim the query by creating a user to it.
If a query is locked, it is password protected. Unless you provide valid user information, you will
neither be able to create a report directly using that query nor make changes to the query, including
setting its Share property.
Dynamic queries
You can build queries using the Query Editor or from an imported external SQL file. Either way, the
queries should be predefined. However, sometimes you may want to specify the query at runtime. For
example, in the catalog, you build the query "select customers_id from customers", but at runtime, you
may want to fetch data from another table - customers1. The query should be updated according to the
table index, such as "select customers_id from customers1". JReport provides a new feature called
dynamic query. With this, queries can be dynamically generated, which allow you to fetch data from
different tables at runtime.
In this section, you will be shown how to make use of dynamic queries via the dynamic query interface
as follows:
ConnectionInfo
Driver, URL, User, Password, DateFormat, TimeFormat, TimestampFormat, TransactionIsolation level,
ReadOnly, QualifiedNamePattern, ExtraNamePattern, EncodingPattern
Column array
All the selected columns. Elements in this array are ColumnInfo object. ColumnInfo contains Mapping
Name, Real Name, Table Info and Expression (if this is a computed column).
Tables(array)
Selected tables. Elements in this array are TableInfo objects. TableInfo contains Mapping Name, Real
Name, Correlation Name, Schema, and Catalog.
Joins(array)
Elements in this arrays are JoinInfo objects. JoinInfo includes Column from, Column to, Operator,
and Join type.
QBEs(array)
Part of the where condition. It is retrieved from the query builder. Elements in this array are QBEInfo
objects. QBEInfo contains ColumnInfo with QBE condition bound to this column.
Ands(array)
Part of the where condition. It is retrieved from the advanced search condition in the query builder.
Elements in the array are AndInfo objects. AndInfo contains Left expression, Operator, Right
expression, and Logic.
SubLinks(array)
If the dynamic query is for a subreport, the SubLinks is used for the additional WHERE clause to filter
data, and this is the way to link the dynamic query to the main report. Elements in this array are
composed of SubLinksInfo objects. SubLinkInfo contains Column, Operator and Value.
Parameters (array)
Parameters used for creating a query. Users are required to encode parameters that the database
can recognize. The elements in this array are ParameterInfo objects. ParameterInfo contains Name,
Type and Value.
OrderBys(array)
Elements in the array are OrderByInfo objects. OrderByInfo contains Column and sorting direction.
Other Information
Query name, IsDistinct, and WherePortionString. The value of WherePortionString is set via JRengine.
setWherePortionString().
You implemented the interface by the class UserSQLStmtCreatorImpl, then input the property
value as UserSQLStmtCreatorImpl;@para1;@para2. Para1 and Para2 are parameters used to
specify criteria while creating the query.
School year which changes at runtime, requires to be inserted into the report template so that
the input value for the runtime parameters can be passed to the dynamic query interface via
QueryInfo object, in order for a corresponding SQL statement to be returned.
Notes:
3. Set the value of the query property Enable SQL Statement Creator.
In the Catalog Browser, in the Properties sheet of a highlighted query, there is a property named
Enable SQL Statement Creator, which indicates whether or not the query uses the dynamic query
interface to get the result set. When it is set to true, the query can be re-generated at runtime
using the dynamic query interface.
An illustrative example
You are provided with a demo program, SQLStmtCreatorImpl.java in <install_root>\help\designer
\samples, which implements the dynamic query interface. This demo is for changing the table name of
the query sent to the database. Specifically, when you run the report, if you enter 1 as the tableIndex
parameter, the query will dynamically change to Customers1. If you do not enter anything, you will get
the result set from the Customers table.
The following example explains how to compile the required files and use dynamic queries in a report:
1. Compile SQLStmtCreatorImpl.java.
Assume that JReport Designer has been installed in C:\JReport\Designer, and the class files of
the MappingNameFinder.java are in C:\JReport\Designer\help\designer\samples:
javac -classpath c:\jreport\designer\lib\JREngine.jar;c:\jreport\designer\help
\designer\samples SQLStmtCreatorImpl.java
Note: To compile SQLStmtCreatorImpl.java you will need another file MappingNameFinder.
java in <install_root>\help\designer\samples.
2. Modify the batch file setenv.bat in <install_root>\bin by appending the SQLStmtCreatorImpl.
java path into the batch file's ADDCLASSPATH variable:
set ADDCLASSPATH=%JAVAHOME%\lib\tools.jar;C:\jreport\designer\help\designer
\samples;
3. Start up JReport Designer.
4. Click File > Open. In the Open Report Set dialog, click the Browse button to open the catalog file
SampleComponents.cat in <install_root>\Demo\Reports\SampleComponents, then open the
sample report BandedObjectReport.cls.
5. Launch the Catalog Browser, expand the Data Source 1 node, right-click the Parameters node,
click Add Parameter on the shortcut menu, then create a type-in parameter of String type
named tableIndex (leave the other settings to their default).
6. Expand the Relational node in Data Source 1, and then select the JDBC connection.
on the toolbar, then
7. Unfold the property list of the connection by clicking the Expand button
set the value of the SQL Statement Creator property as SQLStmtCreatorImpl;@tableIndex.
The parameter tableIndex is used to specify which table is to be selected at runtime.
8. Select the query QueryForBandedObject in the Catalog Browser, and set the value of its
property Enable SQL Statement Creator to true.
9. Save the catalog and view this report.
10. The Enter Parameter Values dialog appears. When you input 1 as the value of the tableIndex, the
report will run on the table Customers1, and when you input nothing as the value of the
tableIndex, the report will run on the table Customers.
Query modifiers
Query modifiers, also called WHERE portions in JReport, are the WHERE clauses in SQL select
statements. In JReport, the SQL select statements are called queries. Both queries and query modifiers
are stored in the catalog, and query modifiers are saved in the catalog independently (not related to
queries). When a report is running, JReport will construct the SQL statement based on the query used
in the report and may substitute the WHERE clause in the SQL statement if there is a given query
modifier.
The query modifier can be stored in the catalog in two formats: structure and string. In the structure
format, the groups of conditions are stored. The query modifier consists of many condition groups and
the groups are connected by a logical operator. Each condition consists of many conditions and the
conditions are also connected by a logical operator. Each condition consists of a left expression, the
relationship operator and a right expression. In string format, the text of the query modifier is stored.
Before running a report, you can specify a query modifier to the JReport system via the Engine Bean,
so that you can generate the report on different data (for details, refer to Defining query range via the
WHERE portion).
4. Enter a name for the query modifier in the Name text box and specify its type in the Type dropdown list, Structure or String.
5. Select a query from the Query drop-down list to build the query modifier. You can click the Show
Query button to view the query if required.
6. In the editing area, edit the query modifier as required.
If String type has been selected, a text editor will be shown where you can key in the WHERE
clause. If the Structure type has been selected, a condition editor will be displayed where you can
construct the query modifier by clicking buttons (for details about how to set the condition, see
Filtering with the filter format).
7. Click the Check button to check the validity of the query modifier according to the query.
The validity of a query modifier is defined as: all the fields and formulas referred to by the query
modifier are available to the chosen query. This validation check also ensures that the query
modifier will work with the specified query.
8. Click the Show SQL button to view the string of the query modifier.
9. When done, click OK.
UResultFileResultSet;C:\JReport\Designer\Cached\test
3. Click the View tab to view the report. You will now see that the report data has been retrieved
from the cached query result file.
Note: If you check the option Use cached query result in the Catalog category of the Options dialog,
whenever you view a report, a dialog will prompt you to choose a cached query result to run the report.
4. Click the Add button, and the Data Source Editor dialog appears.
on the toolbar to
5. Input a name for the driver in the Driver Name box. Here, we name it OrderStat.
6. Check the URL radio button and input the URL as follows:
jrquery:/jet.universe.resultfile.UResultFileResultSet;Full path of the cached
query result
In the example, the URL is jrquery:/jet.universe.resultfile.UResultFileResultSet;C:
\JReport\Designer\Cached\orderstat_cached
Note: If you check the Driver radio button to specify the driver, you will need to input the
class name and parameter of the driver as below:
Data Manager
The Data Manager in JReport Designer allows you to control the data retrieval of your queries, including
the number of rows to be displayed and the duration required for the retrieval. It can also keep access
information from previous runs of a query (including imported SQL, stored procedure and UDS which
function as queries).
This topic shows the usage of the Data Manager as follows:
In the Catalog Browser, right-click the query and select Properties from the shortcut menu. In
the Properties sheet, change the property values as required, then press Enter on your
keyboard to apply the change.
In the Resource View panel, right-click the query and click Properties on the shortcut menu. In
the Properties dialog, edit the property values as required and then press Enter to confirm.
Here, modify the value of Maximum Rows to 10 and change the value of Maximum Duration to 1
second. This specifies the maximum elapsed time to be one second, and that within this duration
no more than ten records will be fetched.
Tip: If you find that you are unable to edit the properties, make sure that you have
unchecked the Forbid editing data object properties option in the Options dialog (File >
Options > Catalog > Forbid editing data object properties).
4. View the report. You will find that only ten rows are fetched within one second.
Notes:
You can decide where the two properties will be applied, on JReport side or on the database side, by
configuring the JdbcDriversConfig.properties file. For details, see Specifying where to implement the
maximum query run time and number of records.
If the value of the Maximum Rows/Maximum Duration property is zero or a negative number, it
means the number will be unlimited.
If the number you specify for Maximum Rows/Maximum Duration is equal to or more than that
required for running all the records in your report, Maximum Rows and Maximum Duration will be
unlimited.
It is not recommended to specify both of the properties at the same time. Sometimes the time
information for large-data reports may not be very accurate. For example, if you specify 5 seconds,
you may find that it takes 7 seconds, since this time also includes the time for writing the history
information to a file.
Click the Refetch Data button
on the toolbar of the View tab to run the report again if you find
that the specified properties have not taken effect.
These two properties apply to the specified query, not the report. For a report with a subreport,
specifying the properties for a query used by the main report will not have any effect on the
subreport's query, and vice versa. For example, Report A.cls uses query Q1, and Report B.cls uses
query Q2. B.cls is inserted to A.cls as a subreport. Maximum Rows for Q1 is modified to 3. The main
report will now only fetch three records, whereas Q2 for subreport B.cls will not be affected. To limit
the subreport records, you will have to restrict Q2.
2. Open a report and adjust the Maximum Rows and Maximum Duration properties of the query on
which the report is built to suitable values.
3. Click the View tab to view the report.
4. In the Resource View panel (or the Catalog Browser panel), right-click the query the report uses
and choose Data Manager from the shortcut menu. You will now find that the run information of
the query is displayed in the Data Manager dialog. You can sort the items by Date, Time, Rows,
Duration, Report, simply by clicking the column title.
Notes:
When the values Maximum Duration and Maximum Rows are 0, the history record will not be
generated.
The Data Manager allows you to find details of current and previous runs of a query.
The following is an example to demonstrate how to use the Data Manager with the sample report
InvoiceReport.cls. Here assumed that the command line alwaysShowDMRecord=true has been added to
the file report.ini in <designer_install_root>\bin:
1. Click File > Open on the menu bar.
2. In the Open Report Set dialog, click the Browse button to open the catalog file SampleReports.
cat in <designer_install_root>\Demo\Reports\SampleReports, then open the sample report
InvoiceReport.cls but do not view it.
3. Click View > Catalog Browser.
4. In the Catalog Browser, right-click the query Invoice and select Data Manager. The Data
Manager dialog is shown without any history information, since the report has not yet been run.
5. Close the Data Manager, then specify Maximum Rows as 5 and Maximum Duration as 3 in the
Catalog Browser for the Invoice query.
6. Click the View tab to run the report. After the report result is shown, go to the Data Manager. You
will now see the history of this first run of the query. The history information will include when the
report is run - date and time, the running duration, the number of rows displayed, and the report
that uses the query.
7. Close the report, and use the query Invoice to create another report report1.cls.
8. Run report1.cls, then the run information will be appended as a record in the Data Manager, but
the Report field it shows will be report1.
4. Open the report on JReport Server and start JReport Designer. Make sure that you have pointed
the dmPath argument in the file report.ini in <designer_install_root>\bin to the output
location (containing the dm folder) of the server. Then in JReport Designer, open the
corresponding query in the Catalog Browser to show its server-side run history information.
Parameters
A parameter is a variable whose value is input at runtime. If a report contains a parameter, you will
need to specify a value for the parameter when running the report. For example, if each time a report
is run, an editor for the report would like to have his/her name placed in the report. You can simply
insert a parameter directly into the report, and then each time you run the report, the value of the
editor's name can be inserted. The runtime parameter dynamically controls your report result.
Also, you may want to input order date as an input parameter when running a report so that only
orders on that date are displayed. In this way, parameters can be used as part of the query condition
(search criteria), so that only the records which satisfy the specified parameter values are retrieved. In
addition, JReport parameters can also be used for dynamic grouping or sorting.
Parameters defined in a catalog can be used in different reports. They can also be edited at any time.
Click the following links to get details:
Creating a parameter
Creating a parameter
To create a parameter in a catalog, follow the steps below:
1. In JReport Designer, open the catalog file in which you want to create the parameter.
2. In the Data tab of the Catalog Browser, expand the data source that will include the parameter, right-click the
Parameters node, and then select Add Parameter to bring up the Create Parameter dialog.
to add a value line, double-click in it and then type in a value of the specified data type.
or
4. Specify the value which will be set as the default selected value in the Enter Parameter Value dialog by
selecting it from the list.
3. Click in the Bind Column cell and select a field from the drop-down list.
4. If you want the values of another field to be displayed in the Enter Parameter Values dialog, which
makes more sense to report end users than the values of the Bind Column field, click in the Display
Column cell and then select that field from the drop-down list.
5. Click in the Parameter cell to create the parameter. A name for the parameter will then be
automatically added by JReport.
6. Repeat step 2 to 4 to create more parameters. Make sure that the selected Bind Column fields are of
cascading relationship one level by one level down. In this way a group of cascading parameters will be
created.
or
6. In the Options box, set options for the parameter according to your requirements.
7. When done, click OK to create the parameter.
Meaning
Presentation
Example
Era designator
Text
AD
Year
Number
1996
Month in a year
July & 07
Day in a month
Number
10
Number
12
Number
Minute in an hour
Number
30
Second in a minute
Number
55
millisecond
Number
978
Day in a week
Text
Tuesday
Day in a year
Number
189
Number
Week in a year
Number
27
Week in a month
Number
Am/pm marker
Text
PM
Number
24
Number
Time zone
Text
'
''
Single quote
Notes:
Text: 4 or more pattern letters -- use full form, < 4 -- use short or abbreviated form if one exists.
Number: the minimum number of digits. Shorter numbers are zero-padded to this amount. However,
Year is handled in a different way. If the number of letter 'y' is 2, then the year will be truncated to 2
digits.
Text & Number: 3 or over, uses text, otherwise uses number.
Any characters in the pattern that are not in the ranges of ['a'..'z'] and ['A'..'Z'] will be treated as
quoted text. For example, characters such as ':', '.', ' ', '#' and '@' will appear in the resulting time
text even if they have not been single quoted.
A pattern containing any invalid pattern letter will result in a thrown exception during formatting or
parsing.
Examples
Meaning
Notes
A digit
Separates formats
Meaning
Example
_ (underscore)
[]
[^]
Reference: If you would like to reference parameter features showed in sample reports, you can open
the report set Parameter_*.cls in the catalog file SampleComponents.cat, which is located at
<install_root>\Demo\Reports\SampleComponents.
4. Create a table report based on the query as follows: have the fields Customer ID, Customer Name, City
and Phone displayed in the table and apply the default style.
5. View the report. In the Enter Parameter Values dialog, click
6. In the Enter Values dialog, uncheck the All option, add the listed values 1, 10, and 20 to the right box,
and then click OK. You will find that the records with Customer ID equal to 1, 10 and 20 have been
retrieved.
7. View the report again. This time, in the Enter Values dialog, remove 1, 10, and 20 from the Selected
Values box first. Enter the values 3, 7, 9, 11, 15, and 25 in the Enter Values field and add them into the
Selected Values box one by one. Then click OK. Now, the records for the specified Customer IDs are
displayed.
To view the report with full data, select the All option and then click OK in the Enter Values dialog.
Notes:
The parameter's data type should be set according to the field type and the manner in which you use the
parameter. For example, if the field is a number, define a parameter to be Number type also.
If you set the parameter format to be @ParameterName, to specify a String type value, your typed value
should be without single quotations, for example, USA. Once you input a parameter value with single
quotation marks, the quotation marks will be recognized as a part of the parameter value.
However for the format :ParameterName, to specify a String type value, your typed value should be with
single quotations, for example, 'USA'. If the data type is Number, the parameter value should be like: 1234.
The colon is used to append the parameter value (of String type) to the first condition row instead of
replacing it.
7. Click OK to apply the change to the query.
8. View the report, and in the Enter Parameter Values dialog, write a WHERE portion in standard SQL syntax
as value of p_Portion, for example, CUSTOMERID<20. Then, both of the two WHERE portions will be used
to filter the query.
5. Add another user David which has the permission to view records in the United Kingdom only.
For details about how to set up a RLS policy, refer to Setting up a connection-scope security policy.
6. In the same data source, right-click the Parameters node and then click Add Parameter.
7. In the Create Parameter dialog, enter pCountry in the Name field, select Bind with Single Column
from the Value Setting drop-down list, and bind the parameter with the Country column. In the Options
box, select CusCountry as value of Record Level Security, and then set the Distinct option to true.
8. Create a query CustomersInfo on the table Customers. Select all the fields contained in the table.
9. Create a standard banded report based on the query, and have the fields Customer ID, Customer Name,
Country and Phone displayed in the report.
10. In the Resource View panel, right-click the node that represents the query, and then select Edit Query
from the shortcut menu.
11. In the Query Editor, click Query > Filter.
12. In the Search Condition dialog, add a condition for the query as below (for details, see Filtering with the
filter format):
When applying an RLS policy to a parameter bound with a column, you must make sure the parameter
bound column and the column used to set conditions in the RLS policy are in the same table. In addition, if
the RLS policy also contains conditions defined on other columns, all the columns must be in the same table,
and the RLS policy cannot contain parameters and formulas; otherwise, when you apply the RLS to the
parameter, the RLS would not work properly.
When you have applied an RLS policy to a parameter and then you click the SQL button in the Create
Parameter dialog to edit the SQL statement of the parameter, the parameter value drop-down list may be
Null because the changed SQL statement may not match the permissions of the RLS.
To have the RLS applied to a parameter work on JReport Server, the users for the RLS must be imported
from the server. If the users are created in JReport Designer, you need to first create these users on JReport
Server, and then in JReport Designer, synchronize the security information with JReport Server by means of
importing security information from the server with the Merge option checked.
9. Create a table report based on the query, and have the fields Customer Name, City, Country and Region
displayed in the report.
10. View the report and the Enter Parameter Values dialog appears.
11. From the region drop-down list, select a region, then only the countries in the selected region will be
displayed in the country drop-down list. Choose a country from the list, and then only the cities in the
selected country will be displayed in the city drop-down list.
12. Click OK. You will now find that only the specified records are shown.
Method 2
1. Open the demo catalog SampleReports.cat and in the Catalog Browser, expand the desired data source
node.
2. Right-click the Parameters node and then click Add Parameter.
3. Create a parameter named ParamRegion, select Bind with Single Column from the Value Setting dropdown list, select Tables and Views from the Source drop-down list, select Region as the Bind Column
and Display Column. Then in the value cell of the Import SQL option, you can see the following statement:
SELECT CUSTOMERS.REGION FROM CUSTOMERS
4. Create another parameter named ParamCountry. Bind it with the column Country, then click
value cell of Import SQL and edit its SQL statement as below:
in the
3. All the parameters used in the report are displayed in the dialog. Select a parameter, and then
click Move up and Move down to adjust the sequence.
4. Click OK to close the dialog.
5. Run the report. You will now find that the parameters are displayed in the sequence that you
specified.
4. Open an existing report set. Insert the parameters P_Category, P_Month, P_Country, and GroupParam into a
report of the report set.
5. View the report, and the Enter Parameter Values dialog appears. You can select the parameter you want from
the GroupParam drop-down list.
Select @P_Category, the P_Category parameter is displayed in the dialog and you can select or type in a
value for the parameter. If you select @P_Month,@P_Country, then both the parameters P_Month and
P_Country will be displayed for you to specify values with which to run the report.
The package name can be defined by yourself. In our sample code, we use help as the package
name.
Since the interface ImportParamValues is in the package jet.util, you will have to import the
class package jet.util.*.
A public constructor method without parameters is required.
5. Open the report set with the parameter value that you want to import.
6. In the Report Inspector, set the property Import Parameter Values of the report set to be the class
name that you just generated with the package name, and set Parameter List Auto to false.
Notes:
Be default, the node that represents the report set level is not displayed in the Report Inspector. You
can select any report contained in the report set in the tree first and then click the Up button
the toolbar to make it displayed.
Ensure that the parameter format in the class file is consistent with that in JReport, specifically, that
the parameter format used in the class file is parsed when viewing the report set so that the correct
data records will be returned.
When you implement the interface jet.util.ImportParamValues and use its function promptValues( ),
ensure that:
on
The parameter of this function is a String array which contains the names of the parameters.
The return value of this method is a Hashtable, its keys are parameter names used in the report
set and its values are vector objects which contain the parameter values.
When there are subreports in a main report, setting the properties Import Parameter Value and
Parameter List Auto will not affect them. That is, you have to set these properties in the main report
and subreports separately.
The following two examples explain how to import parameter values and what you should be aware of
while using this feature:
6. Save the report set and catalog, and then view the report result.
7. In the Enter Parameter Values dialog, click the drop-down list of the parameter. You will find that
all the values you specified in ParamTest.java have been imported into the list.
8. Select one of the values with which to view the report.
9. Publish the saved report set CustomerAnalysis.cls to JReport Server (for details, see Publishing
resources remotely).
10. Append C:\JReport\Designer\help to the ADDCLASSPATH variable of setenv.bat in
<server_install_root>\bin.
11. Start JReport Server with the modified batch file.
12. Load your web browser to access the JReport Server Console Page. You will then have the same
parameter values as you did in JReport Designer.
Note: In the sample ParamTest.java, we used the method compareToIgnoreCase( ) to compare the
parameter name in the class file with the one in your report. This method is not case sensitive when
performing the comparison.
Summaries
Summaries allow you to generate functions for your data, such as count, average, sum, and standard
deviation. Summary functions are based on how you initially grouped the data. For example, if you
grouped your data according to country, and you have two groups (US and Canada). Then, if you
specify to perform a summary break by country group, you will get the summary result for each group.
A summary is a special kind of formula, but it is often used for DBField or an existing formula.
Summary functions can also be realized with formula functions. Since summaries are frequently used in
reports, JReport provides you with an easy-to-use GUI for this purpose.
The following topics describe summaries in detail:
Summary functions
Creating a summary
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how summaries could be used in a report. For the example, open
<install_root>\Demo\Reports\SampleComponents\UsingFormula.cls.
Summary functions
The following are functions that can be used for creating summaries.
Count
Total count of all the values in a field. The value will be shown in the Group Footer. For example, if
you have six fields in a group, the value generated by Count will be 6.
Sum
This function sums up all the numerical values in a field. The value will be shown in the Group Footer.
For example, if a field contains 5, 10, 15, 20 and 25, the Sum function will return 75.
Minimum
This function finds the smallest numerical value in a field. The value will be shown in the Group
Footer. For example, if a field contains 5, 10, 15, 20, and 25, the Minimum function will return 5.
Maximum
This function finds the largest numerical value in a field. The value will be shown in the Group Footer.
For example, if a field contains 5, 10, 15, 20, and 25, the Maximum function will return 25.
Average
This function takes the average of all the numerical values in a field. The value will be shown in the
Group Footer. For example, if a field contains 5, 10, 15, 20, and 25, the Average function will return
15.
Distinct Count
This function takes a total count of all the distinct fields in a report. This value will be shown in the
Report Footer. For example, if you have forty three fields in your report and three fields have
identical values, the value generated by Distinct Count will be 41.
Population Standard Deviation
This function uses the following equation to compute its value. PSD takes the square root of the
Population Variance.
Standard Deviation
This function uses the following equation to compute its value. SD takes the square root of the
Variance.
Population Variance
This function uses the following equation. PV sums up the square of the difference between a value
and its average, and then divides the result by the total number of values.
Variance
This function uses the following equation. Variance sums up the square of the difference between a
value and its average, and then divides the result by the total number of values subtracted by one.
Creating a summary
To create a summary in a catalog, follow the steps below:
1. In JReport Designer, open the required catalog, then in the Catalog Browser, expand the data
source in which you want to create the summary.
2. Right-click the Summaries node and click Add Summary on the shortcut menu. The New
Summary dialog displays.
If Static Summary is checked, select the field from the Resource box and then click
next to
next to Group By. And if the field you select is of Numeric/String/Date/Time type, you can
further specify to which level the data will be grouped by by selecting a special function from the
Special Function drop-down list. If Customize is selected, you can set the function by your own
in the Customized Function dialog.
If Dynamic Summary is checked, first select Up or Down from the drop-down list, then in the
combo box, select a value or input an integer, which should be between 0 to 127, to specify the
group on which the summary will take effect.
For example, if you select Up or Down and input 0 in the combo box and insert this summary
into any group, the summary will take effect on this group; if you select Up and input 1 and
insert this summary to a group, the summary will take effect on the group higher than the
group where the summary is inserted, and if you specify Down and 1, it will take effect on the
lower group; and the rest may be deduced by analogy.
Notes:
If the dynamic summary is to be used in a chart, when defining the summary, you must
choose Down from the Group By drop-down list; if it is to be inserted to other data
containers, the summary must be defined on Up level.
When you insert a dynamic summary into a report and there is no corresponding group
level to match settings of the dynamic summary, an error message will be generated.
7. Click the Apply button to add the new summary to the catalog. The Summary Name dialog will
then be displayed, asking you to name the summary. Enter a name as required, and then click OK.
8. Click the OK button in the New Summary dialog to close the dialog.
Formulas
Formulas are objects that are computed at runtime, which allow you to manipulate field data by
performing calculations on it. They control the data that will be displayed, and can even create new
data not directly available from the database.
A formula is a symbolic statement of the manipulations that are to be performed on certain data before
it is printed onto your report. For example, if your report contains an @Sales field and an @Cost field,
and you want to create an @GrossProfit formula, you can designate its value as @Sales - @Cost.
@GrossProfit is a simple formula that tells JReport to subtract the value of the @Cost field from the
value of the @Sales field, and then to print the result. Formulas can be used to calculate numeric
values, compare one value to another and select alternative actions based on the comparison. Also,
they can be used to join multiple text strings into a single string. In general, formulas can be used to:
calculate information you cannot directly obtain from database data fields.
compare data.
Meanwhile, in JReport, there is a type of formulas which are refer to as constant level formulas. These
kind of formulas never refer to a DBField, page level special fields (the value of the special field is
ready at the time when the report result is generated), or other constant level formulas. The allowed
constants that can be referred to by the formulas are: parameters, the special field User Name,
constant values such as aaa, and the combination of the above three.
The following are some specific topics about JReport formulas:
Creating a formula
Formula examples
DBArray in formulas
Note: Currently JReport formula searches for javac based on the java.home option, but this way may
fail under some user environments. To ensure the formulas can work, you are recommended to use the
javac_path option to specify the full path of javac yourself, for example, set -Djavac_path=c:
\jdk1.6.0_17\bin\javac.exe in the startup file of JReport.
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how formulas could be used in a report. For the example, open <install_root>
\Demo\Reports\SampleComponents\UsingFormula.cls.
Creating a formula
To create a formula in catalog, follow the steps below:
1. In JReport Designer, open the catalog to which you want to add the formula.
2. In the Data tab of the Catalog Browser, expand the data source in which to create the formula, then right-click the
Formulas node, and then select Add Formula from the shortcut menu.
3. Enter a name for the formula in the Input Formula Name dialog and click OK. The Formula Editor window will then be
displayed.
4. Compose the formula by selecting the required fields, functions and operators from the Fields, Functions and Operators
panels. You can also write the formula by yourself in the editing panel.
5. To comment a line, click the Comment/Uncomment button
on the toolbar.
6. If you want to bookmark a line so that it can be searched easily later, click the Bookmark button
7. Click the Check button
You should have some knowledge of the formula syntax before you can successfully compose a formula with no errors. To
learn the formula syntax, refer to topics in Formula syntax.
If you refer to any field in the formula, the reference name for that field will be prefixed with an @ sign. If the field name
contains spaces, the reference name in formula will be quoted with double-quotation marks (""). For example, if the field
name is Customer Name, then the reference name will be @"Customer Name".
When formulas reference display names or mapping names, the names should not contain any of below characters if the
names are not quoted by double-quotation marks "":
"~", "`", "!", "@", "#", "$", "%", "^", "&", "*", "(", ")", "-", "+", "=", "{", "}", "[", "]", "|", "\\", ":", ";", "\", " ' ", "<", ",",
">", ".", "?", "/"
Examples:
The number of the "if-else" statements in a formula is limited to 190. When this number is reached, you should use the
"select-case" statement instead.
In the Fields panel, if the summaries or parameters you want to use have not been predefined in the catalog, you can create
them by your own by clicking the New Summary button
see Creating a summary and Creating a parameter).
Formula examples
The following are some formula examples.
Example 1: TerritoryUSA
if (@State in ["CT", "ME",
"NorthEast, USA"
else if ( @State in ["DC",
"MidAtlantic, USA"
else if ( @State in ["CO",
"Rockies, USA"
else if ( @State in ["AZ",
"South, USA"
else if ( @State in ["AL",
"SouthEast, USA"
else if ( @State in ["AK",
"West, USA"
else if ( @State in ["IL",
"MidWest, USA"
Purpose: In your sales report, you want JReport to print out which territory the customer belongs to
according to the abbreviated state names stored in the State field.
Explanation: In the six else-if statements, JReport will retrieve the value of the State field, and
compare it with the values in brackets []. If a value matches the value in brackets, the formula will
return the territory name.
Example 2: DateToMonth
Number m = Month ( @"Order Date" ) ;
String str = "";
if ( m == 1 )
str = " January Sales"
else if( m == 2 )
str = " February Sales"
else if ( m == 3 )
str = " March Sales"
else if( m == 4 )
str = " April Sales"
else if( m == 5 )
str = " May Sales"
else if ( m == 6 )
str = " June Sales"
else if ( m == 7 )
str = " July Sales"
else if( m == 8 )
Purpose: In your sales report, you want JReport to print out the month name of the orders, so that you
can compare the orders of each month in a year.
Explanation: Since the database field Order Date is of the TimeStamp data type, the built-in function
Month (DateTime) is first used to extract the month portion of Order Date. Then, the else-if statement is
used to decide the month according to the return value of the function, and assigns a String value which
contains a relative month name to the pre-declared string variable str.
Example 3: SectionInvisible
boolean s;
if (pagenumber==1){
s=true
}
else s=false
Purpose: This formula is used to control the Suppressed property of a certain section such as Page
Header, so that the section will be suppressed on the first page of the report.
Explanation: Since it is only required to suppress the section on the first page, if only the Suppressed
property of the section is set to true in the Report Inspector, then it will be suppressed on every page. In
this formula, a Boolean type variable is first declared. Then, an else-if statement is used to decide
whether or not the page is the first page. If the statement is true, true is assigned to "s". If the
statement is false, false is assigned false to "s". In this formula, pagenumber is a special field.
3. Create a formula named Formula3 as below to display the sum of one page. And insert it into the
BandedPageFooter panel.
return pagetotal;
instName is the instance name that you give when you load the class. It is a global variable,
you can use it in your formulas in the current data source.
ClassName is the class name defined in your class file. If the class file is put in the package jet.
formula.javaformula, only the class name is required. However, if it is in your own package,
you must specify the qualify name of the class.
For example, the following declaration assumes the class MyFunctions is in package jet.
formula.javaformula:
import myfunc from "MyFunctions";
And the following declaration allows user defined UDF class in any package, supposing the
class is com.mycom.MyFunctions:
import myfunc from "com.mycom.MyFunctions";
Notes:
You should write the import statement only without anything else in a separate formula
so as to avoid importing unwanted things.
You should avoid giving the same instance name when importing the same UDF.
5. Using dialog:
a. On the File menu of the Formula Editor, click Import UDF Classes.
b. In the UDF Classes dialog, click the button
c. In the Import UDF Class dialog, input the class name with full package path and then click
OK.
d. The class with package path is displayed. Click OK.
a temp file:
import myfunc from "MyFunctions";
global integer filehandle = myfunc.openfile("e:\\test\\data.txt", false);
Note: If the class file is in your own package com.mycom other than jet.formula.javaformula,
import the class in a formula as follows:
import myfunc from "com.mycom.MyFunctions";
5. Compose a formula (fmlB) to call the method to write data into the temp file:
string contents ="";
contents = @"Customer Name"+"\t"+ @Country+"\t"+ @Phone + "\t"+ PageNumber + "\n";
myfunc.write(filehandle, contents);
The return value of the last statement is the formula result.
6. Compose another formula (fmlC) to close the temp file:
PageNumber;
myfunc.closefile(filehandle);
If the statement PageNumber is added to the formula, the formula will be calculated after the
page break, which means that the calculation point is controlled.
7. We have now defined three formulas (fmlA, fmlB, fmlC) in the above three steps. You can use it in
a report as with a normal one.
Note: Now in JReport, the '8859-1' encoding is not required any more and the UDF functions you
define should be able to return the correct unicode strings. Thus, if you have UDF fuctions created in
previous JReport versions which still return '8859-1' encoded strings, you may need to modify them to
make them return unicode strings.
DBArray in formulas
JReport Designer supports a multiple-value field, which contains a set of values in a single field, in a
formula. Using the multiple value field is the same as using an array in a formula. You can refer to a
field with multiple values as with a normal field in a formula, such as @FIELDNAME, and then use the
array functions that JReport Designer provides in the Formula Editor to manipulate the values in it.
JReport Designer first converts this field into a normal array, and then manipulates it in the usual way.
For example, normally an array in a formula is manually defined as follows:
Integer myArray[4]=[1, 2, 3, 4]; //Datatype ArrayName[ArraySize]=[ArrayContent];
The array may be referred to in this way:
integer myInt=3;
myInt in myArray;
If a field, named myField, for example, contains a similar array value, it can be referred to similarly:
integer myInt=3;
myInt in @myField;
Usually when you open the drop-down list of this kind of property, there is no formula to be selected
directly unless you have created some in the catalog before building the report. You can also click the
<Create Formula> item in the drop-down list to create one as required.
When you are composing a new formula that directly binds to a property using the Report Inspector,
make sure the data type of return value is the same as the property type. Otherwise, the new
formula will not be bound to this property, although it will be created in the catalog data source.
In this example we will vary the middle hexadecimal digits of the RGB color values. The Red value is
fixed at 0x00, the Blue value is fixed at 0x7f. The Green value will change according to the number of
records displayed. Record 1 will use color 0x00107f, Record 2 will use 0x00207f, and so on.
Take the following steps:
1. Create a standard banded report in JReport Designer.
2. In the design area, select the detail panel (DP) of the banded object.
3. In the Properties panel of the Report Inspector, click the value cell of property Background, and
click
4. Click the View tab to view the report. The report will be shown somewhat as below, depending on
the report you use.
Report Sets
A report set is a container which holds multiple reports. It is a manageable set of reports that are
designed for the same purpose, or related purposes. Reports developers can design, maintain, run and
schedule these reports together. Reports in the same report set can share the same parameters and
dataset.
Comparing with the single-report management system before, the Report Set feature is designed to
improve the product performance, avoid wasting data sources by sharing them in the report set, and
manage and maintain reports more easily for the report developers.
In addition, when more than one report set is opened, you can use items in the Window menu to
manage the design windows of the report sets in a way you prefer.
The following topics detail the functions of report sets:
2. In the New Report Set dialog, select the layout of the first report in the report set.
Since a report set cannot be empty, you will also need to create a report in it when creating the
report set. See Creating a report for details about how to create the first report in a report set.
3. Click OK to create the report set.
on the Standard
JReport Designer supports opening more than one report set at one time.
If you just want to access some recently open reports, click File > Open Recent and then select the
reports one by one from the sub-menu.
When you open a self-contained report set, JReport will prompt you to specify the way in which you
want the report set to be opened. For details, refer to the Open As dialog.
5. All components in the selected reports, which have self-bound datasets, will be listed in the dialog.
Specify which dataset you want the component to use by clicking its Dataset Name cell and
choosing from the drop-down list.
6. Click OK to import the reports with specified datasets to their components. The imported reports
will be listed after the existing reports in the report set.
1. On the report tab bar, right-click any report tab and select Insert from the shortcut menu.
2. In the New Report dialog, specify the layout of the new report, then click OK.
3. Create the report according to your requirements.
Copying a report
To copy a report, on the report tab bar, right-click the report you want to copy and click Copy on the
shortcut menu. Then,
If you want to make a copy of the report within the current report set, right-click any report tab
and select Paste from the shortcut menu. You will then be prompt to give the report a new name.
Specify the name as required.
If you want to copy the report to another report set of the same catalog, open the report set to
which the report will be copied, then right-click any report tab and select Paste from the shortcut
menu.
Moving a report to another report set
1. On the report tab bar, right-click the report you want to move and click Cut on the shortcut
menu.
2. Open the report set where the report will be moved.
3. Right-click any report tab and click Paste on the shortcut menu.
Renaming a report
1. On the report tab bar, right-click the tab that represents the report with the name you want to
change and click Rename on the shortcut menu.
2. In the Input Report Name dialog, enter a new name for the report.
3. Click OK to confirm the name.
Duplicating a report
To make a duplicate report in the current report set, right-click the tab that represents the report on
the report tab bar, and then click Duplicate on the shortcut menu.
Removing a report
To remove a report from a report set, right-click the tab that represents the report on the report tab
bar, and then click Remove on the shortcut menu.
Note: Since a report set cannot be empty, you will not be able to remove all of the reports in
the report set.
The report sets and the relevant files alike will be copied to the directory where the target
catalog file is located.
The resources (query, formulas, parameters, and so on) that are referenced by this report set in
the current catalog will be merged to the target catalog.
If the connection does not exist yet in the target catalog, it will be added using the same
connection information as in the source catalog.
In this way, even while users work with their own individual catalog files, they can still publish their
report sets and associated resources to the target "universal" catalog file. Note that JReport does not
handle the concurrent issue. Two people cannot update the "universal" catalog at the same time.
See also Merging catalogs for more information about the Save To command.
Folder Item: A container in which you can operate report set items or sub folder items.
Report Set Item: This represents a report set. You can edit name, keywords and description
properties of this item.
In the Report Set Manager, you can manage your report sets as follows:
Adding an item
To add a folder item to the Report Set Manager:
1. In the Report Sets tab of the Catalog Browser, select a folder and right-click it.
2. Select Add Folder from the shortcut menu.
Now, a new folder will have been added as a sub node, and the default name for the folder is Folder1,
Folder2.... However, you can rename the folder as required. To do this, right-click the folder item and
select Rename from the shortcut menu, then type a new name in the name box, and then click outside
the box (or just press Enter on your keyboard).
To add a report set item to the Report Set Manager:
1. In the Report Sets tab of the Catalog Browser, right-click the folder to which you want to add the
report set.
2. On the shortcut menu, click Add Report Set.
3. In the Choose Report Set dialog, select a report set. Here you can select multiple report sets at a
time. Then, click Open.
Now, the selected report set will have been added to the specified folder. You can double-click any
report set item in the Report Set Manager to open the report set. The default name of the report set
item is the file name of the report set. However, you can give the item another name as you would
with a folder item.
A report set can be added to multiple folders in case you want to include it in multiple categories.
3. Specify the search condition and click the Search Now button to start searching. Matched results
will be listed in the search result box.
4. If you want to start another search, click the New Search button and set the condition using the
method described above.
4. Give a name for the table, and then click OK in the Input dialog.
Note: If a table already exists, it will be replaced. So you must be sure that there are no duplicate
names in the DBMS.
Deleting items
By using the Catalog Browser, you can delete a report set from the file system.
To delete a report set or a folder or multiple items:
1. In the Report Sets tab of the Catalog Browser, select the report set or the folder or the multiple
items on the Reports tree, and then take either of the following ways:
2. A Warning message box is displayed. Check the option Also delete report files from file
system if you want to remove them from your local directory permanently. Otherwise leave the
option unchecked and only remove the items from the virtual tree.
3. Click Yes in the box. If a report set is selected, the report set will be deleted. If a folder is
selected, the folder and all its contents will be removed.
If a report set is deleted manually from the local file system, later when you open the Catalog Browser,
you will see the node icon that represents the report set is marked with a red cross. You can use the
above method to remove the unused node.
Reports
A report in JReport is not only a passive document used only for reading or viewing but also a business
document that contains the predefined data. It is a form that typically contains data from many
unrelated records or transactions.
JReport reports are usually composed of different components, with each component serving different
purposes. They have the same functions as with general reports, but also include additional unique
qualities.
In addition, the report templates in JReport use a flow layout model, which means paragraphs and
components in the report body can flow from one page to another, maintaining their sequence.
This chapter details JReport reports in the following sections:
Creating a report
Editing a report
Previewing a report
See also Report Bursting for information about how to design a bursting report in JReport Designer.
Static
The component will be positioned at the location in which it is inserted. The X and Y coordinate
properties are disabled. The position of the component cannot be moved other than by having its
insertion point moved. This can happen when the text flow preceding the insertion point expands.
Relative
The component will be positioned at an offset to the position at which it is inserted. The offset is
determined by the X and Y coordinate property values. This value is not available for some kinds of
component.
Absolute
The component will be located at the position specified by dragging and dropping or by setting its X
and Y coordinate property values. The component insertion point does not change, for instance it is
not affected by having text inserted before it.
When components in the same flow layout container have their Position property value set to
Absolute and overlap, you can set the display order of the objects by right-clicking the object and
then selecting an item from the Move submenu (or clicking the corresponding move button on the
Alignment toolbar).
Move Backward
Moves the component one step towards the back.
Move to Back
Moves the component to the back.
Move Forward
Moves the component one step closer to the front.
Move to Front
Paragraphs
Paragraphs are created when text is entered directly into a flow layout container, that is the report
body, a tabular cell or a text box.
To input text, simply position the mouse pointer in the report body, a tabular cell, or a text box and
type the text.
To exit a paragraph, click the mouse pointer anywhere outside of the paragraph.
To format a paragraph, position the mouse pointer anywhere in the paragraph and click Paragraph
on the shortcut menu. For details, refer to Formatting paragraphs in a text box.
Creating a report
Before you can create a report, you first have to create a report set or open an existing report set.
JReport provides you with eight report layouts as follows, which are designed for serving different
reporting requirements:
The following topics explain in detail about how to create a report in a specific layout:
2. In the dialog, specify the title of the report, select the Banded/Horizontal Banded/Mailing
Label layout and click OK. The corresponding report wizard will then be displayed.
3. In the Data screen of the wizard, specify the dataset on which the banded object will be built.
To build the banded object on a new dataset created from the catalog resources, check the New
radio button, and then select the data source of the dataset. If the given data resources are not
what you want, click the <Add xxx...> item to create one. In addition, if you choose to create
the dataset from a query, you can click the Modify button to further modify the query if
required.
To build the banded object on an existing dataset in the report set, check the Existing radio
button, and then select the dataset as required (click the Modify button to modify the selected
dataset if necessary). You can also click the <Add Dataset...> item to create one as required.
4. In the Display screen, add the required fields from the Resources panel to be displayed in the
banded object. Modify the display name of any added field if necessary by double-clicking its
Display Name cell. And if required, click the Sort Fields By button to specify how to sort data in
the banded object (for details, refer to the same topic on table).
5. In the Group screen, add the fields as the grouping criteria, and then specify the sorting direction
of each group in the Sort column (for details, see the same topic on table).
6. To add summaries, go to the Summary screen. In the sum on panel (the panel on the right),
specify the group to which the summary will be applied (if you select Banded Object, the summary
will be based on the whole dataset), add a field from the Resources panel as the summary field,
and then select the function for the summary from the Aggregate Function column.
7. If you want to create a chart together with the banded object in the banded header panel, go to
the Chart screen. Select the chart type you like. From the Category drop-down list, select the field
you want to display on the category (X) axis of the chart. You can choose from the group by fields
of the banded object on which some summaries are added. Choose the field to be displayed on the
series (Z) axis of the chart from the Series drop-down list, where all the group by fields of the
banded object are listed. From the Show Values drop-down list, select the field you want to
display on the value (Y) axis of the chart. You can choose from the summary fields which are
calculated based on the field you specify to display on the category axis of the chart.
8. In the Filter screen, define some filter conditions to filter the data displayed in the banded object.
To define a filter condition, click the Add Condition button to add a condition line, then from the
field drop-down list, select the field on which the filter will be based, set the operator with which to
compose the filter expression from the operator drop-down list, and in the value combo box, type
the value of how to filter the field or select the value from the drop-down list.
9. If you are creating a mailing label report, in the Layout screen, specify the label size and the gap
between the labels.
10. In the Style screen, specify the title and style of the banded object, and if required, click the Page
Setup button to set the page settings.
When you want to create a banded report on a hierarchical data source, pay attention to the unique
features of HDS. For details, refer to Developing reports from HDS.
If you have added several group by fields to the banded object in the Group screen, when the report
is created, these groups will be indented according to the Customize group indent option setting in
the Options dialog. You can configure this option in advance to have the groups indented according
to your requirements.
If you have added some summaries to the banded object in the Summary screen, when the report is
created,
JReport will automatically give the summaries some proper name labels to help you clarify the
meaning of the numbers. The auto generated labels are controlled by the Text property in the
Report Inspector. You can also manually edit the text of the label later by setting this property.
By default, the summaries that have the same function will be aligned horizontally in the banded
object. If you want to align summaries of the same function vertically, check the option Align
summaries vertically in the Options dialog in advance.
See also:
Horizontal Banded Wizard for detailed explanation about options in this wizard.
Mailing Label Wizard for detailed explanation about options in this wizard.
An example: The SampleComponents catalog, included with JReport Designer, contains reports that
have examples of report layout types. For the banded report layout example, open <install_root>
\Demo\Reports\SampleComponents\BandedObjectReport.cls.
2. In the dialog, specify the title of the report, select the required table type: Group Above, Group
Left, Group Left Above, or Summary Table, then click OK. The Table Wizard will then be displayed.
3. In the Data screen of the wizard, specify the dataset on which the table will be built.
To build the table on a new dataset created from the catalog resources, check the New radio
button, and then select the data source of the dataset. If the given data resources are not what
you want, click the <Add xxx...> item to create one. In addition, if you choose to create the
dataset from a query, you can click the Modify button to further modify the query if required.
To build the table on an existing dataset in the report set, check the Existing radio button, and
then select the dataset as required (click the Modify button to modify the selected dataset if
necessary). You can also click the <Add Dataset...> item to create one as required.
Note: When you want to create a table report on a hierarchical data source, pay attention to
the unique features of HDS. For details, refer to Developing reports from HDS.
4. In the Display screen, add the required fields from the Resources panel to be displayed in the
table. Modify the display name of any added field if necessary by double-clicking its Display Name
column. If required, click the Sort Fields By button to specify how to sort data in the table. And if
you want to hide these newly added fields in the table, check Hide Detail.
5. In the Group screen, add the fields as the grouping criteria, and then specify the sorting direction
of each group in the Sort column. If you want the columns created for the group by fields shown,
check Show Groups in Columns. And if necessary, check Combine Group Headers with
Detail Row to place all the group by fields in the detail row, or Combine Group Headers to
place them in the most inner group header row.
6. To add summaries, go to the Summary screen. In the sum on panel (the panel on the right),
specify the group to which the summary will be applied (if you select Table, the summary will be
based on the whole dataset), add a field from the Resources panel as the summary field, and then
select the function for the summary from the Aggregate Function column. From the Position and
Column columns, specify where to place the added sum on field in the table.
7. If you want to create a chart together with the table in the report body, go to the Chart screen.
Select the chart type you like. From the Category drop-down list, select the field you want to
display on the category (X) axis of the chart. You can choose from the group by fields of the table
on which some summaries are added. Choose the field to be displayed on the series (Z) axis of
the chart from the Series drop-down list, where all the group by fields of the table are listed. From
the Show Values drop-down list, select the field you want to display on the value (Y) axis of the
chart. You can choose from the summary fields which are calculated based on the field you specify
to display on the category axis of the chart.
8. In the Filter screen, define some filter conditions to filter the data displayed in the table.
To define a filter condition, click the Add Condition button to add a condition line, then from the
field drop-down list, select the field on which the filter will be based, set the operator with which to
compose the filter expression from the operator drop-down list, and in the value combo box, type
the value of how to filter the field or select the value from the drop-down list.
9. In the Style screen, specify the style of the table, and if required, click the Page Setup button to
set the page settings.
10. When done, click Finish to create the report.
See also:
An example: The SampleComponents catalog, included with JReport Designer, contains reports that
have examples of report layout types. For the table report layout example, open <install_root>
\Demo\Reports\SampleComponents\TableReport.cls.
2. In the dialog, specify the title of the report, select the Chart Report layout and click OK. The
Chart Wizard will then be displayed.
3. In the Data screen of the wizard, specify the dataset on which the chart will be built.
To build the chart on a new dataset created from the catalog resources, check the New radio
button, and then select the data source of the dataset. If the given data resources are not what
you want, click the <Add xxx...> item to create one. In addition, if you choose to create the
dataset from a query, you can click the Modify button to further modify the query if required.
To build the chart on an existing dataset in the report set, check the Existing radio button, and
then select the dataset as required (click the Modify button to modify the selected dataset if
necessary). You can also click the <Add Dataset...> item to create one as required.
To create a single type chart, check the Single Type radio button, and select the required type
from the Chart Type box and its sub type accordingly.
To create a combo type chart, check the Combo Type radio button, and the click the <Add
Combo Type> item to add the required combo type to Primary Axis and Secondary Axis
respectively.
5. In the Display screen, add the required fields from the Resources panel to be displayed on the
category (X) axis, series (Z) axis, and value (Y) axis of the chart, and define some special group,
special function and Order/Select N condition on the category/series field if required.
6. To apply some filters to the chart so as to reduce the data displayed in the chart, go to the Filter
screen and define the filter conditions as required.
To define a filter condition, click the Add Condition button to add a condition line, then from the
field drop-down list, select the field on which the filter will be based, set the operator with which to
compose the filter expression from the operator drop-down list, and in the value combo box, type
the value of how to filter the field or select the value from the drop-down list.
7. In the Layout screen, with the Data category selected in the Options list box, you can specify the
category/series start and end offset, whether or not to reverse the category/series field value
sequence, and whether or not to swap groups. Besides, you can set whether or not to show the
titles, axes, walls, gridlines, and legend. If yes, set the titles for the chart, the category axis and
the value axis respectively. If you choose not to display a certain axis, the labels and tick marks
along the axis will be hidden as well.
8. In the Style screen, specify the style of the chart, and if required, click the Page Setup button to
When you want to create a chart report on a hierarchical data source, pay attention to the unique
features of HDS. For details, refer to Developing reports from HDS.
If you specify to create a pie chart, you can add several fields to be displayed on the value axis of
the chart as long as the fields are of Numeric type. However, you can add formulas and DBFields to
the axis at the same time, but when a summary has been added to the axis, no other DBFields or
formulas can be added.
If you have defined a subtype of the Stock type, in the Display screen, you should add fields for the
subtype in the order indicated by the subtype name, e.g., if you define the Open-High-Low-Close 2-D
subtype, then you should add four fields to the Show Values box for this subtype, and arrange them
to the order of Open-High-Low-Close by clicking the buttons
and
See also:
An example: The SampleComponents catalog, included with JReport Designer, contains reports that
have examples of report layout types. For the chart report layout example, open <install_root>
\Demo\Reports\SampleComponents\Chart.cls.
2. In the dialog, specify the title of the report, select the Crosstab layout and click OK. The Crosstab
Wizard will then be displayed.
3. In the Data screen of the wizard, specify the dataset on which the crosstab will be built.
To build the crosstab on a new dataset created from the catalog resources, check the New radio
button, and then select the data source of the dataset. If the given data resources are not what
you want, click the <Add xxx...> item to create one. And if you choose to create the dataset
from a query, you can click the Modify button to further modify the query if required.
To build the crosstab on an existing dataset in the report set, check the Existing radio button,
and then select the dataset as required (click the Modify button to modify the selected dataset
if necessary). You can also click the <Add Dataset...> item to create one as required.
Note: When you want to create a crosstab report on a hierarchical data source, pay attention
to the unique features of HDS. For details, refer to Developing reports from HDS.
4. In the Display screen, add the required fields from the Resources box to the Columns and Rows
boxes respectively to make them displayed on the columns and rows of the crosstab. For the
added fields, you can specify their display names in the Label column which will label the rows and
columns (by default the Label column is blank and no label will be created for the rows and
columns), the background color in the Color column, set the sorting manner of the field values by
, and adjust their display order by clicking
or
. Then, add the fields as
clicking
aggregate fields to the Summaries box and specify the aggregate functions and labels for the
added fields as required. If necessary, click the Comparison Function button to set the
comparison function.
5. If you want to create a chart together with the crosstab in the report body, go to the Chart screen.
Select the chart type you like, from the Category and Series drop-down lists, where all the fields
that have been added to the columns and rows of the crosstab are listed, choose the fields to be
displayed on the category (X) axis and series (Z) axis of the chart, then select the field you want
to display on the value (Y) axis of the chart from the Show Values drop-down list, you can choose
from all the aggregate fields in the crosstab.
6. To apply some filters to the crosstab so as to reduce data displayed in the crosstab, go to the
Filter screen and define the filter conditions as required.
To define a filter condition, click the Add Condition button to add a condition line, then from the
field drop-down list, select the field on which the filter will be based, set the operator with which to
compose the filter expression from the operator drop-down list, and in the value combo box, type
the value of how to filter the field or select the value from the drop-down list.
An example: The SampleComponents catalog, included with JReport Designer, contains reports that
have examples of report layout types. For the crosstab report layout example, open <install_root>
\Demo\Reports\SampleComponents\Crosstab.cls.
2. Specify the title of the report and select the Tabular layout, then click OK.
3. In the Tabular Wizard, specify the number of rows and columns, and the border width and tabular
width according to your requirements.
4. Click Finish to create the report.
When a tabular report is created, you can then insert components and texts into the tabular cells as
required, and their layout will be controlled by the cells. A tabular report helps you better design the
report page. For details about how to work with tabulars, refer to Tabulars.
2. Specify the title of the report, select the Blank Report layout and click OK.
3. In the Choose Data dialog, specify the dataset on which the report will be built.
To build the report on a new dataset created from the catalog resources, check the New radio
button, and then select the data source of the dataset. If the given resources are not what you
want, click the <Add xxx...> item to create one. And if you choose to create the dataset from a
query, you can click the Modify button to further modify the query if required.
To build the report on an existing dataset in the report set, check the Existing radio button, and
then select the dataset as required (click the Modify button to modify the selected dataset if
necessary). You can also click the <Add Dataset...> item to create one as required.
4. When done, click OK and a blank report will then be created. You can then insert the required
objects into the report as described in the Components chapter.
Page panel
Page settings
Page break
Page mode
Page panel
A page panel is a template to design a page. You can define information for it and meanwhile
information for pages designed with this page panel will be defined accordingly. Here, information
covers all factors of a page, including page size, margin, and orientation. Also, you can define the page
headers and page footers for a page panel. By default, a page panel has only one page header and
page footer, but you can also set more and remove them according to your requirements.
In addition, JReport Designer also supports multiple page panels. With multiple page panels, you have
to define each page panel's page settings individually.
Page panels can be inserted into banded reports which satisfies the following conditions:
Page settings
Settings for a page are the same as with a page panel which is used as a template to design this page.
All pages designed with the same page panel will apply the same page settings. So, you just need to
set the settings for a page panel to apply them to these pages.
2. Set properties of paper, orientation and margin for the current page. You can also click Set
Default to apply the default values for each option.
3. Click OK to apply your settings.
Page break
A new page will be generated in a report only when the space in a page has been fully occupied or
there exists a break control in this page, for example, a page break that is inserted in the page.
To insert a page break, Click Insert > Page Break.
Notes:
Page breaks can be inserted into banded objects only when the following conditions have been met:
Page mode
In JReport Designer, you can set the page mode of a report: pagination mode and continuous mode.
This section describes these two page modes and how to switch between them.
Pagination mode
In pagination mode, the page shape and size can be specified in the page panel settings. Once set, the
contents of the report will be laid out according to these specifications. If the contents exceed the
specified size, the page break control will start a new page with the same size.
In addition, the total page size is determined both by the contents' size and by the page breaking
control, such as Fill Whole Page, On New Page, Page Breaker.
Continuous mode
In continuous page mode, only the component breaking control will work. The whole report is laid out
in a single page, and has no specific shape and size. If no component breaking control has been set, all
of the components will be laid out in the same page, and the size of the page will depend on the size of
the contents.
In addition, all of the properties set in pagination mode will be simply skipped, including the page
breakers in page panel. In this way, if there is more than one page panel in a report, all contents
contained in different page panels will be laid out in the same page, and only the first page panel's
page header and footer will be laid out.
Component breaking rule
In continuous page mode, JReport Designer provides you with an option for breaking a component in
continuous page mode. This kind of breaking is not based on space, but on logic. For example, you can
set a group break to occur every 20 detail sections, no matter how big these 20 detail sections are.
The following three components have logic break functionality: banded object, table and crosstab:
For banded objects, the logic break acts only on the sub-components - detail panel and group panel.
For tables, the logic break acts only on the sub-components - table detail and table group.
For banded objects and tables, there are two relative properties: Current Block Index and Items per
Block.
For crosstabs, besides the two properties mentioned above, there are also four extra properties:
Current Row Block Index, Current Column Block Index, Items per Row Block and Items per Column
Block.
To switch between the two page modes, you can choose either of the following ways:
Editing a report
After a report is built up, you can make further modifications to the report, in order to make it better
satisfy your requirements. In JReport, to edit a report is actually to edit the components in it. This
section only lists the basic operations used for editing a report. For more details, you can refer to the
specific section of each component in the chapter Components.
Note: The other way to edit a report is by changing its properties in the Report Inspector. For detailed
property descriptions, see Properties in the Report Inspector.
In the Report Inspector, select the node which represents the component and press the Delete
button on your keyboard.
In the design area, right-click the component and select Delete from the shortcut menu.
Previewing a report
In the process of designing a report, you can preview the report at any time in the following two ways:
Moreover, if a report is developed with National Language Support, when you preview it, you can
specify the language in which you want the report to display.
Dynamic sort
You can sort the records in a banded object dynamically in the View area. To do this:
1. Point to the field you want to sort.
2. Right-click the field and select the option Sort Ascending or Sort Descending from the shortcut
menu.
Drill-down
You can drill down on aggregate level fields in a banded object. Drill-down is made possible where
there is a summary for a group. For example, if a banded object has been grouped by Customer
Region, and the group summary is on Annual Sales. When previewing the banded object, if you point
the mouse at the total annual sales for a region, it will turn into a small hand. Click on the total, and
the drill-down report for the selected region will be displayed.
By default, in cases like the above, JReport's convention is to hide the detail panel of each group and
only show it in a drill-down report. To do this, select the detail panel, and go to the Report Inspector.
Set its Invisible property to true. Then view the banded object again, and it will be shown without
details.
Note: After some modifications in the design area, if you find the report is shown very quickly and the
changes are not applied in view mode, this means you need to click the Refresh Data button
the toolbar to re-run your report.
on
On the View menu, select the specific format from the Preview As submenu.
Click the Preview As button
drop-down list.
on the Standard toolbar and select the required item from the
On the File menu, select Export To and select the format you want to use.
By selecting one of the formats in the View > Preview As menu, the report will be exported to a
temporary file which will automatically be opened in the format with the appropriate application. The
temporary file will be removed when you exit JReport Designer.
By selecting one of the formats in the File > Export To menu, the report will be exported to a file in the
same directory as the catalog but will not be opened automatically. The exported file can be used to
email or share with other members of your team for review purposes and will not be removed
automatically.
Notes:
The function of previewing a report in DHTML is enabled only if you have checked the option Server
for previewing reports in DHTML or Studio when installing JReport Designer.
The preview server is a web ad hoc disabled server, and it supports only one user and one report set
concurrently.
JReport Designer and the preview server are running in two separated JVMs. The preview server
applies -Djreport.url.encoding=UTF-8 in the startup batch file and this setting covers URL
encoding/decoding. Therefore, when you preview a report in DHTML format, if the name of the report
or its report set or catalog file contains non-Latin characters, you need add -Djreport.url.
encoding=UTF-8 into the startup batch file of JReport Designer as well; otherwise the preview will fail.
When previewing a report in DHTML format,
Make sure the JDBC driver's class path has been appended to setenv.bat/setenv.sh in
<install_root>\server\bin.
If the report contains some user defined objects (UDO), to have them work correctly in the preview
server, you need to compile your Java files again using report.jar and JREngine.jar in the
<install_root>\server\lib directory, modify the udo.ini file in <install_root>\server\lib and
append the classes to the class path of JRServer.bat in <install_root>\server\bin. For details,
see Creating a UDO manually.
If the report contains some user defined data sources (UDS) or user defined formulas (UDF), you
can use the classes you have compiled for using in Designer, but remember to append the classes
to the class path of JRServer.bat in <install_root>\server\bin.
Suppress all useless panels in a banded object, such as Group Header and Footer panels which are
not adding values to the report.
To do this, select the panel, go to the Report Inspector, and then change the property Suppress to
true.
This is more efficient than hiding the panel.
Set the precision (length) of DBFields or record level formulas to the size of the maximum value you
need to display in the report. Make them larger than necessary wastes resources.
To do this:
1. Make sure the option Forbid editing data object properties is unchecked in the Catalog category
of the Options dialog.
2. Go to the Catalog Browser, expand the Properties sheet.
3. Select the DBField or record level formula, then change the Precision property to an appropriate
value.
You can improve the report performance by setting the data buffer size to a larger value.
By default, the size of data buffer is 2MB. When data exceeds the default size, data will be written to
disk, which will slow down the report processing. JReport Designer enables you to set data buffer size
by specifying two properties of a dataset or subreport in the Report Inspector: Records per Page and
Max Page Number. For details, see Data Buffer.
When running a report to the Delimited Format (such as the CSV format) on JReport Server, the
property Fast Pass can help you speed up the generation process. Setting Fast Pass to true will
enable you to specify the position of the object you want to display in the result file, thus JReport will
not calculate the position for every object during the generation process.
To use this method:
1. In the Report Inspector, select the node that represents the report and set the properties Fast
Pass and Columned to true.
2. For each DBField or label, set the exact coordinate using the properties Column Index and Row
Index.
For example, set the properties Column Index=0 and Row Index=2 for a DBField, JReport
Designer will put this DBField into the first column and the third row in the generated Text file.
3. Set the property engine.single_thread=false in the file server.propertise in
<server_install_root>\bin. This enables the property Fast Pass to take effect when running
the report to the Delimited Format.
Cache Section.
The Cache Section property is used to cache the objects in the Detail panel of a banded object
instead of creating them repeatedly. You can set Cache Section in the Report Inspector to true to
improve the performance.
Note: Cache Section doesn't work if there is crosstab, text object, chart, etc. in the Detail panel
of the banded object, because these objects contain child-DBFields.
Datasets
A dataset is the set of data built from the result of a query, and can optionally have filters applied to it.
A dataset contains not only DBFields, but also any formulas, summaries, and parameters that use the
DBFields.
A dataset has a name, which by default is the name of the resource on which it is created. You can
view items in a dataset by choosing the Dataset View mode from the toolbar of the Resource View
panel.
When you create a report or a data component, you specify whether a new dataset is created for it or
an existing one is used. Having components and reports use an existing dataset whenever possible will
have a dramatic effect on the performance of your reports in the runtime environment. This is because
each dataset is created by running a query against the database, and that is the most expensive part
of running a report in terms of execution time.
This chapter describes the following topics related to datasets:
Creating a dataset
Managing datasets
Creating a dataset
The dataset is created automatically when a query is created and mapped to a report. You can also
create a dataset independently, and then use it on a report later. This section describes the ways to
create a dataset as follows:
If you specify to create the report in one of the following layouts: Standard Banded Report, Table
Report, Chart Report, Crosstab Report, Horizontal Banded Report or Mailing Label Report, in the Data
screen of the corresponding report wizard:
Check the New radio button and specify the source on which the dataset will be created. Then,
If you go on to the next screens of the report wizard and select some data fields to display in the
report, the dataset will contain the selected data fields.
Check the Existing radio button and click <Add Dataset...> in the dataset tree. In the New
Dataset dialog, specify the source on which the dataset will be created, give a name for it, then
click OK to create the dataset.
If you click Finish directly in the report wizard, an empty dataset will be created.
If you click Finish directly in the report wizard, the dataset will be empty.
If you go on to the next screens of the report wizard and select some data fields to display in the
report, the dataset will contain the selected data fields.
If you choose to create a blank report, you will be prompted with the Choose Data dialog to specify a
dataset for the report.
Check the New radio button and specify the source on which the dataset will be created. Then click
OK, and an empty dataset will be created.
Check the Existing radio button and click <Add Dataset...> in the dataset tree. In the New
Dataset dialog, specify the source on which the dataset will be created, give a name for it, then
click OK. An empty dataset will be created.
Managing datasets
After you have created some datasets in a report set, you can manage them according to your
requirements, for example, you can add data fields to a dataset or filter the dataset. To do this, click
Report > Dataset Management on the menu bar, and the Dataset Management dialog will be
displayed, in which you can manage your datasets as required.
You can add additional data fields to a dataset, as long as they come from the source on which the
dataset is created. To do this:
1. In the Dataset List box of the Dataset Management dialog, select the dataset to which you want to
add data fields.
2. From the Available Resource box of the Data tab, select the required data fields and then click
to add them to the dataset.
3. When done, click OK to apply the changes and close the dialog box.
Optimizing a dataset
You can enlarge or decrease the scope of retrieved data for a dataset, and therefore make a
balanceable decision between better performance and special usage cases/demands. To do this:
1. In the Dataset List box of the Dataset Management dialog, select the dataset with the name you
want to optimize.
2. Click the Optimize Dataset button.
3. In the Optimize Dataset dialog, choose a retrieved data scope for the dataset.
Renaming a dataset
1. In the Dataset List box of the Dataset Management dialog, select the dataset with the name you
want to modify.
2. Double-click the Name cell of the dataset.
3. Input a new name in the cell and press Enter to apply the changes.
Note: You are not recommended to rename a dataset that has been used by other components
randomly. Renaming a referenced dataset may cause reports which contain components based on the
dataset not to work.
Removing a dataset
After you have created one or more datasets in a report set, you can choose to remove them if they
are no longer required for the report set. To do this:
1. In the Dataset List box of the Dataset Management dialog, specify the dataset you want to
remove.
2. Click the Remove button to remove the specified dataset.
3. When done, click OK to apply the changes and close the dialog.
Note: If you remove a dataset directly in this way, any data containers created based on the dataset
will not work. So, when you want to remove a dataset, it is recommended that you first remove the
data containers which reference this dataset.
See also Dataset Management dialog for details about options in the dialog.
Components
Components are the objects that you can place in a report. JReport provides a full set of components that
allow you to present and control the report data and presentation in a wide variety of ways.
Component categories
Components in JReport can be classified as follows:
JReport components: labels, text boxes, images, barcodes, ranks, tables, horizontal table, crosstabs,
charts, tabulars, banded objects, subreports, UDOs, maps
Fields: DBFields, formula fields, summary fields, parameter fields
Web controls: form, text field, password, text area, checkbox, radio button, image button, button,
drop-down list, list, expand/collapse group, parameter control, parameter form control, filter control,
navigation control
Multimedia objects: applets, flash files, real media files, windows media files
Special fields: Print Date, Print Time, Fetch Date, Fetch Time, Record Number and many more.
Component placement
Components can be placed within banded objects or some other components, as well as onto an empty
area of a report. JReport Designer indicates whether or not the target location is valid for the component.
The following tables lists the report areas that are valid targets for the various components, listed on the
left.
Report layout areas and the components they can contain
Report Layout Area
Banded
Object
BH
panel
Banded
Object
BPH
panel
Banded
Banded
Object
Object
BPF
DT panel
panel
Banded
Banded
Object
Object
GH
BF panel
panel
Banded
Text
Object
Box
GF panel
Table
Cell
Tabular
Cell
Page
Header/
Footer
Panel
Banded
object
Chart
Component
Crosstab
Table
DBField
Parameter
field
Summary
field
Formula field
Special field
Label
Tabular
Image
Text box
Multimedia
object
Drawing
object
Subreport
Map
UDO
Form
Web control
Barcode
Barcode and rank components can be inserted in a report layout area that is valid for the component on which the
barcode or rank is based. For example, a rank component that represents a DBField is allowed in the report layout
areas in which a DBField component is allowed.
Rank
Labels
DBFields
Formula fields
Summary fields
Parameter fields
Special fields
Text boxes
Tables
Banded objects
Crosstabs
Charts
Tabulars
Subreports
Images
Maps
UDOs
Barcodes
Ranks
Drawing objects
Web controls
Multimedia objects
Labels
A label is an object that contains a string. It is typically a brief description used to identify a field or
other value nearby. In JReport, the display type of a label can be changed, that is you can map the
string to another value or image to be displayed instead.
The following tasks related to labels are described in this section:
Inserting a label
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how each component type could be used in a report. For the label component
example, open <install_root>\Demo\Reports\SampleComponents\ForLabel.cls.
Inserting a label
Labels can be inserted in the report areas listed in Component placement.
You can use either of the following methods to insert a label:
A label with the default text "Label" is inserted. Now, you can customize its appearance and
behavior by setting properties in the Report Inspector, which can be saved as a CSS style for future
use (for details, see Creating a CSS style).
To change the alignment of a label, click the required alignment button: Justify
Center
. The text in the label will then be aligned according to your selection.
or Right
, Left
and Underline
To change the background color of the label, click the Background Color button
foreground color of the label text, click the Font Color button
; to change the
A Report
If you create a link to a report, when viewing the result, you can view another report by clicking
the label (for details, see Linking a report to another report).
Master/Detail Report
If you create a link to a detail report, when viewing the result, you can view the detail report by
clicking the label (for details, see Linking a report to a detail report).
A URL
to select a field which contains URL information or
Enter the link in the Hyperlink box, or click
create a formula to represent a URL to set the hyperlink, and then specify the frame from the
Target Frame drop-down list.
An E-mail
You can use the text boxes and drop-down list to compose e-mail address. For example, a field
"Company" contains company information such as "Jinfonet", you can input "sales" in the first
text boxes, select "Company" from the drop-down list, and input ".com" in the second text box.
With this, you can click the label at runtime so as to write an e-mail to the corresponding
recipient. You can also type "[email protected]" into the first text box and leave the dropdown list and the second text box empty, and thus clicking the label (or any field value) will
write an e-mail to the specific address. For studio reports, enter the address in the text box.
As text
As image
As barcode
As rank
Note: The display type of a label can also be changed to a web control, including text field, hidden
field, text area, checkbox, radio button, image button, and button. A label cannot be displayed as list or
drop-down list. For details about how to make settings of these display types, see Using basic web
controls.
As text
To define the display type of a label as text, follow the steps below:
1. Right-click the label and select Display Type from the shortcut menu to open the Display Type
dialog.
2. In the Display As box, select Text.
3. In the Tool Tip field, enter the tip you want to show for the text. Then after the report is exported
to HTML or DHTML, when you hover the mouse over the text, the tooltip will be displayed.
If you want to use a formula to control the tip, click
and select a formula from the drop-down
list. You can also click the <CREATE FORMULA> item in the list to create one as required.
4. Bind some web actions to the label in the Web Behaviors box (for details, see Applying web
actions).
5. Upon finishing, click the OK button to close the dialog.
Note: If you have specified a tooltip for the text, when the report is opened in HTML or DHTML format,
the tooltip will be displayed differently on different browsers:
On Internet Explorer, the tip text will be automatically wrapped if its length exceeds the maximal tip
width the browser allows. In addition, for Internet Explorer, you can manually make some text
displayed in a new line by adding 
 or 
 ahead of the text when editing it in the Tool Tip field.
On Firefox, the tip text will be displayed in one line with the maximal tip width the browser allows,
and the text that cannot be displayed within the width will be cut off and replaced by ellipsis.
As image
To define the display type of a label as image, follow the steps below:
1. Right-click the label and select Display Type from the shortcut menu to open the Display Type dialog.
2. In the Display As box, select Image.
3. In the Web Options panel, click the Browse button to specify the image source.
For a DBField, formula, or a summary, you can also check the From DBField radio button to make the
value of the DBField/formula/summary the image source. If you choose this option, the Decode Type
drop-down list is enabled, from which you can specify the type for decoding the image.
4. Type the name of the image in the Name field.
5. Type a string in the Alternate Text field to serve as content when the image cannot be displayed.
6. In the Tool Tip field, enter the tip you want to show for the image. Then after the report is exported to
HTML or DHTML, when you hover the mouse over the image, the tooltip will be displayed.
7. Specify the scaling mode of the image from the Scaling Mode drop-down list, and the maximum scaling
ratio in the Max Ratio field. By default the scaling ratio of the image is not limited.
The following are the available scaling modes:
actual size - If selected, the image will be shown in its actual size.
fit width - If selected, the image will be scaled to fit the width of the image viewer.
fit height - If selected, the image will be scaled to fit the height of the image viewer.
customize - If selected, the image will be scaled according to the width and height that you specify in
the Width and Height box.
If you choose to use the original size of the image, check the Original Size option.
If you want to use customized image size, uncheck Original Size, and then set the display width and
height of the image in the Width and Height fields. Check the Constrain Proportion option if you want
to constrain aspect ratio of the image when setting the width and height.
0 - No rotation.
10. Bind some web actions to the label in the Web Behaviors box (for details, see Applying web actions).
11. Upon finishing, click the OK button to close the dialog.
Notes:
The source, tooltip, name and alternate text of the image can be controlled by formula. To do this, click the
next to the text field and select a formula from the drop-down list. You can also click the
formula button
<CREATE FORMULA> item in the list to create one as required.
If you have specified a tooltip for the image, when the report is opened in HTML or DHTML format, the
tooltip will be displayed differently on different browsers:
On Internet Explorer, the tip text will be automatically wrapped if its length exceeds the maximal tip width
the browser allows. In addition, for Internet Explorer, you can manually make some text displayed in a
new line by adding 
 or 
 ahead of the text when editing it in the Tool Tip field.
On Firefox, the tip text will be displayed in one line with the maximal tip width the browser allows, and the
text that cannot be displayed within the width will be cut off and replaced by ellipsis.
When you rotate an image, the rectangle that holds the image maintains its original size, which may result
in that the image exceeds the field border and therefore the parts that extends outside of the border will be
cut off.
As barcode
To define the display type of a label as barcode, follow the steps below:
1. Right-click the label and select Display Type from the shortcut menu to open the Display Type dialog.
2. In the Display As box, select Barcode.
3. In the Web Options panel, select the required barcode type from the Symbology drop-down list. You can
preview the format of the selected symbology in the Preview box (for details about the different
symbologies of barcodes, see Appendix 2: Barcode symbologies).
4. In the Tool Tip field, enter the tip you want to show for the barcode. Then after the report is exported to
HTML or DHTML, when you hover the mouse over the barcode, the tooltip will be displayed.
and select a formula from the drop-down list. You
If you want to use a formula to control the tip, click
can also click the <CREATE FORMULA> item in the list to create one as required.
5. From the Scale Mode drop-down list, select the unit for the values of Quiet Zone, Narrow Width,
If you have specified a tooltip for the barcode, when the report is opened in HTML or DHTML format, the
tooltip will be displayed differently on different browsers:
On Internet Explorer, the tip text will be automatically wrapped if its length exceeds the maximal tip width
the browser allows. In addition, for Internet Explorer, you can manually make some text displayed in a
new line by adding 
 or 
 ahead of the text when editing it in the Tool Tip field.
On Firefox, the tip text will be displayed in one line with the maximal tip width the browser allows, and the
text that cannot be displayed within the width will be cut off and replaced by ellipsis.
As rank
To define the display type of a label as rank, follow the steps below:
1. Right-click the label and select Display Type from the shortcut menu to open the Display Type dialog.
2. In the Display As box, select Rank.
3. In the Options panel, click the Browse button to select an image file to be the default image (used if a
value does not fit any of the specified value ranges).
4. Type a string in the Default Image Alternate Text field. The string will be displayed when the default
image cannot be loaded or is unavailable.
5. In the Default Tool Tip field, enter the tip you want to show for the default image. Then after the report is
exported to HTML or DHTML, when you hover the mouse over the image, the tooltip will be displayed.
6. Specify the rotation degree of the default image in the Default Image Rotation field.
0 - No rotation.
7. In the Value Range box, specify different ranges according to your requirements. For each value range,
you should specify the minimum value, maximum value, image, alternate text, tooltip and rotation. A
value, which is larger than or equal to the minimum value of a range and less than the maximum value,
will be displayed as the image, or the alternate text if the image cannot be loaded or is unavailable. For a
value belonging to two or more overlapping ranges, the highest range in the Value Range box will apply.
Click
or
or
8. Bind some web actions to the label in the Web Behaviors box (for details, see Applying web actions).
9. Upon finishing, click the OK button to close this dialog.
Notes:
Ranks can also be used as component and inserted into a report directly. For details, refer to the section
Ranks.
If you have specified a tooltip for the rank image, when the report is opened in HTML or DHTML format, the
tooltip will be displayed differently on different browsers:
On Internet Explorer, the tip text will be automatically wrapped if its length exceeds the maximal tip width
the browser allows. In addition, for Internet Explorer, you can manually make some text displayed in a
new line by adding 
 or 
 ahead of the text when editing it in the Tool Tip field.
On Firefox, the tip text will be displayed in one line with the maximal tip width the browser allows, and the
text that cannot be displayed within the width will be cut off and replaced by ellipsis.
When you rotate an image, the rectangle that holds the image maintains its original size, which may result
in that the image exceeds the field border and therefore the parts that extends outside of the border will be
cut off.
DBFields
DBFields, or database fields, are fields directly from databases, user data sources, hierarchical data sources, or
XML data sources.
Using dialog
1. Position the mouse pointer at the destination where you want to insert the DBField and do one of the
following:
2. Select a dataset from the dataset drop-down list, and all resources in the selected dataset will then be
listed in the DBField List box.
3. Select the required DBField and specify its layout in the Insert Layout box.
4. Click the Insert button to insert the DBField into the destination.
When a DBField has been inserted into a report, you can customize its appearance and behavior by setting
properties in the Report Inspector, which can be saved as a CSS style for future use (for details, see Creating
a CSS style).
Notes:
To insert more than one DBField with the Insert Field dialog, you can select them one by one with the Ctrl
key, or you can make a continuous selection with the Shift key.
You cannot use the Insert Fields dialog to insert a DBField into a crosstab.
If you insert a DBField into the detail panel of a banded object or table, the name of the DBField will
automatically be inserted as a label into the corresponding header panel. Otherwise the field and its name
label will be placed in the same panel. If you do not want to insert the field name automatically, you can
uncheck Insert field name label with field in the Options dialog (File > Options > Component > Insert
field name label with field).
Right-click the DBField and select Conditional Formatting from the shortcut menu.
See an example: The SampleComponents catalog, included with JReport Designer, contains reports that have
examples of how each component type could be used in a report. For the DBField component example, open
<install_root>\Demo\Reports\SampleComponents\ForDBField.cls.
Formula fields
Formula fields are calculated from DBFields, other formulas, summaries, and parameters, so they can
present information that DBFields cannot do.
Using dialog
1. Position the mouse pointer at the destination where you want to insert the formula and do one
of the following:
2. Select the required formula from the Formulas node, then specify its layout in the Insert Layout
box.
3. Click the Insert button to insert the formula into the destination.
When a formula field has been inserted into a report, you can customize its appearance and
behavior by setting properties in the Report Inspector, which can be saved as a CSS style for future
use (for details, see Creating a CSS style).
Notes:
No matter which way you take, if the given formulas are not what your want, you can click the <Add
Formula...> item to create one as required.
If you insert a formula into the detail panel of a component, the name of the formula will
automatically be inserted as a label into the corresponding header panel. Otherwise the formula and
its name label will be placed in the same panel. If you do not want to insert the name label
automatically, you can uncheck Insert field name label with field in the Options dialog (File >
Options > Component > Insert field name label with field).
The display type of a formula field can be changed, that is to say, you can map the formula field to
another value or image to be displayed instead.
To change the display type a formula field:
1. Right-click the formula field and select Display Type from the shortcut menu.
2. In the Display Type dialog, specify the required display type in the Type box, and set the options
for the selected type in the Option panel.
3. Upon finishing, click the OK button to close the dialog.
For details about display types, see Changing the display type of a label.
to add a condition.
3. Set the format that will be applied to the field values when the specified condition is fulfilled.
4. Repeat the above two steps to add more conditions and define the format for each condition.
5. When done, click OK to save the settings.
For more details about conditional formatting, see Adding conditional formats to a DBField.
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how each component type could be used in a report. For the formula field
example, open <install_root>\Demo\Reports\SampleComponents\UsingFormula.cls.
Summary fields
A summary is a special kind of formula. A summary generates a count, average, sum, standard
deviation or other transformation of a set of data values. A summary applies to a defined group of data.
Using dialog
1. Select the DBField in the report to which you want the summary to be applied.
2. Do one of the following:
Right-click the DBField and select Summary Function from the shortcut menu.
3. From the Function drop-down list, specify the function of the summary.
4. If the report is grouped, select to which group level the summary will be applied from the Group
By drop-down list. If None is select, the summary will be added based on the whole report.
5. Click the Insert button to insert the summary into the destination.
When a summary field has been inserted into a report, you can customize its appearance and
behavior by setting properties in the Report Inspector, which can be saved as a CSS style for future
use (for details, see Creating a CSS style).
Notes:
Summary fields can only be inserted into the header/footer/detail panel of a banded object or cells in
the header/footer/detail panel of a table. However, if you have specified a group by field when
creating the summary, it can be inserted into the corresponding group panels.
If you insert a summary into the detail panel of a component, the name of the summary will
automatically be inserted as a label into the corresponding header panel. Otherwise the summary
and its name label will be placed in the same panel. If you do not want to insert the name label
automatically, you can uncheck Insert field name label with field in the Options dialog (File >
Options > Component > Insert field name label with field).
to add a condition.
3. Set the format that will be applied to the field values when the specified condition is fulfilled.
4. Repeat the above two steps to add more conditions and define the format for each condition.
Parameter fields
A parameter in JReport is a variable whose value is determined at runtime. The runtime parameters
help you dynamically control your report results.
Using dialog
1. Position the mouse pointer at the destination where you want to insert the parameter and do
one of the following:
2. Select the required parameter from the Parameters node, then specify its layout in the Insert
Layout box.
3. Click the Insert button to insert the parameter into the destination.
When a parameter field has been inserted into a report, you can customize its appearance and
behavior by setting properties in the Report Inspector, which can be saved as a CSS style for future
use (for details, see Creating a CSS style).
Notes:
No matter which way you take, if the given parameters are not what your want, click the <Add
Parameter...> item to create one as required.
If you insert a parameter into the detail panel of a banded object or table, the name of the
parameter will automatically be inserted as a label into the corresponding header panel. Otherwise
the parameter and its name label will be placed in the same panel. If you do not want to insert the
name label automatically, you can uncheck Insert field name label with field in the Options dialog
(File > Options > Component > Insert field name label with field).
To change the display type of a parameter to list or drop-down list, select the item List or Dropdown List, and then in the Web Options panel, set the name and title. You may notice that a
default list item had been added, and its value is the parameter. If you check Use Runtime
Value, when running the report, you need to specify a value for the parameter, and then the
item same as the value will be selected in the list or drop-down list by default; if you uncheck
the option, the Selected text box will be enabled for you to input a value and the item same as
this value will be selected. For the List type, you can check Allow Multiple Selections to enable
more than one item selected.
For other display types, refer to Changing the display type of a label for details.
to add a condition.
3. Set the format that will be applied to the field values when the specified condition is fulfilled.
4. Repeat the above two steps to add more conditions and define the format for each condition.
5. When done, click OK to save the settings.
For more details about conditional formatting, see Adding conditional formats to a DBField.
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how each component type could be used in a report. For the parameter field
examples, open the following report sets: <install_root>\Demo\Reports\SampleComponents
\Parameter.cls, and <install_root>\Demo\Reports\SampleComponents\ParameterField.cls.
Special fields
Special fields are defined by JReport and allow you to easily obtain system information and reportrelated data and add it to your report. The special fields are as follows:
Print Date
Prints today's date (or the current date from your computer).
Print Time
Prints the current time from your computer.
Fetch Date
Prints the date when the data is retrieved from the database.
Fetch Time
Prints the time when the data is retrieved from the database.
Record Number
Prints the record number (usually placed in the Details panel).
Group Name
Prints the group name (usually placed in the Group Header/Footer panel).
Total Records
Prints the total number of records after all the filter conditions are performed, except the ones
created in the Filter dialog of JReport Viewer, and the Group Filter dialog and top N or bottom N
condition in JReport Designer.
Total Fetched Records
Prints the total number of records which take part in grouping calculation. The possible result of the
special field is as follows:
If you don't set any filter condition in the Filter dialog of JReport Viewer, print the very number of
the record obtained after setting the property Maximum Records.
If you set filter conditions in the Filter dialog of JReport Viewer, print the number of records
obtained after performing the filters, even though you have set the property Maximum Records
before setting the filters.
Group Number
Prints the group number (usually placed in the Group Header/Footer panel).
Total Group Number
Prints the total group number (usually placed in the Group Header/Footer panel).
Page Number
Prints the page number of the report which it is placed in.
Global Page Number
Prints the global page number of the whole report wherever it is placed.
Total Page Number
Prints the total page number of the report which it is placed in.
HDS
(General)
HDS (XML)
UDS
SQL File
User Name
Supported.
Supported in
the Parameter
box in the Add
General
Hierarchical
Data Source
dialog.
Supported.
Supported in
the Parameter
box in the Add
User Data
Source dialog.
Supported in
the SQL
statement.
User Name
used in a
formula
Supported.
Supported.
Supported.
Supported.
Supported.
Modified Date
Prints the last modified date of the catalog.
Modified Time
Prints the last modified time of the catalog.
Task ID
Prints the internal task ID (a unique time stamp). This special field only works in the JReport Server
environment. It returns a NULL value when running in JReport Designer.
Page N of M
Prints a specific page number out of the total page number of the report which the field is placed in.
You can specify the format of this special field. To do this, select this special field, then in the Report
Inspector, find the Format property and choose an item from the shortcut list. Besides the items
listed here, you can also customize the format. For example, if you want it displayed as "This is page
n of m pages", you can input the format string "This is page @PageNumber of @TotalPageNumber
pages" into the Format text box.
Global Page N of M
Prints a specific global page number out of the global total page number. You can specify the format
of this special field in the Report Inspector. The operation is the same as Page N of M.
Note: Page Number, Total Page Number and Page N of M in the following conditions in versions after
V8 are different from those in versions prior to V7:
In V7 and prior, the Page Number, Total Page Number and Page N of M which are placed in a
subreport will calculate the page number of the subreport if the value of the property Embed in a
subreport is set to true. And if you set Embed to false, the Page Number, Total Page Number and
Page N of M will work as global special fields, it will calculate the page number of the main report.
While in V8 and after, the Page Number, Total Page Number and Page N of M which are placed in a
subreport will calculate the page number of the subreport no matter you set the property Embed to
true or false.
Click Insert > Special Fields, and click the corresponding command on the submenu.
Click the down arrow on the Insert Special Field button
select the required special field from the drop-down list.
2. In the Display Type dialog, specify the required display type in the Type box and set the options
for the selected type in the Option panel.
3. Upon finishing, click the OK button to close the dialog.
For details about display types, see Changing the display type of a label.
to add a condition.
3. Set the format that will be applied to the field values when the specified condition is fulfilled.
4. Repeat the above two steps to add more conditions and define the format for each condition.
5. When done, click OK to save the settings.
For more details about conditional formatting, see Adding conditional formats to a DBField.
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how each component type could be used in a report. For the special field
example, open <install_root>\Demo\Reports\SampleComponents\ForSpecialFields.cls.
Text boxes
Similar to a word processing document, a text box is an object that holds text (a single character, a
single word, entire sentences, or paragraphs). Editing in a text box is just like working in a word
processor. You can cut, copy and paste selected text easily, and format the text as needed. In addition,
a text box can hold other components.
After a text box has been inserted into a report, you can double-click it to input text. You can also
customize its appearance and behavior by setting properties in the Report Inspector, which can be
saved as a CSS style for future use (for details, see Creating a CSS style).
To specify the alignment style of the paragraph, select the required option from the Alignment
drop-down list: left, center, right or justified.
To set the indentation formats of the paragraph, in the Indentation box, specify the left and
right indent distance in the Left and Right fields. If you want to set the paragraph to be
indented, select first line or hanging from the Special drop-down list, then input a number in
the By text box. This will create a first-line indent or hanging indent in the paragraph using the
inputted number as the indent distance.
To adjust the spacing before or after the paragraph, enter the required amount of spacing in the
Before or After field.
To change the spacing between the lines in the paragraph, select the required item from the
Line Spacing drop-down list. If at least, exactly or multiple is selected, enter the required
amount of space or the number of lines in the At box.
2. In the Import a File dialog, select the .txt or .rtf file you want to import and click OK.
The text of the file is inserted in the text box.
To export the text from a text box:
1. Position the mouse pointer on the text, right-click and select Save to RTF File.
2. In the Save RTF File dialog, specify the name of the file and click OK.
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how each component type could be used in a report. For the text box example,
open <install_root>\Demo\Reports\SampleComponents\ForTextBox.cls.
Tables
Tables give you great control over how to present data, including placing fields, grouping them, and
sorting them. A table is composed of rows and columns, and each contains several cells. With such a
structure a table is a good way to show any two-dimensional dataset.
In JReport, tables are data containers, which means that a table displays the results of a query and you
can apply some filters to narrow down the records displayed in it. Also, when a table is inserted into
another data container, you can set up data container link between the table and its parent.
Meanwhile, in order to meet the requirements from voice agents used by people with eyesight
disabilities, JReport supports exported table components in the HTML data table format to get a section
508 compliant result. For detailed descriptions, refer to Accessibility.
Pick a task from the following:
Inserting a table
Modifying a table
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how each component type could be used in a report. For the table component
example, open <install_root>\Demo\Reports\SampleComponents\TableReport.cls.
Inserting a table
To insert a table into a report, take the following steps:
1. Position the mouse pointer at the destination where you want to insert the table. A table can be
inserted in the report areas listed in Component placement.
2. Do one of the following:
3. In the Table Type dialog, choose a type for the table you want to insert and click OK. The Create
Table wizard is then displayed.
4. In the Data screen of the wizard,
If you are inserting a table into a normal report, define or select the dataset on which the table
will be created.
New
If checked, the table will be built on a new dataset created from the catalog resources.
Existing
If checked, specify the dataset in the current report set from which the table will be created.
Current
If checked, the table will be built on the dataset which is used by its parent.
If you are inserting a table into a studio report, select a business view in the current catalog on
which the table will be created.
5. In the Display screen, add the required fields from the Resources panel to be displayed in the
table. Modify the display name of any added field if required by double-clicking its Display Name
column. If required, click the Sort Fields By button to specify how to sort data in the table. And if
you want to hide these newly added fields in the table, check Hide Detail.
6. In the Group screen, add the fields as the grouping criteria, and then specify the sorting direction
of each group level in the Sort column. If you want the columns created for the group by fields
shown, check Show Groups in Columns. And if necessary, check Combine Group Headers
with Detail Row to place all the group by fields in the detail row, or Combine Group Headers
to place them in the most inner group header row.
7. To add summaries, go to the Summary screen. In the sum on panel (the panel on the right),
specify the group to which the summary will be applied (if you select Table, the summary will be
based on the whole dataset), add a field from the Resources panel as the sum on field, and then
select the function for the summary from the Aggregate Function column. From the Position and
Column columns, specify where to place the added sum on field in the table.
8. In the Filter screen, define some filter conditions to filter the data displayed in the table. If you are
inserting the table into a studio report, you can select a predefined filter of the specified business
view if there is from the Filter drop-down list to apply, or select User Defined in the list to define
a new filter.
9. In the Style screen, specify the style of the table as required.
If you have specified to insert the table into a banded object, by default the table will inherit its
parent's style. If you want to apply another style to the table, uncheck the Inherit Style option
and then select the required style from the Style box. For more information, see Inheriting the
style from a data container.
10. Click Finish to insert the table.
If you have used the menu or toolbar command to insert the table and specified to insert it to
position other than the report body or tabular cell, after clicking Finish in the wizard, you need to
click the mouse button in the destination once again in order to insert the table there.
After a table has been created, you can customize its appearance and behavior by setting properties in
the Report Inspector, which can be saved as a CSS style for future use (for details, see Creating a CSS
style).
Note:
When you want to create a table on a hierarchical data source, pay attention to the unique features
of HDS. For details, refer to Developing reports from HDS.
When you insert a table into a banded report with the dataset inherited from the banded report, you
can not insert the table into the BandedPageHeader and BandedPageFooter panel.
Modifying a table
Once a table has been created, you can further modify it by accessing its shortcut menu wizard which
is composed by a set of screens that are similar to the wizard screens used to create the table. For
example, you can change the data used by the table, apply some grouping, sorting criteria to the table,
and so on.
To modify a table after it has been created:
1. Right-click the table and select Table Wizard from the shortcut menu to display the Table Wizard.
2. In the Data screen, specify a new data source for the table if required.
3. In the Display screen, specify the fields you want to display in the table and how to sort records in
the table.
4. In the Group screen, specify the grouping criteria, and then the sorting direction of each group
level in the Sort column.
5. In the Style screen, select the style you want to apply to the table.
6. When done, click Finish to accept the changes.
See also Table Wizard for details about options in the wizard.
Notes:
Due to the specialty of hierarchical data sources, you are not allowed to specify an HDS as the new
dataset of the table.
In the Display screen, the newly added fields will be put to the end of the existing fields, and you
cannot re-adjust the order of the fields as you did when creating the table.
For a normal report, when you have specified a new dataset for the table, if there are existing fields
in the table that cannot match the new dataset, they will be marked with a red cross icon. You can
to select fields from the new dataset to replace them. Then when you
use the Replace button
finish the modification, the new dataset and fields you specify will be displayed in the table and those
remaining fields that cannot be matched to fields in the new dataset will be removed from the table
automatically.
For a studio report, if you specify a new business view for the table, the current table data will be
lost and when you finish editing, a new table will be created.
2. From the Function drop-down list, specify a function to summarize the field in the detail column.
3. Specify the Group By option.
If the table has groups and you want the summary to be applied on certain group level, check
Group By and select the corresponding group by field from the drop-down list below.
If you want the summary to be applied on the whole dataset, check Group By and do not select
any field from the drop-down list below.
If you want to create a dynamic summary, keep Group By unchecked. Then the summary will
be applied on every group level and the whole dataset at the same time.
Right-click the table and select Table Wizard from the shortcut menu.
3. Select the field from the Resources panel as the grouping criterion, and then click
to add it to the group by panel (the
panel on the right). And if the type of the group by field is Numeric/String/Date/Time, you can select a special function for the
field as required.
4. Set the sorting manner of groups at this group level in the Sort column.
Description
None
All the records that have the same field value will be displayed together as a
group.
Up to 5
Up to 10
Up to 50
Up to 100
Up to 500
Up to 1000
Up to 5000
Up to 10000
Description
None
All the records that have the same field value will be displayed together as a
group.
The records, of which the field values' first letter is the same, will be grouped
together.
The records, of which the field values' first two letters are the same, will be
grouped together.
The records, of which the field values' first three letters are the same, will be
grouped together.
The records, of which the field values' first four letters are the same, will be
grouped together.
The records, of which the field values' first five letters are the same, will be
grouped together.
The records, of which the field values' last letter is the same, will be grouped
together.
The records, of which the field values' last two letters are the same, will be
grouped together.
The records, of which the field values' last three letters are the same, will be
grouped together.
The records, of which the field values' last four letters are the same, will be
grouped together.
The records, of which the field values' last five letters are the same, will be
grouped together.
Description
None
All the records that have the same field value will be displayed together as a
group.
The records, of which the field values are in the same second, will be grouped
together.
The records, of which the field values are in the same minute, will be grouped
together.
The records, of which the field values are in the same hour, will be grouped
together.
The records, of which the field values are in the same day, will be grouped
together.
The records, of which the field values are in the same week, will be grouped
together.
The records, of which the field values are in the same bi-week, will be grouped
together.
The records, of which the field values are in the same half month, will be
grouped together.
The records, of which the field values are in the same month, will be grouped
together.
The records, of which the field values are in the same quarter, will be grouped
together.
The records, of which the field values are in the same half year, will be grouped
together.
The records, of which the field values are in the same year, will be grouped
together.
Customized function
In the special function list for all the above data types, there is an item called Customize. By selecting
this item, you can define special functions.
If you want to group the data by intervals, check the By Intervals radio button, then define the
interval in the Numerical Value text box.
If you want to group data by certain range, check the Within Range radio button, specify the
range in the Within text box and select how to apply the range: apply to increasing data or
decreasing data.
3. Check Keep values outside of the range in special group if you want to put values that do
not fall within the specified interval or range in a new group, then give a name for the group in
the Special Group Name text box.
4. Click OK to save the settings.
Note: When grouping Numeric typed data by intervals, JReport follows this rule: all values in
each range are >= the minimum value in the range and < the maximum value in the range, and
0 is the offset for the intervals.
For example, if you specify to group the following values by intervals of 5: -8, -6, -5, -3, -1, 0,
1, 3, 4, 5, 8, the results will be as below:
Ranges
Values
-10 to -5
-8, -6
-5 to 0
-5, -3, -1
0 to 5
0, 1, 3, 4
5 to 10
5, 8
from the drop-down list and then enter N in the text box. Note that the number of letters should
be an integer no larger than 255.
3. If you want to distinguish between uppercase and lowercase characters when grouping, check
Case sensitive when grouping; otherwise, check in which way you want to convert the group
names: Uppercase, Lowercase or No Conversion.
Note: If you check Case sensitive when grouping, No Conversion will be checked as the
default converting method.
Check Keep values outside of the range in special group if you want to put values that do not
fall within the specified interval in a new group, then give a name for the group in the Special Group
Name text box.
2. Specify the group intervals by inputting a value in the Time text box and then selecting the
required item from the drop-down list behind.
3. Define the offset with which you want to group the data.
By default, JReport takes 1/1/1970 00:00:00 as the offset. If you want to define the offset by
your own, check the Customized Value radio button and then click the calendar button to
choose the required offset.
4. Specify which day will be used as the first day of a week as required.
5. Check Keep values outside of the range in special group if you want to put values that do
not fall within the specified interval in a new group, then give a name for the group in the
Special Group Name text box.
6. Click OK to save the settings.
Ascend
Groups will be sorted in ascending order.
Descend
Groups will be sorted in descending order.
No Sort
Groups will be arranged in their original order.
Special Group
Selecting this item will bring out the User Defined Group dialog for you to define how to group your
information.
For example, if you place a field named Score for grouping which contains student scores that range
from 0 to 100, and you want to group the students in 5 ranks, namely rank A: 90~100, B: 80~89, C:
70~79, D: 60~69, and E: 0~59. You can set the following with the User Defined Group dialog.
Group Name
Operator
Operand
between
between
between
between
<=
59
There will be five groups in the order from A to E. If you want to change the order of the groups, you
can also do so via the User Defined Group dialog.
See also User Defined Group dialog for details about options in the dialog.
Sort Group By
Selecting this item will bring out the Sort Group By dialog for you to define how to sort the groups.
You can specify some fields in the dialog, then the groups will be sorted by the values of the first
record in each group on the related fields.
The following example shows how to sort groups by a specific field.
Suppose that you have created a table based on the query EmployeeInformation in the catalog file
SampleReports.cat as follows: added the fields Hire Date, Name, Home Phone and Salary to be
displayed in the table, set the field Employee Position as the group by field and Ascend as the sort
order, then applied the default style to the table.
Notes:
The Select N conditions for the whole object and each group are not mutually exclusive, so you can
set them individually.
If you use an Integer-typed parameter to define the Top/Bottom N condition dynamically at runtime,
you should make sure that the parameter has at least one default value that is larger than 0,
otherwise you will get exceptions when viewing the report.
2. Right-click the table and select Table Wizard from the shortcut menu.
3. In the Group screen of the Table Wizard, select the Table node in the group by panel, and then
click the Select N button.
4. In the Select N dialog, select Top from the Select N drop-down list and enter 2 in the combo box.
5. Click OK to go back to the Table Wizard.
6. Select the group by field Assigned Region in the group by panel and click the Select N button
again.
7. In the Select N dialog, select Top, enter 2, check the Other box and enter Others in the text field.
8. Click OK to close the Select N dialog, then click Finish in the Table Wizard to accept all settings.
You can find that the first 2 records in each group (the group Latin America has only one record)
have been retrieved, and then the first 2 groups (North America, and Latin America) are displayed,
with the records in the rest group combined into an additional Others group.
Example 1: Show groups where the lowest employee salary is less than 50000
1. Right-click the table and select Table Wizard from the shortcut menu.
2. In the Group screen of the Table Wizard, select the group by field Employee Position, the Group Filter button will then become
available. Click it to display the Group Filter dialog.
Function
Operator
Value
More
Unchecked
Min
Salary
Salary
<
50000
End
4. Click OK to close the dialog and then Finish in the Table Wizard to apply the settings.
5. View the report result. You will find that only the two groups Marketing and Sales Representative are displayed, while the group Vice
President that does not fit this condition is ignored.
Example 2: Show groups in which the highest-salary employee was hired before Jan. 1, 1989
In this example, you need to set the Group Filter dialog as below:
Logic
Function
Operator
Value
More
Unchecked
Max
Salary
Hire Date
<
1989-01-01
00:00:00.000
End
When you view the report result, you will find that this time only the group Vice President is displayed.
Example 3: Show groups where at least one "not highest" employee salary is larger than 50000
In this example, you need to set the Group Filter dialog as below:
Logic
Function
Operator
Value
More
Checked
Max
Salary
Salary
>
50000
End
When you view the report result, you will find that this time only the two groups Marketing and Vice President are displayed.
Notes:
In the Value field of the Group Filter dialog, you can input a constant or parameter.
For String type constants, you can type the string without quotation marks. For Date/Time type constants, you have to follow the Date/
Time format specified in the Date Format tab of the Get JDBC Connection Information dialog.
Ensure that the report result contains at least one record; otherwise JReport Designer will throw out an error message.
3. In the Create Parameter dialog, create a type-in parameter named GroupBy of String type (leave
the other settings to their default), then click OK.
4. Specify to group the report on the just created parameter GroupBy and use Ascend as the
sorting order.
5. Click Finish in the Table Wizard to accept the settings.
6. Click the View tab to view the report. You will then be prompted to specify the parameter value.
The parameter value drop-down list will show all available fields (including the DBFields in the
query EmployeeInformation and formulas which are related to these DBFields).
7. Select Employee Position from the value drop-down list and data in the table is then grouped by
positions of the employees.
To group the data by hire date or salary, the end user would need to select Hire Date or Salary
from the drop-down list.
Right-click the table and select Table Wizard from the shortcut menu.
2. In the Table Wizard, click the Display screen, then click the Sort Fields By button.
3. In the Sort Fields By dialog, select the field Hire Date as the sort by field from the Resources
panel and click
to add it to the sort by panel, select Ascend from the Sort column, then click
OK to accept the changes.
4. Click Finish in the Table Wizard to apply the settings.
5. View the table again and you will find that the records in each group are displayed in ascending
order by Hire Date.
7. Click Dynamic Sort in the sort order drop-down list of the Sort column.
8. In the Specify Sort Order for dialog, input SortBy Order, then click OK to close the dialog.
9. Click OK in the Sort Fields By dialog to accept the changes.
10. Click Finish in the Table Wizard to apply the settings.
11. View the report result. In the Enter Parameter Values dialog, select a field from the SortBy dropdown list and specify the sorting manner in the SortBy Order drop-down list.
Here, we choose Salary from the SortBy list and DESCENDING from the SortBy Order list. The
records within each group are displayed in descending order according to their salary values.
Resizing a column/row
You can take either of the following ways to resize columns/rows of a table:
To resize a column, drag the boundary on the right side of the column to the required width. If the boundary is not the rightmost one,
the column width will change, but the total width of the table will not change. If you want to change both the column width and the table
width, press the Shift button on the keyboard while dragging. To resize a row, drag the boundary below the row to the required height.
Both the row height and the table height will change. If you want to change just the row height, press the Shift button on the keyboard
while dragging the boundary, which is not the last boundary.
Select a table cell, right-click it and then click Row Height or Column Width to access the corresponding dialog. Type a value in the
dialog, click OK, and the height/width of the row/column in which the cell is located will then be changed according to your specification.
Inserting a row
1. Select a cell in the table, right-click it and then click Insert on the shortcut menu.
2. In the Insert dialog, specify where the row will be inserted, above or below the selected cell.
3. Click OK. A new row will then be inserted into the table according to your selection.
Inserting a column
A table can have the following types of column: common column, summary column, detail common and group common. You can insert any
type of column into a table as you want.
To insert a common column:
Select a cell in the table, right-click it and click Insert on the shortcut menu. In the Insert dialog, specify where the column will be
inserted, before or after the selected cell, then click OK. A new common column will then be inserted into the table in the position you
specify.
Select a column in the table, right-click it, then on the shortcut menu, click Insert > Common Column. A new common column will
then be inserted before the selected column.
Select the table, right-click it, then on the shortcut menu, click Insert > Common Column. A new common column will then be
inserted as the last column in the table.
2. In the Resources panel, select the field you want to use for the new group column and click
to add it as the group by field, then
specify the sorting direction of the newly added group in the Sort column, and if the type of the added field is Numeric/String/Date/
Time, select a special function for the field from the Special Function column as required (for details, see group the data).
3. Specify the position of the group by field: Group Above, Group Left Above, or Group Left.
4. Repeat the above two steps to add more group columns if required.
5. Click OK to insert the group columns.
The next time when you open the Insert Group Column dialog to add more group columns, all the added group by fields will be listed
in the dialog. You can choose to remove or edit them if required.
Hiding a column
You can use any of the following methods to hide a table column:
Select the column to be hidden, right-click it, and select Hide Column from the shortcut menu.
Select the table, right-click it and select Show Column from the shortcut menu. In the Show Column dialog, uncheck the column to be
hidden.
Select the cell in the table header, which is in the column you want to hide, right-click the cell and select Hide Column from the
shortcut menu. If the table has more than one header row, use the header in the first row to access the Hide Column command.
Converting a column
You can convert a group column into a detail column, and vice versa.
To convert a group column into a detail column, select the group column, right-click it, and select Convert to Detail from the shortcut
menu, then the conversion is done.
To convert a detail column into a group column:
1. Select the detail column you want to convert, right-click it, and select Convert to Group from the shortcut menu.
2. In the Select Group Position dialog, specify the position for the newly converted group by field in the dialog.
3. Click OK to save the changes.
Notes: A detail column can not be converted to a group column in the following two conditions:
The field bound with the detail column is also added as group by field at the same time.
The field bound with the detail column is unable to be used as group by field.
Deleting a column/row
1. Select a cell which is in the column/row to be deleted, right-click it, and then select Delete from the shortcut menu.
2. In the Delete dialog, select Column or Row.
3. Click OK. The column or row will then be deleted from the table.
Besides, you can also select the specific column or row to be deleted, right-click it and select Delete from the shortcut menu to delete it.
Note: There must be at least one table detail row (TD) in a table. Therefore, if a row is the only detail row of a table, it cannot be deleted.
To merge cells, select adjacent cells, right-click and select Merge (or click the Merge button
the Standard toolbar).
on
To unmerge cells, right-click it and select Unmerge from the shortcut menu. The cell will then be
split into multiple cells.
Unmerging is the reverse operation to merging, and therefore only previously merged cells can be
unmerged.
2. Specify whether the borders will be displayed or not by checking None, Box or Custom. If
Custom is checked, you can click
left, right, top, or bottom border.
, or
A set of link conditions which are used to dynamically filter out data of the child data container.
A set of parameter links (if the child data container has parameters) which are used to assign some
fixed values to the child container parameters so that at runtime, you do not need to enter values for
them.
Assume that you have created a standard banded report showing the customer information. Then, you
insert a table into the detail panel of the banded object, which displays the order information. Now you
want to set up some link conditions between these two containers, so that when you view the report, a
table will be generated according to the ID of the customer as follows:
To achieve this, select the table and right-click it. On the shortcut menu, click Data Container Link,
then specify the settings as required in the Link Data Container dialog.
Generally, data container link functions the same as subreport links. The only difference is that you do
not need to specify a specific component that is linked with the parent data container, since you have
selected the child as the target of the links. For details about how to set up data container link, refer to
Creating sub links, Setting up parameter links, Returning values to the primary report.
Banded objects
A banded object is a kind of component that can present grouped data and detailed data. A banded
object is composed of several banded panels with which you can easily organize data fields and other
elements.
In JReport, banded objects are data containers, which means that a banded object displays the results
of a query and you can apply some filters to narrow down the records displayed in it. Also, when a
banded object is inserted into another data container, you can set up data container link between the
banded object and its parent.
The following topics describe banded objects:
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how each component type could be used in a report. For the banded object
example, open <install_root>\Demo\Reports\SampleComponents\BandedObjectReport.cls.
3. In the Data screen of the wizard, define or select the dataset on which the banded object will be
created.
New
If checked, the banded object will be built on a new dataset created from the catalog
resources.
Existing
If checked, specify the dataset in the current report set from which the banded object will be
created.
Current
If checked, the banded object will be built on the dataset which is used by its parent.
4. In the Display screen, add the required fields from the Resources panel to be displayed in the
banded object, then modify the display name of any added field if necessary by double-clicking
its Display Name column.
If you want to have data in the banded object sorted in a desired order, click the Sort Fields By
button, then specify the fields on which the sorting will be based and the sorting manner as
required (for details, see the same topic Sorting the data on table).
5. In the Group screen, add the fields as the grouping criteria, and then specify the sorting
direction of each group level in the Sort column (for details, see the same topic Grouping the
data on table).
6. To add summaries, go to the Summary screen. In the sum on panel (the panel on the right),
specify the group to which the summary will be applied (if you select Banded Object, the
summary will be based on the whole dataset), add a field from the Resources panel as the sum
on field, and then select the function for the summary from the Aggregate Function column.
7. In the Filter screen, define some filter conditions to filter the data displayed in the banded
object.
To define a filter condition, click the Add Condition button to add a condition line, then from
the field drop-down list, select the field on which the filter will be based, set the operator with
which to compose the filter expression from the operator drop-down list, and in the value combo
box, type the value of how to filter the field or select the value from the drop-down list.
1. From the Toolbox panel, drag Banded Object to the destination in the report where allows the
insertion of a banded object, and a blank banded object will then be created.
2. In the Resource View panel, select the dataset you want to use in the banded object from the
dataset drop-down list. If you want to create a new dataset for the banded object, select
<Choose Data from...> from the list and new a dataset in the New Dataset dialog.
3. Drag the required fields in the specified dataset from the Resource View panel into the banded
panels.
After a banded object has been created, you can customize its appearance and behavior by setting
properties in the Report Inspector, which can be saved as a CSS style for future use (for details, see
Creating a CSS style).
Notes:
When you want to create a banded object on a hierarchical data source, pay attention to the unique
features of HDS. For details, refer to Developing reports from HDS.
When inserting a banded object using the report wizard,
If you have added several group by fields in the Group screen, when the banded object is created,
these groups will be indented according to the Customize group indent option setting in the
Options dialog. You can configure this option in advance to have the groups indented according to
your requirements.
If you have added some summaries in the Summary screen, when the banded object is created,
JReport will automatically give the summaries some proper name labels to help you clarify the
meaning of the numbers. The auto generated labels are controlled by the Text property in the
Report Inspector. You can also manually edit the text of the label later by setting this property.
By default, the summaries that have the same function will be aligned horizontally in the banded
object. If you want to align summaries of the same function vertically, check the option Align
summaries vertically in the Options dialog in advance.
When you insert an object whose height is determined at runtime into the BandedPageFooter panel
(for example, a subreport), but do not set the height of the panel high enough to hold this object,
the object might get overlapped with the ones that are in the panel which is above the BPF panel at
runtime.
When you insert a banded object into a banded report with the dataset inherited from the banded
report, you can not insert the banded object into the BandedPageHeader and BandedPageFooter
panel.
Due to the specialty of hierarchical data sources, you are not allowed to specify an HDS as the new
dataset of the banded object.
In the Group screen, the newly added fields will be put to the end of the existing fields, and you
cannot re-adjust the order of the fields as you did when creating the banded object.
When you have specified a new dataset for the banded object, if there are existing fields in the
banded object that cannot be found in the new dataset, they will be marked with a red cross icon.
to select fields from the new dataset to replace them. Then
You can use the Replace button
when you finish the modification, the new dataset and fields you specify will be displayed in the
banded object and those remaining fields that cannot be matched to fields in the new dataset will be
removed from the banded object automatically.
Note: When a banded object is created on an HDS, even though you can define some filter conditions
on the banded object via the Format Filter dialog, the conditions will not be applied when the banded
object runs due to the specialty of HDS. However, if you want to narrow down the data displayed in
such kind of banded objects, you can make use of the dataset filter.
In addition, you can insert a web control, Expand/Collapse Group, to the group header panel of a
banded object so that end users in JReport Viewer can use the web control to expand/collapse records
in groups of the banded object. Note that, this feature works only in continuous page mode.
To insert to a Expand/Collapse Group web control in a banded object:
1. Make sure to uncheck the Page Layout command on the View menu.
2. Select the group header panel, then do one of the following:
Click Insert > Web Control > Expand/Collapse Group on the menu bar.
Select Expand/Collapse Group from the Insert Control Objects drop-down list
the Insert toolbar.
on
3. Click on the group header panel, and the web control will be inserted there.
After publishing the report set to JReport Server and run it in JReport Viewer, end users will be able to
use the web control which appears like a plus or minus sign to expand or collapse a group (i.e., to
show or hide the details of that group). Furthermore, you can use two properties of a group panel to
set the expanding/collapsing state of all groups in the corresponding group level. That is, the Expand
Detail Data property controls whether or not to expand the groups, and the Shrink Footer property
controls whether or not to hide the group footer panel when collapsing the group.
Select a panel of the same type, right-click it and select Insert Panel After. A blank panel will be
inserted into the banded object.
Deleting a banded panel
To delete a banded panel from a banned object, right-click the panel and select Delete. Note that
you cannot delete a panel of a certain type if it is the only one of that type.
Hiding a banded panel
To hide a banded panel from view, right-click the panel, and then click Hide.
Showing a hidden banded panel
1. Check the item Show Invisible Objects on the View menu, and the hidden panel will then be
displayed and marked with two triangles.
2. Right-click the banded panel, and click Show on the shortcut menu to release its hidden state.
Resizing a banded panel
For a vertical or cross banded object, drag the boundary below the banded panel until the panel is
at the required height.
For a horizontal banded object, drag the boundary on the right side of the banded panel until the
panel is at the required width.
Crosstabs
A crosstab summarizes data and presents the summaries in a compact row and column format. In
JReport, crosstabs are data containers, which means that when a crosstab is inserted into another data
container, you can set up data container link between the crosstab and its parent (for details, see the
section Setting up data container link).
Meanwhile, in order to meet the requirements from voice agents used by people with eyesight
disabilities, JReport supports exported crosstab components in the HTML data table format to get a
section 508 compliant result. For detailed descriptions, refer to Accessibility.
Pick a task from the following:
Inserting a crosstab
Modifying a crosstab
Expanding/Collapsing a crosstab
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how each component type could be used in a report. For the crosstab
component example, open <install_root>\Demo\Reports\SampleComponents\Crosstab.cls.
Inserting a crosstab
To insert a crosstab into a report, use either of the following two ways:
If you are inserting the crosstab into a studio report, you can also drag Crosstab from the
Toolbox panel to display the wizard.
If you are inserting a crosstab into a normal report, define or select the dataset on which the
crosstab will be created.
New
If checked, the crosstab will be built on a new dataset created from the catalog resources.
Existing
If checked, specify the dataset in the current report set from which the crosstab will be
created.
Current
If checked, the crosstab will be built on the dataset which is used by its parent.
If you are inserting a crosstab into a studio report, select a business view in the current
catalog on which the crosstab will be created.
4. In the Display screen, add the required fields from the Resources box to the Columns and Rows
boxes respectively and set the other settings according to your requirements. Add the fields as
aggregate fields to the Summaries box and specify the aggregate functions for the added fields.
If necessary, click the Comparison Function button to set the comparison function.
5. To apply some filters to the crosstab so as to reduce the data displayed in the crosstab, go to
the Filter screen and define the filter conditions. If you are inserting the crosstab into a studio
report, you can select a predefined filter of the specified business view if there is from the Filter
drop-down list to apply, or select User Defined in the list to define a new filter. For how to
define a filter, refer to Filtering the data.
6. In the Layout screen, specify the layout of the crosstab.
7. In the Style screen, set a style for the crosstab.
If you have specified to insert the crosstab into a banded object, by default the crosstab will
inherit its parent's style. If you want to apply another style to the crosstab, uncheck the Inherit
Style option and then select the required style from the Style box. For more information, see
When a crosstab has been created, you can customize its appearance and behavior by setting
properties in the Report Inspector, which can be saved as a CSS style for future use (for details, see
Creating a CSS style).
Note:
When you want to create a crosstab on a hierarchical data source, pay attention to the unique
features of HDS. For details, refer to Developing reports from HDS.
When you insert a crosstab into a banded report with the dataset inherited from the banded report,
you can not insert the crosstab into the BandedPageHeader and BandedPageFooter panel.
Modifying a crosstab
Once a crosstab has been created, you can further modify it by accessing its shortcut menu wizard
which is composed by a set of screens that are similar to the wizard screens used to create the
crosstab. For example, you can change the data used by the crosstab, reset the layout and style of the
crosstab.
To modify a crosstab after it has been created:
1. Right-click the crosstab and select Crosstab Wizard from the shortcut menu to display the
Crosstab Wizard.
2. In the Data screen, specify a new data source for the crosstab if required.
3. In the Display screen, specify the fields you want to display in the crosstab.
4. In the Layout screen, specify the layout of the crosstab.
5. In the Style screen, set a style for the crosstab.
6. Upon finishing, click Finish to accept the changes.
See also Crosstab Wizard for details about options in the wizard.
Notes:
Due to the specialty of hierarchical data sources, you are not allowed to specify an HDS as the new
dataset of the crosstab.
For a normal report, when you have specified a new dataset for the crosstab, if there are existing
fields in the crosstab that cannot match the new dataset, they will be marked with a red cross icon.
to select fields from the new dataset to replace them. Then
You can use the Replace button
when you finish the modification, the new dataset and fields you specify will be displayed in the
crosstab and those remaining fields that cannot be matched to fields in the new dataset will be
removed from the crosstab automatically.
For a studio report, if you specify a new business view for the crosstab, the current crosstab data will
be lost and when you finish editing, a new crosstab will be created.
After finishing the modification, you can also apply some filter conditions to narrow down the records
displayed in the crosstab the same as you do for a table (for details, see Filtering the data). However, if
the crosstab is created on an HDS, the conditions you define in the Format Filter dialog will not be
applied when the crosstab runs due to the specialty of HDS. Therefore, if you want to filter the data
displayed in such kind of crosstabs, you need to make use of the dataset filter.
3. From the Function drop-down list, select the required function: Percentage, Permillage or Difference.
4. Specify a position for the comparison function.
5. Numbers that form the calculation of the comparison function are determined by the Break by and Refer to drop-down
lists.
Items in the Break By drop-down list vary with the position of the comparison function. It specifies the first parameter
(aggregate or subtotal) of the comparison function.
All available items are displayed in the Refer to drop-down list according to what you have selected from the Break By
drop-down list. These items are outer group subtotal and grand total. Select one as the other parameter of the
comparison function.
6. Click OK and you can see that a new field is added into the Aggregates box. Set the display name for the field as
required.
7. Repeat the above steps to define more comparison functions.
8. When done, click Finish in the Crosstab Wizard to apply the settings.
9. View the report. You will get the values of the comparison function.
Now, you want to define a comparison function in the crosstab to show the percentage of each state's sales volume to the
grand total. To do this:
1. Right-click the crosstab and click Crosstab Wizard on the shortcut menu.
2. In the Display screen of the Crosstab Wizard, select Quantity in the Summaries box, then click the Comparison
Function button.
3. In the Comparison Function dialog, select Percentage from the Function drop-down list, check Comparison Function
Spans on Row Direction, specify Product Type Name as the break by field and choose Grand Total from the Refer
to list.
4. Click OK in the Comparison Function dialog to return to the Crosstab Wizard, then click Finish in the wizard to accept
the settings.
5. In the Report Inspector, modify the value of the Format property of the fields corresponding to the percentage to #,###.
##% (the fields are represented as QUANTITY9, QUANTITY10 and QUANTITY11 respectively in the Report Inspector).
6. View the crosstab again and you will find that a percentage is added to the right of each state's sales volume.
Expanding/Collapsing a crosstab
If a crosstab has more than one row/column group level, you can specify whether or not to enable the crosstab to
be expanded at runtime, and set the default expanding/collapsing state of groups in outer level. This behavior is
controlled by two properties: Expand Data and Expand Detail Data.
Expand Data: A property on both crosstab, and DBField or formula added into crosstab as dimension (group
level). The property on crosstab controls whether or not to enable end users to expand/collapse dimensions in a
crosstab, and when it is enabled, you can use the property on certain DBField or formula to specify whether this
dimension can be expanded/collapsed respectively.
Expand Detail Data: A property on DBField or formula added into the crosstab as dimension (group level). It
specifies whether or not to display the details of this field by default.
Note: These two properties works only in continuous page mode, and after setting the two properties, if you have
further modified the crosstab layout, they may not take effect.
The following example shows how to use the two properties:
1. Create a crosstab report on the query WorldWideSales in the catalog file SampleReports.cat as follows: add
Product Type Name and Category in the Products table as the column fields, Region, Country and State in
the Customers table as the row fields, Quantity in the Orders Detail table as the aggregate field and specify
Sum as the aggregate function, set the crosstab to be Vertical Layout (Number of Rows: 1), and apply the
style Classic to the crosstab.
2. In the Report Inspector, set the Expand Data property of the crosstab to true.
3. Set the Expand Data property of the DBField Country to false, and the Expand Detail Data property of the
DBField Product Type Name to false.
4. Uncheck Page Layout on the View menu.
5. Save the crosstab.
6. Click View > Preview As > DHTML to preview the report in DHTML format. You can then click the buttons
with a plus or minus sign to expand/collapse the Region and Product Type Name dimensions, and since the
Expand Detail Data property of Product Type Name is set to false, you will find the details of this dimension
are not expanded by default.
Charts
A chart organizes and graphically presents data in a way that makes it easy for end users to see
comparisons, trends, and patterns in data. It represents the report data in a visually straightforward
form. A chart is based on the chart platform. On the platform, the chart paper, the legend, and labels
make up the chart. You can create a chart that contains only simple DBFields, or a complicated chart
that contains DBFields, groups, summaries, and even formulas. Normally, DBFields, summaries, and
formulas in a report are represented in a chart using chart data markers, and groups are used to
produce category names and data series names. DBFields can also be used as category names.
In JReport, charts are data containers, which means that when a chart is inserted into another data
container, you can set up data container link between the chart and its parent (for details, see the
section Setting up data container link).
This section describes the following tasks related to charts:
Chart elements
Chart types
Inserting a chart
Modifying a chart
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how each component type could be used in a report. For the chart component
example, open <install_root>\Demo\Reports\SampleComponents\Chart.cls.
Chart elements
In a report template, a chart consists of three basic areas: the platform, paper, and legend. The chart
platform is a container for other chart elements, and the chart paper holds walls, axes, data markers,
axis values, and category names.
Chart platform
The container of other chart elements, such as chart paper and chart legend.
Chart paper
The canvas on which the main chart is drawn. The chart paper contains walls, axes, data markers,
axis values, and category names.
Chart legend
The chart legend is a box which identifies the patterns or colors assigned to the data series or
categories in a chart. The chart legend may contain one or more legend entries; each entry is
composed of an icon and a label.
Chart label
A chart label can be used as the chart title or axis title. You can insert a label anywhere inside a chart.
Axis values
Each axis is divided by some tick marks, and each tick mark is associated with a value which is by
default along the axis.
Category names
DBField and formula values can be used as category axis names.
Data series names
DBField and formula values can be used as series names.
Data markers
Data markers with the same pattern represent one data series. Each data marker represents one
value from the chart data.
Hint
A hint message that displays the value of a data marker when you move your mouse pointer over the
data marker.
Chart types
The following table lists the JReport chart types.
Bar
Clustered Bar 2-D
Bar 3-D
Bench
100% Stacked Bench 2-D 100% Stacked Bench. Displays and compares the percentage
that each data value contributes to a total across categories.
100% Stacked Bench 3-D 100% stack bench with a 3-D visual effect.
Bench 3-D
Line 2-D
Line 3-D
Area 2-D
Line
Area
Area 3-D
Clustered Pie
Clustered Donut
Radar 2-D
Pie
Radar
Gauge
Surface
Surface 3-D
Scatter 2-D
Bubble 2-D
High-Low 2-D
High-Low-Close 2-D
Scatter
Bubble
Stock
Bullet
Bullet 2-D
Bullet. Replaces the meters and gauges that are often used on
dashboards. Its linear design not only gives it a small footprint,
but also supports more efficient reading than radial meters.
Combo
Combo
You can also create a chart containing summary information. This kind of chart can display either twoor three-dimensional data. The following is an example showing a three-dimensional-data chart. Notice
that the data field in the series axis always holds a higher group level (outer group) than that in the
category axis.
If you would like the value axis to display more than one data field, the data fields must be of a same
level, that is, all these fields are DBFields or formulas of the dataset (for two-dimensional-data chart),
or they are summaries of a same group level (for three-dimensional-data chart).
With respect to a Stock chart, it is designed specially for representing stock trends. You can think of it
as a two-dimensional-data chart which must show more than one data field in its value axis. The
number of data fields is decided by the subtype of the Stock chart.
A combo chart is different from a single chart in that it has two value axes -- the primary value axis
and the secondary value axis, and each value axis can represent one or more subtypes. You can add
one or more data fields to any subtype of the two axes and all data fields in the two value axes must
be of a same level. Notice that some subtypes are not applicable for combo charts.
Inserting a chart
To insert a chart into a report, follow the steps below:
1. Position the mouse pointer at the destination where you want to insert the chart. A chart can be
inserted in the report areas listed in Component placement.
2. Do one of the following to open the Create Chart wizard:
If you are inserting a chart into a normal report, define or select the dataset on which the chart
will be created.
New
If checked, the chart will be built on a new dataset created from the catalog resources.
Existing
If checked, specify the dataset in the current report set from which the chart will be created.
Current
If checked, the chart will be built on the dataset which is used by its parent.
If you are inserting a chart into a studio report, select a business view in the current catalog on
which the chart will be created.
To create a single chart, check the Single Chart radio button, and then select the required type
from the Chart Type box and its subtype accordingly.
To create a combo chart, check the Combo Chart radio button. You can see that the Chart Type
Groups box lists the two value axes: the primary axis (Y1) and the secondary axis (Y2), and an
<Add Combo Type> item is displayed for each axis. A default chart subtype has been added to
the primary axis. To add an additional subtype to an axis, click the corresponding <Add Combo
Type>, and you will find that a subtype has been added. To change any subtype listed in the
box, select it, then choose your required chart type from the Chart Type box, and click the
thumbnail for the subtype you want in the Sub Type box. To delete a subtype, select it and click
.
5. In the Display screen, add the required fields from the Resources panel to be displayed on the
category axis, series axis and value axis of the chart, and define some special group, special
function and Order/Select N condition on the category/series field if required.
6. To apply some filters to the chart so as to reduce the data displayed in the chart, go to the Filter
screen and define the filter conditions. If you are inserting the chart into a studio report, you can
select a predefined filter of the specified business view if there is from the Filter drop-down list to
apply, or select User Defined in the list to define a new filter. For how to define a filter, refer to
Filtering the data.
7. In the Layout screen, with the Data category selected in the Options list box, you can specify the
category/series start and end offset, whether or not to reverse the category/series field value
sequence, and whether or not to swap groups. Besides, you can set whether or not to show the
titles, axes, walls, gridlines, and legend. If yes, set the titles for the chart, the category axis and
the value axis respectively. If you choose not to display a certain axis, the labels and tick marks
along the axis will be hidden as well.
8. In the Style screen, select a style for the chart.
If you have specified to insert the chart into a table or a banded object, by default the chart will
inherit its parent's style. If you want to apply another style to the chart, uncheck the Inherit
Style option and then select the required style from the Style box. For more information, see
Inheriting the style from a data container.
9. Click Finish to insert the chart.
If you have used the menu or toolbar command to insert the chart and specified to insert it to
position other than the report body or tabular cell, after clicking Finish in the wizard, you need to
click the mouse button in the destination once again in order to insert the chart there.
When a chart has been created, you can further format its elements according to your requirements.
You can also customize its appearance and behavior by setting properties in the Report Inspector,
which can be saved as a CSS style for future use (for details, see Creating a CSS style).
Notes:
When you want to create a chart on a hierarchical data source, pay attention to the unique features
of HDS (for details, refer to Developing reports from HDS). Moreover, when a chart is created on
HDS, only the fields that are of Integer or Number data type in the HDS can be added to the value
axis of the chart.
If you want to insert a chart into the BandedPageHeader panel of a banded object, make sure the
chart has its own dataset.
If you specify to create a pie chart, you can add several fields to be displayed on the value axis of
the chart as long as the fields are of Numeric type. However, you can add formulas and DBFields to
the axis at the same time, but when a summary has been added to the axis, no other DBFields or
formulas can be added.
If you have defined a subtype of the Stock type, in the Display screen, you should add fields for the
subtype in the order indicated by the subtype name, e.g., if you define the Open-High-Low-Close 2-D
subtype, then you should add four fields to the Show Values box for this subtype, and arrange them
to the order of Open-High-Low-Close by clicking the buttons
and
Modifying a chart
Once a chart has been created, you can further modify it by accessing its shortcut menu wizard which
is composed by a set of screens that are similar to the wizard screens used to create the chart. For
example, you can change the data used by the chart, modify the chart type, and so on.
To modify a chart after it has been created:
1. Right-click the chart and select Chart Wizard from the shortcut menu to display the Chart Wizard.
2. In the Data screen, specify a new data source for the chart if required.
3. In the Type screen, specify the type of the chart.
If you want to change the chart type, you may need to first remove all chart data. Specially, if you
change a combo type to a single type or vice versa, JReport will prompt you to make sure because
all chart data will be removed automatically.
4. In the Display screen, specify the fields you want to display in the chart, and define some special
group, special function and Order/Select N condition on the category/series field if required.
5. In the Layout screen, specify settings for the chart elements.
6. In the Style screen, select a style for the chart.
7. When done, click Finish to accept the changes.
See also Chart Wizard for details about options in the wizard.
Notes:
Due to the specialty of hierarchical data sources, you are not allowed to specify an HDS as the new
dataset of the chart.
While changing a type of 2-D chart to another type of 2-D chart, or a type of 3-D chart to another
type of 3-D chart, all the previous properties will be kept. Nevertheless, when changing a 2-D chart
to a 3-D chart, the properties of the Z axis, the Y-Z wall, and the floor of the 3-D chart will be set to
default values (since a 2-D chart does not have the Z axis, the Y-Z wall, or the floor), and all other
properties will be taken from the 2-D chart. When changing a 3-D chart to a 2-D chart, the properties
of the Y2 axis of the 2-D chart will be set to default values (since a 3-D chart does not have the Y2
axis).
When both special functions and Select N conditions are defined in a chart, the former takes higher
priority. That is to say, grouping data by intervals takes effect before Top/Bottom N.
For a normal report, when you have specified a new dataset for the chart, if there are existing fields
in the chart that cannot match the new dataset, they will be marked with a red cross icon. You can
use the Replace button
to select fields from the new dataset to replace them. Then when you
finish the modification, the new dataset and fields you specify will be displayed in the chart and those
remaining fields that cannot be matched to fields in the new dataset will be removed from the chart
automatically.
For a studio report, if you specify a new business view for the chart, the current chart data will be
lost and when you finish editing, a new chart will be created.
After finishing the modification, you can also apply some filter conditions to narrow down the records
displayed in the chart the same as you do for a table (for details, see Filtering the data). However, if
the chart is created on an HDS, the conditions you define in the Format Filter dialog will not be applied
when the chart runs due to the specialty of HDS. Therefore, if you want to filter the data displayed in
such kind of charts, you need to make use of the dataset filter.
2. Click the Add button to add a grouping line and specify the Group Name, Operator and Operand
as required. Repeat this to add more group criteria.
For example, if you place a field named Score for grouping which contains student scores that
range from 0 to 100, and you want to group the students in 5 ranks, namely rank A: 90~100, B:
80~89, C: 70~79, D: 60~69, and E: 0~59. You can set the groups as follows:
Group Name
Operator
Operand
between
between
between
between
<=
59
There will be five groups in the order from A to E. If you want to change the order of the groups,
you can also do so via the User Defined Group dialog.
3. Check Keep values outside of the range in special group checkbox if you want to put the
values that are not included in the specified criteria in a new special group, and then provide a
name for the special group in the Special Group Name text field.
4. Click OK to accept the settings.
5. When done, click Finish in the Chart Wizard to apply the changes.
See also User Defined Group dialog for details about options in the dialog.
By default, the special function for field on the category axis is the same as that of the summary
displayed on the value axis. When you change the special function for the category field, the
summary's special function will not be affected.
If you have defined a special function to the group by field of a table or banded object, and then
insert a chart in the table or banded object which inherits dataset from the parent and has the same
grouping structure with the parent, the special function defined for the very field will be applied to
the chart too. However, you can specify another special function to the field on the chart axis
according to your requirements.
2. In the Category/Series Order box of dialog, specify the sort order of the category/series values.
Ascend
Values on the axis will be sorted in an ascending order.
Descend
Values on the axis will be sorted in a descending order.
No Sort
Values on the axis will be sorted in the original order in database.
All
If selected, all category/series values will be shown in the chart.
Top/Bottom N
If selected, the combo box to the right will be enabled and you can specify an integer number in
the text field, or select a parameter which returns an integer from the drop-down list to
dynamically define the Top/Bottom N condition, then only the first or last N (N is the number
you specify by the integer or parameter) category/series values will be shown in the chart.
Note: If you use an Integer-typed parameter to define the Top/Bottom N condition
dynamically at runtime, you should make sure that the parameter has at least one default
value that is larger than 0, otherwise you will get exceptions when viewing the report.
4. Check the Based On checkbox and specify values for the options that follow.
If Based On is unchecked, the order for the first or last N values will be based on what you specify
in the Category/Series Order box of the dialog; if you check it, the order will be based on values of
the summary field and the sort direction you specify via the drop-down list and radio buttons next
to Based On.
5. If you have selected Top N or Bottom N from the Select drop-down list, you can check the
Remaining Categories In checkbox and then type a character string in the text field to the right,
so that the category/series values beyond the first or last N range will be merged into the group
with the name as that character string.
6. If necessary, check Skip First and input a number M in the text field to the right, then the first M
category/series values will be skipped, and the Select N condition will begin with M+1. The
skipped values will be merged into the Remaining Categories group.
7. When done, click OK to accept the settings.
8. Click Finish in the Chart Wizard to apply the changes.
The following example shows how to control the number of field values that will be displayed in a chart.
1. In the TutorialReports.cat catalog, create a chart report based on the OrderListbyDate query,
select the Clustered Bar 2-D chart type and add the summary Sum_ProductSalesbyProductID to
the value axis. The report result looks as follows:
2. Right-click the chart in the report and select Chart Wizard from the shortcut menu to open the
Chart Wizard.
3. In the Display screen, click the Order/Select N button below the Category box.
4. In the Category Options dialog, set the Select condition to Top 6, based on
Sum_ProductSalesbyProductID descendingly, then check the Remaining Categories In checkbox
and input Other into the text field so as to put the categories that do not meet the condition into
the Other group. Click the OK button.
If the chart is of 2-D type, in the General tab, drag the slider to scale up or down the display
size of the chart along the X or Y axis. Check the Constrain Proportion option to set the same
scaling ratios for both X and Y axes.
If the chart is of 3-D type, in the Rotate tab, set the rotation angle for the chart, and specify the
scaling ratios for the X, Y and Z axes accordingly. You can either click
,
,
, or
, and
then drag the chart thumbnail in the preview box to rotate the chart around the origin point, X
axis, Z axis, or Y axis, or adjust the degrees directly in the spinners.
Tip: You can rotate a 3-D chart in another intuitive way as explained below:
1. Right-click anywhere in the chart and select Rotation Mode from the shortcut menu.
2. Hold the mouse button and move the pointer to the desired position, then release the
mouse button to confirm.
To quit the rotation mode, right-click anywhere in the chart and click Editing Mode
on the shortcut menu.
3. In the Fill and Border tabs, set the fill and border modes (for details, refer to Formatting the
platform).
4. When done, click OK to apply the settings and close the dialog.
See also Format Paper dialog for detailed explanation about options in the dialog.
To change the style of a mark item, select it in the Mark Items box and then choose a new one
from the Mark Items drop-down list. To change the fill mode of a mark item, select it and set the
If the chart is a combo chart composed by bars and areas/lines, when you set the depth properties
for the bars, they will be applied to the areas/lines as well, and vice versa.
For 3-D charts, the Show Static Data Label checkbox in the Data Label tab is grayed out. However,
you can still see the data labels by moving the mouse pointer over the bars when viewing the report
result in view mode, or in HTML/DHTML format.
If you set the style of the bars to be cylinder, the style can take effect only when the Use Depth
option is set to true at the same time.
For a 2-D line chart, set the layout style and thickness of the lines and the style, width and
height of the nodes in the lines. If you want to add a 3-dimensional effect to the lines, set the
Use Depth option to true and specify the depth and direction as required.
For a 3-D line chart, set the thickness of the lines.
3. In the Fill tab, set the fill and transparency settings of the lines.
Click the color image button and select a color swatch to fill the lines (you can also directly type
the hexadecimal value of the desired color in the text box). If the color swatches cannot meet
your requirement, click More Colors to open the Pick a color dialog, with which you can set a full
range of color. If required, click More Fill Effects to specify a gradient, a texture or an image as
the fill effect in the Fill Effects dialog. Click the Pattern List button to specify the color pattern
that will be applied to the lines if required.
For a 2-D line chart, you can also set the fill and transparency settings of the areas that are
formed by the chart axes and the lines the same as you do to the lines.
4. In the Node tab (the tab is available to 2-D lines only), specify the style, width, fill color, height
and transparency of the line nodes in the Shape box. In the Border box, set the border properties
of the line nodes, including border color, transparency, line style and thickness.
5. In the Border tab (the tab is available to 3-D lines only), set the border mode of the lines,
including the border style, color, transparency, line style, thickness, end caps style, and line joint
mode. You can also specify whether the border is to be outlined, and whether or not to
automatically resize the border dashes if the border is drawn with dashes.
6. In the Data Label tab, specify whether or not to show static data labels for every node, and if to
show, the position of the label related to the node. In the Font and Effects boxes, set the font
formats and effects of the labels.
7. Click OK to apply the settings and close the dialog.
See also Format Line dialog for detailed explanation about options in the dialog.
Notes:
If the chart is a combo chart composed by lines and areas/bars, when you set the depth properties
for the lines, they will be applied to the areas/bars as well, and vice versa.
For 3-D charts, the Show Static Data Label checkbox in the Data Label tab is grayed out. However,
you can still see the data labels by moving the mouse pointer over the lines when viewing the report
result in view mode, or in HTML/DHTML format.
If the chart is a combo chart composed by areas and bars/lines, when you set the depth properties
for the areas, they will be applied to the bars/lines as well, and vice versa.
For 3-D charts, the Show Static Data Label checkbox in the Data Label tab is grayed out. However,
you can still see the data labels by moving the mouse pointer over the areas when viewing the report
result in view mode, or in HTML/DHTML format.
In the Option box, set the left margin, top margin, relative radius of the bubbles, and whether or
not to draw horizontal/vertical grids. In the Value box, set the minimum and maximum values. In
the Color Range box, specify the minimum and maximum values, color, and name for the three
predefined color ranges. If the value represented by a bubble is in a range, its color will be the
one of that range.
3. In the Border tab, set the border mode for the bubbles (for details, see Formatting the platform).
4. In the Data Label tab, set the font formats and effects of the data labels. The data labels will be
shown when you move the mouse pointer over the bubbles while viewing the report result in view
mode, or in HTML/DHTML format.
5. When done, click OK to apply the settings.
See also Format Dial Gauge dialog, Format Bar Gauge dialog and Format Bubble Gauge dialog for
detailed explanation about options in each dialog.
The chart should have the same group structure as that of the banded object or table.
The following example further explains what the same group structure means.
A banded object has two groups: group 1 and group 2 (group 1 is the higher level)
Add the summary 2 based on group 2 to the value axis, then group 2 will be added to the
category axis, and group 1 will be added to the series axis.
Add the summary 1 based on group 1 to the value axis, then group 1 will be added to the
category axis, and no value will be added to the series axis.
When the chart is to be inserted into the group header panel 1 which displays group 1, only
summary 2 based on group 2 can be added to the value axis. Then group 2 will be added to the
category axis, and no value will be added to the series axis.
When the chart is to be inserted into the group header panel 2 which displays group 2, the value
axis cannot contain any summary value.
A detail chart does not contain summary value on the value axis, but DBFields. The DBFields on
the value axis and the value on the category axis must be in the detail panel of the banded
object or table, and should not be hidden.
A summary chart contains summary value on the value axis, and the summary on the value axis
must be in the banded object or table, and should not be hidden.
When the chart does not inherit data from the banded object or table:
The chart should use the same dataset as the banded object or table.
The chart should have the same group structure as that of the banded object or table.
The chart should have the same filter/sort condition, Top N condition and special function as that of
the banded object or table.
The chart can only be inserted into the banded header/footer panel or outside of the banded object.
DBFields on the value axis must be in the detail panel of the banded object or table, and
should not be hidden.
The category value must be in the detail panel of the banded object or table, and should not
be hidden.
If the chart, banded object or table has a Top N condition, then the chart will not be mapped to
the banded object or table.
For a summary chart, the summary on the value axis must be in the banded object or table, and
should not be hidden.
The following example shows how to use the Dynamic Chart feature in Excel. Here the chart inherits
data from its parent banded object.
1. Open the catalog file TutorialReports.cat, and create a query Products in Data Source 1 of the
catalog based on the table Products. Check all the columns in the table.
2. Create a standard banded report based on the query Products. The banded report displays the
following fields: Products_Product ID, Product Name and Price, and is grouped by Category and
Products_Product Type ID (Category is the higher level).
3. In the Resource View panel, click <Add Summary...> from the Summaries node and create a
summary named Sum_Price which uses the function Sum, sums on Price in the Products table,
and applies to the Products_Product Type ID group level.
4. Drag the summary to the footer panel of the Products_Product Type ID group level in the banded
object.
5. Click Insert > Chart to insert a 2-D bar chart into the banded header panel. The chart inherits
the dataset from the banded object (make sure Current is checked in the Data screen of the
Create Chart wizard), displays Products_Product Type ID on the category axis, Category on the
series axis, and Sum_Price on the value axis.
6. Right-click the chart and select Chart Wizard from the shortcut menu.
7. In the Chart Wizard, switch to the Layout screen, select Export in the Options box and then
select BandedObject from the Mapping Component drop-down list, then click Finish.
8. Click File > Options. In the Options dialog, check the option Check the availability of dynamic
chart for Excel in the General category, then click OK.
This option is provided to check if the chart can be correctly mapped to the banded object when
you save the report or export it to Excel.
9. Click File > Export To > Excel to export the report to Excel (make sure Preserve Report
Formatting is checked in the Export to Excel dialog).
10. Open the exported result file in <install_root>\Demo\Reports\TutorialReports.
11. Change the price of Jamaican Rum and Torrefazione Italia to 30.00, and you will find that the
value of the chart is changed accordingly.
Notes:
You cannot make charts of bubble, stock and scatter types to be dynamic charts if they have
summary value on the value axis.
Chart and the summary used in the chart cannot be inserted into the repeated panel of the banded
object or table.
For summary chart, only value axis can be mapped to each single cell in Excel. That is to say, when
you change the data in Excel, the corresponding value axis will also be changed.
Tabulars
A tabular is a component designed to lay out other components. Unlike a table component, that is used
to display a dataset, a tabular is a set of cells that can each display a dataset in a component.
Using dialog
1. Do one of the following to bring out the Insert Tabular dialog:
2. Specify the number of rows and columns, and the border width and tabular width as required.
3. Click the OK button to close the dialog.
If the mouse pointer is in the report body or a cell of another tabular, the tabular will be
inserted there upon clicking OK. Otherwise, you need to click the mouse button in the desired
location to place the tabular there.
Insert the required components into the tabular cells. The components that can be inserted into a
tabular cell are listed in Component placement.
Double-click a tabular cell and then input and modify text in it.
You can also customize the tabular appearance and behavior by setting properties in the Report
Inspector, which can be saved as a CSS style for future use (for details, see Creating a CSS style).
To merge adjacent cells, select them, right-click and select Merge from the shortcut menu (or click
the Merge button
on the Standard toolbar). These cells will then be merged into one cell.
1. Right-click the cell and select Split from the shortcut menu.
2. In the Split Cell dialog, check whether the cell will be split into rows or columns, and then
specify how many rows/columns the cell will be split into.
3. Click OK, and the cell will then be split according to your selection.
To resize a column of a tabular, drag the boundary on the right side of the column until the column
is the width you want. If the boundary is not the rightmost one, the column width will change, but
the total width of the tabular will not change. If you want to change both the column width and the
tabular width, press the Shift button on the keyboard while dragging. To resize a row, drag the
boundary below the row until the row is the height you want. Both the row height and the tabular
height will change. If you want to change just the row height, press the Shift button on the keyboard
while dragging the boundary, which is not the last boundary.
To insert a column/row into a tabular, select a cell and right-click it. On the shortcut menu, click the
corresponding inserting column/row item and a column/row will then be inserted according to your
selection.
To delete a column/row from a tabular, select all the cells in this column/row, right-click, and then
select Delete Column/Delete Row from the shortcut menu.
Subreports
A report that is inserted into a report is referred to as the subreport. Subreports are inserted and
managed just like a component in a primary report, but a subreport itself is created and managed just
like a primary report. You can specify relationships between the primary report and the subreport as
well as have JReport pass values to the primary report or the subreport. A primary report can have
more than one subreport.
This section describes the following topics related to subreports:
Inserting a subreport
Formatting a subreport
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how each component type could be used in a report. For the subreport
examples, open <install_root>\Demo\Reports\SampleComponents\Subreport_*.cls.
Inserting a subreport
A subreport can be inserted in the report areas listed in Component placement.
To insert a subreport into a report:
1. Open the primary report.
2. Position the mouse pointer at the destination where you want to insert the subreport, then click
Insert > Subreport on the menu bar (or the Insert Subreport button
toolbar). Then,
on the Insert
If the destination is the report body or a tabular cell, the Subreport dialog will be displayed.
If the destination is a banded panel, click the mouse button in the panel to open the Subreport
dialog.
3. In the Subreport dialog, click the Browse button to select the report set which contains the report
you want to use as the subreport. This report set must belong to the same catalog as the primary
report.
4. Select the required report as the subreport from the Subreport drop-down list, where the names
of all the reports in the specified report set are displayed.
5. In the Field tab, click the Add button beside the Component in Report box. In the Choose
Component dialog, add the components in the subreport you want to be interlinked with the
primary report with conditions. If the required components use different datasets, you need to add
them respectively, however, as long as the components are based on the same dataset, you can
add them all at a time.
6. Select a component from the Component in Report box and set up links between the primary
report and the component as required (for details, see Creating sub links). Repeat this to define
the link condition between other components in the subreport and the primary report.
7. If the subreport has parameters, and you do not want to enter values for them at runtime, you
can click the Parameter tab to assign values to the parameters. For details, see Setting up
parameter links.
8. If you want the subreport to return certain values to the main report, click the Return Value tab
and specify the settings according to your requirements (for details, see Returning values to the
primary report).
9. Click OK to insert the subreport.
When a subreport has been inserted into a report, you can use the Format Subreport dialog to format
this subreport. You can also customize its appearance and behavior by setting properties in the Report
Inspector, which can be saved as a CSS style for future use (for details, see Creating a CSS style).
Notes:
When inserting subreports, you need to avoid link loop. For example, if you have inserted report B
into report A as its subreport, then you cannot insert report A into report B as its subreport again.
You can use the option Show real view of subreport in the Options dialog (File > Options >
General > Show real view of subreport) to specify whether or not to show the detailed subreport
structure in the primary report in design mode. However,
For subreport with multiple pages, only the report body in the first page will be shown in the
primary report.
For cascading subreport, only the first layer of the subreport will be shown in the primary report.
Formatting a subreport
You use the Format Subreport dialog to format a subreport. To access this dialog, right-click a
subreport and choose Format Subreport.
This dialog supports the following tasks related to formatting subreports:
Creating sublinks
Creating sublinks
A sublink is a way to connect the primary report and the subreport. When you define a sublink, JReport
will match the records with equal relationships within the subreport and the primary report. You can
apply one or more links to make the subreport and the primary report interlinked.
The following example explains the use of sublinks in detail.
Assume that you have two report sets in the same catalog: one contains a customer report which has a
banded object inside and displays information of customer ID, country, city and phone, and the other
contains an order report which contains a crosstab showing information of customer ID, product name
and quantity. Now, you want to insert the order report as subreport into the customer report, and set
up a link between them, so that when the end users views the customer report, a subreport will be
built for each customer based on the order report, showing order records for only the specified
customer.
To achieve this, take the following steps:
1. Open the report set that contains the customer report in JReport Designer.
on the
2. Select the detail panel of the banded object and click the Insert Subreport button
Insert toolbar. A box is then attached to the mouse pointer to indicate it is ready to place the
subreport.
3. Click in the panel and the Subreport dialog is displayed.
4. Click the Browse button to select the report set that contains the order report as the subreport.
5. In the Field tab, click the Add button.
6. Check CTCrossTab in the Choose Component dialog, then click OK. The component is listed in
the Component in Report box.
7. Add the Customers_CustomerID field in the customer report to the Field box, a link is then
automatically set up as below:
Fields(Primary)
OP
Fields(Subreport)
Customers_Customer ID
CUSTOMERS_CUSTOMERS
ID
Note: When creating sublinks, you need to avoid link loop. For example, if you set the links between
the primary report A and subreport B (report A -> report B), you cannot set the link back to report A
(report A -> report B -> report A).
If a subreport parameter is mapped to another parameter, you will still be prompted to input the
value at runtime. In the Enter Parameter Values dialog, the parameter name you see is that of the
mapping parameter.
If a subreport parameter is mapped to a formula, the parameter will obtain value automatically from
the mapping formula.
When passing values between the subreport and the primary report, you should pay attention to
avoiding parameter loop, which may occur as this case: parameter A of the primary report is
assigned to parameter B of the subreport in the Parameters tab, while in the Return Value tab, B is
assigned to A. In this case, the values of A and B will depend on the default values and the position
relationship between the two parameters.
When you insert the subreport, you should insert it before the parameter, or the parameter will not
be the expected value.
To use the return value parameter in a formula, you need to add pagenumber in the first line in the
formula.
For example, all the formulas which referenced the return value parameter should be like:
pagenumber;
... ... ...
... ... ...
If the subreport will cross page, the result of the formula may not be the expected value because the
return value will only be calculated when finishing laying out the subreport.
Images
An image is a digital representation of a picture. JReport supports the following image formats: .bmp, .
gif, .jpg, and .png.
This section describes how to use the image component.
If you want to use an image from your local file system, use the Look in drop-down list to
browse for the image, then click Open. If the image file is not in the current catalog directory,
you will be prompted to copy it to the directory.
If you want to use an image via URL, enter the URL in the URL field and then click OK.
If want to use an image via URL and you are in an intranet, to successfully access the image, you
need to add the parameters -DproxyHost=XXX -DproxyPort=XX to JReport Designer's startup file
JReport.bat, which is located in <install_root>\bin.
If you insert an image via URL into a report, when the report is saved, only the URL information will
be saved into the report template.
When an image has been inserted into a report, you can customize its appearance and behavior by
setting properties in the Report Inspector, which can be saved as a CSS style for future use (for details,
see Creating a CSS style).
2. In the Master/Detail Report dialog, specify the target to which the image will be linked from the
Link to drop-down list and then set the options for the target.
3. When done, click OK.
For details about different link targets, see Binding a link to a label.
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how each component type could be used in a report. For the image component
example, open <install_root>\Demo\Reports\SampleComponents\ForImage.cls.
Maps
A map is a special kind of image in JReport. It contains a picture and certain areas that are bound with
groups in a banded object. Map features only work in the HTML and DHTML report output formats.
This section describes the following tasks related to maps:
Inserting a map
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how each component type could be used in a report. For the map component
example, open <install_root>\Demo\Reports\SampleComponents\MapReport.cls.
Inserting a map
Before you can insert a map, you need to create a tabular report or a banded object.
To insert a map into a report:
1. Select a tabular cell, or the banded header/footer, group header/footer, or banded page header/
footer panel of the banded object.
2. Click Insert > Map on the menu bar, or the Insert Map button
Editor window appears.
3. If you want to use an image as background of the map, click Insert > Background Image on the
menu bar of the Map Editor window, then click
the image.
4. Next is to add areas to the map. You can do this either by importing from an previously saved XML
file or an ESRI file which has been defined with some area information, or by drawing the areas
manually, or using a combination of these two.
To import the predefined map areas, click File > Open in the Map Editor window, then in the
Import Map Area dialog, specify the .xml file or .shp file that contains the required area information
and click Open to import the areas. If you choose to import the map areas from a .shp file, you
need to further specify a field in the ESRI shape file to define area name of the map, and if
required, you can also select fields from the ESRI shape file to define the area tooltips.
To draw the areas manually, first check the Insert Mode item on the Edit menu to switch the Map
Editor to insert mode.
To draw an area, click the left mouse button to pick the start point of the area. Move the mouse
pointer and click the left mouse button to select the other points. The points will be connected
automatically. When you move the mouse pointer to the start point, a square will appear indicating
that the area will be closed. Click the left mouse button to finish drawing the area. If you want to
undo your last line, click the right mouse button.
5. If you want to further change the shape or position of the areas, uncheck Insert Mode on the Edit
menu to change the Map Editor to edit mode.
To change the shape of an area, move the mouse pointer over the border or the points of the area.
When it becomes a cross, choose a point on the line and drag it to create a new point. You can also
choose a point of the area and drag it to a new position. If there are three points on one line, the
middle point will be deleted automatically.
To move an area, move the mouse pointer close its border. When it changes to a four-headed arrow,
drag the area to a new position.
Tip: If you have specified a background image for the map, and the size of it is not the same as
that of the map object, you can click Insert > Match Background Image in the Map Editor
window to resize the map object so as to make it match the size of the background image.
6. To bind data to the map areas, click Insert > Bind Data, then specify the settings according to your
requirements (for details, refer to Binding data to a map).
7. If you want to add some conditional formats to the map areas, click Format > Conditional
Formatting, then define the conditions and formats as required (for details, refer to Adding
conditional formats to map areas).
8. To make the map areas link to other reports, URLs or emails, set the Detail Report or Link property
on the map areas as required (for details, refer to Binding links to map areas).
9. In the Map Area Inspector panel, edit properties of any area, label, summary field and line in the
map if necessary.
10. If you want to save the area information you have defined in a file for future use, click File > Save
As. In the Save Map Area dialog, specify the directory where you want to save the file and a name
for it, then click Save. Then, when you create a report with a map next time, you can choose to
import areas from the saved XML file.
11. When done, click File > Save to save the changes to the map and close the Map Editor window.
12. Click the mouse button in the tabular cell, or banded panel to insert the map.
When a map has been inserted into a report, you can customize its appearance and behavior by setting
properties in the Report Inspector, which can be saved as a CSS style for future use (for details, see
Creating a CSS style).
See also Map Editor window for details about options in the window.
on the toolbar.
2. In the Data screen of the wizard, define or select the dataset with which the map will be bound.
New
If checked, the map will be bound with a new dataset created from the catalog resources.
Existing
If checked, specify the dataset in the current report set with which the map will be bound.
Current
If checked, the map will be bound with the dataset used by its parent.
3. In the Group screen, add a field as the grouping criteria to group data in the specified dataset. You
can add only one group by field.
4. In the Summary screen, add the fields as the sum on fields, and specify the function as required.
Data in each group will then be calculated based on the selected fields using the specified
function, and the summary results will be displayed accordingly on map areas the names of which
match with values of the group by field.
5. In the Filter screen, define some filter conditions to filter the data displayed on the map areas.
To define a filter condition, click the Add Condition button to add a condition line, then from the
field drop-down list, select the field on which the filter will be based, set the operator with which to
compose the filter expression from the operator drop-down list, and in the value combo box, type
the value of how to filter the field or click
2. Click the Add button to add a condition in the Edit Conditions dialog.
To link the area to a URL, in the displayed dialog, select A URL from the Link to drop-down list,
enter the link in the Hyperlink box, or click
to select a field which contains URL information or
create a formula to represent a URL to set the hyperlink, and then from the Target Frame dropdown list, specify where to load the linked target.
To link the area to an email, in the displayed dialog, select An Email from the Link to dropdown list, then compose the e-mail address with the text boxes.
For example, a field "Company" contains company information such as "Jinfonet", you can input
"sales" in the first text boxes, select "Company" from the drop-down list, and input ".com" in
the second text box. With this, you can click the area at runtime so as to write an e-mail to the
corresponding recipient. You can also type "[email protected]" into the first text box and leave
the drop-down list and the second text box empty, and thus clicking the area will write an email to the specific address.
3. In the Link Report dialog, specify the settings according to your requirements (for details, see
Linking a report to another report).
4. When done, click OK to apply the changes.
Then, when the map is viewed in HTML or DHTML report format, you can click the area to open the
linked report according to the specified link conditions, and when it is viewed in PDF format, you can
click the label or summary field of this area to open the linked report.
3. In the Master/Detail Report dialog, specify the settings according to your requirements (for
details, see Linking a report to a detail report).
4. When done, click OK to apply the changes.
Then, when the map report is published to JReport Server and run in JReport Viewer, you can click the
area to open the detail report according to the specified link conditions.
To change the alignment, click the required alignment button on the Map Editor toolbar: Justify
, Left
, Center
or Right
, or click the corresponding command from the Format >
Align submenu. The content in the label/summary field will then be aligned according to your
selection.
and Underline
To set the properties globally, in the Map Area Inspector panel, expand the Map Global Setting
node, select the sub node representing the label/summary field, then in the Properties panel, set
the properties as required.
To set the properties for any label/summary field in specific, in the Map Area Inspector panel,
select the node representing the label/summary field, edit the Use Default property of the label/
summary field to false, then set its properties.
For details about properties of labels and summary fields in a map, refer to Labels and Summary
fields in the Property References chapter.
places, however, after you do this, you will not be able know clearly the connection between each
label/summary field and the corresponding area. To keep you from being confused, JReport provides
you with the Auto Connector property on labels and summary fields on map areas, by enabling which
a line will automatically be drawn between the label/summary field and the area it describes when
the label/summary field is dragged out of the area. This property can also be set globally for all the
labels/summary fields in a map and for each label/summary field in specific.
For the automatically drawn lines, you can set the properties if required.
UDOs
A user defined object (UDO) is an object inherited from JReport system's object. You can add and
modify new properties, as well as other existing methods and specify new methods for modifying your
UDO. UDOs, which have been appended to the ADDCLASSPATH variable of setenv.bat in
<install_root>\bin, can be inserted as components into a report and consequently become a part of
the report.
For details about the usage of UDOs, refer to User defined object.
Barcodes
A barcode can be used as a component and directly inserted into a report. To do this:
1. Do one of the following to open the Barcode Expert dialog.
2. Select a dataset from the Barcode Resources drop-down list, and then specify the source of the
barcode: a DBField, formula, summary, or parameter.
3. Select the required barcode type from the Symbology drop-down list. You can preview the format
of the selected symbology in the Sample box (for details about barcode symbologies, see
Appendix 2: Barcode symbologies).
4. Select the unit for the values of the quiet zone, narrow width, supplement, height and ratio from
Where a barcode can be inserted in a report depends on what you have selected as its source.
You can also create a barcode component by first inserting a DBField, formula, summary or
parameter and then changing its display type to barcode.
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how each component type could be used in a report. For the barcode component
example, open <install_root>\Demo\Reports\SampleComponents\Barcode.cls.
Ranks
A rank is a component that is based on the value of another component - a DBField, formula,
summary, or parameter. One or more values for these fields can be mapped to an image known as the
rank. The rank component allows you to convert raw data values to easy-to-understand graphical cues
or to hide sensitive details but still convey the general data value to the report end users.
To insert a rank into a report:
1. Do one of the following:
2. The Rank Resources drop-down list displays the dataset available for the current insertion, and the
list box below shows its fields, including DBFields, formulas, summaries and parameters.
Select the field you want to insert as rank from the list box. You can also create formulas,
summaries, and parameters here.
3. Click the Browse button to select an image file to be the default image (used if a value does not
fit any of the specified value ranges).
4. Type the alternate text of the default image in the Default Image Alternate Text box, which will be
displayed when the image cannot be loaded or is unavailable.
5. In the Value Range box, specify the minimum value, maximum value, image and alternate text
respectively in the Minimum, Maximum, Image, and Alternate Text columns. Click
or
to
or
. A value, which is larger
add or delete a range. To adjust the order of the ranges, click
than or equal to the minimum value of a range and less than the maximum value, will be
displayed as the image, or the alternate text if the image cannot be loaded or is unavailable. For a
value belonging to two or more overlapping ranges, the highest range in the Value Range box will
take effect.
6. Click Insert in the dialog, then click the mouse button in the location where you want the rank to
be displayed.
Notes:
Where a rank can be inserted in a report depends on what you have selected as its source.
You can also create a rank by first inserting a DBField, formula, summary or parameter, and then
changing its display type as rank.
Example
Suppose that you want to define product quality rank based on customer grading, and you want to
define three levels:
50-70, Poor
71-90, Good
91-100, Excellent
Specify the following in the Value Range box:
1. In the first range line, set the minimum and maximum values as 50 and 70 respectively in the
cells of the Minimum and Maximum columns. Go to the Image cell, and then click <Browse...> to
select an image to represent the rank. Click the Alternate Text cell and enter Poor.
2. Click
to add another line. Set the minimum and maximum values as 71 and 90, select
another image to represent the rank and enter Good in the Alternate Text cell.
3. Add one more line, and set the values, image and name for Excellent in the same way as before.
You have successfully defined a rank for product quality.
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how each component type could be used in a report. For the rank component
Drawing objects
You can add arcs, ovals, boxes, round boxes and lines to your report.
Drawing objects can only be inserted into banded objects. To insert a drawing object into a report, you
can use either of the following two methods:
Click Insert > Drawing Objects on the menu bar, then click the drawing object (Line, Box, Arc,
Oval, or Round Box) you want to insert on the submenu.
Select an item from the drawing object drop-down list
Then, move your mouse pointer to the insertion point, drag the mouse button till you are satisfied with
the drawing object's size and proportions. The selected drawing object will then be inserted into your
report at the specified position. Note that only boxes, horizontal or vertical lines can be presented in
DHTML format.
When a drawing object has been inserted into a report, you can customize its appearance and
behavior by setting properties in the Report Inspector.
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how each component type could be used in a report. For the drawing object
example, open <install_root>\Demo\Reports\SampleComponents\ForDrawingObject.cls.
Web controls
Web controls are report components designed to be similar to the kinds of controls found on web
pages. JReport provides some web controls such as text fields, drop-down lists, and buttons that are
usually used in web pages. In most cases, web controls are not used independently. They are bound
with some web actions, or put into a form. When a web control is bound with some web actions which
will be triggered on certain events, any of the events applied to the web control will perform the web
actions. You can also add some web controls into a form, and then define the form according to your
requirements, so that the inputs at runtime can be submitted to JReport Server and thus be processed.
Based on the different functions and usages, web controls are divided into two types: basic web
controls and advanced web controls. For the basic web controls, you need to bind web actions to them
by yourself, however, advanced web controls are defined with specific web actions or are used for
specific purposes so that you can use them directly. In addition, the basic web controls can be inserted
into normal reports only, while the advanced web controls are supported in both normal reports and
studio reports.
This section explains how to use web controls in JReport as follows:
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how each component type could be used in a report. For the web control
example, open <install_root>\Demo\Reports\SampleComponents\WebControls_*.cls.
Text field
To insert a text field and define its values:
1. Do one of the following to insert the text field:
2. Right-click the text field and select Display Type from the shortcut menu. The Display Type
dialog will appear.
3. In the Web Options panel of the Display Type dialog, select the type of the text field: Standard or
Password.
Standard means that the text field will be a normal text field. Password means that the text field
will be a password box in which the typed characters will be displayed as asterisks.
4. Enter the name, value for the text field in the Name and Value fields.
5. In the Tool Tip field, enter the tip you want to show for the text field. Then after the report is
exported to HTML or DHTML, when you hover the mouse over the text field, the tooltip will be
displayed.
6. Set the character width in the Display Width field, and the maximum number of characters the
user can enter in the Max Length field.
7. Check the Read Only option if you would like to set this text field to be read-only.
8. Check the Disabled checkbox if you want to make the text field disabled.
9. Bind some web actions to the text field in the Web Behaviors box.
10. Upon finishing, click the OK button to close this dialog.
Hidden field
2. Right-click the hidden field and select Display Type from the shortcut menu. The Display Type
dialog will appear.
3. In the Web Options panel of the Display Type dialog, specify the name and value of the hidden
field.
4. Bind some web actions to the hidden field in the Web Behaviors box.
5. Upon finishing, click the OK button to close the dialog.
Text area
A text area allows you to input a multi-line string.
To insert a text area and define its values:
1. Do one of the following to insert the text area:
2. Right-click the text area and select Display Type from the shortcut menu. The Display Type
dialog will appear.
3. In the Web Options panel of the Display Type dialog, enter the name, value of the text area in the
Name and Value fields.
4. In the Tool Tip field, enter the tip you want to show for the text area. Then after the report is
exported to HTML or DHTML, when you hover the mouse over the text area, the tooltip will be
displayed.
5. Set the character width in the Display Width field.
6. Specify the number of lines that the text area will allow in the Number of Lines field, and choose
whether or not to wrap the text by selecting true or false from the Auto Wrap drop-down list.
7. Check the Read Only option if you would like to set this text area to be read-only.
8. Check the Disabled checkbox if you want to make the text area disabled.
9. Bind some web actions to the text area in the Web Behaviors box.
10. Upon finishing, click the OK button to close this dialog.
Checkbox/Radio button
The way to insert and define the values of a checkbox and radio button is the same.
To insert a checkbox/radio button and define its values:
1. Do one of the following to insert the checkbox/radio button:
2. Right-click the checkbox/radio button and select Display Type from the shortcut menu. The
Display Type dialog will appear.
3. In the Web Options panel of the Display Type dialog, specify the name, value of the checkbox/
radio button in the Name and Value fields.
4. In the Tool Tip field, enter the tip you want to show for the checkbox/radio button. Then after the
report is exported to HTML or DHTML, when you hover the mouse over the checkbox/radio button,
the tooltip will be displayed.
5. Set Initially Checked to true if you want the checkbox/radio button to be selected by default.
6. Check the Disabled checkbox if you want to make the checkbox/radio button disabled.
7. Bind some web actions to the checkbox/radio button in the Web Behaviors box.
8. Upon finishing, click OK to close this dialog.
Image button
To insert an image button and define its values:
1. Do one of the following to insert the image button:
If you choose to use the original size of the image, check the Original Size option.
If you want to use customized image size, uncheck Original Size, and then set the display
width and height of the image in the Width and Height fields. Check the Constrain Proportion
option if you want to constrain aspect ratio of the image when setting the width and height.
10. Bind some web actions to the image button in the Web Behaviors box.
11. Upon finishing, click the OK button to close the dialog.
Button
A button is for submitting or resetting a form.
To insert a button and define its values:
1. Do one of the following to insert the button:
2. Right-click the button and select Display Type from the shortcut menu. The Display Type dialog
will appear.
3. In the Web Options panel of the Display Type dialog, enter the name, value of the button in the
Name and Value fields.
4. In the Tool Tip field, enter the tip you want to show for the button. Then after the report is
exported to HTML or DHTML, when you hover the mouse over the button, the tooltip will be
displayed.
5. Select the action of the button: None, Submit Form or Reset Form.
6. Check the Disabled checkbox if you want to make the button disabled.
7. Bind some web actions to the button in the Web Behaviors box.
8. Upon finishing, click OK to close this dialog.
List/Drop-down list
List and drop-down list are generally called multivalue containers. A list or drop-down list provides a list
of values for users to select from. While, a drop-down list occupies a smaller space than a list box so
that a report can be laid out more compactly.
To insert a list/drop-down list and define its values:
1. Do one of the following to insert the list/drop-down list:
2. Right-click the list/drop-down list and select Display Type from the shortcut menu. The Display
Type dialog will appear.
3. In the Web Options panel of the Display Type dialog, enter a name for the list/drop-down list in
the Name field.
4. In the Tool Tip field, enter the tooltip you want to show for the list/drop-down list. Then after the
report is exported to HTML or DHTML, when you hover the mouse over the list/drop-down list, the
tooltip will be displayed.
5. Specify the item labels and the value of each item in the items box by inputting some strings as
the labels and values respectively.
If you want to use a DBField/formula field/parameter field to control the value, click
in the
Value column to insert one with the Insert Fields dialog, and then select the format for the
inserted field from the drop-down list in the Item Label column. Check the All radio button in the
Insert Field dialog if you want to add an All value to the list/drop-down list. Then when All is
selected as value of the list/drop-down list at runtime, all filter actions defined on the list/dropdown list will not take effect, and if you applied some other web action that needs value from the
list/drop-down list, a Null value will be returned.
6. If the display type is defined as List, you can check the Allow Multiple checkbox if you want to
The display type of a basic web control can also be changed after it has been created. Basic web
controls other than list and drop-down list can be converted to each other, and can be displayed as a
general type. You may notice that these web controls have a common Class Type property value
"Label" in the Report Inspector, and this signifies that these web controls are labels in nature.
List and drop-down list can be converted to each other, while cannot be displayed as any other type.
DBFields, parameter fields, formula fields, summary fields, special fields, and images can also be
displayed as a basic web control type. From this view, these objects can be considered as basic web
controls too.
Some of the basic web control values can be controlled by formulas. To control a value by a formula,
If you have specified a tooltip for any basic web control, when the report is opened in HTML or
DHTML format, the tooltip of the basic web control will be displayed differently on different browsers:
On Internet Explorer, the tip text will be automatically wrapped if its length exceeds the maximal
tip width the browser allows. In addition, for Internet Explorer, you can manually make some text
displayed in a new line by adding 
 or 
 ahead of the text when editing it in the Tool Tip
field.
On Firefox, the tip text will be displayed in one line with the maximal tip width the browser allows,
and the text that cannot be displayed within the width will be cut off and replaced by ellipsis.
2. In the dialog, specify the parameter you want to add to the parameter control from the Select a
Parameter box, which lists all the parameters except cascading parameters used in the current
report set.
3. When done, click OK to insert the parameter control into the desired destination.
Drag Parameter Form Control from the Toolbox panel to the destination.
Click Insert > Web Controls > Parameter Form Control on the menu bar, then click the
mouse button in the desired location in the report.
On the Insert toolbar, click the down arrow on the Insert Control Objects button
and
select Parameter Form Control from the drop-down list, then click the mouse button in the
desired location in the report.
2. Specify the target report sets to run using the parameter form control.
To run the current report set, select Current Report, then specify the parameters used to run
the report set from the Select Parameters box.
To run other report sets, select Others, then select the report sets you want to run. All the
parameters used by the selected report sets are displayed in the Parameter Information box. If
all the selected report sets contain no parameters, you cannot finish the dialog.
3. Specify whether to include the Submit button in the parameter form control. If Submit is included,
it is used to submit the parameter values end users specify in the parameter form control. If
Submit is not included, once end users change the value of a parameter in the parameter form
control, the new value will be applied automatically.
4. When done, click OK to insert the parameter form control into the desired destination.
Click Insert > Web Controls > Filter Control on the menu bar, then click the mouse button
in the desired location in the report.
On the Insert toolbar, click the down arrow on the Insert Control Objects button
select Filter Control from the drop-down list, then click the mouse button in the desired
location in the report.
and
2. In the dialog, browse to the required data source, then select a field in the data source on which
the filter control is based.
3. When done, click OK to insert the filter control. Then at runtime, all values of the specified field
will be listed in the filter control. End users can select one or more values to apply.
In addition, after a filter control is inserted into a report, you can further modify it if necessary. To do
this:
1. Right-click the filter control and select Edit Filter Control from the shortcut menu. The Filter On
dialog appears.
A navigation control can be considered as an accessorial control for filter controls and is used to deal
with the value selection operations in all the filter controls in the same report.
To insert a navigation control into a report, do either of the followings:
Back
Goes back to the previous value selection status and refreshes the report data accordingly.
Clear
Removes all the value selection histories and all the filter conditions based on the selections, and
refreshes the report data accordingly.
Forward
Goes forward to the next value selection status and refreshes the report data accordingly.
By default, these three buttons are displayed as normal buttons, however, you can change their button
type to be image button if necessary. To do this:
1. Select the target button, right-click it and select Button Type > Image Button from the shortcut
menu.
2. In the Image Button dialog, click Browse to specify the path or input the URL of the image source
directly in the text field.
3. Click OK to confirm.
If you want to get back the normal button type, you just need to right-click the target image button,
and select Normal Button from the Button Type submenu.
Notes:
If you save a report set containing a parameter form to another directory or publish it to local
directory or to JReport Server, the report sets that you selected in the parameter form in order to run
will not be saved or published along with the report set.
After an advanced web control has been inserted, you can customize its appearance and behavior by
setting properties in the Report Inspector, which can be saved as a CSS style for future use (for
details, see Creating a CSS style).
End users can also insert these advanced web controls (except Expand/Collapse Group) into reports
at runtime the same as report designers would do in JReport Designer. For details about how to use
the web controls at runtime, see Applying web controls in the JReport Server User's Guide.
Description
Blur
Data Change
Click
Fires when the user clicks the left mouse button on the object.
onContextMenu
Fires when the user clicks the right mouse button on the object, opening the
shortcut menu.
Double_Click
Focus
Key Down
Key Press
Key Up
Mouse Down
Fires when the user clicks the object with either mouse button.
Mouse Move
Fires when the user moves the mouse over the object.
Mouse Out
Fires when the user moves the mouse pointer outside the boundaries of the object.
Mouse Over
Fires when the user moves the mouse pointer into the object.
Mouse Up
Fires when the user releases a mouse button while the mouse is over the object.
Resize
Scroll
Fires when the user repositions the scroll box in the scroll bar on the object.
Select
4. In the Web Action List dialog, select the required action and then click OK.
If the selected web action is Filter, Sort or Parameter, the Web Action Builder dialog will then
appear. Specify the settings according to your requirements and then click OK to return to the
Display Type dialog.
If the selected action needs no parameter, the Web Action List dialog will be closed and you will
return to the Display Type dialog.
If the selected web action needs parameter, the Parameters dialog will be displayed for you to
input the parameter value. For parameters that refer to instance name, you can input the
mapping name of the instance, or the display name plus the prefix "&" as the parameter value.
Click OK after specifying to return to the Display Type dialog.
5. Click
or
. Then, when an event that has
6. Adjust the order of the added web actions by clicking
been bound with more than one action happens, the upper action will be triggered first.
7. Click OK to apply the settings and close the Display Type dialog.
Then, when you run the report in JReport Viewer, the occurrence of any of the specified events will fire
the actions that have been bound to the web control. For detailed usages of these web actions, see the
following sections:
Filter
Sort
Parameter
Note: You can define your own web actions by adding API functions into both the file API.js located at
<designer_install_root>\lib\html\javascript\dhtml and the same-name file located at
<server_install_root>\public_html\dhtmljsp\js.
Filter
The Filter web action enables you to filter the records in a banded object, table or crosstab.
To bind the Filter web action to a web control:
1. Insert the required web control into your report by dragging a button from the Toolbox panel.
2. Right-click the web control, and then select Display Type from the shortcut menu.
3. In the Web Behaviors box of the Display Type dialog, choose an event from the Events column,
and then click
4. In the Web Action List dialog, select Filter and click OK. The Filter - Web Action Builder dialog
appears.
5. From the Get Input from drop-down list, specify where to get the web control, which may be a
form, or other in report.
6. From the Apply Action to drop-down list, select a component whose records will be filtered.
7. In the Filter on column, specify the field on which to filter the records. The field may be a column
in the component, or be specified by the value of a web control.
8. Specify the operator and value. The value may be input by yourself, or be the value of a web
control.
9. If necessary, specify And or Or in the More column so as to add a new filter condition or you can
click
or
Sort
The Sort web action enables you to sort the records in a banded object.
To bind the Sort web action to a web control:
1. Insert the required web control into your report by dragging the corresponding button from the
Toolbox panel.
2. Right-click the web control, and then select Display Type from the shortcut menu.
3. In the Web Behaviors box of the Display Type dialog, choose an event from the Events column,
and then click
4. In the Web Action List dialog, select Sort and click OK. The Sort - Web Action Builder dialog
appears.
5. From the Get Input from drop-down list, specify where to get the web control, which may be a
form, or other in report.
6. From the Apply Action to drop-down list, select a banded object whose records will be sorted.
7. In the Sort on column, specify the field on which to sort the records. The field may be a column in
the banded object, or be specified by the value of a web control.
8. Specify the sort value. The value may be Ascending or Descending, or be the value of a web
control.
9. If necessary, click
or
Parameter
The Parameter web action enables you to run a report set, especially a report set with parameters.
To bind the Parameter web action to a web control:
1. Insert the required web control into your report by dragging a button from the Toolbox panel.
2. Right-click the web control, and then select Display Type from the shortcut menu.
3. In the Web Behaviors box of the Display Type dialog, choose an event from the Events column,
and then click
4. In the Web Action List dialog, select Parameter and click OK. The Parameter - Web Action Builder
dialog appears.
5. Specify the handler which will receive the parameters of the web action. The handler may be the
default one in the current server, or in another server specified by Customized Path.
6. From the Get Input from drop-down list, specify where to get the web control, which may be a
form, or other in report.
7. Specifies whether to apply the action to run a report set or refresh the current. If you choose to
run a report set, click the Browse button to specify the report set or use a web control to retrieve
the report set name, then select the window or frame in which the report set will be opened from
the Target Frame drop-down list.
8. The parameters used by the specified report set will be automatically listed in the parameters box.
Specify the value for each parameter.
9. Click OK to accept the settings.
See also Parameter - Web Action Builder dialog for details about options in the dialog.
Besides the way of binding the Parameter web action to a web control, two standalone web controls
can achieve the same purposes: parameter control which is used to specify a parameter to a report and
parameter form control which is used to run report sets. For details about the usages of the two web
controls, see Using parameter control to specify a parameter to a report or Using parameter form
control to run report sets.
Parameter
user_atuoRefreshALLDataSet
Description
Refreshes the report data automatically at certain interval.
time
user_bottomN
Shows records with the field value equal to one of the last N
field values in a component.
instanceName
columnMappingName
value
user_changeComboChartType
isPrimaryAxis
index
type
user_changeCompProperty
instanceName
propertyName
value
isBy
user_changeGenericChartType
isPrimaryAxis
type
user_changeStyleTo
user_chartToCrosstab
instanceName
user_closeReportSet
user_closeRpt
user_crosstabToChart
user_deleteRpt
user_downloadReport
type
optionValues
user_drillTo
columnBLName
user_exit
user_filter
instanceName
columnMappingName
operator
value
user_firstPage
user_groupFlex
user_lastPage
user_nextPage
user_oneStepExport
optionValues
user_oneStepFilter
operators
values
logics
instanceName
user_oneStepSearch
isContent
columnMappingName
isUp
isMatchCase
isWordOnly
user_oneStepSort
orders
instanceName
user_openNewReport
rptName
newWindow
params
user_prevPage
user_popCustomizedPage()
user_redo
Redoes an action.
user_refresh
user_renameRpt
user_reset
instanceName
user_rotateCrosstab
Rotates a crosstab.
instanceName
user_saveRpt
user_showDHTMLView
user_showFilterDialog
user_showHelp
user_showNewRptDialog
user_showOpenRptDialog
user_showPageSetupDialog
user_showPrintDialog
user_showSaveAsDialog
user_showSaveResultDialog
user_showSearchDialog
user_showSortDialog
user_showTOC
user_showToolbox
user_showUserPanel
user_sort
columnMappingName
order
user_stopAutoRefreshDataSet
user_topN
instanceName
columnMappingName
value
user_undo
Undoes an action.
user_zoomTo
Note: If you are very familiar with usages of the web actions, you can select the first item Input an
Action, and then input the action name with parameter (if necessary).
Dialog/Wizard
Help File
40011
Chart Wizard
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_chtwzd.
htm
40012
Crosstab Wizard
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_crstbwzd.htm
40013
Banded Wizard
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_bdwzd.
htm
40014
Table Wizard
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_tblwzd.
htm
40015
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_dbprpty.htm
40016
Filter dialog
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_fltr.htm
40017
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_imgprpty.htm
40018
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_lblprpty.htm
40019
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_newrpt.
htm
40020
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_newtlbar.htm
40021
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_opnrpt.
htm
40022
Options dialog
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_optn.
htm
40023
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_pgprpty.htm
40024
Print dialog
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_print.
htm
40025
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_rptprpty.htm
40026
Save As dialog
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_svas.
htm
40027
Export dialog
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_expt.
htm
40028
Search dialog
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_search.
htm
40029
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_slctvalue.htm
40030
Sort dialog
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_sort.
htm
40031
40032
Split dialog
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_split.
htm
40033
Top N dialog
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_topn.
htm
40034
To Chart dialog
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_tochart.htm
40036
Bottom N dialog
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_btmn.
htm
40037
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_fmtpapr.htm
40038
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_fmtpltfrm.htm
40039
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_crstbprpty.htm
40040
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_grpprpty.htm
40041
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_mltvluprpty.htm
40042
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_prmtrprpty.htm
40043
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_rptbdyprpty.htm
40044
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_bdobjprpty.htm
40045
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_bdpnlprpty.htm
40046
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_tableprpty.htm
40047
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_tablecelprpty.htm
40048
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_tablerowprpty.htm
40049
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_tblrprpty.htm
40050
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_tblrcelprpty.htm
40051
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_txtbxprpty.htm
40052
To Crosstab dialog
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_tocrstb.
htm
40053
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_cndtnlfmt.htm
40054
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_chtdef.
htm
40055
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_cnvrtdata.htm
40056
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_rptprmtr.htm
40057
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_fmtlgnd.htm
40058
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_fmtlbl.
htm
40059
Encoding dialog
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_encode.htm
40060
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_pdfencrpt.htm
40061
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_pdfsign.htm
40062
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_mxrec.
htm
40063
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_renmrpt.htm
40064
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_svtmplt.htm
40065
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_slctcolor.htm
40066
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_newrptset.htm
40067
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_tn2pg.
htm
40068
Zoom dialog
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_zoom.
htm
40069
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_qryfltr.
htm
40070
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_edtcndtn.htm
40071
Order/Select N dialog
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_ordrslctn.htm
40072
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_appstyl.htm
40073
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_insrtimg.htm
40074
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_addmsr.htm
40075
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_fmlaedtr.htm
40076
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_slctrsc.
htm
40077
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_entervlu.htm
40078
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_edtmsr.
htm
40079
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_cstmzdpg.htm
40080
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_btnprpty.htm
40081
40082
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_insrtfltrctrl.htm
40083
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_insrtprmctrl.htm
40084
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_insrtprmfrmctrl.htm
40085
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_nvgctrlprpty.htm
40086
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_prmctrlprpty.htm
40087
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_prmfrmctrlprpty.htm
40088
Aggregate On dialog
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_agrgton.htm
40089
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_insrtdtlclmn.htm
40090
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_insrtgrpclmn.htm
40091
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_insrtsumclmn.htm
40092
<install_root>\help\server\en\userguide\HTML\dialog
\dlg_dhtml_slctgrppstn.htm
40093
<install_root>\help\server\en\userguide\HTML\dialog\dlg_dhtml_slctfld.
htm
Property Name
ArcShape
Area
BandedColumnInfos
BandedFooter
BandedHeader
BandedObject
BandedPageFooter
BandedPageHeader
BandedPagePanel
Box
ChartLabelObject
ChartLegendObject
ChartObject
ChartPaperObject
ColAttribute
Column
CTAggField
CTAggSpecialField
CTCrossTab
CTDBField
CTDBTitleField
CTLabelField
CTTextField
DBField
DetailPanel
Form
GroupControlImg
GroupFilter
GroupFooterPanel
GroupHeaderPanel
GroupPanel
HDSDataSet
Image
JBrowser
JHyperLink
JRotator
Line
Map
MapDBField
MapTextField
MultiValueContainer
OLEObject
OnDemandDataSet
OvalShape
PageFooterPanel
PageHeaderPanel
ParallelDetailPanel
ParallelGroupPanel
ParameterField
QueryDataSet
Report
ReportBody
ReportSet
ImportParamValues, ParaListAuto
RoundBoxShape
SpecialField
Subreport
TableCell
TableComp
TableDetail
TableFooter
TableGroup
TableGroupFooter
TableGroupHeader
TableHeader
Tabular
TabularCell
TabularColumnGroup
TabularRowGroup
TextBox
TextField
TOC
Export Option
Key
Available Value
Description
to_ver
true, false
to_open
true, false
to_local
true, false
browser
0 (Internet Explorer), 2
(Firefox).
imagetype
0 (decided by JReport), 1
(GIF), 2 (JPG), 3 (PNG).
overflow
0 (VISIBLE), 1 (HIDDEN), 2
(VERFLOWCOUNT).
resolution
title
Any string
applet
true, false
css
true, false
multi
true, false
hyperlink
true, false
pagenumber
true, false
drilldown
true, false
Specifies whether or not to include the drilleddown file in the exported HTML file.
no_margin
true, false
absolute
true, false
to_ver
true, false
to_open
true, false
to_local
true, false
no_margin
true, false
simulate
true, false
standard
true, false
content
true, false
drilldown
true, false
Specifies whether or not to include the drilleddown file in the exported PDF file.
encrypt
true, false
compress
true, false
ratio
compatibitly
Any string
permi_psw
Any string
printing
changes
0: Prevents users from making Defines which editing actions are allowed in the
any changes to the file).
PDF file.
1024: Allows inserting,
deleting, and rotating pages.
256: Allows users to fill in
form fields and adding digital
signatures.
32: Aallows users to fill in form
fields and add digital
signatures and comments.
40: Allows users to do
anything except extracting
pages.
2108: Allows all.
Text
Excel
enable_copy
true, false
enable_access
true, false
to_ver
true, false
to_open
true, false
to_local
true, false
repeat
true, false
compress
true, false
win_linebreak
true, false
normal
true, false
quote_mark
true, false
head_foot
true, false
delimiter
width
An integer
height
An integer
to_ver
true, false
to_open
true, false
to_local
true, false
wrap
new_layout
true, false
shapes
true, false
excel_2000
true, false
XML
RTF
PostScript
advanced
true, false
header
Any string
footer
Any string
gridline
true, false
to_ver
true, false
to_open
true, false
to_local
true, false
only_data
true, false
schema
An existing schema file with its Specifies the name of an existing schema file
full path.
with its full path with which to generate the XML
file.
to_ver
true, false
to_open
true, false
to_local
true, false
rtf_flow
true, false
no_margin
true, false
to_ver
true, false
to_open
true, false
to_local
true, false
no_margin
true, false
Value
Classic
Classic
Classic Blue
ClassicBlue
Classic Green
ClassicGreen
Default
Default
None
None
):
Then, in the Web Behaviors box of the dialog, set Event to Data Change, Action to user_changeStyleTo, and specify the
value for the web action parameter styleName to this.value.
Value
Unit Price
UNIT PRICE
Quantity
QUANTITY
4. Insert a List web control next to the drop-down list. The list is displayed as MultiValueContainer2 in the Report Inspector.
5. In the Display Type dialog for this list, add these items and corresponding values:
Item Label
Value
Ascending
Ascending
Descending
Descending
6. Insert a Button web control and place it next to the list, then right-click the button and click Display Type on the shortcut
menu.
7. In the Display Type dialog, specify Event to Click and Action to Sort, then in the Sort - Web Action Builder dialog, select
MultiValueContainer1 from the Sort on column, and MultiValueContainer2 from the Sort Value column. Confirm the
settings, and go to the Report Inspector to modify the Text property of the button to Sort.
Previewing the report set in DHTML and applying the web actions
1. Click View > Preview As > DHTML to preview this report set in DHTML format.
2. Click the Search button and the Search dialog will then be displayed.
3. Click the Rotate Crosstab button, the columns and rows of the crosstab will then be rotated.
4. Select a style from the Change Report Style To drop-down list, for example, select Classic Green, and the report style will
change to the selected one. It affects both the banded object and the crosstab.
Note: You may notice that the value of the drop-down list will not change to the selected one after the report style has
been updated. To update the drop-down list value to the current report style, you should append another action
user_changeCompProperty to the event Data Change to the drop-down list.
5. Select a field name from the third drop-down list and then the sorting direction from the list. Here we select Unit Price and
Descending respectively, then click the Sort button.
The records in the banded object will now be sorted based on the Unit Price values descendingly.
Creating a form
To create a form in a report, you can do either of the following:
Remove All Controls: Removes all the objects added to the form.
Max Length: 30
4. Right-click the button, click Display Type on the shortcut menu and set the following options in
the Display Type dialog:
Value: Google
Action: Submit Form
5. Select the two web controls, then right-click and select Add to Form > Add to New Form from
the shortcut menu.
6. Set the properties of the form in the Report Inspector as follows:
Form Action: http://www.google.com/search
Form Method: get
Form Target: blank
7. Save the report set and preview it in DHTML format.
Now you can input a string up to 30 characters in the text field, and then click the button Google
to search for that string. The search result will be displayed in a new browser window.
Note: For a table, if you add a field to a new form, the form will be created in the first cell of the table
row which contains the field, and fields in the previous table rows cannot be added to this newlycreated form. If you add columns before the first cell, then fields in these columns of the same table
row also cannot be added to the form.
Multimedia Objects
Multimedia objects, including Applet, Flash, RealMedia, and Windows Media objects can be inserted in
the report areas listed in Component placement.
The following explains how to insert different multimedia object into a report:
2. Click the Browse button to select a flash file, or type the URL of a flash file in the File Name/URL
field.
3. In the Plug-in Page field, set the URL of the plug-in page. By default, it is http://www.
macromedia.com/go/getflashplayer.
4. Specify the properties so as to control the options when playing the flash file in JReport Viewer or
JReport Studio.
5. Click OK in the dialog to insert the object in the required location.
When you view the report result with a web browser in which the Flash Player plug-in has been
installed, the media file will be played according to your settings.
2. Click the Browse button to select a RealMedia file, or type the URL of a RealMedia file in the File
Name/URL field.
3. In the Plug-in Page field, set the URL of the plug-in page. By default, it is http://www.real.com/.
4. Specify the properties so as to control the options when playing the media file in JReport Viewer or
JReport Studio.
5. Click OK in the dialog to insert the object in the required location.
When you view the report result with a web browser in which the RealPlayer plug-in has been installed,
the media file will be played according to your settings.
2. Click the Browse button to select a Windows Media file, or type the URL of a Windows Media file
in the File Name/URL field.
3. In the Plug-in Page field, set the URL of the plug-in page. By default, it is http://www.microsoft.
com/Windows/MediaPlayer/.
4. Specify the properties so as to control the options when playing the media file in JReport Viewer or
JReport Studio.
5. Click OK in the dialog to insert the object in the required location.
When you view the report result with a web browser in which the Windows Media Player plug-in has
been installed, the media file will be played according to your settings.
When a multimedia object has been inserted into a report, you can further edit it if required (to do this,
right-click the object and select Edit WebOLEObject from the shortcut menu). You can also customize
its appearance and behavior by setting properties in the Report Inspector, which can be saved as a CSS
style for future use (for details, see Creating a CSS style).
See an example: The SampleComponents catalog, included with JReport Designer, contains reports
that have examples of how each component type could be used in a report. For the label component
example, open <install_root>\Demo\Reports\SampleComponents\MultimediaObject.cls.
DHTML Features
Reports developed by JReport Designer can be published to a standalone JReport Server or to web
applications integrated with JReport Server. After that they can be viewed and analyzed in JReport
Viewer. Certain DHTML features require a report to be pre-configured in JReport Designer before being
published to JReport Server.
Pick a task from the following:
Linking reports
See also the chapter JReport Viewer - Interactive Reports in the JReport Server User's Guide for details
about how to use these features in JReport Viewer.
Note: In addition to the above features, JReport allows you to create a table of contents for DHTML use
by setting the TOC Anchor and Anchor Display Value properties for each component in a report, then in
JReport Viewer, you can use the TOC Browser to locate the component. For details about how to show
components in a TOC tree, see Editing a report.
Note: A JReport Designer Live license is required in order to use this feature. If you do not have a Live
license please contact your Jinfonet Software account manager to obtain a license.
Categories
Categories are the main tools for organizing data. They are components which correspond to particular
collections of data in the data source. They are grouped in folders that are named to reflect information
collections. A category can contain several subcategories.
Organizing data required by a user into multiple categories or multiple levels of categories is
meaningful, and makes it easy to use. End users can use categories to find data elements they need to
use without knowing the underlying table names although sometimes the table names are used as
categories.
Dimension objects
Dimension objects are cube elements that are the basis for analysis in a report. They present the
availability and key performance of data, and characteristically return text data or dates, and answer
the following question: who, when, what, where and which. A dimension object can be inserted
wherever a field can be inserted, as a column or row in a crosstab, or as a group field or detail field in a
table or banded object or as a category or series in a chart. They may be based on DBFields such as
region and country or they could be based on formulas such as the year, quarter, or month portion of a
date field.
Measure objects
Measure objects are numeric cube elements that are calculated dynamically at run time. Measures can
be used alone or calculated with other fields. A measure object can be inserted wherever a summary
can be inserted. For instance, it can be inserted into the group header or footer panel in a table or
banded object, or into a crosstab as an aggregate field. A measure object can also be used as a detail
field in a banded object or table although it will display the same aggregate value for every detail line.
JReport calculates values based on the group level at which the measure object is inserted such as total
sales, average order size and number of orders from a customer.
9. Click File > Close to close the window. The business/report cube will now have been added to the
catalog.
To edit a business cube, right-click the business cube in the Business Cubes node and select Edit
Business Cube from the shortcut menu.
To edit a report cube, select the query, stored procedure, imported SQL file, or user defined data
source, on which the report cube has been defined, in the Report Cube node, right-click the report
cube and then select Edit Report Cube from the shortcut menu.
Then, in the Business/Report Cube Editor window, edit the business/report cube as required. For
example, you can add some elements to it and define hierarchies.
The following topics show how to edit an existing business/report cube in detail:
Adding elements
Configuring security
Defining hierarchies
Creating filters
See also Business Cube Editor window and Report Cube Editor window for additional help about options
in each window.
Adding elements
You can add more elements to a business/report cube at any time to suit your requirements.
Adding a category
To add a category, follow the steps below:
1. In the Business/Report Cube Editor window, select the business/report cube (or any existing
category) in the right panel, right-click and then click Add Category to display the Category
Property dialog.
2. In the General tab, set the name and display name for the category in the Name and Display
Name text fields. The name and display name must be unique at current level.
3. Type a description for the category in the Description text box if required, which will be shown
when you hover the mouse pointer over the category in the Resource View panel of JReport
Viewer.
4. Click the Security tab and set permission to the category as required (for details, see Configuring
security).
5. Click OK. A new category will be added to the business/report cube (or a selected category). You
2. In the General tab, decide the type of the cube element by selecting the corresponding item
from the Type drop-down list. It can be Dimension, Measure or Detail Info.
3. In the Name text field, specify the name of the cube element as required. The name must be
unique at current level.
4. Click the chooser button
the cube element.
next to the Mapping Name text field to specify the mapping field of
5. Specify the display name of the cube element in the Display Name text field.
By default, the display name is the same as the mapping name. You can change it according to
your requirements. The display name must be unique at current level.
6. If you choose to create a measure object, click the Aggregate Function drop-down list to
specify the aggregate function for the object.
7. Specify the tooltip and description of the cube element in the Tip and Description text boxes
respectively if required, which will be shown when you hover the mouse pointer over the cube
element in the Resource View panel of JReport Viewer.
8. Click the Security tab and set permission to the cube element as required (for details, see
Configuring security).
9. When done, click OK to close the dialog.
Tip: If you want to add a detail information object to a dimension or measure object, you can
right-click the dimension/measure object, select Add Detail Information from the shortcut
menu and then add the detail information object as required.
Adding by dragging
In the Business/Report Cube Editor window, drag a table, DBField, formula or summary from the
Resource Objects panel to the business/report cube or a category. Then, all DBFields in the table, the
DBField, formula or summary will be added as cube element into the business/report cube or that
category. JReport will determine their types automatically. Moreover, you can drag a DBField of the
data type other than Integer and Date or a formula to a dimension or measure object to add it as a
detail information object.
Notes:
For all the elements in a business/report cube you can,
Edit and rename them at any time by right-clicking an object and selecting the corresponding
editing command from the shortcut menu.
Delete them if required by choosing Delete from the shortcut menu, clicking the Delete button
on the toolbar, or dragging them from the right panel to the Resource Objects panel.
For a report cube, if you want to enable data analysis on a component with it, for components
designed in JReport Designer and then published, you must add the corresponding cube elements for
all fields in the component, that is, each group field (column/row field in crosstab or category/series
field in chart) has a corresponding dimension object, each detail field has a corresponding dimension/
measure/detail information object, and each summary/aggregate field has a corresponding measure
object (matching the aggregate function and field both).
Configuring security
JReport Designer allows you to allocate security permissions to different principles (users, groups and
roles), and thus you can make the cube elements in a business/report cube available only for some
special principles.
To configure security for a business/report cube, follow the procedure below:
1. Add or import principles.
2. Set the permissions to the cube elements of the business/report cube.
3. Save the catalog to save the security configuration.
2. In the Role/Group/User tab, click the Add button to add a role/group/user, and give a
description for it as required.
3. Click OK to save the settings.
To import principles from JReport Server, you must first make sure that JReport Server has been
started. Then,
1. Check Import from JReport Server in the Security Configuration dialog.
2. Click the Options button, and specify the connection information in the Import from JReport
Server dialog, then click OK to connect to the server.
3. All the principles defined in JReport Server will then be imported, and you can click OK to save
them.
Setting permissions
To set permissions to the cube elements of a business/report cube, follow the steps below:
1. Right-click the cube element in the Business/Report Cube Editor window, and then choose the
corresponding item for editing the cube element.
2. In the Edit Cube Element dialog, click the Security tab and set permissions to the element as
required.
The Visible permission controls whether a principle can view the business/report cube element in
the resource tree of JReport Viewer and whether he or she can perform actions based on the
element. These actions include inserting, removing, grouping by, drilling down, drilling to, and
drilling to by value. Filtering and sorting are not under security control.
3. Click OK to save the permission settings.
Defining hierarchies
Hierarchies can be defined in a business/report cube to allow users to drill report data down to particular
dimensions in JReport Viewer.
To define a data hierarchy:
1. In the Business/Report Cube Editor window, click Tools > Hierarchy Management. The Hierarchy Editor
dialog will then appear.
2. Click <Add Hierarchy...> in the Hierarchy box to add a hierarchy. Click the Rename button to rename
the hierarchy if necessary.
3. Select dimensions that have been added to the business/report cube from the Dimension box and click
to add them to the hierarchy. Click
business/report cube. To remove a dimension from a hierarchy, first select it and then click
Delete button.
4. Adjust the order of the dimensions by clicking the Move Up or Move Down button.
5. If you want to add another hierarchy, click <Add Hierarchy...> and repeat the above steps.
To adjust the order of the added hierarchies, click the Mover Up or Move Down button.
or the
To delete a hierarchy, select it in the Hierarchy box and then click the Delete button or
. If you want
Creating filters
To provide flexibility and convenience to end users playing with ad hoc reports, JReport provides two
options to narrow down the records:
Built-in filter: It is defined in JReport Designer for business cubes only and transparent to the end
users running the business cube reports.
Predefined filter: It is predefined on the Designer side for both business and report cubes. Ad hoc
end users can choose to apply such filter when designing/modifying reports based on the business/
report cube.
3. Click
behind the field text box. In the Cube Element Resources dialog, select Country and
click OK.
4. Select = from the operator drop-down list.
5. Click
next to the value text box. In the Values dialog, click the Value sub tab, double-click
USA and it will be added to the value box, then close the dialog.
6. Click OK to save the filter. The filter is used as a built-in filter in the CustomersCube business
cube.
7. Click File > Catalog Management > Save Catalog to save the catalog.
8. Publish the catalog to JReport Server.
9. Create reports in JReport Viewer based on the business cube, the filter will be automatically
applied to the business cube, that is to say, the report will get data from USA only.
2. In the Business Cube Editor window, click the Predefined Filter button
display the Predefined Filter dialog.
on the toolbar to
3. Click the New button, double-click in the Name cell of the filter and change its name to
CustomersFilter, then in the Condition panel, click the Add Condition button and define the
filter as Customer ID>=25.
4. Click the New button to add another filter and name it OrdersFilter, then define the filter as
Shopping Cost=150.
5. Click OK in the Predefined Filter dialog to save the filters.
6. Save the catalog and publish it to JReport Server.
7. Create reports based on the business cube in JReport Viewer, and you can choose which filter you
want to apply.
For detailed explanations about how to use the predefined filters in JReport Viewer, refer to Applying
filters to business/report cubes in the JReport Server User's Guide.
Notes:
When the resources that are used in some predefined filters are removed from the business view,
the next time when you open the Predefined Filter dialog, you will be prompted with warning
messages showing the details and the filters will be removed automatically from the dialog as well.
If you want to input values manually in the filter dialogs, pay attention to the following rules:
String Value
Rules: Quote the values with single quotes.
Example1: Customers_Country='USA'.
Example2: Customers_Country in 'Australia','Germany','Mexico'
Date Value
Rules:
Default input format supported in JReport Designer is the same as the format of the values
available in the Values dialog.
Default input format supported in JReport Viewer is 'MM/dd/yyyy' for Date, 'hh:mm:ss a' for Time
and 'MM/dd/yyyy hh:mm:ss a' for Timestamp.
Both the above formats are only the input value format in the filter dialogs, and filters are done in
the RDBMS side and some RDBMS have special requirements for the date format, so you need to
make sure the date formats specified in the Data Format tab of the Get JDBC Connection
Information dialog are supported by your database.
Adding tables
Editing a join
Adding tables
When you open the Business Cube - Join Editor, you will see all the tables (including views) that have
been added to the business cube when you create it. If you find that you require some extra tables to
create joins, you can add them as follows:
1. In the Business Cube - Join Editor window, click Table > Add Table to display the Add Table
dialog.
2. Select a schema from the Schemas box if the database supports schema. The tables that are
contained in the selected schema and are not included in the business cube will then be displayed
in the Tables box. Choose the required tables, and then click the Add button.
3. Click the Done button to close the dialog. Then, all the selected tables/views will be shown in the
right panel of the Join Editor window.
4. Click the Arrange button to organize the tables.
Now, you can define joins among the selected tables as required.
Tips:
Tables that have been added to a business cube can be deleted if not required. To do this, select the
table in the Business Cube - Join Editor window, and then click Table > Delete Table. However, a
table with a join to another table cannot be deleted.
If you want to hide a table which is not a part of a join, click
in the upper right corner of the
table. To redisplay hidden tables, in the Business Cube - Join Editor window, click Table > Table
Properties to show the Table Properties dialog, then move the hidden tables from the Hide Tables
box to the Show Tables box (you can also use this dialog to hide tables without join relations).
To create joins manually, tables must be retrieved from a database and a relationship, called a join
condition, must be specified between at least one column from each table. To do this:
1. In the Business Cube - Join Editor window, position the mouse pointer over the field that will be
the source of the join.
2. Click and hold the left mouse button while moving to the destination field.
3. The join relationship is then established between the tables. When more than one relationship is
required between two tables, you can create multiple joins between them.
Joins can also be made automatically by selecting the corresponding item from the Auto Join command
of the Table menu in the Business Cube - Join Editor window. You can choose to automatically join
tables either By Name or By Primary Key.
When automatically joining tables by name, a join between two tables, within which two fields share
the same name and same data type, will be added.
When automatically joining tables by primary key, a join between two tables, within which two fields
have the same name, same data type and one of the fields is and must be the table's primary key,
will be added.
If the Pre-join feature is enabled for a data source connection, when you create joins for business
cubes in this data source, the joins can be inherited from pre-joins of the data source.
To make business cube joins inherit from data source pre-joins:
1. Make sure the Prejoin property of the data source connection is set to true (see details).
2. In the Business Cube - Join Editor window, click Table > Add Table.
3. In the Add Table dialog, add the required tables to the business cube and click Done.
Tables that have been defined some pre-join relationships in the data source will be automatically
joined together.
When you use pre-joins for creating business cube joins, you may meet the following cases:
If JReport Designer needs other tables to bridge the tables you have added, you will be prompted to
decide whether to add another table to the business cube.
If there is more than one path available in the pre-join, you will be asked to choose which path you
want to use.
Notes:
Any joins defined between two tables are represented as arrows connecting the key fields from the
two tables.
If the Pre-join option is enabled for a data source connection, the Auto Join feature will not take
effect when defining joins for business cubes in the data source.
If you use pre-joins for creating business cube joins, even though the tables involved in the business
cube joins are not contained in the business cube as cube elements, the business cube joins inherited
from pre-joins will be applied to any resources in the business cube, which reference table fields used
in the pre-joins.
If there are any loops between the joins, they will be listed in the All Loops panel. When you select a
loop in the panel, the joins forming the loop will be highlighted both in the All Joins panel and the
right panel of the Join Editor window. You can double-click any loop to get detailed information about
the loops in the Properties dialog, and edit the selected join in a loop by clicking
join line.
After building a join in a business cube, the corresponding DBField names will be recorded in this
join. If you rename any DBField later, the internal record will not change, and you have to reestablish a join to apply the new name.
Editing a join
After a join has been set up, you can edit it at any time as required. To do this:
1. In the Business Cube - Join Editor window, right-click the join in the All Joins box and choose Edit Join
in the right panel). The Join Options dialog appears.
(or double-click its join button
2. Check the Outer Join option to set the join an outer join, then specify the format of the join as required:
SQL92 or Use'+'.
3. Edit the join conditions in the Condition panel according to your requirements.
4. When done, click OK to accept the changes.
See also Join Options dialog for details about options in the dialog.
Besides, if you find that some joins are unnecessary or their names are not intuitive, you can delete or rename
them.
To delete an existing join, right-click the join in the All Joins box and choose Delete from the shortcut menu
(or click the Delete Join button in the Join Options dialog).
To rename an existing join, right-click the join in the All Joins box and choose Rename from the shortcut
menu. The name of the join will then become editable. Enter a name in the name box and press Enter on
your keyboard (or click somewhere outside the box).
How to convert
The following lists what types of fields in the query will be converted to what types of elements in the
report cube:
When Query Fields Are Used As
Cube Elements
Dimension
Crosstab aggregation
Measure
Measure
Detail information
Detail information
Dimension
Static summary (except that used as chart Y axis or current group by level).
Page level formula, that is, the formula calculated after the whole report finishes rendering.
Group by parameter.
Table, crosstab, chart, or banded object when one of its children components cannot be converted
(the children components exclude blank components and those having already been converted).
Linking reports
In most cases, your reports are affiliated with one another, with each report emphasizing one or more
aspects of a bigger picture. Relationships can be set up in order for users to browse from one report to
another through the relationship "channels" created.
You can achieve an inter-report relationship network by setting up the join/filter/link conditions
between two reports in the same catalog. You can use one report to hold comprehensive report data,
and another to show detailed information relating to a specific topic. Then, when you view the main
report at runtime, you can gain access to the linked or detail report by clicking a trigger, which is an
object defined in the main report to load a linked or detail report. Usually, you can use a field (DBField,
summary, formula, parameter, or special field), an image or a label as a trigger object.
Pick a task from the following:
4. Click the Browse button to specify the report set in the same catalog that contains the report you want
as the linked report. Then, select the report name from the Report drop-down list.
5. In the Condition tab, click the Add button beside the Component in Report box. In the Choose
Component dialog, add the components in the linked report you want to be interlinked with the primary
report with conditions. If the required components use different datasets, you need to add them
respectively, however, as long as the components are based on the same dataset, you can add them all
at a time.
6. Select a component from the Component in Report box, then specify the link condition between the
primary report and the component as follows:
a. Select a given field/formula from the left box and click
displayed in the Fields(Primary) column.
b. Choose an operator from the drop-down list in the OP column. The operator can be "=", "<>", "<",
">", "<=", ">=", or "IN".
c. Specify the field/formula of the linked report from the drop-down list in the Fields(LinkedReport)
column. All fields in the linked report of the same value type as the selected primary report field
will be available.
d. If necessary, you can specify other link conditions by specifying the primary report field, the
operator, and the corresponding field in the linked report. Note that the relationship among these
link conditions is AND, which means that JReport will fetch linked report data which meets all of the
conditions.
7. Select another component from the Component in Report box and repeat the above steps to set its link
condition with the primary report.
8. From the Default Linked Component drop-down list, select which component in the linked report will be
linked with the primary report by default. Then, when the primary report is opened in HTML, PDF or
Excel format, the page where the data that meet the predefined condition in the specified component in
the linked report will be displayed by default after you click the link.
9. If the linked report contains one or more parameters, the Parameters tab will be enabled. In this tab,
you can assign field of the primary report to parameter of the linked report. Then, when running the
linked report from the link, the field value of the primary report will be assigned to the parameter
automatically.
10. Check Pass style group information down to the linked report to transfer style information from
the primary report to the linked report, so that the style of the primary report will apply to the linked
report.
11. From the Target Frame drop-down list, select where the linked report will be loaded. This setting will be
applied only when the primary report is opened in DHTML format, or in JReport Studio if it is a studio
report.
12. Click OK to apply the settings.
Then, when the primary report is opened in DHTML, HTML, PDF or Excel format, or in JReport Studio if it is a
studio report, when you click the trigger object in the primary report, you will find that the linked report is
displayed according to the specified link conditions.
See also Link Report dialog for additional information about options in the dialog.
Notes:
When linking reports, you need to avoid link loops. For example, if you have linked report A to report B,
then you cannot link report B back to report A again.
The conditions specified in the Condition tab are used for setting up the searching criteria between the two
linked reports, which means after you click the trigger object in the primary report, the pages containing
the data that meet the conditions in the linked report will be displayed. However, when running the
primary report in DHTML format or in JReport Studio, the conditions are used for filtering, that is, only the
data that meet the conditions in the linked report will be displayed.
4. Click the Browse button to specify the report set in the same catalog which contains the report you
want for the detail report, and then select the report name from the Report drop-down list.
5. Click
beside the Component in Report field. In the Choose Component dialog, specify which
component in the detail report you want to be interlinked with the master report with conditions. You
can select more than one component as long as the components are based on the same dataset.
6. Specify the join relationship in the Anchor tab. The join between the master and detail report can only
have one condition. For example, the join can be: (Detail report) Product ID = (Master report) Product
ID. The join condition should be as:
(Detail RPT) expression1 operator (Master RPT) expresion2
To make the join more meaningful, expression1 should be a column or record level formula in the
GROUP section of a component in the detail report; and expression2 should be a column or record level
formula in the DETAIL section of a component in the master report. This is because generally the
master report is used to present comprehensive data, and the detail report to present more detailed
information. To specify the join condition,
a. Select a field/formula from the Column in Detail drop-down list. If this list does not offer the
required field/formula, then you will need to specify the component with the data source that
contains the specific field/formula. To do this, select the component from the Component in Report
drop-down list.
b. Choose the operator from the Operator drop-down list. The operator can be "=", "<", ">", "<>",
"<=", or ">=".
c. Specify the field/formula of the master report from the Column in Master drop-down list. This field/
formula should be of the same data type as the selected field/formula of the detail report.
7. If you want to filter the detail report data, switch to the Filter tab to specify the conditions.
This tab is very similar to the Condition tab in the Link Report dialog. You can refer to the procedure in
Linking a report to another report for details. The only difference is that with the Field box in the Filter
tab here, there is an extra column More, with which you can specify the relationship between filter
conditions to be AND or OR.
8. If there is at least one parameter applied in the filters of the queries that the detail report uses, the
Parameters tab will be enabled. In this tab, you can assign field of the master report to parameter of
the detail report. Then, when running the detail report from the link, the field value of the master report
will be assigned to the parameter automatically.
9. If both reports use the same encoding and DB settings, you should check the option Use the same
encoding and DB settings for the detail report as that of the master report. If this option is not
checked, when the detail report is triggered at runtime, you will be prompted to specify the encoding
and DB settings for the detail report.
10. From the Target Frame drop-down list, select where the detail report will be loaded.
11. Click OK to confirm.
After a set of master/detail reports have been defined in JReport Designer and published to JReport Server,
they can be viewed in DHTML. The detail report supports all the DHTML operations, such as sort, filter, drill,
and search.
See also Master/Detail Report dialog for additional information about options in the dialog.
Notes:
The join and filter conditions work together. If you want to set a single condition, you can use join
(anchor). If you want to set a group of conditions, you can use the filter conditions together with a join
condition. The relationship between the join and filter conditions is "Join condition AND (filter conditions)".
If you specify to load the detail report in a new browser window, the detail report will be opened
independently when you click the trigger in JReport Viewer. That is to say, the join and filter conditions you
have set between the master report and detail report will not be applied.
The Go to Detail property is enabled by default for summaries on the group header/footer panel of a
banded object. This is the same case when the formulas on the group header/footer panel of a
banded object are group level formulas.
Go-to-detail from a summary or group level formula can also be performed in view mode in JReport
Designer, and on HTML/PDF report outputs.
The map is inserted in the group header/footer panel that is not the lowest level group of the banded
object.
3. Publish the report set to JReport Server and run the report set in JReport Viewer.
4. Click the map to apply the go-to-detail action, or you can right-click the map and then select Go
to Detail, then the related group information will be displayed.
The following example shows how to obtain detailed information from a chart:
1. Design a report set, and create a standard banded report in it based on the query WorldWideSales
in Data Source 1 of the catalog file SampleReports.cat. The standard banded report displays the
following fields: the DBFields Product Name, Unit Price, Discount and Quantity and the formula
Total, is grouped by Country, State and Category (Country is the highest level and Category the
lowest), and applies the Classic style.
2. In the Resource View panel, click <Add Summary...> from the Summaries node and create a
summary named Sum_Total, which uses the function Sum, sums on the formula Total, and applies
to the Category group level, then drag the summary to the footer panel of the Category group
level in the banded object.
3. Insert a Bar 3-D chart into the header panel of the Country group level. The chart inherits the
dataset from the banded object (make sure to check the Current radio button in the Data screen
of the Create Chart wizard), and displays Category on the category axis, State on the series axis
and Sum_Total on the value axis.
4. In the Report Inspector, set the Go to Detail property of the chart to true.
5. Save the report set and click View > Preview As > DHTML to preview it in DHTML format.
6. Turn to page around 25 to view records in the USA country.
7. Now point to the bar of State=CA and Category=Bold, the mouse pointer will become a hand.
Click the bar and the result will be regenerated.
8. If you click a label on the category axis of the chart, you will go to detailed information concerned
with the product category represented by that label; if you click a series axis label, detailed
information about the state indicated by the label will be displayed.
Note: For a chart, its Hyperlink, X Hyperlink, and Z Hyperlink properties allow you to set a URL for the
graphic objects (such as bars, benches, etc.), category axis labels, and series axis labels respectively.
If you have set any of the three properties, the corresponding object will no longer support the go-todetail function in JReport Viewer, and clicking it will go to the URL. If Interactive is set to true and you
have set Hyperlink, X Hyperlink, and/or Z Hyperlink, double-clicking the corresponding part of the chart
will go to the URL you set.
3. Select a dataset from the Report Dataset drop-down list, and all the fields in the dataset will be shown in the mapping name box.
4. To make the resource names sort automatically, check the Auto Sort checkbox.
5. Specify the display names for the fields in the Display Name column. A formula can be selected as the display name of the field.
6. Select another dataset and repeat the above steps to edit the display names of fields in it.
7. If required, you can click the Advanced button to further customize the display names in specific component in the Edit DHTML
Display Name for Component dialog.
8. From the Component drop-down list, select the component you want to customize.
Tip: You can also right-click a component and then select DHTML Display Name from the shortcut menu to display the Edit
DHTML Display Name for Component dialog. However, if the dialog is opened in this way, only the component you right-click on
will be listed in the Component drop-down list.
9. In the action columns, check the corresponding checkboxes to indicate whether the actions are enabled for the fields. Check the
checkbox on the action column header if you want the corresponding action to be enabled for all fields. If any action is not
supported on the selected component type, the corresponding column will be disabled.
When an action is checked for a field, the field's display name instead of mapping name will be shown in the corresponding dialog or
sub menu in JReport Viewer. If you uncheck the box for any field in any action column, the field will not be available for the action.
Moreover, if you set the display name of any field to be blank in the Edit DHTML Display Name dialog, all actions will be disabled for
the field, which means end users will not be able to perform all these actions on the field in JReport Viewer.
10. Upon finishing, click OK to accept the changes.
Note: If you set the display name of any field to be blank, the field will not be shown in the lists where display names are displayed in
JReport Viewer.
3. In the Fields panel, all the fields in the dataset the component uses are displayed. Select the field by which
to sort the data from the panel and click
select all of them and then click
(ascending) or
5. To change the sorting priority of the fields, select the field in the Sort By panel, and then click
move it up or down.
or
to
7. Click Add Condition to define another condition line and set the relationship between the two lines if
required.
8. When done, click OK to apply the settings.
See also Edit Sort and Filter dialog for details about options in the dialog.
Notes:
If the Customize Display Name feature hasn't been applied to the dataset on which the component is created,
when you open the Edit Sort and Filter dialog, there will be no fields displayed either in the Fields panel of the
Sort tab or the field drop-down list in the Filter tab, in which case, you need to click the Edit DHTML Display
Name button in the dialog first to enable the feature on the dataset. You can also modify the display names in
the Edit DHTML Display Name dialog if desired.
The predefined sort and filter conditions will neither affect the preview result in JReport Designer, nor the
result produced from being run in formats other than DHTML.
3. Check the items you want to show on the Filter submenu of the field in JReport Viewer, and then
click OK.
4. The properties value will be generated, equal to sum of values of those selected items. The items
and corresponding values when checked are as below:
Remove Filter: 1
Top N: 2
Bottom N: 4
More: 8
Default: 16
5. After saving the report set and publishing it to JReport Server, you will see the effect.
Note: In the Filter Options dialog, only when Default is deselected will the rest four checkboxes be
enabled. If you check Default, they will be disabled, but their values will still affect the Filter Options
property value. If Default is checked (Filter Options >= 16), which items will be displayed on the Filter
submenu in JReport Viewer will be determined by settings in the Profile dialog in JReport Server (Profile
> Configure DHTML Profile > Properties > Default Properties > Filter Menu).
Studio Reports
JReport provides the studio reporting solution which is aimed at easier and faster report creation and
design, faster report execution, easier customization, and better presentation style using a newer Rich
Internet Application (RIA) Web 2.0 interface. A studio report contains only one report and uses .wls as
the file suffix.
The data sources that can be used to create studio reports are business views that are resources built
on top of queries. A business view is similar to a report cube except that there is no hierarchical
relationship between the data objects in a business view. Report cube dimensions are business view
groups and report cube measures are business view aggregations. Create business views when your
end users are primarily interested in higher quality presentation style reports and do not need the slice
and dice analytic capability. Use report cubes when users are primarily interested in analyzing the data
from many dimensions. Both business views and report cubes can be built on top of the same query to
support both types of users. Business views are created and managed in JReport Designer.
In JReport Designer, you can create studio reports based on business views, and publish them to
JReport Server. JReport Designer supports opening, creating, and editing of studio reports.
In JReport Server, end users can create studio reports via the JReport Studio Wizard using a browser
and open and edit studio reports via JReport Studio (for details, see the Studio Reports chapter in the
JReport Server User's Guide). Studio reports created in JReport Server can also be downloaded to
JReport Designer for editing.
This chapter contains the following topics:
Business views
Note: A JReport Designer Live license is required in order to use this feature. If you do not have a Live
license please contact your Jinfonet Software account manager to obtain a license.
Business views
Business views are used as data sources for studio reports and are created and managed in JReport
Designer. A business view provides report users with a business-oriented view of their data and
formulas in a query based data source. It contains database connections and relationships between
view elements that are required for creating studio reports.
Business views shield report end users from having to understand physical structure, and enable the
easy building of complex reports containing multiple components. Business views enable end users to
build reports and analyze data based on a set of view elements that they can easily understand. For
example, they do not need to worry about where the data source is from (SQL, stored procedure,
view), or what the data source is (Oracle, Sybase, XML). Business views also enable IT professionals to
maintain control of business data and to ensure its integrity, while presenting end users with an
intuitive view of the underlying data structures.
The following detail information is available:
Categories
Categories are the main tools for organizing data. They are components which correspond to particular
collections of data in the data source. They are grouped in folders that are named to reflect information
collections. A category can contain several subcategories.
Organizing data required by a user into multiple categories or multiple levels of categories is
meaningful, and makes it easy to use. End users can use categories to find data elements they need to
use without knowing the underlying table names although sometimes the table names are used as
categories.
Group objects
Group objects are view elements that are the basis for organizing data in a report. They present the
availability and key performance of data, and characteristically return text data or dates, and answer
the following question: who, when, what, where and which. A group object can be inserted wherever a
field can be inserted, as a column or row in a crosstab, or as a group field or detail field in a table or as
a category or series in a chart. They may be based on DBFields such as region and country or they
could be based on formulas such as the year, quarter, or month portion of a date field.
Aggregation objects
Aggregation objects are numeric view elements that are calculated at run time based on the group
objects in the report. Aggregations can be used alone or calculated with other fields. An aggregation
object can be inserted wherever summaries can be inserted. For example, aggregations can be inserted
in the group header or footer panel of a table, as an aggregate field in a crosstab, or as the value in a
chart. JReport calculates values based on the group level at which the aggregation object is inserted
such as total sales, average order size and number of orders from a customer.
Detail objects
Detail objects provide additional information. It can be bound to a database field, group object,
aggregation object or category/subcategory. Detail objects are used for displaying detailed field values
such as address and phone number for a customer in a table. Detail objects can not be used in
crosstabs and charts.
7. Click File > Close to close the window. The business view will now have been added to the
catalog.
Adding elements
Configuring security
See also Business View Editor window for additional help about options in the window.
Adding elements
You can add more elements to a business view at any time to suit your requirements.
Adding a category
To add a category, follow the steps below:
1. In the Business View Editor window, select the business view (or any existing category) in the
right panel, right-click and then click Add Category to display the Category Property dialog.
2. In the General tab, set the name and display name for the category in the Name and Display
Name text fields. The name and display name must be unique at current level.
3. Type a description for the category in the Description text box if required, which will be shown
when you hover the mouse pointer over the category in the Resources panel of JReport Studio.
4. Click the Security tab and set permission to the category as required (for details, see Configuring
security).
5. Click OK. A new category will be added to the business view (or the selected category). You can
then add view elements to it.
2. In the General tab, decide the type of the view element by selecting the corresponding item
from the Type drop-down list. It can be Group, Aggregation or Detail.
3. Click the chooser button
the view element.
next to the Mapping Name text field to specify the mapping field of
4. Specify the display name of the view element in the Display Name text field.
By default, the display name is the same as the mapping name. You can change it according to
your requirements. The display name must be unique at current level.
5. If you choose to create an aggregation object, click the Aggregate Function drop-down list to
specify the aggregate function for the object.
6. Specify the tooltip and description of the view element in the Tip and Description text boxes
respectively if required, which will be shown when you hover the mouse pointer over the view
element in the Resources panel of JReport Studio.
7. Click the Security tab and set permission to the view element as required (for details, see
Configuring security).
8. When done, click OK to close the dialog.
Tip: If you want to add a detail object to a group or an aggregation object, you can right-click
the group/aggregation object, select Add Detail from the shortcut menu and then edit the
detail object as required.
Adding by dragging
In the Business View Editor window, drag a table, DBField, formula, or summary from the Resource
Objects panel to the business view or a category. Then, all DBFields in the table, the DBField,
formula, or summary will be added as view element into the business view or the category you drop
it into. JReport will determine the type automatically which may not meet your requirements. You
can edit the view element to change it to the required type. Moreover, you can drag a DBField of
data type other than Integer and Date or a formula to a group or aggregation object to add it as a
detail object.
Notes:
For all the elements in a business view you can,
Edit and rename them at any time by right-clicking an object and selecting the corresponding
editing command from the shortcut menu.
Delete them if required by choosing Delete from the shortcut menu, clicking the Delete button
on the toolbar, or dragging them from the right panel to the Resource Objects panel.
The display names of the view elements in a category must be unique, and the category display
names also should be unique in a business view.
on the toolbar to
3. Click the New button, double-click in the Name cell of the filter and change its name to
CustomersFilter, then in the Condition panel, click the Add Condition button and define the
filter as Customers_Customer ID>=25.
4. Click the New button to add another filter and name it OrdersFilter, then define the filter as
Order Date=2007-12-23 00:00:00.000.
5. Click OK in the Predefined Filter dialog to save the filters. You can then apply them when creating
or editing studio reports based on the business view in JReport Designer or in JReport Studio after
you publish the corresponding catalog to JReport Server.
Notes:
When the resources that are used in some predefined filters are removed from the business view,
the next time when you open the Predefined Filter dialog, you will be prompted with warning
messages showing the details and the filters will be removed automatically from the dialog as well.
If you want to input values manually in the filter dialogs, pay attention to the following rules:
String Value
Rules: Quote the values with single quotes.
Example1: Customers_Country='USA'.
Example2: Customers_Country in 'Australia','Germany','Mexico'
Date Value
Rules:
Default input format supported in JReport Designer is the same as the format of the values
available in the Values dialog.
Default input format supported in JReport Studio is 'MM/dd/yyyy' for Date, 'hh:mm:ss a' for Time
and 'MM/dd/yyyy hh:mm:ss a' for Timestamp.
Both the above formats are only the input value format in the filter dialogs, and filters are done in
the RDBMS side and some RDBMS have special requirements for the date format, so you need to
make sure the date formats specified in the Data Format tab of the Get JDBC Connection
Information dialog are supported by your database.
Configuring security
JReport Designer allows you to allocate security permissions to different principles (users, groups and
roles), and thus you can make the view elements in a business view available only for some special
principles.
To configure security for a business view, follow the procedure below:
1. Add or import principles.
2. Set the permissions to the view elements of the business view.
3. Save the catalog to save the security configuration.
To import principles from JReport Server, you must first make sure that JReport Server has been
started. Then,
1. Check Import from JReport Server in the Security Configuration dialog.
2. Click the Options button, and specify the connection information in the Import from JReport
Server dialog, then click OK to connect to the server.
3. All the principles defined in JReport Server will then be imported, and you can click OK to save
them.
Setting permissions
To set permissions to the view elements of a business view,
1. Right-click the view element in the Business View Editor window, and then choose the
corresponding item for editing the view element.
2. In the Edit View Element dialog, click the Security tab and set permissions to the element as
required.
The Visible permission controls whether a principle can view the business view element in the
resource tree of JReport Studio and whether he or she can perform actions based on the element.
These actions include inserting and removing. Filtering and sorting are not under security control.
Tables
Crosstabs
Charts
Tabular
Labels
Images
DBFields
Formulas
Summaries
Parameters
Special fields
All special fields are supported to insert into studio reports in JReport Designer. However, due to the characteristics of
JReport Studio, only these can be rendered and edited in JReport Studio: User Name, Modified Date, and Modified Time.
Multimedia objects
Four web controls: parameter control, parameter form control, filter control, and navigation control
2. Compose the formula by selecting the required fields, functions and operators from the Fields, Functions and Operators
panels. You can also write the formula by yourself in the editing panel.
For details about the functions and operators, refer to Built-in functions and Operators.
3. Click the Check button
Notes:
You can only save a dynamic formula with no errors into a studio report.
When formulas reference display names or mapping names, the names should not contain any of the following characters if
the names are not quoted by double-quotation marks "":
"~", "`", "!", "@", "#", "$", "%", "^", "&", "*", "(", ")", "-", "+", "=", "{", "}", "[", "]", "|", "\\", ":", ";", "\", " ' ", "<", ",",
">", ".", "?", "/"
Examples:
Once a dynamic formula has been created, you can then drag it from the Resource View panel to the desired position in the
report as a detail object, or use it when working with component wizard.
Also, if you want to further edit an existing dynamic formula or remove any formula that is not required, right-click the formula
and then select the corresponding command on the shortcut menu.
2. In the Aggregation Name text field, specify the name of the dynamic aggregation.
3. Click
next to the Mapping Name text field to specify the field on which the dynamic aggregation is based.
Click View > Preview As > Studio Report on the menu bar.
The studio report will then be opened in JReport Studio. You can also click the View tab directly to preview the studio report in
JReport format.
Notes:
The function of previewing a studio report in JReport Studio also requires that:
You have checked the option Server for previewing reports in DHTML or Studio when installing JReport Designer.
You have a JReport Server Live license for your JReport Server.
The preview server is a web ad hoc disabled server, and it supports only one user and one report concurrently.
JReport Designer and the preview server are running in two separated JVMs. The preview server applies -Djreport.url.
encoding=UTF-8 in the startup batch file and this setting covers URL encoding/decoding. Therefore, when you preview a
studio report in JReport Studio, if the name of the report or catalog file contains non-Latin characters, you need add Djreport.url.encoding=UTF-8 into the startup batch file of JReport Designer as well; otherwise the preview will fail.
When previewing a studio report in JReport Studio,
Make sure the JDBC driver's class path has been appended to setenv.bat/setenv.sh in <install_root>\server\bin.
If the report contains some user defined data sources (UDS), you can use the classes you have compiled for using in
Designer, but remember to append the classes to the class path of JRServer.bat in <install_root>\server\bin.
Report Bursting
In a large enterprise reporting deployment, it is important to handle both large amounts of data as well
as a large number of users. Report bursting enables running a report once and distributing the report
results to multiple recipients who each will receive a subset of the report results.
Bursting reports can be distributed to e-mail or FTP addresses, to disk, to the JReport versioning
system, or to the security system members such as users, groups, and roles.
This chapter explains what a bursting report is and how to design a bursting report in JReport Designer.
For details about how to submit a scheduled task which contains a bursting report and viewing the
status of the bursting task and stopping it, see Scheduling a task containing a bursting report in the
JReport Server User's Guide.
Pick a task from the following:
Bursting key
Bursting recipient
Notes:
The bursting report always means the main report. If both the main report and its sub report are
bursting reports, the system will only execute the bursting task according to the main report, and the
sub report will be processed as a normal report.
If you load a report which was created in V8.2 containing only one bursting schema, JReport will
create a default name for the schema. The default name is BurstingSchema.
If the end user has applied security information or filters to the data and the system cannot obtain
the bursting key, it will not send the result.
Bursting key
When running a bursting report, JReport will split the data according to a condition. The condition is the
bursting key. The system will generate multiple results according to this key. For example, sending a
credit card bill to every consumer according to the credit card ID. The credit card ID here is the
bursting key.
Make sure the DB columns used for the bursting key are sortable in the DBMS, otherwise the bursting
results may be unpredictable.
The following data types can be used for the bursting key:
Bursting dataset
The bursting key must be created based on an existing dataset. The bursting key can be composed of a
single DB column or multiple DB columns in the dataset. When multiple columns are selected, the
system will split the data according to each unique combination of the columns.
Bursting recipient
The bursting task generates multiple results and sends them to different places. We define the places
as the recipient. The recipient determines to which addresses or physical locations the report results
will be sent.
In recipient, the following kinds of addresses are supported:
Principals in JReport Server security system (user, role and group)
You can specify a DB column that provides information to locate the users in the server security
system.
The report results can be sent to two places:
For user: Sending to e-mail addresses or private folders of the users defined in the DB column.
For role: Sending to e-mail addresses or private folders of all users belonging to the role.
For group: Sending to e-mail addresses or private folders of all users belonging to the group.
E-mail: You can specify a DB column of e-mail addresses.
Disk: You can specify a DB column that contains directories or full paths with file name. If it is a
directory, the system will add the bursting result with the name generated by the system into the
directory. If it is a full path, the system will generate the result with the specified file name and add
it into the path.
If the system finds that there is a file with the same name as the generated bursting result file, it will
not send the result file into the path and will record a message into the log.
Integer, Float, Character: Same as Java, these data types are transferred to String directly.
Date and Time: All date and time formats will be transferred to the date format: yyyy-MM-dd hh:
mm:ss.
Currency: Currency will be transferred to the number without the currency mark ($ or others).
Name length
In the JReport Server resource system, the resource name only supports up to 64-character length. If
a bursting result file name is longer than that, the system will trim it down automatically.
In order to avoid the same name in the same path, an index will be appended to the result name, for
example: report1_USA_Maryland1.pdf, report1_USA_Maryland2.pdf.
Boolean isRunBursting()
Returns true if the report is running based on bursting schema, else returns false.
String currentBurstingSchema()
Returns the names of the currently applied bursting schemas. When isRunBursting() returns false,
the returned value for currentBurstingSchema() is NULL.
Bursting Key
Recipient
VP
VP
VPs
Manager
VP, Manager
Managers
2. Click the New button and the Create Data Mapping File dialog appears.
3. In the File Name field, specify the name of the mapping file.
4. Click the Language drop-down list and select to which language the data values in the catalog
will be mapped.
5. Click OK, and a property file will then be created in the folder where the catalog file is.
6. In the Data Mapping Editor, click the Import Key button to import the resources with the data
value you want to map from the Import Key dialog.
7. Double-click cells in the Map to Value column to specify the mapping values for the imported
resources according to the selected language.
8. When done, click OK to accept the changes and close the dialog.
Note: From the Import Key dialog, you can only import values of DBFields in a catalog. If you want to
map values of other resources like formulas, summaries and parameters, in the Data Mapping Editor,
click
and specify the value in the Current Value column and Map to Value column accordingly.
NLS Editor
The NLS Editor is used to create and edit NLS property files for report sets. With the NLS Editor, you can translate the
language, and modify the format, font size and font face of the target language.
To display the NLS Editor, do either of the following:
3. In the Add Language dialog, select the required languages in which you want the report set to display, then click
OK. The Connect to JReport Server dialog is then displayed.
4. Type in the host and port of the remote JReport Server in the Host and Port text fields.
5. When using a standalone server, enter /jrserver in the Servlet Path text field or the context root of your web
application if deployed as a war or ear fie such as /jreport/jrserver.
6. If the server has been integrated with another web server that supports SSL, select the SSL (Security Socket
Layer) checkbox to create an SSL connection.
7. Check Remember connection information to enable JReport Designer to remember the connection
information, and then provide the user name and password of the server.
8. Click Connect. The global NLS resources defined for the selected languages are now displayed in the Display and
Font tabs.
9. If the global NLS resources have been updated on JReport Server, click Synchronize with Server to download
the latest resources from the server.
10. When done, click OK to close the dialog.
To create NLS property files using local NLS resources:
1. In the NLS Editor, check the Use Local NLS radio button.
2. Click the Add button
3. In the Add Language dialog, select the required languages in which you want the report set to display, then click
2. Click the View tab to preview the report. You can also click View > Preview As to preview the
report in other format.
10. Click File > Export > HTML to export the report to HTML, and then in the exported HTML results, you will find
that the page navigation links are displayed in the language you specified.
Styles
JReport style is one of the most important concepts in both JReport Designer and JReport Server. A
style in JReport is a set of object attributes that you can assign to components in your report to alter
their appearance and characteristics. When you apply a style, you apply a whole group of property
entries at once. For example, you may want to format the headings of a report to make them stand
out. Instead of formatting them step by step as 12pt, Arial, and center-aligned with a blue background,
you can simply achieve the same goal in one step by applying a predefined style that contains the style
properties you want.
JReport supports two kinds of styles, XSD style and CSS style. This chapter presents their usages
respectively.
Pick a task from the following:
XSD styles
CSS style
XSD styles
An XSD style, that is a style group in the Catalog Browser, can hold a large amount of predefined
object properties, giving you more controls over the appearance and presentation of your report. By
using XSD styles, you can create various visual presentation sets from a single report, and change the
visual presentation of your report at runtime.
XSD styles are a JReport specific format and not an industry standard so you may want to use CSS
styles which are an industry standard.
By simply selecting a style group at runtime, you can change the look and feel of your report in a
dramatic way. JReport style groups can be nested, where the parent group is used as a container of
other groups. The style group feature makes it easy to save and apply styles without repeatedly
designing them each time.
This section explains how to manage XSD styles using the Styles tab of the Catalog Browser as follows:
Now, an XSD style will have been created. You can then apply the style to your reports.
Notes:
The root of the style group tree can only hold style groups. The styles must reside in the style
groups. You cannot create a style directly in the style group tree root.
The name of each style group must be unique in the style group tree.
Each style has a style type to indicate its application scope, e.g., a style with Label type can only be
applied to label objects, and a style with DBField type can only be applied to a DBFields.
You can create more than one style for a style type, and apply different styles to report objects of
the same type. For example, suppose that you have a number of DBFields in your report, such as
address fields, totals, and quantity fields. You probably will not want all the fields to look the same.
You can create two or more styles, using the same style type - DBField, and then apply them
separately to the fields that you want to distinguish.
You can apply a default style to all the objects that hold the same type.
In the Default style group, create a new style, making sure that the style name and style type are
the same, for example, style name=Label, style type=Label. Then, modify the style properties. Then,
when a new object of the specified type is inserted into the report, the default style will be applied to
it automatically. Note that you can see the difference only at runtime.
).
3. If you want to create a new style in the group, click the New Style button and specify the
properties of the style as required.
4. When done, click OK to finish editing.
File Description
Location
1.
CatalogName_stl.xml
2.
StyleGroupName_stl.xsd
Group/Style information
The CatalogName_stl.xml file keeps the style group structure information. The following shows an example:
The style group structure in Catalog Browser:
The corresponding
information in
SampleReports_stl.xml:
<?xml version="1.0"
encoding="UTF-8"?>
<StyleGroup>
<StyleGroupname="Default">
</StyleGroup>
<StyleGroup
name="ClassicBlue">
</StyleGroup>
<StyleGroup
name="ClassicGreen">
</StyleGroup>
</StyleGroup>
The StyleGroupName_stl.xsd file keeps the group/style information, which in the above sample will be as follows:
The file content of ClassicBlue_stl.xsd:
As you can see in the above code sample, an XML style group file contains style group information, style
information, and the style property entry information. You can edit the attributes of an element.
To add a style entry, copy and paste the style information section, and then modify the attributes.
To add a style property entry, copy and paste any element line, and then modify the attributes.
To delete a style entry or style property entry, select the corresponding section, and delete it.
Notes:
The value you type for the default attribute must be consistent with other attributes in the element, and is
recognized by JReport Designer.
For example, if you want to change the Font Face property, you must type a proper font name that JReport
supports for the default attribute, such as Arial, Times New Roman, Tahoma, and so on. You cannot type strings
that are not recognized by JReport. Otherwise, the element will not take effect at runtime.
Make sure that the GroupName attribute is consistent with the XML style group file name.
For example, with GroupA in the XML file, the GroupName attribute is:
<xs:attribute name="GroupName" type="xs:string" default="GroupA"></xs:attribute>
The XML style group file name should then be GroupA_stl.xsd.
CSS styles
A CSS style file is like a style group, which contains a set of styles with many predefined properties. In
JReport, the CSS style file, which is defined according to CSS 2.1 standard of W3C, is supported.
Properties of all of the components in a report can be controlled by a CSS file. You can customize, edit
and save a CSS style with visible UI of the CSS Editor in JReport Designer, and can also compile and
save a CSS file manually according to the W3C standard. After that, these CSS style files can be
imported to apply to a component. By using JReport CSS styles, you can create various visual
presentation sets from a single report, and change the visual presentation of your report.
JReport supports some of the W3C CSS 2.1 standard properties at present, which are backgroundcolor, border-style/border-top-style/border-bottom-style/border-left-style/border-right-style, color,
font-size, height, padding/padding-top/padding-bottom/padding-left/padding-right, text-align, and
width.
This section explains how to create CSS styles and manage them in detail.
To create a custom style that can be applied as a class attribute to a range or block of text,
select the Class option and then enter a name for the style in the Selector Name combo box.
Note: Class names must begin with a period and can contain any combination of letters
and numbers (for example, .myhead1). If you don't enter a beginning period, JReport
Designer automatically enters it for you.
3. To redefine the default formatting of a specific tag, select the Tag option and then select a tag
from the Selector Name combo box.
4. To define the formatting for a particular combination of tags or for all tags that contain a specific
ID attribute, select the Advanced option and then enter one or more tags in the Selector Name
combo box or select one from the box.
5. Select the location in which the style will be defined in the Add Selector to Type drop-down list.
If you want to create an external style file, select New Style Sheet File and click OK. Then,
a. In the Save CSS As dialog, specify the name of the new CSS file.
b. Click Save to save the file and the CSS Style Definition dialog appears.
c. Define the properties of the CSS file. When done, click Save to save the CSS file.
If you want to embed the style in an existing CSS file, select any of the existing style and click
OK. Then,
a. In the CSS Style Definition dialog, define the properties of the style as required.
b. When done, click Save to save the file.
3. In the CSS Style Definition dialog, edit properties for the selected style sheet as required.
4. Click Save to confirm the editing.
Applying a style to a report via the style drop-down list on the toolbar:
1. In the design area, select the components to which you want to apply a style.
2. Select the required style from the style drop-down list
toolbar.
on the Standard
Notes:
There are 15 sets of demo XSD styles provided by JReport, which can be applied to crosstabs,
tables, banded objects and DBFields converted from previous versions. Other components can only
apply the XSD styles which are created by yourself. XSD styles are primarily for compatibility with
previous versions.
By default, the demo XSD styles are not included in either the Style box of the report wizard or the
style drop-down list on the toolbar. If you want to have them displayed, uncheck the option Only CSS
styles available in the style list in the Options dialog.
If you choose to apply a style to a report by setting the Style Group property, later when you publish
the report to JReport Server, the Publish Font and Style dialog will be displayed for you to select the
style groups you want to publish.
When applying CSS styles, you may get warning message showing the CSS properties that are not
supported by JReport. If you want to cancel the warning message, uncheck the option Show warning
message when CSS properties are not supported by JReport in the Options dialog.
In the component creation wizard when inserting a table, crosstab, chart, or banded object into a
table or banded object via the Insert menu.
In the Style screen of the report wizard of a table, crosstab, chart, or banded object which is in a
table or banded object.
In the style list on the toolbar. The Inherit Style here only works on the objects which are in a table,
crosstab, chart, or banded object.
When modifying the style of one of the four types of data containers, if the child component's style
type is Inherit Style, it will change to apply the new style accordingly. However if the child component
has a style, it will reserve its own style.
Security
Security in a report is a kind of privilege control. This chapter demonstrates controlling access to
reports and different subsets of data by means of defining report security. No matter to whom you
need to provide information, JReport Designer allows you to control access to it according to your
requirements.
Generally, report security can be classified into three groups: cached report bursting, record level and
column level. After which, users will then only see what the access privileges allow.
See also Report security system in the JReport Server User's Guide for details about how report
security is applied at the server side.
Security in this chapter is introduced as follows:
Scheduled DHTML and HTML reports will create a report result with the report data for all possible
users. This allows the report to run with a single query to the DBMS to create the report for all users
in one pass. It is similar to report bursting, however, report bursting does not support DHTML and it
makes a separate physical report result for each user and the administrator needs to manually
restrict access to the results. When a user views the report result using cached report bursting,
JReport Server will use the security identifier of the user to restrict access to the data in the report to
the specific groups the security identifier is allowed to view. The end result is the same as the
bursting report in that the user sees only his data, the advantage to the administrator is there is only
one version result to manage.
On-Demand reports and scheduled non-DHTML and non-HTML reports build a separate data result
for each request containing only the data the security identifier allows. In this way, it is similar to a
report using Record-level Security; however, the setup mechanism is different.
return "user1|user2|user3";
Then, user1, user2, and user3 can view the USA group.
Note: The returned value specified in the formula must be the same as the user ID defined in
JReport Server. Also, the user ID is case sensitive.
3. Create a formula Burst_Group to control the Groups property value. This formula returns a String
value indicating which group of users will have the privilege to access which group of data.
if(@Country=='Italy')
return 'group1';
if(@Country=='USA')
return 'group2';
4. Create a formula Burst_Role to control the Roles property value. This formula returns a String
value indicating which role will have the privilege to access which group of data.
if(@Country=='Japan')
return 'role1';
if(@Country=='USA')
return 'role2';
5. In the Report Inspector, select the node that represents the group. Then, in the Security section of
the Properties panel, set Cascade to true, the Grant property's value to the formula Burst_User,
Groups to Burst_Group, and Roles to Burst_Role.
Since the control of report access is not possible without user ID, the significance of this function is
only apparent when other users try to access a report after it has been published to JReport Server.
When an end user views a report with cached report bursting on JReport Server, the corresponding
group will be displayed according to the security identifier.
In the above example, if "admin" belongs to group1 and role1, he will be able to view the China,
Canada, Italy, and Japan groups. jennifer will be able to view only the USA group if she belongs to
group2 and role2.
See also the following topics in the JReport Server User's Guide for details about how to work with
cached report bursting on the server side:
Connection-scope security
Report-scope security
Connection-scope security
A connection-scope security policy is used to refer to a data source security entry in a catalog. It allows
you to control user access to different subsets of data, and ensures that people only see what they are
supposed to see: certain records and/or columns.
If you want to implement the same security policy in a group of reports, you can simply apply an
existing security policy to the reports, without having to repeatedly build the security information for
each report. The following diagram illustrates the security structure of the connection-scope security
policy.
User
The users for connection-scope security fall into two categories: User Defined and Server. The user
defined user is created in JReport Designer, while the server user is imported from JReport Server.
Role
The roles for connection-scope security fall into two categories: User Defined and Server. The user
defined role is created in JReport Designer, while the server role is imported from JReport Server.
Group
The groups for connection-scope security fall into two categories: User Defined and Server. The user
defined group is created in JReport Designer, while the server group is imported from JReport Server.
Security Policy
Permissions can be assigned to users, roles, and groups. A role/group can have more than one user,
and a user can belong to more than one role/group. The permissions that a user may have depends
on the permissions of the roles/groups it belongs to and its own permissions. The inheritance
relationship is logic OR.
For example, if user U1 belongs to two roles and two groups, such as R1, R2, G1, and G2. The
permissions he/she will have are the permissions collections of the roles, groups and itself, which is
P1, P2, P3, P4, and P5, as shown in the following diagram.
The group and role relationships are the same. Here is another example, if group G1 has two roles,
R1 and R2, together with its own permissions, the users in group G1 will have P1, P2, and P3, and
also the permissions assigned directly to the users.
When calculating a user's permissions, the permission collections of its roles and groups are first
calculated using logical OR. If the calculation result conflicts with the user permissions, the user's
permissions will have priority. That is, if one access right is permitted for the user's groups and roles
but denied by the user's permissions, the user will not be permitted to have this access right.
The major steps for using RLS and CLS with a connection-scope security policy are as follows:
1. Set up the security policy.
You use this step to set up the security policies for different report categories. The predefined
security policies work within a connection range.
2. Apply the security policy to your reports.
After you have defined the security policies, you can then apply them to your reports respectively.
3. Publish the reports with RLS (CLS) to JReport Server and run them.
4. To apply record-level security, check the Valid RLS box. To apply column-level security, check the
Valid CLS box.
5. In the User tab of the dialog, click the Add button to add a new user to whom the policy will be
applied.
a. In the User dialog, provide the name, title, and e-mail information of the user respectively in
the corresponding fields.
To build condition statements, specify the expression in the first field. It can be DBFields,
formulas, parameters, or some special fields. Select an operator from the Operator dropdown list, and then specify the value to complete the editing of a row. If you want to append
a new row, in the More drop-down list, select AND or OR.
Values
Description
AND
OR
New Group Adds a new expression group to the list. The relationships between two groups
can be:
Choose Allow all to show all the columns to the user, or Deny all to hide all the columns
from the user.
Check the Select Column option and check the boxes to select the DBFields, formulas,
parameters, or summaries. You can set the selected items to be shown or hidden from the
user by checking the Allow or Deny option. For the unselected columns, the user will have
no permission on them.
g. Click OK to finish permission assigning and return to the User dialog. Then click OK.
6. Add groups and roles using the same way in the Group and Role tabs.
7. Upon finishing, click the OK button to create the security policy.
To add more users/roles/groups, select the corresponding tab and click Add.
To delete a user/role/group, click the corresponding tab, select the user/role/group, and then click
Delete.
To edit a user/role/group, click the corresponding tab, select the user/role/group, and then click
Property.
In addition, with the Security dialog, you can import security information from JReport Server, or
import/export security information from/to external XML files as you like.
2. In the Import from JReport Server dialog, specify the server information as required.
3. Specify whether to replace or merge users, roles and groups with JReport Server by checking the
corresponding radio button.
4. Click OK to start importing.
Notes:
You must be a user in the administrators group in order to log in to perform the importing.
The users/roles/groups from JReport Server will be marked as Server in the Source field in the
Security dialog, while others defined in JReport Designer will be marked as UserDefined.
A user from JReport Server cannot be reassigned to (or removed from) a role from the server.
Similarly, a role from the server cannot be re-assigned to (or removed from) a user from the server.
So, if both users and roles are obtained from the server, you will not be able to change their parental
relationships.
You cannot assign a role from the server to a local user (UserDefined), while a user from the server
can be assigned to a local role.
During importing, if any users/roles, whose source names are Server, have the same names as
those on the server, their properties will be refreshed with new information from the server, for
example, role, or group information and parental relationships. However, their permission settings
will be reserved. Specially, if a user from the server has been assigned to any roles defined in
Designer, then these roles will be reserved in its members list.
You can create your own XML format security information files according to the above structure.
However, the best way to generate an XML security information file is to use the Security dialog. With
this dialog, you can edit the security information, and then export it to an external XML file.
For example, if the simple security policy has been set up as below:
USER
User Name:
d_d_u1
Belongs to Role:
d_d_r1
Permissions:
ROLE
Role Name:
d_d_r1
Belongs to User:
d_d_u1
Note: If you want to use XML security information, you must first purchase a special license. For more
information, contact Jinfonet Support ([email protected]).
sub
Users in Policy
No security policy is applied to either the primary report or the subreport. Users can
therefore view all records in both reports.
Report-scope security
The record-level security (RLS) can be of report scope, which is based on the security information file. That is, you
can use the security information file to set the security policies for a report. Report-scope security policy doesn't
support column-level security (CLS).
Report-scope security has a higher priority than connection-scope security. That is, if in a report, both connectionscope and report-scope security have been applied, only the report-scope security will take effect.
5. Click the Add button to add a condition line and edit the security information as required by clicking
corresponding cells.
Since the record-level security policies are file-based, you can just create a new text file, add the security
settings, and then link the file to your report. Below are steps detailing how to import the security information
from a text file.
a. In the Record Level Security Information dialog, click the Import Text button.
b. In the Select Record Level Security File dialog, specify the text file that contains the predefined security
information and click Open.
c. Information set in the text file will be displayed in the Record Level Security Information dialog. Click the
cells to edit them if required.
d. Click OK to make the security policy applied.
6. Click OK to close the dialog.
7. Click the View tab to view the report. You will then be prompted to provide security ID (SID), which refers to
the user name. Type the SID, and then click OK. Only the records which satisfy the condition will be displayed.
After you have set up RLS for reports in JReport Designer, you can then publish them to JReport Server as normal.
Then, when you log onto JReport Server as different users, you will find that the record-level security settings have
been applied to the report. Different users will only see the data that they are supposed to see.
Notes:
In the Record Level Security Information dialog, the data values provided in the drop-down list may not be valid
for your database, because they are data values that have already been reformatted using your date format
settings in JReport. For detailed information on how to set the date format in JReport Designer, see the Date
Format explanation of the document Get JDBC Connection Information dialog.
If you want to use more values in one cell, use "|" to separate them (applies to User, E-mail, and Title column).
This is useful when you want to apply the same conditions to multiple users. For example, if you want user1,
user2, and user3 to share the same security setting, list user1, user2, and user3 in the same cell, separated by
"|", and then define the security conditions.
Currently, you cannot save the security information to a file.
If you want to apply more than one condition expression to a user, you can edit the condition expressions in
several individual lines, typing in the same user name for each line. For such compound conditions, the
relationship among them is logical OR.
For example, both Customer ID >= 10 and Customer Name = 'Absolute Java' together will cause JReport
Designer to retrieve records where customer ID is larger than or equal to 10 and the record with customer name
equal to Absolute Java.
If you want to use logical AND for the relationship between each condition expression, use a formula that returns
a Boolean value to filter the records. To specify the formula name for a report, in the Properties panel, select or
type the formula name in the Function property entry.
For example, if user1 should only see records which satisfy the condition State = 'CO' and Customer ID >= 10,
the formula should be:
if ( @State == 'CO' && @"Customer ID">= 10 ) return "user1"
If both the Record Level Security Information dialog and a formula have been used to control the security
information, both will take effect. The relationship between them is logical OR.
When creating the text file to include the security information, use TAB to separate each column, and always
keep the headings (User, Role, Column, and so on) in the first line of the text file. For example,
User
Role
Column
Operator
Value
Title
admin
user1
admin
Customer ID
>=
10
Mr.
user1
Customer Name
'Absolute Java'
user2
Customer Name
IN
Miss
user3
Phone
IN
Mrs.
<SecurityContextFactory value="com.utify.JRSecurityContextFactoryImpl"/>
<DeployWizardFactory value="com.utify.JRDeployWizardFactoryImpl"/>
</Option>
3. Add the root path of the implementing class packages to the ADDCLASSPATH variable of setenv.
bat in <install_root>\bin.
JRSecurityUserDataSource
Package: jet.datasource
Usage: A JRSecurityUserDataSource provides data to JReport for generating reports. The
JRSecurityUserDataSource class is developed by users of JReport. It can provide data from a flat file,
non-relational database, or application data.
The data returned by this class is in ResultSet object, so users will need to create a ResultSet instance.
Then, JReport will use the instance to fetch the data. Users can also create their own ResultSet class.
Method: getResultSet(SecurityContext sc, java.lang.String param)
Method description: Gets the data in ResultSet according to parameters.
Parameters:
JRSecurityHierarchicalDataSource
Package: jet.datasource
Usage: A JRSecurityHierarchicalDataSource provides data to JReport for generating reports. The
JRSecurityHierarchicalDataSource class is developed by users of JReport. It can provide data from a flat
realmName - The realm name of the current active realm of the server.
userName - The user name, for a schedule task it is submitter, for an advance run task, it is login
user.
resource - The resource of the server. Now, it is only limited to report resource in the server. For
example, /SampleReports/CustomerAnalysis.cls
versionNumber - The version number of the resource.
SecurityContext
Package: jet.server.api
Usage: SecurityContext is an interface that is used to help you implement security context.
Methods:
getSalutation() - Returns the salutation of the user (e.g., Mr., Mrs., etc).
Package: com.jinfonet.designer.deployment.api
Usage: DeploymentWizard is an interface used for implementing the customized publishing wizard.
Parameters:
DeploymentWizardFactory
Package: com.jinfonet.designer.deployment.api
Usage: DeploymentWizardFactory is an interface used for implementing the customized deployment
wizard.
Method: getDeploymentWizard()
Working principle
In JReport Designer, there is a config.xml file in <install_root>\bin. This file corresponds with the
Options dialog. You can make it configurable by modifying the XML file. Designer loads information
from the XML file and configures the Options dialog when it starts up.
Getting DeployWizardFactory class name and showing the customized deployment wizard:
When you click File > Publish and Download > Publish to Server in JReport Designer, it will first
check if there is deployWizardFactory in the ReportOption, and will then try to create new instance by
the class name. If the class of the customized deployWizard has been successfully loaded, its wizard
will be shown. Otherwise, the default publish wizard will be shown.
In order to overcome the limitation of JDK 1.1.x, JReport is required to be calibrated on the very
first print so that the lines and text can be printed correctly. You will only need to calibrate once
for each printer that JReport uses. Click the Test button, and follow the window instructions.
4. Click OK to print the report.
4. Specify the settings according to your requirements. You can click the Printer button to change
the printer properties.
5. Click OK to print the report.
To mail
To JReport result
To HTML
To PDF
To Excel
To Text
To RTF
To XML
To PostScript
To fax
To Applet
Notes:
You can export the report data in either design or view mode. However, if you modify the report
after opening it, it is recommended to use view mode to export the report data. To do this, click the
on the toolbar. The data will then be reView tab, and then click the Refresh Data button
fetched from the database. After which you can export the report data to the required format.
When exporting to JReport result, you can specify which reports in the current report set you want to
export, however, when you export to other formats, only the report that is opened in the current
report set will be exported.
To mail
If you want to send the results of a report in a report set to other people, you can attach it to a mail.
Be aware that before you can export the report results via e-mail, you must first have your report mail
system configured. Otherwise, a warning message will be displayed when you try to export to mail.
Here when exporting a report set to mail, only the current specified report of a report set in JReport
Designer will be exported.
To JReport result
A JReport result file is JReport's proprietary version of the report results. This file can only be viewed by
JReport Server or JReport Desktop Viewer. You can also display .rst files in your application by calling the
JReport Result Viewer Bean.
To export the results of a report set to JReport result:
1. In JReport Designer, open the report set that is to be exported.
2. Click File > Export To > JReport Result. The Export to JReport Result dialog appears.
5. If you want to export the report set to a zip file, check the Zip option.
6. Specify the precision level with which you want to export the reports from the Precision Level dropdown list.
7. Click OK, and a .rst file will then be generated in the specified directory.
Notes:
To make the specified precision take effect, you need to make sure that the Precision Sensitive property
of the selected reports is set to true. For details, see Report Property - Precision Sensitive.
The precision you specify in the Export to JReport Result dialog has higher priority than the one in the
Export to category of the Options dialog.
To HTML
To export the results of a report to an HTML file, follow the steps below:
1. In JReport Designer, open the report set that contains the report you want to export.
2. On the report tab bar, click the tab that represents the report.
3. Click File > Export To > HTML.
4. In the Web Wizard, specify the settings as required.
4. In the Report tab, specify the web page name as required. Here we use the default one
CustomerAnalysis_CustomerAnalysis. Make sure that Multiple Files, Drilldown and DHTML are checked.
5. In the Directory tab, specify where the exported result files will be saved. Here we save them in the default
directory C:\JReport\Designer\Demo\Reports\SampleReports\.
6. In the Chart Applet tab, select Image Chart > GIF.
7. Click Finish to start generating the files.
8. Open the directory C:\JReport\Designer\Demo\Reports\SampleReports\ and find the exported files.
9. Open the file CustomerAnalysis_CustomerAnalysis_1.html.
10. The Table of Contents (TOC) is displayed in the left pane, including the names of groups and subgroups. If you
click a group, the relative contents will be shown in the right pane.
11. Since Drilldown is checked when exporting the report, you can drill down on a summary by placing the mouse
pointer over the summary and clicking it when the mouse pointer becomes a hand.
Note that summaries should be inserted into your report in advance. They cannot be hidden or suppressed;
otherwise you will not be able to get drilldown files.
Notes:
When exporting a multi-page report to HTML, you can localize the page navigation link names. For detailed
information, refer to Localizing the page navigation links in HTML report outputs.
Multimedia and shapes (except for straight lines and boxes) in reports cannot be exported to HTML.
For mainly meeting the requirements from voice agents used by people with eyesight disabilities, JReport supports
exported tables/crosstabs in the HTML data table format with SCOPE=Row/Column to get a section 508 compliant
After you export a report to a HTML file, you may view it with charts in a web browser. If that, you must ensure
that the chart can be displayed correctly, make sure that you have enabled Additional Unsigned Permissions in the
web browser. For example, to do this in Internet Explorer:
1. On the Tools menu, click Internet Options.
2. Switch to the Security tab, and then click Custom Level.
3. Scroll down Settings, and set Java Permissions to Custom.
To PDF
To export the results of a report to PDF file, follow the steps below:
1. In JReport Designer, open the report set that contains the report you want to export.
2. On the report tab bar, click the tab that represents the report.
3. Click File > Export To > PDF.
4. In the Export to PDF dialog, specify the settings as required.
6. Check the Encrypt option to set the document open password and permissions password in the Encrypt
dialog.
7. Check the Sign option to set a digital ID for the PDF file in the Sign Digital ID dialog.
If you check Compress Image in the Export to PDF dialog, the transparent image will be compressed, but
the transparent attribute will be ignored.
JReport stores the finished pages in RAM before the pages are finally written to a PDF file. When the result
file is too large, you may find that you are low on RAM, leading to an OutOfMemoryError. You can solve
this problem by changing the maximum heap size (-Xmx100m). Also, you can use the old method
(Simulated Printing).
If the color mode of your display adapter is less than 256 colors, when you export to PDF file using the
standard method, charts cannot be compressed. This is because JReport catches an image with less than
256 colors as a GIF image. A GIF image cannot be compressed.
When you export a report which has summary fields, if the Drill Down checkbox is checked, every
summary field in this report will generate a new file which is linked in the main file.
In the Sign Digital ID dialog, by default, the information of Digital ID File and Password are checked. If
there are any problems, the error messages will prompt you, such as Unable to import the chosen Digital
ID file! or Incorrect password! and so on.
Before exporting a report using true type fonts, you should select a report name in the Report Inspector,
and then set Embeddedfonts equal to all true type fonts that you have used in the report. Otherwise the
PDF files may not be displayed correctly.
When you export a web control object, barcode or UDO to PDF, if you select Generate charts and barcodes
using vector graphics, the results will be the vector graphic; if you select the Generate charts and barcodes
using images, the results will be the bitmap.
When a report, in which there is an object beyond its container, is exported to PDF, the overstepped part
will be ignored in PDF file, but the overstepped part of objects in a paragraph can still be exported to PDF.
In order to get a better effect, Acrobat Reader 6.0 is recommended.
To Excel
To export the results of a report to an Excel file, follow the steps below:
1. In JReport Designer, open the report set that contains the report you want to export.
2. On the report tab bar, click the tab that represents the report.
3. Click File > Export To > Excel to display the Export to Excel dialog.
4. Specify the destination of the exported file (make sure that the folder you specify here does exist).
5. From the Word Wrap drop-down list, select a word-wrap setting for the exported Excel file.
6. Set the other options.
To make the layout of the result file match that of the original report, check Preserve Report
Formatting, and then specify the available settings according to your requirements.
To export the report results to a general Excel file, check Normal Formatting, in which case,
you can set the Columned property value for the report in the Report Inspector to decide
whether the exported Excel file will be in columned format or not (when exporting a mailing
label report to an Excel file, do not set the Columned property to true). If the Columned
property is set to true, the exported Excel file will be in columned format.
To export the report results to an Excel 2000 file, check Excel 2000.
See also Export to Excel dialog for detailed explanations about options in this dialog.
Notes:
Multiple colors and languages in a report can be exported to an Excel file, but multiple pie charts and
the arc drawing object cannot be. For example, Excel only supports 56 kinds of colors, if there are
more than 56 kinds of colors in a report, when you export the report to Excel, some colors will be
merged.
When exporting a report to Excel,
When Excel 2000 is selected in the Export to Excel dialog, formulas, barcodes, images, HyperLink
property, charts and all drawing objects will not be supported, therefore, we recommend to not use
this format when exporting report results to Excel.
The following are some specific topics related with exporting the report results to Excel:
Related topics:
The Column Width List property takes effect only when the report's Columned property is set to true
and the Normal Formatting option in the Export to Excel dialog is selected.
If a report contains a subreport, the Column Width List property for the subreport is disabled when
exporting the report to Excel.
The value you set for the Top Attach Column (Top Attach Row) property should be always
larger than that for the Bottom Attach Column (Bottom Attach Row) property.
The arc object cannot be shown in Excel and therefore these four properties for arc does
not work.
If you want to put the subreport in the same worksheet together with the primary report, set
the value to false.
If you want to put the subreport in a new worksheet in the exported Excel file, set the property
value to true, then enter a name for the new worksheet in the Sheet Name property's value cell.
Make sure the name you specify here isn't used by any other worksheets.
Merge to Next Panel: Merges current panel to the next panel. It applied to BandedHeader,
BandedPageHeader, GroupHeader, and GroupFooter panels.
Repeat in Detail Panel: Repeats certain panel with the Detail panel. It applied to GroupHeader and
BandedPageHeader panels.
Remove Blank Row: Removes blank rows in the panel. It applied to BandedPageHeader, GroupHeader,
and Detail panels.
Notes:
The three properties take effect only when the Columned property of a report is set to true.
There is an operation order when those three properties work together: first, Merge to Next Panel;
second, Repeat in Detail Panel; third, Romove Blank Row.
When two or more objects in the to be merged panels have the same Row Index and Column Index
property values, after merging the panels, in the exported Excel file, the objects will be merged into
one cell, and they will be located in the cell based on this rule: the object whose X/Y property value is
smaller than others will be put to front, and Y has higher priority than X. However, you can improve
the appearance of the report by relocating the objects.
Don't set the property Merge to Next Panel to true for the last GroupFooter panel. That will make the
exported Excel file incorrect.
Don't set the property Merge to Next Panel to true for the panel that contains crosstab or subreport.
Example
Suppose there is a standard banded report which displays the fields Customer Name, Annual Sales, and
is grouped by Customer_Country and Customer_Region.
Then we set the Columned property of the report to true and Merge to Next Panel of the first
GroupHeader panel to true as well, save the report and export it to Excel. We can see that the two group
by panels are merged into one and fields in the two panels are put in one cell in the exported Excel file.
In order to improve the layout of the Excel result, now we specify the Column Index and Row Index
properties of the objects as below:
Object
Column Index
Row Index
Save the report and export it to Excel again. We can see that fields in the Excel file are shown more
clearly this time.
When the objects in the GroupHeader/BandedPageHeader panel have the same Row Index and
Column Index property values with those in the Detail panel, and you specify to repeat the
GroupHeader/BandedPageHeader panel in the Detail panel, in the exported Excel file, the repeated
objects will be put in the same cells with the ones in the Detail panel based on this rule: the object
whose X/Y property value is smaller than others will be put to front, and Y has higher priority than X.
However, you can improve the appearance of the report by relocating the objects.
When you specify to repeat a GroupHeader panel, if there is a chart in the panel, the chart cannot be
repeated.
If a banded object contains more than one group by fields, that is to say, it has several GroupHeader
panels, when you specify to repeat the first GroupHeader panel in the Detail panel, it will be repeated
in the second GroupHeader panel as well.
To Text
JReport supports exporting to both a regular Text file and a CSV file.
If the report contains drop-down list object, only the selected value in the list can be exported.
The objects, which seem in the same line in other formats (such as PDF), may be in the different
lines, or some unwanted blank lines will be generated. The exception is caused by the differences
between the dimension values - y and height.
exported file is further processed by other applications. The following shows an example:
Scarsdale,The Java King,(914) 657-9823,(914) 657-8745,$78,321.00
As shown above, it is difficult to determine whether the value is $78321.00 or $78 and 321.00.
8. Click OK to start exporting.
See also Export to Text dialog for details about options in the dialog.
When exporting a report to a CSV file, you may want to export only some of the objects in the report
instead of the whole report. To achieve this, you can do it as follows:
1. In the Report Inspector, select the node that represents the object you want to export to the
result file.
2. Set the property Export to CSV of this object to true.
3. Repeat the above steps to specify other objects that you want to export.
4. Set this property to false for all the other objects that you do not want to export.
5. Click File > Export To > Text.
6. In the Export to Text dialog, specify the directory and name of the exported file.
7. Make sure that you have checked the Delimited Format box, and selected CSV Delimited format.
8. Click OK to start exporting.
Then, the exported file will only contain objects whose Export to CSV property value has been set to
true. Note that if you set the Export to CSV property of an object to false, all the object's children will
not be exported regardless of their individual Export to CSV properties.
Notes:
No matter the report is exported to a general CSV file or a columned CSV file,
The data of each field should be in one column. If there is no data in a column, empty strings (" ")
will be placed there automatically. In which case, the empty strings cannot be compressed. Only if
there is no data in the entire line, can a row be compressed when you check the Compress option.
In the Export to Text dialog, if you select Custom Delimited, you should export the report to a .txt
file instead of a .csv file. Then, open the exported file with Excel, and the Text Import wizard will
be displayed. In this wizard, check the Delimited radio button, click Next, check Other on the
Delimiters panel and key in the delimiter you specify in the Export to Text dialog, and then click
Finish to view the results.
When you specify to export a report to a general CSV file,
Objects in the exported file will be located according to its dimension values (x, y, width, height)
you set in the Report Inspector.
In the exported file, you may find that some column names are not aligned with their DBFields, so
they may be displayed in different columns. To resolve this problem, make both the column names
and its DBFields to be left aligned and adjust their location using the same Geometry X before
exporting it to a general CSV file.
When you specify to export a report to a columned CSV file,
Objects in the exported file will be located according to their Row Index and Column Index property
values. When setting values for these two properties, pay attention to the following:
Make sure that the Row Index and Column Index property values for all objects in a report do
not conflict with each other. Otherwise, some objects may be replaced.
If either the Row Index value or Column Index value of an object is less than 1, JReport will
ignore this object and all its children.
In the exported file, you may find that some column names are not aligned with their DBFields.
They may be displayed in different columns. To resolve this problem, set the Column Index value
of the column name and its DBField to the same; if they are different, adjust it manually before
exporting it to CSV format.
If the report contains drawing objects, you need to manually adjust these objects' geometry
properties, which are Top Attach Column, Top Attach Row, Bottom Attach Column and Bottom
Attach Row.
You are not recommended to export a mailing label report to a columned CSV file.
When the Fast Pass property is set to true, in the report header panel, the values of the objects that
use global parameters to make calculations will be incorrect. Page level calculation, such as Page
Number and Total Page Number, will also be incorrect. In order to avoid such errors, you should
move these objects from the report header panel to the report footer panel.
Remember to set the positions for objects with the Column Index and Row Index properties.
Otherwise, all the objects will be located in the first column and the first row of the result file.
To RTF
To export the results of a report to a RTF format file, follow the steps below:
1. In JReport Designer, open the report set that contains the report you want to export.
2. On the report tab bar, click the tab that represents the report.
3. Click File > Export To > RTF to access the Export to RTF dialog.
4. Specify the directory and file name respectively in the Directory and File name text boxes. If you
don't specify the name, JReport will apply the report name as the default RTF file name.
5. Check the No Margin checkbox to remove the margins that are originally set while you design the
report.
6. Check Best Editing to apply the flow layout when exporting.
7. Click OK, and a file with the extension .rtf will be generated.
Notes:
If Best Editing is checked, the results can be edited easily, but the layout may be different from that
you designed, because some flow layout properties will not be supported by JReport RTF exporter,
such as clear, relative and so on.
In the Best Editing mode, one report just has one default tab which is in the last paragraph, so
others will be ignored.
In order to get a better effect, Microsoft Office Word 2003 is recommended.
To XML
To export the results of a report to an XML format file, follow the steps below:
1. In JReport Designer, open the report set that contains the report you want to export.
2. On the report tab bar, click the tab that represents the report.
3. Click File > Export To > XML to bring out the Export to XML dialog.
4. Specify the destination of the exported file in the Export to field box.
5. In the Schema File Name field, specify an XSD file to export the report to an XML file based on the
specified XSD file.
6. Check the Only Data checkbox to only export data of this report.
7. When done, click the OK button, and a file with the extension .xml will be generated.
The following are some notes you should be aware of when exporting report results to XML:
The existing schema file that you specify must also be generated from this report. If you use other
schema files, a NullPointerException exception will be thrown out.
If the existing schema file that you specify contains only data, and you have cleared the Only Data
checkbox in the Export to XML dialog, the exported XML file will then only contain database column
information. The content of the exported XML file will be consistent with the schema file it is based
on.
If you delete an element node or an attribute node from the existing schema file, the exported XML
file which is based on it, will not contain the corresponding column. In a not only data schema file,
only the removal of an element used in a formula control property will affect an exported XML file
which is based on it.
Example: Deleting an element node from a schema file affects the exported XML file which
is based on it
Let's take EmployeeInformation.cls as an example.
1. Click File > Open on the menu bar.
2. In the Open Report Set dialog, click the Browse button to open the catalog file
If you do not want to see all the property values in a generated XML file, you can comment out any
unwanted properties in this way:
1. Open the file JRXMLTag.properties located in resource.jar in <install_root>\lib.
2. Add a question mark in front of any unwanted properties to comment them out. See below:
Change: Suppressed=Suppressed
To: ?Suppressed=Suppressed
3. When you export the report to XML, the exported XML file will not contain the property
Suppressed for each report object.
4. Save the property file and refresh the one in resource.jar.
In addition, when you uncheck Only Data, and add an @ sign in front of the value in JRXMLTag.
properties, the property listed in the Element node will then move to the Attribute node.
For example, in JRXMLTag.properties,
Change: StartYPos=StartYPos
To: StartYPos=@StartYPos
You will now find that the StartYPos property is now listed in the Attribute node.
Before adding the @ sign in front of the value, the StartYPos property will have been listed in
the Element node.
To PostScript
To export the results of a report to a PostScript file, follow the steps below:
1. In JReport Designer, open the report set that contains the report you want to export.
2. On the report tab bar, click the tab that represents the report.
3. Click File > Export To > PostScript to access the Export to PostScript dialog.
4. Specify the directory where the export PostScript file will be saved. If the directory does not exist,
an error message will be produced.
5. Enter the name for the exported file.
6. Check No Margins if you want to remove the margins that have been set to the report at design
time.
7. When done, click OK to perform the export operation.
Note: When you export a report to a PostScript file, some objects in this report may be located
imprecisely. You can print your report with PDF in order to get the accurate printed results. Therefore,
you are recommended to export report to PDF rather than to PostScript.
To fax
JReport Designer provides the feature of exporting the report results to fax either via a fax machine or
a fax server. If you require this feature to be enabled, you will first need to configure your running
environment.
Download the files listed in the tables below from our website (http://www.jinfonet.com/download/third
party tool/JavaCommAPIV2 Win32.zip or http://www.jinfonet.com/download/third party tool/
JavaCommAPIV2 Solaris.zip), and put them in the specified locations:
For Windows
File Name
Location
comm.jar
<Java_install_root>\jre
\lib\ext
javax.comm.
properties
<Java_install_root>\jre
\lib
Win32Com.dll
<Java_install_root>\jre
\bin
For Solaris
File Name
Location
comm.jar
<Java_install_root>/
jre/lib/ext
javax.comm.properties
<Java_install_root>/
jre/lib
libSolarisSerialParallel.
so
LD_LIBRARY_PATH
Meanwhile, before you can export report results to fax, you need to have settings of the fax machine or
fax server configured. Otherwise a warning message will be displayed when you try to export to fax. To
do this:
1. In JReport Designer, click File > Options on the menu bar.
2. In the Options dialog, select the Export to category.
3. In the Fax tab, specify via which you want to fax the report results: fax machine or fax server.
4. Configure settings of the fax machine/server as required (For details about the settings, refer to
Export to - Fax).
5. Click OK to accept the changes.
Now, you can export your report results to fax as follows:
1. Open the report set that contains the report you want to export.
2. On the report tab bar, click the tab that represents the report.
3. Click File > Export To > Fax on the menu bar.
4. In the Export to Fax dialog, specify the settings as required.
To Applet
JReport Designer can collaborate with a web server by exporting a report as an applet to a server. After
publishing it to the server, you can then retrieve it by accessing the server.
width=800 height=600
4. Run the web browser with the web server to view the results.
Notes:
Before you can view the results in a web browser, make sure you have enabled Additional Unsigned
Permissions for the web browser.
To enable the option in Internet Explorer:
1. Open the Internet Explorer, then click Tools > Internet Options.
2. In the Security tab, click Custom Level, scroll down Settings to set Java Permissions to
Custom, click Java Custom Settings.
3. In the Edit Permissions tab, check Run Unsigned Content.
4. Click OK to accept the changes.
JReport Server also supports requesting the report result in an applet from a web browser.
Publishing resources
Publishing resources
JReport Designer, as a report design tool, allows you to publish your resources from JReport Designer to your local computer or to
JReport Server.
2. Click the Browse button to select a catalog, or type the catalog name with its full path directly into the From Catalog text field, and
then press Enter to specify the catalog. All the report sets in the specified catalog will then be displayed in the Select Report Set box.
3. Select the report sets that you want to publish from the Select Report Set box and click the arrow button to add them to the box on
the right, or directly drag the reports you want to publish from the Select Report Set box to the box on the right. If no report set is
selected here, only the catalog will be published.
4. Specify a directory for the catalog and report sets that are to be published.
Click the Browse button to the right of the To Local Directory text field, and locate a directory in the Get Directory dialog. Or you
can type a directory in the text box directly. If you type in a directory which does not exist, JReport Designer will automatically
create it for you.
5. Click Next to view or modify properties of the data source connection.
First, select a data source from the Catalog Data Source drop-down list, and then the connection properties of the selected data
source will be displayed. If the selected data source is built on a JDBC connection, you can click the Modify button to modify
properties of the data source connection in the Get JDBC Connection Information dialog.
6. Click the Finish button to publish the catalog and report sets.
See also Publish to Local Directory dialog for details about options in the dialog.
2. Type in the host and port of the remote JReport Server in the Host and Port text fields.
3. When using a standalone server, enter /jrserver in the Servlet Path text field or the context root of your web application if deployed
as a war or ear file such as /jreport/jrserver.
4. If the server has been integrated with another web server that supports SSL, select the SSL (Security Socket Layer) checkbox to
create an SSL connection.
5. Check Remember connection information to enable JReport Designer to remember the connection information, and then provide
the user name and password of the server.
6. Click Connect. The Publish to JReport Server dialog is then displayed.
7. Click the Browse button next to the Publish Resource From text field to find the directory where your resources are located, and the
resources in the specified directory will be loaded automatically. If you choose to type in the directory in the text field directly, you
need to press Enter on the keyboard to load the resources in that directory.
8. In the resource tree panel, check the checkboxes in front of the resources that you want to publish.
9. In the Publish Resource To text field, specify the folder on the server where the resources are to be published. Use the default
location (the My Reports node in the server resource tree) or click the Browse button to specify a location on the server.
Note: If you want to publish the resources to a double-byte-character folder on the server, you need to add -Djreport.url.
encoding="UTF-8" to JReport.bat/JReport.sh in <install_root>\bin.
10. Select a to-be-published resource in the resource tree panel and then click the More Options button to set properties for the
resource.
11. In the Properties tab,
a. In the Resource Node Name text field, specify a name to be displayed in the server resource tree for the resource. You can type
a name in the text field or click the Browse button to select a resource name from the Select Resource Name dialog, where all
resource names of the same type as the selected resource, which are contained in the Publish Resource To path, are displayed.
b. In the Resource Description text box, type a brief description to describe the resource.
c. If a report set is selected, specify the status of the report set by selecting the required item from the Status drop-down list.
d. If a folder is selected, type a real path in the Resource Real Path text field. If no path is specified, the default path will be used.
e. Specify custom field values for the resource if there are custom fields enabled on JReport Server. A custom field can be
regarded as a resource property. For details, see Working with custom fields in the JReport Server User's Guide.
f. Check Apply Archive Policy to apply an archive policy to the resource.
12. In the Permissions tab, check the Enable Setting Permissions option to specify permissions for the selected resource (this tab is
available only when you have specified to publish the resources to the Public Reports folder on the server).
13. If the selected resource is a catalog, the Connection tab will be activated. You can view and modify properties of the selected data
source connection as required.
First, select a data source from the Catalog Data Source drop-down list, and then the connection properties of the selected data
source will be displayed. If the selected data source is built on a JDBC connection, you can click the Modify button to modify
properties of the data source connection in the Get JDBC Connection Information dialog.
14. Repeat steps 6 - 9 to set properties for other resources as required.
15. Click OK to publish the resources. If the resources that you are publishing contain reports that use style groups or have special
fonts, a dialog named Publish Font and Style will be displayed for you to specify them.
See also Publish to JReport Server dialog for details about options in the dialog.
Notes:
If you have made some changes to the to-be-published resources, but haven't saved them, before publishing starts, JReport will save
the changes automatically to ensure the resources published to the server are the latest.
After resources have been published to JReport Server, you may find that the publish time shown on the server UI is different from the
client time. That is because the publish time takes the server time instead of the client time.
2. Type in the host and port of the remote JReport Server in the Host and Port text fields.
3. When using a standalone server, enter /jrserver in the Servlet Path text field or the context root
of your web application if deployed as a war or ear fie such as /jreport/jrserver.
4. If the server has been integrated with another web server that supports SSL, select the SSL
(Security Socket Layer) checkbox to create an SSL connection.
5. Check Remember connection information to enable JReport Designer to remember the
connection information, and then provide the user name and password of the server.
6. Click Connect. The Download from JReport Server dialog is then displayed.
7. In the Download Resource From text field, specify the folder on the server where to download
resources. Use the default location (the My Reports node in the server resource tree) or click the
Browse button to select a folder on the server. The resources in the specified folder will then be
loaded automatically in the resource tree panel.
8. In the resource tree panel, check the checkboxes in front of the resources that you want to
download.
9. Click the Browse button next to the Download Resource To text field to specify the path to which
resources will be downloaded, or type in the directory in the text field directly.
10. Click the OK button to download the resources from JReport Server.
When the resources are successfully downloaded from JReport Server, you can then open them in
JReport Designer, and further edit them if required. However, if any report set is created in JReport
Viewer based on business/report cubes, it can only be previewed in JReport Designer.
See also Download from JReport Server dialog for details about options in the dialog.
Notes:
Resources in the Public Reports folder of JReport Server are secured via permissions. If you specify
to download resources from that folder, which resources you can see in the resource tree panel and
which resources you can download are determined by the user name with which you use to connect
to the server. You can only view the resources on which you have the Visible permission in this panel
and download resources on which you are assigned the Read permission. For details about resource
permissions, refer to Changing resource and folder properties in the JReport Server User's Guide.
Downloading reports which use business views, report cubes or business cubes as data source from
JReport Server requires that JReport Designer and JReport Server each has its own Live license.
JReport SDK
JReport is a Java-centric object-oriented reporting tool written entirely in Java. With the bean
components, provided by JReport, you can easily incorporate JReport into your own applications. The
JReport Beans can be used inside IDE tools such as Eclipse, NetBeans, and WebSphere Studio. By
combining the power of JReport bean APIs and the reusability of JReport beans, you do not need to
open a JReport GUI each time to run, print, or diagnose the problems of a report.
Note: The JReport Design Bean is a discontinued product, and has been removed from the JReport
documentation.
lib\JREngine.jar*
Archive file for JReport Engine Bean.
bin\report.ini*
Configuration file.
lib\log4j-1.2.8.jar*
Jar file used for the JReport Engine logging system.
lib\resource.jar
Resources of JReport Designer.
lib\xml-apis.jar, xercesImpl.jar
Jar files used when exporting to XML.
lib\JRResultViewer.jar
Jar file for JReport Result Viewer Bean.
lib\chart.jar
Jar file used when exporting to HTML with images that are to be embedded as a chart applet in the
HTML file.
lib\udo\udo12.jar
Register of user defined objects.
lib\activation.jar
Jar file used when exporting to mail.
lib\mail.jar
Jar file used when exporting to mail.
lib\itext_1.5.4.jar
Jar file used when exporting to PDF.
lib\iTextAsian.jar
Jar file used for the Asian fonts.
lib\poiHSSF_151.jar
Jar file used when exporting to Excel.
lib\sac.jar
Jar file used to parse xml files.
lib\commons-codec-1.2.jar
Jar file that provides implementations of common encoders and decoders such as Base64, Hex,
Phonetic and URLs.
Readme.html, License.html
Release information.
Note: * represents the files that are required when JReport Engine Bean is called.
Since the only archive file for Report Engine Bean is JREngine.jar. You will need to set the class path
environment variable before you can compile and run the program. Append the following string to
the class path:
<install_root>\lib\JREngine.jar;<install_root>\lib\log4j-1.2.8.jar.
Before you call the methods for exporting a report to Mail, PDF, Excel or XML format, you first have
to add the corresponding class files or jars with a valid path into your class path.
PDF: itext_1.5.4.jar
Excel: poiHSSF_151.jar
When you set the reporthome in the Engine Bean, JReport will retrieve information from the file
report.ini in <install_root>\bin and then check whether it is valid by setting a runtime key in the
bean. If you then open report.ini, you will find that the configuration information, including the
temporary path, template path and the help path. JReport Engine Bean uses the temporary path to
export temporary files. You should therefore make sure that the temporary folder specified in report.
ini exists.
JREngine.jar
JReport Engine Bean.
JRResultViewer.jar
Result Viewer Bean.
log4j-1.2.8.jar
Jar file used for the JReport Engine logging system.
chart.jar
Jar file used when exporting to HTML with images that are to be embedded as a chart applet in the
HTML file.
udo12.jar
Registers user defined objects.
report.ini
Configuration file.
activation.jar
Jar file used when exporting to mail.
mail.jar
Jar file used when exporting to mail.
poiHSSF_151.jar
Jar file used when exporting to Excel.
lib\itext_1.5.4.jar
Jar file used when exporting to PDF.
lib\iTextAsian.jar
Jar file used for the Asian fonts.
LogConfig.properties
Used to configure log mechanism.
sac.jar
Used to parse xml files.
Notes:
In your code, if you set the reporthome as c:\\jreport\\designer, the file report.ini will be read in
the directory c:\jreport\designer\bin. You will find in this file the configuration information,
including the temporary path, template path and the help path. JReport Engine Bean will use the
temporary path to export temporary files. You should therefore ensure that the temporary folder
specified in the file report.ini exists.
If you only want to generate a report, you will only need JReport Engine Bean. While if you want to
view a report result file, you will also need JReport Result Viewer Bean.
Description
UID
key
reportHome
The home path where report.ini and other JReport system files exist.
reportName
catName
The name of the catalog which contains all the required objects used in the report.
paramValues
paramFile
The name of the parameter value file. This will be ignored if paramValues has
been specified.
resultFile
The following methods are used for assigning values to the above properties:
setUID("UID")
setKey ("key")
setReportHome("HomePath")
setReportName("ReportName")
setCatName("CatalogName")
setParamValues("ValuesString")
setParamFile("ParamFileName")
setResultFile("ResultFileName")
Where,
HomePath - The installation path for JReport Designer. Strictly speaking, if you set the ReportHome
as c:\\jreport\\designer, then the first thing JReport Engine Bean will do when running a report is
to check the jslc.dat and report.ini files in c:\jreport\designer\bin are valid.
reportName - A string which contains both report path information and the report name.
catName - A string which contains both catalog path information and the catalog name (the report
path and the catalog path may be different).
ValuesString - A string which assigns a new value to the parameter used in the current report. The
parameter should be the one defined in the catalog.
If more than one parameter is needed in a report, you can pass multiple parameters in the
paramValues string. The ValuesString format is: paraName1=paraValues1, paraName2=paraValue2
where paraName1 and paraName2 are the parameter names and paraValue1 and paraValue2 are the
values. The comma is the separator operator, and the equal sign for separating the parameter name
and parameter value. If the parameter name or parameter value contains a separate operator
(comma or equal sign), it will need an escape. JReport has therefore provided an escape operator -- \
\. If you put the escape operator before the separator operator, it will not be treated as a separator
operator. For example:
* the parameter string is: "param1=aaa\\,aa,param2=bbbbb,param3=ccccc"
it will be parsed to:
the value for param1 is aaa, aa
the value for param2 is bbbbb
the value for param3 is ccccc
* the parameter string is: "pa\\=ram1=aaa\\,aa,param2=bbbbb,param3=ccccc"
it will be parsed to:
the value for pa=ram1 (name) is aaa, aa (value)
the value for param2 is bbbbb
the value for param3 is ccccc
When passing multiple parameters in the paramValues string, note that you do not have to set all
parameter values. If you do not set a parameter value, JReport will use the default value. Also, if you
want to know the report's parameters without running reports, you can call the method
getReportParams(). This method will return a vector, and each element of this vector is jet.formula.
ParamDesc. The class ParamDesc has five public properties:
isColumn - Indicates whether the parameter must be of DB column name type or of Boolean type.
If the parameter is of DB column name type, its value must be an available group field. By calling
the method getAvlGroupFields(), it will return a vector which contains all the available group fields.
However, note that if more than one parameter is of DB column name type, their values cannot be
the same.
ParamFileName - The name of the parameter value file. This will be ignored if paramValues has
been specified. The format of the parameter file is: one parameter name-value pair will take one line,
and another parameter name-value pair will start from a new line. Each line is formatted as
paramname=paramvalue, and you are also provided with the escape operator (\\) for equal sign
same as above.
ResultFileName - The name of the result file. If you want to generate a report result file (with an .
rst extension), then set the result file name (with an .rst extension) with a full file path. For example,
setResultFile("c:\\temp\\test.rst"). The resultFile contains both the path and the file name
information. If there is no path specified, the current path will be used. If there is no file name
specified, the reportName will be used (with an .rst extension).
Notes:
When you call JReport Engine Bean in your application program, your Runtime user ID and Runtime
key are required.
The method runReport( ) has the same effect as setLoadReport ("yes").
When JReport Engine Bean runs the report result, it will generate an .rst file first. However, you may
want to run the report result and then export it to other formats such as HTML and PDF without
generating an .rst file. This feature is now supported. The method runReport( ) and runReport(true)
are equivalent, and each method will always generate an .rst file. If you do not want to generate an .
rst file, you can call runReport(false). This method will print, and output the report result without
generating an .rst file and the performance will also be improved.
Preparations
Illustrative examples
Preparations
Before programming with the Engine Bean, you need to import the Engine Bean classes by adding the following
import statements to the beginning of your program. The first import statement is added to import the bean class:
import jet.bean.*;
import java.awt.*;
import java.awt.event.*;
Then, you need to create an instance of the Engine Bean.
Note: When you call the Engine Bean in your program, you should first set the JReport Runtime user ID and key.
bean.setUID("JReport Runtime User ID");
bean.setKey("JReport Runtime Key");
After the object has been created, set the reporthome, report file, catalog file, result file (if necessary), and
parameter values (if necessary).
bean.setReportHome("C:\\JReport\\Designer");
bean.setReportName("C:\\JReport\\Designer\\Demo\\Reports\\SampleReports\\CustomerAnalysis.cls");
bean.setCatName("C:\\JReport\\Designer\\Demo\\Reports\\SampleReports\\SampleReports.cat");
bean.setTimeZone("CST");
bean.setParamValues("p_StartDate=01/01/2006,p_EndDate=12/31/2007");
bean.setResultFile("C:\\JReport\\Designer\\temp\\CustomerAnalysis.rst");
bean.runReport();
Note: You can run or export a self-contained report by calling JReport Engine Bean. Suppose you want to run a selfcontained report called CustomerAnalysis.clx, which is saved in C:\JReport\Designer\Demo\Reports
\SampleReports. You will not need to set the catalog name in your code, you can just set the report home, report
file, and specify whether to output the debug or error information (if necessary) and log file (if necessary) as below:
bean.setReportHome("C:\\JReport\\Designer");
bean.setReportName("c:\\JReport\\Designer\\Demo\\Reports\\SampleReports\\CustomerAnalysis.clx")
bean.setShowInfoLevel( bean.vDebug | bean.vError );
bean.setLogFile("");
bean.runReport();
With the JReport Engine Bean object, you can manipulate and access many reports, without needing to create a
bean for each one. JReport Engine Bean provides many useful methods, which you can call before or after the
runReport() method.
Printing reports
setShowInfoLevel(vDebug/vError/vOff)
vDebug, vError and vOff are used for showing and turning off debug and error information.
setLogFile("LogFileName")
LogFileName specifies where the debug, error and other information will go. LogFileName contains
both the path and the file name. If no path or file is specified, the default is used. Only the log file
specified here will take effect when running reports, and the log files specified before will be closed.
Notes:
To make LogConfig.properties work, you should set -Dreporthome=<reporthome> in the batch file
and not use bean.setShowInfoLevel( bean.vDebug/bean.vError ) in your programs.
If you use bean.setLogFile("LogFileName") in your programs, the log file path and name will be this
one, otherwise, the log file is the default one in <reporthome>\logs\.
If the reporthome in -Dreporthome=<reporthome> is different from that you set in the program, the
former will be applied.
"OK"
Error: Cannot find the resource file JRsIndex.jrc! - This is caused by the incorrect setting of the
report home path.
Error: Cannot open the catalog "Catalog Name"! - JReport Engine Bean cannot open the specified
catalog file.
Error: Cannot open the report "Report Name"! - JReport Engine Bean cannot open the specified
report file.
Error: Cannot open the parameter file "Parameter file name"! - JReport Engine Bean cannot open the
specified parameter file.
Error: Unknown format in Parameter values! - The parameter values string is in the wrong format.
exportToHtml
The method exportToHtml(java.lang.String htmlFileName) will take the method exportToHtml(java.
lang.String htmlFileName, boolean bChartApplet, boolean isMultiFile, boolean bUsingTable, boolean
bHyperlink, boolean bPageNum, boolean bAbsolute, int iBrowser) using the default parameter values
such as: exportToHtml("HtmlFileName", false, true, false, true, true, true, JREngine.IE).
exportToMail
Before the method exportToMail is called, the mail server should first be configured with the following
method:
configMailServer(String SMTPServerIP, String MyMailAddress, int SMTPServerPort)
where
SMTPServerIP is the mail server IP address.
MyMailAddress is the sender's mail address.
SMTPServerPort is the mail server port.
exportToMultiMail
exportToPdf
exportToText
exportToXlS
exportToPS
exportToRtf
exportToXML
exportToFax
If you want to export the report result to fax, you need to download the files listed in the table below
from the website http://java.sun.com/products/javacomm/index.html, and then put them into the
specified locations (on Windows).
File Name
Location
comm.jar
<designer_install_root>\lib
javax.comm.
properties
<Java_install_root>\jre\lib
Win32Com.dll
<Java_install_root>\jre\bin
Printing reports
The following methods are provided for printing reports:
printReport( )
printReport(Object printJob, Object pageFormat, boolean bInteractive, boolean bInBackground,
boolean bUseJDK11)
printReport(Object printJob, Object pageFormat, boolean bInteractive, boolean bInBackground,
boolean bUseJDK11, boolean bSeparateLargePage)
printReport(Object printJob, Object pageFormat, boolean bInteractive, boolean bInBackground,
boolean bUseJDK11, boolean bSeparateLargePage, String jobName)
printReport (Object printJob, Object pageFormat, boolean bInteractive, boolean bInBackground,
boolean bUseJDK11, boolean bSeparateLargePage, String jobName, String printer)
printReport(java.lang.Object job, boolean bInteractive, java.lang.Object pf, boolean bInBackground,
JReportPrintListener jreportprintlistener, int useJDK, java.lang.String jobName, java.util.Vector
attributeInfo, java.lang.String printer)
getPrintStatus( )
Parameters
bInteractive - A Boolean value. If you set it to false, the Print Setup dialog will not be shown.
bInBackground - A Boolean value. If you set it to true, the Print dialog will not be shown.
bUseJDK11 - A Boolean value. If you set it to true, JDK1.1.x will be used to print the report.
Otherwise, if you set false, the JDK that you are currently running will be used to print the report.
The JDK 1.1 printing method is quick in speed but the printing quality cannot be guaranteed. The JDK
1.2 method will give you a satisfactory result, even for a .gif file. But it is slow in speed.
bSeparateLargePage - A Boolean value. If the report page size is larger than the print paper size,
and you want to separate a large report page during printing, you should set this property to true. If
the print page size chosen is less than the report page size, the report will then be printed in multiple
pages serially. This means that a large page of a report will automatically be separated. After you set
this parameter to true, for JDK1.2 or later, the Page Format dialog will be displayed. In this dialog,
you can choose the page format for printing. However, for JDK1.1.x, you will have to change the
page format with which you want to print in the Print dialog (click the Property button, and then
choose page format).
jobName - A String value of the job name. When printing, the defined job name will be listed in the
window, which can show the information such as the status and owner of a document.
printer - The name of the printer used to print the report. Note that if you set bUseJDK11 to false,
you will not be able to set the printer, and instead will be required to use the default printer.
job - The print job of this print action. It is an instance of PrintJob or PrinterJob.
bUseJDK - An Integer value. If you set it to 0, the method JDK1.1 will be used to print the report. If
you set it to 1, the method JDK1.2 will be used to print the report. If you set it to 2, the method
JDK1.4 will be used to print the report. The JDK 1.1 printing method is quick in speed but the
printing quality cannot be guaranteed. However, the JDK 1.2 method will return you with satisfactory
result, even for a .gif file. But it is slow in speed. JDK 1.4 provides further options, such as specifying
the paper tray.
attributeInfo - A vector where the elements are String.
Each String has been defined in interface PrintConfig. Interface PrintConfig is located in package jet.
bean. For example, you can implement PrintConfig and call its fields as below:
attributeInfo.add(TRAY_MANUAL);
attributeInfo.add(ORIENTATION_PORTRAIT).
Notes:
The first method printReport() is called to start the print. It will then take the third method using
default parameter values such as:
printReport(null, null, true, false, false, false)
The second and third method allows you to pass the parameters -- printJob, pageFormat,
bInteractive, bInbackground, bUseJDK11 and bSeparateLargePage.
The third printing method (with the bSeparateLargePage parameter) is not recommended. It may
cause some unexpected errors, for example, you may get an extra blank page.
After printing is started, the method getPrintStatus() can be used to show the print job status.
Returned values of getPrintStatus() are:
"No print job"
"Busy"
"OK"
"No report load"
Other error messages if there are errors.
Examples
Example 1
Under JDK1.2 or later, if you use the JDK1.2 printing method (boolean bUseJDK11), you can call the
printReport method, as shown below
PrinterJob printJob = PrinterJob.getPrinterJob();
bean.printReport(printJob, printJob.defaultPage(), false, false, false);
Or, if you do not want to getPrinterJob, simply call:
bean.printReport(null, null, false, false, false);
Example 2
Under JDK1.2 or later, if you use the JDK1.1 printing method, you are best recommended to not
getPrintJob. Instead, just can call:
bean.printReport(null, null, false, false, true);
Example 3
Under JDK 1.2 or later, if you use the JDK1.1 printing method and select a network printer, you can
Example 4
Under JDK 1.2 or later, if you use the JDK1.1 printing method and select a local printer, you can call
the printReport method as shown below:
bean.printReport(null, null, false, false, true, false, "job1", "HP LaserJet 6L Pro
PCL5e");
setNamedWherePortion(queryName)
Sets a named WHERE portion from the catalog to the query of the current report. If this WHERE
portion is not found in the catalog, "false" will be returned.
setWherePortion(WherePortionString)
Sets the WHERE portion in String format to the query of the current report.
saveWherePortion(queryName, WherePortionString)
Saves the WHERE portion in String format with the specified query name in the report catalog.
deleteWherePortion(queryName)
Deletes a specified WHERE portion from the report catalog, updates and saves the catalog after
deletion.
getAvailableQueryFields()
Gets the available query fields from the query of the current report. This will return an enumeration
of the names of fields, formulas and parameters and their corresponding data types which are
required to build up the WHERE portion and validate the condition.
getAvailableWherePortions()
Gets an enumeration of the names of all the WHERE portions saved in the report catalog.
SaveCatalog()
Saves the current catalog. Returns "true" if successfully saved.
Parameters
fileName - The name of the SQL file (the SQL file is the file which contains the SQL statement).
dataDriver - The URL that specifies the User Data Source. For example: jrquery:/
AddressListDataSource;c:\AddressList.txt.
cachQueryResultSetFile - The full file path of Cached Query Result. For example "c:\myresult\XXX.
rst".
setLocale(Locale currentLocale)
setEncoding(String encoding)
Notes:
At runtime, you can specify the encoding and locale for rendering the report result accordingly.
However, make sure that when you design the report, you set it to support NLS, and that you have
created the property file for the language you want to apply.
In addition, JReport also provides the method Vector getAvailableLocales(String clt), which gets all of
the Locales that the current report supports. The parameter clt is the current client's locale. If clt is in
current report Locales, it is moved to the index at zero.
getBundleUsage()
An integer value representing the usage of the NLS information, defined as INFOTYPE_TEXTREPLACE,
INFOTYPE_DATAMAPPING, or INFOTYPE_DATAMAPPING + INFOTYPE_TEXTREPLACE.
getDataMapped(String dataValue)
It will be called if getBundleUsage() is INFOTYPE_DATAMAPPING or INFOTYPE_DATAMAPPING +
INFOTYPE_TEXTREPLACE.
getTextReplace(int replaceID, String originText)
It will be called if getBundleUsage() is INFOTYPE_TEXTREPLACE or INFOTYPE_DATAMAPPING +
INFOTYPE_TEXTREPLACE.
getFontStyleReplace(String fontFace, double fs_inch)
It will be called if getBundleUsage() is INFOTYPE_TEXTREPLACE or INFOTYPE_DATAMAPPING +
INFOTYPE_TEXTREPLACE.
getIsEmptyBundle()
It specifies whether the NLS information is empty. Value type is boolean.
Parameters:
Suppose you have had a class to implement the NLSBundleInfo interface, you can then use the Engine
Bean to render customized NLS information to a report set as follows:
bean.setNLSBundleInfo( info );
Reference: See the sample class MyNLSBundleInfo.java in <install_root>\help\designer\samples
about how to implement the NLSBundleInfo interface.
These methods enable users to set the connection information before running a report. You can let the
user specify the user ID and the password before running a report to ensure security. Another
application of this method is for users to be able to select a different database before running reports,
in order to see different report results. Usually in this case, the two databases have the same structure
which eases the work of having to build another catalog.
This method may be called as below:
setConnection("jdbc:Oracle:thin:@204.177.148.30:1521:orcl","scott","tiger","oracle.jdbc.
driver.OracleDriver");
Parameters
String strURL - The URL of the database. For the format of the URL, refer to the instructions of your
JDBC driver.
String strJdbcDriver - The fully qualified name of the class. This class is responsible for connecting to
the database and fetching data. For example, com.sybase.jdbc.SybDriver or oracle.jdbc.driver.
OracleDriver. If not specified, the default one will be used.
boolean fetchSupportInfo - Set to true to get the user support information from the DBMS. This class
will only work when the user has set the connection object or URL.
Parameter
userResultSet - The JDBC ResultSet object created by the user. Users should release this by
themselves.
getSingleThread()
This method checks whether the current engine is single-threaded. The returned value is of Boolean
type. If the current engine is single-threaded, it will return true, otherwise it will return false.
setSingleThread(boolean single)
This method can be set to run the engine with a single thread. It is especially used in an environment
such as EJB, which only allows single thread when performing transactions.
Parameter
single - Set to true if you want to use single-thread. Otherwise, the default multi-threaded engine
will be used.
getUID()
Gets and returns the JReport Runtime user ID.
setUID(String uid)
Sets the JReport Runtime user ID to call JReport Engine Bean.
getKey()
Gets and returns the JReport Runtime key.
setKey (String key)
Sets the JReport Runtime key.
Parameters
boolean use - A Boolean type parameter which specifies whether to use boolean to control the
memory appender.
Note: You can use the method setUsedMemoryAppender(boolean use) only when the property
usedMemoryAppender is set to true.
Input stream API for feeding data via InputStream to JReport Engine.
Output stream API for retrieving exported report via OutputStream from JReport Engine.
Input stream API provides a programmable way to specify data for JReport products besides the URI.
For supporting input stream API, the following requirements should be met:
XML format data input stream from which JReport Engine fetches data.
createInputStream()
Creates a new input stream.
Except for implementing the InputStreamFactory interface, you need also call either of the two
methods in order to use input stream:
Reference: See the demo XmlStreamSample.java for input stream API usage in <install_root>\help
\designer\samples.
Output stream API enables exporting current report and specified result file as output stream in
common file formats, such as PDF, RTF, Excel, Text, and PostScript.
You can use output stream API as follows:
... ... JREngine bean = new JREngine();
bean.setReportHome(ReportHome);
... ...//initialize bean
OutputStream output=new FileOutputStream("filename");
... ...//initialize outputstream
bean.exportToPdf(output); ... ...
Illustrative examples
After you installed JReport Designer, you can find the following illustrative sample programs for using the Engine
Bean in <install_root>\help\designer\samples.
TestEngineBean.java
A sample program. Here is an explanation of how TestEngineBean.java works, and how it uses the methods
provided by JReport Engine Bean.
First, the example file TestEngineBean.java contains hard-coded paths. These must be modified before they can be
compiled and run. For example, assume that JReport Designer has been installed to C:\JReport\Designer, the
Test B section can be modified as follows:
bean.setUID("test");
bean.setKey("ffffffffffffffffffffffffffffffffffffffff");
bean.setReportHome("C:\\JReport\\Designer");
bean.setReportName("C:\\JReport\\Designer\\Demo\\Reports\\SampleReports\\CustomerAnalysis.cls");
bean.setCatName("C:\\JReport\\Designer\\Demo\\Reports\\SampleReports\\SampleReports.cat");
bean.setTimeZone("CST");
bean.setParamValues("p_StartDate=01/01/2006,p_EndDate=12/31/2007");
bean.setResultFile("C:\\JReport\\Designer\\temp\\CustomerAnalysis.rst");
The result file will be saved in the C:\JReport\Designer\temp directory and the result file name will be
SalesAnalysisbyRetailStore.rst.
In addition, TestEngineBean.java will also show how to use JReport Engine Bean to export the result file (.rst
extension) to the different file formats (HTML, PDF, TEXT, etc.).
Assume that SalesAnalysisbyRetailStore.rst has already been generated by JReport Engine Bean, you can then
export it to the different file formats:
bean.exportToPdf("C:\\JReport\\Designer\\temp\\CustomerAnalysis.pdf");
bean.exportToText("C:\\JReport\\Designer\\temp\\CustomerAnalysis.txt", true);
bean.exportToHtml("C:\\JReport\\Designer\\temp\\CustomerAnalysis.html");
C:\\JReport\\Designer\\temp\\... is the location where users specify the new generated files. Finally,
TestEngineBean.java will call the methods to add, delete, save and get the WHERE portion in the report catalog:
bean.saveWherePortion("WherePortionCustomerID","@\"Customer ID\" < 20");
bean.setNamedWherePortion("WherePortionCustomerID1");
bean.setWherePortion("((@\"Customer ID\" > 10) and (@\"Customer ID\" < 20))");
bean.deleteWherePortion("WherePortionCustomerID1");
bean.getAvailableQueryFields();
bean.getAvailableWherePortions();
To run TestEngineBean.java, you need to use the following command to compile it first:
C:\JReport\Designer\help\designer\samples>
javac -classpath C:\JReport\Designer\lib\jrengine.jar;C:\JReport\Designer\lib\sac.jar;
C:\JReport\Designer\lib\log4j-1.2.8.jar; TestEngineBean.java
Here, it is assumed that C:\JReport\Designer is the location where JReport Engine Bean has been installed to,
and it is the current directory when users execute these commands. The sample program can then be run with the
following command:
C:\JReport\Designer\help\designer\samples>
java -classpath C:\JReport\Designer\lib\jrengine.jar;C:\JReport\Designer\lib\sac.jar;
C:\JReport\Designer\lib\log4j-1.2.8.jar; TestEngineBean
java -Dreporthome="C:\JReport\Designer"
-classpath C:\JReport\Designer\lib\jrengine.jar;C:\JReport\Designer\lib\sac.jar;
C:\JReport\Designer\lib\log4j-1.2.8.jar;C:\JReport\Designer\lib\hsqldb.jar; TestEngineBean
When the sample program is complete, you will notice a temporary file <reportname>.rst. For this particular
sample program, it will either be customerlist.rst or phaseorder.rst depending on which report has been executed.
These result files can be read and displayed by either JReport Viewer (the thin client viewer) or JReport Result
Viewer Bean.
JReport Engine Bean is the module running report templates against a data source and exporting report
results to the specified format such as html, pdf, rtf and so on (see Exporting report results to different
file formats for methods about exporting report result to other formats).
The steps for this demo are as below:
1. Preparation
2. Wrapping the Engine Bean into a session bean
3. Building the EJB and running the client application
Preparation
To prepare for this demo you will need to install the Weblogic Server 8.1 and JReport Designer. Follow
the steps below:
1. Install WebLogic Server 8.1 to /home/bea/weblogic81.
2. Download Java EE SDK from http://java.sun.com.
3. Assume that you have installed JReport Designer in /home/jreport/designer. You will get
JReport Engine and related libraries in /home/jreport/designer/lib.
JREngine.jar - It is required.
Note: JReport Engine Bean in JReport Designer is of single thread. That is, you can only have it run
one report at a time. To build your production EJB which calls JReport Engine Bean for concurrent
multiple reports, contact Jinfonet Support about the JReport Server Engine product.
JReport Engine Bean is the module running report templates against a data source and exporting report
results to the specified format such as HTML, PDF, RTF and so on (see Exporting report results to
different file formats for methods about exporting report result to other formats).
The steps for this demo are as below:
1. Preparation
2. Developing the EJB session bean and the servlet that calls the EJB
3. Deploying the EAR file and starting the servlet
Preparation
To prepare for this demo, you will need to install the following:
1. Install WebSphere 5.1 to C:\websphere5.1.
2. Install WebSphere Studio Application Developer 5.1 (abbreviated as WSAD) to C:\IBM. In this
demo, we will use WSAD to:
3. Install JReport Designer to C:\JReport\Designer. You will then have the following JReport Engine
Bean and related libraries in C:\JReport\Designer\lib:
JREngine.jar - It is required.
log4j-1.2.8.jar - Required. It is called by JReport Engine to generate log information at
runtime.
sac.jar - Required. It is used to parse xml files.
hsqldb.jar - It is necessary for this demo. This demo runs a report against HSQL database, and
hsqldb.jar is the hsqldb driver.
This demo will export the report result to the HTML format. If you want to export the report result
to other formats, add the corresponding class files or jars. They are:
Excel: poiHSSF_151.jar
PDF: itext_1.5.4.jar
Note: JReport Engine Bean in JReport Designer is of single thread. That is, you can only have it run
one report at a time. To build your production EJB which calls JReport Engine Bean for concurrent
multiple reports, contact Jinfonet Support about the JReport Server Engine product.
Developing the EJB session bean and the servlet that calls the EJB
In WSAD, first create a project that contains the framework of the EJB and the servlet which calls the
EJB. Then, go to their editors to modify the code for the EJB and servlet. Follow the steps below:
1. Start WebSphere Studio 5.1. Create a new Java EE project named JReportEJBDemo.
To create the new project JReportEJBDemo,
a. Select Project from the File menu. The New Project dialog will then appear.
b. Highlight Java EE on the left panel in the New Project dialog, and then choose Enterprise
Application Project from the right panel. Click the Next button in this dialog. You will then
be taken to the New Enterprise Application Project dialog. Then, click Next in this dialog
directly.
c. Type JReportEJBDemo into the Project name text box, and click Next.
d. Click New Module and on the New Module Project dialog, select EJB Project and Web
Project. Then, click the Finish button.
e. You will now see that JReportEJBDemoEJB and JReportEJBDemoWeb have been generated.
Click Finish.
f. Add source files for the EAR.
i. Right-click Utility JARs in JReportEJBDemo, and click Import from the shortcut menu.
The Import dialog appears. Select File System from the Select an import source panel,
and then click the Next button.
ii. Click the Browse button and select the directory C:\JReport\Designer\lib. Select the
files JREngine.jar, log4j-1.2.8.jar, sac.jar and hsqldb.jar. For the Into folder text
box, click the Browse button and select JReportEJBDemo. Then, click Finish in the
Import dialog.
2. Create an EJB session bean named JReport for JReportEJBDemoEJB.
a. From the Java EE Hierarchy tree, expand EJB Modules, right-click Session Beans in
JReportEJBDemoEJB, and on the shortcut menu, click Session Bean from the sub-menu of
New.
b. In the New Enterprise Bean dialog, click Next.
c. This dialog helps you "Create a 2.0 Enterprise Bean". Type JReport in the Bean name text
box. Type demo in the Default Package text box. Click Next to go to the next dialog which
shows the Enterprise Bean Details (perform no actions in this dialog except for clicking Next).
Then, click Finish.
d. Now, in the Java EE Hierarchy tree, three EJB classes have been generated in the Session
Beans node. They will automatically have been named JReportHome, JReport, and
JReportBean. Note that JReportHome is the EJB home class, JReport is the EJB object class
and JReportBean is the EJB bean class.
3. Edit the three EJB classes.
JReport: Insert methods which have been defined to call JReport Engine Bean.
JReportBean: Implement the methods in the JReport class (the EJB object class).
a. Right-click JReportEJBDemoEJB in EJB Modules, and click Deployment and RMIC Code
from the Generate sub-menu. Check JReport.
b. Click Finish in the Generate Deployment and RMIC Code dialog and the changes will be
saved at the same time.
8. Export this JReportEJBDemoEJB to a jar.
a. Right-click JReportEJBDemoEJB and select Export EJB JAR File from the Export submenu.
b. In the Export dialog, specify a directory in the Destination text box. Use the default name
JReportEJBDemoEJB. The JReportEJBDemoEJB.jar will be generated in the specified path.
9. The EJB, which is JReportEJBDemoEJB, is now ready. Next, you should finish the servlet code in
the created web module, that is JReportEJBDemoWeb, to call this EJB via RMI. To generate the
servlet code,
a. Double-click JReportEJBDemoWeb. In the Web Deployment Descriptor, click Details of
Servlets and JSPs panel.
b. Click New to bring out the New Servlet dialog. Type JRServer in the Class name text box,
and click Finish. The JRServer.java is generated.
c. Add the following code into the JRServer.java.
InitialContext ic = new InitialContext();
Object objRef = ic.lookup("java:comp/env/jreport");
JReportHome home =(JReportHome)PortableRemoteObject.narrow(objRef,
JReportHome.class);
this.jreport = home.create();
Now, both the EJB and the servlet are ready in the same application. The next step is to export an
R file which includes the EJB and web project.
a. In the Java EE Hierarchy tree, select JReportEJBDemo, right-click it and click Export EAR File.
b. In the Export dialog, specify a directory in the Destination text box, using the default name
JReportEJBDemo. JReportEJBDemo.ear will be generated in the specified directory.
Preparation
Assume that:
JBoss 4.0.1 with integrated Tomcat 4.1.24 has been installed to D:\jboss-4.0.1_jakarta-tomcat-4.1.24.
In order to simplify your work, you are provided with a zip called ant_jreport_ejb.zip, which can be found in
<designer_install_root>\help\designer\samples. You can extract it to D:\jboss-4.0.1_jakarta-tomcat4.1.24 directory. This zip file contains a build utility Ant and the JReport EJB demo source code.
Ant is a third party tool, which compiles the Java source code, builds the EJB.jar, and deploys the JAR by
copying it to JBoss's deploy folder.
A file called build.xml is also included in the zip file. This is required by the Ant utility for working out what to
compile and how to build your JARs. It gives the Ant utility information about how to compile and deploy your
Java programs and EJBs. You can find the build.xml file in the D:\jboss-4.0.1_jakarta-tomcat-4.1.24
\workbook\jreport_ejb folder created by the extraction process.
If you need to know more about the Ant utility, visit the Ant project at the Jakarta website at http://jakarta.
apache.org/ant/index.html.
In jreport_ejb folder, there is a folder src, which contains the JReport EJB demo source code (workbook/src/
main/jreport) and two xml files used in JBoss deployment (workbook/src/resources/META-INF).
D:\jboss-4.0.1_jakarta-tomcat-4.1.24\workbook\jreport_ejb>
set JAVA_HOME=C:\jdk1.6.0_17
D:\jboss-4.0.1_jakarta-tomcat-4.1.24\workbook\jreport_ejb>
set JBOSS_HOME=D:\jboss-4.0.1_jakarta-tomcat-4.1.24
The ejb_jrengine.jar has now been successfully built and deployed to D:\jboss-4.0.1_jakarta-tomcat-4.1.24
\server\default\deploy.
Buildfile: build.xml
prepare:
compile:
ejbjar:
run.client_jreport:
[java] ReportHome: true
[java] ReportName: true
[java] CatName: true
[java] RstName: true
[java] getStatus = OK
[java] exportToPdf OK
[java] Exit
BUILD SUCCESSFUL
Total time: 15 seconds
lib\JRResultViewer.jar*
Jar file for the Result Viewer Bean.
lib\log4j-1.2.8.jar*
Jar file used for the JReport Engine logging system.
lib\activation.jar
Jar file for exporting to mail.
lib\mail.jar
Jar file for exporting to mail.
lib\resource.jar
Archive file used when exporting to XML.
lib\xml-apis.jar, xercesImpl.jar
Jar files used when exporting to XML.
lib\itext_1.5.4.jar
Jar file used when exporting to PDF.
lib\iTextAsian.jar
Jar file used for the Asian fonts.
lib\poiHSSF_151.jar
Jar file used when exporting to Excel.
SwingDesigner.jar
If RPTExecutor UDO has been inserted into a report, to view the correct result, this jar file should be
added to the class path that starts the Result Viewer Bean.
Readme.htm, License.htm
Release information.
help\designer\samples\TestResultBean.java
A sample program to demonstrate how to display the result.
Notes:
* means that these files are required when you call the Result Viewer Bean.
Other files without * should be added to your class path to call the Result Viewer Bean.
For example, when you use the Result Viewer Bean to export to mail, you should add mail.jar and
activation.jar with a valid path to your class path. When you use the Result Viewer Bean to export to
XML, you should add resource.jar with a valid path to your class path. When you use JReport Engine
Bean to export to Excel, you should add poiHSSF_151.jar with a valid path to your class path, and
when you use JReport Engine Bean to export to PDF, you should add itext_1.5.4.jar with a valid path
setReportName ("ReportName")
setTempPath("theTemporaryPath");
setShowInfoLevel (vDebug/vError/vOff)
setLogFile ("LogFileName")
setLoadReport ("Yes/No")
Parameters
ReportName - Specifies the name of the JReport result file that is to be viewed. It contains both the
path information and the file name.
Note: Here the report name is the result file name with an .rst extension (NOT the report file .
cls).
theTemporaryPath - The temporary file path. When the bean runs, the temporary files will be written
in this path. You should set the full path of the temporary files in this method as:
bean.setTempPath("c:\\temp");
If you do not set the temporary path, the default path is the directory from where the Bean will be
run.
vDebug/vError/vOff - These are used for showing and turning off debug and error information.
LogFileName specifies where the debug, error and other information will go. LogFileName contains
both the path and the file name. If no path or file is specified, the default will be used.
Yes/No - Indicates whether or not to start to view the result of the report (the file specified by
ReportName).
Preparations
An illustrative example
Preparations
Before programming with the Result Viewer Bean, you need to import the classes of the Result Viewer
Bean by adding the following import statements to the beginning of your program. The first import
statement is added to import the bean class:
import
import
import
import
jet.bean.*;
java.awt.*;
java.awt.event.*;
javax.swing.*;
With the JReport Result Viewer Bean object, you can show the report result and export it to other
formats or to printer. You do not need to create a bean for each report. The Result Viewer Bean
provides many useful methods.
Printing reports
Zooming reports
exportToHtml(string HTMLFileName)
exportToDhtml(string HTMLFileName)
exportToDhtml(string RSTFileName, string HTMLFileName, boolean bChartApplet, boolean
isMultiFile, boolean bUsingTable, boolean bHyperlink, boolean bPageNum, boolean bAbsolute, int
iBrowser, boolean bincdrilldownfile, boolean noMargin)
exportToDhtml(string HTMLFileName, boolean bChartApplet, boolean isMultiFile, boolean
bUsingTable, boolean bHyperlink, boolean bPageNum, boolean bAbsolute, int iBrowser, boolean
bincdrilldownfile, boolean noMargin, int resolution)
exportToDhtml(string HTMLFileName, boolean bChartApplet, boolean isMultiFile, boolean
bUsingTable, boolean bHyperlink, boolean bPageNum, boolean bAbsolute, int iBrowser)
exportToDhtml(string HTMLFileName, boolean bChartApplet, boolean isMultiFile, boolean
bUsingTable, boolean bHyperlink, boolean bPageNum, boolean bAbsolute, int iBrowser, boolean
bincdrilldownfile)
exportToDhtml(string HTMLFileName, boolean bChartApplet, boolean isMultiFile, boolean
bUsingTable, boolean bHyperlink, boolean bPageNum, boolean bAbsolute, int iBrowser, boolean
bincdrilldownfile, boolean noMargin)
Export to PDF
exportToPdf(string PDFFileName)
exportToXls(string XLSFileName)
exportToPS(string PSFileName)
exportToRtf(string RTFFileName)
Parameters
HTMLFileName - The name of the HTML format result file with a full path.
bChartApplet - A boolean value which specifies whether or not the chart in an HTML file is an applet.
The default value is true.
isMultiFile - A boolean value which specifies whether or not HTML is generated to a single file or to
multiple files. The default value is true.
bUsingTable - A boolean value which specifies whether or not to use HTML table format when
exporting HTML files. The default value is false.
bHyperLink - A boolean value which specifies whether or not a hyperlink is generated. The default
value is true.
bPageNum - A boolean value which specifies whether or not to generate page numbers. The default
value is true.
bAbsolute - A boolean value which specifies whether the font size is absolute or relative. The default
value is true.
iBrowser - An int value which specifies whether or not the web browser is IE. 0 means IE. The
default value is 0.
Drilldownfile - A boolean value which specifies whether or not to generate the drilldown HTML files in
the file list. The default value is false.
RSTFileName - The name of the result file (.rst extension) that is to be converted to the required
format.
PDFFileName - The name of the PDF format result file with a full path.
isSimPrintMode - A boolean value which specifies whether or not to use Simulated Printing Mode
(true) or Standard Mode (false) (To PDF). By checking the Standard Mode, the exporting speed will
be much improved. The default value is false.
isCompressImage - An int value which specifies the compression ratio of the image in a report (To
PDF). The values range from 1 to 100. The default value is 20.
isTransparent - A boolean value which specifies whether or not to keep the background of the GIF
image transparent.
TextFileName - The name of the Text format result file with a full path. true/false is to set whether
this text file is in normal Text format or standard Data format. The standard Data format text file is a
text file where each row represents a single record in the report. It can be used as a text datasource
for exchanging data with other applications.
isNormalText - A boolean value which specifies whether or not the text file is in normal text format.
When it is set to false, the output format is in standard data format. The default value is true.
isRepeat - A boolean value which specifies whether or not the same contents are repeated. The
default value is false.
delimiter - A character used in SDF (Standard Data Format) format. The delimiter will only be used
when the "isNormalText" parameter is set to false. The default delimiter is a blank space.
compress - A boolean value which specifies whether or not to remove empty lines or redundant
delimiters in the exported text file. The default value is false.
XLSFileName - The name of the Excel format report result file with a full path.
PSFileName - The name of the Postscript format result file with a full path.
RTFFileName - The name of the Rich Text Format file with a full path.
noMargin - A boolean value which specifies whether or not to generate a file without a page margin.
The default value is false.
chWidth - User defined char width used in plain text format. It would be ignored if the value is 0 or
less than 0. When exporting to Text, the default value is -1.
chHeight - User defined char height which is used in plain text format. It would be ignored if the
value is 0 or less than 0. When exporting to Text, the default value is -1.
XMLFileName - The XML file name.
isMultiFile - A boolean value which specifies whether XML is generated to a single file or to multiple
files.
isOnlyData - A boolean value which specifies whether or not only the database column information is
exported to an XML file. Otherwise, all the report details, including all the properties will be exported.
The default value is false.
parameter - A parameter contains some special settings for exporting to different file formats.
resolution - An int value which is used to specify resolution for different exported file formats.
password - A string value which is used to set the password when exporting to a PDF file that
contains a password.
bToc - A boolean value which specifies whether or not to generate TOC for the PDF file.
bDrill - A boolean value which specifies whether or not to apply drill-down function to the exported
PDF file.
quoteMark - A boolean value specifies whether or not quote characters will be kept in standard
format text file.
hasHeadfoot - A boolean value specifies whether or not page header and footer will be contained
when exporting to TEXT.
forWindows - A boolean value specifies whether the CR-LF in Windows convention or the LF in Unix
udchWidth - An int value which is specified for each unit of the horizontal density between columns.
udchHeight - An int value which is specified for each unit of the vertical density between columns.
KEEPORIGIN - Keeps all the original settings of each component's Word Wrap property as specified
in the report.
param - An int value specifies whether or not to include drawing objects in the exported Excel file. If
isBiff8 is set to true, drawing objects will not be included in the result file, because they cannot be
exported to Excel 2000 files.
XSDFile - A string value indicates the schema file on which the exported XML file is based. If it is set
to null, a new XSD file will be output.
Notes:
Printing reports
There are five methods provided for printing a report.
printReport()
printReport(Object printJob, Object pageFormat, boolean bInteractive, boolean bInBackground,
boolean bUseJDK11)
printReport(Object printJob, Object pageFormat, boolean bInteractive, boolean bInBackground,
boolean bUseJDK11, boolean bSeparateLargePage)
printReport(java.lang.Object job, boolean bInteractive, java.lang.Object pf, boolean bInBackground,
JReportPrintListener jreportprintlistener, int useJDK, java.lang.String jobName, java.util.Vector
attributeInfo, java.lang.String printer)
getPrintStatus()
Parameters
bInteractive - A Boolean value. If you set it to false, the Print Setup dialog will not be shown.
bInBackground - A Boolean value. If you set it to true, the Print dialog will not be shown.
bUseJDK11 - A Boolean value. If you set it to true, it will use JDK1.1.x to print the report. Otherwise
if you set it to false, it will use the JDK that you are running to print the report. The JDK 1.1 printing
method is quick in speed but the printing quality cannot be guaranteed. The JDK 1.2 method will
provide a satisfactory result, even for a .gif file, but it is slow in speed.
bSeparateLargePage - A Boolean value. If the report page size is larger than the print paper size,
and you want to separate a large report page during printing, you should set this property to true. If
the print page size you choose is less than the report page size, the report will be printed in multiple
pages serially. This means a large report will be separated automatically. For JDK1.2 or later, after
you have set this parameter to true, the Page Format dialog will be shown. In this dialog, you can
choose the page format in which you want to print. This page size will then be used for printing. For
JDK1.1.x, however, you must first change the page format in the Print dialog (click the Property
button, then choose the page format).
job - The print job of this print action. It is an instance of PrintJob or PrinterJob.
bUseJDK - An Integer value. If you set it to 0, it will use the method JDK1.1 to print the report. If
you set it to 1, it will use the method JDK1.2 to print the report. If you set it to 2, it will use the
method JDK1.4 to print the report. The JDK 1.1 printing method is quick in speed but the printing
quality cannot be guaranteed. However, the JDK 1.2 method will return you with a satisfactory
result, even for a gif file, but it is slow in speed. The method JDK1.4 provides further print options,
such as specifying the paper tray.
attributeInfo - A vector with String elements. Each string has been defined in interface PrintConfig
which is located in package jet.bean. For example, you can implement PrintConfig and call its fields
as shown below:
attributeInfo.add(TRAY_MANUAL);
attributeInfo.add(ORIENTATION_PORTRAIT).
Example 1
With JDK1.2 or later, if you use the JDK1.2 printing method (boolean bUseJDK11), you can call the
printReport method as shown below:
PrinterJob printJob=PrinterJob.getPrinterJob();
bean.printReport(printJob, printJob.defaultPage(), false, false, false);
Or, if you do not want to use getPrinterJob, you can simply call:
bean.printReport(null, null, false, false, false);
Example 2
With JDK1.2 or later, if you use the JDK1.1 printing method, you are best recommended not to use
getPrintJob, instead you can call:
bean.printReport(null, null, false, false, true);
Notes:
The first method printReport() is called to start printing. It will take the third method using default
parameter values such as:
printReport(null, null, true, false, false, false)
The second and third method allows you to pass the parameters - printJob, pageFormat,
bInteractive, bInbackground, bUseJDK11 and bSeparateLargePage.
The third printing method (with the bSeparateLargePage parameter) is not recommended. It may
cause some unexpected errors, for example, you may get an extra blank page.
After printing has started, the method getPrintStatus() can be used to get the print job status.
Returned values of getPrintStatus() are:
"No print job"
"Busy"
"OK"
"No report load"
Other error messages if there are errors.
The methods getCurrentPageNumber() and getTotalPageNumber() are used to return the current
page number and the total number of pages of the current report onto the screen.
The method int gotoPage(int pageNumber) is used to display the page specified by PageNumber on
the screen. If PageNumber is out of the range of the current report, the first page (if the
pageNumber is less than 0), or the last page will be shown on screen. The returned value is the
current page number.
The methods firstPage(), prevPage(), nextPage() and lastPage() are used to show the specified page
on the screen.
The return value of the above methods is a string, and can be:
"OK"
Zooming reports
If you want to zoom in or out of a report, there is a method named zoom(ratio) that will meet this
requirement.
Parameter
Example 1
If you want to enlarge the report by two times the original size, you can use the method in this way:
zoom(200)
Example 2
If you want to reduce the report size by half, you can use the method in this way:
zoom(50)
Reference: To see another example, see TestResultBean.java in <install_root>\help\designer
\samples.
If you have a class which wants to listen to the click event of a field, this class can implement this
interface. Then, after you have instantiated a bean, you can add the ClickActionListener.
Notes:
This action must be implemented before running the report. Finally after the report has been shown
and you click on a field, the ClickActionListener's method clickOnField will be called, and you will then
get the values of all columns in that field from the parameter currentRecord.
To see an example, see TestResultBean.java in <install_root>\help\designer\samples.
communicator - The Communicator here is a class defined by JReport. After users set the
communicator, the viewer will load the report from this communicator, not the result file.
You are recommended to use getReportCommunicator() in JReport Engine Bean, and use the method
setCommunicator() in JReport Result Viewer Bean. That is,
resultViewerBean.setCommunicator(engineBean.getReportCommunicator());
Parameters
Parameter
Return
An illustrative example
There is a sample program called TestResultBean.java in <install_root>\help\designer\samples included in the
JReport Result Bean package.
The properties for the report are very simple, and you will only need to set the ReportName. Note that here the report
name is the report result .rst file generated by JReport Engine (JReport Designer, JReport Engine Bean or JReport
Server). It is not a .cls file. By calling the runReport and show() methods, the report result will be displayed.
As with the JReport Engine Bean, the report result can be exported to other formats such as HTML, PDF, RTF or to a
printer. You will need to use the appropriate methods and parameters.
To run TestResultBean.java, you can use the following command to compile the sample program first (assume that
JReport Designer has been installed to C:\JReport\Designer):
C:\JReport\Designer\help\designer\samples>
javac -classpath "C:\JReport\Designer\lib\JRResultviewer.jar;
C:\JReport\Designer\lib\log4j-1.2.8.jar;C:\JReport\Designer\lib\itext_1.5.4.jar" TestResultBean.java
The following are some specific topics about JReport Catalog Bean:
lib\JREngine.jar*
Class library that contains the Catalog Bean.
lib\log4j-1.2.8.jar*
Jar file used for the JReport Engine logging system.
bin\jslc.dat*
License control file.
bin\report.ini*
Configuration file.
help\designer\samples\TestCatalogBean.java
The test tool of the Catalog Bean with a graphics user interface.
JReport Catalog Bean is combined with JReport Engine Bean and is stored in the same class library
called JREngine.jar. You will need to set the class path environment variable before you can compile
and run the program. Append the following string to the class path:
<install_root>/lib/JREngine.jar;<install_root>/lib/log4j-1.2.8.jar
JRCatalog class
The JReport Catalog is the principal class that manipulates and accesses a catalog. The application
creates a JReport Catalog instance, and uses JReport Catalog methods to manipulate the catalog.
JReport Catalog has two properties:
reportHome - The string that contains the installation path of JReport Catalog Bean.
catName - The string that contains the full file path of the catalog. This path is used when loading or
creating a catalog.
JRCatalogException class
JRCatalogException is the class that describes the error information. This exception is thrown when an
error occurs. This exception describes many kinds of errors. The error code in the exception represents
the exception type. The error code and error message can be viewed through public means.
ConnectionDesc class
ConnectionDesc is the class that describes the JDBC connection information. This class is used to
create/modify connections and get connection information.
Reference: JReport Designer Javadoc jet.bean.JRCatalog, jet.bean.JRCatalogException and jet.
universe.ConnectionDesc classes in <install_root>\help\designer\api, which includes all the
documents generated by Javadoc.
Preparations
An illustrative example
Preparations
Before programming with the Catalog Bean, you need to import the Catalog Bean classes by adding the
following import statements to the beginning of your program. The first two import statements are
added to import the Catalog Bean, and exception classes. The third is added to import the connection
description class.
import jet.bean.JRCatalog;
import jet.bean.JRCatalogException;
import jet.universe.ConnectionDesc;
Then you need to create an instance of the Catalog Bean. The constructor of the Catalog Bean has no
parameter. After the object has been created, you should then set the report home to the object.
JRCatalog jrCatalog = new JRCatalog();
jrCatalog.setReportHome("c:\\jreport") ;
With the Catalog Bean object, you can manipulate and access many catalogs. You do not need to
create a bean for each catalog.
You can load an existing catalog or create a new catalog. After a catalog has been created or loaded,
you can manipulate it before closing it. The closeCatalog method closes a catalog, releases resource
and clears up the temporary file. Also, the program requires using the closeCatalog method when
operations on it have been completed.
Creating a catalog
The method newCatalog creates an empty catalog according to the catalog name that is set in
catName, and saves it to disk.
When creating a new catalog, the directory of the catalog name should exist and contain no catalog
files. You should make sure of this before you start creating the new catalog.
Try
{
jrCatalog.setCatName("c:\\a.cat");
newCatalog();
}
catch(JRCatalogException e)
{
System.out.println(e);
}
Manipulating a catalog
A catalog can be manipulated by the actions of adding, deleting and editing of objects within it. A
catalog contains many kinds of objects. These objects include connections, tables, views, file queries,
stored procedures, queries, WHERE portions, formulas, summaries and parameters.
For example, you can modify the connection, the name, the URL, the user, the password and the driver.
try
{
ConnectionDesc conDesc=new ConnectionDesc();
conDesc.strName="Demo";
conDesc.strURL="jdbc:oracle:thin:@myhost:1521:orcl";
conDesc.strUser="system";
conDesc.strPassword="manager";
conDesc.strDriver="oracle.jdbc.driver.OracleDriver";
jrCatalog.modifyConnection(conDesc);
}
catch(JRCatalogException e)
{
System.out.println(e);
}
Getting information
You can get information about objects in a catalog via some methods.
For example, you can get the connection information via the method getConnectionDesc().
Try
{
ConnectionDesc conDesc = bean.getConnectionDesc();
}
catch(JRCatalogException e)
{
System.out.println(e);
}
Saving a catalog
Changes to a catalog are saved to a disk only when the method saveCatalog is used.
Try
{
jrCatalog.saveCatalog();
}
catch(JRCatalogException e)
{
System.out.println(e);
}
Handling exceptions
When an error occurs, the JRCatalogException is thrown out. Your program will catch the exception and
handle the error.
The exception describes the error code and detailed message as follows:
Code: 0
Message: "System initialize failed."
Description: The system initialization process failed. The Catalog Bean needs to be initialized to
resolve the environment. This error is caused by reasons such as wrong report home, and bad
installation.
Detail: The reason why the initialization failed.
Code: 1
Message: "The catalog name is null."
Description: The catalog name is null. The catalog name should be set before the loadReport() or
newReport() methods are used.
Detail: None.
Code: 2
Message: "Creating the catalog failed, because the specified directory does not exist or there is an
existing catalog in that directory."
Description: Cannot create a catalog in the specified directory, because the directory does not exist
or there is a catalog in the directory.
Detail: None
Code: 3
Message: "Cannot open the catalog file."
Description: Cannot open the specified catalog file. The reason is file not found, file corrupt, format
error or version mismatch.
Detail: The reason why the opening of a catalog file failed.
Code: 4
Message: "Save catalog failed."
Description: Cannot save the catalog file successfully. The cause is a file writing error, or a formula
file save has failed.
Detail: The reason why the saving of a catalog failed.
Code: 5
Message: "No catalog loaded."
Description: The loadCatalog() or newCatalog() methods should be used before other methods, and
closeCatalog() should be used in the end.
Detail: None
Code: 6
Message: "The name of the WHERE portion is invalid or already exists."
Description: The name specified is invalid or has already been used by another WHERE portion.
Detail: None
Code: 7
Message: "The specified WHERE portion does not exist."
Description: The specified WHERE portion does not exist.
Detail: None.
Code: 8
Message: "A catalog can contain only one connection."
Description: A catalog can contain only one connection, and this error occurs when adding a second
connection.
Detail: None.
Code: 9
Message: "The name of the connection is invalid or already exists."
Code: 10
Message: "Connection failure."
Description: The JDBC connection failed when trying to create a connection to the database.
Detail: The message of SQLException or ClassNotFoundException.
Code: 11
Message: "The name of the file query (customer SQL) is invalid or already exists."
Description: The name of file query is either invalid or already exists.
Detail: None.
Code: 12
Message: "Cannot create the file query."
Description: Cannot create file query object.
Detail: The reason why the file query cannot be created.
Code: 13
Message: "There is no connection in the catalog."
Description: There is no connection in the catalog. If you are deleting or modifying a connection, the
problem is that no such connection exists. If you are adding a file query, you cannot create it without
a connection.
Detail: None
Code: 14
Message: "The specified file query doesn't exist."
Description: The specified file query does not exist.
Detail: None.
Code: 15
Message: "Unknown Error."
Description: The unexpected error.
Detail: None
Code: 16
Message: "Invalid user ID or password"
Description: The user ID or password is invalid.
Detail: None
Code: 17
Message: "Only Tables or Views can be added into catalog."
Description: The table type users specified is not supported.
Detail: None
Code: 18
Message: "Close connection failure."
Description: When closing connection, an error occurred.
Detail: None
An illustrative example
In the following program, the Catalog Bean will be used to change the connection of a catalog:
try
{
// create catalog bean
JRCatalog jrCatalog = new JRCatalog();
// set report home
jrCatalog.setReportHome( "c:\\jrcbean");
// load catalog
jrCatalog.setCatName("c:\\a.cat">);
loadCatalog();
// modify connection
ConnectionDesc conDesc = new ConnectionDesc();
conDesc.strName = "Demo";
conDesc.strURL = "jdbc:oracle:thin:@myhost:1521:orcl";
conDesc.strUser = "System";
conDesc.strPassword = "Manager";
conDesc.strDriver = "oracle.jdbc.driver.OracleDriver";
jrCatalog.modifyConnection(conDesc);
// save catalog
jrCatalog.saveCatalog();
// close catalog
jrCatalog.closeCatalog();
}
catch(JRCatalogException e)
{
System.out.println(e);
}
Getting started
There are some special methods used for editing catalogs, queries, reports, and parameters. These
methods are included in the Designer API and Server Designer API. When invoking these methods in
the Server Designer API, you also have to provide an additional parameter: UID (used to distinguish
between different users, and can be a Number or a String). However, when invoking them in the
Designer API, you do not need to provide this parameter.
The Designer API can only edit one report at a time, while the Server Designer API allows concurrent
users to modify their reports.
JReport Designer API and JReport Server Designer API use an independent license from other JReport
products. You need to contact Jinfonet sales to obtain this special license key if you want to use either
JReport Designer API or JReport Server Designer API on your machine with JReport Designer or JReport
Server. The license will be applied to your program instead of being applied to the installation of
JReport Designer API or JReport Server Designer API.
The keys for JReport Designer API and JReport Server Designer API are different. For example, you
cannot use the JReport Designer API key on JReport Server Designer API, and vice versa.
If you want to use JReport Designer API or JReport Server Designer API package for workstations
without using JReport Designer and JReport Server, you will need to obtain a valid license for each
work station.
JREngine.jar
report.jar
sac.jar
hsqldb.jar
commons-codec-1.2.jar
log4j-1.2.8.jar (Jar file used for the JReport Engine logging system)
Note: The Designer API classes are stored in the archive files: report.jar and JREngine.jar. You will
need to take the following two steps before you can compile and run the program:
1. Set the class path environment variable. Append the following string to your class path that starts
the Designer API:
<designer_install_root>\lib\report.jar;<designer_install_root>\lib\JREngine.jar;
<designer_install_root>\lib\log4j-1.2.8.jar;<designer_install_root>\lib\sac.jar;
<designer_install_root>\commons-codec-1.2.jar;<designer_install_root>\hsqldb.jar
2. Set the -Dreporthome parameter to be the same as the root path of JReport Designer.
Getting started
To help you start using the Designer API, here is a simple example which shows how to use the JReport
Designer API package to compile and run a Java class that returns the connection information from a catalog file.
Assume that TestCatalogAPI.java in <install_root>\help\designer\samples has been run to generate a
catalog file Tutorial.cat in the directory <install_root>\Demo\Reports\APITutorial.
1. Compile the sample code TellMeConnection.java in <designer_install_root>\help\designer\samples.
javac -classpath <install_root>\lib\JREngine.jar;<install_root>\lib\sac.jar;<install_root>
\lib\report.jar TellMeConnection.java
2. Set the license key for Designer API using the method dr.setUserInfo("UID","XXXXXXXXXXX") in
TellMeConnection.java.
3. Run the sample code.
java -classpath ".;<install_root>\lib\JREngine.jar;<install_root>\lib\report.jar;
<install_root>\lib\sac.jar;<install_root>\lib\log4j-1.2.8.jar"
-Dreporthome=<install_root> TellMeConnection <catalog path> <catalog name>
For example,
java -classpath "c:\JReport\Designer\lib\JREngine.jar;c:\JReport\Designer\lib\report.jar;
c:\JReport\Designer\lib\sac.jar;c:\JReport\Designer\lib\log4j-1.2.8.jar;
C:\JReport\Designer\lib\hsqldb.jar"-Dreporthome=D:\JReport\Designer
TellMeConnection c:\JReport\Designer\Demo\Reports\APITutorial Tutorial.cat
Preparations
Illustrative examples
Preparations
Before you can use the Designer API to perform certain tasks, you need to first make the following preparations.
Every node and object in the above trees is identified by a HANDLE in JReport Designer API. Therefore, before you can create or edit a
report with the Designer API, you will first have to get the handle information. Super class API provides the following methods to get
handles of different nodes and different types.
getHandles()
Gets all the handles of a report and returns a handle array.
getHandles(String handle)
Gets handles of the sub node in the current node and returns a handle array. If it fails, it will return null.
getHandles(String handle, int type)
Gets sub node handles of the same types for the given node and returns a handle array. If it fails, it will return null.
getParent(String handle)
Gets the parent handle of an object and returns the parent handle. If it fails, it will return null.
Parameters
handle - Parent node handle when getting sub node handles. Object handle when getting parent handle.
depth - This is related to the current level in the report tree. When the depth is -1, all handles in the report will be got. When the depth is
0, the handles of the current level will be got. When the depth is number n, the handles of n levels and the current level will be got.
Moving objects
Concurrent control
Parameters
Notes:
The report should be created based on the existing catalog file, otherwise you will get an error.
The query should exist in the given catalog, otherwise you will get an error.
open(String name)
Opens an existing report set and returns the handle of the report set.
close(String handle)
Saves any changes and closes the open report in the current report set.
closeReportSet()
Saves any changes and closes the current report set.
quit(String handle)
Closes an open report without saving any changes.
Parameters
Parameters
The following methods are used for getting the property values of different types and return the
property value:
Parameters
Note: The getControlFields(String handle, String name) method is used for getting fields that can
control property values at runtime.
Parameters
The following methods are used for changing the property values of different types. They will return
true if the value is changed.
Parameters
Note: The setControlFields(String handle, String prop, String field) method is used for setting a field to
control the property value at runtime. The setReference(String handle, String name, String refHandle)
method is used for changing the reference property value of an object.
getDBFields(String handle)
Gets DBFields that can be used in the report and returns a mapping name array.
getControlFields(String handle, String name)
Gets fields that control property values at runtime.
getFormulae(String handle)
Gets formulas that can be used in the report and returns a mapping name array.
getSummaries(String handle)
Gets summaries that can be used in the report and returns a mapping name array.
getParameter()
Gets parameters in the catalog and returns a mapping name array.
getQueries()
Gets parameters in the catalog and returns a mapping name array.
getQueryName(String handle)
Gets the query name of a report.
getProcedures()
Gets procedures in the catalog and returns a mapping name array.
getSections(String handle, boolean visible), getSections(String handle)
Gets handles of sections in a report.
getGroups(String handle)
Gets handles of groups in a report.
public GroupInfo[] getGroupInfo(String handle)
Gets the group information in a report.
public ReportSortInfo getReportSortInfo(String handle)
Gets the sort information of a report.
public SortInfo[] getSortInfo(java.lang.String handle)
Gets the sort information of a group.
getSQLs()
Gets the SQLs in the catalog.
getUDS()
Gets the UDSs in the catalog.
getViews()
Gets the VIEWs in the catalog.
getObjectType(String handle)
Gets the type information of an object.
getObjectInfo(String handle)
visible - A Boolean type parameter which specifies that the section is visible.
getInstanceName(String handle)
Gets the instance name of an object, and returns the instance name. If it fails, it will return null.
getClassType(String handle)
Gets the class type of an object and returns one of the class type values that are defined in the
Designer class. If an error or a warning occurs, it will return UNKNOWN.
Parameter
Moving objects
The method public boolean changeZOrder(String objectHandle, int zorderType) is used to move an
object to front/back, or forward/backward.
Parameters
getWarning()
Gets and returns the warning message. If the operation is successful, it will return null.
clearWarning()
Clears the warning message.
getError()
Gets and returns the error message. If the operation is successful, it will return null.
clearError()
Clears the error message.
clearMsg()
Clears all warning and error messages.
setLog(OutputStream log, String encoding)
Sets the log to get error, debug and other information.
writeLog(String msg)
Writes all messages to the log.
closeLog() throws IOException
Closes the log.
exit()
Exits from the editing status, releases all the resources and saves all reports and the catalog.
quit()
Quits the editing status without saving and releases all resources. It will return false if it fails,
otherwise true.
Concurrent control
Most of the methods in JReport Designer API can also be used when programming with JReport Server
Designer API. There are however, some methods which are unique to JReport Server Designer API.
When programming with it, you should use these methods by using the parameters listed in
MultiUserCatalogAPI and MultiUserDesigner, which can be found in the Designer Javadoc stored in
<install_root>\help\designer\api. The methods can be named the same in JReport Designer API
and JReport Server Designer API. However, if the methods do not have a parameter UID, they cannot
be used in JReport Server Designer API.
Notes:
The number of concurrent reports and users will depend on your license.
A user does not mean a person but means a section. Concurrent users mean concurrent sections.
When using JReport Server Designer API, you must make sure that each user can only edit one
report and that each report can only be edited by one user at the same time.
For details about JReport Server Designer API special methods, see the JReport Designer Javadoc in
<install_root>\help\designer\api.
Illustrative examples
JReport provides you with some sample programs which demonstrate how to create and edit reports
using the Designer API in <insatll_root>\help\designer\samples. They are:
TestDesignInvoice.java
An example of designing a report with an invoice.
TestDesignEditInvoice.java
An example of how to change the image in the report invoice1.
TestDesignGraph.java
An example of designing a report with a chart.
TestDesignCrosstab.java
An example of designing a report with a crosstab.
TestDesignSubreport.java
An example of designing a report with a subreport.
TestMutiUserDesign.java
An example of creating four reports at the same time.
The following are three specific examples of using the Designer API:
Example 1: TestDesignInvoice.java
Example 2: TestMutiUserDesign.java
Example 3: TestDesignEditInvoice.java
Example 1: TestDesignInvoice.java
TestDesignInvoice.java is primarily designed for creating a report with the methods provided by the
Designer API. Here is an explanation of how TestDesignInvoice.java works.
Getting handles
handles = desg.getHandles(report, Designer.PAGE);
This method gets all handles of PAGE type and returns a handle array. Parameter report is the parent
handle, and Designer.PAGE is a class type value which is defined in the Designer class.
Creating a report
report = desg.create(name, "invoice");
This method creates a new report and returns its handle. Parameter name is the name of the report
that is to be created, and Invoice is the name of the query in the catalog file SampleReports.cat with
which the report is created.
Inserting a label
handle = desg.insert(header, Designer.LABEL, "Label1");
This method inserts a label named label1 into the group header. Parameter header is the parent
handle, the newly inserted object will be in this node. desg.LABEL is the class type that you want to
insert, and Label1 is the object name to be inserted.
Inserting DBField
handle = desg.insert(header, Designer.DBFIELD, "DBField1", "Orders_Order ID");
This method inserts a DBField named DBField1 into the group header. Parameter header is handle of
the parent node; Designer.DBFIELD is class type that is to be inserted, and Orders_Orders ID is the
mapping name of the database field.
For example, in the sample program, it is made sure that the parameter PToday, formula
customeraddress12, and summary Sum_total9 already exist in the catalog by the following:
handle = desg.insert(header, Designer.PARAMETER, "Parameter1", "PToday");
handle = desg.insert(header, Designer.FORMULA, "formula1", "customeraddress12");
handle = desg.insert(footer, Designer.SUMMARY, "summary1", "Sum_total9");
"Width", 1.74f);
"Height", 0.35f);
"Text", "Invoice");
"Alignment", desg.LEFTCENTER);
"Foreground", new Color(0x900000));
"Bold", true);
"FontSize", 0.31f);
When you run the sample program, you should provide two or three parameters. If you want to use
two parameters, they should be catalog path and catalog name, and the command line should be:
C:\JReport\Designer\help\designer\samples>java
-Dreporthome="C:\JReport\Designer"
-classpath "C:\JReport\Designer\lib\jrengine.jar;C:\JReport\Designer\lib\sac.jar;
C:\JReport\Designer\lib\resource.jar;C:\JReport\Designer\lib\report.jar;
C:\JReport\Designer\lib\log4j-1.2.8.jar;C:\JReport\Designer\lib\hsqldb.jar"
TestDesignInvoice C:\JReport\Designer\Demo\Reports\APITutorial Tutorial.cat
If you want to use three parameters, they should be catalog path, catalog name and log file with a
full path name, and the command line should be:
C:\JReport\Designer\help\designer\samples>java -Dreporthome="C:\JReport\Designer"
-classpath "C:\JReport\Designer\lib\JREngine.jar;C:\JReport\Designer\lib\sac.jar;
C:\JReport\Designer\lib\resource.jar;C:\JReport\Designer\lib\report.jar;
C:\JReport\Designer\lib\log4j-1.2.8.jar;C:\JReport\Designer\lib\hsqldb.jar"
TestDesignInvoice C:\JReport\Designer\Demo\Reports\APITutorial Tutorial.cat
C:\test\log.txt
Here, it is assumed that JReport Designer has been installed to C:\JReport\Designer, and the
current directory when you execute these commands is C:\JReport\Designer\help\designer
\samples (location of the sample programs). After running the program, you will find a newly
created file invoice1.cls in C:\JReport\Designer\Demo\Reports\APITurorial.
Example 2: TestMutiUserDesign.java
TestMutiUserDesign.java is primarily designed for creating four reports at the same time using the
methods provided by the Designer API.
Before using the sample program to create reports, it is assumed that TestCatalogAPI.java in C:\JReport
\Designer\help\designer\samples has been run to generate a catalog file Tutorial.cat in C:\JReport
\Designer\Demo\Reports\APITutorial.
With this sample program, three reports are created:
Getting handles
handles = desg.getHandles(report, Designer.PAGE);
This method gets all handles of PAGE type and returns a handle array. Parameter report is the parent
handle, and Designer.PAGE is the class type value defined in the Designer class.
Example 3: TestDesignEditInvoice.java
TestDesignEditInvoice.java shows how to modify a report using the methods of the Designer API. It
demonstrates how to change the image in the report invoice1.
Here is an explanation of how TestDesignEditInvoice.java works with the methods provided by the
Designer API.
Creating an instance
desg = new Designer(path, cat);
The constructor of Designer has two parameters: path and name. They are respectively path and
name of the catalog with which the report will be created.
Setting log
desg.setLog(new FileOutputStream(log), "8859_1");
The output stream log points the path and file in which to write log messages. Parameter "8859_1" is
the encoding for the messages.
Getting handles
handle = desg.getHandles(report, Designer.IMAGE)[0];
This allows the handle of the object to be modified.
C:\JReport\Designer\help\designer\samples>javac
-classpath C:\JReport\Designer\lib\report.jar;C:\JReport\Designer\lib\sac.jar;
C:\JReport\Designer\lib\JREngine.jar;
TestDesignEditInvoice.java
When you run the sample programs, you should provide two or three parameters. If you want to use
two parameters, they should be catalog path and catalog name. The command line should be:
C:\JReport\Designer\help\designer\samples>java -Dreporthome="C:\JReport\Designer"
-classpath "C:\JReport\Designer\lib\jrengine.jar;C:\JReport\Designer\lib\sac.jar;
C:\JReport\Designer\lib\report.jar;
C:\JReport\Designer\lib\log4j-1.2.8.jar;C:\JReport\Designer\lib\hsqldb.jar;"
TestDesignEditInvoice C:\JReport\Designer\Demo\Reports\APITutorial Tutorial.cat
If you want to use three parameters, they should be catalog path, catalog name and log file with a
full path name. The command line should be:
C:\JReport\Designer\help\designer\samples>java -Dreporthome="C:\JReport\Designer"
-classpath "C:\JReport\Designer\lib\jrengine.jar;C:\JReport\Designer\lib\sac.jar;
C:\JReport\Designer\lib\report.jar;
C:\JReport\Designer\lib\log4j-1.2.8.jar;C:\JReport\Designer\lib\hsqldb.jar;"
TestDesignEditInvoice C:\JReport\Designer\Demo\Reports\APITutorial Tutorial.cat
C:\test\log.txt
Here, it is assumed that JReport Designer has been installed to C:\JReport\Designer, and that the
directory that is current when you execute these commands is C:\JReport\Designer\help\designer
\samples (location of the sample programs). After running the program, you will find a modified file
invoice1.cls in C:\JReport\Designer\Demo\Reports\APITutorial.
Create a connection.
Add and delete objects such as tables, queries, formulas, parameters, and WHERE portions.
The combination of the Catalog API and the Designer API provides you with a Java development
environment that enables you to create any report to meet your requirements.
Pick a task from the following for details about how to use the Catalog API:
report.jar
JREngine.jar
sac.jar (Jar file used for installing Catalog API with Designer API product)
...
The Catalog API class is stored in the archive file report.jar. You will need to do the two steps below
before you can compile and run the program:
1. Set the class path environment variable. Append the following string to your class path that starts
the Catalog API:
<install_root>\lib\report.jar;<install_root>\lib\sac.jar;<install_root>\lib
\JREngine.jar;<install_root>\lib\log4j-1.2.8.jar
2. Set the Dreporthome parameter equal to the root path of JReport Designer.
Preparations
An illustrative example
Preparations
Before you can use the Catalog API to perform certain task, you will have to create a Designer object
and then get a Catalog API instance.
Creating a connection
Inserting an object
Inserting a table/view
Inserting a UDS
Inserting a query
Deleting an object
Modifying a query
Saving a catalog
Creating a connection
The following methods are used to insert a database connection and return the handle of the newly
inserted connection. If not successful, a null value is returned:
insert(boolean bUseJDBCODBCBridge, String name, String desc, String url, String driver)
insert(boolean bUseJDBCODBCBridge, String name, String desc, String url, String driver,
ConnectionInfo info)
insert(String dataSourceName, boolean bUseJDBCODBCBridge, String name, String desc, String url,
String driver)
insert(String dataSourceName, boolean bUseJDBCODBCBridge, String name, String desc, String url,
String driver, ConnectionInfo info)
Parameters
Note: The class ConnectionInfo is used to create the connection information. For details, refer to the
JReport Designer Javadoc jet.api package in <install_root>\help\designer\api, which includes all
documents generated by Javadoc.
Inserting an object
The following methods are used to insert an object into a catalog and to return the handle of the newly
inserted object:
Parameters
Inserting a table/view
The following methods are used to insert a table or view into a catalog and to return the handle of the
newly inserted object:
Parameters
insert(String procName, String catalog, String schema, String name, String remarks, int iType)
Parameters
Parameters
Inserting a UDS
The following methods are used to insert a user defined data source and to return the handle of the
newly inserted UDS:
Parameters
Inserting a query
The following methods are used to insert a query into a catalog and to return the handle of the newly
inserted query:
Parameters
Reference: For details about the classes QueryFieldInfo, QueryJoinInfo, QueryQBEInfo and
QueryAndInfo, refer to the JReport Designer Javadoc jet.api package in <install_root>\help
\designer\api, which includes all the documents generated by Javadoc.
Parameters
handle - The handle of the specified object, which is obtained from the method for inserting an
object.
info - The object information. For a summary, it includes the summary name, description, function
type, the field name calculated on and the field name grouped by. For a formula, it includes the
formula name, description and expression. For a parameter, it includes the parameter name,
description, prompt information, the parameter data type and the default value.
The following methods can also be used to insert a formula, summary, parameter or a WHERE portion,
but they are now deprecated.
Parameters
Deleting an object
The method delete(Stringhandle) is used to delete an object from its parent node and to return true if
the specified object is removed.
Parameter
Modifying a query
You can perform the following manipulations when modifying a query.
Note: The tables that are to be added should exist in the specified catalog.
Parameters
selectAllFields - Specifies whether or not to insert a table with all its fields.
Parameters
Parameters
tableFrom - The name of the table from which the join links.
columFrom - The name of the column from which the join links.
Parameters
tablename - The name of the table where the QBE condition will be added or deleted.
columnname - The name of the column where the QBE condition will be added or deleted.
Parameters
sLogic - The logic string of the where condition that is to be inserted or deleted.
sExpression1 - The first expression of the where condition that is to be inserted or deleted.
sExpression2 - The second expression of the where condition that is to be inserted or deleted.
getTables(String dataSourceName)
Gets tables and views in a connection and returns the mapping name array.
getTables(boolean bIncludeSystemTable)
Gets tables and views in a data source and returns the name array.
getProcedureNames(String dataSourceName)
Gets all the stored procedures in a catalog and to return the mapping name array.
Getting SQLs
getSQLs(String dataSourceName)
Gets all the SQL files in a catalog and to return the mapping name array.
Getting UDSs
getUDSs(String dataSourceName)
Gets all the UDSs in a catalog and to return the mapping name array.
Getting queries
getQueries(String dataSourceName)
Gets queries in a catalog and returns the mapping name array.
getNewQueryName()
Gets a default name for a new query, which must be unique. The name for the first query in a
catalog is query1. The following query is query2, then query3 etc.
Getting columns
Parameters
Getting fields
Parameters
DSName - The data source object name, such as Query, SQL, UDS, and Procedure.
getFormulae(String dataSourceName)
Gets formulae that can be used in a catalog and returns the mapping name array.
getFormulaeCanBeGroupedBy(String dataSourceName, String queryName, String groupBy)
Gets formulae that are valid to a query and returns the formula names.
getSummaries(String dataSourceName)
Gets summaries that can be used in a catalog and returns the mapping name array.
getSummaryCanBeSortedBy(String dataSourceName, String queryName, String groupBy)
Gets summaries that can be sorted by.
getParameter(String dataSourceName)
Gets parameters in a catalog and returns the mapping name array.
getParameterCanBeGroupedBy(String dataSourceName)
Gets parameters that can be grouped by.
Parameters
Getting joins
Parameter
Parameter
getNewReportName()
Gets a default name for a new report, which must be unique. The name for the first report in a
catalog is report1, after which the following reports will be named report2, report3 etc.
Saving a catalog
The following methods are used to save catalogs:
save()
Saves an open catalog and returns a Boolean value: false if it fails, otherwise true.
saveAs(String path, String name)
Saves an open catalog as a new catalog file. You can save the catalog as a binary catalog using the
extension .cat, or an XML format catalog using the extension .cat.xml.
An illustrative example
You are provided with a sample program that demonstrates how to use the Catalog API to create or modify a
catalog - TestCatalogAPI.java that is located in <install_root>\help\designer\samples.
Here, TestCatalogAPI.java has been used as an example to explain how the methods work in the Catalog API.
dr.setUserInfo("UID","XXXXXXXXXXX")
Reminds you to set the license key for Designer API.
Getting a CatalogAPI instance
CatalogAPI cat = dr.getCatalogAPI();
Creating a connection
ConnectionHandles = cat.insert(true,"jinfonet","Accessdbase","jinfonet",null);
Inserting objects into a catalog
For example, insert a table named Customer:
tablehandles = cat.insert(null,null,"Customer",cat.TABLE);
C:\JReport\Designer\help\designer\samples>java
-classpath "C:\JReport\Designer\lib\jrengine.jar;C:\JReport\Designer\lib\sac.jar;
C:\JReport\Designer\lib\report.jar;C:\JReport\Designer\lib\log4j-1.2.8.jar;
C:\JReport\Designer\help;C:\test\classes"
-Dreporthome=C:\JReport\Designer
TestCatalogAPI C:\JReport\Designer\Demo\Reports\APITutorial
APITutorial C:\temp\api.log
Notes:
The PARAMETER here is the parameter string given to the UDS interface. That is, the UDS API
provides a function getResultSet (String strParam), and PARAMETER is string strParam in this
function. The following topics about UDS API will help make this information more clear. As a
reminder, PARAMETER here is different from the parameter object in the JReport catalog. To
distinguish between them, we have used an upper case PARAMETER to refer to the parameter string
in the UDS, and a lower case parameter for the parameter object in a catalog.
To design a report, JReport requires a meta data (see java.sql.ResultSetMetaData) which
corresponds to the ResultSet that the data source has returned. To view or run a report, JReport
requires a ResultSet object. The user data source must provide both of these two parts for JReport.
Go through the following topics for details about the USD API:
PARAMETER: strParam - A String value used to request and get different result sets. The format of
the PARAMETER string is defined and parsed by yourself. You can enter the PARAMETER string when
you add the UDS to a catalog. If you want to use parameters predefined in the Catalog Browser, you
can add @paraName into the PARAMETER string.
Keep in mind the parsing rules for the PARAMETER string when you enter the PARAMETER string.
The characters used for parameter name can be any character defined on the key board, except for
quotation marks.
Parameter name is introduced with @, and sometimes colon : is also recognized as an introducer.
When your PARAMETER string contains characters such as @, "", : or other strings which do not
need to be parsed by JReport, you should then quote the whole string with quotation marks, so
that they are not parsed as the beginning mark of the parameter name. For example, jdbc:
oracle:thin:@204.177.148.30:1521:orcl. Here, '@' is a character used by the URL. If you add
this PARAMETER string, '204' will be considered as the name of a parameter in a catalog. Thus, the
correct form is: jdbc:oracle:thin:"@"204.177.148.30:1521:orcl.
Returns: java.sql.ResultSet - A row and column dataset that can be used in JReport.
Throws: JRUserDataSourceException - If there are some errors when freeing the resource.
java.sql.ResultSet
java.sql.ResultSetMetaData
Note: The method ResultSetMetaData getMetaData() throws SQLException is only invoked when the
Specify Columns option is not checked in the Add User Defined Data Source dialog.
When there is no JDBC driver available for an external data source (for example, a comma-delimited
text file), you can create a ResultSet object to return the data to the requesting report. See Example
1: Developing reports from flat file UDS.
You can return a ResultSet through the JDBC API. See Example 2: Developing reports from SQL data
source UDS.
Oracle stored procedure UDS. See Oracle stored procedure UDS.
Notes:
The PARAMETER here is the parameter string given to the HDS interface. That is, the HDS API
provides a method getResultSet (String strParam), and PARAMETER is string strParam in the above
method. After reading the subsequent information on HDS API, this information will become clearer
to you. As a note, we would like to remind you that PARAMETER here is different from that in a
JReport catalog. To distinguish between them, we have used an upper case PARAMETER to refer to
the parameter string in the HDS, and a lower case parameter for a parameter object in a catalog.
To design a report, JReport requires meta data (See java.sql.ResultSetMetaData) which corresponds
with the ResultSet that the data source has returned. To view or run a report, JReport requires a
ResultSet object. The hierarchical data source must provide both of these two parts to JReport.
Go through the following topics for details about the HDS API:
jet.datasource.JRHierarchicalDataSource
jet.datasource.JRHierarchicalDataset
jet.datasource.JRHierarchicalDatasetMetaData
jet.datasource.JRHierarchicalDataSource
Provides data to JReport for generating reports. The JRHierarchicalDataSource class is developed by users of
JReport, and can provide data from a flat file, non-relational database, or application data. The data returned
by this class is in JRHierarchicalDataset object, so that users are required to create a JRHierarchicalDataset
instance for JReport to use this instance to fetch data. Users can also create their own JRHierarchicalDataset
class.
The following are methods provided by the interface.
public JRHierarchicalDataset getHierarchicalDataset (String param) throws
JRUserDataSourceException
This method gets the data in JRHierarchicalDataset according to the parameters set.
PARAMETER: param - A String value used to request and get different result sets. The format of the
PARAMETER string is defined and also parsed by yourself.
jet.datasource.JRHierarchicalDataset
Provides data to JReport for generating reports. The JRHierarchicalDataset class is developed by users of
JReport, and can provide data from a flat file, non-relational database, or application data.
The following are methods provided by the interface.
public interface JRHierarchicalDataset
{
/**
* Retrieves the number, types and properties of this object's leaves
*/
public JRHierarchicalDatasetMetaData getMetaData();
/**
* Moves the cursor down one row from its current position in the current node.
* return true if the new current row is valid; false if there are no more rows
* in the current node.
*/
public boolean next(String branchName);
/**
* Gets the value of the designated leaf node in the current branch node row as a boolean
* in the Java programming language.
*/
public boolean getBoolean(int leafIndex);
/**
* Gets the value of the designated leaf in the current branch node row as a byte
* in the Java programming language.
*/
public byte getByte(int leafIndex);
/**
* Returns the value of the designated leaf in the current branch node row as a short
* in the Java programming language.
*/
public short getShort(int leafIndex);
/**
* Returns the value of the designated leaf in the current branch node row as an int
* in the Java programming language.
*/
public int getInt(int leafIndex);
/**
* Returns the value of the designated leaf in the current branch node row as a long
* in the Java programming language.
*/
public long getLong(int leafIndex);
/**
* Returns the value of the designated leaf in the current branch node row
* in the Java programming language.
*/
public float getFloat(int leafIndex);
/**
* Returns the value of the designated leaf in the current branch node row
* in the Java programming language.
*/
public double getDouble(int leafIndex);
/**
* Gets the value of the designated leaf in the current branch node row as
* java.math.BigDecimal with full precision.
*/
public java.math.BigDecimal getBigDecimal(int leafIndex);
/**
* Returns the value of the designated leaf in the current branch node row
* java.sql.Date object
* in the Java programming language.
*/
public java.sql.Date getDate(int leafIndex);
/**
* Returns the value of the designated leaf in the current branch node row
* java.sql.Time object
* in the Java programming language.
*/
public java.sql.Time getTime(int leafIndex);
/**
* Returns the value of the designated leaf in the current branch node row
* a java.sql.Timestamp object
* in the Java programming language.
*/
public java.sql.Timestamp getTimestamp(int leafIndex);
/**
* Returns the value of the designated leaf in the current branch node row
* in the Java programming language.
*/
public String getString(int leafIndex);
/**
* Returns the value of the designated leaf in the current branch node row
* in the Java programming language.
*/
public java.sql.Array getArray(int leafIndex);
/**
* Reports whether the last leaf read had a value of SQL NULL
*/
public boolean wasNull(int leafIndex);
/**
* Releases this object's resource.
*/
public void close();
}
as a float
as a double
as a
as a
as
as a String
as an Array object
jet.datasource.JRHierarchicalDatasetMetaData
Provides meta data for JRHierarchicalDataset. The JRHierarchicalDatasetMetaData class is developed by users
You can import an XML format hierarchical data source directly from an external data source to
JReport Designer using the JReport built-in classes. See Example 2: Importing an HDS from an XML
file to a catalog.
You can also develop your own classes to implement the HDS APIs, and then import your customized
hierarchical data source. See Example 1: Adding a general HDS to a catalog.
Jet.report.JRObjectTemplate
This is an object provided by the JReport system, and is used to derive a UDO. The JRObjectTemplate
contains several predefined properties of the standard JReport Object used to compose a report,
including: X, Y, Height and Width. You can add more properties (supported by JReport system) to
your own UDO. These properties can be viewed and modified by the Report Inspector at design time.
Note: Only JReport system properties or properties inherited from them can be added, such as
JetNumber, JetColor, JetString, and JetEnumeration. See the jet.controls package.
jet.datastream.JRVisiableResult
This is another object provided by the JReport system. You will need to define an object inherited
from this object, so that you can specify the methods for saving and restoring the UDO object.
JRVisiableResult provides methods for saving and restoring UDOs.
jet.datastream.JRObjectResult
If the UDO you define is not used for displaying, that is, it will not appear inside the report result on
the screen or on paper, then it can be inherited from the JRObjectResult object.
jet.udo.JRObjectResultCreator
This is an interface. It takes JReport system's JReport Record as input parameters and produces the
UDO's JRObjectResult. A definition of the JReport Record is in the jet.connect package.
jet.udo.JRObjectRender
This is another interface. It provides a method used for painting the UDO to the report. The report
can then be shown on the screen or printed on a printer.
jet.udo.JRObjectEditor
This is an optional interface. If specified, the JReport system will use it to handle interactive events
(key events, mouse events, paint etc.) at design time. If this interface is not implemented, the
JReport system will use the default one.
jet.udo.JRGroupListener
This interface is used when you define a UDO with a value which is calculated based on a group of
data.
6. Compile the Java files, add the classes to the class path of JReport Designer and run it.
Note: If you want to use class files for the UDO which have been used in previous versions,
you should re-compile the source files.
Following are two specific examples about creating UDOs:
Example 1: Accessing a record for a UDO and registering the UDO with the report system
Example 1: Accessing a record for a UDO and registering the UDO with the report system
This example describes how to access a record for your UDO and how to register your UDO with the report
system.
1. A UDO needs to implement at least four classes from JReport. The four classes are for template, result,
creator and render files respectively.
MyDbFld.java
//Template
package myudo;
import jet.report.*;
import jet.controls.*;
/**
* This class extends form JRObjectTemplate, add two properties "ColumnName" and
* "TextColor".
*/
public class MyDbFld extends JRObjectTemplate {
/**
* This property is for the column name of MyDbFld.
*/
public JetColumnName columnName = new JetColumnName(this, "ColumnName");
/**
* This property is for the background color of MyDbFld..
*/
public JetColor backColor = new JetColor(this, "TextColor", null, true);
public MyDbFld() {
super();
columnName.setEditable(true);
// set the default size.
set("Width", 40); // before build575 should be width.set(40);
set("Height", 20); // before build575 should be height.set(20);
// add the property to group then they can displayed in ReportInspector.
addPropertyToGroup("ColumnName", "Others");
addPropertyToGroup("TextColor", "Color");
}
/**
* Return the instance name prefix. >
*/
public String getPrefix() {
return "MyDbField";
}
}
MyDbFldRst.java
//Result
package myudo;
import
import
import
import
jet.connect.Record;
jet.connect.DbValue;
jet.util.*;
jet.datastream.*;
MyDbFldCreator.java
//Creator
package myudo;
import
import
import
import
import
import
import
import
import
java.awt.*;
java.util.*;
jet.report.*;
jet.controls.*;
jet.connect.*;
jet.udo.*;
jet.datastream.*;
guitools.Painter;
jet.util.*;
/**
* Implements JRObjectResultCreator for creating JRObjectResult in JReport
* Engine Bean.
*/
public class MyDbFldCreator implements JRObjectResultCreator {
public MyDbFldCreator() {
}
MyDbFldRender.java
//Render
package myudo;
import
import
import
import
import
import
import
java.awt.*;
java.awt.event.*;
java.util.*;
jet.datastream.*;
jet.connect.DbValue;
jet.connect.Record;
jet.udo.*;
}
}
Note: Since the compiling process of JReport Designer differs with that of JReport Server, when you
run UDOs in these two applications, you should pay attention to some minor differences. For
example, to get width and height, in JReport Designer, you should use:
w = guitools.toolkit.Unit.convertUnitToPixel(((Integer)propertySetable.
getPropertyByName ("Width").getObject()).intValue());
h = guitools.toolkit.Unit.convertUnitToPixel(((Integer)propertySetable.
getPropertyByName ("Height").getObject()).intValue());
While in JReport Server, you should use the following instead:
JRObjectResult obj = (JRObjectResult)propertySetable;
w = guitools.toolkit.Unit.convertUnitToPixel(obj.getTemplate().getWidth(obj));
h = guitools.toolkit.Unit.convertUnitToPixel(obj.getTemplate().getHeight(obj));
2. Compile the Java files.
To compile these four Java files, you should add report.jar and JREngine.jar with their path into the class
path. For example, use the following command:
Javac -classpath "C:\JReport\Designer\lib\JRengine.jar;C:\JReport\Designer\lib\report.jar;C:
\test "MyDbFld.java
Here it is assumed that JReport Designer is installed to C:\JReport\Designer. The Java files for the
example are in C:\test\myudo.
3. Modify the udo.ini file in the <install_root>\lib directory by appending the four classes as follows:
Begin
name=MyDbField
template=myudo.MyDbFld
resultobject=myudo.MyDbFldRst
resultcreator=myudo.MyDbFldCreator
resultviewer=myudo.MyDbFldRender
End
4. Edit setenv.bat in <install_root>\bin by appending the path of the four classes to the batch file's
ADDCLASSPATH variable. Assume that the four classes are located in D:\test\myudo.
set ADDCLASSPATH=%JAVAHOME%\lib\tools.jar;D:\test;
5. Start JReport Designer.
6. Click Insert > UDO. You will now find a new UDO object named MyDbFld in the drop-down list of the Insert
UDO dialog.
MySumFld.java
//Template
package myudo;
import jet.report.*;
import jet.controls.*;
/**
* This class extends from JRObjectTemplate, add two properties "ColumnName" and
* "TextColor".
*/
public class MySumFld extends MyDbFld {
public MySumFld() {
super();
}
/**
* Return the instance name prefix.
*/
public String getPrefix() {
return "MySumField";
}
public boolean isGroupListener() {
return true;
}
}
MySumFldRst.java
//Result
package myudo;
import
import
import
import
import
import
jet.JRStopEngineException;
jet.connect.Record;
jet.connect.DbValue;
jet.util.*;
jet.datastream.*;
java.io.*;
MySumFldCreator.java
//Creator
package myudo;
import
import
import
import
import
import
import
import
import
java.awt.*;
java.util.*;
jet.report.*;
jet.controls.*;
jet.connect.*;
jet.udo.*;
jet.datastream.*;
guitools.Painter;
jet.util.*;
/**
* * Implements JRObjectResultCreator for creating JRObjectResult in JReport *
* Engine Bean.
*/
public class MySumFldCreator implements JRObjectResultCreator, JRGroupListener {
// This interface must implement by JRObjectCreator.
MySumFld rpt;
MySumFldRst dsField;
double value;
public MySumFldCreator() {
}
public void setTemplate(JRObjectTemplate rptobj) {
rpt = (MySumFld) rptobj;
}
public JRObjectResult createJRObjectResult(JRObjectTemplate rptobj,
Record record) {
rpt = (MySumFld) rptobj;
MySumFldRst dsField = new MySumFldRst();
dsField.setTemplate(rpt);
dsField.value = value;
return dsField;
}
/** * This method will be called before the first record. */
public void prepareFetchRecords() {
value = 0.0;
}
/** * This method will be called after the last record. */
public void finishFetchRecords() {
}
/** * This method will be called each record. */
public void fetchNewRecord(Record record) {
String colName = (String) rpt.getPropertyByName("ColumnName")
.getObject();
4. Edit setenv.bat in <install_root>\bin by appending the path of the four classes to the batch
file's ADDCLASSPATH variable. Assume that the four classes are located in D:\test\myudo.
set ADDCLASSPATH=%JAVAHOME%\lib\tools.jar;D:\test;
5. Start JReport Designer.
6. Click Insert > UDO. You will now find a new UDO object named MySumFld in the drop-down list
of the Insert UDO dialog.
Click Insert > UDO on the menu bar (or the Insert UDO button
Drag UDO from the Toolbox panel to the destination where you want to insert the UDO.
3. In the Insert UDO dialog, select a UDO as required from the UDO drop-down. The list contains all
UDOs that have been registered in the file setenv.bat in <install_root>\bin
4. Click OK in the dialog.
If you use menu or toolbar command to insert the UDO, click the mouse button in the desired
location to insert the UDO there.
If you take the dragging and dropping method to insert the UDO, the UDO will be inserted there
upon clicking the OK button.
After a UDO has been inserted, you can then customize its appearance and behavior by setting
properties in the Report Inspector, which can be saved as a CSS style for future use (for details, see
Creating a CSS style).
See also Properties - UDO for details about the properties of JHyperLink and JRotator in the Report
Inspector.
URL: http://www.jinfonet.com
in the detail reports on JReport Server. For how to use JHyperLink to link reports as master/detail reports,
JReport Designer provides an example for your better understanding.
All the needed materials for this example, including the report sets and catalog are compressed in the file
JHyperlink_Master-detail.zip in <install_root>\help\designer\samples. Extract JHyperlink_Master-detail.
zip to <install_root>\help\UDODemo, and do the following steps:
1. In JReport Designer, open the catalog for this example, Demo.cat.
2. Select one of the existing report sets and ensure the report sets in this catalog can run. If there is a
problem, open the Catalog Browser, highlight the connection node, and in the Properties sheet, modify
the value of the URL to connect to the demo database, it is jdbc:hsqldb:<install_root>\help\UDODemo
\db\demo.
Linking the master report to the detail report
Formulas will be used to control the property values URL and Display Value of JHyperLink to make it link the
master and detail reports.
1. Open the report set that contains the master report - mainreport.cls.
A JHyperLink is inserted in the Detail panel of the report. The URL and Display Value property values of
the UDO are as follows:
This URL value enables you to drill down to the detail report and also make a link for this detail report
on the top of the page for you to drill up and down.
Display Value: Determined by the DBField EmployeeName to show the Employee Name in the master
report.
2. Open the report set that contains the detail report SalesPerformancebyYear.cls.
In the GroupHeader panel, the value of Total is a JHyperLink, whose property values URL and Display
Value are both controlled by formulas.
Where, the URL is used to access the detail report SalesYearPerformancebyQuarter.cls, and the records
of the detail report are filtered by the parameters pEmployeeID and pYear.
4. Click any name in the Employee Name column, and the year's performance of the employee will be
displayed.
5. Click the Total number, and it will drill down to the next detail report.
Note: When using JHyperLink to link reports as master and detail reports, if a parameter with its value
containing special characters such as "\" and "&" is used in the URL, you need to add "\" before the special
character. For example, if the parameter value is a&b, you need to enter it as a\&b.
Properties
Executive interfaces
Properties
Open a report in JReport Designer. In the Report Inspector, select the node that represents the report
and you will find the three exit function properties: After Init Parameter, After Run and Before Run.
Reference: For API information, see JReport Designer Javadoc jet.util package and jet.exception
package in <install_root>\help\designer\api.
Executive interfaces
We provide three interfaces for you to implement:
jet.util.JURLExecutor
This interface provides the following method, which is used to get the status of the JReport Engine:
public boolean exec(String[] params) throws JURLExecuterException
Parameter
params - Array of strings, each element is defined and parsed by yourself. You can enter the
PARAMETERs in the Report Inspector. If no PARAMETER is entered, params.length will be zero.
Return
Boolean value. If true, the JReport Engine will continue running. If false, JReport Engine will stop at
this point.
jet.util.JURLEngineExecutor
This interface provides the following method, which is used to get the status of the JReport Engine:
public boolean exec(String[] params, EngineExecutor executor) throws
JURLExecutorException
Parameter
params - Array of strings, each element of which is defined by yourself and also parsed by yourself.
You can enter the PARAMETERs in the Report Inspector. If no PARAMETERs are entered, then params.
length is zero.
executor - Executor of EngineExecutor, which is another interface JReport provides for exporting a
report to HTML, TXT or PDF format within the exit functions.
Return
boolean value. If true, the JReport Engine will continue running. If false, the JReport Engine will stop
at this point.
jet.util.EngineExecutor
This interface provides three methods:
Parameter
HtmlFileName - Name of the HTML format result file with full path.
bChartApplet - A Boolean value which specifies whether or not a chart in an HTML file is an applet.
isMultiFile - A Boolean value which specifies whether or not the HTML is generated to one or
multiple files.
bUsingTable - A Boolean value which specifies whether or not to use the HTML table format for
exporting HTML files.
bHyperLink - A Boolean value which specifies whether or not to generate hyperlinks.
bPageNum - A Boolean value which specifies whether or not to generate page number.
bAbsolute - A Boolean value which specifies whether or not the font size is absolute or relative.
iBrowser - An int value which specifies whether or not the web browser is IE.
Return
Boolean value for exporting status. If true, the report has been successfully exported and vice
versa.
public boolean exportToPdf(String pdfFileName)
Parameter
PdfFileName - The name of the PDF format result file with a full path.
Return
Boolean value for exporting status. If true, the report has been successfully exported and vice
versa.
Parameter
TextFileName - Name of the TEXT format result file with full path, where "true/false" sets whether
or not the text file is of normal text format or of standard data format. A standard data format text
file is a text file where each row represents a single record in a report. It can be used as a text
data source for exchanging data with other applications.
isNormalText - A Boolean value which specifies whether or not a text file is in normal text format.
isRepeat - A Boolean value which specifies whether or not the contents will be repeated.
delimiter - A character which is be used in SDF (Standard Data Format). The delimiter will only be
used when the "true/false" parameter is set to false. Delimiters can be ',' (the CSV format) or any
other character. The default is ' ' (a blank), which is the SSV format.
Return
Boolean value for exporting status. If true, the report has been successfully exported and vice
versa.
Reference: For API information, see JURExecutor, JUREngineExecutor and EngineExecutor interfaces
in the JReport Designer Javadoc jet.util package located at <install_root>\help\designer\api.
String type parameters, such as aa, C:\ and so on. In this case, the string will be passed directly
to the exit function.
JReport predefined parameters used in the current report, which are introduced by the @
symbol. In this case, the parameter value will be passed to the exit function.
6. Run the report, the report engine will call the class that you specified in the Report Inspector.
Notes:
When a JReport parameter is used as the parameter of the Before Run function, no JReport
parameter value will be returned, and the returned value will be the JReport parameter name with
the @ symbol.
For the JReport parameter that are used as exit function parameters, they must be used in the
report. Otherwise, no value will be returned.
If you want to publish the report to JReport Server and run it there, you should publish both the
report and the catalog file to JReport Server. However, do not forget to add the path to the class
path option in the batch file that starts JReport Server.
Using formulas in exit functions can also be realized by using returning values in subreport. Thus,
you need to pass value of a formula in the subreport to a parameter in the main report.
Accessibility
JReport supports accessibility attributes and a built-in accessible JReport Server console. The
implementation standard is based on HTML specification 4.01 http://www.w3.org/TR/WCAG10-HTMLTECHS/ and information on Section 508 Standards: http://www.section508.gov and http://www.accessboard.gov.
When you design reports that will be run on a platform different to where they have been designed,
it is best to use TTF fonts.
JReport uses the JDK TTF, however the JDK has a problem in printing reports with rs_song.ttf (some
characters are incorrect). You are therefore recommended to use other Chinese TTF fonts such as
SimSun.ttf, PMingLiu.ttf and LF_FangSong.ttf.
For files of HTML/RTF/Excel formats, they will find the fonts from the system font directory. If you want
to deliver the report result in the above formats to end users, you should choose the TTF fonts that are
commonly used on Windows systems for your reports. If you have to use fonts that do not exist in a
client system, you can choose the embedded TTF font solution for a good print result in PDF format.
When you select TTF fonts to design a report, and these fonts are not within the client's existing font
systems.
When you have used the TTF and Acrobat Reader has to be updated with the language extension
package to view the result, but you do not want to trouble the end user with it.
To take advantage of the PDF embedded TTF font feature, follow the steps below:
1. Select the TTF to design reports as specified previously.
2. Open the report, go to the Report Inspector, and in the node representing the report, find a
property called Embedded Fonts. The drop-down list will show all the TTF fonts used by the report.
You can select multiple fonts by holding down the Ctrl or Shift key.
3. Save the report set and export it to a PDF file. The selected fonts will be embedded in the
exported PDF file.
By embedding TTF fonts, the file size will increase a little. However, it is still of reasonable size to be
transferred over a network.
Logging
JReport provides a robust, flexible and configurable logging system which is based on log4j version
1.2.8, and supports versions from log4j version 1.2.8 to 1.3alpha7.
The logging system is used for obtaining meaningful and helpful JReport logging information in a
convenient way. It is easy to configure and manage. The following are the significant benefits of the
JReport logging system:
Configuring logs
Log configuration tasks can be achieved in two ways. They are:
Description
-vDebug
Sets engine log file's trace level to INFO and error level to WARN.
-vError
Sets engine log file's trace level to OFF and error level to ERROR.
-log[:<file>]
Outputs message to the file as specified and uses the -vDebug level.
Note: Any settings made using the command options will override the trace and error type level
settings in the LogConfig.properties file. To log on console when using the two commands
above: -vDebug or -vError, configure the appender in LogConfig.properties first.
JReportRollingFile
JReportDailyRollingFile
JReportConsole
By default, all log categories use one appender, JReportRollingFile. However, you can also define
different output appenders or files for different log categories in the LogConfig.properties file, which is
located in <install_root>\bin. For example, to add another log appender - JReportConsole for the
Designer, edit the LogConfig.properties file as follows:
log4j.logger.com.jinfonet.designer=, JReportRollingFile, JReportConsole
...
log4j.appender.RootConsole=org.apache.log4j.ConsoleAppender
log4j.appender.RootConsole.layout=com.jinfonet.util.JRPatternLayout
log4j.appender.RootConsole.layout.ConversionPattern=%m [%t][%p][%d{HH:mm:ss,SSS}]%n
log4j.appender.RootConsole.threshold=ON
log4j.appender.RootConsole.target=System.out
...
OFF
Specifies not to use the trace level.
OUTLINE
The OUTLINE level specifies an outline of program workflow, and dump global variables, including a
single thread, multiple threads, the time for when to begin to fetch data, and success in exporting to
the specified result format.
INFO
The INFO level specifies informational messages that highlight the application progress at a coarsegrained level, and important local variables, such as query, parameter, formula value used when
running report sets, connection information, and SQL statement.
TRIVIAL
The TRIVIAL Level specifies fine-grained informational events most useful in tracing an application.
Such as the report structure dump, or the result set dump.
Error levels
OFF
Specifies not to use the Error level.
FATAL
The FATAL level specifies severe error events that will presumably lead the application to abort, for
example, failing to read the valid key, and exceptions that result in feature incompleted.
ERROR
The ERROR level specifies error events that may allow the application to continue running, such as
failing to load a report set, failing to find a catalog file, failing to parse a parameter, and failing to
create db buffer.
WARN
The WARN level specifies potentially harmful situations, such as failing to find the resource, or having
found invalid query or formula with grammar error when loading a catalog.
If the showTitle property is set to true in the LogConfig.properties file, the log file size will increase.
However, the effect on performance is negligible.
The levels of trace and error affect the amount of logging output. The higher the level, the more the
output. However, the effect on performance is negligible.
The use of the following conversion characters in ConversionPattern property results in the slow
generation of caller class or location information: %C, %F, %L and %M. Their use should be avoided
unless execution speed is not an issue. For information about the ConversionPattern property, see
comments in the LogConfig.properties file, which is located in the <install_root>\bin directory.
Dialog Reference
This chapter covers dialogs that you will come across when using JReport Designer. It mainly provides
description and explanation of the options available in these dialogs. The purpose is to make the use of
JReport Designer much easier and more convenient.
The following are dialogs included in this chapter:
Advanced dialog
Aggregate On dialog
Banded Wizard
Bursting dialog
Chart Wizard
Crosstab Wizard
Encrypt dialog
Filter dialog
Filter On dialog
Find dialog
Find/Replace dialog
Group dialog
Merge dialog
Open As dialog
Options dialog
Parameters dialog
Role dialog
Search dialog
Security dialog
Select N dialog
Subreport dialog
Table Wizard
Tabular Wizard
User dialog
Windows dialog
Aggregation Name
Specifies the name of the aggregation.
Mapping Name
Click the
Aggregate
Specifies the function for the aggregation.
OK
Creates the aggregation and closes the dialog.
Cancel
Cancels the creation and closes the dialog.
Help
Displays this help document.
General tab
Security tab
General tab
Specifies properties of the cube element.
Name
Specifies the name of the cube element.
Display Name
Specifies the display name of the cube element which is intuitive to the end user.
Mapping Name
Specifies the mapping name of the field to which the cube element is mapped. Click
field.
to select the
Type
Specifies the type of the cube element.
Dimension
Dimension objects are the cube elements that will become the basis for analyzing data in a report.
They characteristically return text data or dates.
Measure
Measure objects are numeric cube elements that are calculated at the time the report is ran. The
values they return are dependent on the dimension objects which they are used with. For example
you may want a sales total by year.
Detail Info
Detail information objects provide additional information. They can be bound to dimension, measure
or category. Detail information objects are not used for analysis but are useful to have.
Aggregate Function
Available only when the type of the cube element is defined as measure object. It specifies the function
for the measure object.
Tip
Specifies the tooltip of the cube element which will be shown when you hover the mouse pointer over
the element in the Resource View panel of JReport Viewer.
Description
Specifies the description of the cube element which will be shown after the tooltip when you hover the
mouse pointer over the element in the Resource View panel of JReport Viewer.
Security tab
Specifies principals' permissions to the cube element.
Role tab
Lists all the roles for the current security policy.
Role Name
Displays role names.
Visible
Specifies whether or not the cube element is visible for the roles.
Group tab
Lists the groups for the current security policy.
Group Name
Displays group names.
Visible
Specifies whether or not the cube element is visible for the groups.
User tab
Lists the users for the current security policy.
User Name
Displays user names.
Visible
Specifies whether or not the cube element is visible for the users.
Security Configuration
Related topics:
Columns
Specifies the column settings.
Element
Displays the column name in the selected node of table.
Selected
Specifies whether to import the column into the catalog.
Format
Specifies the format in which the column values are to be displayed in the report result. Varies for
different types of data, and can be manually defined.
Type
Specifies the data type of the column.
Load Tree
Analyzes and loads data tree from the external data source file. The structure is shown in the Structure
box after you click this button.
OK
Applies all changes here and closes the dialog.
Cancel
Does not retain changes and closes the dialog.
Help
Displays this help document.
When Local NLS is checked in the NLS Editor, adds the selected languages to the Language box in
the NLS Editor and closes the dialog.
When Global NLS is checked in the NLS Editor, opens the Connect to JReport Server dialog to
download global NLS resources that have been defined for the selected languages from the server.
Cancel
Cancels the action and exits the dialog.
Help
Displays this help document.
Help
Displays this help document.
Database Catalogs
Lists all the catalogs in the database.
Schemas
Lists the schemas you have selected in the Schema tab of the Get JDBC Connection Information dialog.
Show All Schemas
If checked, all schemas in the selected catalog will be shown in the Schema box.
Tables
Lists the tables contained in the selected schema after you click the Load Tables button.
Connection
Shows the current connection name.
Table Name Pattern
Specifies whether to filter the tables according to the specified filtering condition.
Include System Table
If checked, the system tables will become available in the Tables box.
Include Added Table
If checked, the tables that have been added to the catalog will become available in the Tables box. You
can then add them into the catalog again with a different name.
Load Tables
Loads the tables into the Tables box.
Add
Adds the selected tables to the JReport catalog.
Done
Completes the adding tables process and closes the dialog.
Help
Displays this help document.
Database Catalogs
Lists all the catalogs in the database. Not supported on XML connection.
Schemas
Lists the schema transformed from the XML source.
Tables
Lists the tables contained in the schema after you click the Load Tables button.
Connection
Shows the current connection name.
Load Tables
Loads the tables into the Tables box.
Add
Adds the selected tables to the JReport catalog.
Done
Completes the adding tables process and closes the dialog.
Help
Service Name
Contains all the service information defined in the WSDL file. Select one you want from the drop-down
list.
Operation Name
Contains all the operation information for the selected service. Select one you want from the dropdown list.
Time Out
Specifies how long to wait to get the service and operation information defined in the WSDL file.
Input Message
Lists the input message information for the selected operation.
Value
Specifies the value for the input message.
OK
Accepts the adding table result and closes the dialog.
Cancel
Cancels the adding table process and exists the dialog.
Help
Displays this help document.
After filling in the Class Name field, the classname of the interface that the class implements will be
displayed here.
Parameter
Specifies the parameter string for the UDS. The parameter string must match the format defined in the
UDS class. You can use parameters predefined in a JReport catalog in the parameter string, and the
format used in the string is "@" + parameter name. For example, if the parameter string of a UDS is
SQL=select * from employee, and you want to use the parameter sql in a catalog to replace the part
after "=" in the string, then the parameter string of the UDS will be SQL=@sql.
Edit Format
Opens the Edit Parameter Format dialog, in which you can edit the parameter format:
Name
Displays names of the parameters used in the UDS.
Format
Specifies formats for the parameters as required.
OK
Accepts changes and closes the dialog.
Cancel
Does not retain changes and closes the dialog.
Specify Columns
Specifies the column definitions. If you don't specify the column definitions, JReport will retrieve them
from result set.
Name
Specifies the valid name of the column. The name of the column should have the same validation
with a common table column. The default names for column definitions are column1', column2' etc.
SQLType
Specifies the data type of the column. The following types are supported:
String
The corresponding JDBC type is VARCHAR or LONGVARCHAR.
java.math.BigDecimal
The corresponding JDBC type is NUMERIC.
boolean
The corresponding JDBC type is BIT.
byte
The corresponding JDBC type is TINYINT.
short
The corresponding JDBC type is SMALLINT.
int
The corresponding JDBC type is INTEGER.
long
The corresponding JDBC type is BIGINT.
float
The corresponding JDBC type is REAL.
double
The corresponding JDBC type is DOUBLE.
java.io.InputStream
The corresponding JDBC type is VARBINARY or LONGVARBINARY.
java.sql.Date
The corresponding JDBC type is DATE.
java.sql.Time
The corresponding JDBC type is TIME.
java.sql.Timestamp
The corresponding JDBC type is TIMESTAMP.
Adds a default row in the column definitions. If there is no row selected, an empty row will be added to
the last line.
Related topics:
Connection
Shows the current connection name.
View Name Pattern
Specifies whether to filter the views according to the specified filtering condition.
Include System View
If checked, system views will become available in the Views box.
Include Added View
If checked, views that have been added to the catalog will become available in the Views box. You can
then add them into the catalog again with a different name.
Load Views
Loads the views to the Views box.
Add
Adds the selected views to the JReport catalog.
Done
Completes the adding views process and closes the dialog.
Help
Displays this help document.
General tab
Security tab
General tab
Specifies properties of the view element.
Display Name
Specifies the display name of the view element which is intuitive to the end user.
Mapping Name
Specifies the mapping name of the field to which the view element is mapped. Click
field.
to select the
Type
Specifies the type of the view element.
Group
Group objects are the view elements that will become the basis for analyzing data in a report. They
characteristically return text data or dates. For example they may return items like country, state
and year to use for grouping data in reports.
Aggregation
Aggregation objects are numeric view elements that are calculated at the time the report is ran. The
values they return are dependent on the group objects which they are used with. For example you
may want a sales total by year.
Detail
Detail objects provide additional information. They can be bound to group, aggregation, or category
elements. Detail objects are not used for analysis but are useful in tables to show detail information
such as addresses and phone numbers.
Aggregate Function
Available only when the type of the view element is defined as aggregation. It specifies the function for
the aggregation object.
Tip
Specifies the tooltip of the view element which will be shown when you hover the mouse pointer over
the element in the Resources panel of JReport Studio.
Description
Specifies the description of the view element which will be shown after the tooltip when you hover the
mouse pointer over the element in the Resources panel of JReport Studio.
Security tab
Specifies principals' permissions to the view element.
Role/Group/User tab
Lists all the roles/groups/users for the current security policy.
Name
Displays role/group/user names.
Visible
Specifies whether or not the view element is visible to the roles/groups/users.
Security Configuration
Opens the Security Configuration dialog to add or import principals.
OK
Applies all changes and closes the dialog.
Cancel
Does not retain changes and closes the dialog.
Help
Displays this help document.
Advanced dialog
This dialog appears when you click the Advanced button in the Pattern List dialog. It helps you to bind
certain fill pattern to some specific values in a chart to make the same value the same fill effect. Note
that this feature does not apply to surface 3-D, gauge bubble 2-D and all scatter chart types, and the
settings in the dialog have higher priority than the ones in the Pattern List dialog.
OK
Applies the settings and closes the dialog.
Cancel
Do not retain any changes and closes the dialog.
Help
Displays this help document.
Aggregate On dialog
The dialog appears when you right-click a detail column in a table and select Aggregate On from the
shortcut menu. It helps you to create aggregate function based on the selected table detail column.
Aggregate On
Displays the field bound with the detail column, and also the one on which you want to create
aggregate function.
Function
Specifies the function to summarize the field in the detail column.
Group By
If checked, you can select a group by field from the drop-down list below, to which the summary will
be applied. If no field is selected, the summary will be applied to the whole dataset.
If unchecked, a dynamic summary will be created.
OK
Creates the aggregation and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Banded Wizard
This wizard is displayed when you select the Banded layout in the New Report dialog or New Report Set dialog and then click
OK, or right-click a banded object and click Banded Wizard on the shortcut menu. It helps you to create or modify a banded
object.
The wizard consists of the following screens:
Data screen
Display screen
Group screen
Summary screen
Chart screen
Filter screen
Style screen
Back
Goes back to the previous screen.
Next
Goes to the next screen.
Finish
Finishes creating or modifying the banded object and closes this wizard.
Cancel
Does not retain changes and closes this wizard.
Help
Displays this help document.
Data screen
Specifies the dataset for the banded object.
New
If checked, select a data source from the catalog resources to create a dataset that will be used to build the banded object.
When you choose to create the dataset from a query, you can click the Modify button to edit the query in the Query Editor if
required.
Existing
If checked, select a dataset from the ones existing in the open report set to create the banded object. Click the Modify
button to edit the dataset in the Dataset Editor if required.
Current
If checked, the current dataset used by the parent object will be applied to the banded object.
Display screen
Specifies the data fields to display in the banded object.
Resources
Lists all the available data resources.
Removes the specified field that is not required in the banded object.
Replaces the selected field in the banded object with the specified field in the Resources panel.
Group screen
Specifies the fields to group the data.
Resources
Lists all the available data resources.
Adds the selected field as the group by field in the banded object.
Replaces the selected group by field in the banded object with the specified field in the Resources panel.
Ascend
Groups will be sorted in an ascending order (A, B, C).
Descend
Groups will be sorted in a descending order (C, B, A).
No Sort
Groups will be sorted in the original order in database.
Special Group
Opens the User Defined Group dialog to define grouping information.
For example, if you placed a field named Region for grouping, and this field contains all 50 states of the United States; and if
you want to see the data between Maryland (MD) and New York (NY), you can define the criteria by selecting the between
operator to further define your grouping information.
Sort Group By
Opens the Sort Group By dialog to set how groups will be sorted.
Special Function
If the group by field is of Numeric/String/Date/Time type, you can select a special function for the field in the Special Function
column to further specify to which level the data will be grouped by.
If Customize is selected, the Customized Function dialog will be displayed, in which you can set the function by your own.
Sort Group By
Specifies how to sort the groups. Activated only when you have clicked Sort Group By from the Sort column to define the
sorting manner of groups for the selected group level.
Special Group
Specifies how to group your information. Activated only when you have clicked Special Group from the Sort column to define a
special group.
Select N
Opens the Select N dialog to specify the Select N condition.
Group Filter
Opens the Group Filter dialog to specify the group filter condition.
Summary screen
Specifies the fields on which to create aggregate functions. This screen is available only when you create a banded object.
Resources
Lists all the available data resources.
Adds the selected field as the summary field to the banded object.
Lists all the fields that you want to display and to be summarized in the banded object.
Aggregate Function
Specifies the function to summarize the selected field.
Break Field
Displays a defined field on which the summary will be calculated. If a summary field is added below the Banded Object node,
the break field is null and the summary will be calculated on the whole dataset.
Chart screen
Specifies to create a chart together with the banded object, which will be placed in the banded header panel. This screen is
available only when you create a banded object, and when there is at least one group by field and one summary field which is
calculated on this group by field in the banded object.
No Chart
Specifies not to create a chart.
Bar Chart
Specifies to create a Clustered Bar 2-D chart together with the banded object.
Line Chart
Specifies to create a Line 2-D chart together with the banded object.
Pie Chart
Specifies to create a Clustered Pie chart together with the banded object.
Category
Lists the group by fields of the banded object on which the summary fields are calculated. Choose the field you want to display
on the category (X) axis of the chart from the drop-down list.
Series
Lists the fields that have been added as the group by fields of the banded object. Choose the field you want to display on the
series (Z) axis of the chart from the drop-down list.
Show Values
Lists the summary fields which are calculated based on the field you choose to display on the category axis of the chart.
Choose the value you want to display in the chart from the drop-down list.
Filter screen
Specifies to filter data displayed in the banded object. This screen is available only when you create a banded object.
For details about options in the screen, see Edit Filter dialog.
Style screen
Specifies the style of the banded object.
Style
Lists all the available styles that can be applied to the banded object.
<Custom>
There is no any style information on it and it is only used to cover previous-version report which did not bind any style or the
bound style cannot be found in the style list.
Preview
Displays a diagram illustrating the effect of the selected style on the banded object.
Inherit Style
Specifies whether to make the banded object take the style of its parent. This option is available only when you modify a
banded object and the banded object is inserted into another banded object.
Create a Banded Report
Creates a restricted version of a flow layout report, one that can contain a single banded object only. This layout option is
intended to provide compatibility with JReport Version 7 report templates.
Create a Flow Layout Report Containing a Banded Object
Creates a report that contains a banded object mapped to the specified dataset. This layout option is specified by default.
Page Setup
Opens the Page Setup dialog to specify page properties.
Related topics:
Specifies the unit for values of Quiet Zone, Narrow Width, Supplement, Height, and Ratio. Can be Mils
(0.001 inch), Metric (0.01 millimeter), and Points (1/72 inch).
Quiet Zone
Specifies the space around the barcode where there are no dark marks. Most of symbology requires a
quiet zone which precedes the following barcode.
Narrow Width
Specifies the barcode bar width.
Supplement
Specifies the supplement (if necessary). Some barcode types, such as CODE39, CODE128 and
Codabar, do not have supplements.
Height
Specifies the height of the barcode.
Ratio
Specifies the width ratio of the thick bar to the thin bar in the CODE39/ Codabar barcode. The ratio box
can have only 2 effective values, 2.0 and 3.0. Any ratio values that are not equal to 2.0 or 3.0 will be
regarded as 2.0. Enabled only for CODE39 and Codabar.
Default Message
Specifies the default value for the barcode.
Enable Checking Digits
If checked, the checking digits will be enabled.
Display HR
Specifies whether to display the barcode numbers together with the barcode. Enabled only for CODE39,
CODE128, and Codabar.
Insert
Accepts the changes and inserts the barcode into your report.
Cancel
Does not retain the changes and closes the dialog.
Help
Displays this help document.
Related topics:
Component - Barcodes
Bursting dialog
The dialog appears when you click Report > Bursting on the menu bar. It helps you to make a normal
report become a bursting report.
Dataset
Specifies the dataset used in the report based on which to set the bursting key. Multiple bursting
schemas for a report can be based on different datasets in the report.
Bursting Key
Specifies DB columns according to which to split report data. The available values are columns in
the specified dataset.
Recipient
Data Source
Specifies the data source that contains the recipient query.
Query
Specifies the query from the selected data source which retrieves recipient addresses. Multiple
bursting schemas for a report can be based on different recipient queries in the report.
Recipient Mapping Identifier
Specifies a unique recipient column to map to each bursting key column. The available values are
columns in the specified query of the same data type as the bursting key.
The recipient columns should contain all desired information of addresses which will be used in
recipient.
Adds a row to map another pair of bursting key column and recipient column.
Recipient
E-mail
Specifies the column that defines E-mail addresses.
FTP
Specifies the column that defines FTP addresses.
Disk
Specifies the column that defines file system directories.
JReport Server Version
Specifies the column that defines resource directories in the JReport Server resource system.
JReport Server User
Specifies the column that defines user addresses in the JReport Server security system.
User E-mail
If checked, the report results will be sent to e-mail addresses.
User Private Folder
If checked, the report results will be sent to the users' My Reports folders in the server resource
tree and you are allowed to give a subpath.
User E-mail
If checked, the report results will be sent to e-mail addresses.
User Private Folder
If checked, the report results will be sent to the group members' My Reports folders in the server
resource tree and you are allowed to give a subpath.
Sub Path
If checked, specify a subpath in the My Reports folder and the report result will be sent to the
subpath.
Sub Path
If checked, specify a subpath in the My Reports folder and the report result will be sent to the
subpath.
User E-mail
If checked, the report results will be sent to e-mail addresses.
User Private Folder
If checked, the report results will be sent to the role members' My Reports folders in the server
resource tree and you are allowed to give a subpath.
Sub Path
If checked, specify a subpath in the My Reports folder and the report result will be sent to the
subpath.
OK
Accepts all changes and closes the dialog.
Cancel
Related topics:
Report Bursting
Save
Saves the business cube and applies all the changes made in this window.
Save As
Saves the business cube as another name and applies all the changes made in this window.
Close
Exits this window.
Insert
Category
Opens the Category Property dialog to insert a new folder into the business cube.
Dimension
Opens the Add Cube Element dialog to insert a dimension object to the business cube.
Measure
Opens the Add Cube Element dialog to insert a measure object to the business cube.
Detail
Opens the Add Cube Element dialog to insert a detail information object to the business cube.
Tools
Filter
Opens the Filter dialog to set a built-in filter for the business cube.
Hierarchy Management
Opens the Hierarchy Editor dialog to edit hierarchies for the business cube.
Join Editor
Opens the Business Cube - Join Editor window to edit joins for the business cube.
Security Configuration
Opens the Security Configuration dialog to configure security for the business cube.
Predefined Filter
Opens the Predefined Filter dialog to add some predefined filters for the business cube.
Help
Displays this help document.
Toolbar
Save
Saves the business cube and apply all the changes made in this window.
Delete
Deletes the specified table, view, formula or summary from the business cube.
Insert Category
Inserts a category into the business cube.
Insert Dimension
Inserts a dimension object to the business cube.
Insert Measure
Inserts a measure object to the business cube.
Insert Detail
Inserts a detail information object to the business cube.
Filter
Specifies a built-in filter for the business cube. The built-in filter is transparent to the end users
running reports based on the business cube. Each business cube can only have one built-in filter.
Hierarchy Management
Specifies hierarchies for the business cube.
Join Editor
Specifies joins for the business cube.
Predefined Filter
Adds some predefined filters for the business cube. Ad hoc end users can choose to apply those filters
when designing/modifying reports based on the business cube.
Move Up
Moves the selected object one step up.
Move Down
Moves the selected object one step down.
Resource Objects
This panel lists all the objects that can be inserted into the business cube.
Business Cube
This panel lists resources added to the business cube.
Related topics:
Save
Saves and applies all the changes made in this window.
Exit
Exits this window.
Table
Table Properties
Opens the Table Properties dialog to specify properties for tables of the business cube.
Add Table
Opens the Add Table dialog to add tables to the business cube.
Delete Table
Deletes the selected table from the business cube. However, a table which is a part of a join cannot be deleted.
Auto Join
Specifies the criteria to set up joins automatically.
By Name
Specifies to set up joins automatically by name.
By Primary Key
Specifies to set up joins automatically by primary key.
Toolbar
Deletes the selected table from the business cube. However, a table which is a part of a join cannot be deleted.
Arranges the tables that are added into the business cube.
All Joins
Lists all joins created for the business cube.
All Loops
Lists all loops formed among the business cube joins.
Arrange
Arranges the tables that are added into the business cube.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain changes and closes the dialog.
Help
Displays this help document.
Related topics:
Setting up joins
Save
Saves the business view and applies all the changes made in this window.
Close
Exits this window.
Insert
Category
Opens the Category Property dialog to insert a new folder into the business view.
Group
Opens the Add View Element dialog to insert a group object into the business view.
Aggregation
Opens the Add View Element dialog to insert an aggregation object into the business view.
Detail
Opens the Add View Element dialog to insert a detail object into the business view.
Tools
Security Configuration
Opens the Security Configuration dialog to configure security for the business view.
Predefined Filter
Opens the Predefined Filter dialog to add predefined filters to the business view.
Help
Toolbar
Save
Saves the business view and applies all the changes made in this window.
Delete
Deletes the specified category, group, aggregation or detail from the business view.
Insert Category
Inserts a new folder into the business view.
Insert Group
Inserts a group object into the business view.
Insert Aggregation
Inserts an aggregation object into the business view.
Insert Detail
Inserts a detail object into the business view.
Predefined Filter
Opens the Predefined Filter dialog to add predefined filters to the business view. End users can choose
to apply those filters when designing/modifying studio reports based on the business view.
Related topics:
Ascend
Values will be sorted in an ascending order (A, B, C).
Descend
Values will be sorted in a descending order (C, B, A).
No Sort
Values will be sorted in the original order in database.
Category Selection
Specifies the number of the category values that will be displayed in the chart.
Select
Specifies the Select N condition to define the number of the category values that will be displayed.
All
If selected, all category values in the chart will be displayed.
Top N
If selected, specify a number in the field to the right and the first N category values in the chart
will be displayed. You can also select a parameter from the drop-down list, which returns an
integer, and then specify a value for the parameter when viewing the report to dynamically define
the Top N condition.
Bottom N
If selected, specify a number in the field to the right and the last N category values in the chart will
be displayed. You can also select a parameter from the drop-down list which returns an integer,
and then specify a value for the parameter when viewing the report to dynamically define the
Bottom N condition.
Based On
If checked, the category values will be sorted by values of the summary selected with the direction
specified. If unchecked, the category values will be sorted by the order specified in the Category
Order box of the dialog.
Remaining Categories In
Enabled only when Top N or Bottom N is selected from the Select drop-down list. Check this option
and then type a character string in the text field to group all the category values beyond the top/
bottom N range.
Skip First
If you check the Skip First option and input a number M in the text field to the right, then the first M
category values in the chart will be skipped and the Select N condition will take effect beginning with
M+1. The skipped values will be included in the Remaining Categories group together with all the
category values beyond the top/bottom N range.
OK
Accepts the changes and closes the dialog.
Cancel
Discards the changes and closes the dialog.
Help
Displays this help document.
Related topics:
General tab
Security tab
General tab
Specifies properties for the category.
Display Name
Specifies the display name of the category.
Description
Specifies the description of the category which will be shown when you hover the mouse pointer over
the business/report cube category in the Resource View panel of JReport Viewer, or over the business
view category in the Resources panel of JReport Studio.
Security tab
Specifies principals' permissions to the category.
Role tab
Lists all the roles for the security policy.
Name
Displays role names.
Visible
Specifies whether or not the category is visible for the roles.
Group tab
Lists all the groups for the security policy.
Name
Displays group names.
Visible
Specifies whether or not the category is visible for the groups.
User tab
Lists all the users for the security policy.
Name
Visible
Specifies whether or not the category is visible for the users.
Security Configuration
Opens the Security Configuration dialog to add or import principals.
OK
Applies all changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Chart Wizard
This wizard is displayed when you select Chart layout in the New Report dialog or New Report Set dialog and then click OK, or
right-click a chart and click Chart Wizard from the shortcut menu. It helps you create or modify a chart.
The wizard consists of the following screens:
Data screen
Type screen
Display screen
Filter screen
Layout screen
Style screen
Back
Goes back to the previous screen.
Next
Goes to the next screen.
Finish
Finishes creating or modifying the chart and closes this wizard.
Cancel
Does not retain changes and closes this wizard.
Help
Displays this help document.
Data screen
The Data screen differs with report type: normal report or studio report.
New
If checked, select a data source from the catalog resources to create a dataset that will be used to build the chart. When you
choose to create the dataset from a query, you can click the Modify button to edit the query in the Query Editor if required.
Existing
If checked, select a dataset from the ones existing in the open report set to create the chart. Click the Modify button to edit
the dataset in the Dataset Editor if required.
Current
If checked, the current dataset used by the parent object will be applied to the chart.
Type screen
Specifies the type of the chart. You can refer to the section Chart types which describes each of the chart type in detail.
Single chart
Specifies to create a single chart.
Chart Type
Lists all the chart types that can be used to create a single chart.
Sub Type
Lists all the sub types of the selected chart type.
Description
Displays the description of the selected chart type.
Combo chart
Specifies to make more than one type use the primary or secondary axis. The types should be featured as Combination charts.
Two types of data markers are used to represent different data values.
Chart Type
Lists all the chart types that can be added as a combo chart.
Sub-Type
Lists all the sub-types of the selected chart type.
Description
Primary Axis
Secondary Axis
Removes a specified chart type from the Chart Type Groups box.
Display screen
Specifies the data fields to display in the chart.
Resources
Removes the selected fields from the chart if they are not required.
Replaces the selected field in the chart with the specified field in the Resources panel.
Category/Series
Lists the field you want to display on the category/series axis of the chart.
Special Group
Opens the User Defined Group dialog to define how to group information.
Special Function
Opens the Special Function dialog to define some special function to the field.
Order/Select N
Opens the Category Options dialog or Series Options dialog to specify the sort order of the category or series values and
define the number of the category or series values that will be displayed in the chart.
Show Values
Lists the values you want to show in the chart.
Filter screen
Specifies to filter the data used in the chart. This screen is available only when you create a chart.
For details about options in the screen, see Edit Filter dialog.
Layout screen
Specifies the layout of the chart elements.
Data
Notes:
If values are set to be less than 0, it means the categories or series will be displayed without any offset.
If values are set to be greater than 0 and the value of Category/Series Start Offset is greater than that of Category/Series
End Offset, all of the categories or series will be displayed.
Title
Chart Title
Specifies the title of the chart.
Category(X) Axis Title
Specifies the title of the X-axis.
Value(Y) Axis Title
Specifies the title of the Y-axis.
Value(Y2) Axis Title
Specifies the title of the Y2-axis.
Axis
Wall
Show Wall
Specifies whether to show the wall in this chart.
Show Floor
Specifies whether to show the floor in this chart.
Gridlines
Legend
Show Legend
Specifies whether to show the legend in this chart.
Export
Mapping Component
Specifies the component to which the chart will be mapped. For details, see Creating dynamic chart in Excel.
Style screen
Specifies the style of the chart.
Style
Lists the available styles.
<Custom>
There is no any style information on it and it is only used to cover previous-version report which did not bind any style or the
bound style cannot be found in the style list.
Preview
Displays a diagram illustrating the effect of the selected style on the chart.
Inherit Style
Specifies whether to make the chart take the style of its parent. This options is available only when you modify a chart and the
chart is inserted into a banded object or table.
Page Setup
Opens the Page Setup dialog to specify page properties.
Related topics:
Modifying a chart
New
If checked, select a data source from the catalog resources to create a dataset that will be used to
build the report. When you choose to create the dataset from a query, you can click the Modify
button to edit the query if required.
Existing
If checked, select a dataset from the ones existing in the open report set to create the report. Click
the Modify button to edit the query if required.
OK
Accepts changes and closes this dialog.
Cancel
Does not retain changes and closes this dialog.
Help
Displays this help document.
To add consecutive report sets, first click the report set, press and hold down SHIFT, and then click
the last report set, then click the Add button.
To add report sets that are not consecutive, press and hold down CTRL, click each report set, and
then click the Add button.
Cancel
Closes this dialog and leaves any changes unsaved.
Help
Displays this help document.
Related topics:
Priority
Specifies the priority of each condition.
High
Moves a condition up for a higher priority.
Low
Moves a condition down for a lower priority.
Format
Specifies the format which will be applied to the field values when the specified condition is fulfilled.
Font
Specifies the font type for the field values.
Border
Specifies the border line style for the field values.
Size
Specifies the font size for the field values.
Bold
Specifies whether or not to bold the field values.
Italic
Specifies whether or not to make the field values italic.
Underline
Specifies whether or not to underline the field values.
Foreground Color
Specifies the foreground color for the field values.
Background Color
Specifies the background color for the field values.
Sample Text
Displays a preview sample of your selection.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Host
Specifies the host of the remote web server.
Port
Specifies the port that the web server listens to.
Servlet Path
It is /jrserver, and is used in the URL to access the servlet.
SSL
Abbreviation of Security Socket Layer. Check this option to specify whether to create an SSL
connection when the server you are using is integrated with another web server which supports SSL.
Login
Specifies the user name and password for login to the server.
User Name
Specifies the user name used to access JReport Server.
Password
Specifies the password of the user name.
Connect
Connects to JReport Server.
Cancel
Does not retain the changes and closes the dialog.
Help
Displays this help document.
Data screen
Display screen
Group screen
Summary screen
Filter screen
Style screen
Back
Goes back to the previous screen.
Next
Goes to the next screen.
Finish
Finishes creating the banded object and closes this dialog.
Cancel
Does not retain changes and closes this dialog.
Help
Displays this help document.
Data screen
Specifies the dataset that you want to use to create the banded report.
on
New
If checked, select a data source from the catalog resources to create a dataset that will be used to build the banded object.
When you choose to create the dataset from a query, you can click the Modify button to edit the query in the Query Editor if
required.
Existing
If checked, select a dataset from the ones existing in the open report set to create the banded object. Click the Modify
button to edit the dataset in the Dataset Editor if required.
Current
If checked, the current dataset used by the parent object will be applied to the banded object.
Display screen
Specifies the data fields that you want to display in the banded object.
Resources
Lists all the available data resources.
Removes the specified field that is not required in the banded object.
Display Name
Shows the display names of the selected fields. You can double-click the name cells to edit them if required.
Sort Fields By
Opens the Sort Fields By dialog to specify how to sort data in the banded object.
Group screen
Specifies the data fields that are used to group the data.
Resources
Lists all the available data resources.
Adds the selected field as the group by field in the banded object.
Ascend
Groups will be sorted in an ascending order (A, B, C).
Descend
Groups will be sorted in a descending order (C, B, A).
No Sort
Groups will be sorted in the original order in database.
Special Group
Opens the User Defined Group dialog to define grouping information.
For example, if you placed a field named Region for grouping, and this field contains all 50 states of the United States; and if
you want to see the data between Maryland (MD) and New York (NY), you can define the criteria by selecting the between
operator to further define your grouping information.
Sort Group By
Opens the Sort Group By dialog to set how groups will be sorted.
Special Function
If the group by field is of Numeric/String/Date/Time type, you can select a special function for the field in the Special Function
column to further specify to which level the data will be grouped by.
If Customize is selected, the Customized Function dialog will be displayed, in which you can set the function by your own.
Sort Group By
Specifies how to sort the groups. Activated only when you have clicked Sort Group By from the Sort column to define the
sorting manner of groups for the selected group level.
Special Group
Specifies how to group your information. Activated only when you have clicked Special Group from the Sort column to define a
special group.
Select N
Opens the Select N dialog to specify the Select N condition.
Group Filter
Opens the Group Filter dialog to specify the group filter condition.
Summary screen
Specifies the fields on which you want to create aggregate functions.
Resources
Lists all the available data resources.
Adds the selected field as the summary field to the banded object.
Aggregate Function
Specifies the function to summarize the selected field.
Break Field
Displays a defined field on which the summary will be calculated. If a summary field is added below the Banded Object node,
the break field is null and the summary will be calculated on the whole dataset.
Filter screen
Specifies to filter data displayed in the banded object.
For details about options in the screen, see Edit Filter dialog.
Style screen
Specifies the style of the banded object.
Grow Report
Specifies the layout of the banded object.
Vertically
Creates a vertical banded object.
Horizontally
Creates a horizontal banded object.
Mailing Label Format
Creates a cross banded object in the form of a mailing label layout.
Style
Specifies the style of the banded object.
Preview
Displays the selected layout and style effects.
Inherit Style
Specifies whether to make the banded object take the style of its parent. Available only when the banded object is to be
inserted into another banded object.
Related topics:
Data Screen
Type screen
Display screen
Filter screen
Layout screen
Style screen
Back
Goes back to the previous screen.
Next
Goes to the next screen.
Finish
Finishes creating a chart and closes this wizard.
Cancel
Does not retain changes and closes this wizard.
Help
Displays this help document.
Data screen
The Data screen differs with report type: normal report or studio report.
New
If checked, select a data source from the catalog resources to create a dataset that will be used to build the chart. When you
choose to create the dataset from a query, you can click the Modify button to edit the query in the Query Editor if required.
Existing
If checked, select a dataset from the ones existing in the open report set to create the chart. Click the Modify button to edit
the dataset in the Dataset Editor if required.
Current
If checked, the current dataset used by the parent object will be applied to the chart.
Type screen
Specifies the type of the chart. You can refer to the section Chart types which describes each of the chart type in detail.
Single chart
Specifies to create a single chart.
Chart Type
Lists all the chart types that can be used to create a single chart.
Sub Type
Lists all the sub types of the selected chart type.
Description
Displays the description of the selected chart type.
Combo chart
Specifies to make more than one type use the primary or secondary axis. The types should be featured as Combination charts.
Two types of data markers are used to represent different data values.
Chart Type
Lists all the chart types that can be added as a combo chart.
Sub Type
Lists all the sub types of the selected chart type.
Description
Primary Axis
Secondary Axis
Removes a specified chart type from the Chart Type Groups box.
Display screen
Specifies the data fields that you want to display in the chart.
Resources
Removes the selected fields from the chart if they are not required.
Category/Series
Lists the field you want to display on the category/series axis of the chart.
Special Group
Opens the User Defined Group dialog to define how to group information.
Special Function
Opens the Special Function dialog to define some special function to the field.
Order/Select N
Opens the Category Options dialog or Series Options dialog to specify the sort order of the category or series values and
define the number of the category or series values that will be displayed in the chart.
Show Values
Lists the values you want to show in the chart.
Filter screen
Specifies to filter the data used in the chart.
Filter
This option is available only when creating a chart in a studio report. It lists all the predefined filters of the specified business
view. Select one from the drop-down list to apply, or select User Defined and define a new filter according to your
requirements.
For details about the other options in the screen, see Edit Filter dialog.
Layout screen
Specifies settings of some of the chart elements.
Data
Notes:
If values are set to be less than 0, it means the categories or series will be displayed without any offset.
If values are set to be greater than 0 and the value of Category/Series Start Offset is greater than that of Category/Series
End Offset, all of the categories or series will be displayed.
Title
Chart Title
Specifies the title of the chart.
Category(X) Axis Title
Specifies the title of the X-axis.
Value(Y) Axis Title
Specifies the title of the Y-axis.
Value(Y2) Axis Title
Specifies the title of the Y2-axis.
Axis
Wall
Show Wall
Specifies whether to show the wall in this chart.
Show Floor
Specifies whether to show the floor in this chart.
Gridlines
Legend
Show Legend
Specifies whether to show the legend in this chart.
Export
Mapping Component
This option is disabled when creating a chart. It specifies the component to which the chart will be mapped (for details, see
Creating dynamic chart in Excel).
Style screen
Specifies the style of the chart.
Style
Specifies the style of the chart.
Preview
Displays the selected style and layout effects.
Inherit Style
Specifies whether to make the chart take the style of its parent. Available only when the chart is to be inserted into a table or
banded object.
Related topics:
String
Specifies String formulas to create a function.
Numeric
Specifies Numeric formulas to create a function.
Time & Date
Specifies Time or Date formulas to create a function.
+
Table/Column
Lists all the tables and fields which are available for creating the computed column.
OK
Applies all changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Related topics:
Data screen
Display screen
Filter screen
Layout screen
Style screen
Back
Goes back to the previous screen.
Next
Goes to the next screen.
Finish
Finishes creating the crosstab and closes this dialog.
Cancel
Does not retain changes and closes this dialog.
Help
Displays this help document.
Data screen
The Data screen differs with report type: normal report or studio report.
New
If checked, select a data source from the catalog resources to create a dataset that will be used to build the crosstab. When
you choose to create the dataset from a query, you can click the Modify button to edit the query in the Query Editor if
required.
Existing
If checked, select a dataset from the ones existing in the open report set to create the crosstab. Click the Modify button to
edit the dataset in the Dataset Editor if required.
Current
If checked, the current dataset used by the parent object will be applied to the crosstab.
Display screen
Specifies the fields that you want to display in the crosstab.
Resources
Lists all the available data resources.
Field
Lists the fields that will be displayed on the columns/rows of the crosstab.
Label
Specifies the display names for the selected fields. By default these are blank and no names will be created for the fields to
label the columns/rows. You can double-click the cells to edit them if required.
Color
Specifies the background color of the selected fields.
Summaries
Field
Lists the fields that you select to create summaries.
Aggregate
Specifies the functions used to summarize data of the selected fields.
Label
Specifies the display names for the selected fields. By default these are blank and no names will be created for the fields to
label the summaries. You can double-click the cells to edit them if required.
Comparison Function
Opens the Comparison Function dialog to add a comparison function as an aggregate for the crosstab.
Filter screen
Specifies to filter data displayed in the crosstab.
Filter
This option is available only when creating a crosstab in a studio report. It lists all the predefined filters of the specified
business view. Select one from the drop-down list to apply, or select User Defined and define a new filter according to your
requirements.
For details about the other options in the screen, see Edit Filter dialog.
Layout screen
Specifies the layout of the crosstab.
Aggregate
Specifies properties of the aggregate fields.
Vertical Layout
If selected, the aggregate layout will be set vertically.
Horizontal Layout
If selected, the aggregate layout will be set horizontally.
Number of Row(s)
Specifies the number of rows to be displayed in a crosstab. By default, it is -1, which means that there is only one column
with which to arrange the aggregate fields vertically; if it is set to 1, that means there will be only one row to arrange the
aggregate fields horizontally; if it is set to a number larger than 1, that means there will be this number of aggregate
rows; if this number is larger than the number of aggregate fields in the crosstab, it will be treated as -1.
Number of Column(s)
Specifies the number of columns to be displayed in a column. By default, it is -1, which means that there is only one row
with which to arrange the aggregate fields horizontally; if it is set to 1, that means there will be only one column to
arrange the aggregate fields vertically; if it is set to a number larger than 1, that means there will be this number of
aggregate rows; if this number is larger than the number of aggregate fields in the crosstab, it will be treated as -1.
Repeat Aggregate
Assume that you have created a crosstab on the query WorldWideSales in the catalog file SampleReports.cat as follows:
added Products_Product Type ID as the column field, added Customers_Country as the row field, added Quantity and
Discount as the aggregate fields and specified the functions as Sum, and applied the style Classic to the crosstab.
If checked, one cell will contain only one aggregate field value, while for the other aggregate fields, the crosstab will
repeat. The crosstab will be shown as below:
If unchecked, one crosstab cell accommodates the values of all aggregate fields. The crosstab will be shown as below:
Style screen
Specifies the style of the crosstab.
Style
Related topics:
Type-in Parameter
If selected, you can predefine parameter values by typing manually.
Bind with Single Column
If selected, the parameter will be bound with a DBField. The values of the DBField will be retrieved as the
parameter values at runtime.
Value Type
Specifies the data type of the parameter.
Values
The section after Value Type varies with the type you select from the Value Setting drop-down list.
For Type-in Parameter
Value List
Lists the predefined parameter values.
Prompt Values [format hint]
Predefines the parameter values. The [format hint] shows what the predefined values should look like.
There can be more than one prompt value. All the prompt values must be of the same type as specified in
the Value Type field.
Adds a new prompt value to the list. Double-click in the value line to edit the value.
JReport provides such a mechanism that links each field value of Display Column with the exact value of
Bind Column. When you select the field value from Display Column, the field value of Bind Column is
actually sent to the query and filters the query result. It helps you to bind the parameter to a DBField
(column) in order to provide a list of DBField values for users to select at runtime. The selected value of the
bound DBField will be used as the parameter value. Additionally, instead of displaying the values of the
bound one, you can also choose to display values of other DBField, which probably makes more sense to the
report end users. For example, it might be confusing if you provide a list of customer ID numbers for users
to select at runtime, since the ID numbers could probably mean nothing to them. In cases like this, it is
wise for you to display values of other fields, which could probably make more sense. For this case, you
might prefer to display customer names instead of ID numbers. When the report end users select a
customer name from the list, its ID number is passed to the query as the parameter value so that the
search criteria can be fulfilled. So, before the report with a parameter bound to a DBField is processed, a
query statement will be executed first to retrieve the values of the bound field and display field.
Source
Specifies the data source type from which to retrieve the columns which can be used to bind with the
parameter. The available data source types are tables and views, stored procedures, imported SQLs, and
user defined data sources.
Bind Column
Specifies the DBField to be bound with the parameter.
Display Column
When viewing a report which contains the parameter, the field values related to the column name you
selected in the drop-down list of Display Column will be displayed in the Enter Parameter Values dialog at
runtime.
For Bind with Cascading Columns
Data Source
Specifies the data source type from which to retrieve the columns which can be used to bind with the
parameters. The available data source types are tables, views, stored procedures, imported SQLs, and
user defined data sources.
Value List
Defines a group of cascading parameters.
Options
Specifies options for the parameter. The options vary with the type you select from the Value Setting dropdown list.
Prompt Text
Specifies the text for prompting users to provide the value of the parameter.
Tips:
To help users avoid typing a value out of range, you can add the value range to the end of the prompt
text. For example, "Type a customer ID (1~100):".
To help users avoid typing a value in a wrong pattern, you can add the value pattern to the end of the
prompt text. For example, "Type an order date (MMM-dd-yy):".
Minimum Value/Length
Specifies the minimum value allowed for the parameter. If the parameter value type is String, this option is
defined as Minimum Length, which means that you can set the minimum allowed length of the string.
Maximum Value/Length
Specifies the maximum value allowed for the parameter. If the parameter value type is String, this option is
defined as Maximum Length, which means that you can set the maximum allowed length of the string.
String Encoding
Specifies the encoding for the parameter. Available only when the parameter's data type is defined as String.
User Defined Format
For certain types of parameters, the value format supplied by JReport may not satisfy your requirement. In
this case, you can define your own preferred format. When you have defined the value format, all the
values you supply at runtime should be based on it. Otherwise there will be an error message. For details,
see User defined format for parameters.
Notes:
The letters that stand for the user defined format should follow the JDK standard. In addition, the
user defined format only limits the format of the input value, which does not mean that the display
value will be in the same format. To change the display format, you will need to specify the Format
property of this parameter in the Report Inspector.
The user defined format will show different appearance under different locale, and you need input
values according to the displayed format. For example, under the Spanish or French locale, ####.
## will be displayed as #0,## and you should follow #0,## to input values.
Required
If set to true, the parameter will be treated as a required parameter. A required parameter must be fulfilled,
which means that you must supply a value in the Enter Parameter Values dialog before the report can be
run. If set to false, the parameter will be treated as an optional parameter. An optional parameter can be
left blank, which means you can either type a value, or leave it as it is.
In the Enter Parameters Value dialog, the prompt text of a required parameter will be marked with a * sign.
Note: If the parameter is optional and you do not expect it to take effect in your report, in the Enter
Parameter Values dialog, clear the content in the value field. Otherwise, any value left in the field will
function in reports.
If set to true, when the value of the parameter is blank, the current date time in your system will be used
as value of the parameter. Available only when the parameter's data type is defined as Date, Time or
DateTime.
If the type of the parameter is set to Date, Time or DateTime, you can choose whether to get parameter
value dynamically from the system's date time by enabling one of the above options - Use Current or Use
Current When Blank. However, if you want to use this feature, you need to make sure your system's
DateTime format is set to yyyy-MM-dd H:mm:ss as it is the only format JReport supports; otherwise, you
need to make use of the User Defined Parameter Format feature. Also, if one of the two options is enabled,
you need to provide the parameter's prompt value according to the data type of your parameter.
When the data type of the parameter is Date, you can specify the value according to the format yyyy-MMdd.
When the data type of the parameter is Time, you can specify the value according to the format H:mm:
ss.
When the data type of the parameter is DateTime, specify the value in a combination of the above.
Note: If you have made changes to the SQL statement, the later changes for Bind Column and Display
Column will not take effect unless you remove the SQL lines or bind the parameter all over again. To
remove the SQL lines, click
in the value cell and clear the content in the Import SQL dialog.
Use default
The default value defined when creating the parameter will be used.
Warn
Displays a warning message telling that "Value xxx is out of the available value list".
Note: For a multi-value parameter, if one of the input values is not in the value list, the whole input
result will be treated as out of range.
OK
Applies all changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Related topics:
Creating a parameter
Related topics:
Locking queries
Data screen
Display screen
Group screen
Summary screen
Filter screen
Style screen
Back
Goes back to the previous screen.
Next
Goes to the next screen.
Finish
Finishes creating the table and closes this dialog.
Cancel
Does not retain changes and closes this dialog.
Help
Displays this help document.
Data screen
The Data screen differs with report type: normal report or studio report.
New
If checked, select a data source from the catalog resources to create a dataset that will be used to build the table. When you
choose to create the dataset from a query, you can click the Modify button to edit the query in the Query Editor if required.
Existing
If checked, select a dataset from the ones existing in the open report set to create the table. Click the Modify button to edit
the dataset in the Dataset Editor if required.
Current
If checked, the current dataset used by the parent object will be applied to the table.
Display screen
Specifies the fields that you want to display in the table.
Resources
Lists all the available data resources.
Display Fields
Lists the fields that have been selected to display in the table.
Display Name
Shows the display names of the selected fields. You can double-click the name cells to edit them if required.
Sort Fields By
Opens the Sort Fields By dialog to specify how to sort data in the table.
Group screen
Specifies the fields that you want to use to group the data.
Resources
Lists all the available data resources.
Ascend
Groups will be sorted in an ascending order (A, B, C).
Descend
Groups will be sorted in a descending order (C, B, A).
No Sort
Groups will be sorted in the original order in database.
Special Group
Opens the User Defined Group dialog to define grouping information.
For example, if you placed a field named Region for grouping, and this field contains all 50 states of the United States; and if
you want to see the data between Maryland (MD) and New York (NY), you can define the criteria by selecting the between
operator to further define your grouping information.
Sort Group By
Opens the Sort Group By dialog to set how groups will be sorted.
Special Function
If the group by field is of Numeric/String/Date/Time type, you can select a special function for the field in the Special Function
column to further specify to which level the data will be grouped by.
If Customize is selected, the Customized Function dialog will be displayed, in which you can set the function by your own.
Sort Group By
Specifies how to sort the groups. Activated only when you have clicked Sort Group By from the Sort column to define the
sorting manner of groups for the selected group level.
Special Group
Specifies how to group your information. Activated only when you have clicked Special Group from the Sort column to define a
special group.
Select N
Opens the Select N dialog to specify the Select N condition.
Group Filter
Opens the Group Filter dialog to specify the group filter condition.
Summary screen
Specifies the fields on which you want to create aggregate functions.
Resources
Lists all the available data resources.
Header
Specifies to put the summary field in the header row. If the summary is calculated on a group by field, it will be put in the
group header row of the corresponding group; if the summary is calculated on the whole dataset, it will be put in the table
header row.
Footer
Specifies to put the summary field in the footer row. If the summary is calculated on a group by field, it will be put in the
group footer row of the corresponding group; if the summary is calculated on the whole dataset, it will be put in the table
footer row.
Column
Works together with the Position option to specify the location where the summary field will be put.
Detail
The summary field will be put in a detail column.
Summary
The summary field will be displayed in a separate summary column.
Filter screen
Specifies to filter data displayed in the table.
Filter
This option is available only when creating a table in a studio report. It lists all the predefined filters of the specified business
view. Select one from the drop-down list to apply, or select User Defined and define a new filter according to your
requirements.
For details about the other options in the screen, see Edit Filter dialog.
Style screen
Specifies the style of the table.
Grow Report
Specifies the layout of the table.
Vertically
Creates a vertical table.
Horizontally
Creates a horizontal table.
Style
Specifies the style of the table.
Preview
Displays the selected layout and style effects.
Inherit Style
Specifies whether to make the table take the style of its parent. Available only when the table is to be inserted into a banded
object.
Related topics:
Crosstab Wizard
This wizard is displayed when you select the Crosstab layout in the New Report dialog or New Report Set dialog and then click
OK, or right-click a crosstab and select Crosstab Wizard from the shortcut menu. It helps you to create or modify a crosstab.
The wizard consists of the following six screens:
Data screen
Display screen
Chart screen
Filter screen
Layout screen
Style screen
Back
Goes back to the previous screen.
Next
Goes to the next screen.
Finish
Finishes creating or modifying the crosstab and closes this wizard.
Cancel
Does not retain changes and closes this wizard.
Help
Displays this help document.
Data screen
The Data screen differs with report type: normal report or studio report.
New
If checked, select a data source from the catalog resources to create a dataset that will be used to build the crosstab. When
you choose to create the dataset from a query, you can click the Modify button to edit the query in the Query Editor if
required.
Existing
If checked, select a dataset from the ones existing in the open report set to create the crosstab. Click the Modify button to
edit the dataset in the Dataset Editor if required.
Current
If checked, the current dataset used by the parent object will be applied to the crosstab.
Display screen
Specifies the fields to display in the crosstab.
Resources
Lists all the available data resources.
Replaces the selected field in the crosstab with the specified field in the Resources panel.
Columns/Rows
Field
Lists the fields that will be displayed on the columns/rows of the crosstab.
Label
Specifies the display names for the selected fields. By default these are blank and no names will be created for the fields to
label the columns/rows. You can double-click the cells to edit them if required.
Color
Specifies the background color of the selected cells.
Summaries
Field
Lists the fields that you select to create summaries.
Aggregate
Specifies the functions used to summarize data of the selected fields.
Label
Specifies the display names for the selected fields. By default these are blank and no names will be created for the fields to
label the summaries. You can double-click the cells to edit them if required.
Comparison Function
Opens the Comparison Function dialog to add a comparison function as an aggregate for the crosstab.
Chart screen
Specifies to create a chart together with the crosstab, which will be placed above the crosstab in the report body. This screen is
available only when you create a crosstab, and when there is at least one field inserted in the columns or rows, and with at
least one summary field in the crosstab.
No Chart
Specifies not to create a chart.
Bar Chart
Specifies to create a Clustered Bar 2-D chart together with the crosstab.
Line Chart
Specifies to create a Line 2-D chart together with the crosstab.
Pie Chart
Specifies to create a Clustered Pie chart together with the crosstab.
Category
Lists the fields that have been added to the columns and rows of the crosstab. Choose the field you want to display on the
category (X) axis of the chart from the drop-down list.
Series
Lists the fields that have been added to the columns and rows of the crosstab. Choose the field you want to display on the
series (Z) axis of the chart from the drop-down list.
Show Values
Lists the fields that have been selected to create summaries in the crosstab. Choose the value you want to display in the chart
from the drop-down list.
Filter screen
Specifies to filter data displayed in the crosstab. This screen is available only when you create a crosstab.
For details about options in the screen, see Edit Filter dialog.
Layout screen
Specifies the layout of the crosstab.
Aggregate
Specifies properties of the aggregate fields.
Vertical Layout
If selected, the aggregate layout will be set vertically.
Horizontal Layout
If selected, the aggregate layout will be set horizontally.
Number of Row(s)
Specifies the number of rows to be displayed in a crosstab. By default, it is -1, which means that there is only one column
with which to arrange the aggregate fields vertically; if it is set to 1, that means there will be only one row to arrange the
aggregate fields horizontally; if it is set to a number larger than 1, that means there will be this number of aggregate
rows; if this number is larger than the number of aggregate fields in the crosstab, it will be treated as -1.
Number of Column(s)
Specifies the number of columns to be displayed in a column. By default, it is -1, which means that there is only one row
with which to arrange the aggregate fields horizontally; if it is set to 1, that means there will be only one column to
arrange the aggregate fields vertically; if it is set to a number larger than 1, that means there will be this number of
aggregate rows; if this number is larger than the number of aggregate fields in the crosstab, it will be treated as -1.
Repeat Aggregate
Assume that you have created a crosstab on the query WorldWideSales in the catalog file SampleReports.cat as follows:
added Products_Product Type ID as the column field, added Customers_Country as the row field, added Quantity and
Discount as the aggregate fields and specified the functions as Sum, and applied the style Classic to the crosstab.
If checked, one cell will contain only one aggregate field value, while for the other aggregate fields, the crosstab will
repeat. The crosstab will be shown as below:
If unchecked, one crosstab cell accommodates the values of all aggregate fields. The crosstab will be shown as below:
Style screen
Specifies the style of the crosstab.
Style
<Custom>
There is no any style information on it and it is only used to cover previous-version report which did not bind any style or the
bound style cannot be found in the style list.
Preview
Displays a diagram illustrating the effect of the selected style on the crosstab.
Inherit Style
Specifies whether to make the crosstab take the style of its parent. This options is available only when you modify a crosstab
and the crosstab is inserted into a banded object.
Page Setup
Opens the Page Setup dialog to specify page properties.
Related topics:
Modifying a crosstab
Name
Lists the names of the properties.
Value
Specifies values for the selected properties.
Important
Specifies whether this property is important or not.
Adds all the properties listed in the All Properties box to apply to the style.
Removes a property that is not required from the Selected Properties box.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Adds the selected buttons in the Available Buttons box into the specified toolbar.
By Intervals
Specifies to group the data by intervals.
Numerical Value
Specifies the intervals of the group.
Within Range
Specifies to group data within certain range. If this option is checked, you need to enter a value as the
range in the Within text box and specify how to apply the range, to increasing data or decreasing data,
by selecting the item from the drop-down list.
First/Last N letters
Specifies the intervals with which to group the report data. N should be an integer no larger than 255.
Case sensitive when grouping
If checked, JReport will distinguish between uppercase and lowercase characters when grouping.
Convert group name to
Specifies how to convert the group name. If Case sensitive when grouping is selected, this option will
be disabled.
Uppercase
Specifies to convert the group names to uppercase.
Lowercase
Specifies to convert the group names to lowercase.
No Conversion
Specifies not to convert any group names.
Specifies to put values that do not fall within the defined interval in a new special group.
Time
Specifies the time which will be applied as the intervals to group data.
The Offset of Time Grouping
Specifies the offset used to grouping the data.
1/1/1970 00:00:00
The default offset defined by JReport.
Customized Value
If checked, you can define your required offset by clicking the calendar button.
Related topics:
Save As
Saves the data buffer information in the specified directory with xml format.
Close
Closes the dialog.
Help
Displays this help document.
Notes:
The value of buffer size shows information of a report's latest successful running.
The values of Records per Page and Maximum Page Number are default if they are not set.
Scale
Divides the value by hundreds, thousands, and so on.
Number
Re-formats the number value (Original example: 123456).
Date/Time
Re-formats the date/time value (Example, Wednesday, December 25, 00:00:00 GMT-08:00 2002).
Text
Mapping
Maps the new value to one or more values.
Format
Lists all the formats of the selected category. For details about each format, see Data Format.
Properties
Specifies the properties for the selected format.
Sample
Displays the selected format effects.
Stack
Lists all the formats that you selected from different categories.
Add
Adds a format to the Stack box.
Remove
Removes a format from the Stack box.
Apply
Applies the specified format to the tick mark labels.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
File Name
Displays the file name of the current data mapping file that will be edited.
Language
Displays the language that is selected for the current data mapping file.
New
Opens the Create Data Mapping File dialog to generate a new data mapping file to save language
information.
Load
Loads an existing data mapping file from a specific directory.
Import Key
Opens the Import Key dialog to add values into this data mapping file from catalog resources. Only the
DBFields can be added by this way.
Adds a row to specify a value and its mapped value in another language.
Related topics:
Data tab
Filter tab
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Data tab
Adds some extra data fields to the dataset or removes some existing data fields from the dataset.
Available Resource
Lists all the available data fields contained in the data source on which the dataset is created.
Dataset
Lists all the data fields contained in the dataset.
Filter tab
Sets some conditions to filter the data of the dataset.
Add Condition
Adds a new condition line.
Delete
Deletes the selected condition line.
Group
Makes the selected conditions in one group. Conditions can also be added to an existing group by
selecting the conditions and the group while holding the Ctrl button, and then clicking the Group button.
Ungroup
Makes the selected condition ungrouped.
Up
Moves the selected condition up to a higher level.
Down
Moves the selected condition or group down to a lower level.
Logic
Lists the logic operator.
And
Logic operator And which is applied to this and the next line.
Or
Logic operator Or which is applied to this and the next line.
And Not
Logic operator And Not which is applied to this and the next line.
Or Not
Logic operator Or Not which is applied to this and the next line.
Field
Specifies the field to be filtered.
Operator
Specifies the operator to compose the filter expression.
=
Equal to
>
Greater than
>=
Greater than or equal to
<
Less than
<=
Less than or equal to
!=
Not equal to
[not ]in
Causes an enumerated list of values which will appear in the WHERE clause predicate to be evaluated
for a true condition.
Value
Specifies the value of how to filter the field. You can either type in the value manually or click
next
to specify the value, the Expressions dialog is displayed. The following are options
+
Adds numbers or fields together.
Subtracts numbers or fields together.
*
Multiplies numbers or fields together.
/
Divides numbers or fields together.
=
Equates fields together.
"
Places quotations on long character strings or name that have blanks in them. For example, you
should place quotes on values such as "New York" or "Washington DC".
||
Places fields together in the same expression. For example, "New York" || "Washington DC".
()
Places the fields in parentheses.
SQL Statement
Displays the SQL statement of the filter condition.
selecting the conditions and the group while holding the Ctrl button, and then clicking the Group button.
Ungroup
Makes the selected condition ungrouped.
Up
Moves the selected condition up to a higher level.
Down
Moves the selected condition or group down to a lower level.
Logic
Lists the logic operator.
And
Logic operator And which is applied to this and the next line.
Or
Logic operator Or which is applied to this and the next line.
And Not
Logic operator And Not which is applied to this and the next line.
Or Not
Logic operator Or Not which is applied to this and the next line.
Field
Specifies the field to be filtered.
Operator
Specifies the operator to compose the filter expression.
=
Equal to
>
Greater than
>=
Greater than or equal to
<
Less than
<=
Less than or equal to
!=
Not equal to
[not] in
Causes an enumerated list of values which will appear in the WHERE clause predicate to be evaluated
for a true condition. The [not] in operator supports multi-value parameters as the value.
[not] like
Like string pattern matching operator is used to compare the first expression string value to the
pattern string (the second expression). If you want to use wildcard character in the pattern string,
only "_" and "%" are supported.
[not] between
Allows the system to evaluate whether or not data values are located between a range of values
indicated in the predicate. For operator between' or not between', there are two value input boxes
for inputting the same type of values.
is [not] null
It is used in WHERE clause predicates to match null values occurring in a specified data field. For
operator is null' or is not null', the value input box is hidden.
Value
Specifies the value of how to filter the field. You can either type in the value manually or click
to the text box to specify the value.
next
When you type in the value, if multiple values are required, they should be separated with ",", and if ","
or "\" is contained in the values, write it as "\," or "\\".
When you click
in the dialog:
to specify the value, the Expressions dialog is displayed. The following are options
+
Adds numbers or fields together.
Subtracts numbers or fields together.
*
Multiplies numbers or fields together.
/
Divides numbers or fields together.
=
Equates fields together.
"
Places quotations on long character strings or name that have blanks in them. For example, you
should place quotes on values such as "New York" or "Washington DC".
||
Places fields together in the same expression. For example, "New York" || "Washington DC".
()
Places the fields in parentheses.
Name
Shows the name of the dataset.
Data Source
Shows the data source in which the dataset is located.
Query
Shows the query that the dataset is based on.
Add
Opens the New Dataset dialog to add a new dataset to the report set.
Remove
Removes the specified dataset from the report set.
Optimize Dataset
Opens the Optimize Dataset dialog to optimize the selected dataset.
Data tab
Modifies fields in a specified dataset.
Available Resource
Lists all the available resources in the query which the dataset based on.
Dataset
Lists all the fields that are included in the dataset.
Filter tab
Sets filter conditions for data in a dataset. For details about options in the tab, see Dataset Filter dialog.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Apply
Related topics:
Managing datasets
Help
Displays this help document.
Related topics:
Driver Name
Specifies the name of the data source driver.
URL
Specifies the URL of the driver definition.
The URL is composed of three parts: scheme, qualified class name and arguments. If the Data Source
Driver does not use argument, the argument part will not appear on the URL. Its syntax is: URL =
"jrquery" ":" "/" qualified_classname[ ";" params]
Driver
Specifies the driver configuration.
Scheme
Specifies the scheme of the driver. Presently only "jrquery" is available.
Class Name
Specifies the qualified class name.
Parameters
Specifies the arguments for the Data Source Driver. In the parameters field, the arguments should
The DHTML format allows you to export your report set to a DHTML result that can be viewed in a
JReport DHTML window. Some reports cannot be published to version in a DHTML result format, such
as self-contained (CLX) reports, multi-level nested master and subreports, reports containing data
objects, and reports developed from a dynamic query or hierarchical data source (HDS).
The following are details about options in the dialog:
Resolution
Specifies the resolution of the DHTML result to zoom in/out, in DPI. The default value is obtained from
the operation system, which is the resolution of your monitor, for example, 72 DPI on Unix or 96 on
Windows. You can set higher/lower value to zoom in/out.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Decimal
Specifies the scale of the fractional data in the report. For instance, if you set Decimal to 3, then all the
property values of the objects in the Report Inspector will be rounded to the thousandth.
Unit
Specifies the unit of the measure to use in the report properties. It can either be centimeter or inch.
Resolution
Specifies the resolution in dots per inch. When it is Default, it will be the resolution of your monitor.
OK
Accepts all changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Text
Image
Barcode
Rank
Text Field
Hidden Filed
Text Area
Checkbox
Radio button
Image Button
Button
List
Drop-down List
Note: The two display types - List and Drop-down List are only available when the field is a parameter
field.
Related topics:
Text
The following are details about options for this display type.
Tool Tip
Specifies the tooltip of the image, which will be shown when you hover the mouse over the text after the
report is exported to HTML or DHTML.
If you want to use a formula to control the tooltip, click
and select a formula from the drop-down list.
If the given formulas cannot meet your requirements, click <CREATE FORMULA> to create one.
Web Behaviors
Specifies some web behaviors to the text.
Opens the Web Action List dialog to bind some web action to the event.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Image
The following are details about options for this display type.
Source
Specifies the source of the image.
From URL
Specifies to use an image from a URL. You can click the Browse button to specify the path or input the
URL directly in the text field. These types of images are supported: GIF, BMP, JPG, and PNG.
From DBField
For a DBField, formula, or a summary, you can check this option to make the value of the DBField/
formula/summary the image source.
Decode Type
Specifies the type for decoding the image. It can be GIF or JPG, BMP, PNG, AUTODETECT (this is to
detect an image type saved in the database automatically).
Name
Specifies the name of the image.
Alternate Text
Specifies the alternate text of the image, which will be shown when the image cannot be displayed.
Tool Tip
Specifies the tooltip of the image, which will be shown when you hover the mouse over the image after
the report is exported to HTML or DHTML.
Indicates the value of the option can be controlled by a formula. Click this button and select a formula
from the drop-down list. If the given formulas cannot meet your requirements, click <CREATE FORMULA>
to create one.
Size
Specifies the size of the image.
Original Size
Specifies whether to use the original size of the image.
Scaling Mode
Specifies the scaling mode of the image. There are five types available for you:
actual size
If selected, the image will be shown in its actual size.
fit image
If selected, the image will be scaled to be wholly shown.
fit width
If selected, the image will be scaled to fit the width of the image viewer.
fit height
If selected, the image will be scaled to fit the height of the image viewer.
customize
If selected, the image will be scaled according to the width and height that you specify in the Width
and Height fields.
Max Ratio
Specifies the maximum scaling ratio of the image. By default the scaling ratio of the image is not
limited. If it is set to any value greater than 0, the actual scaling ratio will be less than or equal to it.
Rotation
Specifies the angle, at which to rotate the image, in degrees. The following is the meaning of different
values:
0 - No rotation.
which may result in that the image exceeds the field border and therefore the parts that extend
outside of the border will be cut off.
Constrain Proportion
If checked, when you set the display width or height of the image, the other will be adjusted
accordingly based on the image's width-to-height ratio.
Width
Specifies the new display width of the image.
Height
Specifies the new display height of the image.
Web Behaviors
Specifies some web behaviors to the image.
Opens the Web Action List dialog to bind some web action to the event.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Barcode
The following are details about options for this display type.
Symbology
Specifies the barcode type.
Tool Tip
Specifies the tooltip of the barcode, which will be shown when you hover the mouse over the barcode
after the report is exported to HTML or DHTML.
and select a formula from the drop-down list.
If you want to use a formula to control the tooltip, click
If the given formulas cannot meet your requirements, click <CREATE FORMULA> to create one.
Scale Mode
Specifies the unit for the values of Quiet Zone, Narrow Width, Supplement, Height and Ratio.
Quiet Zone
Specifies the space around the barcode.
Default Message
Specifies the default value for the barcode, which will be used for the barcode in design mode.
Supplement
Specifies the supplement for the barcode. The barcode types, Code 39, Code 128/128A/128B/128C and
Codabar, don't have supplements.
Use Default Massage
If checked, the value you specify in the Default Message field will be used as the barcode value when you
view the report result. Otherwise, the value will only be used in design mode.
Enable Checking Digits
Specifies whether to include check digits in the barcode.
Display HR
Specifies whether to display the barcode numbers together with the barcode. Enabled only for Code 39,
Code 128/128A/128B/128C and Codabar.
Size
Specifies the size of the barcode.
Narrow Width
Specifies the width between the barcode bars.
Ratio
Specifies the width ratio of the thick bar to the thin bar in the CODE39/Codabar barcode. The Ratio box
can have only 2 effective values, 2.0 and 3.0, any ratio values are not equal to 2.0 or 3.0 will be
granted as 2.0. Enabled only for CODE39 and Codabar.
Height
Specifies the height for the bars of the barcode.
Orientation
Specifies the orientation for the barcode.
Preview
Displays the format of the selected symbology.
Web Behaviors
Specifies some web behaviors to the barcode.
Opens the Web Action List dialog to bind some web action to the event.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Rank
The following are details about options for this display type.
Indicates the value of the option can be controlled by a formula. Click this button and select a formula
from the drop-down list. If the given formulas cannot meet your requirements, click <CREATE FORMULA>
to create one.
Default Image Rotation
Specifies the default image's rotation angle, in degrees. The following is the meaning of different values:
0 - No rotation.
Note: When rotating an image, the rectangle that holds the image maintains its original size, which may
result in that the image exceeds the field border and therefore the parts that extend outside of the border
will be cut off.
Value Range
Specifies the value ranges.
Web Behaviors
Opens the Web Action List dialog to bind some web action to the event.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Text Field
The following are details about options for this display type.
Type
Specifies the type of the text field.
Standard
Specifies that the text field is a standard text field.
Password
Specifies that the text field is a password text field, which means that the value input in the text field
will be hidden using asterisks.
Name
Indicates the value of the option can be controlled by a formula. Click this button and select a formula
from the drop-down list. If the given formulas cannot meet your requirements, click <CREATE FORMULA>
to create one.
Display Width
Specifies the display width of the text field.
Max Length
Specifies the maximum length of the string that is allowed in the text field.
Read Only
Specifies whether to make the field read-only to others.
Disabled
Specifies whether the text field is disabled or enabled.
Web Behaviors
Specifies some web behaviors to the text field.
Opens the Web Action List dialog to bind some web action to the event.
OK
Applies the changes and closes the dialog.
Cancel
Hidden Field
The following are details about options for this display type.
Name
Specifies the name of the hidden field.
Value
Specifies the value of the hidden field.
Indicates the value of the option can be controlled by a formula. Click this button and select a formula
from the drop-down list. If the given formulas cannot meet your requirements, click <CREATE FORMULA>
to create one.
Web Behaviors
Specifies some web behaviors to the hidden field.
Opens the Web Action List dialog to bind some web action to the event.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Text Area
The following are details about options for this display type.
Name
Specifies the name of the text area.
Value
Specifies the value of the text area.
Tool Tip
Specifies the tooltip of the text area, which will be shown when you hover the mouse over the text area
after the report is exported to HTML or DHTML.
Display Width
Specifies the display width of the text area.
Number of Lines
Specifies the number of lines that is allowed in the text area.
Auto Wrap
Specifies whether to wrap the text in the text area.
Indicates the value of the option can be controlled by a formula. Click this button and select a formula
from the drop-down list. If the given formulas cannot meet your requirements, click <CREATE FORMULA>
to create one.
Read Only
Specifies whether to make the text area read-only to others.
Disabled
Specifies whether the text area is disabled or enabled.
Web Behaviors
Specifies some web behaviors to the text area.
Opens the Web Action List dialog to bind some web action to the event.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Checkbox
The following are details about options for this display type.
Name
Specifies the name of checkbox.
Value
Specifies the value of the checkbox.
Tool Tip
Specifies the tooltip of the checkbox, which will be shown when you hover the mouse over the checkbox
after the report is exported to HTML or DHTML.
Initially Checked
Specifies whether or not the checkbox is selected by default.
Indicates the value of the option can be controlled by a formula. Click this button and select a formula
from the drop-down list. If the given formulas cannot meet your requirements, click <CREATE FORMULA>
to create one.
Disabled
Specifies whether the checkbox is enabled or disabled.
Web Behaviors
Specifies some web behaviors to the checkbox.
Opens the Web Action List dialog to bind some web action to the event.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Radio Button
The following are details about options for this display type.
Name
Specifies the name of radio button.
Value
Specifies the value of the radio button.
Tool Tip
Specifies the tooltip of the radio button, which will be shown when you hover the mouse over the radio
button after the report is exported to HTML or DHTML.
Initially Checked
Specifies whether or not the radio button is selected by default.
Indicates the value of the option can be controlled by a formula. Click this button and select a formula
from the drop-down list. If the given formulas cannot meet your requirements, click <CREATE FORMULA>
to create one.
Disabled
Specifies whether the radio button is enabled or disabled.
Web Behaviors
Specifies some web behaviors to the radio button.
Opens the Web Action List dialog to bind some web action to the event.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Image Button
The following are details about options for this display type.
Source
Specifies the source of the image button.
From URL
Specifies to use an image from a URL. You can click the Browse button to specify the path or input the
URL directly in the text field. These types of images are supported: GIF, BMP, JPG, and PNG.
From DBField
For a DBField, formula, or a summary, you can check this option to make the value of the DBField/
formula/summary the image source.
Decode Type
Specifies the type for decoding the image. It can be GIF or JPG, BITMAP, AUTODETECT (this is to
detect an image type saved in the database automatically).
Name
Specifies the name of the image button.
Value
Specifies the value of the image button.
Alternate Text
Specifies the alternate text of the image, which will be shown when the image cannot be displayed.
Tool Tip
Specifies the tooltip of the image button, which will be shown when you hover the mouse over the image
button after the report is exported to HTML or DHTML.
Indicates the value of the option can be controlled by a formula. Click this button and select a formula
from the drop-down list. If the given formulas cannot meet your requirements, click <CREATE FORMULA>
to create one.
Disabled
Specifies whether the image button is disabled or enabled.
Size
Specifies the size of the image.
Original Size
Specifies whether to use the original size of the image.
Scaling Mode
Specifies the scaling mode of the image. There are five types available for you:
actual size
If selected, the image will be shown in its actual size.
fit image
If selected, the image will be scaled to be wholly shown.
fit width
If selected, the image will be scaled to fit the width of the image viewer.
fit height
If selected, the image will be scaled to fit the height of the image viewer.
customize
If selected, the image will be scaled according to the width and height that you specify in the Width
and Height fields.
Max Ratio
Specifies the maximum scaling ratio of the image. By default the scaling ratio of the image is not
limited. If it is set to any value greater than 0, the actual scaling ratio will be less than or equal to it.
Constrain Proportion
If checked, when you set the width or height of the image, the other will be adjusted accordingly based
on the image's width-to-height ratio.
Width
Specifies the new display width of the image.
Height
Specifies the new display height of the image.
Web Behaviors
Specifies some web behaviors to the image button.
Opens the Web Action List dialog to bind some web action to the event.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Button
The following are details about options for this display type.
Name
Specifies the name of the button.
Value
Specifies the value of the button.
Tool Tip
Specifies the tooltip of the button, which will be shown when you hover the mouse over the button after
the report is exported to HTML or DHTML.
Indicates the value of the option can be controlled by a formula. Click this button and select a formula
from the drop-down list. If the given formulas cannot meet your requirements, click <CREATE FORMULA>
to create one.
Action
Specifies the default action that will happen when the button is clicked.
None
Specifies that no default action happens when the button is clicked.
Submit Form
Specifies that the default action of the button is to submit a form.
Reset Form
Specifies that the default action of the button is to reset a form.
Disabled
Specifies whether the button is disabled or enabled.
Web Behaviors
Specifies some web behaviors to the button.
Opens the Web Action List dialog to bind some web action to the event.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
List
The following are details about options for this display type.
Name
Specifies the name of the list.
Tool Tip
Specifies the tooltip of the list, which will be shown when you hover the mouse over the list after the
report is exported to HTML or DHTML.
Opens the Insert Fields dialog to add field to control the value.
Selected
Specifies the value that will be selected in the list by default.
Indicates the value of the option can be controlled by a formula. Click this button and select a formula
from the drop-down list. If the given formulas cannot meet your requirements, click <CREATE FORMULA>
to create one.
Allow Multiple Selections
Specifies whether to allow selecting multiple items in the list at the same time.
Use Runtime Value
When changing the display type of a parameter to list, you can check this option to use the runtime value
as the selected value of the list.
Disabled
Specifies whether the list is disabled or enabled.
Web Behaviors
Specifies some web behaviors to the list.
Events
Specifies the trigger event.
Actions
Specifies the web action you want the event to trigger.
Opens the Web Action List dialog to bind some web action to the event.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Drop-down List
The following are details about options for this display type.
Name
Specifies the name of the drop-down list.
Tool Tip
Specifies the tooltip of the drop-down list, which will be shown when you hover the mouse over the dropdown list after the report is exported to HTML or DHTML.
Opens the Insert Fields dialog to add field to control the value.
Selected
Specifies the value that will be selected in the drop-down list by default.
Indicates the value of the option can be controlled by a formula. Click this button and select a formula
from the drop-down list. If the given formulas cannot meet your requirements, click <CREATE FORMULA>
to create one.
Use Runtime Value
When changing the display type of a parameter to drop-down list, you can check this option to use the
runtime value as the selected value of the drop-down list.
Disabled
Specifies whether the drop-down list is disabled or enabled.
Web Behaviors
Specifies some web behaviors to the drop-down list.
Actions
Specifies the web action you want the event to trigger.
Opens the Web Action List dialog to bind some web action to the event.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Name
Displays the resource names.
Size
Displays the file size.
Type
Displays the file type.
Version Date
Displays the latest version date of the resources.
Description
Shows other necessary descriptions of the resources if any.
Has Read Permission
Shows whether you have the Read permission on the resources. You can only download resources on
which you have the Read permission from JReport Server.
Tips:
Except for the Name column, you can specify whether or not to show the other columns in this panel
by right-clicking on any column header and then checking/unchecking the corresponding items on
the shortcut menu.
You can sort the resources by name, size, type, etc by clicking on the corresponding column header.
Download Resource To
Specifies the directory to which the resources will be downloaded. By default, the path of the currently
opened catalog is shown here. You can click the Browse button to find another directory.
OK
Applies the changes and downloads the resources from JReport Server to the specified directory.
Cancel
Closes the dialog, leaving any changes unsaved.
Help
Displays this help document.
Related topics:
Aggregation Name
Specifies the name of the aggregation.
Mapping Name
Specifies the mapping name of the field to which the aggregation is mapped. Click
field.
Aggregate
Specifies the function for the aggregation.
OK
Edits the aggregation and closes the dialog.
Cancel
Cancels the editing and closes the dialog.
Help
Displays this help document.
to select the
Group
Makes the selected conditions in a group. Conditions can also be added to an existing group by selecting
the conditions and the group while holding the Ctrl button, and then clicking the Group button.
Ungroup
Makes the selected condition ungrouped.
Up
Moves the selected condition or group up to a higher level.
Down
Moves the selected condition or group down to a lower level.
Logic
Lists the logic operator.
And
Logic operator And which is applied to this and the next line.
Or
Logic operator Or which is applied to this and the next line.
And Not
Logic operator And Not which is applied to this and the next line.
Or Not
Logic operator Or Not which is applied to this and the next line.
Field
Specifies the field on which the condition is based.
Operator
Specifies the operator to compose the condition expression.
=
Equal to
>
Greater than
>=
Greater than or equal to
<
Less than
<=
Less than or equal to
!=
Not equal to
Value
Specifies the value of how to build the condition.
If you are editing conditional formatting to a field, you can either type in the value manually or select
the value from the drop-down list, where the top 50 values of the selected field are listed.
If you are editing conditional formatting to map areas, type in the value manually or click the button
next to the value text box to specify the value.
Condition Expression
Displays the condition expression.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
General tab
Security tab
General tab
Sets properties for the cube element.
Name
Specifies the name of the cube element.
Display Name
Specifies the display name of the cube element which is intuitive to the end user.
Mapping Name
Specifies the mapping name of the field to which the cube element is mapped. Click
field.
to select the
Type
Specifies the type of the cube element.
Dimension
Dimensions are the cube elements that will become the basis for analyzing data in a report.
Dimensions characteristically return text data or dates.
Measure
Measures are numeric cube elements that are calculated at the time the report is ran. The values
they return are dependent on the dimension objects which they are used with. For example you may
want a sales total by year.
Detail Info
Detail information provides additional information. It can be bound to dimension, measure or
category. Detail information is not used for analysis but is useful to have.
Aggregate Function
Available only when the cube element is a measure object. It specifies the function for the measure
object.
Tip
Specifies the tooltip of the cube element which will be shown when you hover the mouse pointer over
the element in the Resource View panel of JReport Viewer.
Description
Specifies the description of the cube element which will be shown after the tooltip when you hover the
mouse pointer over the element in the Resource View panel of JReport Viewer.
Security tab
Specifies principals' permissions for the cube element.
Role tab
Lists all the roles for the security policy.
Role Name
Displays role names.
Visible
Specifies whether or not the cube element is visible for the roles.
Group tab
Lists all the groups for the security policy.
Group Name
Displays group names.
Visible
Specifies whether or not the cube element is visible for the groups.
User tab
Lists all the users for the security policy.
User Name
Displays user names.
Visible
Specifies whether or not the cube element is visible for the users.
Security Configuration
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Related topics:
If the dialog is opened by clicking the Advanced button in the Edit DHTML Display Name dialog, in the drop-down list, all the data
components in current report set will be listed.
If the dialog is opened by clicking DHTML Display Name on the shortcut menu of a data container in the design area, only the
specified component will be listed in this drop-down list.
Resource Name
Displays the names of fields in the selected component.
Display Name
Shows the display names for fields in the selected component.
Action columns
Indicates whether the actions are enabled for the fields. When an action is enabled for a field, the field's display name instead of the
mapping name will be shown in the corresponding dialog or sub menu in JReport Viewer; when not enabled, end users will not be
able to perform this action on the field in JReport Viewer. If the display name of any field is set to be blank, the field will not be
available for any of the actions below. Check the box on the column header to enable the corresponding action on all fields.
Sort
Specifies whether to enable the Sort action on the fields. The Sort column is disabled when the selected component is a crosstab
or chart.
Filter
Specifies whether to enable the Filter action on the fields.
Go
Specifies whether to enable the Go action on the fields. The Go column is disabled when the selected component is a crosstab.
Search
Specifies whether to enable the Search action on the fields. The Search column is disabled when the selected component is a
crosstab or chart.
Sort in Group
For a grouped banded object or table, end users can also choose to sort the groups at certain group level based on a specified
field in each group in JReport Viewer. Here you can decide whether to enable this Sort in Group action on the fields by checking
Related topics:
Group
Makes the selected conditions in a group. Conditions can also be added to an existing group by selecting the
conditions and the group while holding the Ctrl button, and then clicking the Group button.
Ungroup
Makes the selected condition ungrouped.
Up
Moves the selected condition or group up to a higher level.
Down
Moves the selected condition or group down to a lower level.
Logic
Lists the logic operator.
And
Logic operator And which is applied to this and the next line.
Or
Logic operator Or which is applied to this and the next line.
And Not
Logic operator And Not which is applied to this and the next line.
Or Not
Logic operator Or Not which is applied to this and the next line.
Field
Specifies the field on which the condition is set.
Operator
Specifies the operator to compose the filter expression.
=
Equal to
>=
Greater than or equal to
>
Greater than
<
Less than
<=
Less than or equal to
!=
Not equal to
[not] in
Causes an enumerated list of values to appear in the WHERE clause predicate, used for evaluating for a
true condition. For operator in' or not in', it is allowed to input multiple values in the Value input box and
separate the values with comma (,).
[not] like
Like string pattern matching operator is used to compare the first expression string value to the pattern
string (the second expression). If you want to use wildcard character in the pattern string, only "_" and
"%" are supported.
[not] between
Allows the system to evaluate whether or not data values are located between a range of values indicated
in the predicate. For operator between' or not between', there are two value input boxes for inputting the
same type of values.
is [not] null
It is used in WHERE clause predicates to match null values occurring in a specified data field. For operator
is null' or is not null', the value input box is hidden.
Value
Specifies the value of how to filter the field. When you type in the value manually, if multiple values are
required, they should be separated with ",", and if "," or "\" is contained in the values, write it as "\," or "\\".
SQL Statement
Displays the SQL statement of the filter expressions.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
When the HDS you are to edit is a general HDS, this dialog displays
Class Name
Specifies the name of the entrance class that implements the HDS APIs. The class should be in the
class path in the system environment.
Parameter
Specifies the parameter string that is required by the class, if any. The parameter string must match
the format defined in the HDS class.
Structure
Shows the structure of the hierarchical data source.
Columns
Specifies the column settings.
Element
Displays the column name in the selected node of table.
Selected
Specifies whether to import the column into the catalog.
Format
Specifies the format in which the column values are to be displayed in the report result. Varies for
different types of data, and can be manually defined.
Type
Specifies the data type of the column.
Precision
Specifies the precision of the column's values. The larger the precision is, the more memory it might
take, however, the more accurate values you will get.
Scale
Specifies the number of digits to the right of the decimal point for the column's values.
Nullable
Specifies whether the column is nullable. You have three options to choose: Nullable, No Nulls and
Nullable Unknown.
Currency
Specifies whether to use the Currency type for this column or not
Array
Specifies whether to use the Array type for this column or not.
Load Tree
Parses and loads data tree from the external data source file. The structure is shown in the Structure
panel after you click this button.
OK
Applies all changes here and close the dialog.
Cancel
Does not retain changes and closes the dialog.
Help
Displays this help document.
When the HDS you are to edit is an XML HDS, this dialog displays
XML URI
Specifies the location of the external XML format data source. Can be a local path or a web url. Click
Browse to find the file on the local disk.
XSD URI
Specifies the location of the schema file for the XML format data source. Can be a local path or a web
url. Click Browse to find the file on the local disk.
Root Name
Indicates the HDS root, starting from which JReport Designer imports the data.
Structure
Shows the structure of the hierarchical data source.
Columns
Specifies the column settings.
Element
Displays the column name in the selected node of table.
Selected
Specifies whether to import the column into the catalog.
Format
Specifies the format in which the column values are to be displayed in the report result. Varies for
different types of data, and can be manually defined.
Type
Specifies the data type of the column.
Precision
Specifies the precision of the column's values. The larger the precision is, the more memory it might
take, however, the more accurate values you will get.
Scale
Specifies the number of digits to the right of the decimal point for the column's values.
Nullable
Specifies whether the column is nullable. You have three options to choose: Nullable, No Nulls and
Nullable Unknown.
Currency
Specifies whether to use the Currency type for this column or not
Array
Specifies whether to use the Array type for this column or not.
Load Tree
Parses and loads data tree from the external data source file. The structure is shown in the Structure
panel after you click this button.
OK
Applies all changes here and closes the dialog.
Cancel
Does not retain changes and closes the dialog.
Help
Displays this help document.
Service Name
Displays the service name you have selected to create the table.
Operation Name
Displays the selected operation name.
Time Out
Specifies how long to wait for the operation to complete.
Input Message
Lists the input message information for the selected operation.
Value
Specifies the value for the input message.
OK
Accepts the editing operation result and closes the dialog.
Cancel
Cancels the editing operation process and exists the dialog.
Help
Displays this help document.
Type-in Parameter
If selected, you can predefine parameter values by typing manually.
Bind with Single Column
If selected, the parameter will be bound with a DBField. The values of the DBField will be retrieved as the
parameter values at runtime.
Value Type
Specifies the data type of the parameter.
Values
The section after Value Type varies with the type you select from the Value Setting drop-down list.
For Type-in Parameter
Value List
Lists the predefined parameter values.
Prompt Values [format hint]
Predefines the parameter values. The [format hint] shows what the predefined values should look like.
There can be more than one prompt value. All the prompt values must be of the same type as specified in
the Value Type field.
Adds a new prompt value to the list. Double-click in the value line to edit the value.
JReport provides such a mechanism that links each field value of Display Column with the exact value of
Bind Column. When you select the field value from Display Column, the field value of Bind Column is
actually sent to the query and filters the query result. It helps you to bind the parameter to a DBField
(column) in order to provide a list of DBField values for users to select at runtime. The selected value of the
bound DBField will be used as the parameter value. Additionally, instead of displaying the values of the
bound one, you can also choose to display values of other DBField, which probably makes more sense to the
report end users. For example, it might be confusing if you provide a list of customer ID numbers for users
to select at runtime, since the ID numbers could probably mean nothing to them. In cases like this, it is
wise for you to display values of other fields, which could probably make more sense. For this case, you
might prefer to display customer names instead of ID numbers. When the report end users select a
customer name from the list, its ID number is passed to the query as the parameter value so that the
search criteria can be fulfilled. So, before the report with a parameter bound to a DBField is processed, a
query statement will be executed first to retrieve the values of the bound field and display field.
Source
Specifies the data source type from which to retrieve the columns which can be used to bind with the
parameter. The available data source types are tables and views, stored procedures, imported SQLs, and
user defined data sources.
Bind Column
Specifies the DBField to be bound with the parameter.
Display Column
When viewing a report which contains the parameter, the field values related to the column name you
selected in the drop-down list of Display Column will be displayed in the Enter Parameter Values dialog at
runtime.
For Bind with Cascading Columns
Data Source
Specifies the data source from which to retrieve the columns which can be used to bind with the
parameters. The available data source types are tables, views, stored procedures, imported SQLs, and
user defined data sources.
Value List
Defines a group of cascading parameters.
Options
Specifies options for the parameter. The options vary with the type you select from the Value Setting dropdown list.
Prompt Text
Specifies the text for prompting users to provide the value of the parameter.
Tips:
To help users avoid typing a value out of range, you can add the value range to the end of the prompt
text. For example, "Type a customer ID (1~100):".
To help users avoid typing a value in a wrong pattern, you can add the value pattern to the end of the
prompt text. For example, "Type an order date (MMM-dd-yy):".
Minimum Value/Length
Specifies the minimum value allowed for the parameter. If the parameter value type is String, this option is
defined as Minimum Length, which means that you can set the minimum allowed length of the string.
Maximum Value/Length
Specifies the maximum value allowed for the parameter. If the parameter value type is string, this option is
defined as Maximum Length, which means that you can set the maximum allowed length of the string.
String Encoding
Specifies the encoding for the parameter. Available only when the parameter's data type is defined as String.
User Defined Format
For certain types of parameters, the value format supplied by JReport may not satisfy your requirement. In
this case, you can define your own preferred format. When you have defined the value format, all the
values you supply at runtime should be based on it. Otherwise there will be an error message. For details,
see User-defined format for parameters.
Notes:
The letters that stand for the user defined format should follow the JDK standard. In addition, the
user defined format only limits the format of the input value, which does not mean that the display
value will be in the same format. To change the display format, you will need to specify the Format
property of this parameter in the Report Inspector.
The user defined format will show different appearance under different locale, and you need input
values according to the displayed format. For example, under the Spanish or French locale, ####.
## will be displayed as #0,## and you should follow #0,## to input values.
Required
If set to true, the parameter will be treated as a required parameter. A required parameter must be fulfilled,
which means that you must supply a value in the Enter Parameter Values dialog before the report can be
run. If set to false, the parameter will be treated as an optional parameter. An optional parameter can be
left blank, which means you can either type a value, or leave it as it is.
In the Enter Parameters Value dialog, the prompt text of a required parameter will be marked with a * sign.
Note: If the parameter is optional and you do not expect it to take effect in your report, in the Enter
Parameter Values dialog, clear the content in the value field. Otherwise, any value left in the field will
function in reports.
If set to true, when the value of the parameter is blank, the current date time in your system will be used
as value of the parameter. Available only when the parameter's data type is defined as Date, Time or
DateTime.
If the type of the parameter is set to Date, Time or DateTime, you can choose whether to get parameter
value dynamically from the system's date time by enabling one of the above options - Use Current or Use
Current When Blank. However, if you want to use this feature, you need to make sure your system's
DateTime format is set to yyyy-MM-dd H:mm:ss as it is the only format JReport supports; otherwise, you
need to make use of the User Defined Parameter Format feature. Also, if one of the two options is enabled,
you need to provide the parameter's prompt value according to the data type of your parameter.
When the data type of the parameter is Date, you can specify the value according to the format yyyy-MMdd.
When the data type of the parameter is Time, you can specify the value according to the format H:mm:
ss.
When the data type of the parameter is DateTime, specify the value in a combination of the above.
Note: If you have made changes to the SQL statement, the later changes for Bind Column and Display
Column will not take effect unless you remove the SQL lines or bind the parameter all over again. To
remove the SQL lines, click
in the value cell and clear the content in the Import SQL dialog.
Adopt directly
The typed value will be used directly.
Use default
The default value defined when creating the parameter will be used.
Warn
Displays a warning message telling that "Value xxx is out of the available value list".
Note: For a multi-value parameter, if one of the input values is not in the value list, the whole input
result will be treated as out of range.
OK
Applies all changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Fields
Lists all fields that are available to be sorted on.
Adds the selected fields in the Fields box to the Sort By box.
Sort By
Lists the fields that are selected. Report data will be sorted according to the sort by fields you selected.
Direction
Specifies the sort order of the specified field.
Name
Displays the field name.
Moves the selected field up one step. The order of the sort by fields determines the order in which the
report data will be sorted.
Moves the selected field down one step.
Filter tab
Defines the filtering conditions. For details about options in the tab, see Edit Filter dialog.
Edit DHTML Display Name
Opens the Edit DHTML Display Name dialog to add or remove display name fields.
OK
Accepts the changes you've made and closes this dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Related topics:
Style Name
Specifies the name of the new style.
Style Type
Specifies the type of the new style.
Description
Specifies the description of the new style.
OK
Creates a new style in this style group.
Cancel
Cancels creating a new style.
To specify the sum on field, highlight it in the Resource box and then click
On to add it to the field box.
next to Summary
Static Summary
If selected, the summary will take effect on a specific group that you define in the Group By field and it
can only be inserted into the group.
Group By
Specifies the field used to group the data.
To specify the group by field, highlight it in the Resource box and then click
By to add it to the field box.
next to Group
Dynamic Summary
If selected, the summary will be take effect on the group according to the number, which is specified in
the Group By field and it can be inserted into any banded panels of a component.
Group By
Specifies on which group the summary will take effect.
To specify the group level, first select Up or Down from the drop-down list, then in the combo box,
select a value or input an integer, which should be between 0 to 127, to specify the group on which
the summary will take effect. For example, if you select Up or Down and input 0 in the combo box
and insert this summary into any group, the summary will take effect on this group; if you select Up
and input 1 and insert this summary to a group, the summary will take effect on the group higher
than the group where the summary is inserted, and if you specify Down and 1, it will take effect on
the lower group; and the rest may be deduced by analogy.
Notes:
If the dynamic summary is to be used in a chart, when defining the summary, you must
choose Down from the Group By drop-down list; if it is to be inserted to other data containers,
the summary must be defined on Up level.
When you insert a dynamic summary into a report and there is no corresponding group level
to match settings of the dynamic summary, an error message will be generated.
Special Function
If the group by field is of Numeric/String/Date/Time type, you can select a special function for the field
in the Special Function drop-down list to further specify to which level the data will be grouped by. If
Customize is selected, the Customized Function dialog will be displayed, in which you can set the
function by your own.
OK
Accepts all changes and closes the dialog.
Apply
Applies all changes to the existing summary or adds the new summary to the catalog.
Cancel
Does not retain any changes and closes this dialog.
Help
Displays this help document.
displayed here.
Parameter
Specifies the parameter string for the UDS. The parameter string must match the format defined in the
UDS class. You can use parameters predefined in a JReport catalog in the parameter string, and the
format used in the string is "@" + parameter name. For example, if the parameter string of a UDS is
SQL=select * from employee, and you want to use the parameter sql in a catalog to replace the part
after "=" in the string, then the parameter string of the UDS will be SQL=@sql.
Edit Format
Opens the Edit Parameter Format dialog to edit the parameter format:
Name
Displays names of parameters used in the user data source.
Format
Specifies formats for parameters as required.
OK
Accepts changes and closes the dialog.
Cancel
Does not retain changes and closes the dialog.
Specify Columns
Specifies the column definitions. If you don't specify the column definitions, JReport will retrieve them
from result set.
Name
Specifies the name of a column. The name of the column should have the same validation with a
common table column. The default names for column definitions are column1', column2' etc.
SQLType
Specifies the data type of the column. The following types are supported:
String
The corresponding JDBC type is VARCHAR or LONGVARCHAR.
java.math.BigDecimal
The corresponding JDBC type is NUMERIC.
boolean
The corresponding JDBC type is BIT.
byte
The corresponding JDBC type is TINYINT.
short
The corresponding JDBC type is SMALLINT.
int
The corresponding JDBC type is INTEGER.
long
The corresponding JDBC type is BIGINT.
float
double
The corresponding JDBC type is DOUBLE.
java.io.InputStream
The corresponding JDBC type is VARBINARY or LONGVARBINARY.
java.sql.Date
The corresponding JDBC type is DATE.
java.sql.Time
The corresponding JDBC type is TIME.
java.sql.Timestamp
The corresponding JDBC type is TIMESTAMP.
Adds a default row in the column definitions. If there is no row selected, an empty row will be added to
the last line.
General tab
Security tab
General tab
Sets properties for the view element.
Display Name
Specifies the display name of the view element which is intuitive to the end user.
Mapping Name
Specifies the mapping name of the field to which the view element is mapped. Click
field.
to select the
Type
Specifies the type of the view element.
Group
Group objects are the view elements that will become the basis for analyzing data in a report. They
characteristically return text data or dates. For example they may return items like country, state
and year to use for grouping data in reports.
Aggregation
Aggregation objects are numeric view elements that are calculated at the time the report is ran. The
values they return are dependent on the group objects which they are used with. For example you
may want a sales total by year.
Detail
Detail objects provide additional information. They can be bound to group, aggregation, or category
elements. Detail objects are not used for analysis but are useful in tables to show detail information
such as addresses and phone numbers.
Aggregate Function
Available only when the view element is an aggregation. It specifies the function for the aggregation
object.
Tip
Specifies the tooltip of the view element which will be shown when you hover the mouse pointer over
the element in the Resources panel of JReport Studio.
Description
Specifies the description of the view element which will be shown after the tooltip when you hover the
mouse pointer over the element in the Resources panel of JReport Studio.
Security tab
Specifies principals' permissions to the view element.
Role/Group/User tab
Lists all the roles/groups/users for the current security policy.
Name
Displays role/group/user names.
Visible
Specifies whether or not the view element is visible to the roles/groups/users.
Security Configuration
Opens the Security Configuration dialog to add or import principals.
OK
Applies all changes and closes the dialog.
Cancel
Does not retain changes and closes the dialog.
Help
Displays this help document.
Encrypt dialog
This dialog appears when you click the Setting button after checking the Encrypt checkbox in the Export
to PDF dialog. It helps you to configure the encryption settings for the PDF file.
Specifies options for the encryption you defined for the PDF file.
Permissions
Sets permissions for the encryption that you specified for the PDF file.
Use a password to restrict printing and editing of the document and its security settings
Specifies whether to use a permission password to restrict users from printing and editing.
Permission Password
Specifies the password to restrict users from printing and editing.
Note: The password here cannot be the same as the one used for opening the document.
Confirm Password
Confirms the password you have specified in the Permission Password text box.
Printing Allowed
Specifies the printing quality for the PDF document.
None
Not allowed prevents users from printing the document.
Low Resolution
Available only when a high encryption level - Acrobat 5.0 is selected. If checked, users can print the
document at no higher than 150-dpi resolution. Printing may be slower because each page is
printed as a bitmapped image.
High Resolution
Lets users print at any resolution, directing high-quality vector output to PostScript and other
printers that support advanced high-quality printing features.
Changes Allowed
Specifies what editing actions are allowed in the PDF document.
None
Prevents the user from making any changes to the document, including filling in signature and form
fields.
Inserting, deleting, and rotating pages
Available only when a high encryption level - Acrobat 5.0 is selected. If checked, users can insert,
delete, and rotate pages, as well as create bookmarks and thumbnail pages.
Filling in form fields and signing
Lets users fill in forms and add digital signatures. This option doesn't allow users to add comments
or create form fields.
Commenting, filling in form fields and signing
Lets users fill in forms and add digital signatures and comments.
Any except extracting pages
Lets users change the document using any method listed in the Changes Allowed menu, except
removing pages.
OK
Applies all changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
If you set the parameter's Allow Type-in of Value option to true while creating it, you can then type in
values except for selecting values for it in the Enter Parameter Values dialog.
will be
If you set the parameter's Allow Multiple Values option to true while creating it, the button
available in the Enter Parameter Values dialog, by clicking which, the Enter Values dialog is displayed
for you to specify multiple values for the parameter.
OK
Applies your input and runs the report.
Default
Accepts the default value and runs the report.
Cancel
Available Values
Lists all predefined parameter values for selection. When the parameter is bound with a column, but
the Display Column is different from the Bind Column, values of the Display Column are listed here.
Adds the selected values from the Available Values box to the Selected Values box.
Adds all the selected values from the Available Values box to the Selected Values box.
Removes all the selected values from the Selected Values box.
Selected Values
Lists the values selected. The selected values are case sensitive.
Enter Values
This option is available when you set the parameter's Allow Type-in of Value to true while creating it.
Enter a value manually in the text box and then click the button next to add the value to the Selected
Values box. When the parameter is bound with a column, but the display column is different from the
bind column, make sure the value you enter is that of the bind column.
All
If selected, it means that the parameter value result is all the values in the DBMS. This option is
available when you set the parameter's Enable the "All" Option to true while creating it. This is
translated in SQL to remove the parameter which may select more values than listed in the available
values list.
For example, when the parameter query is:
SELECT CUSTOMERS.CUSTOMERID,CUSTOMERS.CUSTOMERNAME FROM CUSTOMERS where CUSTOMERS.
CUSTOMERID>0 and CUSTOMERS.CUSTOMERID<4
When you click
the SQL is:
to add 1, 2 and 3 as the parameter values, which are all the available values,
(CUSTOMERS.CUSTOMERID IN ( 1,2,3))
Run the same report again and this time check the All checkbox in the Enter Values dialog, the query is
then:
( 1 = 1)
In this case, you will get more customers even though available values are only 1 3.
Note: When a multi-value parameter is inserted as a field into a report and All is selected as the value,
the field will show the string "All" which represents all the values in the DBMS.
OK
Closes the dialog and applies the selected values to the parameter.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
OK
Applies all changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
The following are the details about the options in this dialog:
To
Specifies the e-mail address of the recipients to whom you want to send the report.
Cc
Specifies the e-mail address of the recipients to whom you want to send a copy of the report.
Bcc
Specifies the e-mail address of the recipients to whom you want to send a blind carbon copy of the
report.
Subject
Specifies the subject of the e-mail that is to be sent.
SMTP Logon Information
The following options are available only when you have checked Server requires authentication in the
Options dialog (File > Options > Export to > E-mail > Server requires authentication).
Account Name
Specifies the account name in the SMTP server.
Password
Specifies the password for logging on to the SMTP server.
E-mail Address
Specifies the e-mail address in the SMTP server.
Note: Some SMTP may not need the mail address as one part of authentication information).
Comment
Specifies some comments about the report. The contents in this text box will be shown in the text part
of the mail.
Format
Specifies in which mail format the report will be sent.
No Margin
Specifies whether to remove the margins originally set when the reports is designed.
Section 508 Compliant Output
If checked, the accessibility attributes defined for the report elements via the Report Inspector will
be exported to the HTML format report result which is Section 508 compliant. See Accessibility for
more information.
When Section 508 Compliant Output is checked, the Use HTML Data Table and Relative Font Size
options will be checked and disabled. The output will be Section 508 compliant including HTML data
table, accessible attributes, and relative font feature.
When sending the report result as an attachment to the mail, you can specify either (or both) of the
following two options as required:
No Margin
Specifies whether or not to remove the margins originally set when the reports is designed.
Compress Attachment as Java Archive
Specifies whether or not to compress the mail attachment as Java Archive.
OK
Applies all changes, and sends the report to the specified E-mail address.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Specifies whether to encrypt the PDF file. Click the Setting button to configure the encrypt settings in
the Encrypt dialog.
Sign
Specifies whether to add the digital sign to the PDF file. Click the Setting button to configure the sign
settings in the Sign Digital ID dialog.
Compress Image
If checked, the size of the images or pictures in the report will be compressed to the specified
proportion of its original size.
Generate charts and barcodes using images (recommended)
If selected, charts, UDOs and barcodes in the report will be exported to common pictures, which will
look dimmed and the file size may be relatively large. But, the transparency property is supported.
Generate charts and barcodes using vector graphics
If selected, charts, UDOs and barcodes in the report will be exported to vector graphics, which will not
be anamorphic when it is zoomed out or zoomed in. But, the transparency property is not supported.
OK
Applies all changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Format
Specifies the delimiter to separate fields.
CSV Delimited
Fields in the exported Text file will be separated by a comma.
Tab Delimited
Fields in the exported Text file will be separated by a tab.
Customize Delimited
Fields in the exported Text file will be separated by a user defined delimiter. You can type your own
delimiter in the Delimiter box (note that the delimiter should be only one character).
Horizontal Density
Specifies the value for each unit of the horizontal density between columns. The resulting density is a
direct ratio of the value you specify. That is, the greater the value, the smaller the width between
columns.
Vertical Density
Specifies the value for each unit of the vertical density between columns. The resulting density is a
direct ratio of the value you specify. That is, the greater the value, the smaller the height between
columns.
Notes:
By exporting using user defined densities, if the densities are not set appropriately, the fields in the
report may overlap each other, so you are not recommended to use this way to export the report
result to Text.
When setting the value of Horizontal/Vertical Density, you need to pay attention to the following:
The value of Horizontal/Vertical Density must be greater than the character's width/height of the
smallest field in the report (smallest field is the field with the smallest font size), otherwise, the
value you set will not be applied.
If the value of Vertical Density is greater than 0 and the value of Horizontal Density is less than 0,
the value that you specify for the Vertical Density will be applied and the value of Horizontal
Density will be specified by JReport.
If the value of Vertical Density is less than 0 and the value of Horizontal Density is greater than 0,
the value that you specify for the Horizontal Density will be applied and the value of Vertical
Density will be specified by JReport.
If the values of Vertical Density and Horizontal Density are both greater than 0 and the value of
Horizontal Density is less than 11, the specified value of the two densities will be applied.
Otherwise, they will be specified by JReport.
If the values of Vertical Density and Horizontal Density are both less than 1, these densities will be
specified by JReport.
Compress
Specifies whether to generate the report result to Text format in a compressed size, that is to say,
there will be no clearance between the columns.
Header and Footer
If checked, the exported file will contain all headers and footers in the report, including Report Header/
Footer, Page Header/Footer and Group Header/Footer. Otherwise, the exported file will only contain
data in Detail panel.
If checked, the exported XML file will only contain the database column information. The exported
XML schema file will only contain the structure information of the report.
If unchecked, the exported XML file will also contain elements controlled by formulas, and the
exported XML schema file will contain all the detailed information from the report, including all the
property values of each report object.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Gradient tab
Texture tab
Image tab
Default
Sets all the values in the dialog to be the default settings.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Gradient tab
Fills the object with specified gradient colors.
Fill Gradient
Specifies the type of gradient to fill the object. It can be one of the following: Linear, Cyclic Linear,
Square Radial, and Round Radial.
Start Color
Specifies a color in the gradient graph.
End Color
Specifies the other color in the gradient graph.
Transparency
Specifies the transparency of the gradient color, in percent.
Start X
Specifies the horizontal position, measured in the percentage of the object's width, from the left edge
of the object, where the gradient starts.
Start Y
Specifies the vertical position, measured in the percentage of the object's height, from the top edge of
the object, where the gradient starts.
End X
Specifies the horizontal position, measured in the percentage of the object's width, from the left edge
Texture tab
Fills the object with specified texture.
Fill Texture
Specifies the type of texture to fill the object.
Foreground
Specifies the foreground color of the texture.
Background
Image tab
Fills the object with specified image.
Specifies the bottom position of the area, measured in the percentage of the image's width, from the
bottom edge of the image.
Width
Specifies the width of the area, measured in the percentage of the image's width. Setting this value to
less than 100 percent will cut the image from the right edge.
Height
Specifies the height of the area, measured in the percentage of the image's height. Setting this value
to less than 100 percent will cut the image from the bottom edge.
The above four options, namely Image X, Image Y, Width and Height, are used to define an area in the
image and put the defined area of the image into the object.
Preview
Displays a preview of your settings.
Filter dialog
This dialog appears when you click the Filter button
on the toolbar of the Business Cube Editor
window. It allows you to create or modify a built-in filter for a business cube. The built-in filter is
transparent to the end users running the BC reports. Each business cube can only have one built-in
filter.
Group
Makes the selected conditions in one group. Conditions can also be added to an existing group by
selecting the conditions and the group while holding the Ctrl button, and then clicking the Group button.
Ungroup
Makes the selected condition ungrouped.
Up
Moves the selected condition up to a higher level.
Down
Moves the selected condition or group down to a lower level.
Logic
Lists the logic operator.
And
Logic operator And which is applied to this and the next line.
Or
Logic operator Or which is applied to this and the next line.
Field
Specifies the field to be filtered. You can either type in the field directly or click
to specify the field.
Operator
Specifies the operator to compose the filter expression.
=
Equal to
>=
Greater than or equal to
>
Greater than
<
Less than
<=
Less than or equal to
!=
Not equal to
[not] in
Causes an enumerated list of values to appear in the WHERE clause predicate, used for evaluating for
a true condition. For operator in' or not in', it is allowed to input multiple values in the Value input
box and separate the values with comma (,).
[not] like
Like string pattern matching operator is used to compare the first expression string value to the
pattern string (the second expression). If you want to use wildcard character in the pattern string,
only "_" and "%" are supported.
[not] between
Allows the system to evaluate whether or not data values are located between a range of values
indicated in the predicate. For operator between' or not between', there are two value input boxes
for inputting the same type of values.
is [not] null
It is used in WHERE clause predicates to match null values occurring in a specified data field. For
operator is null' or is not null', the value input box is hidden.
Value
Specifies the value of how to filter the field. You can either type in the value manually or click
to the text box to specify the value.
next
When you type in the value, if multiple values are required, they should be separated with ",", and if ","
or "\" is contained in the values, write it as "\," or "\\".
When you click
Fields tab
Lists the fields which can be used in the filter expression. Double-click the required field to add it as
the filter value.
Value tab
Lists values of the field to be filtered. Double-click the required value to add it as the filter value.
SQL Statement
Displays the SQL statement of the filter condition.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Filter On dialog
The dialog appears when you right-click a filter control and select Edit Filter Control from the shortcut
menu. It helps you to edit the filter control.
in. Select the target components you want to apply the filter to.
More/Less Options
Shows/Hides the additional settings for editing the filter control.
OK
Inserts a filter control into the report and closes the dialog.
Cancel
Cancels the operation and closes the dialog.
Help
Displays this help document.
Select All
Selects all the elements in the list box to include them in the view.
Deselect All
Deselects all the elements in the list box to exclude them from the view.
OK
Applies all changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
=
Equal to
>
Greater than
<
Less than
>=
Greater than or equal to
<=
Less than or equal to
!=
Not equal to
in
Causes an enumerated list of values to appear in the WHERE clause predicate, used for evaluating for
a true condition. For operator in', it is allowed to input multiple values in the Value input box and
separate the values with comma (,).
Value
Specifies the value of how to filter the field. If multiple values are required, they should be separated
with ",", and if "," or "\" is contained in the values, write it as "\," or "\\".
More
Lists some additional commands, which includes AND, OR, and End.
OK
Accepts the changes and closes this dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Related topics:
Find dialog
This dialog appears when you click Edit > Find DBField on the menu bar, or the Find DBField button
on the Standard toolbar.
When a report has many fields, you may find it difficult to determine where a certain field is. This
dialog enables you to find specific fields you have lost track of in your report.
Root
Searches for these identical fields from the top node.
Current Node
Searches for these fields from the current node.
Find Next
If you placed multiple identical fields in the same report, you can repeat the action of clicking this
button to search for all of them.
Cancel
Ends the search and closes the dialog.
Help
Displays this help document.
Find/Replace dialog
This dialog appears when you click the Search button
in the Formula Editor window. You can then
search for text in the formula text, and replace the found text with different text.
Match case
Limits the search to text that exactly matches the case of the text you want to find.
Match whole word
Limits the search to text that matches one or more complete words.
Find Next
Jumps to and selects the next occurrence of the search words in the Formula Text.
Find All
Finds all occurrences of the search words in the Formula Text.
Replace
Replaces the found material one by one in the Formula Text.
Replace All
Replaces all of the found materials in the Formula Text.
Close
Closes the dialog.
Play
Specifies whether to play the flash file.
Loop
Specifies whether to play the flash file repeatedly.
Movie Quality
Specifies the quality for the flash file from the drop-down list.
OK
Accepts all changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
General tab
Fill tab
Border tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
General tab
For 2-D area charts
Specifies the general format of the 2-D area chart.
Layout
Specifies the layout for 2-D areas of the chart.
None 2-D
If selected, 2-D area will be applied to display the trend of the values over time or categories.
Stacked 2-D
If selected, stacked 2-D area will be applied to display the trend of the contribution of each data
value over categories.
100% Stacked 2-D
If selected, 100% stacked 2-D area will be applied to display the trend of the percentage each data
value contributes over categories.
Depth
Specifies the depth properties for areas of the chart.
Use Depth
Specifies whether to make the areas in the chart three-dimensional. You can also use a formula to
control the property.
Depth
Direction
Specifies the direction for depth of the lines.
High-Low Lines
Specifies whether to show the high-low lines in areas of a chart.
Layout
Specifies the layout for 3-D areas of the chart.
None 3-D
If selected, area with a 3-D visual effect will be applied.
Stacked 3-D
If selected, stacked area with a 3-D visual effect will be applied.
100% Stacked 3-D
If selected, 100% stacked area with a 3-D visual effect will be applied.
Fill tab
Specifies the color, fill effect and transparency for areas of the chart.
Color
Specifies the color schema for areas in the same data series.
Transparency
Specifies the transparency of the color schema that is applied to areas in the same data series.
Pattern List
Opens the Pattern List dialog to modify color pattern of areas in the same data series.
Sample
Displays a preview sample of your selection.
Border tab
Specifies properties for border of the areas.
Border Type
Displays the type of border for the areas. Its default value is solid, and can not be changed.
Color
Specifies the color for border of the areas.
Transparency
Specifies the transparency for color of the border.
Line Style
Specifies the line style to apply to border of the areas.
Thickness
Specifies the weight of the border.
End Caps
butt
Ends unclosed sub paths and dash segments with no added decoration.
round
Ends unclosed sub paths and dash segments with a round decoration that has a radius equal to half
of the width of the pen.
square
Ends unclosed sub paths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Line Joint
Specifies the line joint style for the border line.
miter
Joins path segments by extending their outside edges until they meet.
round
Joins path segments by rounding off the corner at a radius of half the line width.
bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
Sample
Displays a preview sample of your selection.
Path
Specifies the fill pattern of the border line.
Outline Path
Specify the fill pattern of the border line to be outline path.
Fill Path
Specify the fill pattern of the border line to be whole path.
Dash
Specifies the dash size of the border line.
auto fit
If selected, the data labels will be displayed automatically.
top center
If selected, the data labels will be displayed in the top center of the nodes on the areas.
top left
If selected, the data labels will be displayed on the top left of the nodes on the areas.
top right
If selected, the data labels will be displayed on the top right of the nodes on the areas.
bottom left
If selected, the data labels will be displayed on the bottom left of the nodes on the areas.
bottom center
If selected, the data labels will be displayed in the bottom center of the nodes on the areas.
bottom right
If selected, the data labels will be displayed on the bottom right of the nodes on the areas.
Font
Specifies the font format of text in the data labels.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Specifies the special effects of text in the data labels.
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
General tab
Fill tab
Border tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
General tab
For 2-D bar/bench charts
Specifies the general format of the 2-D bar chart.
Size
Specifies the size of the bars in the chart.
Bars Width
Specifies the bar width as a percentage of the unit width.
Bars Gap
Specifies the distance between two bars as a percentage of the bar width, only applying to clustered
bar/bench charts.
Layout
Specifies the layout of the chart.
Clustered - 2-D
Displays and compares data values across categories.
Stacked - 2-D
Displays and compares the contribution of each data value to a total across categories.
100% Stacked - 2-D
Displays and compares the percentage that each data value contributes to a total across categories.
Depth
Use Depth
Specifies whether to make the bars in the chart three-dimensional. You can also use a formula to
control the property.
Depth
Specifies the depth of the lines.
Direction
Specifies the direction for depth of the lines.
Size
Specifies the size of bars in the chart.
Bars Width
Specifies the bar width as a percentage of the unit width.
Layout
Specifies the layout of the chart.
Fill tab
Specifies the color, fill effect and transparency for bars of the chart.
Color
Specifies the color schema for bars in the same data series.
Transparency
Specifies the transparency of the color schema that is applied to bars in the same data series.
Pattern List
Opens the Pattern List dialog to modify color pattern of bars in the same data series.
Sample
Displays a preview sample of your selection.
Vary Colors by value
Specifies whether or not colors will be varied with values.
Border tab
Specifies the properties for border of the bars.
Border Type
Displays the type for border of the bars. The default value is solid, and cannot be changed.
Color
Specifies the color for border of the bars.
Transparency
Specifies the transparency for color of the border.
Line Style
Specifies the line style to apply to border of the bars.
Thickness
Specifies the weight of the border.
End Caps
Specifies the ending style of the border line.
butt
Ends unclosed sub paths and dash segments with no added decoration.
round
Ends unclosed sub paths and dash segments with a round decoration that has a radius equal to half
of the width of the pen.
square
Ends unclosed sub paths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Line Joint
Specifies the line joint style for the border line.
miter
Joins path segments by extending their outside edges until they meet.
round
Joins path segments by rounding off the corner at a radius of half the line width.
bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
Sample
Displays a preview sample of your selection.
Path
Specifies the fill pattern of the border line.
Outline Path
Specifies the fill pattern of the border line to be outline path.
Fill Path
Specifies the fill pattern of the border line to be whole path.
Dash
Specifies the dash size of the border line.
auto fit
If selected, the data labels will be displayed automatically.
outside top
If selected, the data labels will be displayed on the outside top of the nodes on the bars.
inside top
If selected, the data labels will be displayed on the inside top of the nodes on the bars.
inside center
If selected, the data labels will be displayed in the inside center of the nodes on the bars.
inside bottom
If selected, the data labels will be displayed at the inside bottom of the nodes on the bars.
Font
Specifies the font format of text in the data labels.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Specifies the special effects of text in the data labels.
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
General tab
Fill tab
Border tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
General tab
Specifies the general format of the bar gauge chart.
Option
Layout
Specifies the layout of the bar gauges. It can be vertical or horizontal.
Range Border
Specifies properties of the range borders.
Color
Specifies the color schema of the range borders.
Style
Specifies the style of the range borders.
Transparency
Specifies the transparency of the color schema.
Thickness
Specifies the thickness of the range borders.
Color Range
Specifies different colors to fill the bar gauges in different ranges.
Minimum
Specifies the minimum value of a range.
Maximum
Specifies the maximum value of a range.
Color
Specifies the color schema for every range.
Name
Specifies the name for every range.
Fill tab
Specifies the color, fill effect and transparency for the bar gauges.
Color
Specifies the color schema for bar gauges in the same data series.
Transparency
Specifies the transparency of the color schema that is applied to the bar gauges in the same data
series.
Pattern List
Opens the Pattern List dialog to modify color pattern of gauges in the same data series.
Sample
Displays a preview sample of your selection.
Border tab
Specifies properties for the border of the bar gauges.
Border Type
Displays the type for border of the bar gauges. The default value is solid, and cannot be changed.
Color
Specifies the color for border for the bar gauges.
Transparency
butt
Ends unclosed sub paths and dash segments with no added decoration.
round
Ends unclosed sub paths and dash segments with a round decoration that has a radius equal to half
of the width of the pen.
square
Ends unclosed sub paths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Line Joint
Specifies the line joint style for the border line.
miter
Joins path segments by extending their outside edges until they meet.
round
Joins path segments by rounding off the corner at a radius of half the line width.
bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
Sample
Displays a preview sample of your selection.
Path
Specifies the fill pattern of the border line.
Outline Path
Specifies the fill pattern of the border line to be outline path.
Fill Path
Specifies the fill pattern of the border line to be whole path.
Dash
Specifies the dash size of border line.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Specifies the special effects of text in the data labels.
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
General tab
Fill tab
Border tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
General tab
Specifies the general format of the bubble chart.
Fill tab
Specifies the color, fill effect and transparency of the bubbles.
Color
Specifies the color schema of the bubbles.
Transparency
Specifies the transparency of the color schema that is applied to the bubbles.
Pattern List
Opens the Pattern List dialog to modify color pattern of bubbles in the same data series.
Sample
Displays a preview sample of your selection.
Border tab
Specifies the properties for border of the bubbles.
Border Type
Displays the type for border of the bubbles. The default value is solid, and cannot be changed.
Color
Specifies the color for border of the bubbles.
Transparency
Specifies the transparency for color of the border.
Line Style
Specifies the line style to apply to border of the bubbles.
Thickness
Specifies the thickness of the border.
End Caps
Specifies the ending style of the border line.
butt
Ends unclosed sub paths and dash segments with no added decoration.
round
Ends unclosed sub paths and dash segments with a round decoration that has a radius equal to half
of the width of the pen.
square
Ends unclosed sub paths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Line Joint
Specifies the line joint style for the border line.
miter
Joins path segments by extending their outside edges until they meet.
round
Joins path segments by rounding off the corner at a radius of half the line width.
bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
Sample
Displays a preview sample of your selection.
Path
Specifies the fill pattern of the border line.
Outline Path
Specifies the fill pattern of the border line to be outline path.
Fill Path
Specifies the fill pattern of the border line to be whole path.
Dash
Specifies the dash size of the border line.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Specifies the special effects of text in the data labels.
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
General tab
Border tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
General tab
Specifies the general format of the bubble gauge chart.
Option
Left Margin
Specifies the gap between the left labels and left bubbles.
Top Margin
Specifies the gap between top labels and top bubbles.
Range Radius
Specifies the radius
Draw Category(X) Grid
Specifies whether to draw category grid.
Draw Series(Z) Grid
Specifies whether to draw series grid.
Value
Specifies the value range for the bubble gauge chart.
Minimum
Specifies the minimum value of the bubble gauge chart.
Maximum
Specifies the maximum value of the bubble gauge chart.
Color Range
Specifies different colors to fill the bubble gauges in different ranges.
Minimum
Specifies the minimum value of a range.
Maximum
Specifies the maximum value of a range.
Color
Specifies the color schema for every range.
Name
Specifies the name for every range.
Border tab
Specifies properties for border of the bubble gauges.
Border Type
Displays the type for border of the bubble gauges. The default value is solid, and cannot be changed.
Color
Specifies the color for border of the bubble gauges.
Transparency
Specifies the transparency for color of the border.
Line Style
Specifies the line style to apply to border of the bubble gauges.
Thickness
Specifies the weight of the border.
End Caps
Specifies the ending style of the border line.
butt
Ends unclosed sub paths and dash segments with no added decoration.
round
Ends unclosed sub paths and dash segments with a round decoration that has a radius equal to half
of the width of the pen.
square
Ends unclosed sub paths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Line Joint
Specifies the line joint style for the border line.
miter
Joins path segments by extending their outside edges until they meet.
round
Joins path segments by rounding off the corner at a radius of half the line width.
bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
Sample
Displays a preview sample of your selection.
Path
Specifies the fill pattern of the border line.
Outline Path
Specifies the fill pattern of the border line to be outline path.
Fill Path
Specifies the fill pattern of the border line to be whole path.
Dash
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Specifies the special effects of text in the data labels.
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
General tab
Fill tab
Border tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
General tab
Specifies the general format of the bullet chart.
Size
Specifies the size of the bullets in the chart.
Featured Measure Width
Specifies the featured measure width as a percentage of the unit width.
Comparative Measure Width
Specifies the comparative measure width as a percentage of the unit width.
Qualitative Ranges Width
Specifies the qualitative ranges width as a percentage of the unit width.
Fill tab
Specifies the fill properties.
Color
Specifies the color schema for the featured measure in the same data series.
Transparency
Specifies the transparency of the color schema that is applied to the featured measure in the same
data series.
Pattern List
Opens the Pattern List dialog to modify color pattern of the featured measure in the same data series.
Color
Specifies the color schema for the comparative measures in the same data series.
Transparency
Specifies the transparency of the color schema that is applied to the comparative measures in the
same data series.
Pattern List
Opens the Pattern List dialog to modify color pattern of the comparative measures in the same data
series.
Color
Specifies the color schema for the qualitative ranges in the same data series.
Transparency
Specifies the transparency of the color schema that is applied to the qualitative ranges in the same
data series.
Pattern List
Opens the Pattern List dialog to modify color pattern of the qualitative ranges in the same data series.
Sample
Displays a preview sample of your selection.
Vary Colors by Value
Specifies whether or not colors will be varied with values.
Border tab
Specifies the properties for the borders of the bullets.
Border Type
Displays the type for border of the bullets. The default value is solid, and cannot be changed.
Color
Specifies the color for border of the bullets.
Transparency
Specifies the transparency for color of the border.
Line Style
Specifies the line style to apply to border of the bullets.
Thickness
Specifies the thickness of the border.
End Caps
Specifies the ending style of the border line.
butt
Ends unclosed sub paths and dash segments with no added decoration.
round
Ends unclosed sub paths and dash segments with a round decoration that has a radius equal to half
of the width of the pen.
square
Ends unclosed sub paths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Line Joint
Specifies the line joint style for the border line.
miter
Joins path segments by extending their outside edges until they meet.
round
Joins path segments by rounding off the corner at a radius of half the line width.
bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
Sample
Displays a preview sample of your selection.
Path
Specifies the fill pattern of the border line.
Outline Path
Specifies the fill pattern of the border line to be outline path.
Fill Path
Specifies the fill pattern of the border line to be whole path.
Dash
Specifies the dash size of the border line.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Specifies the special effects of text in the data labels.
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
Axis tab
Font tab
Orientation tab
Format tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Axis tab
Specifies the general properties for the category(X) axis of the chart.
Option
Specifies the options for the category(X) axis.
Number of Labels
Specifies how many labels to be displayed in the category(X) axis.
Label Every N Tick Marks
Specifies whether to display a label every N tick marks.
Draw Axis Only
Specifies whether to show the labels on the category(X) axis.
Show Gridlines
Specifies whether to show the horizontal gridlines in the chart.
Show Axis Label Tips
Specifies whether to display the complete label text when the mouser pointer points at a label on the
category(X) axis.
Line
Specifies the line style for the category(X) axis.
Color
Transparency
Specifies the transparency for the color of the category(X) axis.
Style
Specifies the style for the line of the category(X) axis.
Thickness
Specifies the thickness for the line of the category(X) axis.
Labels
Specifies the properties for the labels on the category(X) axis.
If the category(X) axis is used to show numeric data of a scatter or a bubble chart, the following
options will be available.
Option
Specifies the options for the category(X) axis.
Minimum Value
Specifies the minimum value that is to be displayed on the category(X) axis.
Maximum Value
Specifies the maximum value that is to be displayed on the category(X) axis.
Increment
Specifies the difference between two adjacent values on the category(X) axis.
Number of Tick Marks
Specifies how many tick marks to be displayed on the category(X) axis.
Draw Axis Only
Specifies whether to show the labels on the category(X) axis.
Show Gridlines
Specifies whether to show the horizontal gridlines in the chart.
Line
Specifies the line style for the category(X) axis.
Color
Specifies the color of the category(X) axis.
Transparency
Specifies the transparency for the color of the category(X) axis.
Style
Specifies the style of the category(X) axis.
Thickness
Specifies the thickness of the category(X) axis.
Labels
Specifies the properties for the labels on the category(X) axis.
Tick Mark
Specifies the general properties for all the tick marks on the category(X) axis.
Color
Specifies the color for all the tick marks on the category(X) axis.
Style
Specifies the type for tick marks on the category(X) axis.
Transparency
Specifies the transparency for the tick marks on the category(X) axis.
Thickness
Specifies the thickness for the tick marks on the category(X) axis.
None
If selected, major tick marks will not be shown on the category(X) axis.
Inside
If selected, major tick marks will be inside the chart.
Outside
If selected, major tick marks will be outside the chart.
Cross
If selected, major tick marks will be across the category(X) axis.
Major Tick Length
Specifies the length of major tick marks on the category(X) axis.
None
If selected, minor tick marks will not be shown on the category(X) axis.
Inside
If selected, minor tick marks will be inside the chart.
Outside
If selected, minor tick marks will be outside the chart.
Cross
If selected, minor tick marks will be across the chart.
Minor Tick Length
Specifies the length for the minor tick marks on the category(X) axis.
Font tab
Specifies the font format of the tick mark labels on the category(X) axis.
Font
Specifies the font format of text in the tick mark labels.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
Sample
Displays a sample of the specified font and any text effects.
Orientation tab
Specifies the rotation angle of the tick mark labels on the category(X) axis.
Automatic
Specifies to adjust the rotation angle of the label text on the axis automatically according to the length
of the label text, in degrees.
When this option is checked by default:
If the text can be completely displayed horizontally, the default rotation angle will be 0.
If the text can not be completely displayed horizontally, the default rotation angle will be 30
anticlockwise, and the cut off part will be shown as suspension points.
Angle
Specifies to customize the rotation angle of the label text on the axis. When you change the rotation
angle in the text box, the red line in the spin box will change correspondingly, and vice versa.
Format tab
Specifies some properties for the tick mark labels on the category(X) axis.
Category
Specifies different formats to display the tick mark labels on the category(X) axis.
Scale
Lists all the formats of a value of a scale type that can be applied to the tick mark labels.
Number
Lists all the formats of a value of a number type that can be applied to the tick mark labels.
Date/Time
Lists all the formats of a value of a date/time type that can be applied to the tick mark labels.
Text
Lists all the formats of a value of a text type that can be applied to the tick mark labels.
Mapping
Lists all the formats of a value of a mapping type that can be applied to the tick mark labels.
Formats
Displays all the formats of the selected category. For more details about every format, see A detailed
chart property reference.
Properties
Specifies the properties for the format that you selected.
Sample
Displays the selected format effects.
Stack
Lists all the formats that you selected from different categories.
Add
Adds a format to the Stack list box.
Remove
Removes a format from the Stack list box.
Apply
Applies the specified format in the Stack list box to the tick mark labels.
Thickness
Specifies the thickness for category(X) gridlines in the chart.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
None
If selected, no border of the selected table cell will be displayed.
Box
If selected, insert a box border around the selected table cell, formatted with the currently selected
line style and color settings.
Custom
If selected, create a custom border and customize every border, by clicking the corresponding border
buttons. If you click one of the border buttons, the Custom will be selected automatically.
Color
Specifies the line color schema for border of the selected table cell. If you want to use a formula to
control the line color, click
Style
Specifies the line style for border of the selected table cell.
OK
Applies all changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes, leaving the dialog open.
Help
Displays this help document.
General tab
Fill tab
Border tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
General tab
Specifies the general format for gauges of the chart.
Circle
Specifies properties for circles of dial gauges in the chart.
Start Angle
Specifies the degree of start angles of the circles.
Stop Angle
Specifies the degree of stop angles of the circles.
Circular Style
Specifies the position of a dial gauge curve, related to the position of a circle in the chart.
Thickness
Specifies the thickness for the circles.
Range Radius
Specifies the percent size of a dial gauge in an area.
Pointer
Specifies properties for pointers of dial gauges in the chart.
Pointer Style
Specifies the style applied to pointers of the dial gauges.
triangle
If selected, pointers will be triangle shapes.
diamond
If selected, pointers will be diamond shapes.
arrow
If selected, pointers will be arrow shapes.
Arrow Style
Specifies the style applied to arrows of the pointers.
sharp
If selected, arrows will be sharp ones.
round
If selected, arrows will be round ones.
plain
If selected, arrows will be plain ones.
Color Range
Specifies different colors to fill the dial gauges in different ranges.
Minimum
Specifies the minimum value of a range.
Maximum
Specifies the maximum value of a range.
Color
Specifies the color schema and fill effect for every range.
Name
Specifies the name for every range.
Fill tab
Specifies the color, fill effect and transparency for the gauges.
Color
Specifies the color schema for dial gauges in the same data series.
Transparency
Specifies the transparency of the color schema that is applied to the dial gauges in the same data
series.
Pattern List
Opens the Pattern List dialog to modify color pattern of gauges in the same data series.
Sample
Displays a preview sample of your selection.
Border tab
Specifies the properties for borders of the dial gauges.
Border Type
Displays the type for border of the dial gauges. The default value is solid, and cannot be changed.
Color
Specifies the color for the borders of dial gauges.
Transparency
Specifies the transparency for color of the border.
Line Style
Specifies the line style to apply to the border of the dial gauges.
Thickness
Specifies the weight of the border.
End Caps
Specifies the ending style of the border line.
butt
Ends unclosed sub paths and dash segments with no added decoration.
round
Ends unclosed sub paths and dash segments with a round decoration that has a radius equal to half
of the width of the pen.
square
Ends unclosed sub paths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Line Joint
Specifies the line joint style for the border line.
miter
Joins path segments by extending their outside edges until they meet.
round
Joins path segments by rounding off the corner at a radius of half the line width.
bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
Sample
Displays a preview sample of your selection.
Path
Specifies the fill pattern of the border line.
Outline Path
Specifies the fill pattern of the border line to be outline path.
Fill Path
Specifies the fill pattern of the border line to be whole path.
Dash
Specifies the dash size of border line.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Specifies the special effects of text in the data labels.
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
General tab
Fill tab
Border tab
OK
Accepts the formatting of the donuts and closes the dialog.
Cancel
Cancels the formatting of the donuts and closes the dialog.
Apply
Accepts the formatting of the donuts and leaves the dialog open.
Help
Displays this help document.
General tab
Specifies the options which are available when you format a donut chart.
Option
Gap Amount
Specifies the gap between two donuts.
Explode Amount
Specifies the gap between every section and the central point of a donut.
Data Label Type
Specifies the display type for data value in the data label. It can be value, category name, percent,
value and percent.
Donut Hole
Specifies the radius percentage of the donut hole to the total pie circle.
Show Donut Name
Specifies whether to show the name of the donut.
Fill tab
Specifies the color, fill effect and transparency for the donuts.
Color
Specifies the color schema for the donuts.
Transparency
Specifies the transparency of the color schema that is applied to the donuts.
Pattern List
Specifies the Pattern List dialog to modify color pattern of donuts in the same data series.
Sample
Displays a preview sample of your selection.
Border tab
Specifies the properties for the border of the donuts.
Border Type
Displays the type for border of the donuts. The default value is solid, and cannot be changed.
Color
Specifies the color for the border of the donuts.
Transparency
Specifies the transparency for color of the border.
Line Style
Specifies the line style to apply to the border of the donuts.
Thickness
butt
Ends unclosed sub paths and dash segments with no added decoration.
round
Ends unclosed sub paths and dash segments with a round decoration that has a radius equal to half
of the width of the pen.
square
Ends unclosed sub paths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Line Joint
Specifies the line joint style for the border line.
miter
Joins path segments by extending their outside edges until they meet.
round
Joins path segments by rounding off the corner at a radius of half the line width.
bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
Sample
Displays a preview sample of your selection.
Path
Specifies the fill pattern of the border line.
Outline Path
Specifies the fill pattern of the border line to be outline path.
Fill Path
Specifies the fill pattern of the border line to be whole path.
Dash
Specifies the dash size of border line.
auto fit
If selected, the data labels will be displayed automatically.
sticker
If selected, the data labels will be displayed next to donuts.
slim leg
If selected, the data labels will be displayed beside donuts and pointed by thin lines.
best fit
If selected, the data labels will be displayed at the best fit position automatically.
on slices
If selected, the data labels will be displayed on the slices of donuts.
Font
Specifies the font format of text in the data labels.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Specifies the special effects of text in the data labels.
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
Color
Specifies the color schema for the floor of a 3-D chart.
Transparency
Specifies the transparency of the color schema that is applied to the floor of a 3-D chart.
Border
Specifies properties for border of the chart floor.
Color
Specifies the color for border of the chart floor.
Transparency
Specifies the transparency for color of the border.
Style
Specifies the style for border of the chart floor.
Thickness
Specifies the thickness for border of the chart floor.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
General tab
Fill tab
Border tab
Font tab
Orientation tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
General tab
Specifies the general format of the label.
Text
Specifies the text of the label.
Icon
Specifies the icon formats.
Style
Specifies the style for the icon that will be used in the label. If you don't want to show any icon in the
label, you can choose No Icon from the drop-down list.
Icon Text Gap
Specifies the distance between the icon and the label text.
Fill
Specifies the color to fill the selected icon.
Transparency
Specifies the transparency of the color that is used to fill the selected icon.
Width
Specifies the width of the icon.
Height
Text
Specifies the alignment format for text in the label.
Icon
Specifies the alignment format for icons in the label.
Fill tab
Specifies the color schema to fill the title of the label.
Color
Specifies the color to fill the label.
Transparency
Specifies the transparency of the color.
Sample
Displays the specified color and transparency effects.
Border tab
Specifies properties of the label border.
Border Style
Specifies the type for border of the label.
Color
Specifies the color for border of the label.
Line Style
Specifies the line style to apply to the label border.
Thickness
Specifies the thickness of the label border.
Transparency
Specifies the transparency for the color of the label border.
End Caps
Specifies the ending style of the border line.
Butt
Ends unclosed sub paths and dash segments with no added decoration.
Round
Ends unclosed sub paths and dash segments with a round decoration that has a radius equal to half
of the width of the pen.
Square
Ends unclosed sub paths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Line Joint
Specifies the line joint style for the border line.
Miter
Joins path segments by extending their outside edges until they meet.
Round
Joins path segments by rounding off the corner at a radius of half the line width.
Bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
Path
Specifies the fill pattern of the border line.
Outline Path
Specify the fill pattern of the border line to be outline path.
Fill Path
Specify the fill pattern of the border line to be whole path.
Dash
Specifies the dash size of border line.
Font tab
Specifies the font format of the label text.
Font
Specifies the font format of label text.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
Sample
Displays the specified font and any text effects.
Orientation tab
This tab allows you to set the alignment format of the label text and the icon.
Orientation
Drag the pointer in the box to specify the alignment format of the label text and the icon.
Angle
Specify the alignment format of the label text and the icon.
Fill tab
Border tab
Placement tab
Font tab
Orientation tab
Format tab
Mark tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Fill tab
Specifies the color and its transparency for the legend of the chart.
Color
Specifies the color to fill the legend.
Transparency
Specifies the transparency of the color.
Border tab
Specifies the properties for border of the legend.
Border Style
Specifies the type for border of the legend.
Color
Specifies the color for border of the legend.
Line Style
Specifies the line style to apply to the border of the legend.
Thickness
Specifies the thickness of the border.
Transparency
Specifies the transparency for the color of the border.
End Caps
Specifies the ending style of the border line.
Butt
Ends unclosed sub paths and dash segments with no added decoration.
Round
Ends unclosed sub paths and dash segments with a round decoration that has a radius equal to half
of the width of the pen.
Square
Ends unclosed sub paths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Line Joint
Specifies the line joint style for the border line.
Miter
Joins path segments by extending their outside edges until they meet.
Round
Joins path segments by rounding off the corner at a radius of half the line width.
Bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
Path
Specifies the fill pattern of the border line.
Outline Path
Specify the fill pattern of the border line to be outline path.
Fill Path
Specify the fill pattern of the border line to be whole path.
Dash
Specifies the dash size of border line.
Sample
Displays a preview sample of your selection.
Placement tab
Specifies the location of the legend object.
Position
Specifies the position of the legend to be left, right, top, bottom or decided it by JReport automatically.
You can preview the samples.
Alignment
Specifies the alignment format for the legend.
Legend-Label Gap
Specifies the minimum distance between the legend entry labels.
Vertical Margin
Specifies the minimum vertical distance between the legend entry labels.
Vertical Label Spacing
Specifies the vertical distance between legend labels, in pixels.
Horizontal Margin
Specifies the minimum horizontal distance between legend entry labels.
Horizontal Label Spacing
Specifies the horizontal distance between the legend entry labels, in pixels.
Reverse Legend
Specifies whether the legend entries will be re-arranged in a reverse order.
Font tab
Specifies the font format of text in the legend entry labels.
Font
Specifies the font format of text in the legend entry labels.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Specifies the special effects of text in the legend entry labels.
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
Sample
Displays the specified font and any text effects.
Orientation tab
Specifies the alignment format of the legend entry labels.
Orientation
Specifies the orientation of the legend entry labels.
Angle
Specifies the angel of the legend entry labels.
Format tab
Specifies properties for the legend entry labels.
Category
Specifies different formats to display the legend entry labels.
Scale
Lists all the formats of a value of a scale type that can be applied to the legend entry labels.
Number
Lists all the formats of a value of a number type that can be applied to the legend entry labels.
Date/Time
Lists all the formats of a value of a date/time type that can be applied to the legend entry labels.
Text
Lists all the formats of a value of a text type that can be applied to the legend entry labels.
Mapping
Lists all the formats of a value of a mapping type that can be applied to the legend entry labels.
Format
Displays all the formats of the selected category. For more details about every format, see A detailed
chart property reference.
Properties
Specifies the properties for the format that you selected.
Stack
Lists all the formats that you selected from different categories.
Sample
Displays the effects of the selected format that has been added into the Stack list box.
Add
Adds a format to the Stack list box.
Remove
Removes a format from the Stack list box.
Apply
Applies the specified format in the Stack list box to the legend entry marks.
Note: To make settings in this tab take effect, you need to first make sure that the property Label
Format Source of the chart legend has been set to Legend Label Format in the Report Inspector.
Mark tab
Specifies the format of the legend entry marks.
Mark Items
Lists all the styles that are available for you to choose to apply to every mark item of the legend entry
marks.
Adds the specified mark item from the drop-down to the Mark Items list.
Color
Specifies the color scheme for the selected item.
Transparency
General tab
Fill tab
Node tab
Border tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
General tab
For 2-D lines
Specifies the general format of the 2-D line chart.
Layout
Specifies the layout of the 2-D lines in the chart.
None
If selected, the lines will display trend over categories.
Stacked
If selected, the stacked lines will display the trend of the contribution of each data value over
categories.
100% Stacked
If selected, the 100% stacked lines will display the trend of the percentage each data value
contributes over categories.
Line
Thickness
Specifies thickness of 2-D lines in the chart.
Depth
Specifies the depth properties for lines of the chart.
Use Depth
Specifies whether to make the lines in the chart three-dimensional. You can also use a formula to
control the property.
Depth
Specifies the depth of the lines.
Direction
Specifies the direction for depth of the lines.
Node
Specifies properties for the 2-D line nodes.
Style
Specifies the style of the 2-D line nodes.
Width
Specifies the width of the 2-D line nodes.
Height
Specifies the height of the 2-D line nodes.
Thickness
Specifies the thickness of the 3-D lines in the chart.
Fill tab
Specifies the fill properties.
Color
Specifies the color schema for the lines in the same data series.
Transparency
Specifies the transparency of the color schema that is applied to lines in the same data series.
Pattern List
Opens the Pattern List dialog to modify color pattern of lines in the same data series.
Area
Specifies properties for the areas which are formed by the chart axes and the lines. Applies to 2-D lines
only.
Color
Specifies the color schema for the areas.
Transparency
Specifies the transparency of the color schemas.
Area Pattern List
Opens the Pattern List dialog to modify color pattern of the areas.
Sample
Node tab
Specifies properties for nodes of the 2-D line chart.
Shape
Specifies the shape properties of the line nodes.
Style
Specifies the style of the line nodes.
Fill Color
Specifies the color of the line nodes.
Width
Specifies the width of the line nodes.
Height
Specifies the height of the line nodes.
Border
Specifies the border properties of the line nodes.
Border Color
Specifies the color for the border of the line nodes.
Transparency
Specifies the transparency for the border of the line nodes.
Line Style
Specifies the line style to apply to the border of the line nodes.
Thickness
Specifies the thickness for the border of the line nodes.
Sample
Displays a preview sample of your selection.
Border tab
Specifies properties for borders of the 3-D lines.
Border Type
Displays the type for border of the lines. The default value is solid, and cannot be changed.
Color
Specifies the color for border of the lines.
Transparency
Specifies the transparency for the color of the border.
Line Style
Specifies the line style to apply to border of lines.
Thickness
Specifies the thickness for the border.
End Caps
Specifies the ending style of the border line.
butt
Ends unclosed sub paths and dash segments with no added decoration.
round
Ends unclosed sub paths and dash segments with a round decoration that has a radius equal to half
of the width of the pen.
square
Ends unclosed sub paths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Line Joint
Specifies the line joint style for the border line.
miter
Joins path segments by extending their outside edges until they meet.
round
Joins path segments by rounding off the corner at a radius of half the line width.
bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
Sample
Displays a preview sample of your selection.
Path
Specifies the fill pattern of the border line.
Outline Path
Specifies the fill pattern of the border line to be outline path.
Fill Path
Specifies the fill pattern of the border line to be whole path.
Dash
Specifies the dash size of border line.
auto fit
If selected, the data labels will be displayed automatically.
top center
If selected, the data labels will be displayed on the top center of the nodes on lines.
top left
If selected, the data labels will be displayed on the top left of the nodes on lines.
top right
If selected, the data labels will be displayed on the top right of the nodes on lines.
bottom left
If selected, the data labels will be displayed on the bottom left of the nodes on lines.
bottom center
If selected, the data labels will be displayed on the bottom center of the nodes on lines.
bottom right
If selected, the data labels will be displayed on the bottom right of the nodes on lines.
Font
Specifies the font format of text in the data labels.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Specifies the special effects of text in the data labels.
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
Fill tab
Border tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Scale X
Specifies the left position of the area, measured in the percentage of the image's width, from the left
edge of the image.
Scale Y
Specifies the bottom position of the image, measured in the percentage of the image's height, from the
bottom edge of the image.
Constraint Proportion
Specifies whether to set the same scaling ratios for both X and Y axes.
Depth
Specifies the scaling ratios of the depth for the paper.
Constraint Proportion
Specifies whether to set the same scaling ratios for width, height and depth of the paper.
Fill tab
Specifies the color to fill the chart paper.
Color
Specifies the color to fill the paper.
Transparency
Specifies the transparency of the color.
Sample
Displays the specified color and transparency effects.
Border tab
Specifies properties for border of the chart paper.
Border Style
Specifies the type for border of the paper.
Color
Specifies the color for border of the chart paper.
Line Style
Specifies the line style to apply to border of the chart paper.
Thickness
Specifies the thickness of the border.
Transparency
Specifies the transparency for the color of the border.
End Caps
Butt
Ends unclosed sub paths and dash segments with no added decoration.
Round
Ends unclosed sub paths and dash segments with a round decoration that has a radius equal to half
of the width of the pen.
Square
Ends unclosed sub paths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Line Joint
Specifies the line joint style for the border line.
Miter
Joins path segments by extending their outside edges until they meet.
Round
Joins path segments by rounding off the corner at a radius of half the line width.
Bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
Path
Specifies the fill pattern of the border line.
Outline Path
Specifies the fill pattern of the border line to be outline path.
Fill Path
Specifies the fill pattern of the border line to be whole path.
Dash
Specifies the dash size of border line.
General tab
Fill tab
Border tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
General tab
Specifies the options which are available when you format a pie chart.
Option
Gap Amount
Specifies the gap between two pies.
Explode Amount
Specifies the gap between every section and the central point of a pie.
Data Label Type
Specifies the display type for data value in the data label. It can be value, category name, percent,
value and percent.
Show Pie Name
Specifies whether to show the name of the pie.
Fill tab
Specifies the color, fill effect and transparency for the pies.
Color
Specifies the color schema for the pies.
Transparency
Specifies the transparency of the color schema that is applied to the pies.
Pattern List
Specifies the Pattern List dialog to modify color pattern of pies in the same data series.
Sample
Displays a preview sample of your selection.
Border tab
Specifies the properties for the border of the pies.
Border Type
Displays the type for border of the pies. The default value is solid, and cannot be changed.
Color
Specifies the color for the border of the pies.
Transparency
Specifies the transparency for color of the border.
Line Style
Specifies the line style to apply to the border of the pies.
Thickness
Specifies the weight of the border.
End Caps
Specifies the ending style of the border line.
butt
Ends unclosed sub paths and dash segments with no added decoration.
round
Ends unclosed sub paths and dash segments with a round decoration that has a radius equal to half
of the width of the pen.
square
Ends unclosed sub paths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Line Joint
Specifies the line joint style for the border line.
miter
Joins path segments by extending their outside edges until they meet.
round
Joins path segments by rounding off the corner at a radius of half the line width.
bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
Sample
Displays a preview sample of your selection.
Path
Specifies the fill pattern of the border line.
Outline Path
Specifies the fill pattern of the border line to be outline path.
Fill Path
Specifies the fill pattern of the border line to be whole path.
Dash
Specifies the dash size of border line.
auto fit
If selected, the data labels will be displayed automatically.
sticker
If selected, the data labels will be displayed next to pies.
slim leg
If selected, the data labels will be displayed beside pies and pointed by thin lines.
best fit
If selected, the data labels will be displayed at the best fit position automatically.
on slices
If selected, the data labels will be displayed on the slices of pies.
Font
Specifies the font format of text in the data labels.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Specifies the special effects of text in the data labels.
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
Fill tab
Border tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Fill tab
Specifies the color schema to fill the platform.
Color
Specifies the color with which to fill the platform.
Transparency
Specifies the transparency of the color.
Sample
Displays the selected color and its transparency effects.
Border tab
Specifies the properties for borders of the chart platform.
Border Type
Specifies the type for border of the platform.
none
The object has no visible border lines (default value).
raised
The object has 3D borders that appear as if they are raised off the page.
recess
The object has 3D borders that appear as if they are pressed into the page.
shadow
The object has two shadowed borders, beneath and to the right of the object.
Color
Specifies the color for border of the platform.
Transparency
Specifies the transparency for color of the border.
Line Style
Specifies the line style to apply to the border of the platform.
Thickness
Specifies the thickness of the border.
End Caps
Specifies the ending style of the border line.
butt
Ends unclosed sub paths and dash segments with no added decoration.
round
Ends unclosed sub paths and dash segments with a round decoration that has a radius equal to half
of the width of the pen.
square
Ends unclosed sub paths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Line Joint
Specifies the line joint style for the border line.
miter
Joins path segments by extending their outside edges until they meet.
round
Joins path segments by rounding off the corner at a radius of half the line width.
bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
joint round
Joins path segments by rounding off the corner at the specified radius.
Path
Specifies the fill pattern of the border line.
Outline Path
Specifies the fill pattern of the border line to be outline path.
Fill Path
Specifies the fill pattern of the border line to be whole path.
Dash
Specifies the dash size of border line.
Radius
Specifies the radius for the border joint of the platform border line. This option is available only when
the border line joint is set to joint round.
General tab
Fill tab
Border tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
General tab
Specifies the general format of the radar chart.
Options
Line
Thickness
Specifies the thickness for the radars lines.
Node Style
Specifies the type of node styles on the radars lines.
Width
Specifies the width for node styles on the radars lines.
Height
Specifies the height for node styles on the radars lines.
Arrow Style
Specifies the style for arrows on the lines.
None
If selected, no style will be applied to the arrows.
Sharp
If selected, arrows will be sharp.
Round
If selected, arrows will be round.
Plain
If selected, arrows will be plain.
Fill tab
Specifies the color, fill effect and transparency for the radars.
Color
Specifies the color schema of the radars.
Transparency
Specifies the transparency of the color schema that is applied to the radars.
Pattern List
Opens the Pattern List dialog to modify color pattern of radars in the same data series.
Sample
Displays a preview sample of your selection.
Border tab
Specifies properties for border of the radars.
Border Type
Displays the type for border of the radars. The default value is solid, and cannot be changed.
Color
Specifies the color for border of the radars.
Transparency
Specifies the transparency for color of the border.
Line Style
Specifies the line style to apply to border of the radars.
Thickness
Specifies the weight of the border.
End Caps
Specifies the ending style of the border line.
butt
Ends unclosed sub paths and dash segments with no added decoration.
round
Ends unclosed sub paths and dash segments with a round decoration that has a radius equal to half
of the width of the pen.
square
Ends unclosed sub paths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Line Joint
Specifies the line joint style for the border line.
miter
Joins path segments by extending their outside edges until they meet.
round
Joins path segments by rounding off the corner at a radius of half the line width.
bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
Sample
Displays a preview sample of your selection.
Path
Specifies the fill pattern of the border line.
Outline Path
Specifies the fill pattern of the border line to be outline path.
Fill Path
Specifies the fill pattern of the border line to be whole path.
Dash
Specifies the dash size of border line.
auto fit
The data labels will be displayed automatically.
Font
Specifies the font format of text in the data labels.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Specifies the special effects of text in the data labels.
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
General tab
Fill tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
General tab
Specifies the general format of the scatter chart.
Layout
Specifies the layout for scatter markers in the chart.
No line
If selected, no lines will be used to joint scatter markers in the chart.
Straight line
If selected, straight lines will be used to joint scatter markers in the chart.
Curved line
If selected, curved lines will be used to joint scatter markers in the chart.
Line
Specifies properties for lines of the scatter chart.
Thickness
Specifies the thickness for lines in the scatter chart.
Node
Specifies properties for line nodes in the scatter chart.
Style
Width
Specifies the width for line nodes.
Height
Specifies the height for line nodes.
Fill tab
Specifies the color, fill effect and transparency of the scatter markers.
Color
Specifies the color schema for the scatter markers.
Transparency
Specifies the transparency of the color schema that is applied to the scatter markers.
Pattern List
Opens the Pattern List dialog to modify color pattern of scatter markers in the same data series.
Sample
Displays a preview sample of your selection.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Specifies the special effects of text in the data labels.
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
Axis tab
Font tab
Orientation tab
Format tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Axis tab
Specifies the general properties for the series(Z) axis of the chart.
Option
Specifies options for the series(Z) axis.
Number of Labels
Specifies how many labels to be displayed in the series(Z) axis.
Label Every N Tick Marks
Specifies whether to display a label every N tick marks.
Draw Axis Only
Specifies whether to show the labels on the series(Z) axis.
Show Gridlines
Specifies whether to show the horizontal gridlines in the chart.
Show Axis Label Tips
Specifies whether to display the complete label text when the mouser pointer points at a label on the
series(Z) axis.
Line
Specifies the line style for the series(Z) axis.
Color
Transparency
Specifies the transparency for the color of the line.
Style
Specifies the style for line of the series(Z) axis.
Thickness
Specifies the thickness for the line of the series(Z) axis.
Labels
Specifies properties for the labels on the series(Z) axis.
Tick Mark
Specifies general properties for all the tick marks on the series(Z) axis.
Color
Specifies the color for all the tick marks on the series(Z) axis.
Transparency
Specifies the transparency for the tick marks on the series(Z) axis.
Style
Specifies the type for tick marks on the series(Z) axis.
Thickness
Specifies the thickness for the tick marks on the series(Z) axis.
None
If selected, major tick marks will not be shown on the series(Z) axis.
Inside
If selected, major tick marks will be inside the chart.
Outside
If selected, major tick marks will be outside the chart.
Cross
If selected, major tick marks will be across the series(Z) axis.
Major Tick Length
Specifies the length of major tick marks on the series(Z) axis.
None
If selected, minor tick marks will not be shown on the series(Z) axis.
Inside
If selected, minor tick marks will be inside the chart.
Outside
If selected, minor tick marks will be outside the chart.
Cross
If selected, minor tick marks will be across the chart.
Minor Tick Length
Specifies the length for the minor tick marks on the series(Z) axis.
Font tab
Specifies the font format of text in the tick mark labels on the series(Z) axis.
Font
Specifies the font format of text in the tick mark labels.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
Sample
Displays the specified font and any text effects.
Orientation tab
Specifies the rotation angle of the tick mark labels on the series(Z) axis.
Automatic
Specifies to adjust the rotation angle of the label text on the axis automatically according to the length
of the label text, in degrees.
When this option is checked by default:
If the text can be completely displayed horizontally, the default rotation angle will be 0.
If the text can not be completely displayed horizontally, the default rotation angle will be 30
anticlockwise, and the cut off part will be shown as suspension points.
Angle
Specifies to customize the rotation angle of the label text on the axis. When you change the rotation
angle in the text box, the red line in the spin box will change correspondingly, and vice versa.
Format tab
Specifies some properties for the tick mark labels on the series(Z) axis.
Category
Specifies different formats to display the tick mark labels on the series(Z) axis.
Scale
Lists all the formats of a value of a scale type that can be applied to the tick mark labels.
Number
Lists all the formats of a value of a number type that can be applied to the tick mark labels.
Date/Time
Lists all the formats of a value of a date/time type that can be applied to the tick mark labels.
Text
Lists all the formats of a value of a text type that can be applied to the tick mark labels.
Mapping
Lists all the formats of a value of a mapping type that can be applied to the tick mark labels.
Formats
Displays all the formats of the selected category. For more details about every format, see A detailed
chart property reference.
Properties
Specifies the properties for the format that you selected.
Sample
Displays the selected format effects.
Stack
Lists all the formats that you selected from different categories.
Add
Adds a format to the Stack list box.
Remove
Removes a format from the Stack list box.
Apply
Applies the specified format in the Stack list box to the tick mark labels.
General tab
Fill tab
Border tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
General tab
Specifies general format of the stock chart.
Stock Line
Specifies properties for the stock lines.
Color
Specifies the color schema for the stock lines.
Thickness
Specifies the thickness of the stock lines.
Stock Bar
Specifies properties for stock bars of an Open-High-Low-Close stock chart, which requires four series of
values in this order.
Up color
Specifies the color schema for stock bars that stand for the stocks that the Open value is lower than
the Close value.
Down color
Specifies the color schema for stock bars that stand for the stocks that the Open value is higher than
the Close value.
Bar Width
Specifies the width of the stock bars.
Fill tab
Specifies the color, fill effect and transparency for the stocks.
Color
Specifies the color schema for the stocks.
Transparency
Specifies the transparency of the color schema that is applied to the stocks.
Pattern List
Opens the Pattern List dialog to modify color pattern of stocks in the same data series.
Sample
Displays a preview sample of your selection.
Border tab
This tab allows you to specify the properties for border of the stocks.
Border Type
Displays the type for border of the stocks. The default value is solid, and cannot be changed.
Color
Specifies the color for border of the stocks.
Transparency
Specifies the transparency for color of the border.
Line Style
Specifies the line style to apply to border of the stocks.
Thickness
Specifies the weight of the border.
End Caps
Specifies the ending style of the border line.
butt
Ends unclosed sub paths and dash segments with no added decoration.
round
Ends unclosed sub paths and dash segments with a round decoration that has a radius equal to half
of the width of the pen.
square
Ends unclosed sub paths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Line Joint
Specifies the line joint style for the border line.
miter
Joins path segments by extending their outside edges until they meet.
round
Joins path segments by rounding off the corner at a radius of half the line width.
bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
Sample
Displays a preview sample of your selection.
Path
Specifies the fill pattern of the border line.
Outline Path
Specifies the fill pattern of the border line to be outline path.
Fill Path
Specifies the fill pattern of the border line to be whole path.
Dash
Specifies the dash size of border line.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Specifies the special effects of text in the data labels.
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
Fill tab
Border tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Fill tab
Specifies the color or fill effect and the transparency for the surfaces.
Color
Specifies the color schema for surfaces in the same data series.
Transparency
Specifies the transparency of the color schema that is applied to the surfaces in the same data series.
Pattern List
Opens the Pattern List dialog to modify color pattern of surfaces in the same data series.
Sample
Displays a preview sample of your selection.
Border tab
Specifies properties for border of the surfaces.
Border Style
Displays the type for border of the surfaces. The default value is solid, and cannot be changed.
Color
Specifies the color for border of the surfaces.
Transparency
Specifies the transparency for color of the border.
Line Style
Specifies the line style to apply to border of the surfaces.
Thickness
Specifies the weight of the border.
End Caps
Specify the ending style of the border line.
butt
Ends unclosed sub paths and dash segments with no added decoration.
round
Ends unclosed sub paths and dash segments with a round decoration that has a radius equal to half
of the width of the pen.
square
Ends unclosed sub paths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Line Joint
Specifies the line joint style for the border line.
miter
Joins path segments by extending their outside edges until they meet.
round
Joins path segments by rounding off the corner at a radius of half the line width.
bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
Sample
Displays a preview sample of your selection.
Path
Specifies the fill pattern of the border line.
Outline Path
Specify the fill pattern of the border line to be outline path.
Fill Path
Specify the fill pattern of the border line to be whole path.
Dash
Specifies the dash size of the border line.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Specifies the special effects of text in the data labels.
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
Paragraph tab
Font tab
OK
Accepts all changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes in this dialog.
Help
Displays this help document.
Paragraph tab
Specifies properties for the text in the paragraph.
Alignment
Specifies how paragraphs fit between the margins.
Left
Specifies to make the paragraph left-aligned.
Centered
Specifies to make the paragraph centered.
Right
Specifies to make the paragraph right-aligned.
Justified
Specifies to adjust the horizontal spacing so that text is aligned evenly along both the left and right
margins. Justifying text creates a smooth edge on both sides.
Indentation
Specifies the distance of the paragraph from either the left or right margins.
Left
Specifies the distance of the paragraph from the left margin.
Right
Specifies the distance of the paragraph from the right margin.
Special
Specifies to make the paragraph specially indented.
None
If selected, no special indent rule will be applied in this paragraph.
First line
If selected, use the First line indent in the paragraph with the length you specified in the By text
box.
Hanging
If selected, use the Hanging indent in the paragraph with the length you specified in the By text
box.
Spacing
Specifies the spaces between lines in the paragraph.
Before
Specifies the distance with N lines before the specified paragraph.
After
Specifies the distance with N lines after the specified paragraph.
Line Spacing
Specifies the amount of vertical space between lines of text in a paragraph.
Single
Accommodates the largest font in that line, plus a small amount of extra space. The amount of
extra space varies depending on the font used.
1.5 lines
One-and-one-half times that of single line spacing.
Double
Twice that of single line spacing.
At least
Minimum line spacing that is needed to fit the largest font or graphic on the line.
Exactly
Fixed line spacing that JReport Designer does not adjust.
Multiple
Line spacing that is increased or decreased by a percentage that you specify. For example, setting
line spacing to 1.2 will increase the space by 20 percent.
At
Effective only when you have selected At least, Exactly or Multiple. it specifies the distances
between lines.
Preview
Displays a preview sample of your selection.
Font tab
Specifies the font format of text in the paragraph.
Font list
Lists all the available font faces for the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of text.
Preview
Displays a preview sample of your selection.
Effects
Specifies special effect for the text.
Bold
Specifies whether the text to be bold or not.
Italic
Specifies whether the text to be italic or not.
Strikethrough
Specifies whether or not to draw a line through the text.
Underline
Specifies whether to use the horizontal line under the text or not.
Underline Color
Specifies the color for the horizontal line under the text.
Underline Style
Specifies the style of the horizontal line under the text.
Ignore HTML Tag
If true, the text will appear in the HTML file the same as that in JReport Designer (HTML tag elements
in the field value, if any, will not be parsed); or HTML tag elements of the text will be parsed while
the report set is to be saved as an HTML file.
Subscript
Specifies whether to make the specified text as subscript.
Superscript
Specifies whether to make the specified text as superscript.
Axis tab
Font tab
Orientation tab
Format tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Axis tab
Specifies the general properties for the value(Y) axis of the chart.
Option
Specifies the options for the value(Y) axis.
Minimum Value
Specifies the minimum value that is to be displayed on the value(Y) axis.
Maximum Value
Specifies the maximum value that is to be displayed on the value(Y) axis.
Increment
Specifies the difference between two adjacent values on the value(Y) axis.
Number of Tick Marks
Specifies how many tick marks to be displayed on the value(Y) axis.
Draw Axis Only
Specifies whether to show the labels on the value(Y) axis.
Show Gridlines
Specifies whether to show the horizontal gridlines in the chart.
Show Axis Label Tips
Specifies whether to display the complete label text when the mouser pointer points at a label on the
value(Y) axis.
Show Percent
Specifies whether to show the value labels on the value(Y) axis in percent. Only applies to radar,
bullet, bar/bench, line, and area chart that are not 100% stacked type.
Line
Specifies the line style for the value(Y) axis.
Color
Specifies the color of the line.
Transparency
Specifies the transparency for the color of the line.
Style
Specifies the style for the line.
Thickness
Specifies the thickness for the line.
Labels
Specifies the properties for the labels on the value(Y) axis.
Tick Mark
Specifies the general properties for all the tick marks on the value(Y) axis.
Color
Specifies the color of all the tick marks on the value(Y) axis.
Transparency
Specifies the transparency for the tick marks on the value(Y) axis.
Style
Specifies the type of the tick marks on the value(Y) axis.
Thickness
Specifies the thickness for the tick marks on the value(Y) axis.
None
If selected, major tick marks will not be shown on the value(Y) axis.
Outside
If selected, major tick marks will be outside the chart.
Inside
If selected, major tick marks will be inside the chart.
Cross
If selected, major tick marks will be across the value(Y) axis.
Major Tick Length
Specifies the length of major tick marks on the value(Y) axis.
None
If selected, minor tick marks will not be shown on the value(Y) axis.
Outside
If selected, minor tick marks will be outside the chart.
Inside
If selected, minor tick marks will be inside the chart.
Cross
If selected, minor tick marks will be across the chart.
Minor Tick Length
Specifies the length for the minor tick marks on the value(Y) axis.
Font tab
Specifies the font format for text in the tick mark labels on the value(Y) axis.
Font
Specifies the font format of text in the tick mark labels.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
Sample
Displays the specified font and any text effects.
Orientation tab
Specifies the rotation angle of the tick mark labels on the value(Y) axis.
Automatic
Specifies whether to adjust the rotation angle of the label text on the axis automatically according to
the length of the label text, in degrees.
When this option is checked by default:
If the text can be completely displayed horizontally, the default rotation angle will be 0.
If the text can not be completely displayed horizontally, the default rotation angle will be 30
anticlockwise, and the cut off part will be shown as suspension points.
Angle
Specifies to customize the rotation angle of the label text on the axis. When you change the rotation
angle in the text box, the red line in the spin box will change correspondingly, and vice versa.
Format tab
Specifies some properties for the tick mark labels on the value(Y) axis.
Category
Specifies different formats to display the tick mark labels on the value(Y) axis.
Scale
Lists all the formats of a value of a scale type that can be applied to the tick mark labels.
Number
Lists all the formats of a value of a number type that can be applied to the tick mark labels.
Date/Time
Lists all the formats of a value of a date/time type that can be applied to the tick mark labels.
Text
Lists all the formats of a value of a text type that can be applied to the tick mark labels.
Mapping
Lists all the formats of a value of a mapping type that can be applied to the tick mark labels.
Formats
Displays all the formats of the selected category. For more details about every format, see A detailed
chart property reference.
Properties
Specifies the properties for the format that you selected.
Sample
Displays the selected format effects.
Stack
Lists all the formats that you selected from different categories.
Add
Adds a format to the Stack list box.
Remove
Removes a format from the Stack list box.
Apply
Applies the specified format in the Stack list box to the tick mark labels.
Axis tab
Font tab
Orientation tab
Format tab
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
Axis tab
Specifies the general properties for the value(Y2) axis of the chart.
Option
Specifies the options for the value(Y2) axis.
Minimum Value
Specifies the minimum value that is to be displayed on the value(Y2) axis.
Maximum Value
Specifies the maximum value that is to be displayed on the value(Y2) axis.
Increment
Specifies the difference between two adjacent values on the value(Y2) axis.
Number of Tick Marks
Specifies how many tick marks to be displayed on the value(Y2) axis.
Draw Axis Only
Specifies whether to show the labels on the value(Y2) axis.
Show Gridlines
Specifies whether to show the horizontal gridlines in the chart.
Show Axis Label Tips
Specifies whether to display the complete label text when the mouser pointer points at a label on the
value(Y2) axis.
Show Percent
Specifies whether to show the value labels on the value(Y2) axis in percent. Only applies to bar/
bench, line and area chart that are not 100% stacked type.
Line
Specifies the line style for the value(Y2) axis.
Color
Specifies the color of the line.
Transparency
Specifies the transparency for the color of the line.
Style
Specifies the style for the line.
Thickness
Specifies the thickness for the line.
Labels
Specifies the properties for the labels on the value(Y2) axis.
Tick Mark
Specifies the general properties for all the tick marks on the value(Y2) axis.
Color
Specifies the color of all the tick marks on the value(Y2) axis.
Transparency
Specifies the transparency for the tick marks on the value(Y2) axis.
Style
Specifies the type of the tick marks on the value(Y2) axis.
Thickness
Specifies the thickness for the tick marks on the value(Y2) axis.
None
If selected, major tick marks will not be shown on the value(Y2) axis.
Outside
If selected, major tick marks will be outside the chart.
Inside
If selected, major tick marks will be inside the chart.
Cross
If selected, major tick marks will be across the value(Y2) axis.
Major Tick Length
Specifies the length of major tick marks on the value(Y2) axis.
None
If selected, minor tick marks will not be shown on the value(Y2) axis.
Outside
If selected, minor tick marks will be outside the chart.
Inside
If selected, minor tick marks will be inside the chart.
Cross
If selected, minor tick marks will be across the chart.
Minor Tick Length
Specifies the length for the minor tick marks on the value(Y2) axis.
Font tab
Specifies the font format for text in tick mark labels on the value(Y2) axis.
Font
Specifies the font format of text in the tick mark labels.
Font list
Lists all the available font faces that can be selected to apply to the text.
Font Size
Specifies the font size of the text.
Font Color
Specifies the font color of the text.
Transparency
Specifies the transparency of the text.
Rotation
Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
Shearing
Specifies the gradient of the text.
Effects
Style
Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
Strikethrough
Specifies the style of the horizontal line with which the text is struck through. It can be one of the
following: none, thin line, bold line, and double lines.
Underline
Specifies the style of the horizontal line under the text. It can be one of the following: none, single,
single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
Superscript
Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is
available.
Embossed
Makes the text appear to be raised off the page in relief.
Outlined
Displays the inner and outer borders of each character.
Subscript
Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is
available.
Engraved
Makes the text appear to be imprinted or pressed into the page.
Shadowed
Adds a shadow beneath and to the right of the text.
Sample
Displays the specified font and any text effects.
Orientation tab
Specifies the rotation angle of the tick mark labels on the value(Y2) axis.
Automatic
Specifies whether to adjust the rotation angle of the label text on the axis automatically according to
the length of the label text, in degrees.
When this option is checked by default:
If the text can be completely displayed horizontally, the default rotation angle will be 0.
If the text can not be completely displayed horizontally, the default rotation angle will be 30
anticlockwise, and the cut off part will be shown as suspension points.
Angle
Specifies to customize the rotation angle of the label text on the axis. When you change the rotation
angle in the text box, the red line in the spin box will change correspondingly, and vice versa.
Format tab
Specifies some properties for the tick mark labels on the value(Y2) axis.
Category
Specifies different formats to display the tick mark labels on the value(Y2) axis.
Scale
Lists all the formats of a value of a scale type that can be applied to the tick mark labels.
Number
Lists all the formats of a value of a number type that can be applied to the tick mark labels.
Date/Time
Lists all the formats of a value of a date/time type that can be applied to the tick mark labels.
Text
Lists all the formats of a value of a text type that can be applied to the tick mark labels.
Mapping
Lists all the formats of a value of a mapping type that can be applied to the tick mark labels.
Formats
Displays all the formats of the selected category. For more details about every format, see A detailed
chart property reference.
Properties
Specifies the properties for the format that you selected.
Sample
Displays the selected format effects.
Stack
Lists all the formats that you selected from different categories.
Add
Adds a format to the Stack list box.
Remove
Removes a format from the Stack list box.
Apply
Applies the specified format in the Stack list box to the tick mark labels.
Fill
Specifies the color schema of the wall.
Transparency
Specifies the transparency of the color schema that is applied to the wall of the chart.
Bound
Specifies the fill color or effect to compound with the basic fill which is set in the Wall area.
Color
Specifies the fill color schema or effect to compound with the basic fill which is set for the walls of a
chart in the Wall area.
Transparency
Specifies the transparency of the color schema that is applied here.
Border
Specifies the color and its transparency for the border of the wall.
Color
Specifies the color schema for the border of the wall.
Transparency
Specifies the transparency of the color schema that is applied to the border of the wall.
Style
Specifies the style for the border of the wall.
Thickness
Specifies the thickness for the border of the wall.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Apply
Applies all changes and leaves the dialog open.
Help
Displays this help document.
New Formula
Creates a new formula
New Summary
Creates a new summary
New Parameter
Creates a new parameter.
Import UDF Classes
Opens the UDF Classes dialog to import user defined formula classes.
Save
Saves a formula to the default path
Save As
Saves a formula to your specified path.
Close
Closes the window.
Edit menu
Undo
Undoes an action.
Redo
Redoes an action.
Cut
Cuts the selected text in the Formula Text panel.
Copy
Copies the selected text in the Formula Text panel.
Paste
Pastes the text that was previously cut or copied in the Formula Text panel.
Delete
Deletes the selected text in the Formula Text panel.
Search
Brings out the Find/Replace dialog. You can then search for text in the Formula Text panel, and replace the found text
with different text.
View menu
Fields Panel
Specifies whether to show the Fields panel.
Functions Panel
Specifies whether to show the Functions panel.
Operators Panel
Specifies whether to show the Operators panel.
Sort Tree
Sorts functions in the Functions panel and fields in the Fields panel by names.
Formula menu
Check
Tests the syntax of your formula. If the syntax is incorrect, JReport gives the opportunity to correct the errors.
Add Bookmark
Adds a bookmark to a specific position.
Go to Previous Bookmark
Goes to the previous bookmark.
Go to Next Bookmark
Goes to the next bookmark.
Clear all Bookmarks
Clears all of the bookmarks.
Comment/Uncomment
Adds or removes comments.
Add Operators
Specifies a general operator to be used in the Formula Text panel.
Color Converter
A color palette is provided for you to insert the HEX code of a color simply by clicking the corresponding color in the
color palette instead of inputting the HEX code manually.
Auto Finish
Enables the automatic input of the other part of a sign pair right after you type in the first part when editing formula.
Formula References
Shows the formulas that reference the selected UDF function in the Functions panel.
Properties
Shows properties of the formula in the Formula Properties dialog.
Data Type
The data type of the returned value of the formula.
Precision
The precision of the returned value of the formula. If the precision is set to 0, all characters of the returned value will
be displayed; if it is set to N, only the first N characters will be displayed.
Scale
The number of digits to the right of the decimal point for the returned value of the formula.
Help menu
Toolbar
The following are commands on the toolbar:
New Formula
Creates a new formula.
New Summary
Creates a new summary.
New Parameter
Creates a new parameter.
Save
Saves a formula to the default path.
Save As
Saves a formula to your specified path.
Properties
Specifies the precision and scale properties of the formula.
Sort Tree
Sorts functions in the Functions panel and fields in the Fields panel by names.
Fields Panel
Specifies whether to show the Fields panel.
Functions Panel
Specifies whether to show the Functions panel.
Operators Panel
Specifies whether to show the Operators panel.
Fields panel
Displays a list of those fields that are available for formulas. Those fields contain table columns, formulas, summaries,
parameters and special fields. Select one field and double-click it to insert it into the formula text panel at the insertion
point.
Functions panel
Displays a list of JReport functions and imported user defined formula functions that are available for formulas. When you
select one function and double-click it, JReport will insert the selected function into the formula text panel at the insertion
point completely with its required syntax items (parentheses, commas, etc). For the usage of these functions, refer to
section Built-in functions and User-defined formula functions.
Operators panel
Displays a list of operators that are available for formulas. Select one operator and double-click it to insert the selected
operator into the formula text panel at the insertion point. For the usage of these operators, refer to section Operators.
Formula text panel
In this panel, you can build and edit your formula. There are several ways to work with formula:
Select formula components from the Fields, Functions and Operators panels on the top of Formula Editor, and then
double-click the components, JReport will then insert them in the formula;
The line numbers of the formula are marked in the left of the panel to help you check it easily.
Related topics:
Creating a formula
DSN Name
Specifies the name for the ODBC data source.
Options
These options are designed for experienced users, and when your database has some special
requirements.
Qualifier tab
Name Pattern
Specifies whether or not catalog or schema is used in data manipulation.
Unqualified Name
Neither catalog nor schema will be included in data manipulation. Example: SELECT t.c FROM t
2-Part Names
Uses schema in data manipulation. Example: SELECT schema.t.c FROM schema.t
3-Part Names
Uses both catalog and schema in data manipulation. Example: SELECT catalog.schema.t.c from
catalog.schema.t
This is very useful when the database contains tables with the same names in different catalogs and/
or schemas. If you only use an unqualified name, the SQL statement generated by JReport will not
contain the catalog and schema name, and therefore the result will be unpredictable.
Quote Qualifier
Specifies the characters, and then the qualifier name which contains the characters that will not be
quoted.
In JReport, you need quote with the character defined by the DBMS. The default character is double
quotation marks (" "). Two properties exist for the Quote Qualifier.
Default (JDBC)
If selected, the program will get the extra name characters from JDBC.
User Defined
If selected, you can modify the quote character according to the database system being used.
Extra Characters
Specifies the extra characters for identifier names.
Quote Character
Specifies the quote character.
Modify Qualifier
Edits the current qualifier.
Qualifier
Lists all the qualifiers available. You can change the current qualifier by selecting one from the
drop-down list. The default value is the first one in the list. If the database do not support qualifier,
there will be no drop-down list, and you cannot input the qualifier name.
Apply To
Tables
If checked, the modified qualifier will be applied to all tables in the connection.
Views
If checked, the modified qualifier will be applied to all views in the connection.
Imported SQLs
If checked, the modified qualifier will be applied to all imported SQLs in the connection
Stored Procedures
If checked, the modified qualifier will be applied to all stored procedures in the connection.
Note: All the changes you made in the Modify Qualifier panel will not be recorded in the Get
JDBC Connection Information dialog. That is to say, if you change any value in the panel and
apply it, when you open the dialog next time, it will keep to the original.
Restore Default
Restores values in the tab to defaults.
Apply
Accept the changes.
Date Format tab
Different database systems use different Date and Time formats for Date and Time values. The Date
Format tab is for specifying the format, so that when JReport sends the SQL statement with Date or
Time parameters, they can be correctly translated into the format of your database system.
For example, in an Oracle database, by default, the Date format is 'dd-MMM-yy'. However, in a Sybase
database system, the Date format is 'yyyy-MM-dd'. Thus, the Date format in the connection object is
required to be modified accordingly, in order for the JReport generated SQL statements to function
correctly with the database.
Date Format
Specifies the date format.
Time Format
Specifies the time format.
Timestamp Format
Specifies the timestamp format.
Symbol
Meaning
Presentation
year
number
month in year
number
day in month
number
number
minute in hour
number
second in minute
number
millisecond
number
Transaction tab
Read Only
Default
Accepts the settings from the database that you are connecting to.
Read Only
Users will only be able to access the database in read-only mode.
Read & Write
Users will be able to access the database in read-write mode.
Transaction Mode
Default
Accepts the settings from the database that you are connecting to.
None
Transactions are not supported.
Read Uncommitted
Transactions are not isolated from each other. If the DBMS supports other transaction isolation
levels, it ignores whatever mechanism it uses to implement those levels. So that they do not
adversely affect other transactions, transactions running at the Read Uncommitted level are usually
read-only.
Note: When Read Only is set and Transaction Isolation to be Read Uncommitted, it provides
faster access to the data but if a database transaction is rolled back the read will retrieve an
invalid row and result in an inaccurate report.
Read Committed
When one transaction is reading, updating or deleting a row, other transactions cannot update or
delete it until this transaction has been committed or rolled back.
Repeatable Read
When one transaction is updating, deleting several rows or inserting new rows into them, the other
transactions cannot also update or delete these rows, until this transaction has been committed or
rolled back.
Serializable
When one transaction is updating, deleting several rows or inserting new rows into them, the other
transactions cannot update, delete these rows, or insert any new rows into these rows, until this
transaction has been committed or rolled back.
Pre-join tab
Specifies whether or not to enable the Pre-join feature when building a query or defining join
relationships in business cubes.
Schema tab
Schema
Enables you to choose the schemas you want and makes JReport show the chosen schemas in the
Add Table dialog and Add View dialog.
Schema List
Lists the schemas for you to choose.
Included Schemas
Shows the selected schemas.
Load All Schemas
Enables JReport Designer to show all the schemas in database.
Modify Schema
Edits the current schema.
Schema List
Lists all the schemas available.
Apply To
Tables
If checked, the selected schema will be applied to all tables in the connection.
Views
If checked, the selected schema will be applied to all views in the connection.
Stored Procedures
If checked, the selected schema will be applied to all stored procedures in the connection.
Note: All the changes you made in the Modify Schema box will not be recorded in the Get JDBC
Connection Information dialog. That is to say, if you change any value in the box and apply it,
when you open the dialog next time, it will keep to the original.
Restore Default
Restores values in the tab to defaults.
Apply
Accepts the changes.
Related topics:
Group dialog
This dialog appears when you select the Group tab and then click the Add button in the Security dialog.
It helps you to specify the groups for the current security entry.
Source
Displays the group source information: a user-defined group or a group obtained from JReport Server.
All Users
Lists all the users available in the current security entry.
Users
Lists the users that have been added to the group.
All Roles
Lists all the roles available in the current security entry.
Roles
Lists the roles that have been added to the group.
Assigns all the users/roles in the current security entry to the group.
Min
Evaluates the records that have the lowest values for the selected field.
Max
Evaluates the records that have the largest values for the selected field.
Exist
Checks if there exists at least one qualified records.
Where,
+
Adds numbers or fields together in the Expression menu.
Subtracts numbers or fields together in the Expression menu.
*
Multiplies numbers or fields together in the Expression menu.
/
Divides numbers or fields together in the Expression menu.
=
Equates fields together.
"
Places quotations marks on long character strings or names that have blanks. For example, places quotes on values, such as "New
York" and "Washington DC".
||
Places fields together in the same Expression menu. For example: "New York" || "Washington DC".
()
Places the fields in parentheses.
Operators
Specifies the operator to compose the filter expression.
Value
Specifies the value used in the filter condition.
You can also use a parameter for runtime input. You can manually type the value or parameter name, or, for parameters, click
to select the parameter names in the Expressions dialog.
More
Lists some additional commands.
END
Finishes entering the condition
OR
Inserts the logic operator OR which is applied to this line and the next line.
Insert Row
Inserts a single Expression row.
Delete Row
Deletes a single Expression row.
OK
Accepts the changes and closes the dialog.
Cancel
Closes the dialog, leaving any changes unsaved.
Help
Displays this help document.
Adds all the dimension data in the Dimension box to the selected hierarchy tree.
Data screen
Display screen
Group screen
Summary screen
Chart screen
Filter screen
Style screen
Back
Goes back to the previous screen.
Next
Goes to the next screen.
Finish
Finishes creating the horizontal banded report and closes this wizard.
Cancel
Does not retain changes and closes this wizard.
Help
Displays this help document.
Data screen
Specifies the dataset used to create the banded object.
New
If checked, select a data source from the catalog resources to create a dataset that will be used to build the banded object.
When you choose to create the dataset from a query, you can click the Modify button to edit the query in the Query Editor if
required.
Existing
If checked, select a dataset from the ones existing in the open report set to create the banded object. Click the Modify
button to edit the dataset in the Dataset Editor if required.
Display screen
Specifies the data fields displayed in the banded object.
Resources
Lists all the available data resources.
Removes the specified field that is not required in the banded object.
Display Name
Shows the display names of the selected fields. You can double-click the name cells to edit them if required.
Sort Fields By
Opens the Sort Fields By dialog to specify how to sort data in the banded object.
Group screen
Specifies the fields that you want to use to group the data.
Resources
Lists all the available data resources.
Adds the selected field as the group by field in the banded object.
Ascend
Groups will be sorted in an ascending order (A, B, C).
Descend
Groups will be sorted in a descending order (C, B, A).
No Sort
Groups will be sorted in the original order in database.
Special Group
Opens the User Defined Group dialog to define grouping information.
For example, if you placed a field named Region for grouping, and this field contains all 50 states of the United States; and if
you want to see the data between Maryland (MD) and New York (NY), you can define the criteria by selecting the between
operator to further define your grouping information.
Sort Group By
Opens the Sort Group By dialog to set how groups will be sorted.
Special Function
If the group by field is of Numeric/String/Date/Time type, you can select a special function for the field in the Special Function
column to further specify to which level the data will be grouped by.
If Customize is selected, the Customized Function dialog will be displayed, in which you can set the function by your own.
Sort Group By
Specifies how to sort the groups. Activated only when you have clicked Sort Group By from the Sort column to define the
sorting manner of groups for the selected group level.
Special Group
Specifies how to group your information. Activated only when you have clicked Special Group from the Sort column to define a
special group.
Select N
Opens the Select N dialog to specify the Select N condition.
Group Filter
Opens the Group Filter dialog to specify the group filter condition.
Summary screen
Specifies the fields on which to create aggregate functions.
Resources
Lists all the available data resources.
Adds the selected field as the summary field to the banded object.
Aggregate Function
Specifies the function to summarize the selected field.
Break Field
Displays a defined field on which the summary will be calculated. If a summary field is added below the Banded Object node,
the break field is null and the summary will be calculated on the whole dataset.
Chart screen
Specifies to create a chart together with the banded object, which will be placed in the banded header panel. This screen is
available only when there is at least one group by field and one summary field which is calculated on this group by field in the
banded object.
No Chart
Specifies not to create a chart.
Bar Chart
Specifies to create a Clustered Bar 2-D chart together with the banded object.
Line Chart
Specifies to create a Line 2-D chart together with the banded object.
Pie Chart
Specifies to create a Clustered Pie chart together with the banded object.
Category
Lists the group by fields of the banded object on which the summary fields are calculated. Choose the field you want to display
on the category (X) axis of the chart from the drop-down list.
Series
Lists the fields that have been added as the group by fields of the banded object. Choose the field you want to display on the
series (Z) axis of the chart from the drop-down list.
Show Values
Lists the summary fields which are calculated based on the field you choose to display on the category axis of the chart.
Choose the value you want to display in the chart from the drop-down list.
Filter screen
Specifies to filter data displayed in the banded object.
For details about options in the screen, see Edit Filter dialog.
Style screen
Specifies the style of the banded object.
Style
Lists all the available styles that can be applied to the banded object.
Preview
Displays the selected layout and style effects.
Create a Banded Report
Creates a restricted version of a flow layout report, one that can contain a single horizontal banded object only. This layout
option is intended to provide compatibility with JReport Version 7 report templates.
Create a Flow Layout Report Containing a Banded Object
Creates a report that contains a horizontal banded object mapped to the specified dataset. This layout option is specified by
default.
Page Setup
Opens the Page Setup dialog to specify page properties.
Related topics:
Embedded CSS
Specifies to embed the cascading style sheet (CSS) in the exported HTML files; otherwise, the .css
file will be generated individually.
Single File
Generates the report result to a single HTML file.
No Hyperlink
If checked, there will be no hyperlinks for navigating previous and next pages on the navigation bar
of the exported HTML file.
No Page Number
If checked, there will be no page number information showing the current page number and total
page number on the navigation bar of the exported HTML file.
Drilldown
Generates the report result into an HTML file with the Drilldown feature enabled. The Drilldown feature
enables you to inspect certain items for further detailed data.
Section 508 Compliant Output
If checked, the accessibility attributes defined for the report elements via the Report Inspector will be
exported to the HTML format report result which is Section 508 compliant. See Accessibility for more
information.
When Section 508 Compliant Output is checked, the Use HTML Data Table and Relative Font Size
options will be checked and disabled. The output will be Section 508 compliant including HTML data
table, accessible attributes, and relative font feature.
Use HTML Data Table
Specifies whether the table and crosstab components will be output as table objects in the HTML format
result.
Absolute Font Size
Generates the report result using an absolute font size, which means that the font size is fixed, and
cannot be adjusted according to the font size settings in the web browser.
Relative Font Size
Generates the report result using a relative font size. The font size can be adjusted according to the
font size settings in the web browser.
Use Chart
Applet Chart
Uses a Java applet to display the charts in an HTML format result file.
Image Chart
If selected, charts will be displayed as images. You can specify the image type from the drop-down
list. The options are:
Auto-select
If selected, the image format will be detected to JPG or GIF by the JReport system automatically. If
the image colors are less than 256 colors, GIF will be applied; otherwise, it is JPG.
GIF
If selected, the GIF format will be applied, which is a lossless compression technique and supports
only 256 colors. GIF is better than JPG for images with only a few distinct colors, such as line
drawings, black and white images and small text that is only a few pixels high.
JPEG
If selected, the JPEG format will be applied, which is supported on the Web. JPEG is a lossy
compression technique that is designed to compress color and grayscale continuous-tone images.
JPEG images support 16 million colors and are best suited for photographs and complex graphics.
PNG
If selected, the PNG format will be applied, which provides a portable, legally unencumbered, wellcompressed (effectively 100 percent lossless compression), well-specified standard for lossless
bitmapped image file. PNG supports indexed-color images of up to 256 colors and shows a more
interchangeable, flexible and robust function than GIF.
Resolution
Specifies the resolution of the HTML result to zoom in/out, in DPI. The default value is obtained from
the operation system, which is the resolution of your monitor, for example, 72 DPI on Unix or 96 on
Windows. You can set higher/lower value to zoom in/out.
Web Browser
Specifies the web browser for which the HTML result adapts.
Text Overflow
Specifies whether the text overflow is visible or hidden.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Mark Items
Lists all the styles that are available for you to choose to apply to every mark item of the legend entry
marks.
Adds the specified mark item from the drop-down to the Mark Items list.
URL
Specify the source of the image button from a URL. You can click the Browse button to specify the path
or input the URL directly in the text field.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Replace
When there are users, groups and roles on the server with the same names as those on the local
computer, the setting from the server will replace those on the local computer. If the names of the
user/role are the same on both the Server and the local computer, you can use the server users/roles
to override any user defined ones.
Note: Permission settings for user defined users or roles will be lost once they are replaced.
Merge
When there are users, groups and roles on the server with the same names as those defined on the
local computer, the settings from the server will be maintained while being integrated with the
permissions from the local computer.
OK
Imports users, groups and roles from JReport Server and closes the dialog.
Cancel
Does not retain the changes and closes the dialog.
Help
Displays this help document.
Structure
Shows the structure of the hierarchical data source.
Columns
Specifies settings for the columns.
Element
Displays the field name in the selected node of table.
Selected
Specifies whether to import the field into the catalog.
Format
Specifies the format in which the field value is to be displayed in the report result. Varies for different
types of data, and can be manually defined.
Type
Specifies the data type of the column.
Precision
Displays the default value for each SQL type automatically. Click the cell and modify the value if
necessary.
Scale
Specifies the decimal place.
Nullable
Specifies whether the field is nullable. You have three options to choose: Nullable, No Nulls and
Nullable Unknown.
Currency
Specifies whether to use the Currency type for this field or not.
Array
Specifies whether to use the Array type for this field or not.
Load Tree
Analyzes and loads data tree from the external data source file. The structure is shown in the Structure
box after you click this button.
OK
Applies all changes here and closes the dialog.
Cancel
Does not retain changes and closes the dialog.
Help
Displays this help document.
Resources
Lists all the available data resources for the new detail column. Select the resource you want from the
list.
OK
Inserts the column with the specified resource and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Dataset
This node is automatically expanded when inserting a DBField. It lists the tables and fields from the
current dataset. If you want to insert DBField from another dataset, select the dataset from the
dataset drop-down list. You can also click the <Choose Data from...> item to create a new dataset if
required.
Formulas
This node is automatically expanded when inserting a formula field. It lists all the formulas in the
current catalog. You can also click the <Add Formula...> item to create one if required.
Parameters
This node is automatically expanded when inserting a parameter field. It lists all the parameters in
the current catalog. You can also click the <Add Parameter...> item to create one if required.
All
This radio button is available only when the dialog is opened from the Display Type dialog. You can
check it to add an All value to the list/drop-down list.
Insert Layout
When multiple fields are selected, you can arrange these objects horizontally or vertically by selecting
Horizontal or Vertical, or by selecting the Default radio button to set it with the default layout.
Vertically Space
Specifies the space between fields that are arranged vertically.
Horizontal Space
Specifies the space between fields that are arranged horizontally.
Insert
Inserts the selected fields into the specified location in the report.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Replaces the selected group by field in the table with the specified field in the Resources panel.
Group By
Lists the fields that are used to group data in the table.
Sort
Specifies how groups at the specific group level will be sorted.
Ascend
Groups will be sorted in an ascending order (A, B, C).
Descend
Groups will be sorted in a descending order (C, B, A).
No Sort
Groups will be sorted in the original order in database.
Special Group
Opens the User Defined Group dialog to define grouping information.
For example, if you placed a field named Region for grouping, and this field contains all 50 states of the United States; and if you
want to see the data between Maryland (MD) and New York (NY), you can define the criteria by selecting the between operator to
further define your grouping information.
Sort Group By
Opens the Sort Group By dialog to set how groups will be sorted.
Special Function
If the group by field is of Numeric/String/Date/Time type, you can select a special function for the field in the Special Function column
to further specify to which level the data will be grouped by.
If Customize is selected, the Customized Function dialog will be displayed, in which you can set the function by your own.
Group Above
Specifies to place the selected group by field above the detail panel.
Group Left Above
Specifies to place the selected group by field left above the detail panel.
Group Left
Specifies to place the selected group by field left to the detail panel.
Current
Specifies to run the current report set with the specified parameters.
Select Parameters
Specifies the parameters that are used to run the current report set. Once you select one of a
group of cascading parameters, all the other parameters in the cascading group will be selected
automatically, and vice versa.
Others
Report Sets
Specifies the target report sets to run. If all the selected report sets contain no parameters, you
cannot finish the dialog.
Parameter Information
Lists the parameters used by the selected report sets.
Related topics:
on
Join Table
Displays the tables on which the join is set up.
Add Condition
Adds a new condition line.
Delete
Deletes the selected condition line.
Group
Makes the selected conditions in one group. Conditions can also be added to an existing group by
selecting the conditions and the group while holding the Ctrl button, and then clicking the Group button.
Ungroup
Makes the selected condition ungrouped.
Up
Moves the selected condition up to a higher level.
Down
Moves the selected condition or group down to a lower level.
Logic
Lists the logic operator.
And
Logic operator And which is applied between this and the next line or between more than two lines of
a group.
Or
Logic operator Or which is applied to this and the next line.
And Not
Logic operator And Not which is applied to this and the next line.
Or Not
Logic operator Or Not which is applied to this and the next line.
Column
Specifies the column that will be used in the join condition.
Operator
Specifies the operator to compose the join condition.
=
Displays values that are equal to each other.
>
Displays values that are greater on the left side.
<
Displays values that are greater on the right side.
>=
Displays values that are greater than or equal to the left side.
<=
Displays values that are greater than or equal to the right side.
<>
Displays values that are not equal to each other.
SQL Statement
Displays the SQL statement of the join condition.
Delete Join
Deletes the join.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Adds a field of the parent data container to set up links between the parent and child data containers.
Fields(Parent)
Lists the selected fields of the parent data container.
OP
Specifies the operator to setting up links between the parent and child data containers.
Fields(Child)
Lists the DBFields in the dataset of the child data container which are of the same data type as the
selected fields in the parent data container.
Parameter tab
Specifies values for all parameters in the child data container.
Parameters
Lists all parameters contained in the dataset of the child data container.
Value
Lists all the DBFields, formulas, summaries and parameters in the dataset of the parent data
container which are of the same data type as the parameters of the child data container.
Adds a field in the child data container whose value will be returned to a parameter of the parent
data container.
Fields
Lists the selected fields in the child data container.
Parameters
Lists all the parameters in the parent data container which are of the same data type as the fields
selected in the child data container.
OK
Applies all changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Related topics:
Specifies the mail address that the field will be linked to.
OK
Applies all changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Component in Report
Lists the components in the linked report that will be interlinked with the primary report.
Add
Adds a component in the linked report to be interlinked with the primary report.
Remove
Removes the selected component from the Component in Report box.
Adds the selected field of the primary report to set up link between the primary report and the linked
report.
Fields(Primary)
Lists the selected fields of the primary report.
OP
Specifies the operator to set up links between the primary report and linked report.
Fields(LinkedReport)
Lists the DBFields in the datasets of the linked report which are of the same data type as the
selected fields in the primary report.
Parameters tab
This tab is available when the linked report uses parameters. It helps you to assign values to the
parameters of the linked report automatically.
Parameters
Lists all parameters contained in the datasets of the linked report.
Value
Lists all the DBFields, formulas, summaries and parameters in the datasets of the primary report
which are of the same data type as the parameters of the linked report.
Target Frame
Specifies the window or frame in which to load the linked report.
<Server Setting>
Loads the linked report according to setting of the Pop Up New Window for Links option in the
Configure DHTML Profile panel of the Profile dialog in JReport Server.
Same Frame
Loads the linked report into the same frame as the primary report.
Whole Window
Loads the linked report into the full browser window.
New Window
Loads the linked report into a new window. This window is not named.
Parent Frame
Loads the linked report into the parent frame of the frame in which the primary report is.
Other Frame
Loads the linked report into some other specified frame. If the frame name does not exist, the linked
report will be loaded into a new window.
OK
Applies all changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Related topics:
Specifies the URL for the hyperlink that is to be used to link the field. You can create a formula to
represent a URL to set the hyperlink. Give the formula a name and specify a URL as the content of the
formula.
Target Frame
Specifies the window or frame in which to load the location specified by the URL.
<Server Setting>
Loads the linked file according to setting of the Pop Up New Window for Links option in the Configure
DHTML Profile panel of the Profile dialog in JReport Server.
Same Frame
Loads the linked file into the same frame as the link.
Whole Window
Loads the linked file into the full browser window.
New Window
Loads the linked file into a new window. This window is not named.
Parent Frame
Loads the linked file into the parent frame of the frame that contains the link.
Other Frame
Loads the linked file into some other specified frame. If the frame name does not exist, the linked file
will be loaded into a new window.
OK
Applies all changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Data screen
Display screen
Group screen
Summary screen
Chart screen
Filter screen
Layout screen
Style screen
Back
Goes back to the previous screen.
Next
Goes to the next screen.
Finish
Finishes creating the mailing label report and closes this wizard.
Cancel
Does not retain changes and closes this wizard.
Help
Displays this help document.
Data screen
Specifies the dataset used to create the banded object.
New
If checked, select a data source from the catalog resources to create a dataset that will be used to build the banded object.
When you choose to create the dataset from a query, you can click the Modify button to edit the query in the Query Editor if
required.
Existing
If checked, select a dataset from the ones existing in the open report set to create the banded object. Click the Modify
button to edit the dataset in the Dataset Editor if required.
Display screen
Specifies the data fields displayed in the banded object.
Resources
Lists all the available data resources.
Removes the specified field that is not required in the banded object.
Display Name
Shows the display names of the selected fields. You can double-click the name cells to edit them if required.
Sort Fields By
Opens the Sort Fields By dialog to specify how to sort data in the banded object.
Group screen
Specifies the fields to group data in the banded object.
Resources
Lists all the available data resources.
Adds the selected field as the group by field in the banded object.
Ascend
Groups will be sorted in an ascending order (A, B, C).
Descend
Groups will be sorted in a descending order (C, B, A).
No Sort
Groups will be sorted in the original order in database.
Special Group
Opens the User Defined Group dialog to define grouping information.
For example, if you placed a field named Region for grouping, and this field contains all 50 states of the United States; and if
you want to see the data between Maryland (MD) and New York (NY), you can define the criteria by selecting the between
operator to further define your grouping information.
Sort Group By
Opens the Sort Group By dialog to set how groups will be sorted.
Special Function
If the group by field is of Numeric/String/Date/Time type, you can select a special function for the field in the Special Function
column to further specify to which level the data will be grouped by.
If Customize is selected, the Customized Function dialog will be displayed, in which you can set the function by your own.
Sort Group By
Specifies how to sort the groups. Activated only when you have clicked Sort Group By from the Sort column to define the
sorting manner of groups for the selected group level.
Special Group
Specifies how to group your information. Activated only when you have clicked Special Group from the Sort column to define a
special group.
Select N
Opens the Select N dialog to specify the Select N condition.
Group Filter
Opens the Group Filter dialog to specify the group filter condition.
Summary screen
Specifies the fields on which to create aggregate functions.
Resources
Lists all the available data resources.
Adds the selected field as the summary field to the banded object.
Aggregate Function
Specifies the function to summarize the selected field.
Break Field
Displays a defined field on which the summary will be calculated. If a summary field is added below the Banded Object node,
the break field is null and the summary will be calculated on the whole dataset.
Chart screen
Specifies to create a chart together with the banded object, which will be placed in the banded header panel. This screen is
available only when there is at least one group by field and one summary field which is calculated on this group by field in the
banded object.
No Chart
Specifies not to create a chart.
Bar Chart
Specifies to create a Clustered Bar 2-D chart together with the banded object.
Line Chart
Specifies to create a Line 2-D chart together with the banded object.
Pie Chart
Specifies to create a Clustered Pie chart together with the banded object.
Category
Lists the group by fields of the banded object on which the summary fields are calculated. Choose the field you want to display
on the category (X) axis of the chart from the drop-down list.
Series
Lists the fields that have been added as the group by fields of the banded object. Choose the field you want to display on the
series (Z) axis of the chart from the drop-down list.
Show Values
Lists the summary fields which are calculated based on the field you choose to display on the category axis of the chart.
Choose the value you want to display in the chart from the drop-down list.
Filter screen
Specifies to filter data displayed in the banded object.
For details about options in the screen, see Edit Filter dialog.
Layout screen
Specifies the layout of the banded object.
Label Size
Specifies the size for the labels in the banded object.
Width
Specifies the width of the labels, in inches. By default, its value is 1.04.
Height
Specifies the height of the labels, in inches. By default, its value is 0.18.
Horizontal Gap
Specifies the horizontal gap between two labels, in inches. By default, its value is 0.42.
Vertical Gap
Specifies the vertical gap between two labels, in inches. By default, its value is 0.42.
Preview
Displays the selected layout for the label.
Style screen
Specifies the style of the banded object.
Style
Lists all the available styles that can be applied to the banded object.
Preview
Displays the selected style effects.
Create a Banded Report
Creates a restricted version of a flow layout report, one that can contain a single banded object only. This layout option is
intended to provide compatibility with JReport Version 7 report templates.
Related topics:
Priority
Specifies the priority of each condition.
High
Moves a condition up for a higher priority.
Low
Moves a condition down for a lower priority.
Add
Adds a new condition in the Edit Conditions dialog.
Remove
Edit
Edits the selected condition.
Format
Specifies the format for the areas defined in the selected condition.
Fill Color
Specifies the filling color for the areas.
Border Color
Specifies the border color for the areas.
Border Style
Specifies the border line style for the areas.
Border Width
Specifies the border width for the areas, in inches.
Note: The format set here corresponds with some formulas. After you save the map and the
corresponding catalog, and then load the catalog again, you will find some formulas are developed in
the catalog. You can edit the formulas in the Formula Editor. However, the change you make to the
formulas will not be reflected in the Map Area Conditional Formatting dialog.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Related topics:
Data screen
Group screen
Summary screen
Filter screen
Back
Goes back to the previous screen.
Next
Goes to the next screen.
Finish
Finishes data binding and closes this wizard.
Cancel
Does not retain changes and closes this wizard.
Help
Displays this help document.
Data screen
Define a dataset for the object
Specifies the dataset that will be bound with the map.
New
If checked, select a data source from the catalog resources to create a dataset to bind with the map. When you choose to
create the dataset from a query, you can click the Modify button to edit the query in the Query Editor if required.
Existing
If checked, select a dataset from the ones existing in the open report set to bind with the map. Click the Modify button to
edit the dataset in the Dataset Editor if required.
Current
If checked, the current dataset used by the parent object will be applied to the map.
Group screen
Specifies the field to group the data.
Resources
Lists all the available data resources.
Ascend
Groups will be sorted in an ascending order (A, B, C).
Descend
Groups will be sorted in a descending order (C, B, A).
No Sort
Groups will be sorted in the original order in database.
Special Group
Opens the User Defined Group dialog to define grouping information.
Sort Group By
Opens the Sort Group By dialog to set how groups will be sorted.
Special Function
If the group by field is of Numeric/String/Date/Time type, you can select a special function for the field in the Special Function
column to further specify to which level the data will be grouped by.
If Customize is selected, the Customized Function dialog will be displayed, in which you can set the function by your own.
Sort Group By
Specifies how to sort the groups. Activated only when you have clicked Sort Group By from the Sort column to define the
sorting manner of groups for the selected group level.
Special Group
Specifies how to group your information. Activated only when you have clicked Special Group from the Sort column to define a
special group.
Select N
Opens the Select N dialog to specify the Select N condition.
Group Filter
Opens the Group Filter dialog to specify the group filter condition.
Summary screen
Specifies the fields on which to create aggregate functions.
Resources
Lists all the available data resources.
Aggregate Function
Specifies the function to summarize the selected field.
Break Field
Displays a defined field on which the summary will be calculated.
Filter screen
Specifies to filter the data displayed on the map areas.
For details about options in the screen, see Edit Filter dialog.
Related topics:
Open
Specifies to import a .shp or .xml file which has been defined with some area information to the map
object.
Save
Accepts and saves the changes on the map object.
Save As
Saves the map object to an .xml file with the name you specify.
Canvas Setup
Opens the Map Canvas Setup dialog to change the width and height of the map object.
Close
Closes the window.
Edit menu
Undo
Reverses a previous action.
Redo
The counter-operation of Undo.
Cut
Erases an object and places it in the clipboard.
Copy
Copies an object and places it in the clipboard.
Paste
Takes an object from the clipboard and places it into the report.
Delete
Deletes a selected object.
Insert Mode
If checked, the window is in insert mode, and you can add areas into the map manually; if
unchecked, the window is in edit mode, and you can edit areas as required.
Reset All
Opens the Reset All dialog to reset the properties for map areas including the labels and summary
fields inside the areas globally.
Hide Duplicate Labels
If clicked, for map areas with the same name, only the label and summary field for the biggest area
will be shown.
View menu
Insert menu
Background Image
Specifies to select an image as background of the map.
Match Background Image
Resizes the map object to make it match the size of the background image. Activated only when the
size of the background image is not the same as that of the map object.
Label
Inserts a label to the map object.
Line
Inserts a line to the map object.
Bind Data
Opens the Map Data Binding Wizard to bind data to the map object.
Format menu
Conditional Formatting
Opens the Map Area Conditional Formatting dialog to add some conditional formats to the map areas.
Align
Left
Aligns the content in the selected object to the left boundary of the object.
Center
Aligns the content in the selected object to the center of the object.
Right
Aligns the content in the selected object to the right boundary of the object.
Justify
Adjusts horizontal spacing so that the content is aligned evenly along both the left and right
margins in the selected object.
Text Style
Bold
Specifies whether or not to bold the text in the selected object.
Italic
Specifies whether or not to italicize the text in the selected object.
Underline
Specifies whether or not to underline the text in the selected object.
Help menu
Help
Displays this help document.
Toolbar
The following are commands on the toolbar:
Open
Specifies to import a .shp or .xml file which has been defined with some area information to the map
object.
Save
Accepts and saves the changes on the map object.
Canvas Setup
Opens the Map Canvas Setup dialog to change the width and height of the map object.
Cut
Erases an object and places it on the clipboard.
Copy
Copies an object and places it on the clipboard.
Paste
Takes an object from the clipboard and places it into the map object.
Delete
Deletes a selected object.
Undo
Reverses a previous action.
Redo
The counter-operation of Undo.
Insert Mode
If pressed, the window is in insert mode, and you can insert areas into the map; otherwise, the
window is in edit mode, and you can edit the map areas.
Line
Inserts a line into the map object.
Bind Data
Opens the Map Data Binding Wizard to bind data to the map areas.
Conditional Formatting
Opens the Map Area Conditional Formatting dialog to add some conditional formats to the map areas.
Font Face Box
Specifies the font face of the text in the selected object.
Font Size Box
Specifies the font size of the text in the selected object.
Bold
Specifies whether or not to bold the text in the selected object.
Italic
Specifies whether or not to italicize the text in the selected object.
Underline
Specifies whether or not to underline the text in the selected object.
Justify
Adjusts horizontal spacing so that the content is aligned evenly along both the left and right margins
in the selected object.
Left
Aligns the content in the selected object to the left boundary of the object.
Center
Aligns the content in the selected object to the center of the object.
Right
Aligns the content in the selected object to the right boundary of the object.
Background Color
Specifies the background color of the selected object.
Foreground Color
Specifies the foreground color of the selected object.
Related topics
Inserting a map
Column in Detail
Specifies the field in the detail report which will be used to link the detail report with the master.
Op
Specifies the operator. Can be =, <>, >, >=, <, or <=.
Column in Master
Specifies the field in the master report.
Filter tab
Specifies the condition to further filter data in the detail report.
Adds a field of the master report to set up filter condition between the master report and the detail
report.
Fields(Master)
Lists the selected fields of the master report.
OP
Specifies the operator to set up the filter condition between the master report and detail report.
Fields(Detail)
Lists the DBFields in the datasets of the detail report which are of the same data type as the
selected fields in the master report.
More
Specifies relations between two conditions.
Parameters tab
This tab is only available when there is at least one parameter applied in the filters of the queries that
the detail report uses. It helps you to assign values to the parameters of the detail report automatically.
Use the same encoding and DB setting for the detail report as that of the master report
Specifies whether the detail report uses the same encoding and DB settings as per the master report.
Target Frame
Specifies the window or frame where to load the detail report.
<Server Setting>
Loads the detail report according to setting of the Pop up New Window for Links option in the
Configure DHTML Profile panel of the Profile dialog in JReport Server.
Same Frame
Loads the detail report into the same frame as the master report.
Whole Window
Loads the detail report into the full browser window.
New Window
Loads the detail report into a new window, which is not named. If this is selected, the detail report
will be opened independently when you click the trigger in JReport Viewer, that is to say the join and
filter conditions you set between the master report and detail report will not be applied.
Parent Frame
Loads the detail report into the parent frame of the frame in which the master report is.
Other Frame
Loads the detail report into some other specified frame. If the frame name does not exist, the detail
report will be loaded into a new window.
OK
Applies all changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Related topics:
Merge dialog
This dialog appears when you click Save in the Save To dialog to save your report set in another
directory in which a catalog of the same name exists. It helps you to merge the two catalogs.
Replaces the resource in the target catalog with the selected conflicting resource from the source
catalog.
Skip
Leaves the original value in the target catalog.
Differences
Displays the Properties Differences dialog to show the property values of the selected conflicting
resource in the two catalogs. The different properties are highlighted.
Note: Sometimes, even though some objects are marked in the Merge dialog, in the Properties
Differences dialog, you will not find different properties. The reason for this is that some children of the
two objects are different.
Target Relation
Shows the name of the resource and its parent node in the target catalog in the Target Relation dialog.
Merge
Closes the dialog and merges the two catalogs according to the changes that you have made.
Cancel
Closes the dialog, leaving any changes unsaved.
Help
Displays the help document.
Related topics:
Merging catalogs
Related topics:
Creating a catalog
OK
If New Style Sheet File is selected, clicking this button will bring out the Save CSS As dialog.
If any of the existing CSS files is selected, clicking this button will bring out the CSS Style Definition
dialog.
Cancel
Closes the dialog, leaving any changes unsaved.
Help
Displays this help document.
JDBC
If selected, a JDBC data source will be created and data stored in RDBMS can be accessed via JDBC
connection or JDBC-ODBC bridge.
XML
If selected, an XML data source will be created and data stored in XML instance can be accessed via
XML data transformation.
Use XML as
Specifies to create an XML data source as a relational one or a hierarchical one.
Hierarchical
If selected, a new hierarchical data source will be created.
User Defined
If selected, a new user defined data source will be created.
Web Service
If selected, a new web service data source will be created and the data can be retrieved through a
web service.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Related topics:
Banded
OK
Creates a report with the selected layout.
Cancel
Closes the dialog and deletes any unsaved changes.
Help
Displays this help document.
Related topics:
Creating a report
Banded
Creates a report containing a vertical banded object.
Table (Group Above)
Creates a report containing a table with group information above the detail panel.
Table (Group Left)
Creates a report containing a table with group information left to the detail panel.
Table (Group Left Above)
Creates a report containing a table with group information left above the detail panel.
Summary Table
Creates a report containing a table with only group and summary information.
Chart
Creates a report containing a chart.
Crosstab
Creates a report containing a crosstab.
Horizontal Banded
Creates a report containing a horizontal banded object.
Mailing Label
Creates a report containing a banded object in the form of a mailing label layout.
Tabular
Creates a report containing a tabular component.
Blank
Creates a report with nothing in it.
OK
Creates a report set containing its first report with the selected layout.
Cancel
Closes the dialog and deletes any unsaved changes.
Help
Displays this help document.
Related topics:
To specify the sum on field, highlight it in the Resource box and then click
On to add it to the field box.
next to Summary
Static Summary
If selected, the summary will take effect on a specific group that you define in the Group By field and it
can only be inserted into the group.
Group By
Specifies the field used to group the data.
To specify the group by field, highlight it in the Resource box and then click
By to add it to the field box.
next to Group
Dynamic Summary
If selected, the summary will take effect on the group according to the number, which is specified in
the Group By field and it can be inserted into any groups of a component.
Group By
Specifies on which group the summary will take effect.
To specify the group level, first select Up or Down from the drop-down list, then in the combo box,
select a value or input an integer, which should be between 0 to 127, to specify the group on which
the summary will take effect. For example, if you select Up or Down and input 0 in the combo box
and insert this summary into any group, the summary will take effect on this group; if you select Up
and input 1 and insert this summary to a group, the summary will take effect on the group higher
than the group where the summary is inserted, and if you specify Down and 1, it will take effect on
the lower group; and the rest may be deduced by analogy.
Notes:
If the dynamic summary is to be used in a chart, when defining the summary, you must
choose Down from the Group By drop-down list; if it is to be inserted to other data containers,
the summary must be defined on Up level.
When you insert a dynamic summary into a report and there is no corresponding group level
to match settings of the dynamic summary, an error message will be generated.
Special Function
If the group by field is of Numeric/String/Date/Time type, you can select a special function for the field
in the Special Function drop-down list to further specify to which level the data will be grouped by. If
Customize is selected, the Customized Function dialog will be displayed, in which you can set the
function by your own.
OK
Accepts all changes and closes the dialog.
Apply
Applies all changes to the existing summary or adds the new summary to the catalog.
Cancel
Does not retain any changes and closes this dialog.
Help
Displays this help document.
Related topics:
Creating a summary
Language
Displays the languages into which the display text in the report set will be translated.
Opens the Add Language dialog to add languages for editing here.
on the NLS
Type
Lists types of display text for different objects.
Column
This type is only for DHTML. It is the type of display text of columns.
Prompt
Type of display text of parameter prompt value.
TOC
Type of display text on the TOC tree.
Key
Lists keys to indicate the objects in the original language.
Translate in <language>
Specifies to which the display text will be translated in the target language.
Adds available display text in the object of the report set for the target language.
Format tab
Specifies the format for all fields.
Label
Type of display text of label and some web controls.
Key
Displays formats of all fields in the report set in the original language.
Format in <language>
Specifies the format for every field in the report set in the target language.
Adds available formats in the object of the report set for the target language.
Font tab
Specifies font properties for every field in the report set.
Key
Lists font face and font size of all fields in the report set in the original language.
Font Face
Specifies font face for every field in the report set in the target language.
Font Size
Specifies font size for every field in the report set in the target language.
Adds available fonts in the object of the report set for the target language.
Language
Displays the languages into which the display text in the report set will be translated.
Opens the Add Language dialog to add languages for editing here.
Type
Lists types of display text for different objects.
Column
This type is only for DHTML. It is the type of display text of columns.
Prompt
Type of display text of parameter prompt value.
TOC
Type of display text on the TOC tree.
Key
Lists keys to indicate the objects in the original language.
Translate
Displays to which the display text is translated in the target language.
Font tab
Displays font properties in the target language's global NLS resource library.
Label
Type of display text of label and some web controls.
Key
Lists keys to indicate the fonts in the original language.
Font Face
Displays font face for the key in the target language.
Font Size
Displays font size for the key in the target language.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and closes the dialog.
Help
Displays this help document.
Related topics:
NLS Editor
List
Displays the files with names only.
Details
Displays the files with detailed information such as name, size, type and last modified time.
Name
Shows the name of all the report sets included in this catalog, based on the type you selected from
the Report Sets of Type drop-down list.
Size
Shows the size of the report sets.
Type
Shows the type of the report sets.
Modified
Shows the time when the report sets were modified at the last time.
Report Set Name
Shows the names of the selected report sets.
Report Sets of Type
Specifies the type of the report sets. When saving a report set, you can save it as four kinds of files:
cls (report set binary file), rpt (report set source file), cls.xml (XML format report set), or clx (selfcontained report set). A studio report can only be saved as the .wls file.
Recent tab
Lists all the report sets that have been opened recently.
Open
Opens the selected report sets and closes the dialog.
To open consecutive report sets, first click the first report set, press and hold down SHIFT, and then
click the last report set. Then click the Open button. The last report set will be the active report set.
To open report sets that are not consecutive, press and hold down CTRL, click each report set, and
then click the Open button. The last selected report set will be the active report set.
Cancel
Closes the dialog, leaving any changes unsaved.
Help
Displays this help document.
Open As dialog
This dialog appears when you open a self-contained report set from the Open Report Set dialog (a selfcontained report set is a binary report set file, which has a .clx suffix and contains not only the report
set's layout but also the catalog with its own resources). It helps you to specify the way in which the
self-contained report set will be opened.
If checked, all the differences between the two catalogs will be checked by JReport Designer.
If unchecked, only the differences that can cause the report engine to fail when running the report
set will be checked by JReport Designer.
OK
Opens the report set in the specified way and closes the dialog.
Cancel
Closes the dialog, leaving any changes unsaved.
Help
Displays this help document.
Options dialog
This dialog appears when you click File > Options on the menu bar, or click the Options button
on
the Catalog Browser toolbar. It helps you to configure JReport to your preferences and requirements.
The following are details about the options in the dialog:
General
Editor
Panel
Format
Dataset
Component
Preview
Catalog
Export to
Query Editor
Security
Cache
OK
Applies the changes and closes the dialog.
Cancel
Does not retain the changes and closes the dialog.
Apply
Applies the changes and leaves the dialog open.
Help
Displays this help document.
General
The following are details about options of this category.
Specifies whether or not to show the prompt message when a blank report is created.
Show hidden objects
Specifies whether or not to show objects that are hidden in your report.
Show real view of subreport
Specifies whether or not to show the detailed structure of a subreport in its primary report in design
mode.
Set maximum number of open report sets
Specifies the maximum number of the report sets that can be opened in JReport Designer.
Set recently used report set names to display
Specifies the number of report set names that are recently used to display.
Backup files automatically before saving modifications
Specifies whether or not to generate the backup files (.cat.bak and .cls.bak ) of the catalog and report
when they are saved.
High Precision View
Specifies the default value for the High Precision View option on the View menu.
Show tips
Specifies whether or not to show the tooltips.
Show warning message when CSS properties are not supported by JReport
Specifies whether or not to show the warning message when the applied CSS style contains properties
that JReport does not support.
Check the availability of dynamic chart for Excel
Specifies to check if a chart can be correctly mapped to a banded object/table when you save the report
or export it to Excel.
Default Chinese Encoding
Convert
Enables the converting encoding function. This function is applied to data which is stored using the
Unicode UTF8 in the database. When this function is enabled, the changes will only be apparent when
you view the report or export it to certain formats.
Restore Defaults
Restores values of all options to be the default ones.
Editor
The following are details about options of this category.
Specifies whether or not to show the guidelines in the main window of the reports.
Show paragraph marks
Specifies whether or not to show the paragraph marks in the design mode of Designer.
Show margins
Specifies whether to show the margins in the design area.
Margin Line Color
Specifies the margin line color that is to be displayed in reports.
Grids
Specifies the grid properties.
Show grids
Specifies whether to show grids in reports.
Snap to grids
Specifies whether to snap and lock objects with the grids when moving and placing objects around.
Size
Specifies the size of the grids in the design area.
Color
Specifies the grid color.
Display Attributes
Specifies the display attributes.
Decimals
Specifies the precision of the fractional data in reports. For instance, if you set Decimal to 3, then all
the property values of the objects in the Report Inspector will be rounded to the thousandth.
Units
Specifies the unit of the measurement in reports. It can be either centimeter or inch.
Resolution
Specifies the resolution. By default, it will be the resolution of your monitor.
Customize Toolbars
Opens the Customize Toolbars dialog to customize the toolbars.
Restore Defaults
Restores values of all options to be the default ones.
Panel
The following are details about options of this category.
Show Toolbox
Specifies whether to show the Toolbox panel in Designer.
Show Resource View
Specifies whether to show the Resource View panel in Designer.
Show Catalog Browser
Restore Defaults
Restores values of all options to be the default ones.
Format
The following are details about options of this category. The format properties set here will be applied to
all columns in a catalog.
Data Type
Specifies the data type of the columns.
Format
Specifies the format of the columns.
Font
Font Face
Specifies the font face of the column contents.
Font Size
Specifies the size of the font.
Horizontal Alignment
Specifies the horizontal alignment of the column contents.
Vertical Alignment
Specifies vertical alignment of the column contents.
Foreground
Specifies the color of the font foreground.
Autofit
Specifies whether to adjust the width according to the contents.
Word wrap
If checked, the contents will be wrapped.
Italic
If checked, italic fontface will be used.
Underline
If checked, the contents will be underlined.
Strikethrough
Specifies whether or not to draw a line through the column contents.
Bold
If checked, fold fontface will be used.
Border
Specifies properties of the column border.
Border Width
Specifies the width of the border. Can be from 1 to 3 points.
Border Color
Specifies the color of the border. Use a string like "0xff0000" to control or select a color from the
palette. This works only if you specify lines for the borders.
Top Line
Specifies the top border line style.
Bottom Line
Specifies the bottom border line style.
Right Line
Specifies the right border line style.
Left Line
Specifies the left border line style.
Shadow
Specifies to draw a shadow to the border.
Shadow Color
Specifies the color for the shadow. Use a string like "0xff0000" to control or select a color from the
palette.
Background
Specifies the color for the background of the columns.
Null Display
If there is no value in a column, JReport will display NULL as default. You can also set what will be
displayed when there is no value in the column by inserting the mouse in the Report Inspector and
inputting a value.
Pattern Style
Specifies the pattern for the columns.
Pattern Color
Specifies the color to draw the pattern using a string such as "0xff0000" or select a color from the dropdown menu.
Padding
Specifies the spaces between the contents of a column and its borders.
Top Padding
Specifies the space between the contents of a column and its top borders.
Bottom Padding
Specifies the space between the contents of a column and its bottom borders.
Left Padding
Specifies the space between the contents of a column and its left borders.
Right Padding
Specifies the space between the contents of a column and its right borders.
Note: Values specified here will be applied when data columns are added to a catalog. You can adjust the
values for each column in the Catalog Browser, or after the columns are added to reports in the Report
Inspector.
Dataset
The following are details about option of this category.
Use the current dataset when the requested data values are available in the current dataset
Specifies whether or not to use the current dataset when the requested data values are available in the
current dataset.
Inherit dataset when component's dataset is the same as its parent's
Specifies whether or not to inherit dataset when component's dataset is the same as its parent's dataset.
Restore Defaults
Component
The following are details about options of this category.
static
If selected, the component will be positioned at the location in which it is inserted.
relative
If selected, the component will be positioned at an offset to the position in which it is inserted. The
offset is determined by the X and Y coordinate property values.
absolute
If selected, the component will be located at the position specified by dragging and dropping or by
setting its X and Y coordinate property values.
When you insert a table, horizontal table, chart, tabular, banded object, subreport or map component
into a flow layout container, this option does not take effect.
Since the position for all the components that are inserted into a banded panel is just absolute, so
when you insert component into the banded panel, this option does not take effect either.
Preview
The following are details about options of this category.
Browser
Specifies the browser for previewing reports as DHTML.
Preview using temporary file
Specifies whether to preview reports that you design in JReport Designer using a temporary file.
Start JReport Server when previewing report
Specifies whether to start JReport Server at the same time when you preview a report.
Start JReport Server when starting Designer
Specifies whether to start JReport Server when Designer is started.
Port
Specifies the port as the TCP port to which JReport Server listens.
Administration Port
Specifies the port used for remote administration.
Restore Defaults
Restores values of all options to be the default ones.
Catalog
The following are details about options of this category.
Sort
Specifies whether or not, and how to sort items in the Catalog Browser and report wizard.
Sort ascending
If selected, the data in the catalog will be sorted in an ascending order.
Sort descending
If selected, the data in the catalog will be sorted in a descending order.
Note: The sort function only applies to resources belong to the same parent node and of the same type.
And real objects in the catalog instead of logic folder nodes can be sorted.
Merge Catalog Options
Specifies the checking level of merging catalogs when you save a report to a directory where a catalog
already with the same name exists.
Export to
The options of this category are divided into three sub-tabs as listed below:
HTML tab
E-mail tab
Fax tab
Restore Defaults
Restores values of all options to be the default ones.
Layout Precision
Opens the Advanced Export Settings dialog to set the precision level for each export format.
HTML tab
Specifies the preferences for exporting the report results to HTML.
Chart
By default, JReport Designer will not display charts in HTML.
File
Specifies whether to convert the report into a single or multiple files.
Multiple files
If selected, JReport Designer will convert the report into multiple files and designates a serial number
for each HTML page. For example, if a 3-page report is named Sales, JReport Designer will create three
files called Sales_1.html, Sales_2.html, and Sales_3.html.
Single file
If selected, the report will be exported into one file.
E-mail tab
Specifies the preference for exporting the report results to E-mail.
SMTP Server
Specifies the numeric or named host of the machine where the e-mail server is located.
Port
Specifies the port where the e-mail server runs.
Mail Sender
Specifies the address of the e-mail sender. You must specify an address and make sure that the format
of the specified address is valid.
Default Mail Format
Specifies the format with which to send the report result.
Fax tab
Specifies the preference for exporting the report result to fax. You can specify to export the report results
either via a fax machine or a fax server.
Fax Machine
Specifies to export the report set results via a fax machine.
Dialing
Specifies the dialing mode of the fax modem. The options are Pulse or Tone.
Modem Class
Specifies the class of the modem. The options are as follows: Class 1, Class 2 or Class 2.0. All are fax
protocols. Most modem only support Class 1, so be sure that higher protocols are supported by the
modem if Class 2 or Class 2.0 is selected.
Initialization String
Initializes the modem. The string should be obtained from the modem manual.
Flow Control
Specifies the flow control mode between DTE (Data Terminal Equipment) and DCE (Data Circuitterminating Equipment). Options are as follows:
RtsCts
Flow control of the hardware.
Xon/Xoff
Flow control of the software.
None
No flow control specified.
Specifying flow control can help the compressing data function of the modem function better. Using
the RtsCts mode is recommended.
Flow Command
Specifies the flow command according to the flow control mode. The command should be obtained from
the modem manual.
Port
Specifies the port number. The port should be obtained from the modem manual.
Timeout
Specifies the maximum amount of time for how long the fax should wait for a response from the
destination before timing out.
Retries
When the line is busy, the report result cannot be faxed, so here you can specify the maximum number
of times the modem will retry faxing the report result.
Fax Server
Specifies to export the report set results via a fax server.
Retries
Specifies the number of times the modem retries faxing the report set result.
Print
The followings are details about options of this category.
JDK1.1
This method is quick in speed but the printing quality cannot be guaranteed.
JDK1.2
This method can give you a satisfactory result, even for a gif file, but it is slow in speed.
JDK1.4
Compared with the above two methods, this one is more advanced, and will give you a satisfactory
result.
Query Editor
The following are details about options of this category.
Auto join
Specifies the options for auto joins.
foreign key because it links the customer's ordering information in Table A to the customer's
information in Table B.
Pre-join
Specifies the default settings for pre-joins.
Additional Options
Specifies the additional options.
Restore Defaults
Security
The following are details about options of this category, with which you can set one or more user
accounts to use JReport Designer.
Administrator
Specifies the name for the new user account, and at least 4 characters are required.
Password
Confirm Password
Confirms the password that you specified in the Password text box.
Submit
Creates a user account.
Cancel
Discards the changes.
Security Manager
Lists all the user accounts.
Add
Adds a new user account.
Remove
Removes the selected user account.
Modify
Modifies the selected user account.
Cache
The following are details about options of this category, with which you can customize the image cache in
JReport Designer.
Cache images
Specifies whether or not to enable image cache.
Restore Defaults
Restores values of all options to be the default ones.
Type
Specifies the paper type.
Width
Specifies the width of the paper.
Height
Specifies the height of the paper.
Orientation
Specifies the paper orientation.
Portrait
If selected, the page will be displayed as portrait.
Landscape
If selected, the page will be displayed as landscape.
Margin
Specifies the distance of the report data to the top, bottom, left, or right edge of the page.
Top
Specifies the top margin of the page.
Bottom
Specifies the bottom margin of the page.
Left
Specifies the left margin of the page.
Right
Specifies the right margin of the page.
Set Default
Resets all options in the dialog to default values.
OK
Applies all changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Parameters dialog
This dialog appears when you select a web action which is with a parameter in the Web Action List
dialog and then click OK. It helps you to specify values of the parameter of an action.
Related topics:
Report Set
Specifies the report set which will be run with the parameter specified in the dialog after the event
bound with the action is triggered.
Browse
Searches for the desired report set. You can also enter the path and filename of the report set in
the text field manually.
Web Control
Specifies the web control from which the report set name is retrieved.
Target Frame
Specifies the window or frame in which the report set will be opened.
<Input>
Allows you to input the window or frame directly.
Constant
blank - Loads the report set into a new blank window. This window is not named.
self - Loads the report set into the window in which the link is clicked (the active window).
parent - Loads the report set into the immediate parent window of the active window. If there is
no parent window, the active window is used.
top - Loads the report set into the topmost window.
Related topics:
Fill
Specifies the pattern. The pattern can be one of the following: Automatic, Color, Texture, and
Gradient.
Transparency
Specifies the transparency.
Advanced
Opens the Advanced dialog to specify the fill effect for certain values.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
When you run a report in PDF format, JReport will take the result of the whole report as a graphic to
transform the report by the method of simulated printer and generate the report result in PDF format.
Generate charts and barcodes using vector graphics
The result of using Generate charts and barcodes using vector graphics is the same as with using
Generate charts and barcodes using images (recommended). However, when you run a report in PDF
format using Generate charts and barcodes using vector graphics, JReport will take the result of the
whole report as a dataset to transform the report by sequence and to generate the report result in PDF
format.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Swatches tab
HSB tab
RGB tab
Preview
Shows the specified color.
OK
Applies all changes and closes the dialog.
Cancel
Does not retain changes and closes the dialog.
Reset
Cancels all changes and allows you to reset the values of the color.
Swatches tab
Shows samples of the colors.
Swatches
Shows colors as samples for you to choose.
Recent
Shows the colors you have chosen recently.
Hex
Shows the RGB hexadecimal value of the color you choose, which can be copied by selecting it and
then pressing Ctrl+C on the keyboard, but it can not be edited.
HSB tab
Specifies the attributes of the color.
Image
Shows the attributes of the specified color, which can be changed by scrubbing the slider between the
pane and the banded frame up and down.
Hue
Specifies the chroma of the color, whose value is from 0 to 359.
Saturation
Specifies the saturation of the color, whose value is from 0 to 100.
Brightness
Specifies the brightness of the color, whose value is from 0 to 100.
Red
Specifies the red value, whose value is from 0 to 255.
Green
Specifies the green value, whose value is from 0 to 255.
Blue
Specifies the blue value, whose value is from 0 to 255.
Hex
Specifies the RGB hexadecimal value of the color, which changes along with the HSB and RGB values,
or it can be changed by entering a hexadecimal value mannually.
RGB tab
Specifies the RGB of the color.
Red
Specifies the red value, whose value is from 0 to 255.
Green
Specifies the green value, whose value is from 0 to 255.
Blue
Specifies the blue value, whose value is from 0 to 255.
Hex
Specifies the RGB hexadecimal value of the color, which changes along with the RGB values, or it can
Arrange
Organizes the tables in the table panel.
Help
Displays this help document.
Related topics:
Pre-joins
High
If checked, the report set results will be exported to the specified format with high precision.
Low
If checked, the report set results will be exported to the specified format with low precision.
OK
Applies the settings and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
New
Creates a filter.
Delete
Removes the selected filter.
Condition
Specifies the filter conditions.
Add Condition
Adds a new condition line.
Delete
Deletes the selected condition line.
Group
Makes the selected conditions in one group.
Ungroup
Makes the selected condition ungrouped.
Up
Moves the selected condition or group up to a higher level.
Down
Moves the selected condition or group down to a lower level.
Logic
Lists the logic operator.
And
Logic operator And which is applied to this and the next line or group.
Or
Logic operator Or which is applied to this and the next line or group.
Field
Specifies the field to be filtered. You can either type in the field directly or click
box to specify the field.
Operator
Specifies the operator to compose the filter expression.
=
Equal to
>=
Greater than or equal to
>
Greater than
<
Less than
<=
Less than or equal to
!=
Not equal to
[not] in
Causes an enumerated list of values to appear in the WHERE clause predicate, used for evaluating
for a true condition. For operator in' or not in', it is allowed to input multiple values in the Value
input box and separate the values with comma (,).
[not] like
Like string pattern matching operator is used to compare the first expression string value to the
pattern string (the second expression). If you want to use wildcard character in the pattern string,
only "_" and "%" are supported.
[not] between
Allows the system to evaluate whether or not data values are located between a range of values
indicated in the predicate. For operator between' or not between', there are two value input boxes
for inputting the same type of values.
is [not] null
It is used in WHERE clause predicates to match null values occurring in a specified data field. For
operator is null' or is not null', the value input box is hidden.
Value
Specifies the value of how to filter the field. You can either type in the value manually or click
next to the text box to specify the value.
When you type in the value, if multiple values are required, they should be separated with ",", and if
"," or "\" is contained in the values, write it as "\," or "\\".
When you click
Fields tab
Lists the fields which can be used in the filter expression. Double-click the required field to add it
as the filter value.
Value tab
Lists values of the field to be filtered. Double-click the required value to add it as the filter value.
SQL Statement
Displays the SQL statement of the filter condition.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Max Records
If checked, both the Max Records option and the Records per Page option will take effect.
All
If checked, all the records will be displayed when you preview the query, and the Max Records option
will be disabled.
OK
Applies the changes and brings out the Preview dialog or the Enter Parameter Values dialog (if there
are parameters in this query).
Cancel
Does not retain any changes and closes this dialog.
Help
Displays this help document.
Related topics:
Previewing a query
OK
Publishes the resources with the specified style groups and/or font files.
Cancel
Publishes the resources without any style groups/font files.
Help
Displays help document.
Properties tab
Specifies properties for the selected resource.
Active
The report set can be run, advanced run and scheduled on JReport Server.
Inactive
The report set cannot be run, advanced run or scheduled on JReport Server.
Incomplete
The report set is not completely designed and cannot be run, advanced run or scheduled on JReport Server.
Custom Field
Specifies custom field values for the selected resource if there are custom fields enabled on JReport Server. A custom field can be
regarded as a resource property.
Name
Displays name of the custom fields.
Value
Specifies value of the custom fields.
Role/User/Group
The tabs list JReport Server roles, users, and groups. You can apply permissions to them by selecting a role/user/group and then
hecking the checkboxes before the required permissions. For unwanted roles/users/groups, you can remove them by selecting one of
hem and then clicking the Remove button.
Permissions
Sets permissions to the selected role/user/group by checking the checkboxes before the required permissions.
Permission
Description
Visible
Allows or denies viewing object names in the resource tree or version table, such as folders, resources, and archive
versions.
Read
Allows or denies viewing object properties, versions, and, if it is a folder, folder content.
Write
Allows or denies publishing folders and resources, changing the properties (not including permission settings) of the
objects in the resource tree or version table, such as folders, resources, and archive versions, and modifying version
table settings.
Delete
Allows or denies deleting objects in the resource tree or version table, such as folders, resources, and archive
versions.
Execute
Allows or denies running resources in normal and advanced mode (report set type resources only).
Schedule
Allows or denies submitting resources to schedules (report set type resources only).
Grant
Update Status
Allows or denies updating report set status, and if it is a folder, the status of report sets in the folder.
Add
Adds roles/users/groups and assigns permissions to them.
Remove
Removes the selected role/user/group from the Role/User/Group tab. The removed roles/users/groups are still available for the case
when you want to add them back.
Modify
f the selected data source is built on a JDBC connection, the Modify button is activated. You can click it to modify properties of the data
ource connection in the Get JDBC Connection Information dialog.
Name
Lists the name of the connection properties.
Property
Lists the value of the properties.
OK
Applies the changes and publishes the resources to JReport Server.
Cancel
Closes the dialog, leaving any changes unsaved.
Help
Displays this help document.
Adds the highlighted report sets from the Select Report list to the list in the right.
Removes the highlighted report sets from the list in the right to the Select Report list.
Adds all the report sets in the Select Report list to the list in the right.
Removes all the report sets from the list in the right to the Select Report list.
To Local Directory
Specifies the directory where the catalog and report sets are to be published to. Type the directory in
the text box or click Browse to find a directory in the Get Directory dialog.
Note: You can type a directory that does not exist, and JReport Designer will create the new directory
automatically.
Back
Retains the changes and returns to the previous page.
Next
Retains the changes and go to the next page to view and modify the connection properties:
Finish
Saves the changes and makes JReport Designer publish the catalog and report sets.
Close
Does not retain the changes and closes the dialog.
Help
Displays this help document.
Apply
Accepts the changes on the query.
Save As
Add Table
Opens the Add table dialog to add tables from the current catalog to the query.
Delete Table
Deletes the selected table.
Union
Creates and modifies a union for the query.
Filter
Opens the Search Condition dialog to specify more criteria to limit the amount of data.
Select Distinct
When selected, in the SQL statement, the SELECT DISTINCT command will be used instead of SELECT.
Ignore Predicate If Parameter Value Is Null
If the query uses a parameter, and the parameter value is null at runtime, then this condition will be
removed from the query's criterion.
For string type parameters, when the value is left blank, if Ignore Predicate If Parameter Is Null is set
to true, the value of this parameter will be considered as NULL, and this predicate will not appear in
the WHERE clause; if false, it will be treated as an empty string().
Foreign Keys
Specifies to automatically join tables in the query through a reference from Table A to a primary key
in Table B. For example, an order form in Table A shows information on purchases that are made by
a customer. It can also show this customer's ID #. The customer ID # refers to a record in Table B
which lists a specific address, phone number, name, etc for the customer. The customer ID # in
Table A is a foreign key because it links the customer's ordering information in Table A to the
customer's information in Table B.
Primary Key with Same Names
Specifies to automatically join tables in the query through a field or a combination of fields that
uniquely and specifically identifies a record. For example, your credit card number is a primary key
because it specifically links to your birthday, credit history, address, etc.
Column menu
View menu
Edit SQL
Shows the SQL statement of the query.
Preview
Opens the Preview Option dialog to preview the records.
Help menu
Toolbar
The following are commands on the toolbar:
Add Table
Adds some extra tables to the query.
Delete Table
Removes some unwanted tables from the query.
Create Computed Column
The create functions are used for a particular query. It helps you to quickly and easily create columns
with the functions available instead of writing a formula.
Add Formula Field
Adds formulas to the query.
Delete Column
Arrange
Organizes joined or auto joined tables.
Preview
Opens the Preview Option dialog to preview the records.
Criteria panel
Lists all columns added to the query. You can specifically define criteria for the columns in this panel.
SQL
Shows the SQL statement of the query.
Show Paths
Shows information of the pre-join paths among tables in the query, when the pre-join feature is enabled.
OK
Accepts all changes and closes the window.
Cancel
Does not retain any changes and closes the window.
Apply
Accepts all changes in the window.
Help
Displays this help document.
Related topics:
Creating a query
Editing a query
Previewing a query
Related topics:
Query modifiers
be displayed.
Value Range
Specifies the value ranges.
Insert
Inserts the data field into the report as a rank display type.
Cancel
Does not retain changes and closes the dialog.
Help
Displays this help document.
Related topics:
Components - Ranks
Auto Start
Specifies whether to start the media file automatically when the report is opened in JReport Viewer or
JReport Studio.
Center
Specifies whether to place the presentation in the center of the image window and display it in its
original size (the size is determined by the Width and Height properties of the multimedia object in
Loop
Specifies whether to play the media file repeatedly.
Loop Number
Specifies the number of the times the media file will loop during playback.
Note: If you have checked the Loop option and specified the Loop Number at the same time,
the media file will be played back according to the specified number, which means the Loop
option will be ignored even though the loop number is set to zero.
Show Controls
Specifies the RealPlayer controls you want to show, which support specific RealPlayer functionality.
The controls will be reproduced in the report as they appear in RealPlayer.
All Controls
Specifies whether to show all controls. When it is checked, all the following controls will be selected
automatically.
Pause Button
Specifies whether to show the Pause Button.
Play Button
Specifies whether to show the Play Button.
Stop Button
Specifies whether to show the Stop Button.
Control Panel
Specifies whether to show the Control Panel, which contains the following playback controls: Play
Button, Pause Button, Stop Button, Fast-forward Button, Rewind Button, Position Slider and Home
Button.
Fast-forward Button
Specifies whether to show the Fast-forward Button.
Home Control
Specifies whether to show the Home Button, which is connected to the www.real.com website.
Image Window
Specifies whether to show the Image Window, which is used for displaying presentations.
Information Panel
Specifies whether to show the Information Panel that displays the title, author, and copyright for
the currently playing clip.
Volume Information
Specifies whether to show the Information/Volume Bar, which consists of the Information Panel
and the Mute/Volume Bar.
Mute Button and Volume Slider
Specifies whether to show the Mute Button and Volume Slider. If checked, the Volume Slider and
Mute checkboxes will be checked correspondingly. Otherwise, you can check Volume Slider or Mute
respectively.
Position Field
Specifies whether to show the Position Field, which shows the position of the current clip that
identifies the clip's current place within the presentation timeline and the total clip length.
Position Slider
Specifies whether to show the Position Slider, which shows the currently playing position within the
clip.
Rewind Button
Specifies whether to show the Rewind Button.
Status Bar
Specifies whether to show the Status Bar, which consists of a text message area, the network
congestion LED, and the current clip position indicator.
Status Field
Specifies whether to show the Status Field, which consists only of a text message area.
Information Field
Specifies whether to show the Information Field, which displays the title, author, and copyright for
the currently playing clip or portion of a multi-clip.
OK
Accepts all changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
User
The user ID to whom the security settings will be applied.
Role
The role of the user. More than one user can share one role; for one role, you only need to define once, and
other users can share this role without type the same conditions again.
Column
The condition expression is comprised of three parts - Column, Operator, and Value.
The column name, can be the name of a DBField in the current query, the name of a formula (summary)
based on any DBField in the current query, and the name of a parameter. You do not need to quote the
name when the name contains spaces. However, you must make sure the names you type actually exist.
Operator
The operator can be one of the following operators: =, <>, <, >, <=, >=, and IN.
Value
The value part of the condition expression.
For String type values, use single quotation mark (') to quote the values, e.g., 'Absolute Java';
For Date type values, make sure the format of the value you enter is consistent with that of your database.
Note: In the Record Level Security Information dialog, the date values provided on the drop-down list
may not be valid for your actual database, because they are date values that have already been
reformatted using your date format settings in JReport. For detailed information on how to set the
date format in JReport Designer, see Date Format.
For the values of other types, type them in their original form.
E-mail
e e-mail address of the user.
Title
e title for the user.
Import Text
Imports record level security settings from an external .txt file.
Add
Inserts a new row of user condition after the selected row.
Remove
Removes the selected row of user condition.
Clear All
Clears all the rows in the list.
OK
Accepts the changes and closes this dialog.
Cancel
Closes this dialog, leaving any changes unsaved.
Help
Displays this help document.
Related topics:
Report-scope security
Related topics:
Save
Saves the report cube and applies all the changes made in this window.
Close
Exits this window.
Insert
Category
Opens the Category Property dialog to insert a new folder into the report cube.
Dimension
Opens the Add Cube Element dialog to insert a dimension object to the report cube.
Measure
Opens the Add Cube Element dialog to insert a measure object to the report cube.
Detail
Opens the Add Cube Element dialog to insert a detail information object to the report cube.
Tools
Hierarchy Management
Opens the Hierarchy Editor dialog to edit hierarchies for the report cube.
Security Configuration
Opens the Security Configuration dialog to configure security for the report cube.
Predefined Filter
Opens the Predefined Filter dialog to add predefined filters for the report cube.
Help
Displays this help document.
Toolbar
Save
Saves the report cube and apply all the changes made in this window.
Delete
Deletes the specified table, view, formula or summary from the report cube.
Add Category
Inserts a new folder into the report cube.
Add Dimension
Inserts a dimension object to the report cube.
Add Measure
Inserts a measure object to the report cube.
Add Detail
Inserts a detail information object to the report cube.
Hierarchy Management
Specifies hierarchies for the report cube.
Predefined Filter
Adds some predefined filters for the report cube. Ad hoc end users can choose to apply those filters
when designing/modifying reports based on the report cube.
Move Up
Moves the selected object one step up.
Move Down
Moves the selected object one step down.
Resource Objects
Lists all the objects that can be inserted into the report cube.
Report Cube
Lists resources added to the report cube.
Related topics:
Objects box
Specifies the object the properties of which you want to reset globally.
Properties box
Lists all the properties for the selected object. Check the checkbox ahead of the properties which you
want to apply global settings, or check All Properties to reset all properties of the selected object
globally.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Role dialog
This dialog appears when you select the Role tab and then click the Add button in the Security dialog.
It helps you to add roles for the current security entry.
Source
Displays the role source information: a user-defined role or a role obtained from the server.
All Users/Groups
Lists all the users/groups available in the current security entry.
Assign to
Lists the users/groups that have been assigned to this role.
Assigns all the users/groups in the current security entry to this role.
Save
Saves the CSS style and goes into the CSS Style Definition dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Detail
Shows the joins information of the highlighted pre-join path.
Rename
Specifies the new name for the highlighted pre-join.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
If selected, save the report set as a binary formatting file which self-contains its own catalog.
Notes:
When you save a report set to XML Format Report Set (*.cls.xml), a special key is needed. If you
want, contact Jinfonet support ([email protected]).
Report that contains customized UDOs cannot be saved to XML format. If this option is required,
contact Jinfonet support ([email protected]).
Save
Saves the report set with the name and type you specified.
Cancel
Closes the dialog, leaving any changes unsaved.
Help
Displays this help document.
Adds all the properties listed in the All Properties box to the style.
Removes the specified property from the Selected Properties box, so that it will not be applied to the
style.
Removes all the properties from the Selected Properties box, so that they will not be applied to the
style.
Save
Saves the style and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
selecting the conditions and the group while holding the Ctrl button, and then clicking the Group button.
Ungroup
Makes the selected condition ungrouped.
Up
Moves the selected condition up to a higher level.
Down
Moves the selected condition or group down to a lower level.
Logic
Lists the logic operator.
And
Logic operator And which is applied to this and the next line.
Or
Logic operator Or which is applied to this and the next line.
And Not
Logic operator And Not which is applied to this and the next line.
Or Not
Logic operator Or Not which is applied to this and the next line.
Field
Specifies the field to be filtered. You can either type in the field manually or click
the Expressions dialog. The following are the options in this dialog:
+
Adds numbers or fields together in the Expression menu.
Subtracts numbers or fields together in the Expression menu.
*
Multiplies numbers or fields together in the Expression menu.
/
Divides numbers or fields together in the Expression menu.
=
Equates fields together
"
Places quotations on long character strings or name that have blanks in them. For example, you
should place quotes on values such as "New York" or "Washington DC")
||
Allows you to place fields together in the same Expression menu. For example, "New York" ||
"Washington DC")
Subquery tab
Allows you to create a sub-query by editing a query or creating a new query. For details about using
sub-queries, see Using sub-queries in filters.
()
Places your fields in parentheses
Edit Subquery
Opens the Query Editor window to edit the query.
New Subquery
Creates a new subquery here.
Field Value tab (disabled when the Expressions dialog is opened while setting the filter field)
Lists all column names of the related table, in which the field to be filtered is. Check the column name
of the field to be filtered, click OK, then the values of the field will be displayed. Choose the required
value and click Set to use it to filter the field.
Operator
Lists all the operators that can be used in the filter condition:
=
Equal to
<>
Not equal to
>
Greater than
>=
Greater than or equal to
<:
Less than
<=
Less than or equal to
[not] in
Causes an enumerated list of values to appear in the WHERE clause predicate, used for evaluating for a
true condition. The [not] in operator supports multi-value parameters as the value.
[not] between
Allows the system to evaluate whether or not data values are located between a range of values
indicated in the predicate.
is [not] null
It is used in WHERE clause predicates to match null values occurring in a specified data column.
[not] like
Like string pattern matching operator is used to compare the first expression string value to the pattern
string (the second expression). If you want to use wildcard character in the pattern string, only "_" and
"%" are supported.
sounds like
Sound like operator uses a soundex algorithm to pattern match strings that sound alike.
[not] exists
It is used to test if a subselect retrieves any records.
Value
Specifies the value of how to filter the field. You can either type in the value manually or click
the text box to specify the value.
next to
When you type in the value, if multiple values are required, they should be separated with ",", and if ","
or "\" is contained in the values, write it as "\," or "\\".
When you click
SQL Statement
Displays the SQL statement of the filter condition.
OK
Applies all changes and closes the dialog.
Cancel
Closes the dialog, leaving any changes unsaved.
Help
Displays this help document.
Related topics:
Search dialog
This dialog appears when you click the Search button
on the toolbar of the Catalog Browser or the
Resource View panel. It enables you to search leaf node resources that you need in the Catalog
Browser/Resource View panel.
Selected Resources
If selected, you will search what you need in the selected resources.
Search In
If selected, specify in which resources of the Catalog Browser/Resource View panel to search what
you need.
Search
Begins the search process and displays the results in the Search Result panel.
Cancel
Cancels the search process and closes the dialog.
Help
Displays this help document.
Limits the search to text that exactly matches the case of the search text.
Include Subfolders
If checked, the search results will include subfolders.
Search Now
Begins the search process.
Cancel
Cancels the search process and closes the dialog.
New Search
Refreshes this dialog in order to set a new search.
Help
Displays the help documentation.
Role tab
Lists the roles for the current security policy.
Role Name
Displays role names.
Description
Displays description of a role and double-click the cell to edit it.
Group tab
Lists the groups for the current security policy.
Description
Displays description of a group and double-click the cell to edit it.
User tab
Lists the users for the current security policy.
User Name
Displays user names.
Description
Displays description of a user and double-click the cell to edit it.
Add
Adds a user, group or role into the current security policy in the opening dialog.
Remove
Removes a specified user, group or role from the current security policy.
Refresh
Refreshes this dialog.
Group Name
Displays group names.
OK
Applies all changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Related topics:
User Name
Specifies the user name for the username token to be used in the security policy.
Password
Specifies the password for the username token to be used in the security policy.
Key Store
Specifies the properties of the key store.
Client Key
Specifies the properties for the client key.
Alias Name
Specifies the alias name which is used as client signature in the key store.
Alias Password
Specifies the password for the alias name.
Server Key
Specifies the properties for the server key.
Alias Name
Specifies the alias name which is used to get the server-side certification or public key in the key
store.
Alias Password
Specifies the password for the alias name.
OK
Accepts the configuration settings and closes the dialog.
Cancel
Cancels the configuration settings and exists the dialog.
Help
Displays this help document.
Security dialog
This dialog appears when you right-click the Data Source Security node in the Catalog Browser, select
Add Security from the shortcut menu, input a name for the new security policy and then click OK. This
dialog allows you to specify the security settings for a connection-scope security policy.
User tab
Lists the users for the current security entry.
Users
Specifies the name for the user that is to be added into the current security entry.
Title
Specifies the title for the user that is to be added into the current security entry.
Source
Displays the source of the user that is to be added into the current security entry.
E-mail
Specifies the E-mail address of the user that is to be added.
Group tab
Lists the groups for the current security entry.
Group
Specifies the group name, which must be unique with in the current security entry. JReport uses the
group name to identify a group.
Source
Displays the group source information: a user-defined group or a group obtained from the server.
Role tab
Lists the roles for the current security entry.
Role
Specifies the role name, which must be unique with in the current security entry. JReport uses the
role name to identify a role.
Source
Displays the role source information: a user-defined role or a role obtained from the server.
Add
Adds a user, group or a role into the current security entry.
Delete
Deletes a specified user, group or role from the current security entry.
Property
Modifies the properties of a specified user, group or role.
Valid RLS
Specifies whether to use RLS policy for this security entry. If unchecked, the RLS policy will not be
applied and all the records will be available for the users.
Valid CLS
Specifies whether to use CLS policy for this security entry. If unchecked, the CLS policy will not be
applied and all the records will be available for the users.
Import
Imports security information from external XML files.
OK
Accepts changes and closes the dialog.
Cancel
Does not retain the changes and closes the dialog.
Related topics:
Connection-scope security
If the policy settings are left blank, the user in this role will not be able to view any records, unless he/
she belongs to more than one role, and the other roles have the necessary permissions.
Values
Description
AND
OR
Insert Row
Delete Row
New Group
Adds a new expression group to the list. The relation ships between two groups
can be:
AND- Logical AND relationship between two groups. Records satisfying both
condition groups will be retrieved.
OR- Logical OR relationship between two groups. Records satisfying either
one of the condition groups will be retrieved.
AND NOT - Records which satisfy the first condition group but not the
second will be retrieved.
OR NOT - Records which satisfy the first condition group, or which do not
satisfy the second condition group will be retrieved.
Select Column
Specifies the columns that are to be shown to (or hidden from) the principal.
Allow all
Allows all the columns in the field list to be revealed to the principal.
Deny all
Hides all the columns in the field list from the principal.
Allow
Allows the selected columns in the field list to be revealed to the principal.
Deny
Hides the selected columns in the field list from the principal.
OK
Accepts the changes and closes this dialog.
Cancel
Closes this dialog, leaving any changes unsaved.
Help
Displays this help document.
Adds the select field to be the one from which to get the area tooltips.
OK
Applies the changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Name
Displays the names of sub folders.
Type
Displays the file type.
Last Modified
Displays the last modified time of the sub folders.
Description
Other necessary descriptions of the sub folders.
New Folder
Creates a new folder in the selected folder. You can rename the folder by double-clicking the folder in
the folder tree.
This button is available only when the dialog is opened by clicking the Browse button next to the
Publish Resource To text field in the Publish to JReport Server dialog.
OK
Saves the information and closes the dialog.
Cancel
Closes the dialog, leaving any changes unsaved.
Help
Displays this help document.
Select N dialog
This dialog is displayed when you click the Select N button in the Group screen of the banded/table
wizard. It helps you to specify a number to filter groups to be displayed in the report, or a parameter
which returns an integer to filter group dynamically when previewing the report.
All
If selected, all groups in the report will be displayed.
Top
If selected, specify a number in the field below and the first N groups in the report will be displayed.
You can also select a parameter from the drop-down list, which returns an integer, and then specify a
value for the parameter when viewing the report to dynamically define the Top N condition.
Bottom
If selected, specify a number in the field below and the last N groups in the report will be displayed.
You can also select a parameter from the drop-down list which returns an integer, and then specify a
value for the parameter when viewing the report to dynamically define the Bottom N condition.
Other
If checked, all the other records that don't match the Select N condition will be displayed (which are by
default hidden) in another group. Specify a name for this group as required.
This option is available only when the Select N condition is applied to a certain group.
OK
Accepts the changes and closes the dialog.
Cancel
Related topics:
Related topics
OK
Accepts the style group you've selected and closes the dialog.
Cancel
Does not accept the style group you've selected and closes the dialog.
Help
Displays this help document.
Ascend
Values will be sorted in an ascending order (A, B, C).
Descend
Values will be sorted in a descending order (C, B, A).
No Sort
Values will be sorted in the original order in database.
Series Selection
Specifies the number of series values that will be displayed in the chart.
Select
Specifies the Select N condition to define the number of the series values that will be displayed.
All
If selected, all series values in the chart will be displayed.
Top N
If selected, specify a number in the field to the right and the first N series values in the chart will
be displayed. You can also select a parameter from the drop-down list, which returns an integer,
and then specify a value for the parameter when viewing the report to dynamically define the Top
N condition.
Bottom N
If selected, specify a number in the field to the right and the last N series values in the chart will
be displayed. You can also select a parameter from the drop-down list which returns an integer,
and then specify a value for the parameter when viewing the report to dynamically define the
Bottom N condition.
Based On
If checked, the series values will be sorted by values of the summary selected with the direction
specified. If unchecked, the series values will be sorted by the order specified in the Series Order box
of the dialog.
Remaining Series In
Enabled only when Top N or Bottom N is selected from the Select drop-down list. Check this option
and then type a character string in the text field to group all the series values beyond the top/bottom
N range.
Skip First
If you check the Skip First option and input a number M in the text field to the right, then the first M
series values in the chart will be skipped and the Select N condition will take effect beginning with M
+1. The skipped values will be included in the Remaining Series group together with all the series
values beyond the top/bottom N range.
OK
Accepts the changes and closes the dialog.
Cancel
Discards the changes and closes the dialog.
Help
Displays this help document.
Related topics:
Auto Sort
If checked, the columns will list alphabetically; otherwise, the columns will list according to their orders
in the table.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
OK
Applies all changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Related topics:
Ascend
If selected, data in the banded object/table will be sorted based on values of the specified sort by field in
ascending order.
Descend
If selected, data in the banded object/table will be sorted based on values of the specified sort by field in
descending order.
Related topics:
Ascend
If selected, groups will be sorted by the values of the first record in each group on the specified field in
ascending order.
Descend
If selected, groups will be sorted by the values of the first record in each group on the specified field in
descending order.
Related topics:
Field
Displays on which field the special function will be applied.
Function
Specifies the special function to the field. For details about the special functions, refer to Specifying
special function for group by field.
OK
Accepts the changes and closes the dialog.
Cancel
Discards the changes and closes the dialog.
Help
Displays this help document.
Name
Displays names of parameters of the stored procedure.
Value
Specifies the value of each parameter. Double-click the cell to edit the value.
Type
Displays types of parameters of the stored procedure.
Bind Parameter Name
Allows you to bind the IN and INOUT parameters in the stored procedure to an existing catalog
parameter of the same type. Double-click the cell to input the parameter name (@parametername).
By default, a bound parameter will have the same name of the IN and INOUT parameter that is
automatically created when adding the stored procedure.
Format
Displays the value format of the current parameter.
OK
Applies all changes here and closes the dialog.
Cancel
Cancels the settings you make and closes the dialog.
Help
Displays this help document.
Resolution
Specifies the resolution of the result to zoom in/out, in DPI. The default value is obtained from the
operation system, which is the resolution of your monitor, for example, 72 DPI on Unix or 96 on
Windows. You can set higher/lower value to zoom in/out.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Subreport dialog
This dialog appears when you click Insert > Subreport on the menu bar, or click the Insert Subreport
on the Insert toolbar. It allows a report (referred to as the subreport) to be inserted into
button
another report (referred to as the primary report).
The following are details about options in the dialog:
Select Subreport Set
Specifies the subreport set.
Subreport
Specifies the report in the subreport set as the subreport.
Field tab
Specifies some links between the primary report and subreport.
Component in Report
Lists the components in the subreport that will be interlinked with the primary report.
Add
Adds a component in the subreport to be interlinked with the primary report.
Remove
Removes the selected component from the Component in Report box.
Adds a field of the primary report to set up links between the primary report and the subreport as
required.
Field
Lists all the fields that are used in the link conditions.
Fields(Primary)
Lists the selected fields of the primary report.
OP
Specifies the operator to be the condition for setting up links between the primary report and the
subreport.
Fields(Subreport)
Lists the DBFields in the datasets of the subreport which are of the same data type as the selected
fields in the primary report.
Parameters tab
Available only when there is at least a parameter in the subreport. It helps you to specify values for all
parameters in the subreport.
Parameters
Lists all the parameters contained in the datasets of the subreport.
Value
Lists all the DBFields, formulas, summaries and parameters in the dataset of the primary report
which are of the same data type as the parameters of the subreport.
Component in Report
Specifies the component in the subreport the fields of which will be used to return value to
parameters of the primary report.
Fields in Subreport
Lists all available fields, formulas, and parameters used by the specified component in the subreport.
Adds a field that you want to assign to a parameter in the primary report.
Parameters
Lists all the parameters in the primary report which are of the same data type as the fields selected
in the specified component of the subreport.
OK
Applies all changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Related topics:
Components - Subreports
Table Wizard
This wizard is displayed when you select a table layout in the New Report dialog or New Report Set dialog and then click OK, or
right-click a table and click Table Wizard on the shortcut menu. It helps you to create or modify a table.
The wizard consists of the following screens:
Data screen
Display screen
Group screen
Summary screen
Chart screen
Filter screen
Style screen
Back
Goes back to the previous screen.
Next
Goes to the next screen.
Finish
Finishes creating or modifying the table and closes this wizard.
Cancel
Does not retain changes and closes this wizard.
Help
Displays this help document.
Data screen
The Data screen differs with report type: normal report or studio report.
New
If checked, select a data source from the catalog resources to create a dataset that will be used to build the table. When you
choose to create the dataset from a query, you can click the Modify button to edit the query in the Query Editor if required.
Existing
If checked, select a dataset from the ones existing in the open report set to create the table. Click the Modify button to edit
the dataset in the Dataset Editor if required.
Current
If checked, the current dataset used by the parent object will be applied to the table.
Display screen
Specifies the data fields to display in the table.
Resources
Lists all the available data resources.
Replaces the selected field in the table with the specified field in the Resources panel.
Hide Detail
Specifies whether to hide the fields that have been added to display in the table.
Show Table Group Structure
Specifies whether to show the group structure of the table.
Display Fields
Lists the fields that you have selected to display in the table.
Display Name
Shows the display names of the selected fields. You can double-click the name cells to edit them if required.
Sort Fields By
Opens the Sort Fields By dialog to specify how to sort data in the table.
Group screen
Specifies the fields that you want to use to group the data.
Resources
Lists all the available data resources.
Replaces the selected group by field in the table with the specified field in the Resources panel.
Show Groups in Columns
Specifies whether to show the groups in columns. When it is unchecked, the Invisible property of the group columns in the
Report Inspector will be set to true automatically. You can later use this property to control whether to make the columns
shown or not.
Combine Group Headers
Specifies whether to place all the group by fields in the most inner group header row. Available only when the option Hide
Detail in the Display screen is checked.
Combine Group Headers with Detail Row
Specifies whether to place all the group by fields in the detail row. Available only when the option Hide Detail in the Display
screen is unchecked.
Ascend
Groups will be sorted in an ascending order (A, B, C).
Descend
Groups will be sorted in a descending order (C, B, A).
No Sort
Groups will be sorted in the original order in database.
Special Group
Opens the User Defined Group dialog to define grouping information.
For example, if you placed a field named Region for grouping, and this field contains all 50 states of the United States; and if
you want to see the data between Maryland (MD) and New York (NY), you can define the criteria by selecting the between
operator to further define your grouping information.
Sort Group By
Opens the Sort Group By dialog to set how groups will be sorted.
Special Function
If the group by field is of Numeric/String/Date/Time type, you can select a special function for the field in the Special Function
column to further specify to which level the data will be grouped by.
If Customize is selected, the Customized Function dialog will be displayed, in which you can set the function by your own.
Sort Group By
Specifies how to sort the groups. Activated only when you have clicked Sort Group By from the Sort column to define the
sorting manner of groups for the selected group level.
Special Group
Specifies how to group your information. Activated only when you have clicked Special Group from the Sort column to define a
special group.
Select N
Opens the Select N dialog to specify the Select N condition.
Group Filter
Opens the Group Filter dialog to specify the group filter condition.
Summary screen
Specifies the fields on which to create aggregate functions. This screen is available only when you create a table.
Resources
Lists all the available data resources.
Header
Specifies to put the summary field in the header row. If the summary is calculated on a group by field, it will be put in the
group header row of the corresponding group; if the summary is calculated on the whole dataset, it will be put in the table
header row.
Footer
Specifies to put the summary field in the footer row. If the summary is calculated on a group by field, it will be put in the
group footer row of the corresponding group; if the summary is calculated on the whole dataset, it will be put in the table
footer row.
Column
Works together with the Position option to specify the location where the summary field will be put.
Detail
The summary field will be put in a detail column.
Summary
The summary field will be displayed in a separate summary column.
Chart screen
Specifies to create a chart together with the table, which will be placed above the table in the report body. This screen is
available only when you create a table, and when there is at least one group by field and one summary field which is calculated
on this group by field in the table.
No Chart
Specifies not to create a chart.
Bar Chart
Specifies to create a Clustered Bar 2-D chart together with the table.
Line Chart
Specifies to create a Line 2-D chart together with the table.
Pie Chart
Specifies to create a Clustered Pie chart together with the table.
Category
Lists the group by fields of the table on which the summary fields are calculated. Choose the field you want to display on the
category (X) axis of the chart from the drop-down list.
Series
Lists the fields that have been added as the group by fields of the table. Choose the field you want to display on the series (Z)
axis of the chart from the drop-down list.
Show Values
Lists the summary fields which are calculated based on the field you choose to display on the category axis of the chart.
Choose the value you want to display in the chart from the drop-down list.
Filter screen
Specifies to filter data displayed in the table. This screen is available only when you create a table.
For details about options in the screen, see Edit Filter dialog.
Style screen
Specifies the style of the table.
Style
Lists the available styles.
<Custom>
There is no any style information on it and it is only used to cover previous-version report which did not bind any style or the
bound style cannot be found in the style list.
Preview
Displays a diagram illustrating the effect of the selected style on the table.
Inherit Style
Specifies whether to make the table take the style of its parent. This option is available only when you modify a table and the
table is inserted into a banded object.
Page Setup
Opens the Page Setup dialog to specify the page settings.
Related topics:
Modifying a table
Tabular Wizard
This wizard appears when you select the Tabular Report layout in the New Report dialog or New Report Set dialog and then
click OK. It helps you to create a report with a tabular in it.
Rows
Specifies the number of rows for the tabular.
Columns
Specifies the number of the columns for the tabular.
Width
Specifies the width for the tabular in inches.
Border
Format
Specifies the delimiter to separate fields.
CSV Format
Fields in the exported Text file will be separated by a comma.
Tab Delimited
Fields in the exported Text file will be separated by a tab.
Custom Defined
Fields in the exported Text file will be separated by a user defined delimiter. You can type your own
delimiter in the Delimiter box (note that the delimiter should be only one character).
Horizontal Density
Specifies the value for each unit of the horizontal density between columns. The resulting density is a
direct ratio of the value you specify. That is, the greater the value, the smaller the width between
columns.
Vertical Density
Specifies the value for each unit of the vertical density between columns. The resulting density is a
direct ratio of the value you specify. That is, the greater the value, the smaller the height between
columns.
Notes:
By exporting using user defined densities, if the densities are not set appropriately, the fields in the
report may overlap each other, so you are not recommended to use this way to export the report
result to Text.
When setting the value of Horizontal/Vertical Density, you need to pay attention to the following:
The value of Horizontal/Vertical Density must be greater than the character's width/height of the
smallest field in the report (smallest field is the field with the smallest font size), otherwise, the
value you set will not be applied.
If the value of Vertical Density is greater than 0 and the value of Horizontal Density is less than 0,
the value that you specify for the Vertical Density will be applied and the value of Horizontal
Density will be specified by JReport.
If the value of Vertical Density is less than 0 and the value of Horizontal Density is greater than 0,
the value that you specify for the Horizontal Density will be applied and the value of Vertical
Density will be specified by JReport.
If the values of Vertical Density and Horizontal Density are both greater than 0 and the value of
Horizontal Density is less than 11, the specified value of the two densities will be applied.
Otherwise, they will be specified by JReport.
If the values of Vertical Density and Horizontal Density are both less than 1, these densities will be
specified by JReport.
Compress
Specifies whether to generate the report set result to Text format in a compressed size, that is to say,
there will be no clearance between the columns.
Header and Footer
If checked, the Text file will contain all headers and footers in the report, including Report Header/
Footer, Page Header/Footer and Group Header/Footer. Otherwise, the Text file will only contain data in
Detail panel.
Windows End-of-line (CR-LF)
Specifies to use Windows end-of-line characters to indicate the start of a new line. If checked, two
characters <cr> and <lf> will be used at the end of the line.
Unix End-of-line (LF)
Specifies to use Unix End-of-line characters to indicate the start of a new line. If checked, only the Unix
End-of-line character <lf> will be used.
OK
Applies the changes and closes the dialog.
Cancel
Cancels the changes and exits the dialog.
Help
Displays this help document.
Opens the Import UDF Class dialog for importing a new UDF class. To import a UDF class, you need
first add it to the class path of JReport Designer and then provide the class name with full package path
in the Import UDF Class dialog.
Add
Adds a new grouping line.
Remove
Removes the grouping line you specify.
OK
Applies all changes.
Cancel
Does not retain any changes.
Help
Displays this help document.
User dialog
This dialog appears when you select the User tab and click the Add button in the Security dialog. It
helps you to specify the users for the current security entry.
Title
Specifies the title for the user.
Source
Displays the source of the user.
E-mail
Specifies the e-mail address of the user.
All Roles/Groups
Lists all the roles/groups that exist in the current security entry.
Belongs to
Shows which roles/groups that the user belongs to.
Assigns the selected role/group to this user (adds this user to the select role).
Removes the selected role/group from the user's role list (removes this user from the select role).
Assigns all the roles/groups in the current security entry to this user (adds this user to all roles).
Removes all the selected roles/groups from the user's role list (removes this user from all roles).
Permissions
Opens the Security Permission Setting dialog to specify the permission settings for the user.
OK
Applies all the changes.
Cancel
Closes the dialog and removes all the unsaved changes.
Help
Displays this help document.
Input an Action
If selected, click OK to open the Input Action dialog to input directly an action and its parameter and
bind it to the web control.
*Parameter
If selected, click OK to open the Parameter - Web Action Builder dialog to bind the Parameter action
to the web control.
*Sort
If selected, click OK to open the Sort - Web Action Builder dialog to bind the Sort action to the web
control.
*Filter
If selected, click OK to open the Filter - Web Action Builder dialog to bind the Filter action to the web
control.
Notes
Displays some tips about the specified action.
OK
Accepts the changes and closes the dialog.
Cancel
Discards the changes and closes the dialog.
Help
Displays this help document.
Related topics:
Local File
Specifies to get a WSDL file from local files by clicking the Browse button.
URI
Specifies the location of the WSDL file by inputting the URI string.
User Name
Specifies the user name used for accessing the WSDL file through the URI.
Password
Specifies the password used for accessing the WSDL file through the URI.
Unqualified Name
Neither catalog nor schema will be included in data manipulation. Example: SELECT t.c FROM t
2-Part Names
Uses schema in data manipulation. Example: SELECT schema.t.c FROM schema.t
3-Part Names
Uses both catalog and schema in data manipulation. Example: SELECT catalog.schema.t.c from
catalog.schema.t
Time Out
Specifies how long to wait to get the WSDL file.
Pre-join
Specifies whether or not to enable the Pre-join feature when building a query or defining join
relationships in business cubes.
Security Configuration
Opens the Security Configuration Setting dialog to configure security for the web service data source.
Options
Shows the additional settings for creating the web service data source.
OK
Creates the web service data source and closes the dialog.
Cancel
Cancels the creation of the web service data source and exits the dialog.
Help
Related topics:
Report tab
Directory tab
Note tab
Previous
Retains changes and returns to the previous tab.
Next
Retains changes and goes to the next tab.
Finish
Completes the exporting.
Cancel
Does not retain any changes and closes the wizard.
Help
Displays this help document.
Report tab
Specifies the options applied to the report.
DHTML
Specifies whether to enable the TOC (Table of Contents) when viewing the report in HTML format.
Multiple Files
If checked, the report result will be generated into multiple HTML files, and JReport will designate a
serial number for each HTML page. For example, if you named a 3-page report as "sales", JReport will
create three files called sales_1.html, sales_2.html, and sales_3.html.
Embed CSS
Specifies whether to embed the cascading style sheet (CSS) in the exported HTML files; otherwise,
the .css file will be generated individually.
Single File
If checked, the report result will be generated in a single HTML file.
No Hyperlink
If checked, there will be no hyperlinks for navigating previous and next pages on the navigation bar
of the exported HTML file.
No Page Number
If checked, there will be no page number information showing the current page number and total
page number on the navigation bar of the exported HTML file.
Directory tab
Specifies the location in which to place the exported HTML files.
Directory
Specifies the directory in which to place the exported HTML file.
Applet Chart
Uses a Java applet to display the charts in an HTML format result file.
Image Chart
If checked, charts will be converted to images. Also, you can specify the image type from the dropdown list. The options are:
auto select
If selected, the image format will be set to JPG or GIF by the JReport system automatically. If the
image colors are less than 256 colors, GIF will be applied; otherwise, it is JPG.
GIF
If selected, the GIF format will be applied, which is a lossless compression technique and supports
only 256 colors. GIF is better than JPG for images with only a few distinct colors, such as line
drawings, black and white images and small text that is only a few pixels high.
JPG (JPEG)
If selected, the JPG (JPEG) format will be applied, which is supported on the Web. JPG is a lossy
compression technique that is designed to compress color and grayscale continuous-tone images.
JPG images support 16 million colors and are best suited for photographs and complex graphics.
PNG
If selected, the PNG format will be applied, which provides a portable, legally unencumbered, wellcompressed (effectively 100 percent lossless compression), well-specified standard for lossless
bitmapped image file. PNG supports indexed-color images of up to 256 colors and shows a more
interchangeable, flexible and robust function than GIF.
Note tab
This tab includes important information about HTML. We recommend that you read the contents in the
Note tab before you convert your report to HTML format.
Windows dialog
This dialog appears when you click Window > Windows on the menu bar. It is used to adjust the
multiple report sets to suit your requirements.
Tile Vertically
Lays out all of the open report sets vertically.
Help
Displays this help document
Auto Start
Specifies whether or not to start the media file automatically when the report is opened in JReport
Viewer or JReport Studio.
Auto Rewind
Specifies whether or not to rewind the media file automatically.
Play Count
Specifies the number of times you want to play this media file.
Show Controls
Specifies whether or not to show the Windows Media Player controls.
OK
Accepts all changes and closes the dialog.
Cancel
Does not retain any changes and closes the dialog.
Help
Displays this help document.
Back
Goes back to the previous screen.
Next
Goes to the next screen.
Finish
Finishes confirming to transform an XML schema to a relational schema.
Cancel
Does not retain changes and closes this wizard.
Help
Displays this help document.
Schema Type
Specifies the type to import XML schema. You can import from XSD or parse from an XML instance.
Schema Name
Specifies the schema file by clicking the Browse button or inputting the URI string directly in the text box.
Starting Node
Specifies the starting node, according to the root name in the XML source.
Notes:
If a value of DateTime data type is accurate to millisecond, a message - Invalid Value will still pop-up although
the value is valid according to the W3C standard. If that, ignore the error message and continue the
transformation steps.
If you select to create a parameter and then dynamically specify an XML instance at runtime, the XML instance
will be validated at runtime rather than in the importing process.
Instance
Specifies the XML instance. It should match with the selected XSD schema.
These two operations below are available only when you select Import from XSD from the Schema Type dropdown list.
URI
If selected, specify an XML file for the XSD by clicking the Browse button or input the URI string directly in the
text box.
Parameter
to open the Create Parameter dialog to create a parameter and then dynamically specify an
If selected, click
XML instance that matches with the selected XSD schema at runtime.
Schema
Lists the corresponding schema structure of the root.
XML schema and
Properties
Lists all the properties of the selected elements and attributes in the schema.
Name
Displays names of properties of the selected elements or attributes.
Value
Specifies values of properties for the selected elements or attributes.
Note: When the property Data Type is specified as Date, Time or DateTime, you can specify the Format Pattern
for them to make values of the Data Type display as required. For details about these properties, see the section
Supplementing information for the XML schema.
Schema
Lists the schemas in the database for you to select.
Tables
Lists the tables transformed from the XML schema.
Added Tables
Lists the tables that you have added from the relational schema.
Related topics:
XML connections
Formula Reference
A formula is a symbolic statement of the manipulations you want to perform on certain data. JReport
provides a number of built-in functions for you to build your formula. Also it provides user defined
formula (UDF) functions that allow you to design your own formula functions.
Generally, formulas can be used:
to calculate information you cannot obtain directly from database data fields,
to compare data,
Formula syntax
Data type
Built-in functions
Operators
Formula syntax
JReport formula syntax is a syntax with simple flow control and other statements. The Formula Editor is
where you write your formula statements. You should follow JReport formula syntax when writing
formulas.
In this syntax, sequence and selection control structure are supported. You can use it to control the
execution of the statements. In this syntax, a parameter can be used as variable, and its value can be
used in computation or making decisions. Since the value of the parameter is input before the report is
run, the report can respond to user input and generate different results.
Click a link from the following for details:
Statements
Expression
Statements
The statement is the smallest executable unit in the syntax. A SQL procedure is a sequence of
statements. Statements are separated by semicolon (;). There are many kinds of statements, such as
declare statement, expression statement, assignment statement, if-else statement, and return
statement.
Declare statement
The declare statement is used to declare variables.
Expression statement
The expression statement is used to calculate the value of an expression.
Assignment statement
The assignment statement is used to calculate the expression on the right side of assignment operator
and assign the value to the variable on the left side.
Syntax: Variable = Expression
The type of value of expression must be compatible with the type of the variable.
Example: total = amount * price
In this example, where the total, amount and price are declared variable. The statement calculate the
"amount * price" and assign the value to "total".
If - else statement
The if-else statement provides conditional control of an action. Normally, the statements are executed
one by one sequentially. The if-else statement enables alternative actions that depend on the
evaluation result of the expression.
Syntax:
if (expression)
{
statement(s)
}
or
if (expression)
{
statement(s)
}
else
{
statement(s)
}
Where, the expression must be a logical expression and have a Boolean value. The if clause checks the
condition presented by the logical expression. If the condition is true, the statement following the if will
be executed. Otherwise, the statement following the else will be executed.
Example:
If (score >= 60)
{
return "PASS";
}
else
{
return "FAIL";
}
In this example, if the score is greater than or equal to 60, the result is pass, otherwise the result is fail.
Return statement
The return statement is used to stop the execution of procedure and return a value if necessary. The
return statement is the last statement executed.
Syntax: return or return expression;
The expression will be calculated before the procedure returns.
Example: return results;
For statement
The for statement provides a compact way to iterate over a range of values.
Syntax:
for (initialization; termination; increment) {
statement
}
Or
for (initialization; termination; increment) statement
The initialization is an expression that initializes the loop - it's executed once at the beginning of
the loop. The termination expression determines when to terminate the loop. This expression is
evaluated at the top of each iteration of the loop. When the expression evaluates to false, the loop
terminates. Finally, increment is an expression that gets invoked after each iteration through the loop.
All these components are optional.
Examples:
integer i=0, j=0;
For(i=0;i<100;i=i+1){
j=j+1;
};
return j;
Or
integer i=0, j=0;
For(i=0;i<100;i=i+1) j=j+1;
return j;
if(@P_int==0) then
stite=stite+"&jrs.param$Site=%07"
else
{for(siteint=0;siteint<@P_int;siteint=siteint+1)
stite= stite+"&jrs.param$Site=" + @P_int
};
return stite;
While statement
The while statement is used to continually execute a block of statements while a condition remains true.
Syntax:
while (expression) do {
statement
}
Or
while(expression) do statement
First, the while statement evaluates expression, which must return a Boolean value. If the expression
returns true, then the while statement executes the statement(s) associated with it. The while
statement continues testing the expression and executing its block until the expression returns false.
Example:
integer i=0;
While(i<100) do {
i=i+1;
};
return i;
Or
integer i=0;
While(i<100) do i=i+1;
return i;
Select statement
The select statement is usually used in the case that the value of a single variable may determine one
of a number of different choices.
A select statement is given a variable and compares its value to all cases in the switch; if there is a
case that matches the value, all statements in the matching case are executed. If none match, and a
default is given, all statements following the default keyword are executed.
Syntax:
select (variable name){
case expression_1: statement
case expression_2: statement
...
default: statement
};
The expression_1 and expression_2 should be variables or constants. The statement in each should
be a single statement or multi-statement (compound statement). When multi-statement is used, they
must be enclosed by {}.
Notes:
The value of the select is only evaluated one time even when a case modifies the tested value.
No break statement is required, the logic flow does not continue through the following case
statements.
Examples:
integer i = 0 ; string j = 'a';
i = @"Customers_Customer ID";
select(i)
{
case 1: j='bb'
case 2: j='cc'
default: j ='dd'};
return j
string state="",result="";
if (IsNull(@Customer_State)) then
state="Others"
else
state = @Customer_State;
select (state)
{
case "BC","ID","MT","WA":result="Northwest"
case "CA","AZ","TX","NM":result="Southwest"
case "ME","MA","NH","NY":result="Northeast"
case "FL","NC","GA","SC":result="Southeast"
default: result="Rest of Country"
};
return result;
Expression
The expression is a combination of values, operators and functions that produce a result. The value in
the expression can be a literal value or a variable, while the operator defines the operation between
values; the function is used to perform an action and return a value.
Value
The value specified in an expression can be a literal value or a variable value. JReport formula syntax
supports seven data types of value. See the section Data type for details.
Literal value
The Literal Value is a value that is used exactly as it is displayed. A literal value represents a value such
as a Number, String, or Date. For example, "Name", 98.6...
Variables
A variable is a named storage unit used to store a value. The identifier (name) of variable can be used
to refer to the value of the variable or refer to the storage space of the variable. In an expression, the
identifier is used to refer to the value, and in assignment statement, the identifier on the left is used to
refer to the storage space.
Undeclared variables
The undeclared variables include parameter, DBField, special field and summary defined in the
catalog. They can be used as a variable in a formula.
Declared variables
Another type of variable which must be declared in a declare statement before use. The declared
variable is a real variable and can be assigned in the assignment statement. There are two kinds of
declared variables:
Local Variable: Variable which is only valid in the formula where it is declared.
Global Variable: Variable which is valid in all the formulas once it is declared.
Component level: Its lifetime is the same as the component's lifetime. In its lifetime, whenever a
formula is executed, the variable will be executed if it is used in the formula.
Report level: Its lifetime is the same as the report's (primary report) lifetime. Even in different
components (using same data source), the same report level global variable will have only one
instance. The report level variable can be passed to different components (using same data source).
The components include banded objects, tables, charts, tabulars, crosstabs, and subreports
(including many layers of subreports).
When using the keyword "global" to define a global variable in a formula, if you add no words before
the keyword, the global variable is on the component level; if you add "report" before the keyword, the
global variable will be a report level global variable.
Example
This example uses the report global variable to do a calculation in the report. First, create three
formulas based on the report global variable as follows:
Formula1: report global number a =0;
Formula2: a = a+1;
Formula3: return a;
Then use them in one report set including two BandedObjects(BandedObject1 and BandedObject2) in
the same dataset as follows:
1. Insert Formula1, Formula2, Formula3 to the BandedObject1(15 records) as follows:
BandedHeader:Formula1
DetailPanel:Formula2
BandedFooter:Formula3 - returns 15.
2. Then insert Formula2 and Formula3 to the BandedObject2(25 records) as follows:
DetailPanel:Formula2
BandedFooter:Formula3 - returns 40.
Notes:
For nested data containers, report level global formulas may lead to an unexpected result. If you add
"pagenumber" in the formula's definition, the generated result can be the one expected.
Although one report can have two or more data sources, report level global variable cannot span
across data sources, otherwise the formula will not run correctly, thus, even the report global
variables with the same variable name in different data sources are different in one report.
If there is a report level global variable report global integer g, and it is used both in the primary
report and subreport, then this variable g can communicate with each other.
If you want to calculate the record number of the subreport and primary report separately, you can
define a different report level variable from the primary report, but if one subreport is inserted into
one primary report more than once you will be unable to correctly use the variable separately, in
such circumstance, you can change the report level variable into component level variable to solve
the problem.
Operator
An operator is a symbol that indicates an operation to be performed on values. The JReport procedure
language has several classes of operators, including math, comparison and logical operators. For
detailed information about operator, see the section Operators in this chapter.
Function
Functions return a value as its result. JReport formula syntax provides many built-in functions. You can
refer to the section Built-in functions for detailed information about function.
Data type
Type
Numeric
Description
Integer
int
long
BigInt
Real Number
Immutable arbitrary-precision
integers.
float
double
currency
Type
DateTime
Description
Date
MM/dd/yy
MM/dd/yyyy
Other
Types
Time
HH:mm:ss
hh:mm:ss
TimeStamp
yyyy-MM-dd
hh:mm:ss
Char
16-bit
Unicode
character
A single character.
String
Boolean
True or false.
Notes:
Format
Description
yyyy
MM
dd
An Integer from 1 to 31 (maximum depends on the month and year) representing the day
of the month
HH
hh
mm
ss
nnnnnn
Built-in functions
The Functions panel in the Formula Editor lists all the built-in functions JReport provides. They are
powerful and commonly used. If you are still puzzled in finding your own required function, you can
write user defined formula functions.
The following are types of the built-in functions:
Math
String
Date/Time
Date Range
Financial
Array
Others
Math
Mathematical functions are used for a variety of mathematics-oriented calculations and operations. The
following is a list of the Math functions. Click the links for further information.
Abs
Atan
Average
Cos
Count
DistinctCount
E, Pi
Exp
integDiv
Log
Maximum
Minimum
MRound
Population
Pow
Random
Remainder
Round
Sgn
Sin
Sqr
StdDev
Sum
Tan
ToBinary
ToHex
ToInt
ToOctal
Truncate
Variance
Abs
Abs(double, a)
Returns the absolute value of a Double value. If the argument is not negative, the argument will be
returned. If the argument is negative, the negation of the argument will be returned.
Parameter
a - A Double value.
Return value
The return value is a Number.
Example
The return value of the following statements is 2.4785.
Abs(2.4785) and Abs(-2.4785)
Abs(BigInt, a)
Returns the absolute value of a BigInt value. If the argument is not negative, the argument will be
returned. If the argument is negative, the negation of the argument will be returned.
Parameter
a - A BigInt value.
Return value
The return value is an Integer.
Example
The return value of the following statements is 3534.
Abs(-3534) and Abs(3534)
Abs(currency, a)
Returns the absolute value of a Currency value. If the argument is not negative, the argument will be
returned. If the argument is negative, the negation of the argument will be returned.
Parameter
a - A Currency value.
Return value
The return value is a Currency.
Example
Atan
Atan(number)
Returns a number specifying the arctangent of the given number parameter. In other words, it returns
the angle whose tangent is the given number parameter. This function works in a similar way to the
Java Math function with the same name. The range of values returned by atan is between -pi/2 and
pi/2 radians.
Parameter
number - A Number value.
Return value
Number value, which is an angle specified in number of radians.
Example
atan(1) - Returns an angle of 0.7854 radians (rounded to 4 radians). To convert this angle to degrees
multiply by 180 / pi. For instance, atan (1) * 180 / pi is 45 degrees.
Average
Average(DBField a)
The function is used to get the average value of the values referred to by the argument.
Parameter
a - Values of DBField or formula field. Can be Number or Currency data type.
Return value
The return value can be Number or Currency.
Examples
Number x = Average(@dbfield)
Number x = Average(@formula)
Currency x = Average(@dbfield)
Currency x = Average(@formula)
Return value
The result value can be Number or Currency, and is depent on the data type of the first argument
respectively.
Examples
Average(Number a[])
This function computes the average of all the values in the array.
Parameter
a - A Number or Currency array.
Return value
The return value is a Number or a Currency.
Examples
Note: If a field is assigned to a variable, for example x, the variable x will lose the characteristic of
representing a group of values. The following formula will then be treated as incorrect.
Number x = @dbfield;
Number y = Average(x); // system will prompt you that there is no such kind of function.
Cos
Cos(number)
Returns a number specifying the cosine of an angle given in radians. It takes a right-angle triangle, and
returns the length of the side adjacent to the specified angle divided by the length of the hypotenuse.
Parameter
number - An angle in number of radians.
Return value
Number value between 1 and -1.
Examples
Count
Count(Array a[ ])
This function computes the number of the values in an array.
Parameter
a - A Double array.
Return value
The return value is an Integer.
Examples
Count(["George","Paul","George","John","Ringo","John"]) - Returns 6.
Count(DBField a)
The function is used to count the number of values referred to by the argument.
Parameter
a - Values of DBField or formula field.
Return value
Returns a Number type value.
Examples
Number x = Count(@dbfield)
Number x = Count(@formula)
groupby - A constant string to indicate the groupby DBField name, formula name grouped by or a
Note: If a field is assigned to a variable, for example x, the variable x will lose the characteristic of
representing a group of values. The following formula will then be treated as incorrect.
Number x = @dbfield;
Number y = Count(x); // system will prompt you that there is no such kind of function.
DistinctCount
DistinctCount(Number a[ ])
This function computes the number of distinct values in an array.
Parameter
a - A Number array.
Return value
The return value is an Integer.
Example
The return value of the following statement is 4.
DistinctCount([1.45, 2.63, 38.1, 1.45, 23.9])
DistinctCount(DBField a)
This function computes the number of distinct values referred to by a DBField.
Parameter
a - Values of a DBField or a formula field.
Return value
The return value is an Integer.
Example
If you build a report about customer order, the return value of the following statement is 19.
DistinctCount(@"Order Date")
Return value
Returns a Number type value.
Examples
Note: If a field is assigned to a variable, for example x, the variable x will lose the characteristic of
representing a group of values. The following formula will be treated as incorrect.
Number x = @dbfield;
Number y = DistinctCount(x); // system will prompt you that there is no such kind of
function.
E, Pi
E()
Returns the Mathematical value of e, which is 2.7182818 (if rounded to 7 decimal places).
Pi
Pi()
Returns the Mathematical value of pi, which is 3.1415926 (if rounded to 7 decimal places).
Exp
Exp(Number)
Returns a number specifying e (the base of natural logarithms) raised to a power. The value of e is
approximately 2.7182818284590452354. This function works like the Java Math function with the same
name. Numeric overflow occurs if the given number parameter is larger than approximately 705.
Parameter
inNumber - Number value that specifies a power.
Return value
A number which is the value of e ^ Number.
Examples
integDiv
integDiv(numbera, numberb)
Returns the integer portion of the value numbera/numberb.
Parameters
Return value
Whole Number value.
Example
integDiv(33, 2) - Returns 16.
Log
Log(number)
Returns a number specifying the natural logarithm of a given number. The natural logarithm is the
logarithm to the base e, where e is approximately 2.7182818284590452354. If the value of number is
less than 0, the function will return NaN.
Parameter
number - The Number value that you want to calculate on.
Return value
The number which is the value of ln(Number).
Examples
Maximum
Maximum(a[ ])
This function returns the highest value in an array.
Parameter
a - An array, data type can be Number.
Return value
Returns a Number value.
Example
Maximum(DBField a)
This function is used to pick up the maximum value from the values referred to by the argument.
Parameter
a - Values of a DBField or a formula field.
Return value
The returned value type is dependent on the data type of the parameter. It may be Number, Currency,
String, Date, Time, DateTime or Boolean.
Examples
Number x = Maximum(@dbfield)
Date x = Maximum(@formula)
Currency x = Maximum(@dbfield)
Boolean x = Maximum(@formula)
groupby - A constant string to indicate the DBField name, formula or parameter grouped by.
Return value
The returned type is dependent on the data type of the first argument. It may be Number, Currency,
Note: If a field is assigned to another variable, for example x, the variable x will lose the characteristic
of representing a group of values. The following formula will then be treated as incorrect.
Number x = @dbfield;
Number y = Maximum(x); // system will prompt you that there is no such kind of function.
Minimum
Minimum(a[ ])
This function returns the lowest value in an array.
Parameter
a - An array which type can be Number.
Return value
Returns a Number value.
Examples
Minimum(DBField a)
This function is used to pick up the minimum value from the values referred to by the argument.
Parameter
a - Values of a DBField or a formula field.
Return value
The returned value type is dependent on the data type of the parameter. It can be Number, Currency,
String, Date, Time, DateTime or Boolean.
Examples
Number x = Minimum(@dbfield)
Date x = Minimum(@formula)
Currency x = Minimum(@dbfield)
Boolean x = Minimum(@formula)
groupby - A constant string to indicate the DBField name, formula or parameter grouped by.
Return value
The returned value type is dependent on the first argument. It may be Number, Currency, String, Date,
Time, DateTime or Boolean.
Examples
Note: If a field is assigned to a variable, for example x, the variable x will lose the characteristic of
representing a group of values. The following formula will then be treated as incorrect.
Number x = @dbfield;
Number y = Minimum(x); // system will prompt you that there is no such kind of function.
MRound
Returns a number that is a multiple of the second parameter and at the same time is nearest to the
first parameter. This function rounds up (away from zero) if the remainder of the division is greater
than or equal to half of the value of the second parameter.
Overloads
MRound(Number,Number)
MRound(Currency,Number)
MRound(Currency,Currency)
Parameters
Note: Regardless of the positive/negative sign of the second parameter, the result of the function
takes the positive/negative sign of the first parameter.
Return value
A number.
Expression
Take MRound(Currency,Number) for an example:
MRound(Currency,Number) = Number*(Integer(Currency/Number) + (1 if Remainder(Currency/
Number) >=Number/2, otherwise 0)
Examples
Population
PopulationVariance(a[ ])
PopulationVariance(DBField field)
This function computes the population variance of the values referred to by the argument.
Parameters
a - A Number array.
groupby - A constant string to indicate the DBField, formula or parameter grouped by.
Return value
Returns a Number type value.
Examples
Number x = PopulationVariance(@dbfield)
Number x = PopulationVariance(@formula)
Note: If a field is assigned to a variable, for example x, the variable x will lose the characteristic of
representing a group of values. Therefore, the following formula will be treated as incorrect.
Number x = @dbfield;
Number y = PopulationVariance(x); // system will prompt you that there is no such kind
of function.
PopulationStdDev(a[ ])
PopulationStdDev(DBField field)
This function computes the population standard deviation of the values referred to by the argument.
Parameters
a - A Number array.
groupby - A constant string to indicate the DBField, formula or parameter grouped by.
Return value
Returns a Number type value.
Examples
Number x = PopulationStdDev(@dbfield)
Number x = PopulationStdDev(@formula)
Note: If a field is assigned to a variable, for example x, the variable x will lose the characteristic of
representing a group of values. Therefore, the following formula will be treated as incorrect.
Number x = @dbfield;
Number y = PopulationStdDev(x); // system will prompt you that there is no such kind of
function.
Pow
Pow(numbera, numberb)
Returns the value of numbera ^ numberb.
Paremeters
Examples
Random
Random(), Random(seed)
Returns a random number greater than or equal to 0 and less than 1. If seed is equal to 0, Random
returns the random number that was returned from the previous call to random. If seed is not supplied
or is greater than 0, then Random will return the next random number in the internally generated
sequence of random numbers. If seed is less than 0, then Random will use this value of seed to start a
new random number sequence and returns the first value in the sequence. This function is typically
used when your formula requires a randomly generated number, for example, statistical calculations or
selecting records at random to limit the data in a report.
Overloads
random()
random(seed)
Parameter
seed - An optional Number value parameter.
Return value
A Number value.
Examples
Note: You can call Random without ever starting a new random number sequence by specifying a
negative seed parameter. If you do so, an internal seed will be generated using the system clock. The
reason to start a new random number sequence by calling Random with a negative seed parameter,
and then making subsequent calls to Random without a parameter (or with a positive parameter) is so
that the report will look exactly the same every time it is previewed. In other words, it allows you to
make use of random numbers, but to return a reproducible result.
Remainder
Remainder(Integer a, Integer b)
This function is used to evaluate the remainder after numerator has been divided by a denominator.
Parameters
a - A BigInt value.
b - A BigInt value.
Return value
The return value is an Integer.
Examples
Remainder(7, 9) - Returns 7.
if(Remainder(@"CustomerID",2)==0) then
return "0xffcc99"
else
return "0xccffff"
This formula can distinguish odd numbers and even their backgrounds.
Round
Round(Number a, integer b)
This function is used to round to a specified scale determined by argument b for Double value a.
Parameters
a - A Double value.
b - A Scale value.
Return value
The return value is a Number.
Example
The return value of the following statement is 2.46.
Round(2.4576, 2)
Round(Number a)
This function returns the integer portion after a specified number has been rounded.
Parameter
a - A Double value.
Return value
The return value is an Integer.
Example
The return value of the following statement is 3.00.
Round(2.754)
ROUND_UP = 0
Rounding mode to round away from zero. Always increments the digit prior to a non-zero discarded
fraction. Note that this rounding mode never decreases the magnitude of the calculated value.
ROUND_DOWN = 1
Rounding mode to round towards zero. Never increments the digit prior to a discarded fraction (i.
e., truncates). Note that this rounding mode never increases the magnitude of the calculated value.
ROUND_CEILING = 2
Rounding mode to round towards positive infinity. If the value is positive, behaves as for
ROUND_UP; if negative, behaves as for ROUND_DOWN. Note that this rounding mode never
decreases the calculated value.
ROUND_FLOOR = 3
Rounding mode to round towards negative infinity. If the BigDecimal is positive, behave as for
ROUND_DOWN; if negative, behave as for ROUND_UP. Note that this rounding mode never
increases the calculated value.
ROUND_HALF_UP = 4
Rounding mode to round towards "nearest neighbor" unless both neighbors are equidistant, in
which case round up. Behaves as for ROUND_UP if the discarded fraction is >= .5; otherwise,
behaves as for ROUND_DOWN. Note that this is the rounding mode that most of us were taught in
grade school.
ROUND_HALF_DOWN = 5
Rounding mode to round towards "nearest neighbor" unless both neighbors are equidistant, in
which case round down. Behaves as for ROUND_UP if the discarded fraction is > .5; otherwise,
behaves as for ROUND_DOWN.
ROUND_HALF_EVEN = 6
Rounding mode to round towards the "nearest neighbor" unless both neighbors are equidistant, in
which case, round towards the even neighbor. Behaves as for ROUND_HALF_UP if the digit to the
left of the discarded fraction is odd; behaves as for ROUND_HALF_DOWN if it's even. Note that this
is the rounding mode that minimizes cumulative error when applied repeatedly over a sequence of
calculations
Return Value
The return value is a Number.
Example
The return value of the following statement is 2.03.
Round(2.021, 2, 0)
c - The rounding mode. It can be Up (0), DOWN (1), CEILING (2), FLOOR (3), HALF_UP (4),
HALF_DOWN (5), and HALF_EVEN (6). See the previous section about the detailed description of
each rounding mode.
Return Value
The return value is a number.
Example
The return value of the following statement is 123.457.
Round(123.4567, 3, 'UP')
Note: The digits of the decimal fraction of the rounded number must be bigger than the scale specified
in the formula.
Sgn
Sgn(data)
Returns the sign value of the given number (whose value is data). If data is greater than 0, it will
return 1. If data is less than 0, it will return -1. If data is equal to 0, it will return 0.
Parameter
data - The value you want to know the sign of.
Return value
1, 0 or -1.
Examples
sgn(2) - Returns 1.
sgn(0) - Returns 0.
Sin
Sin(number)
Returns a number specifying the sine of an angle given in radians. It takes a right-angle triangle, and
returns the length of the side opposite to the specified angle divided by the length of the hypotenuse.
Parameter
number - An angle in number of radians.
Return value
Number value between -1 and 1.
Examples
Sqr
Sqr(number)
Returns the square root of a given number. If the value of the number is less than 0, this function
returns NaN. It is designed to work like the Java Math function of sqrt().
Parameter
number - A Number value greater than or equal to 0.
Return value
Number value.
Example
sqr(100) - Returns 10.
StdDev
StdDev(a[ ])
StdDev(field)
StdDev(field, groupby)
This function computes the standard deviation of the values referred to by the argument.
Parameters
a - A Number array.
groupby - A constant string which indicates the DBField, formula or parameter grouped by.
Return value
Returns a Number value.
Examples
Number x = StdDev(@dbfield)
Number x = StdDev(@formula)
Note: If a field is assigned to a variable, for example x, the variable x will lose the characteristic of
representing a group of values. The following formula will then be treated as incorrect.
Number x = @dbfield;
Number y = StdDev( x); // system will prompt you that there is no such kind of function.
Sum
Sum(Number a[ ])
Sum(Integer a[ ])
Sum(Currency a[ ])
Sum(DBField field)
This function computes the sum of all the values referred to by the argument.
Parameters
groupby - A constant string which indicates the DBField, formula or parameter grouped by.
Return value
The returned value type is dependent on the parameter. It can be Number, Integer or Currency.
Examples
Number x = Sum(@dbfield)
Number x = Sum(@formula)
Currency x = Sum(@dbfield)
Currency x = Sum(@formula)
Note: If a field is assigned to a variable, for example x, the variable x will lose the characteristic of
representing a group of values. So, the following formula will be treated as incorrect.
Number x = @dbfield;
Number y = Sum( x); // system will prompt you that there is no such kind of function.
Tan
Tan(number)
Returns a number specifying the tangent of an angle given in radians. It takes a right-angle triangle,
and returns the length of the side opposite the specified angle divided by the length of the side
adjacent to the angle.
Parameter
number - An angle in the form of number of radians.
Return value
Number value.
Examples
ToBinary
ToBinary(Integer a)
This function changes a specified integer to its binary form.
Parameter
a - A BigInt value.
Return value
The return value is a String.
Example
The return value of the following statement is 1011.
ToBinary(11)
ToHex
ToHex(Integer a)
This function returns the HEX form of a specified value.
Parameter
a - A BigInt value.
Return value
The return value is a String.
Example
The return value of the following statement is 20.
ToHex(32)
ToInt
ToInt(number a)
This function changes a specified number to an Integer.
Parameter
a - A Number value.
Return value
The return value is an Integer.
Example
The return value of the following statement is 100.
ToInt(100.1)
ToOctal
ToOctal(Integer a)
This function returns the octal form of a specified value.
Parameter
a - A BigInt value.
Return value
The return value is a String.
Example
The return value of the following statement is 64.
ToOctal(52)
Truncate
Truncate(Number a)
This function returns a number by truncating the decimal portion.
Parameter
a - A Double value to be truncated.
Return value
The return value is a Number.
Example
The return value of the following statement is 25.00.
Truncate(25.4321)
Truncate(Number a, Integer b)
This function returns a number by truncating the number at the decimal point. The number is truncated
to the decimal place indicated by argument b, and the function returns a fractional number.
Parameters
Return value
The return value is a Number.
Example
The return value of the following statement is 25.430.
Truncate(25.432, 2)
Variance
Variance(Number a[ ])
Variance(Currency a[ ])
Variance(DBField field)
This function computes the variance of all the values referred to by the argument.
Parameters
a - A Number array.
groupby - A constant string which indicates the DBField, formula or parameter grouped by.
Return value
Returns a Number type value.
Examples
Number x = Variance(@dbfield)
Number x = Variance(@formula)
Note: If a field_variable is assigned to a variable, for example x, the variable x will lose the
characteristic of representing a group of values. So, the following formula will be treated as incorrect.
Number x = @dbfield;
Number y = Variance(x); // system will prompt you that there is no such kind of
function.
String
The following is a list of the String functions. Click the links for further information.
Asc
ByteToText
Chr
ExchGetId
ExchGetOrganization
ExchGetPath
ExchGetSite
ExtractString
Filter
InStr
Join
LastIndexOf
Left
Length
LooksLike
LowerCase
Mid
NumericText
Picture
ProperCase
ReplaceString
ReplicateString
Right
Soundex
Space
StrCmp
StringSplit
StrReverse
ToLongString
ToNumber
ToString
ToText
ToWords
Trim
UpperCase
Val
Asc
Asc(Char a)
This function evaluates the ASCII value of the first character of the argument.
Parameter
a - A Char value.
Return value
The return value is an Integer.
Example
The return value of the following statement is 97.
Asc("abc")
ByteToText
ByteToText(byte)
This function will return the size of a message in the "appropriate" unit.
If the parameter is between 1024 and 1048576, then the result will be in kilobytes.
Parameter
Byte is the size of a message in bytes.
Return value
String.
Examples
Chr
Chr(Integer a)
This function returns a single character string associated with the ASCII value passed as the argument.
Parameter
a - A BigInt value.
Return value
The return value is a String.
Examples
ExchGetId
ExchGetId (address)
This function will begin by determining whether the address is in X500 or X400 format. Once this has
been ascertained, the function will then determine the ID.
If the field is in X500 format, the function will extract the last instance of the "CN=" code (not case
sensitive)
If the field is in the X400 format, it will extract the SMTP or MS Ids.
Note: The fields must follow the address type standards for the functions to operate them.
Parameter
address - The address of sender/recipient (String data type).
Return value
String value.
Examples
ExchGetOrganization
ExchGetOrganization(address)
This function will begin by determining whether the address is in X500 or X400 format. Once this has
been ascertained, the function will then determine the Organization Name.
If the field is in X500 format, the function will extract the last instance of the "/O=" code (not case
sensitive).
If the field is in the X400 format, it will extract the instance of the "P=" code (not case sensitive).
Note: The fields must follow the address type standards for the functions to operate on them.
Parameter
address - The address of the sender/recipient (String data type).
Return value
String value.
Examples
ExchGetPath
ExchGetPath(path)
This function will return the container information in an address field.
If the address type is X500, the function will return all of the information from the first instance of
the "CN=" code until the last instance of the "CN=" code. If there is only one instance of the "CN="
code, the function will return NULL.
If the address type is X400, the function will return all "OU*=" codes (residing between the "P=" and
"O=" codes).
If the address starts with "DDA:", the function will return all information after the "DDA:" code.
Parameter
path - The address of sender/receiver (String data type).
Examples
ExchGetSite
ExchGetSite(address)
The function will begin by determining whether the address is in X500 or X400 format. Once this has
been ascertained, the function will then determine the Site Name.
If the field is in X500 format, the function will extract the last instance of the "/OU=" code (not case
sensitive).
If the field is in the X400 format, it will extract the instance of the "O=" code (not case sensitive).
Note: The fields must follow the address type standards for the functions to operate on them.
Parameter
address - The address of sender/recipient (String data type).
Return value
String value.
Examples
ExchGetSite("/o=Jinfonet Software/ou=JReport/cn=Configuration/cn=Servers/cn=ESPRESSO/
cn=Fredt") - Returns "JReport".
ExchGetSite("c=US; a= ;p=Jinfonet;o=apps-wga; dda:[email protected]") - Returns
"apps-wga".
ExtractString
ExtractString(String origin, String start, String end)
This function is used to evaluate an origin string and returns the first occurrence of a String that starts
with the Start String and ends with the End String (the End String is excluded). If the End String is not
found, the string that starts with the Start String till its end will be returned.
Parameters
Return value
The return value is a String.
Examples
The return value of the following statement is day after that day.
ExtractString("one day after that day", "d", "c")
ExtractString("The rain in Spain falls on the plain","rain", "plain") - Returns rain in Spain falls on the.
Filter
Filter(inString, searchString)
This function is designed to search the string in the specified strings. It searches an array of strings for
a specified string, and returns the strings in an array.
Overloads
Filter(inString, searchString)
Parameters
inString - An array of string which you want to find the search string from.
include - An optional Boolean value indicating whether to return substrings that include or exclude
searchString. If include is True, Filter returns the subset of the array that contains searchString as a
substring. If include is False, Filter returns the subset of the array that does not contain searchString
as a substring. If omitted, the value True will be used.
compare - An optional Number value indicating the kind of string comparison to use,
Return value
Array of String values.
Examples
Suppose that inString = [ "abc", "Abc", "abcdfg", "asdfabc", "sdfdfd"], searchString = "abc"
string inString[]=["John","Paul","George","Ringo"];
Join(Filter(inString,"o"),",");
This formula can search strings which include the word "o" and use comma to compart them.
InStr
InStr(String a, String b)
This function returns the position of the first occurrence of one string within another. If String a is not
found in String b, the InStr function will return -1.
Parameters
Return value
The return value is an Integer.
Examples
a - A BigInt value that is the character position in String b where the search is to begin.
Return value
The return value is an Integer.
Examples
Join
Join(stringArray)
Returns a string created by joining a number of substrings contained in an array.
Overloads
Join(stringArray)
Join(stringArray, delimiterString)
Parameters
Return value
String value.
Examples
Assume that the stringArray list in the examples consists of the following three elements: Welcome,
Use and JReport.
LastIndexOf
LastIndexOf(String a, String b)
This function returns the position of the last occurrence of one string within another, if String b is not
found in String a, the InStr function will return -1.
Parameters
Return value
The return value is an Integer.
Examples
a - A BigInt value that is the character position in String b where the search is to end.
Return value
The return value is an Integer.
Left
Left(String a, Number b)
This function returns a substring that contains the specified number of characters from the left side of a
string.
Parameters
a - A String value.
Return value
The return value is a String.
Example
The return value of the following statement is he is.
Left("he is my father", 5)
Length
Length(String a)
This function returns the number of characters in a String.
Parameter
a - A String value.
Return value
The return value is an Integer.
Example
The return value of the following statement is 16.
Length("she is my mother")
LooksLike
LooksLike(String a, String b)
This function enables you to locate field values using standard DOS wildcards ( ? is a wildcard for a
single character, * is a wildcard for any number of characters). It does this by comparing a String to a
mask which contains one or more wildcards. The function returns True if the string matches the mask,
and False if the string does not match the mask.
Parameters
Return value
The return value is True or False.
Examples
LowerCase
LowerCase(String a)
This function returns a String that contains all lowercase letters converted from String a.
Parameter
a - A String value.
Return value
The return value is a String.
Example
The return value of the following statement is this is her book.
LowerCase("This is HER book")
Mid
Mid(String a, Number b)
This function returns a number of characters from a specified position of a String.
Parameters
Return value
The return value is a String.
Example
The return value of the following statement is my father.
Mid("he is my father", 6)
Return value
The return value is a String.
Examples
NumericText
NumericText(String a)
This function is used to test if the content of the string is a Number.
Parameter
a - A String value to be tested.
Return value
The return value is Boolean.
Examples
Picture
Picture(String a, String b)
This function prints a string or values in a string in a predetermined format.
Parameters
b - A String value representing the way you want the characters in the string to be printed.
Return value
The return value is a string.
Examples
ProperCase
Capitalizes the first letter in a text string and any other letter that follows a character other than a
letter, and converts all other letters to lowercase letters.
Overloads
ProperCase(String)
Parameter
String - A text string.
Return value
String value.
Examples
ReplaceString
ReplaceString(inString, searchString, replaceString, startPosition, count, compare)
Returns a String in which a specified substring has been replaced with another substring a specified
number of times. As an option, you can also specify a location in the string where the replacing process
will begin from (returns a string starting from that position). This function is typically used in a string to
systematically replace one substring with another.
Overloads
Parameters
startPosition - An optional Number indicating the position within inString where the substring search
is to begin from. If omitted, 1 will be used.
count - An optional Number of substring substitutions to be performed. If omitted, the default value
is -1, which means make all possible substitutions.
compare - An optional Number indicating the kind of comparison to use when evaluating substrings:
Return value
String value.
Examples
Assume that inStrings = "abc Abc abcdfg asdfabc sdfdfd", searchString = "abc", replaceString = "ABC".
Note: The return value of the replace function is a String, with the specified substring replacements
made, beginning at the position specified by startPosition, and endings at the end of the inString string.
It is not a start to finish copy of the original string.
ReplicateString
ReplicateString(String a, Integer b)
This function replicates the string in String a the number of times specified by b.
Parameters
Return value
The return value is a String.
Example
The return value of the following statement is Stop! Stop! Stop!.
ReplicateString("Stop!", 3)
Right
Right(String a, Integer b)
This function is used to extract the specified number of characters in String a from the right side.
Parameters
Return value
The return value is a String.
Example
The return value of the following statement is mother.
Right("She is my mother", 6)
Soundex
Soundex(string)
Evaluates a text string and returns a four-character value that symbolizes the way the string sounds.
Use this function whenever you want to locate records based on two or more field values that are
spelled differently yet sound alike. This function can also be used to find customer names that have
been misspelled.
Parameter
String is one of two or more strings that sound alike.
Return value
Text string.
Examples
Soundex("Jinfonet") - Returns J515.
Notes:
The value string must be in quotes.
Soundex works only with values that begin with the same letter. For example, Soundex will return
the same value for Chris and Cris C620 but not for Kris K620. Soundex creates a code based on the
first character in the string plus three characters based on the following:
If the resulting code is only 2 or 3 characters long, Soundex uses zeros to fill it out to four
characters. For example, in the name Lauren, only the L, r, and n are translated (Lrn), so the
If the resulting code is more than four characters long, all characters after the fourth character will
be ignored. For example, in the name Patrick, the P, t, r, c, and k can be translated (Ptrck), but the
resulting Soundex code will only be four characters P362.
Space
Space(Integer a)
This function returns a String value that contains a specified number of spaces.
Parameter
a - A BigInt value indicating the number of spaces.
Return value
The return value is a String.
Example
The return value of the following statement is
Space(3)
StrCmp
StrCmp(String a, String b)
This function is used to compare two strings. It returns positive if String a is greater than String b,
returns 0 if String a is equal to String b, and returns negative if String a is less than String b.
Parameters
a- A String value.
b- A String value.
Return value
The return value is an Integer.
Examples
StringSplit
StringSplit(inString, delimiterString, count, compare)
This function takes a String that contains a number of substrings, breaks it up into a specified number
of substrings and returns an array containing the substrings.
Overloads
stringSplit(inString)
stringSplit(inString, delimiterString)
Parameters
inString - A String expression containing substrings and delimiters.
delimiterString - An optional String character used to identify substring limits. If omitted, the space
character (" ") is assumed to be the delimiter. If the delimiter is a zero-length string, a singleelement array containing the entire inString string will be returned.
count - An optional Number value of substrings to be returned. The value -1 indicates that all
substrings will be returned. If omitted, -1 will be used.
compare - An optional Number indicating the kind of comparison to use when evaluating the
delimiter string:
Return value
Array of String values.
Examples
Assume that inString = "Welcome use JReport"
Note: If count, c, is less than the total number of substrings in inString, then at most c substrings will
be returned as elements in the resultant array. The last element in the array is a concatenation of the
substring and all the remaining substrings.
StrReverse
strReverse(inString)
This function is designed to reverse the string. It returns a String in which the character order of
inString is reversed. If inString is a zero-length string (" "), a zero-length string will be returned.
Parameter
inString - A String whose characters are to be reversed.
Return value
String value.
Examples
ToLongString
toLongString(String a)
This function converts a string to a long string.
Parameter
a - A String value.
Return value
The return value is a LongString.
Example
The return value of the following statement is aa.
LongString a=toLongString("aa");
string b="bb";
if (b > toString(a)) then
return a
else
return toLongString(b);
ToNumber
ToNumber(Currency a)
This function converts a Currency to a Number.
Parameter
a - A Currency value.
Return value
The return value is a Number.
Examples
ToNumber(String a)
This function converts a specified string to a Number.
Parameter
a - A Char value.
Return value
The return value is a Number.
Example
The return value of the following statement is 123.00.
ToNumber("123")
Note: In this function, the format of the string should be [#] or [#].[#]. If you input a character string
as the argument, the return value will be NULL.
ToString
toString(LongString a)
This function converts a long string to a string.
Parameter
a - A LongString value.
Return value
The return value is a String.
Examples
The return value of the following statement is aa.
LongString a=toLongString("aa");
string b="bb";
if (b > toString(a)) then
return a
else
return toLongString(b);
ToText
ToText (Integer a, String b)
This function converts a BigInt value to a String.
Parameters
b - A String value indicating the format for displaying the value in argument a.
Return value
The return value is a String.
Example
The return value of the following statement is 456.
ToText(456, "###")
Return value
The return value is a String.
Example
The return value of the following statement is 456.00.
ToText(456, "###", 2)
ToText(Integer a)
This function converts a BigInt value to a String.
Parameter
a - A BigInt value to be converted.
Return value
The return value is a String.
Example
The return value of the following statement is 456.
ToText(456)
Return value
The return value is a String.
Examples
Return value
The return value is a String.
Example
The return value of the following statement is $1*234.57.
ToText($1234.57, "$#,###.000", 2, "*")
ToText(Number a, String b)
This function converts a Double value to a String.
Parameters
Return value
The return value is a String.
Example
The return value of the following statement is 1236.46.
ToText(1236.456, "###0.00")
Return value
The return value is a String.
Example
The return value of the following statement is 1,234.6.
ToText(1234.567, 1, ",")
Return value
The return value is a String.
Example
The return value of the following statement is 1,234,57.
ToText(1234.567, 2, "," , ",")
Return value
The return value is a String.
Example
The return value of the following statement is 1,234.00.
ToText(1234, 2, ",")
Return value
The return value is a String.
Example
The return value of the following statement is $123.5.
ToText($123.456, "$##0.00", 1)
ToText(Number a)
This function converts a Double value to a String.
Parameter
a - A Double value to be converted.
Return value
ToText(Time a, String b)
This function converts a Time value to a String.
Parameters
Return value
The return value is a String.
Example
Suppose the time is 08:48:58, the return value of the following statement is 8:48:58.
ToText(ToTime(8,48,58), "h:mm:ss")
Return value
The return value is a String.
Example
Suppose the time is 8:48:58 in the morning, the return value of the following statement is 8:48:58 AM.
ToText(ToTime(8,48,58), "h:mm:ss a", "AM")
Return value
The return value is a String.
Examples
Suppose the time is 08:48:58, the return value of the following statement is 8:48:58 AM.
ToText(ToTime(8,48,58), "h:mm:ss a", "AM", "PM")
Suppose the time is 21:49:59, the return value of the following statement is 9:49:59 PM.
ToText(ToTime(21,49,59), "h:mm:ss a", "AM", "PM")
ToText(DateTime a)
This function converts a DateTime value to a String.
Parameter
a - A TimeStamp value to be converted.
Return value
The return value is a String.
Example
Suppose the date is July 15,1999 and time is 7:42:51, the return value of the following statement is 15Jul-99 7:42:51 AM.
ToText(ToDateTime(1999,7,15,7,42,51))
ToText(DateTime a, String b)
This function converts a DateTime value to a String.
Parameters
Return value
The return value is a String.
Example
Suppose the date is July 15,1999 and time is 7:42:51, the return value of the following statement is 0715-99 7:42:51.
ToText(ToDateTime(1999,7,15,7,42,51), "MM-dd-yy h:mm:ss")
Return value
The return value is a String.
Example
Suppose the date is July 15,1999 and time is 7:42:51, the return value of the following statement is 15Jul-99 7:42:51 AM.
ToText(ToDateTime(1999,7,15,7,42,51), "dd-MMM-yy h:mm:ss a", "AM")
Return value
The return value is a String.
Examples
Suppose the date is Oct. 7,1999 and time is 7:42:51, the return value of the following statement is
07-Oct-99 7:42:51 AM.
ToText(ToDateTime(1999,10,7,7,42,51), "dd-MMM-yy h:mm:ss a", "AM", "PM")
Suppose the date is Oct. 7,1999 and time is 18:42:51, the return value of the following statement is
07-Oct-99 6:42:51 PM.
ToText(ToDateTime(1999,10,7,18,42,51), "dd-MMM-yy h:mm:ss a","AM", "PM")
Return value
The return value is a String.
Example
The return value of the following statement is 12,345.00.
ToText(12345, 2, ",", ".")
ToText(Currency a, String b)
This function converts a Currency value to a String.
Parameters
Return value
The return value is a String.
Example
The return value of the following statement is $123.45.
ToText($123.45, "$##0.00")
ToText(Integer a, Integer c)
This function converts a BigInt value to a String.
Parameters
Return value
The return value is a String.
Example
The return value of the following statement is 123.00.
ToText(123, 2)
Return value
The return value is a String.
Example
The return value of the following statement is $1,234.57.
ToText($1234.567, 2, ",")
ToText(Currency a, Integer c)
This function converts a Currency value to a String.
Parameters
Return value
The return value is a String.
Example
The return value of the following statement is $123.46.
ToText($123.4567, 2)
ToText(Number a, Integer c)
This function converts a Double value to a String.
Parameters
Return value
The return value is a String.
Example
The return value of the following statement is 123.46.
ToText(123.456, 2)
Parameters
Return value
The return value is a String.
Example
The return value of the following statement is $1,234.57.
ToText($1234.567, 2, ",", ".")
ToText(Date a)
This function converts a Date value to a String.
Parameter
a - A Data value.
Return value
The return value is a String.
Example
Suppose the date is July 15,1999, the return value of the following statement is 15-Jul-99.
ToText(ToDate(1999,7,15))
ToText(Currency a)
This function converts a Currency value to a String.
Parameter
a - A Currency value to be converted.
Return value
The return value is a String.
Example
The return value of the following statement is $123.45.
ToText($123.45)
ToText(Bit a)
This function converts a Bit value to a String, either true or false.
Parameter
a - A Bit value.
Return value
The return value is a String.
Example
The return value of the following statement is false.
ToText(3<2)
ToText(Date a, String b)
This function converts a Date value to a String.
Parameters
a - A Date value.
Return value
The return value is a String.
Example
Suppose the date is July 15,1999, the return value of the following statement is 15-Jul-99.
ToText(ToDate(1999,7,15), "dd-MMM-yy")
ToText(Time a)
This function converts a Time value to a String.
Parameter
a - A Time value.
Return value
The return value is a String.
Example
Suppose the time is 12:40:30, the return value of the following statement is 12:40:30 PM.
ToText(ToTime(12,40,30))
Return value
The return value is a String.
Example
The return value of the following statement is 1,234.57.
ToText(1234.567, "#,###.000", 2, ",")
Return value
The return value is a String.
Example
The return value of the following statement is 1,234.00.
ToText(1234, "#,###", 2, ",", ".")
Return value
The return value is a string.
Example
The return value of the following statement is 123.46.
ToText(123.456, "###.00", 2)
Return value
The return value is a String.
Example
The return value of the following statement is 1,234.00.
ToText(1234, "#,###", 2, ",", ".")
Return value
The return value is a String.
Example
The return value of the following statement is 1,234.57.
ToText(1234.567, "#,###.000", 2, ",", ".")
Notes:
When converting a Double value, Currency value or a BigInt value to a String, special characters
used as format in argument b are following:
Symbol
Meaning
a digit
Notes
Can't mix 0, *, and _ in same format
separates formats
Time format syntax: The time format is specified by means of a String time pattern. In this
pattern, all ASCII letters are reserved as pattern letters, which are defined as the following:
Symbol
Meaning
Presentation
Example
era designator
Text
AD
year
Number
1996
month in year
July & 07
day in month
Number
10
Number
12
Number
minute in hour
Number
30
second in minute
Number
55
millisecond
Number
978
day in week
Text
Tuesday
day in year
Number
189
Number
week in year
Number
27
week in month
Number
am/pm marker
Text
PM
Number
24
Number
Text
time zone
'
''
single quote
ToWords
ToWords(Number a)
This function converts a Number field value or the result of a numeric calculation to words.
Parameter
a - A fractional number to be converted into words.
Return value
The return value is a String.
Example
The return value of the following statement is ten and 12/100.
ToWords(10.12)
ToWords(Integer a)
This function converts a Number field value or the result of a numeric calculation to words.
Parameter
a - A BigInt value to be converted into words.
Return value
The return value is a String.
Example
The return value of the following statement is twenty and xx/100.
ToWords(20)
ToWords(Currency a)
This function converts a Number field value or the result of a numeric calculation to words.
Parameter
a - A Currency value to be converted into words.
Return value
The return value is a String.
Example
The return value of the following statement is three and 15/100.
ToWords($3.15)
ToWords(Number a, Integer b)
This function converts a Number field value or the result of a numeric calculation to words.
Parameters
b - A BigInt value indicating the number of decimal places to be converted. This argument is optional.
Return value
The return value is a String.
Example
The return value of the following statement is three and 1/10.
ToWords(3.14, 1)
ToWords(Integer a, Integer b)
This function converts a Number field value or the result of a numeric calculation to words.
Parameters
b - A BigInt value indicating the number of decimal places to be converted. This argument is optional.
Return value
The return value is a String.
Example
The return value of the following statement is three and x/10.
ToWords(3, 1)
ToWords(Currency a, Integer b)
This function converts a Number field value or the result of a numeric calculation to words.
Parameters
b - A BigInt value indicating the number of decimal places to be converted. This argument is optional.
Return value
The return value is a String.
Example
The return value of the following statement is three and 5/10.
ToWords($3.45, 1)
Trim
Trim(String a)
This function is used to remove the leading and the trailing spaces from string arguments.
Parameter
a - A String value.
Return value
The return value is a String.
Example
The return value of the following statement is he is a boy.
Trim("he is a boy")
TrimLeft(String a)
This function is used to remove the spaces on the left side of the string.
Parameter
a - A String value to be trimmed.
Return value
The return value is a String.
Example
The return value of the following statement is he is a boy.
TrimLeft("he is a boy")
TrimRight(String a)
This function is used to remove the spaces on the right side of the string.
Parameter
a - A String value to be trimmed.
Return value
The return value is a String.
Example
The return value of the following statement is he is a boy.
TrimRight("he is a boy")
UpperCase
UpperCase(String a)
This function converts all letters in string a to uppercase letters.
Parameter
a - A String value.
Return value
The return value is a String.
Example
The return value of the following statement is HE IS A BOY.
UpperCase("he is a boy")
Val
Val(String a)
This function reads a string containing numbers (e.g. address, phone or social security number), and
converts them to a decimal value. Val stops reading when it finds the first character in the string.
Parameter
a - A String value.
Return value
The return value is a Number.
Example
The return value of the following statement is 63,550,513.00.
Val("63550513Mr.Tom")
Date/Time
Date functions allow you to convert numbers to dates and dates to numbers. The following is a list of
the Data functions. Click the links for further information.
Current
DateAdd
DateDiff
DatePart
DateTime
DateTimeTo2000
DateTo2000
Day
DTSTo2000
DTSToSeconds
First
ForEach
Hour
IsDate
IsDateTime
IsTime
Minute
Month
MonthName
Now
Quarter
Second
Timer
ToDate
ToDateTime
Today
ToTime
WeekdayName
WeekFrom
WeekOfMonth
Year
Current
CurrentDate()
This function returns the current date on a report.
Return value
The return value is a date.
Example
If today is Oct. 6,1999, the return value of the following statement is 10/06/99.
CurrentDate()
CurrentDateTime()
This function returns the current date and time on a report.
Return value
The return value is a DateTime.
Example
If today is Oct.6,1999, the current time is 5:10:27 p.m., the return value of the following statement is
1999-10-06 05:10:27.
CurrentDateTime()
CurrentTime()
This function returns the current time on a report.
Return value
The return value is a Time.
Example
If the current time is 5:10:27 p.m., the return value of the following statement is 05:10:27.
CurrentTime()
DateAdd
DateAdd(intervalType, nIntervals, startDateTime)
Returns a DateTime value to which a specified number of time intervals have been added.
This function is used to add interval of time to a DateTime. Its main feature is that the DateTime
returned will always be valid. For example, the function takes into account such factors as the number
of days in a month and leap years. If you want to add or subtract days to a DateTime, you could use
the addition and subtraction operators instead of the function with the "d" parameter. However, this
function also handles other types of intervals such as adding months or hours to a DateTime.
Parameters
Description
yyyy
Year
Month
Day of year
Day
Weekday
ww
Hour
Minute
Second
nIntervals - A Number or numeric expression specifying the number of intervals to be added. It can
be positive (to get DateTimes from the future), or negative (to get DateTimes from the past).
startDateTime - The DateTime value to which the intervals are to be added.
Return value
A DateTime value.
Examples
day.
DateAdd("w",1,CurrentDateTime()) - Returns the DateTime value for current datetime plus one
day.
DateAdd("ww",1,CurrentDateTime()) - Returns the DateTime value for current datetime plus
seven days.
DateAdd("h",1,CurrentDateTime()) - Returns the DateTime value for current datetime plus one
hour.
DateAdd("n",1,CurrentDateTime()) - Returns the DateTime value for current datetime plus one
minute.
DateAdd("s",1,CurrentDateTime()) - Returns the DateTime value for current datetime plus one
second.
DateAdd("d",-32,ToDateTime(1999,9,28)) - Returns the DateTime value 1999-8-27 00:00:00.
DateAdd("m",1,ToDateTime(1996,1,31)) - Returns the DateTime value 1996-2-29 00:00:00.
Notice that DateAdd will not return the invalid value 1996-2-31 00:00:00.
DateAdd("q",17,ToDateTime(1999,9,28)) - Returns the DateTime value 2003-12-28 00:00:00.
DateAdd("h",-400,ToDateTime(1999,9,28)) - Returns the DateTime value 1999-9-11 08:00:00. In
other words, this is the result of subtracting 400 hours from 1999-9-28 00:00:00.
Notes:
To add days to a DateTime, you can use any of the interval type parameters "y", "d" or "w". They all
have the same effect for DateAdd.
DateAdd returns a DateTime value and not a Date value. However, you may need to convert this
DateTime value to a Date value in certain situations (such as if you wanted to assign the value
returned by DateAdd to a Date type variable). To convert to a Date value, use DateAdd in
combination with the ToDate type conversion function. For example, the following returns the Date
value for October 6, 1997.
ToDate(DateAdd("yyyy",-2,ToDateTime(1999,10,6)))
DateDiff
DateDiff(intervalType, startDateTime, endDateTime, firstDayOfWeek)
Returns a number of time intervals between two specified dates.
Overload
Parameters
intervalType - A string expression that is the interval of time you use to calculate the difference
between startDateTime and endDateTime. Possible values can be:
IntervalType value
Description
Yyyy
Year
Quarter
Month
Day of year
Ww
Hour
Minute
Second
firstDayOfWeek - An optional constant specifying the first day of the week. If not specified, jrSunday
will be used.
Constant
Description
jrUseSystem
jrSunday
jrMonday
jrTuesday
jrWednesday
jrThursday
jrFriday
jrSaturday
Return value
A Number value.
Examples
Use DateDiff with the "d" or "y" interval type parameter to find the number of days between two
dates.
DateDiff("d", ToDateTime(1999,10,7), ToDateTime(1999,10,10)) - Returns 3
Use DateDiff with the "yyyy" interval type parameter to find the number of years difference between
two dates. This use of DateDiff is the same as finding the difference between the year of
endDateTime and the year of startDateTime.
Suppose that for the above examples, the first date is the date that you bought a mutual fund, and
the second date is the date you sold it. The mutual fund company must send you an annual report
for every year in which you owned units in the fund. You would then get 7, 2 and 1 annual reports
respectively, in the above cases.
Use DateDiff with the "q" parameter to find the number of quarters (3 month periods) difference
between two dates.
Suppose the mutual fund company in the "yyyy" example mailed out quarterly reports. It would need
to mail out 15, 2 and 1 quarterly reports respectively, in the above cases.
Use DateDiff with the "m" parameter to find the number of months difference between two dates.
Use DateDiff with the "w" parameter to calculate the number of weeks between two dates. For
example, if startDateTime is on a Tuesday, DateDiff counts the number of Tuesdays between
startDateTime and endDateTime not including the initial Tuesday of startDateTime. Note however
that it counts endDateTime if endDateTime is on a Tuesday.
DatePart
DatePart(intervalType, inputDateTime, firstDayOfWeek, firstWeekOfYear)
Returns a number that specifies a given part of a given date.
Overloads
DatePart(intervalType, inputDateTime)
DatePart(intervalType, inputTime)
Parameters
intervalType - A String expression that specifies the part of a date to be returned. Possible values
can be:
IntervalType value
Description
Yyyy
Ww
Description
jrUseSystem
jrSunday
jrMonday
jrTuesday
jrWednesday
jrThursday
jrFriday
jrSaturday
firstWeekOfYear - An optional constant specifying the first week of the year. If not specified, the first
week is assumed to be the one in which Jan. 1 occurs (jrFirstJan1).
Constant
Value
Description
jrUseSystem
jrFirstJan1
jrFirstFourDays
Start with the first week that has at least four days in the new year
jrFirstFullWeek
Examples
Notes:
The DatePart function with "yyyy" intervalType parameter is the same as the Year function.
Similarly, the DatePart function with "m", "d", "w", "h", "n" and "s" intervalType argument is the
same as the functions Month, Day, Weekday (or DayOfWeek), Hour, Minute and Second respectively.
On the other hand, there is no easy alternative to using the DatePart function for the "q", "y" and
"ww" intervalType parameters.
The firstDayOfWeek parameter affects the DatePart function when the interval type parameter is "w"
or "ww". For all other intervalType parameter values, it is ignored.
The firstWeekOfYear parameter affects the DatePart function only when the intervalType argument is
"ww". For all other intervalType argument values, it is ignored.
DateTime
DateTimeToDate(Datetime a)
This function evaluates the specified TimeStamp value and returns only the date.
Parameter
a - A TimeStamp value.
Return value
The return value is a date.
Example
If the current date is Oct. 17, 1999 and the current time is 12:27:15, the return value of the following
statement is 10/17/99.
DateTimeToDate(CurrentDateTime())
DateTimeToSeconds(Datetime a)
This function evaluates the specified value and converts the time to the number of seconds from
00:00:00 to the specified time.
Parameter
a - A TimeStamp value.
Return value
The return value is an Integer.
Example
If the current date is Oct. 17, 1999 and the current time is 12:27:15, the return value of the following
statement is 44835.
DateTimeToSeconds(CurrentDateTime())
DateTimeToTime(Datetime a)
This function evaluates the specified TimeStamp value and returns only the time.
Parameter
a - A TimeStamp value.
Return value
The return value is a Time.
Example
If the current date is Oct. 17, 1999 and the current time is 12:27:15, the return value of the following
statement is 12:27:15.
DateTimeToTime(CurrentDateTime())
DateTimeTo2000
DateTimeTo2000(Datetime, Number)
2 digit years(xx)
If the Year value is greater than the windowing number, 19 is appended before the 2 digits (19xx). If
the Year value is less than or equal to the windowing number, 20 is appended (20xx).
4 digit years(19xx)
If the last two digits in the Year value are greater than the windowing number, the Year is retained
as found in the Date field (19xx). If the two digits in the Year value are less than or equal to the
windowing number, the first two digits are changed to 20 (20xx). If the first two digits in the year
field are 20, the Year is retained as found in the Date field (20xx).
Note: If the year is less than or equal to 1899, and greater than or equal to 100, there will be
no change to the date.
Parameters
DateTime - Accepts only valid DateTime fields, with either 2 digit or 4 digit years.
Number - A number between 0 and 99 corresponding with the desired windowing year.
Return value
A Date field with a four digit year.
Examples
Here the window value is greater than the year, and so the year is changed to 20XX.
Some databases maintain the year of a Date as a two-digit field. These samples simulate that Date
field.
DateTo2000
DateTo2000(date, number)
2 digit years(xx)
If the Year value is greater than the windowing number, 19 is appended before the 2 digits (19xx). If
the Year value is less than or equal to the windowing number, 20 is appended (20xx).
4 digit years(19xx)
If the last two digits in the Year value are greater than the windowing number, the Year is preserved
as found in the date field (19xx). If the last two digits in the Year value are less than or equal to the
windowing number, the first two digits are changed to 20 (20xx). If the first two digits in the year
field are 20, the Year is preserved as found in the date field (20xx).
Parameters
date - Accepts only valid Date fields, with either 2 digit or 4 digit years.
number - A number between 0 and 99 corresponding with the desired windowing year.
Return value
A Date field with a four digit year.
Examples
Some databases maintain the year of a date as a two-digit field. The following simulates this type of
date field.
Notes:
If the year is less than or equal to 1899 and greater or equal to 100, there will be no change to the
date.
Whether your database dates are interpreted as two digit years or 4 digit years (19xx) is dependent
on the database driver you are using. The result of the formula will be the same in either case.
Day
Day()
This function returns the day of the month.
Return value
The return value is an Integer.
Example
If today is Oct. 17, 1999, the return value of the following statement is 17.
Day()
Day(Datetime a)
This function extracts the day portion of a specified Date value.
Parameter
a - A TimeStamp value.
Return value
The return value is an Integer.
Example
If the current date is Oct. 17, 1999 and the current time is 12:27:15, the return value of the following
statement is 17.
Day(CurrentDateTime())
Day(Date a)
This function extracts the day portion of a specified Date value.
Parameter
a - A Date value.
Return value
The return value is an Integer.
Example
If the current date is Oct. 17, 1999, the return value of the following statement is 17.
Day(CurrentDate())
DayOfWeek(Datetime a)
This function extracts the day portion of a specified Date value, and indicates which day of the week.
Parameter
a - A TimeStamp value.
Return value
The return value is an Integer.
Example
If the current date is Oct. 17, 1999, current time is 12:27:15 and today is Sunday, the return value of
the following statement is 1 (Sunday is the first day of the week).
DayOfWeek(CurrentDateTime())
DayOfWeek(Date a)
This function extracts the day portion of a specified Date value, and indicates which day of the week.
Parameter
a - A Date value.
Return value
The return value is an Integer.
Example
If today is Oct. 17, 1999 and today is Sunday, the return value of the following statement is 1.
DayOfWeek(CurrentDate())
DayOfWeek()
This function returns the day of the week.
Return value
The return value is an Integer.
Example
If today is Thursday, the return value of the following statement is 5.
DayOfWeek()
DayOfYear()
This function returns the day of the year.
Return value
The return value is an Integer.
Example
If today is Oct. 17, 1999, the return value of the following statement is 290.
DayOfYear()
DTSTo2000
DTSTo2000(DateString, Number)
2 digit years(xx)
If the Year value is greater than the windowing number, 19 is appended before the 2 digits(19xx). If
the Year value is less than or equal to the windowing number, 20 is appended (20xx).
4 digit years(19xx)
If the last two digits in the Year value are greater than the windowing number, the Year is retained
as found in the Date field (19xx). If the two digits in the Year value are less than or equal to the
windowing number, the first two digits are changed to 20 (20xx). If the first two digits in the year
field are 20, the Year is retained as found in the Date field (20xx).
Note: If the year is less than or equal to 1899 and greater than or equal to 100, there will be no
change to the date.
Parameters
Date String - Accepts only valid Date fields, with either 2 digit or 4 digit years. A DateTime string
entered in the format: "yyyy/MM/dd HH: mm: ss.00" or "yy/MM/dd HH:mm:ss:00". For example,
"1997/04/11 12:12:12.00" or "97/04/11 12:12:12.00".
Number - A number between 0 and 99 corresponding with the desired windowing year.
Return value
A DateTime string with a four digit year.
Examples
Some databases maintain the year of a date as a two-digit field and so these samples will simulate
that date field:
DTSToSeconds
DTSToSeconds(string)
Evaluates the specified string, and converts the Time value to the number of seconds from 00:00:00
(12:00 midnight) to the specified time.
Parameter
string - A String which includes a Date and a Time value.
Return value
Whole number.
Example
DTSToSeconds("2004/06/11 13:42:15")- Returns 49335.
First
FirstDayOfMonth(Date a)
This function returns the first day of the month.
Parameter
a - A Date value.
Return value
The return value is a Date.
Example
If the current date is 11/24/2008, the return value of the following statement is 11/01/2008.
FirstDayOfMonth(CurrentDate())
FirstDayOfQuarter(Date a)
This function returns the first day of the quarter.
Parameter
a - A Date value.
Return value
The return value is a Date.
Example
The return value of the following statement is 10/01/2008.
FirstDayOfQuarter(ToDate("11/24/2008"))
FirstDayOfWeek(Date a)
This function returns the first day of the week.
Parameter
a - A Date value.
Return value
The return value is a Date.
Example
The return value of the following statement is 11/23/2008.
FirstDayOfWeek(ToDate("11/24/2008"))
FirstDayOfYear (Date a)
This function returns the first day of the year.
Parameter
a - A Date value.
Return value
The return value is a Date.
Example
The return value of the following statement is 01/01/2008.
FirstDayOfYear(ToDate("11/24/2008"))
FirstSundayOfMonth(Date a)
This function returns the first Sunday of the month.
Parameter
a - A Date value.
Return value
The return value is a Date.
Example
The return value of the following statement is 11/02/2008.
FirstSundayOfMonth(ToDate("11/24/2008"))
FirstSundayOfYear(Date a)
This function returns the first Sunday of the year.
Parameter
a - A Date value.
Return value
The return value is a Date.
Example
The return value of the following statement is 01/06/2008.
FirstSundayOfYear(ToDate("11/24/2008"))
ForEach
ForEachDay(Datetime a)
This function returns the Date portion of a specified DateTime value.
Parameter
a - A DateTime value.
Return value
The return value is a Date.
Example
If the DateTime is Dec.25,1999 20:12:50, the return value of the following statement is 12/25/99.
ForEachDay(ToDateTime(1999, 12, 25, 20, 12, 50))
ForEachWeek(DateTime a)
This function returns the Date of the first day of the week.
Parameter
a - A DateTime value.
Return value
The return value is a Date.
Example
If the DateTime is Oct. 15,1999 5:15:20 and it is Friday, the return value of the following statement is
10/10/99.
ForEachWeek(ToDateTime(1999, 10, 15, 5, 15, 20))
ForEachHalfMonth(DateTime a)
If the day in the DateTime is less than 15, this function will return to the first day of the month. If the
day is more than 15, it will return to the 16th day of the month.
Parameter
a - A DateTime value.
Return value
The return value is a date.
Examples
If the datetime is Sep.13,1999 12:27:15, the return value of the following statement is 09/01/99.
ForEachHalfMonth(ToDateTime(1999,9,13,12,27,15))
If the datetime is Oct.18,1999 5:21:22, the return value of the following statement is 10/16/99.
ForEachHalfMonth(ToDateTime(1999,10,18,5,21,22))
ForEachMonth(DateTime a)
This function returns the first day of the month in a specified DateTime value.
Parameter
a - A DateTime value.
Return value
The return value is a date.
Example
If the datetime is Sep.24,1999 12:05:56, the return value of the following statement is 09/01/99.
ForEachMonth(ToDateTime(1999,9,24,12,5,56))
ForEachQuarter(DateTime a)
If the month of a specified DateTime is before April, the function will return to Jan. 1 of the year. If the
month is after April but before July, the function will return to April. 1 of the year. If the month is after
July but before October, the function will return to July. 1 of the year. If the month is after October, the
function will return to Oct.1 of the year.
Parameter
a - A DateTime value.
Return value
The return value is a date.
Examples
If the datetime is Feb.14,1997 2:10:23, the return value of the following statement is 01/01/97.
ForEachQuarter(ToDateTime(1997,2,14,2,10,23))
If the datetime is May. 28,1999 10:10:25, the return value of the following statement is 04/01/99.
ForEachQuarter(ToDateTime(1999,5,28,10,10,25))
If the datetime is Aug. 28,1999 10:10:25, the return value of the following statement is 07/01/99.
ForEachQuarter(ToDateTime(1999,8,28,10,10,25))
If the datetime is Nov. 11,1998 11:40:23, the return value of the following statement is 10/01/98.
ForEachQuarter(ToDateTime(1998,11,11,11,40,23))
ForEachHalfYear(DateTime a)
If the month of a specified DateTime is before July, the function will return to Jan.1 of the year.
Otherwise the function will return to July 1 of the year.
Parameter
a - A DateTime value.
Return value
The return value is a date.
Examples:
If the datetime is May. 28,1999 10:10:25, the return value of the following statement is 01/01/99.
ForEachHalfYear(ToDateTime(1999, 5, 28, 10, 10, 25))
If the datetime is Nov. 15,1998 11:40:23, the return value of the following statement is 07/01/99.
ForEachHalfYear(ToDateTime(1998, 11, 15, 11, 40, 23))
ForEachYear(DateTime a)
This function will return to Jan.1 of the year.
Parameter
a - A DateTime value.
Return value
The return value is a date.
Example
If the datetime is Aug. 28,1999 10:10:25, the return value of the following statement is 01/01/99.
ForEachYear(ToDateTime(1999, 8, 28, 10, 10, 25))
Hour
Hour(Time a)
This function extracts the hour portion of a specified Time value.
Parameter
a - A Time value.
Return value
The return value is an Integer.
Example
Suppose the time is 10:05:26. The return value of the following statement is 10.
Hour(ToTime(10, 5, 26))
Hour()
This function extracts the hour portion of the current time.
Return value
The return value is an integer.
Example
If the current time is 8:15:30, the return value of the following statement is 8.
Hour()
Hour(DateTime a)
This function extracts the hour portion of a specified TimeStamp value.
Parameter
a - A TimeStamp value.
Return value
The return value is an Integer.
Example
Suppose the datetime is Oct. 15,1999 9:35:22. The return value of the following statement is 9.
Hour(ToDateTime(1999,10,15,9,35,22))
IsDate
IsDate(number or string)
Returns true if the given String or Number value can be converted to a valid Date and returns false
otherwise. A valid Date is any Date between 100-1-1 and 9999-12-31.
Parameters
number - A Number value representing the number of days starting from January 1, 1900. It can be
positive or negative, and is truncated if fractional.
string - A text string representing a date and many forms can be accepted. If the string is a right
Date value and format, the function returns true, otherwise false.
Return value
Boolean value, True or False.
Examples
IsDate(50) - Returns true since the number 50 is interpreted as 50 days from Jan. 1, 1900, which is
Feb 19, 1900.
IsDate(-50) - Returns true since the number 50 is interpreted as 50 days before Jan 1, 1900,
which is Nov 11, 1899.
IsDate("Feb 1, 2004") - Returns true since the string is a right Date value and there is only one
blank between 'Feb' and '1,' and '2004'.
IsDate("2004 - 2 - 19") - Returns false since the String format is not right Date format.
IsDate("2004*2*19") - Returns false since the String format is not right Date format.
IsDateTime
IsDateTime(number/string)
Returns True if the given Number or String value can be converted to a valid DateTime, and returns
False otherwise.
Parameters
number - A Number value or expression to be tested for convertibility to a DateTime value. It can be
positive, negative or fractional. It is interpreted as a number of days from Jan 1, 1900.
string - A String value or expression to be tested for convertibility to a DateTime value. Many forms
are accepted. If the given String value and format are right DateTime value and format, the function
will return true, otherwise false.
Return value
Boolean value, true or false.
Examples
IsDateTime(15.2) - Returns true since the given number argument is interpreted as the DateTime
value 1900-01-15 04:48:00.
IsTime
IsTime(number or string)
Returns True if the given Number or String value can be converted to a valid Time, and returns False if
otherwise.
Parameters
number - A Number value or expression to be tested for convertibility to a Time value. It can be
positive, negative or fractional. It is interpreted as units of 24 hours. If the number makes the Time
value between 0:0:0: and 23:59:59, the function will return true, otherwise false.
string - A String value or expression to be tested for convertibility to a Time value. Many forms are
accepted. If the String value and the format are right Time value and format, the function will return
true, otherwise false.
Return value
Boolean value, true or false.
Examples
IsTime(0.5) - Returns true since the given number argument is interpreted as 0.5 units of 24
hours, which is 12:00:00.
IsTime(3.8) - Returns true since the given number is interpreted as 3.8 units of 24 hours, which is
19:12:00.
IsTime("8:30:00") - Returns true since 8:30:00 is right Time value and format.
IsTime("8 30:00") - Returns false since the given string is not right Time format.
IsTime("8:30:62") - Returns false since the given string is not right Time value.
Minute
Minute()
This function returns the minute portion of the current time.
Return value
The return value is an Integer.
Example
If the current time is 12:41:27, the return value of the following statement is 41.
Minute()
Minute(Time a)
This function returns the minute portion of a specified time.
Parameter
a - A Time value.
Return value
The return value is an Integer.
Example
Suppose the time is 8:30:27. The return value of the following statement is 30.
Minute(ToTime(8,30,27))
Minute(DateTime a)
This function returns the minute portion of a specified DateTime.
Parameter
a - A DateTime value.
Return value
The return value is an Integer.
Example
Suppose the datetime is Sep. 21,1997 12:20:25. The return value of the following statement is 20.
Minute(ToDateTime(1997, 9, 21, 12, 20, 25))
Month
Month()
This function adding one returns the current month of the year.
Return value
The return value is an Integer, which ranges from 0 to 11.
Example
If the current month is September, the return value of the following statement is 8.
Month()
Month(DateTime a)
This function extracts the month portion from a specified TimeStamp value.
Parameter
a - A TimeStamp value.
Return value
The return value is an Integer.
Example
If the timestamp is July 15, 1999 10:10:10, the return value of the following statement is 7.
Month(ToDateTime(1999, 7, 15, 10, 10, 10))
Month(Date a)
This function extracts the month portion from a specified Date value.
Parameter
a - A Date value.
Return value
The return value is an Integer.
Example
If the date is June 15,1999, the return value of the following statement is 6.
Month(ToDate(1999, 6, 15))
MonthName
MonthName(month, abbreviate)
Returns a String name for the specified month.
Parameters
month - A whole number representing the month of the year, with values between 1 and 12, where
1 represents January.
abbreviate - An optional Boolean value that indicates if the month name is to be abbreviated. If the
abbreviate value is true, the function will return the abbreviated month name. Otherwise the function
will return the full month name.
Return value
String value.
Examples
Now
Now()
This function prints the current time on a report.
Return value
The return value is a Time.
Example
If the current time is 1:24:35 in the afternoon, the return value of the following statement is 1:24:35
PM.
Now()
Quarter
Returns the quarter for the given date (1 for the first quarter).
Overloads
Quarter()
Quarter(Date,Integer)
Quarter(Datetime,Integer)
Parameters
Return value
Return an integer (1, 2, 3, 4).
Examples
Second
Second()
This function extracts the second portion of the current time.
Return value
The return value is an Integer.
Example
If the current time is 4:55:03, the return value of the following statement is 3.
Second()
Second(Datetime a)
This function extracts the second portion of a specified TimeStamp.
Parameter
a - A TimeStamp value.
Return value
The return value is an Integer.
Example
Suppose the datetime is Oct. 15,1999 10:15:17, the return value of the following statement is 17.
Second(ToDateTime(1999, 10, 15, 10, 15, 17 ))
Second(Time a)
This function extracts the second portion of a specified time.
Parameter
a - A Time value.
Return value
The return value is an Integer.
Example
Suppose the time is 7:51:59, the return value of the following statement is 59.
Second(ToTime(7, 51, 59))
Timer
Timer()
Returns the number of seconds elapsed since midnight.
Return value
Number value.
Example
If the current time is 9:28:30am, the function returns 34110.
ToDate
ToDate(number or string)
Uses the function IsDate(number or string) to check whether the number/string is right or not. If the
number/string is right, the function returns a Date value between 100-1-1 and 9999-12-31. If the
number/string is wrong, it returns null.
Parameters
number - A value representing the number of days starting from January 1, 1900. It can be positive
or negative, and is truncated if fractional.
string - A text string representing a date and many forms can be accepted.
Return value
Date value or null.
Examples
ToDate(Date a)
This function returns the specified date.
Parameter
a - A Date value.
Return value
The return value is a Date.
Example
Suppose the date is July 15, 1999, the return of the following statement is 07/15/99.
ToDate(ToDate(1999, 7, 15))
ToDate(Datetime a)
ToDate(integer d)
This function converts the argument d (A milliseconds value represents the number of milliseconds that
have passed since January 1, 1970 00:00:00.000 GMT) to a data value.
Parameter
d - A Milliseconds value, a DBField value or a parameter. It should be a long integer.
Return value
The return value is a Date.
Example
The return value of the following statement is 01/02/70.
ToDate(72000000)
Note: When the milliseconds value is larger than 2, you should use DBField or parameter instead.
Return value
The return value is a Date.
Example
The return value of the following statement is 07/15/99.
ToDate(1999, 7, 15)
ToDateTime
ToDateTime(number or string)
Use the function IsDateTime to check whether the number/string is right or not. If it is right, the
function returns a DateTime value between 100-1-1 and 9999-12-31, otherwise the function returns
null.
Parameters
number - A Number value or expression to be tested for convertibility to a DateTime value. It can be
positive, negative or fractional. It is interpreted as a number of days from Jan 1, 1900.
string - A String value or expression to be tested for convertibility to a DateTime value. Many forms
are accepted.
Return value
DateTime value or null.
Examples
ToDateTime("2003-2-29 15:26:25") - Returns null because the given String value is not right
DateTime value.
ToDateTime("2004 *2 *29 15:26:25") - Returns null because the given String format is not right
DateTime format.
ToDateTime(date)
Returns a DateTime value.
Parameter
date - A Date value that can be converted to a DateTime type value by this function.
Example
ToDateTime(ToDate("2004-2-23")) - Returns 2004-02-23 00:00:00.
ToDateTime(Date a, Time b)
This function creates a TimeStamp value from arguments a and b.
Parameters
a - A Date value.
b - A Time value.
Return value
The return value is a DateTime.
Example
Suppose the date is July 15,1999 and the time is 12:20:30, the return value of the following statement
is 1999-07-15 12:20:30.
ToDateTime(ToDate(1999, 7, 15), ToTime(12, 20, 30))
ToDateTime(Integer d)
This function converts the argument d (A milliseconds value represents the number of milliseconds that
have passed since January 1, 1970 00:00:00.000 GMT) to a TimeStamp value.
Parameter
d - A Milliseconds value, a DBField value or a parameter. It should be a long integer.
Return value
The return value is a DateTime.
Example
The return value of the following statement is 1970-01-02 04:00:00.
ToDateTime(72000000)
Notes:
In this function, you can decide the display format by selecting the format from the Report
Inspector. The format of the example above is yyyy-mm-dd hh:mm:ss.
When the milliseconds value is larger than 2, you should use DBField or parameter instead.
Return value
The return value is a DateTime.
Example
Suppose the date is July 15,1999, the return value of the following statement is 1999-07-15 12:00:00.
ToDateTime(1999, 7, 15)
Note: In this function, because you only input year, month and day, the system will output 12:00:00
as the default time. Also you can decide the display format by selecting the format from the Report
Inspector. The format of the example above is yyyy-mm-dd hh:mm:ss.
Return value
The return value is a DateTime.
Example
Suppose the date is July 15,1999 and time is 8:05:30, the return value of the following statement is
1999-07-15 08:05:30.
ToDateTime(1999, 7, 15, 8, 5, 30)
Today
Today()
This function returns the current date on a report.
Return value
The return value is a date.
Example
If the current date is Oct. 11, 1999, the return value of the following statement is 10/11/99.
Today()
ToTime
ToTime(number or string)
Use the function IsTime to check whether the number/string is right or not. If the number/string is
right, the function returns a Time value between 00:00:00 and 23:59:59, otherwise it will return null.
Parameters
number - A Number value or expression to be tested for convertibility to a Time value. It can be
positive, negative or fractional. It is interpreted as units of 24 hours.
string - A String value or expression to be tested for convertibility to a Time value. Many forms are
accepted.
Return value
Time value or null.
Examples
ToTime("20*23:25") - Returns null since the given String format is not time format.
ToTime(DateTime a)
This function extracts the time portion from a specified TimeStamp value.
Parameter
a - A TimeStamp value.
Return value
The return value is a Time.
Example
Suppose the date is July 15,1999 and time is 10:55:45. The return value of the following statement is
10:55:45.
ToTime(Integer t)
This function converts the argument t (A milliseconds value represents the number of milliseconds that
have passed since January 1, 1970 00:00:00.000 GMT) to a Time value.
Parameter
t - A milliseconds value, a DBField value or a parameter. It should be a long integer.
Return value
The return value is a Time.
Example
The return value of the following statement is 08:00:01.
ToTime(1000)
Note: When the milliseconds value is larger than 2, you should use DBField or parameter instead.
Return value
The return value is a Time.
Example
The return value of the following statement is 10:10:10.
ToTime(10, 10, 10)
WeekdayName
WeekdayName(weekday, abbreviate, firstDayOfWeek)
WeekdayName returns a string indicating the name of the specified day of the week.
Overloads
WeekdayName(weekday)
WeekdayName(weekday, abbreviate)
Parameters
Description
jrUseSystem
jrSunday
jrMonday
jrTuesday
jrWednesday
jrThursday
jrFriday
jrSaturday
Return value
String value.
Examples
WeekdayName (3, true, "jrMonday") - Returns Wed, since abbreviation is selected and the first
day of the week is specified to be Monday.
WeekdayName (3, true, "jrUseSystem") - If the current day is Friday, the function returns Sun,
since the first day of week is specified to the current day, and the third day from Friday is Sunday.
WeekFrom
WeekFrom1970()
This function computes the total number of weeks from 1970 to the current date.
Return value
The return value is an Integer.
Example
If the current date is Oct. 13,1999, the return value of the following statement is 1554.
WeekFrom1970()
WeekFrom1970(Timestamp, a)
This function computes the total number of weeks from 1970 to a specified TimeStamp.
Parameter
a - A TimeStamp value.
Return value
The return value is an Integer.
Example
Suppose the timestamp is Jan. 2,1988 10:40:50. The return value of the following statement is 940.
WeekFrom1970(ToDateTime(1988, 1, 2, 10, 40, 50))
WeekFrom1970(Date, a)
This function computes the total number of weeks from 1970 to a specified date.
Parameter
a - A Date value.
Return value
The return value is an Integer.
Example
Suppose the date is July 8,1995. The return value of the following statement is 1331.
WeekFrom1970(ToDate(1995, 7, 8))
WeekOfMonth
WeekOfMonth(Date a)
This function returns the week of the month of a specified date.
Parameter
a - A Date value.
Return value
The return value is an Integer.
Example
If the current date is Oct. 13,1999, the return value of the following statement is 3.
WeekOfMonth(ToDate(1999, 10, 13))
WeekOfMonth(DateTime a)
This function evaluates the week of the month of a specified TimeStamp.
Parameter
a - A TimeStamp value.
Return value
The return value is an Integer.
Example
Suppose the timestamp is Jan. 20,1999 10:40:50. The return value of the following statement is 4.
WeekOfMonth(ToDateTime(1999, 1, 20, 10, 40, 50))
WeekOfMonth()
This function returns the week of the current month.
Return value
The return value is an Integer.
Example
If the current date is Oct. 13,1999, the return value of the following statement is 3.
WeekOfMonth()
WeekOfYear()
WeekOfYear(Date a)
This function returns the week of the year in a specified date.
Parameter
a - A Data value.
Return value
The return value is an Integer.
Example
Suppose the date is July 8,1999. The return value of the following statement is 28.
WeekOfYear(ToDate(1999, 7, 8))
WeekOfYear(DateTime a)
This function returns the week of the year in a specified TimeStamp.
Parameter
a - A TimeStamp value.
Return value
The return value is an Integer.
Example
Suppose the timestamp is Feb. 4,1999 10:40:50. The return value of the following statement is 6.
WeekOfYear(ToDateTime(1999, 2, 4, 10, 40, 50))
Year
Year()
This function returns the current year.
Return value
The return value is an Integer.
Example
If the current year is 1999, the return value of the following statement is 1999.
Year()
Year(Date a)
This function extracts the year portion of a specified date.
Parameter
a - A Data value.
Return value
The return value is an Integer.
Example
Suppose the date is Jan.15,1995. The return value of the following statement is 1995.
Year(ToDate(1995, 1, 15))
Year(DateTime a)
This function extracts the year portion of a specified TimeStamp value.
Parameter
a - A TimeStamp value.
Return value
The return value is an Integer.
Example
Suppose the timestamp is July 15,1988 10:40:50. The return value of the following statement is 1988.
Year(ToDateTime(1988, 7, 15, 10, 40, 50))
Date Range
Note that all the following functions cannot be used to return a value singly.
Aged0To30Days()
This function returns a range of Data values that is within the previous 30 days from today. For
example, if today is 10/14/99, the return range is from 09/15/99 to 10/14/99.
Example
The return value of the following statement is Not Expired.
if (ToDate(1999,9,20) in Aged0To30Days())
return "Not Expired"
else
return "Expired"
Aged31To60Days()
This function returns a range of Data values that is within the previous 31 to 60 days from today date.
For example, if today is 10/13/99, the return range is from 08/12/99 to 09/13/99.
Example
If today is 10/13/99, the return value of the following statement is false.
return ToDate(1998, 4, 20) in Aged31To60Days()
Aged61To90Days()
This function returns a range of Data values that is within the previous 61 to 90 days from today date.
For example, if today is 10/13/99, the return range is from 07/13/99 to 08/11/99.
Example
If today is 10/13/99, the return value of the following statement is false.
return ToDate(1998, 4, 20) in Aged61To90Days()
AllDatesFromToday()
This function returns a range of Data values that include any date from the present day to a date about
10000 years in the future Data value. For example, if today is 04/15/98, the return range is from
04/15/98 to the future.
Example
If today is 10/10/99, the return value of the following statement is false.
AllDatesFromTomorrow()
This function returns a range of Data values that include any date from tomorrow to any future Data
value. For example, if today is 04/15/98, the return range is from 04/16/98 to the future.
Example
If today is 10/10/99, the return of the following statement is false.
return ToDate(1998, 4, 20) in AllDatesFromTomorrow()
AllDatesToToday()
This function returns a range of Data values that include all dates up through the present day. For
example, if today is 4/15/98, the return range is from the past to 04/15/1998.
Example
If today is 10/10/99, the return value of the following statement is true.
return ToDate(1998, 4, 20) in AllDatesToToday()
AllDatesToYesterday()
This function returns a range of Data values that include all dates up through the previous day. For
example, if today is 4/15/98, the return range is from the past to 04/14/1998.
Example
If today is 10/10/99, the return value of the following statement is true.
return ToDate(1998, 4, 20) in AllDatesToYesterday()
Calendar1stHalf()
This function returns a range of Data values that include all dates from January 1st through June 30th.
Example
If today is 10/10/99, the return value of the following statement is false.
return Today() in Calendar1stHalf()
Calendar2ndHalf()
This function returns a range of Data values that include all dates from July 1st through to December
31st.
Example
If today is 10/10/99, the return value of the following statement is true.
return Today() in Calendar2ndHalf()
Calendar1stQtr()
This function returns a range of Data values that include all dates from January 1st through to March
31st.
Example
If today is 10/10/99, the return value of the following statement is false.
return Today() in Calendar1stQtr()
Calendar2ndQtr()
This function returns a range of Data values that include all dates from April 1st through to June 30th.
Example
If today is 10/10/99, the return value of the following statement is false.
return Today() in Calendar2ndQtr()
Calendar3rdQtr()
This function returns a range of Data values that include all dates from July 1st through to September
30th.
Example
If today is 10/10/99, the return value of the following statement is false.
return Today() in Calendar3rdQtr()
Calendar4thQtr()
This function returns a range of Data values that include all dates from October 1st through December
31st.
Example
If today is 10/10/99, the return value of the following statement is true.
return Today() in Calendar4thQtr()
Last4WeeksToSun()
This function returns a range of Data values that include the four weeks previous to last Sunday. For
example, if today is 4/15/95, the return range is from 03/18/95 to 04/14/95.
Example
If today is 10/10/99, the return value of the following statement is false.
return ToDate(1999, 4, 20) in Last4WeeksToSun()
Last7Days()
This function returns a range of Data values that include all dates from seven days ago to today
(including today). For example, if today is 04/15/98, the return range is from (include) 04/09/98 to
04/15/98.
Example
If today is 10/10/99, the return value of the following statement is false.
return ToDate(1999, 4, 20) in Last7Days()
LastFullMonth()
This function returns a range of Data values that include all dates from the first to the last day of the
previous month. For example, if today is 04/15/98, the return range is from 03/01/98 to 03/31/98.
Example
If today is 10/10/99, the return value of the following statement is false.
return ToDate(1999, 4, 20) in LastFullMonth()
LastFullWeek()
This function returns a range of Data values that include all dates from the Sunday to the Saturday of
the previous week. For example, if today is 04/10/95, the return range is from 04/02/95 to 04/08/95.
Example
If today is 10/10/99, the return value of the following statement is false.
return ToDate(1999, 4, 20) in LastFullWeek()
LastYearMTD()
This function returns a range of Data values that fall on any date in the current month last year, up to
the current date last year. For example, if today is 04/15/98, the return range is from 04/01/97 to
04/15/97.
Example
If today is 10/10/99, the return value of the following statement is false.
return ToDate(1999, 4, 20) in LastYearMTD()
LastYearYTD()
This function returns a range of Data values that include all dates in the last year, up to the current
date last year. For example, if today is 04/15/98, the return range is from 01/01/97 to 04/15/97
Example
If today is 10/10/99, the return value of the following statement is true.
return ToDate(1998, 4, 20) in LastYearYTD()
MonthToDate()
This function returns a range of Data values that include all dates from the first day of the month to
today. For example, if today is 04/15/98, the return range is from 04/01/98 to 04/15/98.
Example
If today is 10/10/99, the return value of the following statement is true.
return ToDate(1999, 10, 2) in MonthToDate()
Next30Days()
This function returns a range of Data values that include all days in the next 30 days starting from
today (including today). For example, if today is 04/15/98, the return range is from 04/15/98 to
05/15/98.
Example
If today is 10/10/99, the return value of the following statement is false.
return ToDate(1999, 10, 2) in Next30Days()
Next31To60Days()
This function returns a range of Data values that include all days in the next 31 to 60 days starting
from today. For example, if today is 04/15/98, the return range is from 05/16/98 to 06/14/98.
Example
If today is 10/10/99, the return value of the following statement is false.
return ToDate(1999, 10, 2) in Next31To60Days()
Next61To90Days()
This function returns a range of Data values that include all days in the next 61 to 90 days starting
from today. For example, if today is 04/15/98, the return range is from 06/15/98 to 07/14/98.
Example
If today is 10/10/99, the return value of the following statement is false.
return ToDate(1999, 4, 20) in Next61To90Days()
Next91To365Days()
This function Returns a range of Data values that include all days in the next 91 to 365 days starting
from today. For example, if today is 04/15/98, the return range is from 07/15/98 to 04/15/99.
Example
If today is 10/10/99, the return value of the following statement is false.
Over90Days()
This function returns a range of Data values that include all days that are more than 90 days older than
the current date. For example, if today is 04/15/98, the return range is from the past to 01/14/98.
Example
If today is 10/10/99, the return value of the following statement is true.
return ToDate(1999, 4, 20) in Over90Days()
WeekToDateFromSun()
This function returns a range of Data values that include all days from last Sunday to today (including
today). For example, if today is 04/13/95, the return range is from 04/09/95 to 04/13/95.
Example
If today is 10/10/99, the return value of the following statement is false.
return ToDate(1999, 4, 20) in WeekToDateFromSun()
YearToDate()
This function returns a range of Data values that include all days from the first day of the calendar year
to today (including today). For example, if today is 04/15/98, the return range is from 01/01/98 to
04/15/98.
Example
If today is 10/10/99, the return value of the following statement is true.
return ToDate(1999, 4, 20) in YearToDate()
Financial
The following are functions of the Financial type. Click the links for detailed information.
DDB
FRAccRecTurnover
FRCashFlowVsTotalDebt
FRCurrentRatio
FRDebtEquityRatio
FRDividendYield
FREarningsPerCommonShare
FREquityVsTotalAssets
FRGrossProfitMargin
FRInterestCoverage
FRInventoryTurnover
FRNetProfitMargin
FROperatingProfitMargin
FRPriceEarningsRatio
FRQuickRatio
FRReturnOnCommonEquity
FRReturnOnEquity
FRReturnOnInvestedCapital
FRReturnOnNetFixedAssets
FRReturnOnTotalAssets
FV
IPmt
IRR
MIRR
NPer
NPV
Pmt
PPmt
PV
Rate
SLN
SYD
DDB
DDB(cost, salvage, life, period, factor)
DDB returns a number specifying the depreciation of an asset for a specific time period, using the
double-declining balance method or another method as specified by the factor argument.
Overloads
Parameters
cost - A Number or Currency that specifies the initial cost of the asset. The value is nonnegative and
greater than or equal to salvage.
salvage - A Number or Currency that specifies the value of the asset at the end of its useful life. The
value is nonnegative.
life - A positive Number that specifies the length of the useful life of the asset.
period - A Number that specifies the period for which asset depreciation is calculated. The value is
positive and less than or equal to life. The parameters life and period must have the same units.
factor - An optional positive number that specifies the rate at which the balance declines. If omitted,
2 (double-declining method) will be used.
Return value
Number value.
Examples
Suppose a company purchases a fleet of cars for $560,000. The cars have a lifetime of 12 years and a
salvage value of $30,000. They are depreciated using the double-declining method.
DDB(560000, 30000, 12, 1) - Returns 93333.33. The first year's depreciation is $93,333.33.
DDB(560000, 30000, 13, 5) - Returns 44164.37. The fourth year's depreciation is $44,164.37.
DDB(560000, 30000, 13, 13) - Returns 11605.58. The final year's depreciation is $11,605.58.
FRAccRecTurnover
FRAccRecTurnover(Number accountReceivable, Number sales, DbDouble numOfDays)
This function computes the turnover of the account receivable.
Parameters
Return value
The return value is a Number.
Examples
If the account receivable is 220000.00, the sales value is 450000.00, the number of days is 100, the
return value of the following statement is 48.89.
FRAccRecTurnover(220000.00, 450000.00, 100)
FRCashFlowVsTotalDebt
FRCashFlowVsTotalDebt(Number cashFlow,Number totalDebt)
This function returns the result of cash flow vs total debt.
Parameters
Return value
The return value is a Number.
Example
If the cash flow is 250000.00, the total debt is 280000.00, the return value of the following statement
is 0.89.
FRCashFlowVsTotalDebt(250000.00, 280000.00)
FRCurrentRatio
FRCurrentRatio(Number curAssets, Number curLiabilities)
This function computes the current ratio.
Parameters
Return value
The return value is a Number.
Example
If the current assets are 1800000.00, the current liabilities are 150000.00, the return value of the
following statement is 12.00.
FRCurrentRatio(1800000.00, 150000.00)
FRDebtEquityRatio
FRDebtEquityRatio(Number totalLiabilities, Number totalEquity)
This function computes the debt equity ratio.
Parameters
Return value
The return value is a Number.
Example
If the total liabilities are 175000.00, the total equity is 215000.00, the return value of the following
statement is 0.81.
FRDebtEquityRatio(175000.00, 215000.00)
FRDividendYield
FRDividendYield(Number dividEnd, Number marketPrice)
This function computes the dividend yield.
Parameters
Return value
The return value is a Number.
Example
If the dividend is 9.85, the market price is 10.87, the return value of the following statement is 0.91.
FRDividendYield(9.85, 10.87)
FREarningsPerCommonShare
FREarningsPerCommonShare(Number netProfit, Number preferredDividend, DbDouble
numOfCommonShare)
This function computes the earnings of per common share.
Parameters
Return value
The return value is a Number.
Example
If the net profit is 300000.00, the preferred dividend is 180000.00, the number of common shares is
10000, the return value of the following statement is 12.
FREarningsPerCommonShare(300000.00, 180000.00, 10000)
FREquityVsTotalAssets
FREquityVsTotalAssets(Number totalEquity, Number totalAssets)
This function returns the result of equity vs. total assets.
Parameters
Return value
The return value is a Number.
Example
If the total equity is 215000.00, the total assets are 2200000.00, the return value of the following
statement is 0.10.
FREquityVsTotalAssets(215000.00, 2200000.00)
FRGrossProfitMargin
FRGrossProfitMargin(Number grossProfit, Number sales)
This function is used to compute the gross profit margin.
Parameters
Return value
The return value is a Number.
Example
If the gross profit is 350000.00, the sales value is 450000.00, the return value of the following
statement is 0.78.
FRGrossProfitMargin(350000.00, 450000.00)
FRInterestCoverage
FRInterestCoverage(number cashFlow, number interestExpenses)
This function computes the interest coverage.
Parameters
Return value
The return value is a Number.
Example
If the cash flow is 250000.00, the interest expenses are 350000.00, the return value of the following
statement is 0.71.
FRInterestCoverage(250000.00, 350000.00)
FRInventoryTurnover
FRInventoryTurnover(Number inventory, Number sales, Number numOfDays)
This function computes the turnover of the inventory.
Parameters
Return value
The return value is a Number.
Example
If the inventory is 165000.00, the sales value is 450000.00, the number of days is 100, the return
value of the following statement is 36.67.
FRInventoryTurnover(165000.00, 450000.00, 100)
FRNetProfitMargin
FRNetProfitMargin(Number netProfit, Number sales)
This function is used to compute the net profit margin.
Parameters
Return value
The return value is a Number.
Example
If the net profit is 300000.00, the sales value is 450000.00, the return value of the following statement
is 0.67.
FRNetProfitMargin(300000.00, 450000.00)
FROperatingProfitMargin
FROperatingProfitMargin(Number operatingProfit, Number sales)
This function computes the operating profit margin.
Parameters
Return value
The return value is a Number.
Example
If the operating profit is 380000.00, the sales value is 450000.00, the return value of the following
statement is 0.84.
FROperatingProfitMargin(380000.00, 450000.00)
FRPriceEarningsRatio
FRPriceEarningsRatio(Number marketPrice, Number earningsPerShare)
This function computes the price earning ratio.
Parameters
Return value
The return value is a Number.
Example
If the market price is 10.87, the earning per share is 12, the return value of the following statement is
0.91.
FRPriceEarningsRatio(10.87, 12)
FRQuickRatio
FRQuickRatio(Number curAssets, Number inventories, Number curLiabilities)
This function computes the quick ratio.
Parameters
Return value
The return value is a Number.
Example
If the current assets are 1800000.00, the inventory is 165000.00, the current liabilities are 150000.00,
the return value of the following statement is 10.90.
FRQuickRatio(1800000.00, 165000.00, 150000.00)
FRReturnOnCommonEquity
FRReturnOnCommonEquity(Number netProfit, Number preferredDividend, Number
commonEquity)
This function returns the result of return on common equity.
Parameters
Return value
The return value is a Number.
Example
If the net profit is 300000.00, the preferred dividend is 180000.00, the common equity is 208000.00,
the return value of the following statement is 0.58.
FRReturnOnCommonEquity(300000.00, 180000.00, 208000.00)
FRReturnOnEquity
FRReturnOnEquity(Number netProfit, Number totalEquity)
This function returns the results of return on equity.
Parameters
Return value
The return value is a Number.
Example
If the net profit is 300000.00, the total equity is 215000.00, the return value of the following statement
is 1.40.
FRReturnOnEquity(300000.00, 215000.00)
FRReturnOnInvestedCapital
FRReturnOnInvestedCapital(Number netProfit, Number totalBankDebts, Number totalEquity)
This function returns the result of return on invested capital.
Parameters
Return value
The return value is a Number.
Example
If the net profit is 300000.00, the total bank debts are 100000.00, the total equity is 215000.00, the
return value of the following statement is 0.95.
FRReturnOnInvestedCapital(300000.00, 100000.00, 215000.00)
FRReturnOnNetFixedAssets
FRReturnOnNetFixedAssets(Number netProfit, Number netFixedAssets)
This function returns the result of return on net fixed assets.
Parameters
Return value
The return value is a Number.
Example
If the net profit is 300000.00, the net fixed assets are 400000.00, the return value of the following
statement is 0.75.
FRReturnOnNetFixedAssets(300000.00, 400000.00)
FRReturnOnTotalAssets
FRReturnOnTotalAssets(Number netProfit, Number totalAssets)
This function returns the results of return on total assets.
Parameters
Return value
The return value is a Number.
Example
If the net profit is 300000.00, the total assets are 2200000.00, the return value of the following
statement is 0.14.
FRReturnOntotalAssets(300000.00, 2200000.00)
FV
FV(rate, periods, payment, presentMoney, type)
Returns a number specifying the future value of an annuity based on periodic, fixed payments and a
fixed interest rate.
Overloads
Parameters
Return value
Number value.
Examples
Suppose that you put $1100 per month into a retirement savings plan that pays 6 percent annual
interest, compounded monthly. How much will the account be worth after 20 years?
FV(0.06 / 12, 20 * 12, -1100) - Returns 507144.99. So your account will have $507,145. The
payment (-1100) is negative since you are paying out the money to the plan.
The above example assumes that you make your payments into the plan at the end of the month.
Thus, after the first month, your plan would have $1100 in it, since there wouldn't have been enough
time for any interest to accrue.
Suppose that instead, you make your payments at the start of the month,
FV(0.06 / 12, 20 * 12, -1100, 0, 1) - Returns 510786.21 (rounded to the nearest integer). So
your account will have $510,786. You will save $3,642 more by depositing at the beginning of the
month.
Now suppose that in addition to making payments at the start of the month, you start your plan with
You can also use the FV function to calculate the future value of a lump sum deposit. For example, if
you deposit $25,000 into a plan that pays 6 percent annual interest compounded monthly for 20
years,
FV(0.06 / 12, 20 * 12, 0, -25000) - Returns 82755.12 (rounded to the nearest integer). You
would have $82755.12 in your account.
IPmt
IPmt(rate, period, periods, presentMoney, futureMoney, type)
IPmt returns a number specifying the interest payment for a given period of an annuity based on
periodic, fixed payments and a fixed interest rate.
Overloads
Parameters
period - A Number that specifies the payment period in the range 1 through periods.
periods - A positive Number that specifies the total number of payment periods in the annuity. The
units used for specifying rate, period and periods must be consistent. For example, if periods is the
number of periods in months, then rate is a monthly interest rate and period specifies a month.
presentMoney - A Number or Currency that specifies the present value, or value today, of a series of
future payments or receipts.
futureMoney - An optional Number or Currency that specifies the future value, or cash balance you
want after you've made the final payment. If omitted, 0 will be used.
type - An optional Number that specifies when payments are due. Specify 0 if payments are due at
the end of the payment period, and 1 if payments are due at the beginning of the period. If omitted,
0 will be used.
Return value
Number value.
Examples
Suppose that you want to take out a $250,000 loan payable monthly over 15 years at an annual
interest rate of 6.5 percent. The following formula returns the amount of interest that you pay in
your first loan payment. Note that the monthly interest rate is 0.065 / 12 and the number of months
of the loan is 15 * 12.
IPmt(0.065 / 12, 1, 15 * 12, 250000) - Returns the Number value -1354.17 (rounded to 2
decimals). The value is negative because it represents a payment out from you, whereas the loan
amount of $250,000 is positive because it represents a payment in to you.
The following formula returns the amount of interest that you pay in your 97th payment (after 10
years of payments).
IPmt(0.065 / 12, 9*12 + 1, 15 * 12, 250000) - Returns -701.74 (rounded to 2 decimals). This
shows that you would be making progress on the loan at this stage, with less of your monthly
payment paying the interest.
IRR
IRR(values, guess)
IRR returns a number specifying the internal rate of return for a series of periodic cash flows
(payments and receipts).
Overloads
IRR(values)
IRR(values, guess)
Parameters
values - A Number or Currency type array that specifies cash flow values. The array must contain at
least one negative value (a payment) and one positive value (a receipt). The cash flows must occur
at regular intervals such as monthly or yearly.
guess - An optional Number value that is estimated to be returned by IRR. If omitted, guess is 0.1
(10 percent).
Return value
Number value.
Example
Suppose that you can choose one of two offers: $20,000 now or guaranteed payments of $5,000 after
1 year, $10,000 after 2 years and $15,000 after 3 years. Which is the better offer? One way to quantify
this is to calculate the internal rate of return. If you take the second offer, you can't take the first,
which is like experiencing an initial payment of $20,000 followed by the receipts:
inArray = ["-20000", "15000", "-10000", "25000"];
IRR(inArray)
Returns 0.201 (rounded to 3 decimals) or 20.1 percent interest. With all other things being equal, if
you think that 20.1 percent is a good rate of return, you would prefer the second offer.
Note: The NPV and IRR functions are related since NPV (IRR (values), values) = 0. That is, the internal
rate of return of a sequence of cash flows is the interest rate for which that sequence of cash flows has
a net present value of 0. There is no direct formula for the IRR function and so JReport calculates the
value by iteration. The process depends on the initial guess for the internal rate of return. If the
program reports an error, try changing the value of the guess argument to be closer to what you
expect the internal rate of return to be.
MIRR
MIRR(valueArray, financeRate, reinvestRate)
Returns a number specifying the modified internal rate of return for a series of periodic cash flows
(payments and receipts).
Parameters
valueArray - A Number or Currency type array that specifies cash flow values. The array must
contain at least one negative value (a payment) and one positive value (a receipt). The cash flows
must occur at regular intervals such as monthly or yearly.
financeRate - A Number that specifies the interest rate paid as the cost of financing.
reinvestRate - A Number that specifies the interest rate received on gains from cash reinvestment.
Return value
Number value.
Example
Suppose that you run a business that makes equipment investments, which results in a loss in the first
and fourth years. Your expected annual returns are: -$60,000, $60,000, $45,000, -$50,000, $65,000,
$40,000. Your losses are financed at 10 percent while you reinvest your earnings in an account at 6
percent. The modified internal rate of return is:
MIRR([-60000, 60000, 45000, -50000, 65000, 40000], 0.10, 0.06) - Returns 0.1929 (rounded to
4 decimals) or 19.29 percent.
NPer
NPer(rate, payment, presentMoney, futureMoney, type)
NPer returns a number specifying the number of periods for an annuity based on periodic, fixed
payments and a fixed interest rate.
Overloads
Parameters
Return value
Number value.
Examples
Suppose that you want a $250,000 loan to buy a house. The interest rate is 6.5 percent and you can
afford to pay $3,000 per month. How long a mortgage would you need?
NPer(0.075/12, -3000, 250000) - Returns 118.08 (rounded to 2 decimals) months.
Rather than seeking a loan, suppose that you want to save $500,000 and then buy the house. You
can get a 6.5 percent interest rate compounded monthly from your savings plan, and you want to
save $3,000 per month. How long would you need to save before you had the required amount of
money?
NPer(0.065/12, -3000, 0, 250000) - Returns 68.96 (rounded to 2 decimals) months.
NPV
NPV(rate, values)
Returns a number specifying the net present value of an investment based on a series of periodic cash
flows (payments and receipts) and a discount rate.
Parameters
rate - A Number that specifies the discount rate over the length of the period, expressed as a
decimal.
value - A Number or Currency type array that specifies cash flow values. Negative values represent
payments and positive values receipts. The cash flow must occur at regular intervals, such as
monthly or yearly.
Return value
Number value.
Example
Suppose that someone offers to pay you $15000 after 1 year, $20000 after 2 years, $25000 after 3
years and $12000 after 4 years. If the discount rate (the Time value of money) is 6.5 percent, the
value of this offer to you today is:
NPV(0.065, [15000, 20000, 25000, 12000])
The formula returns 61741.8. So this scheme is worth $61,741.8 to you today. This is less than the
sum of the payments, which is $72000, since you have to wait for this money.
Note: The NPV and IRR functions are related since NPV (IRR (values), values) = 0, which means that
the internal rate of the return of a sequence of cash flow is the discount rate for which that sequence of
cash flow has a net present value of 0.
Pmt
Pmt(rate, periods, presentMoney, futureMoney, type)
Returns a number specifying the payment for an annuity based on periodic, fixed payments and a fixed
interest rate. To find the total amount paid out over the whole loan, multiply the payment per period
(the value returned by Pmt) by the total number of periods.
Overloads
Parameters
Return value
Number value.
Examples
Suppose that you want to take out a $250,000 loan payable monthly over 15 years at an annual
interest rate of 6.5 percent. The following formula returns your monthly loan payment. Note that the
monthly interest rate is 0.065 / 12, and the number of months of the loan is 15 * 12.
Pmt(0.065 / 12, 15 * 12, 250000) - Returns the Number value -2177.77 (rounded to 2
decimals). The value is negative because it represents a payment out from you whereas the loan
amount of $250,000 is positive because it represents a payment in to you.
Now suppose that the payments are made at the beginning of the month instead of the end
(default). Your monthly loan payment is calculated as:
Pmt(0.065 / 12, 15 * 12, 250000, 0, 1) - Returns -2166.04 (rounded to 2 decimals). Note that
your monthly payment is about $11.73 less each month than in the previous example where
payments are made at the end of the month.
Now suppose that you know that you'll receive $80,000 in 15 years. In this case, there is no need to
fully pay off the loan. You only need to reduce the amount owed to $80,000 after 15 years. Note that
the future value is negative since after 15 years you will need to pay out $80,000 to clear the loan.
Your monthly loan payment is calculated as:
Pmt(0.065 / 12, 15 * 12, 250000, -80000) - Returns -1914.22 (rounded to 2 decimals).
PPmt
PPmt(rate, period, periods, presentMoney, futureMoney, type)
Returns a number specifying the principal payment for a given period of an annuity based on periodic,
fixed payments and a fixed interest rate.
Overloads
Parameters
period - A Number that specifies the payment period in the range 1 through periods.
periods - A positive Number that specifies the total number of payment periods in the annuity. The
units used for specifying rate, period and periods must be consistent. For example, if periods is the
number of periods in months, then rate is a monthly interest rate and period specifies a month.
presentMoney - A Number or Currency that specifies the present value, or value today, of a series of
future payments or receipts.
futureMoney - An optional Number or Currency that specifies the future value or cash balance you
want after you've made the final payment. If omitted, 0 will be used.
type - An optional Number that specifies when payments are due. Specify 0 if payments are due at
the end of the payment period, and 1 if payments are due at the beginning of the period. If omitted,
0 will be used.
Return value
Number value.
Examples
Suppose that you want to take out a $250,000 loan payable monthly over 15 years at an annual
interest rate of 6.5 percent. The following formula returns the amount of principal that you pay in
your first loan payment. Note that the monthly interest rate is 0.065 / 12 and the number of months
of the loan is 15 * 12.
PPmt (0.065 / 12, 1, 15 * 12, 250000) - Returns the Number value -823.6 (rounded to 2
decimals). The value is negative because it represents a payment out from you whereas the loan
amount of $250,000 is positive because it represents a payment in to you.
The following formula returns the amount of principal that you pay in your 121st payment (after 10
years of payments):
PPmt (0.065 / 12, 9*12 + 1, 15 * 12, 250000) - Returns -1476.03 (rounded to 2 decimals).
You've made progress on the loan and are paying off more of the principal per payment. This is
because less interest can accrue each month since more of the loan is paid off so that your fixed
monthly payment is applied more to the principal.
PV
PV(rate, periods, payment, futureMoney, type)
Returns a number specifying the present value of an annuity based on periodic, fixed payments to be
paid in the future and at a fixed interest rate.
Overloads
Parameters
Return value
Number value.
Example
Suppose that you want to buy a condo and can make payments of $1100 twice a month (24 annual
payments). If the mortgage rates are 6.5 percent, and you want to pay off the condo in 10 years, what
is the maximum loan that you can take out?
PV(0.065 / 24, 10 * 24, -1100) - Returns 193936 (rounded to the nearest dollar).
You can therefore afford a loan of about $194,000. Notice that the payment argument is negative since
you are paying out the money each month.
Rate
Rate(periods, payment, presentMoney, futureMoney, type, guess)
Rate returns a number specifying the interest rate per period for an annuity. The units of the returned
value are consistent with the units of periods. For example, if periods is in months, then the rate
returned will be a monthly interest rate.
Overloads
Parameters
periods - A positive Number that specifies the total number of payment periods in the annuity.
payment - A Number or Currency that specifies the payment that is to be made for each period.
presentMoney - A Number or Currency that specifies the present value, or value today, of a series of
future payments or receipts.
futureMoney - An optional Number or Currency that specifies the future value or cash balance you
want after you've made the final payment. If omitted, 0 will be used.
type - An optional Number that specifies when payments are due. Specify 0 if payments are due at
the end of the payment period, and 1 if payments are due at the beginning of the period. If omitted,
0 will be used.
guess - An optional Number value estimated to be returned by Rate. If omitted, guess is 0.1 (10
percent).
Return value
Number value.
Examples
An electronics store offers to finance a $12500 television for $560 per month, over 2 years, with no
money down. Is this a good deal? The first step in determining this is to figure out what interest rate
the store is charging.
Rate(2 * 12, -560, 12500) - Returns 0.00588 (rounded to 5 decimals). Notice that periods is 24
months, payment (-560) is negative since monthly payments are being paid, and the present value
(12500) is positive since at the start of the loan, $12500 was effectively received (the value of the
television). The interest rate returned is a monthly interest rate, since periods is in months.
This next expression calculates the interest rate, expressed as a yearly interest rate and as a
percent.
Rate(2 * 12, -560, 12500) * 12 * 100 - Returns 7.06 (rounded to 2 decimals). Thus, the store is
charging an effective annual interest rate of 7.06 percent.
Note: There is no direct formula for the Rate function and so Reports calculates the value by iteration.
The process depends on the initial guess for the rate. If the program reports an error, try changing the
value of the guess argument to be closer to what you expect the interest rate to be.
SLN
SLN(cost, salvage, life)
SLN returns a number specifying the straight-line depreciation of an asset for a single period.
Parameters
cost - A Number or Currency that specifies the initial cost of the asset.
salvage - A Number or Currency that specifies the value of the asset at the end of its useful life.
life - A Number that specifies the length of the useful life of the asset. It must not equal 0.
Return value
Number value.
Example
Suppose a company purchases a fleet of cars for $560,000. The cars have a lifetime of 12 years and a
salvage value of $30,000. The depreciation per year is:
SLN(560000, 30000, 12) - Returns 44166.67. Thus the depreciation per year is $44,166.67.
SYD
SYD(cost, salvage, life, period)
SYD returns a number specifying the sum-of-years' digits depreciation of an asset for a single period.
Parameters
cost - A Number or Currency that specifies the initial cost of the asset.
salvage - A Number or Currency that specifies the value of the asset at the end of its useful life.
life - A positive Number that specifies the length of the useful life of the asset.
period - A Number that specifies the period for which asset depreciation is calculated. The value is
positive and less than or equal to life. The Parameters life and period must have the same units.
Return value
Number value.
Examples
Suppose a company purchases a fleet of cars for $560,000. The cars have a lifetime of 12 years and a
salvage value of $30,000. They are depreciated as follows:
SYD(560000, 30000, 12, 1) - Returns 80000. The first year's depreciation is $81,538.46.
SYD(560000, 60000, 12, 5) - Returns 56000. The fourth year's depreciation is $54,358.97.
SYD(560000, 60000, 12, 12) - Returns 8000. The final year's depreciation is $6,794.87.
Array
The Array functions are all used to summarize field data in several different ways. Following is a list of
the Array functions. Click the links for further information.
Average
Count
DistinctCount
Maximum
Minimum
PopulationStdDev
PopulationVariance
StdDev
Sum
UBound
Variance
Average
Function
Average(array_variable);
Average(field_variable);
Average(field_variable, groupby);
Description
This function is used to return the average value of a group of values referred to by the first argument.
The second argument, if there is one, returns the group by field name.
Arguments
field_variable
field_variable is a special variable in Formula. It refers to a group of values of a database field or of a
formula field. Whatever source they come from, database or formula, they should be of Number or
Currency data type.
array_variable
array_variable refers to an array whose element is of the Number or Currency value.
groupby
groupby can be a constant String which indicates the groupby field name or a field variable on which
grouping occurs, or a parameter variable that can accept a different value before each execution of a
report.
Return type
The result type relies on the first argument. It can be of the Number or Currency data type, if the data
type of each element in the first argument is also of the Number or Currency data type respectively.
Examples
Number x[6] = [1.0, 2.0, 3.0, 4.5, 45.0, 67.0]; Number y = Average(x)
Currency x[] = [$1, $2, $3.0, $4.5, $45, $67]; Currency y = Average(x)
Number x = Average(@dbfield)
Number x = Average(@formula)
Currency x = Average(@dbfield)
Currency x = Average(@formula)
Note: If a field_variable is assigned to a variable, for example X, the variable X will lose the
characteristic of representing a group of values. The following formula will then be treated as incorrect.
Number x = @dbfield;
Number y = Average(x); // system will prompt you that there is no such kind of function.
Count
Function
Count(array_variable);
Count(field_variable);
Count(field_variable, groupby);
Description
This function is used to count the number of a group of values referred to by the first argument. The
second argument, if there is one, returns the group by field name.
Arguments
field_variable
field_variable is a special variable in Formula. It refers to a group of values of a database field or of a
formula field.
array_variable
array_variable refers to an array.
groupby
groupby can be a constant String to indicate the groupby field name, or a field variable on which the
grouping occurs, or a parameter variable that can accept a different value before each execution of a
report.
Return type
Returns a Number value.
Examples
Number x = Count(["str1","str2","str3","str4","str5","str6"]).
Number x = Count(@dbfield).
Number x = Count(@formula).
Note: If a field_variable is assigned to a variable, for example X, the variable X will lose the
characteristic of representing a group of values. The following formula will then be treated as in correct.
Number x = @dbfield;
Number y = Count(x); // system will prompt you that there is no such kind of function.
DistinctCount
Function
DistinctCount(array_variable);
DistinctCount(field_variable);
DistinctCount(field_variable, groupby);
Description
This function is used to count the number of distinct values referred to by the first argument together.
The second argument, if there is one, gives the group by field name.
Arguments
field_variable
field_variable is a special variable in Formula, and refers to a group of values from a database or
formula field.
array_variable
array_variable refers to an array whose element should be a Number.
groupby
groupby can be a constant String to indicate the groupby field name, or a field variable on which
grouping occurs, or a parameter variable that can accept a different value before each execution of a
report.
Return type
Returns a Number value.
Examples
Number x = DistinctCount(["str1","str1","str3","str4","str4","str6"])}
Number x = DistinctCount(@dbfield)
Number x = DistinctCount(@formula)
Note: If a field_variable is assigned to a variable, for example X, the variable X will lose the
characteristic of representing a group of values. The following formula will then be treated as incorrect.
Number x = @dbfield;
Number y = DistinctCount(x); // system will prompt you that there is no such kind of
function.
Maximum
Function
Maximum(array_variable);
Maximum(field_variable);
Maximum(field_variable, groupby);
Description
This function is used to pick up the maximum value from a group of values referred to by the first
argument. The groupby argument specifies the group by field name.
Arguments
field_variable
field_variable is a special variable in Formula, and refers to a group of values from a database or
formula field.
array_variable
array_variable refers to an array whose element should be Number.
groupby
Groupby can be a constant String to indicate the groupby field name, or a field variable on which
grouping occurs, or a parameter variable that can accept a different value before each execution of a
report.
Return type
The result type relies on the first argument. It may be Number, Currency, String, Date, Time,
DateTime, or Boolean if the datatype of each element in the first argument is Number, Currency,
String, Date, Time, DateTime or Boolean respectively.
Examples
Number x = Maximum(@dbfield)
Date x = Maximum(@formula)
Currency x = Maximum(@dbfield)
Boolean x = Maximum(@formula)
Note: If a field_variable is assigned to another variable, for example X, the variable X will lose the
characteristic of representing a group of values. The following formula will then be treated as incorrect.
Number x = @dbfield;
Number y = Maximum(x); // system will prompt you that there is no such kind of function.
Minimum
Function
Minimum(array_variable);
Minimum(field_variable);
Minimum(field_variable, groupby);
Description
This function is used to pick up the minimum value from a group of values referred to by the first
argument together. The second argument, if there is one, gives the group by field name.
Arguments
field_variable
field_variable is a special variable in Formula, and refers to a group of values from a database or
formula field.
array_variable
array_variable refers to an array whose element should be a Number.
groupby
groupby can be a constant String to indicate the groupby field name, or a field variable on which
grouping occurs, or a parameter variable that can accept a different value before each execution of a
report.
Return type
The result type relies on the first argument. It may be Number, Currency, String, Date, Time,
DateTime, or Boolean if the data type of each element in the first argument is Number, Currency,
String, Date, Time, DateTime or Boolean respectively.
Examples
Number x = Minimum(@dbfield)
Date x = Minimum(@formula)
Currency x = Minimum(@dbfield)
Boolean x = Minimum(@formula)
Note: If a field_variable is assigned to a variable, for example X, the variable X will lose the
characteristic of representing a group of values. The following formula will then be treated as incorrect.
Number x = @dbfield;
Number y = Minimum(x); // system will prompt you that there is no such kind of function.
PopulationStdDev
Function
PopulationStdDev(array_variable);
PopulationStdDev(field_variable);
PopulationStdDev(field_variable, groupby);
Description
This function is used to find the population standard deviation of a group of values referred to by the
first argument. The second argument, if there is one, gives the group by field name.
Arguments
field_variable
field_variable is a special variable in Formula, and refers to a group of values from a database or
formula field. Whatever kind of source the data comes from, database or formula, it should be of the
Number data type.
array_variable
array_variable refers to an array whose element should be Number value.
groupby
groupby can be a constant String to indicate the groupby field name, or a field variable on which
grouping occurs, or a parameter variable that can accept a different value before each execution of a
report.
Return type
Returns a Number value.
Examples
Number x = PopulationStdDev(@dbfield)
Number x = PopulationStdDev(@formula)
Note: If a field_variable is assigned to a variable, for example X, the variable X will lose the
characteristic of representing a group of values. The following formula will then be treated as incorrect.
Number x = @dbfield;
Number y = PopulationStdDev(x); // system will prompt you that there is no such kind of
function.
PopulationVariance
Function
PopulationVariance(array_variable);
PopulationVariance(field_variable);
PopulationVariance(field_variable, groupby);
Description
This function is used to find the population variance of a group of values referred to be the first
argument. The second argument, if there is one, gives the group by field name.
Arguments
field_variable
field_variable is a special variable in Formula, and refers to a group of values from a database or
formula field. Whatever kind of source the data comes from, database or formula, it should be of the
Number data type.
array_variable
array_variable refers to an array whose element should be Number value.
groupby
groupby can be a constant String to indicate the groupby field name, or a field variable on which
grouping occurs, or a parameter variable that can accept a different value before each execution of a
report.
Return type
Returns a Number value.
Examples
Number x = PopulationVariance(@dbfield)
Number x = PopulationVariance(@formula)
Note: If a field_variable is assigned to a variable, for example X, the variable X will lose the
characteristic of representing a group of values. The following formula will then be treated as incorrect.
Number x = @dbfield;
Number y = PopulationVariance(x); // system will prompt you that there is no such kind
of function.
StdDev
Function
StdDev(array_variable);
StdDev(field_variable);
StdDev(field_variable, groupby);
Description
This function is used to find the standard deviation of a group of values referred to by the first
argument. The second argument, if there is one, gives the group by field name.
Arguments
field_variable
field_variable is a special variable in Formula, and refers to a group of values from a database or
formula field. Whatever kind of source the data comes from, database or formula, it should be of the
Number data type.
array_variable
array_variable refers to an array whose element should be a Number value.
groupby
groupby can be a constant String to indicate the groupby field name, or a field variable on which
grouping occurs, or a parameter variable that can accept a different value before each execution of a
report.
Return type
Returns a Number value.
Examples
Number x = StdDev(@dbfield)
Number x = StdDev(@formula)
Note: If a field_variable is assigned to a variable, for example X, the variable X will lose the
characteristic of representing a group of values. The following formula will then be treated as incorrect.
Number x = @dbfield;
Number y = StdDev(x); // system will prompt you that there is no such kind of function.
Sum
Function
Sum(array_variable);
Sum(field_variable);
Sum(field_variable, groupby);
Description
This function is used to add a group of values (referred to by the first argument) together. The second
argument, if there is one, gives the group by field name.
Arguments
field_variable
field_variable is a special variable in Formula, and refers to a group of values from a database or
formula field. Whatever kind of source the data comes from, database or formula, it should be of the
Number or Currency data type.
array_variable
array_variable refers to an array whose element should be Number or Currency value.
groupby
groupby may be a constant String to indicate the groupby field name, or a field variable on which
grouping occurs, or a parameter variable that can accept a different value before each execution of a
report.
Return type
The result type relies on the first argument. It may be Number or Currency if the data type of each
element in the first argument is Number or Currency respectively.
Examples
Number x = Sum(@dbfield)
Number x = Sum(@formula)
Currency x = Sum(@dbfield)
Currency x = Sum(@formula)
Note: If a field_variable is assigned to a variable, for example X, the variable X will lose the
characteristic of representing a group of values. The following formula will then be treated as incorrect.
Number x = @dbfield;
Number y = Sum(x); // system will prompt you that there is no such kind of function.
UBound
Function
UBound(array_variable);
Description
This function is used to return the number of elements in an array.
Argument
array_variable
array_variable refers to an Array value, expression or variable.
Return value
Returns a Number value.
Examples
if(isNull(@"Customer Name"))then
{
return "No Data";
}
else{
string s[]=StringSplit(@"Customer Name");
string s1="Java";
string s2[]=filter(s,s1);
if (UBound(s2)!=0) then
return right(s2[0],4)
else
return "No matching data ";
}
This formula searchs for the customer names containing the word "Java".
Variance
Function
Variance(array_variable);
Variance(field_variable);
Variance(field_variable, groupby);
Description
This function is used to find the variance of a group of values referred to by the first argument. The
second argument, if there is one, gives the group by field name.
Arguments
field_variable
field_variable is a special variable in Formula, and refers to a group of values from a database or
formula field. Whatever kind of source the data comes from, database or formula, it should be of the
Number data type.
array_variable
array_variable refers to an array whose element should be Number value.
groupby
groupby can be a constant String to indicate the groupby field name, or a field variable on which
grouping occurs, or a parameter variable that can accept a different value before each execution of a
report.
Return type
Returns a Number value.
Examples
Number x = Variance(@dbfield)
Number x = Variance(@formula)
Note: If a field_variable is assigned to a variable, for example X, the variable X will lose the
characteristic of representing a group of values. The following formula will then be treated as incorrect.
Number x = @dbfield;
Number y = Variance(x); // system will prompt you that there is no such kind of
function.
Others
Besides the above mentioned function types, JReport has some other functions as listed below:
Choose
CurrentBurstingSchema
DBField
Eqv
GetLanguage
GetSecurityContext
IsCountry
IsNoRecord
IsNull
IsNumeric
IsRunBursting
OpenBinFile
OpenBinURL
OpenTxtFile
OpenTxtURL
ReportName
Switch
ToBool
ToNumber
Xor
Choose
Choose(Integer, Array)
Returns a value from the array based on the value of Integer. For example, if integer is 0, it returns
the first element in the array, and if index is 1 it returns the second element in the array.
Parameters
Integer - A Number or numeric expression that specifies the index of the element. The minimum
value is 0, and the maximum is the number of available elements minus 1. If it is out of bounds, no
value will be returned.
Array - An array that contains all the available elements to choose from. All elements must be of the
same type. A choice can be any simple type (Number, Currency, String, Boolean, Date, Time or
DateTime), or range type (Number Range, Currency Range, String Range, Date Range, Time Range
or DateTime Range), but it may not be an array.
Return value
A value from the element in the given array. The type of the returned value is the same as the type of
the element.
Examples
Choose(2,[1,2,3,4,5,6]) - Returns 3.
CurrentBurstingSchema
currentBurstingSchema()
Returns the names of the applied bursting schemas in the current report. When isRunBursting() returns
false, the returned value of currentBurstingSchema() is NULL.
Note: Formulas referring to currentBurstingSchema() are not allowed to be used in queries or
datasets.
Return value
The return value is a String.
Example
If the current report has been applied two bursting schemas: VP and Manager, the return value of the
following statement is VP,Manager:
currentBurstingSchema()
DBField
Next(DBfield a)
This function returns the next value of the current DBField.
Parameter
a - A DBField value.
Return value
The return value is a DBField value.
Example
Suppose you build a report about customer orders. If you use this function on "Ship Date" and insert it
into the Detail Section, then when you run the report, you will see after each record, the next records
will be displayed according to the following statement.
Next(@"Ship Date")
Next(DBfield a, BigInt b)
This function returns the next Nth record decided by the argument b.
Parameters
a - A DBField value.
b - A BigInt value.
Return value
The return value is a DBField value.
Example
Suppose you build a report about customer orders. If you use this function on "Ship Date" and set the
argument b as 1, then when you run the report, you will see after each record, the next first record will
be displayed according to the following statement.
Next(@"Ship Date", 1)
Note: Due to some implementation limitation, the argument b cannot be equal to or larger than 2.
Prev(DBfield a)
This function returns the previous value of the current DBField.
Parameter
a - A DBField value.
Return value
The return value is a DBField value.
Example
Suppose you build a report about customer orders. If you use this function on "Ship Date" and insert it
into the Detail Section, after the report has been run, you will see the previous records displayed after
each record, according to the following statement.
Prev(@"Ship Date")
Prev(DBfield a, BigInt b)
This function returns the previous Nth record decided by the argument b.
Parameters
a - A DBField value.
b - A BigInt value.
Return value
The return value is a DBField value.
Example
Suppose you build a report about customer orders. If you use this function on "Ship Date" and set the
argument b as 4, then when you run the report, you will see before each record, the previous 4th
record displayed according to the following statement.
Prev(@"Ship Date", 4)
Note: Due to some implementation limitation, the argument b cannot be equal to or less than -2.
Eqv
eqv(booleanx, booleany)
Returns a Boolean value of booleanx eqv booleany,
Parameters
Return value
Boolean value.
Examples
GetLanguage
GetLanguage()
Returns the language name of the default locale of JVM.
Return value
The return value will either be the empty string or a lowercase ISO 639 code.
Example
When the default local of JVM is set to en_US, the return value of the following statement is en:
GetLanguage()
GetSecurityContext
getSecurityContext()
Returns a security context object, which provides the method get() to get the Security Context instance
from JReport Server or JReport Designer.
Return value
The return value is a DbSecurityContext object.
Example
Import userClass from "UserFunction";
userClass.getData(getSecurityContext(), @country, );
IsCountry
isCountry(String)
Compares the input parameter with that of the country setting of JVM based on default locale.
Parameter
The input string must be an uppercase 2-letter ISO 3166 code.
Return value
The return value is true or false.
Examples
IsNoRecord
IsNoRecord()
This function tells whether a report has returned a record or not. If the report has no value returned,
the function will return True, otherwise False.
Note: A formula which calls this function cannot be applied to queries, and this formula only takes
effect when laying out this report which contains it.
Example
When using this function, you should refer to a DBField to identify whether this formula is a record level
formula so that it can be calculated when fetching the record. For example,
@"Customers_Customer ID";
if(IsNoRecord())
return "There is no data"
else
return "Total number of records="+@"Count_Customer Name5"
In this example, if no data returned, a tip "There is no data" will be displayed. If data is returned, the
Total number of records will be displayed.
IsNull
IsNull(DBfield a)
This function tells whether a specified value (especially the value of a DBField) is null or not. If the
value is Null, the function will return True, otherwise False.
Parameter
a - A specified value especially a value of a DBField.
Return value
The return value is True or False.
Examples
If you build a report about customer order, suppose one of the values of the field "Shipped" is Null,
the return value of the following statement is true.
IsNull(@shipped)
Integer Total=0;
if (!isnull(@grandTotal))
Total= Total+@grandTotal;
else
Total=Total+0;
This formula can summarize the Grand Total while ignoring the null value or no-record column.
IsNumeric
isNumeric(inString)
Returns a Boolean value if the inString is a math number string.
Parameter
inString - A String type value.
Return value
Boolean value.
Examples
IsRunBursting
isRunBursting()
Returns true if the current report is running based on a bursting schema, else returns false.
Note: Formulas referring to isRunBursting() are not allowed to be used in queries or datasets.
Return value
The return value is true or false.
Examples
If a bursting report is scheduled to run based on a bursting schema, the return value of the following
statement is true:
isRunBursting()
If a bursting report is scheduled to run a normal result, the return value of the following statement is
false:
isRunBursting()
OpenBinFile
openBinFile(string a)
This function is used to open an image file which is saved in your file system according to the path
specified by the parameter.
Parameter
a - A String value which indicates the full path of the image file.
Return value
The return value is a binary image file.
Example
Suppose you have an image file photo1.gif which is saved in the following directory c:\images. The
following example will open this image file.
openBinFile("c:\\images\\photo1.gif")
OpenBinURL
openBinURL(string a)
This function is used to open a binary image file according to the URL which is specified by the
parameter.
Parameter
a - A String value which indicates the URL of the image file.
Return value
The return value is a binary image file.
Example
Suppose you have an image file in the following URL http://www.jinfonet.com/../../asset/images/
Pic1.gif. The following example will open this image file Pic1.gif.
openBinURL("http://www.jinfonet.com/../../asset/images/Pic1.gif")
OpenTxtFile
openTxtFile(string a)
This function is used to open a text file which is kept in your file system according to the path specified
by the parameter.
Parameter
a - A String value which indicates the full path of the text file.
Return value
The return value is a long varchar.
Example
Suppose you have a text file report.int in the following directory C:\JReport\Designer. The following
example will open this text file report.ini.
openTxtFile("C:\\JReport\\Designer\\report.ini")
OpenTxtURL
openTxtURL(string a)
This function is used to open a text file according to the URL specified by the parameter.
Parameter
a - A String value which indicates the URL of the text file.
Return value
The return value is a long varchar.
Example
Suppose you have a text file at the following URL http://www.jinfonet.com/JReport/report.ini. The
following example will open the text file report.ini.
openTxtURL("http://www.jinfonet.com/JReport/report.ini")
ReportName
ReportName()
This function returns the current reportset name.
Return value
The return value is a String.
Example
If the current report name is EmployeeInformation, the return value of the following statement is
EmployeeInformation.
ReportName()
Switch
Switch(Boolean[], Array)
The elements in the two parameters corresponding with each other. This function evaluates the
elements in the first parameter from left to right, and returns element associated with the first element
to evaluate to True. For example,
Switch([1, 2, 3], [a, b, c])
if 1 is true, Switch returns a. If 2 is true, Switch returns b. If 3 is true, Switch returns c.
Parameters
Boolean[] - A Boolean type array, which contains the elements that are to be evaluated.
Array - An array, which contains all the available values that may be returned.
Return value
One of the elements of the parameter array. The type of the returned value is the same as the element
in the array.
Example
Insert the following function into the Detail section of a report,
Switch([@"Customers_Customer ID"< 5, @"Customers_Customer ID" > 50,true],["small",
"large", "medium"])
ToBool
toBool(number or currency)
Returns True if the parameter is positive or negative but not 0, and returns False if the parameter is 0.
Parameter
Can be either a Number, Currency value, or expression.
Return value
Boolean value.
Example
toBool(@Discount) - Returns false if the discount is 0. Otherwise, returns true.
ToNumber
toNumber(Boolean)
Returns 1 if the parameter is True, and returns 0 if the parameter is False.
Parameter
True or false.
Return value
1 or 0.
Examples
toNumber(True) - Returns 1.
toNumber(False) - Returns 0.
Xor
xor(booleanx, booleany)
Returns a Boolean value of booleanx Exclusive OR booleany,
Parameters
Return value
Boolean value.
Examples
Operators
The Operators panel in the Formula Editor lists all the operators JReport provides. They are powerful
and commonly used. The operators can be divided into four types: Math, Comparison, Boolean, and
Others.
Click a link from the following to get details:
Math
Comparison
Boolean
Others
Math
Following are Math operators. You can go into them to get detailed information.
Operator subtract ( - )
Operator multiply ( * )
Operator negative ( - )
Operator percent ( % )
String
String
String
String
String
String
String
URL="http://localhost:8888/jinfonet/runReport.jsp?";
Reports = "&jrs.report_sheet$report2=true";
Catalog = "&jrs.catalog=/SampleReports/SampleReports.cat";
ReportSet = "&jrs.report=/SampleReports/SaleStat_detail.cls";
resultType = "&jrs.result_type=8";
para = "&jrs.param$P_Year=@INNER";
para1 = "&jrs.param$p_AccountManagerName=" + "Jeremy Miner";
This formula sets an URL, which can run one demo report on the JReport Server.
Operator subtract ( - )
numeric op1 - numeric op2
Subtracts Op2 from Op1, and numeric subtracts numeric. The precision of the return value will
correspond to the data type with the higher precision.
Note: Each data type has its own precision. For the Integer type data, BigInt has the highest precision
while integer has the lowest precision. For the real number type data, Currency has the highest
precision while float has the lowest precision. So, if two numeric datum of different precision subtracts
each other, the return value will be of the data type with the higher precision. For example, if an
Integer subtracts a Double, the return value will be a Double value.
Example
The return value of the following expression is 61.71.
87.71 - 26
If one date is 1999-12-12, and the other date is 1995-12-12, the return value of the following
statement is 1461.
ToDate(1999, 12, 12) - ToDate(1995, 12, 12)
if ((todate(@"Due Date")-CurrentDate())<0)
{return '0xff0000'}//red
else
{return '0x000000'}//black
This formula sets values' background, in which way it can highlight report values that are out of
range.
Operator multiply ( * )
integer op1 * number op2
Multiplies Op1 by Op2. When an Integer value is multiplied by a Number value, the return value will be
a Number value.
Example
The return value of the following statement is 104.25.
25 * 4.17
Example
The return value of the following statement is 3.25.
2.56 * $1.27
Example
The return value of the following statement is 0.51.
2.55 / 5
10 \ 3 - Return 3.00
Operator negative ( - )
integer -op1
Returns the opposite value of Op1. If an Integer value is positive, the return value will be negative. If
the Integer value is negative, the return value will be positive.
Examples
number -op1
Returns the opposite value of Op1. If a Number value is positive, the return value will be negative. If
the Number value is negative, the return value will be positive.
Examples
currency -op1
Returns the opposite value of Op1. If a Currency value is positive, the return value will be negative. If
the Currency value is negative, the return value will be positive.
Examples
Operator percent ( % )
integer op1 % integer op2
Computes the percentage of dividing Op1 by Op2. When an Integer value is divided by an Integer, the
return value will be an Integer or a Number.
Example
The return value of the following statement is 77.78.
7%9
Example
The return value of the following statement is 50.
2.5%5
Comparison
Following are Comparison operators. You can go into them to get detailed information.
Operator equal ( == )
Operator equal ( == )
numeric op1 == numeric op2
If Op1 is equal to Op2, the return value will be true. If Op1 is not equal to Op2, the return value will be
false.
Example
The return value of the following statement is false.
5==4
Example
The return value of the following statement is false.
ToDateTime(1999, 10, 10, 5, 10, 10) == ToDateTime(1999,10, 10, 10, 10, 10)
Example
The return value of the following statement is true.
ToDateTime(1999, 10, 10, 5, 10, 10) != ToDateTime(1999,10, 10, 10, 10, 10)
Boolean ( && , || , ! )
Boolean op1 && Boolean op2
Returns true if Op1 is true and Op2 is true.
Examples
! Boolean op1
Returns true if Op1 is false.
Example
The return value of the following statement is def.
Others
return x
Returns the value of X.
Example
The result of the following statement is 06/19/01.
return Today ()
x [ i to j ]
A statement used to define an array.
Example
The return value of the following statement is true.
string range strary = ["a" to "z"];
string x = "d";
x in strary
x[i]
A statement used to index a certain value in an array.
Example
The return value of the following statement is 14:11:27.
time d[3] = [totime(12, 11, 27), totime(13, 11, 27), totime(14, 11, 27)];
time dd[3];
dd = d;
dd[2]
x in y
A statement used to tell whether x is in y, the return value is a boolean value.
Examples
[ x, y, z ]
A statement used to define an array.
Example
The return value of the following statement is 1996-11-27.
date d[3] = [toDate(1997, 11, 27), toDate(1996, 11, 27), toDate(1995, 11, 27)];
date dd[3];
dd = d;
dd[1]
Up to operator: upto x
upto x is used to specify a range of values less than or equal to the value x. x is the type of Number.
Example
The return value of the following statement is true.
integer a[] = [1,1,2,3,4];
3 in a[upto 4];
upto_ x is used to specify a range of values less than but not including the value x. x is the type of
Number.
Example
The return value of the following statement is false.
integer a[] = [1,1,2,3,4];
4 in a[upto_ 4];
You will start off from a table listing all the properties for an object and what can be achieved with
each property.
Some properties are just used to show related information and cannot be edited.
Some properties can be controlled by a formula. Also, some properties must be known by JReport
Engine before page break, so that it can lay out the object. In a formula, the special field
PageNumber is the switch for turning on and off the page break calculation time. If PageNumber is
quoted in the formula, then the calculation time will be after page break and vice versa. For this
reason, JReport will set the calculation time for controlling by whether the formula will be marked as
before page break or not. If otherwise (no mark), the property can be controlled by formula at any
time.
For properties with a hyperlink, you can find further explanation. The same property for different
objects usually means the same thing, unless otherwise stated.
Note: When you hover the mouse on any property in JReport Designer, a tip will be displayed showing
a brief description about the property. You can click
or click
to close the tip. If you do not want to display the property tips, uncheck Show tips in the
Options dialog (File > Options > General > Show tips).
This chapter explains the properties shown in the Report Inspector and Catalog Browser respectively:
Banded object
Chart
Crosstab
Dataset
DBField
Drawing object
Form
Formula field
Image
Label
Map
OLE object
Page panel
Parameter field
Report
Report body
Report set
Special field
Subreport
Summary field
Table
Tabular
Text box
TOC
UDO
Web control
Banded object
The properties of a banded object are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. This property is read only.
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to cache the dataset for this object in the data buffer so other objects
which use the same dataset can share the data rather than perform their own SQL
query.
Data type: Boolean
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Position
Specifies the position of the object. Choose an option from the drop-down list.
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Specifies whether to display the object in the report results when no record is returned
to it.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Excel
Column Index
Specifies the X coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Specifies the width of the border in inches or centimeters. Enter a numeric value to
change the thickness.
Data type: Float
Border Joint
Specifies the joint style for the border line of the object. Choose an option from the
drop-down list.
Data type: Enumeration
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Radius
Specifies the radius for the border line joint of the object. This property takes effect
only when Border Joint is set to round.
Data type: Integer
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
TOC
Anchor Display Value
Specifies the text for the TOC entry for this object in the TOC browser. By default the
text is the unique object name assigned by JReport Designer. The TOC Anchor property
must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
To make the specified values take effect when exporting the report to CSV or Excel, the following is
necessary for both exporting formats:
First set the Columned property in report level to true, and then specify values to the two properties
of the component.
Make sure that the Export to Excel property of the component is set to true.
Make sure that the Export to Excel property of the component is set to true.
When exporting the report to Excel, make sure Normal Formatting is selected in the Export to Excel
dialog.
Make sure that the Export to CSV property of the component is set to true.
When exporting the report to Text via dialog, do check the Delimited Format option.
Note: Preview as Text cannot support the specified values for the default setting of Delimited Format is
unchecked and it is unconfigurable.
The following topics list properties of the children of a banded object:
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Color
Background
Specifies the background color and fill effect of the object. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000), choose a formula that
returns a color, or select Custom from the drop-down list to specify the color and fill
effect.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether the panel can be split across a page break. This property is only
applied if the report has page layout enabled. The default is false which means that the
panel is split only if it exceeds the page height.
Data type: Boolean
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF.
Data type: Boolean
Note: This property only applies to the following web controls: Text Field, Password,
Text Area, Checkbox, Radio Button, Image Button, Button, Drop-down List, and List.
Specifies whether to make the panel extended to the bottom of the page, so that the
next panel starts on a new page.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Label
Specifies the popup text displayed when the mouse pointer hovers over the left edge of
the panel.
Data type: String
On New Page
Specifies whether the panel starts on a new page. This property is only applied if the
report has page layout enabled. The default is false which means the panel starts on a
new page only if the previous page is filled.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to include a horizontal line at the bottom of the panel. This property
applies to panels in table components only. The default is false, which means that no
horizontal line appears at the bottom of the panel.
Data type: Boolean
Suppress
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Specifies whether a panel with no data is included in the report results. The default is
false which means an empty panel is shown.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Underlay
Specifies whether the panel will be layered beneath the next panel in the banded
object. A panel layered beneath a subsequent panel can be used to contain a
background picture or watermark. Banded page header, page footer, or group footer
panels cannot be layered. The default is false which means that the panel is not layered
beneath the next panel.
Data type: Boolean
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Specifies the width of the border in inches or centimeters. Enter a numeric value to
change the border thickness.
Data type: Float
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Paper
Height
Specifies the height of the page in inches or centimeters. The Width and Height values
change when Orientation changes. The Page Type setting determines the Width and Height
values but you can change the latter as desired.
Data type: Float
Orientation
Specifies how to position the report page. The Orientation setting affects the Width and
Height values. Choose an option from the drop-down list.
Specifies the report page dimensions. Choose a size from the drop-down list.
Data type: Enumeration
Width
Specifies the width of the page in inches or centimeters. The Width and Height values change
when Orientation changes. The Page Type setting determines the Width and Height values
but you can change the latter as desired.
Data type: Float
Margin
Bottom Margin
Specifies the distance in inches or centimeters between the bottom page edge and the report
results.
Data type: Float
Left Margin
Specifies the distance in inches or centimeters between the left page edge and the report
results.
Data type: Float
Right Margin
Specifies the distance in inches or centimeters between the right page edge and the report
results.
Data type: Float
Top Margin
Specifies the distance in inches or centimeters between the upper page edge and the report
results.
Data type: Float
The following topics list properties of the children of a banded page panel:
Group panel
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. This property is read only.
Color
Background
Specifies the background color and fill effect of the object. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000), choose a formula that
returns a color, or select Custom from the drop-down list to specify the color and fill
effect.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Label
Specifies the popup text displayed when the mouse pointer hovers over the left edge of
the panel.
Data type: String
Specifies whether to merge the panel into the next panel in the exported Excel file.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to remove blank rows in the panel in the exported Excel file.
Data type: Boolean
Specifies whether to make the objects in the panel repeated in the detail panel in the
exported Excel file.
Data type: Boolean
Specifies whether to include a horizontal line at the bottom of the panel. This property
applies to panels in table components only. The default is false, which means that no
horizontal line appears at the bottom of the panel.
Data type: Boolean
Suppress
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Specifies whether a panel with no data is included in the report results. The default is
false which means an empty panel is shown.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Underlay
Specifies whether the panel will be layered beneath the next panel in the banded
object. A panel layered beneath a subsequent panel can be used to contain a
background picture or watermark. Banded page header, page footer, or group footer
panels cannot be layered. The default is false which means that the panel is not layered
beneath the next panel.
Data type: Boolean
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Group panel
The properties of a group panel in a banded object are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Group By
Shows the group field that the object is based on. If null, the object is grouped based on
the whole dataset. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Others
Current Block Index
The two properties, Current Block Index and Items per Block, work together to control
the data of the object to be displayed in continuous page mode.
Current Block Index specifies the index of the data block that will be displayed. 0 means
the first block index, and 1 the second, and so on.
Data type: Integer
Specifies whether to expand the groups to show the details when the report set is
opened in JReport Viewer. Only works in continuous page mode.
Data type: Boolean
The two properties, Current Block Index and Items per Block, work together to control
the data of the object to be displayed in continuous page mode.
Item per Block specifies the number of records in each data block.
Data type: Integer
Shrink Footer
Specifies whether to hide the group footer panel when collapsing a group in JReport
Viewer. Only works in continuous page mode.
Data type: Boolean
Group Layout
Keep Group Together
If the group header is set to be repeated, you can specify whether to repeat the group
header when a page break occurs on the group footer.
Data type: Boolean
TOC
Anchor Display Value
Specifies the text for the TOC entry for this object in the TOC browser. By default the
text is the unique object name assigned by JReport Designer. The TOC Anchor property
must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
Security
Cascade
Specifies whether to allow the security identifiers specified by the following three
properties to view the group's detail or child groups.
true - The detail panel, the group header panel, and the group footer panel will be
displayed.
false - Only the group header and footer panels will be displayed.
Enables to set cached report bursting. The property accepts user names delimited by "|"
as the value. You can specify which group of data can be viewed by which user.
Data type: String
Groups
Enables to set cached report bursting. The property accepts group names delimited by
"|" as the value. You can specify which group of data can be viewed by which group of
users.
Data type: String
Roles
Enables to set cached report bursting. The property accepts role names delimited by "|"
as the value. You can specify which group of data can be viewed by which role.
Data type: String
Detail panel
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Color
Background
Specifies the background color and fill effect of the object. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000), choose a formula that
returns a color, or select Custom from the drop-down list to specify the color and fill
effect.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether the panel can be split across a page break. This property is only
applied if the report has page layout enabled. The default is false which means that the
panel is split only if it exceeds the page height.
Data type: Boolean
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Specifies whether to make the panel extended to the bottom of the page, so that the
next panel starts on a new page.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Label
Specifies the popup text displayed when the mouse pointer hovers over the left edge of
the panel.
Data type: String
Specifies whether to merge the panel into the next panel in the exported Excel file.
Data type: Boolean
On New Page
Specifies whether the panel starts on a new page. This property is only applied if the
report has page layout enabled. The default is false which means the panel starts on a
new page only if the previous page is filled.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to remove blank rows in the panel in the exported Excel file.
Data type: Boolean
Repeat
Specifies whether to make the objects in the panel repeated in the detail panel in the
exported Excel file.
Data type: Boolean
Specifies whether to include a horizontal line at the bottom of the panel. This property
applies to panels in table components only. The default is false, which means that no
horizontal line appears at the bottom of the panel.
Data type: Boolean
Suppress
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Specifies whether a panel with no data is included in the report results. The default is
false which means an empty panel is shown.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Underlay
Specifies whether the panel will be layered beneath the next panel in the banded
object. A panel layered beneath a subsequent panel can be used to contain a
background picture or watermark. Banded page header, page footer, or group footer
panels cannot be layered. The default is false which means that the panel is not layered
beneath the next panel.
Data type: Boolean
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
On New Page
If you want each group to start on a new page, you have two approaches. One is to configure with
group header panel as below, the other is to set the Fill Whole Page property for the group footer panel.
There is a problem when you only set On New Page to be true for the group header panel. You will find
that the first page will have no details. JREngine starts the detail panel from the second page. To solve
this issue, use a formula to control this property. The formula will judge the property as being false for
the first group, and being true for subsequent groups for displaying on a new page. You will need to
write three formulas and you will also learn how to control property value with a formula. However, if
you feel this is too complicated, go to the group footer panel for the second approach.
global:
global integer i=0;
groupHD:
i=i+1;0
FormulaControl:
@groupHD;
if (i>1)
return true
else
return false
Insert formula global into the banded page header panel and assign it an initial value 0. Insert formula
groupHD into the group header panel so that for each group i will be calculated as i+1. Then, select the
group header panel and let formula FormulaControl control its On New Page property. This formula will
only return true for the property if i>1.
Cross Page
The default value for Cross Page is false. For one detail panel which spans a large space vertically to be
shown in the first page, then the default false value will make it shown in the second page. So you
should set it to true in order to avoid the empty first page.
Repeat
The default value for Repeat is false. For one detail panel which spans a large space vertically to be
shown in several pages, we support the Repeat property if you want to see the group header
information in each page. When the Repeat property is set true and group headers are visible, the
group headers will duplicate on every page. The Repeat property is a Boolean variable and can be
changed by a formula.
Notes:
When a page split occurs in the bottom blank part of the detail panel (or margins in the detail panel)
and the Cross Page property in the Detail panel is set true, the output will be: repeated group header
+ a slice of blank detail panel + group footer. It appears as though the repeated group headers are
followed only by group footers without any detail panel. In order to solve this problem, you can
resize the detail panel.
If the Repeat property is set true in both outer group header and inner group header, JReport will
treat the two group headers as a completely repeated object.
If the outer and inner group headers are set to be one completely repeated object, then when the
page can only hold the group headers or has no enough space for the group headers, both outer and
inner group headers will not be duplicated.
The Repeat property does not work for subreport.
A group control image can be inserted into the group header panel. See the next section for properties
of a group control image.
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Position
Specifies the position of the object. Choose an option from the drop-down list.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Attribute
Access Key
Alternate Text
Specifies the text that will be displayed if the object cannot be displayed.
Data type: String
Checked
Class
This property is typically used to associate a particular style rule in a style sheet with
the object.
Data type: String
Direction
Disabled
ID
Specifies the identifier of the object, which must be unique in the report set. The ID
property can be a style sheet selector.
Data type: String
Name
Size
Source
Displays the URL to be loaded by the object. This property is read only.
Tab Index
Specifies the index that defines the tab order for the image.
Data type: Integer
Title
Specifies the tip information about the image, which will be displayed when you hover
the mouse pointer over the image after the report is exported to HTML or DHTML.
Data type: String
Value
Event
On Blur
On Change
Specifies the action when the contents of the object or selection have changed.
Data type: String
On Click
Specifies the action when the user clicks the left mouse button on the object.
Data type: String
On Double Click
On Focus
On Key Down
On Key Press
On Key Up
On Mouse Down
Specifies the action when the user clicks the object with either mouse button.
Data type: String
On Mouse Move
Specifies the action when the user moves the mouse over the object.
Data type: String
On Mouse Out
Specifies the action when the user moves the mouse pointer outside the boundaries of
the object.
Data type: String
On Mouse Over
Specifies the action when the user moves the mouse pointer into the object.
Data type: String
On Mouse Up
Specifies the action when the user releases a mouse button while the mouse is over the
object.
Data type: String
Detail panel
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Color
Background
Specifies the background color and fill effect of the object. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000), choose a formula that returns
a color, or select Custom from the drop-down list to specify the color and fill effect if
necessary.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and when
there are styles in the Style Group that can be applied to the object, or type in the
style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Cross Page
Specifies whether the panel can be split across a page break. This property is only
applied if the report has page layout enabled. The default is false which means that the
panel is split only if it exceeds the page height.
Data type: Boolean
The two properties, Current Block Index and Items per Block, work together to control
the data of the object to be displayed in continuous page mode.
Current Block Index specifies the index of the data block that will be displayed. 0 means
the first block index, and 1 the second, and so on.
Data type: Integer
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Specifies whether to make the panel extended to the bottom of the page, so that the
next panel starts on a new page.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
The two properties, Current Block Index and Items per Block, work together to control
the data of the object to be displayed in continuous page mode.
Item per Block specifies the number of records in each data block.
Data type: Integer
Label
Specifies the popup text displayed when the mouse pointer hovers over the left edge of
the panel.
Data type: String
On New Page
Specifies whether the panel starts on a new page. This property is only applied if the
report has page layout enabled. The default is false which means the panel starts on a
new page only if the previous page is filled.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to remove blank rows in the panel in the exported Excel file.
Data type: Boolean
Specifies whether to include a horizontal line at the bottom of the panel. This property
applies to panels in table components only. The default is false, which means that no
horizontal line appears at the bottom of the panel.
Data type: Boolean
Suppress
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Specifies whether a panel with no data is included in the report results. The default is
false which means an empty panel is shown.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned to
its parent data container.
Data type: Boolean
Tile Horizontal
If the Tile Detail Panel property of the detail panel is set to true, you can further specify
the direction for tiling records in the detail panel.
true - Records will be tiled in the row direction and then in column.
false - Records will be tiled in the column direction and then in row.
Specifies whether the panel will be layered beneath the next panel in the banded object.
A panel layered beneath a subsequent panel can be used to contain a background picture
or watermark. Banded page header, page footer, or group footer panels cannot be
layered. The default is false which means that the panel is not layered beneath the next
panel.
Data type: Boolean
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object, which
must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for the
object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of the
object's attribute values and text content.
Data type: String
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Color
Background
Specifies the background color and fill effect of the object. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000), choose a formula that
returns a color, or select Custom from the drop-down list to specify the color and fill
effect.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether the panel can be split across a page break. This property is only
applied if the report has page layout enabled. The default is false which means that the
panel is split only if it exceeds the page height.
Data type: Boolean
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Specifies whether to make the panel extended to the bottom of the page, so that the
next panel starts on a new page.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Label
Specifies the popup text displayed when the mouse pointer hovers over the left edge of
the panel.
Data type: String
Specifies whether to merge the panel into the next panel in the exported Excel file.
Data type: Boolean
On New Page
Specifies whether the panel starts on a new page. This property is only applied if the
report has page layout enabled. The default is false which means the panel starts on a
new page only if the previous page is filled.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to include a horizontal line at the bottom of the panel. This property
applies to panels in table components only. The default is false, which means that no
horizontal line appears at the bottom of the panel.
Data type: Boolean
Suppress
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Specifies whether a panel with no data is included in the report results. The default is
false which means an empty panel is shown.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Underlay
Specifies whether the panel will be layered beneath the next panel in the banded
object. A panel layered beneath a subsequent panel can be used to contain a
background picture or watermark. Banded page header, page footer, or group footer
panels cannot be layered. The default is false which means that the panel is not layered
beneath the next panel.
Data type: Boolean
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. This property is read only.
Color
Background
Specifies the background color and fill effect of the object. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000), choose a formula that
returns a color, or select Custom from the drop-down list to specify the color and fill
effect.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Label
Specifies the popup text displayed when the mouse pointer hovers over the left edge of
the panel.
Data type: String
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to include a horizontal line at the bottom of the panel. This property
applies to panels in table components only. The default is false, which means that no
horizontal line appears at the bottom of the panel.
Data type: Boolean
Suppress
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Specifies whether a panel with no data is included in the report results. The default is
false which means an empty panel is shown.
Data type: Boolean
If true, the footer panel on the last page will not be displayed.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Underlay
Specifies whether the panel will be layered beneath the next panel in the banded
object. A panel layered beneath a subsequent panel can be used to contain a
background picture or watermark. Banded page header, page footer, or group footer
panels cannot be layered. The default is false which means that the panel is not layered
beneath the next panel.
Data type: Boolean
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Color
Background
Specifies the background color and fill effect of the object. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000), choose a formula that
returns a color, or select Custom from the drop-down list to specify the color and fill
effect.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether the panel can be split across a page break. This property is only
applied if the report has page layout enabled. The default is false which means that the
panel is split only if it exceeds the page height.
Data type: Boolean
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Specifies whether to make the panel extended to the bottom of the page, so that the
next panel starts on a new page.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Label
Specifies the popup text displayed when the mouse pointer hovers over the left edge of
the panel.
Data type: String
On New Page
Specifies whether the panel starts on a new page. This property is only applied if the
report has page layout enabled. The default is false which means the panel starts on a
new page only if the previous page is filled.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to include a horizontal line at the bottom of the panel. This property
applies to panels in table components only. The default is false, which means that no
horizontal line appears at the bottom of the panel.
Data type: Boolean
Suppress
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Specifies whether a panel with no data is included in the report results. The default is
false which means an empty panel is shown.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
To Bottom
Specifies whether to move the banded object footer panel to the bottom of the page.
The default is false, which means that the banded object footer appears at the end of
the banded object.
Data type: Boolean
Underlay
Specifies whether the panel will be layered beneath the next panel in the banded
object. A panel layered beneath a subsequent panel can be used to contain a
background picture or watermark. Banded page header, page footer, or group footer
panels cannot be layered. The default is false which means that the panel is not layered
beneath the next panel.
Data type: Boolean
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies the column width values, measured in inches. Type the width values delimited
by comma. If you want to use the Width property of a column, leave its place blank.
Data type: String
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Pattern
Position
Specifies the position of the object. Choose an option from the drop-down list.
static - The object is positioned at the location in which it is inserted. The X and Y
properties are ignored. The position of the object is affected by preceding objects in
the same container.
relative - The object is positioned at an offset to the position at which it is inserted.
The offset is determined by the X and Y property values.
absolute - The object will be located at the position specified by dragging and
dropping or by setting its X and Y property values. The position of the object is not
affected by preceding objects in the same container.
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies the columns to be shown in the report result. Type the column mapping
names delimited by comma. For example: Shipping Cost, Ship Date, Ship Via, Payment
Received.
Data type: String
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Show Border
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Accessibility
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Banded column
The properties of a banded column are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Position
Specifies the position of the object. Choose an option from the drop-down list.
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Border
Show Border
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information about
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Chart
A chart mainly consists of three parts: the platform, paper, and legend. The chart platform is a
container for other chart elements, and the chart paper holds walls, axes, data markers, axis values,
and category names.
The following topics are detailed introduction to properties of the elements:
Chart platform
Chart paper
Chart legend
Chart label
Chart platform
A chart platform is a container for other chart elements. You can use the properties listed in the
following table to control the appearances or behavior of a chart platform. In the Report Inspector, a
chart platform is displayed as ChartObject by default.
The properties of a chart platform are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies the alternate text of the image, which will be shown when the image cannot
be displayed. This property applies only when the chart is exported to HTML as an
image chart. Enter a string to serve as the alternative text.
Data type: String
Cache
Specifies whether to cache the dataset for this object in the data buffer so other objects
which use the same dataset can share the data rather than perform their own SQL
query.
Data type: Boolean
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Logic Column
Specifies whether to show the object in the next visible table cell in the same row when
the column which holds the object is hidden. Choose an option from the drop-down list.
Data type: Enumeration
Notes:
Position
The next visible table cell should be completely empty, that is, the cell should not
hold any content including blank space.
When the property for several objects in the same row is set to next visible column,
and the columns holding these objects are all hidden, then only the object in the
rightmost column will be shown in the next visible cell.
Specifies the position of the object. Choose an option from the drop-down list.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Excel
Column Index
Specifies the X coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Column Number
Specifies the number of columns which will be the object's width in the exported Excel
or CSV file. The Columned property at the report level must be set to true for this
property to take effect.
Data type: String
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Row Number
Specifies the number of rows which will be the object's height in the exported Excel or
CSV file. The Columned property at the report level must be set to true for this property
to take effect.
Data type: String
TOC
Anchor Display Value
Specifies the text for the TOC entry for this object in the TOC browser. By default the
text is the unique object name assigned by JReport Designer. The TOC Anchor property
must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
Platform
Anti-aliasing
Pattern List
squares in the color tray one by one to specify the patterns for the data markers. The
patterns can be one or more of the following: Automatic, Color, Texture, and Gradient.
Data type: String
Show Legend
Background
Border Color
Specifies the color of the platform borders. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Specifies the ending style of the platform border line. Choose an option from the dropdown list.
Data type: Enumeration
Border Joint
Specifies the joint style of the platform border line. Choose an option from the dropdown list.
Data type: Enumeration
Border Outlined
Specifies whether to show the platform border line in Outline Path. If the property is set
to true, the platform border line will be shown in Outline Path; otherwise, in Fill Path.
Data type: Boolean
Border Style
Specifies the line style of the platform borders. Choose an option from the drop-down
list.
Data type: Enumeration
Border Thickness
Specifies the width of the border in inches or centimeters. Enter a numeric value to
change the thickness.
Data type: Float
Border Transparency
Specifies the transparency of the platform borders, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Border Type
Specifies the border type of the platform. Choose an option from the drop-down list.
Data type: Enumeration
true - The dash size will be adjusted automatically. And the option Auto Adjust
Dash in the Format Platform dialog will take effect.
false - The dash size will be of fixed size. And the option Fixed Dash Size in the
Format Platform dialog will take effect.
Specifies the color of the platform, applying if the property Fill Type is set to color.
Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000)
or choose a formula that returns a color.
Data type: String
Fill Transparency
Fill Type
Specifies the fill pattern for the chart platforms. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the color of the point where the gradient ends. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Gradient End X
Specifies the horizontal position where the gradient ends, measured in a percentage of
the platform width.
Data type: Integer
Gradient End Y
Specifies the vertical position where the gradient ends, measured in a percentage of the
platform height.
Data type: Integer
Specifies the color of the point where the gradient begins. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Gradient Start X
Specifies the horizontal position where the gradient begins, measured in a percentage
of the platform width.
Data type: Integer
Gradient Start Y
Specifies the vertical position where the gradient begins, measured in a percentage of
the platform height.
Data type: Integer
Gradient Style
Specifies the gradient style for the platform, applying if the property Fill Type is set to
gradient. Choose an option from the drop-down list.
Data type: Enumeration
Image File
Specifies the file name of the image, a portion of which will be displayed as the platform
background, applying if Fill Type is set to image.
Data type: String
Image Height
The four properties, Image X, Image Y, Image Width, and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Height specifies the height of the image portion, measured in a percentage of
the image height.
Data type: Integer
Image Layout
Specifies the layout style for the image. Choose an option from the drop-down list.
Data type: Enumeration
Image Width
The four properties, Image X, Image Y, Image Width, and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Width specifies the width of the image portion, measured in a percentage of the
image width.
Data type: Integer
Image X
The four properties, Image X, Image Y, Image Width, and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image X specifies the distance between the left border of image and the portion that
will contain the pattern, measured in a percentage of the image width.
Data type:
Image Y
The four properties, Image X, Image Y, Image Width, and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Y specifies the distance between the top border of image and the portion that
will contain the pattern, measured in a percentage of the image height.
Data type: Integer
Inset Bottom
Specifies the bottom position of the background area, measured in a percentage of the
chart height, from the bottom edge of the chart.
Data type: Float
Inset Left
Specifies the left position of the background area, measured in a percentage of the
chart width, from the left edge of the chart.
Data type: Float
Inset Right
Specifies the right position of the background area, measured in a percentage of the
chart width, from the right edge of the chart.
Data type: Float
Inset Top
Specifies the top position of the background area, measured in a percentage of the
chart height, from the top edge of the chart.
Data type: Float
Radius
Specifies the radius for the joint of the platform border line. The property takes effect
only when Border Joint is set to joint round. Enter a numeric value to change the
radius.
Data type: Float
Texture Background Color Specifies the background color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Texture Foreground Color Specifies the foreground color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Texture Style
Specifies the texture style of the background, applying if the property Fill Type is set to
texture. Choose an option from the drop-down list.
Data type: Enumeration
Data
The four properties work together to control the range of the data being displayed on a
chart: Category Start Offset, Category End Offset, Series Start Offset, and Series End
Offset.
Category End Offset specifies the ending offset of the categories. It does not apply to
the charts which involve only one group.
Data type: Integer
Category Format
Specifies the data format for the category axis (the X axis) to display the tick mark
in the value cell to specify the format.
labels in the way you choose. Click
Data type: String
The four properties work together to control the range of the data being displayed on a
chart: Category Start Offset, Category End Offset, Series Start Offset, and Series End
Offset.
Category Start Offset specifies the starting offset of the categories. It does not apply to
the charts which involve only one group.
Data type: Integer
Specifies the encoding format for values on the category axis. Choose an option from
the drop-down list.
Data type: String
Specifies the format for each hint percentage to the total. Click
the format.
Data type: String
Hyperlink
Specifies whether to add a hyperlink that refers to another report or a website to the
chart.
Data type: String
Hyperlink Target
Specifies the target window or frame in which to display the content the Hyperlink
property specifies. Choose an option from the drop-down list or directly input the name
of the frame you have defined.
<Server Setting>
Loads the linked file according to setting of the Pop Up New Window for Links option
in the Configure DHTML Profile panel of the Profile dialog in JReport Server.
New Window
Loads the linked file into a new window. The window is not named.
Whole Window
Loads the linked file into the full browser window.
Same Frame
Loads the linked file into the same frame as the link.
Parent Frame
Loads the linked file into the parent frame of the frame that contains the link.
Other Frame
Loads the linked file into some other specified frame. If the frame name does not
exist, the linked file will be loaded into a new window.
Specifies whether to show the detailed information when you click the object in JReport
Viewer. This property is available only when the object is in the group header/footer
panel of a banded object. For details about its usage, refer to Obtaining detailed
information from a banded object.
Data type: Boolean
Specifies the data format for the primary value axis (the Y1 axis) to display the tick
in the value cell to specify the format.
mark labels in the way you choose. Click
Data type: String
Reverse Category
Reverse Series
Specifies the data format for the secondary value axis (the Y2 axis) to display the tick
in the value cell to specify the format.
mark labels in the way you choose. Click
Data type: String
The four properties work together to control the range of the data being displayed on a
chart: Category Start Offset, Category End Offset, Series Start Offset, and Series End
Offset.
Series End Offset specifies the ending offset of the series.
Data type: Integer
Series Format
Specifies the data format for the series axis (the Z axis) to display the tick mark labels
in the value cell to specify the format.
in the way you choose. Click
Data type: String
The four properties work together to control the range of the data being displayed on a
chart: Category Start Offset, Category End Offset, Series Start Offset, and Series End
Offset.
Series Start Offset specifies the starting offset of the series.
Data type: Integer
Specifies the encoding format for values on the series axis. Choose an option from the
drop-down list.
Data type: String
Sort Category
Specifies the sorting order for the category field values. Choose an option from the dropdown list.
Data type: Enumeration
Sort Series
Specifies the sorting order for the series field values. Choose an option from the dropdown list.
Data type: Enumeration
Swap Groups
Specifies to display values from different data fields by switching data between the
category and series axes, the category and value axes of a chart. By default, this
property is set to false, which means no switch will take place in the chart.
Specifies whether to add a hyperlink that refers to another report or a website to the X
axis labels.
Data type: String
X Hyperlink Target
Specifies the target window or frame in which to display the content the X Hyperlink
property specifies. Choose an option from the drop-down list or directly input the name
of the frame you have defined.
<Server Setting>
Loads the linked file according to setting of the Pop Up New Window for Links option
in the Configure DHTML Profile panel of the Profile dialog in JReport Server.
New Window
Loads the linked file into a new window. The window is not named.
Whole Window
Loads the linked file into the full browser window.
Same Frame
Loads the linked file into the same frame as the link.
Parent Frame
Loads the linked file into the parent frame of the frame that contains the link.
Other Frame
Loads the linked file into some other specified frame. If the frame name does not
exist, the linked file will be loaded into a new window.
Specifies whether to add a hyperlink that refers to another report or a website to the Z
axis labels.
Data type: String
Z Hyperlink Target
Specifies the target window or frame in which to display the content the Z Hyperlink
property specifies. Choose an option from the drop-down list or directly input the name
of the frame. If the frame name does not exist, the linked document will be loaded into
a new window.
<Server Setting>
Loads the linked file according to setting of the Pop Up New Window for Links option
in the Configure DHTML Profile panel of the Profile dialog in JReport Server.
New Window
Loads the linked file into a new window. The window is not named.
Whole Window
Loads the linked file into the full browser window.
Same Frame
Loads the linked file into the same frame as the link.
Parent Frame
Loads the linked file into the parent frame of the frame that contains the link.
Other Frame
Loads the linked file into some other specified frame. If the frame name does not
exist, the linked file will be loaded into a new window.
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
A representation of the standard HTML attribute id. This attribute specifies a name to
the object, which must be unique in the report.
Data type: String
External Title
A representation of the standard HTML attribute title. This attribute offers advisory
information about the object.
Data type: String
LongDesc
A representation of the standard HTML attribute longdesc. This attribute specifies a link
to a long description of the object.
Data type: String
Chart paper
The properties of a chart paper are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. Enter a numeric value to change the position in inches or
centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its
parent container. Enter a numeric value to change the position in inches or
centimeters.
Data type: Float
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
External CSS Class Selector Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down
list which is available when a Style Group has been selected at the report level
and when there are styles in the Style Group that can be applied to the object, or
type in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies the rotation angle of the chart around the X axis, in degrees, applying to 3D charts. Enter a numeric value to change the rotation.
Data type: Float
Angle Y
Specifies the rotation angle of the chart around the Y axis, in degrees, applying to 3D charts. Enter a numeric value to change the rotation.
Data type: Float
Angle Z
Specifies the rotation angle of the chart around the Z axis, in degrees, applying to 3D charts. Enter a numeric value to change the rotation.
Data type: Float
Graph Position
Specifies the position of the paper contents relative to the paper background,
applying to 2-D charts. Choose an option from the drop-down list.
Data type: Enumeration
Interactive
Specifies whether the chart will be interactive in view mode and JReport Viewer/
JReport Studio. When it is set to true, all interactive actions are enabled.
Data type: Boolean
Perspective
Specifies how to display the chart in perspective view. By default no perspective chart
will be displayed. Only for 3-D charts.
Data type: Integer
Scale X
Specifies the percentage for elongating or shortening the X axis. Enter a numeric
value to change the percentage.
Data type: Float
Scale Y
Specifies the percentage for elongating or shortening the Y axis. Enter a numeric
value to change the percentage.
Data type: Float
Scale Z
Specifies the percentage for elongating or shortening the Z axis, applying to 3-D
charts. Enter a numeric value to change the percentage.
Data type: Float
Shadow Contents
Background
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down
list, enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a
color.
Data type: String
Specifies the ending style of the paper border line. Choose an option from the dropdown list.
Data type: Enumeration
Border Joint
Specifies the joint style of the paper border line. Choose an option from the dropdown list.
Data type: Enumeration
Border Outlined
Specifies whether to show the paper border line in Outline Path. If the property is set
to true, the paper border line will be shown in Outline Path; otherwise, in Fill Path.
Data type: Boolean
Border Style
Specifies the line style of the paper borders. Choose an option from the drop-down
list.
Data type: Enumeration
Border Thickness
Specifies the width of the border in inches or centimeters. Enter a numeric value to
change the thickness.
Data type: Float
Border Transparency
Specifies the transparency of the icon borders, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Border Type
Specifies the border type of the paper. Choose an option from the drop-down list.
Data type: Enumeration
true - The dash size will be adjusted automatically. And the option Auto Adjust
Dash in the Format Paper dialog will take effect.
false - The dash size will be of fixed size. And the option Fixed Dash Size in the
Format Paper dialog will take effect.
Specifies the color of the paper background, applying if the property Fill Type is set to
color. Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g.
0xff0000) or choose a formula that returns a color.
Data type: String
Fill Transparency
Fill Type
Specifies the fill pattern for the paper background. Choose an option from the dropdown list.
Data type: Enumeration
Specifies the color of the point where the gradient ends. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Gradient End X
Specifies the horizontal position where the gradient ends, measured in a percentage
of the paper width.
Data type: Integer
Gradient End Y
Specifies the vertical position where the gradient ends, measured in a percentage of
the paper height.
Data type: Integer
Specifies the color of the point where the gradient begins. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Gradient Start X
Specifies the horizontal position where the gradient begins, measured in a percentage
of the paper width.
Data type: Integer
Gradient Start Y
Specifies the vertical position where the gradient begins, measured in a percentage of
the paper height.
Data type: Integer
Gradient Style
Specifies the gradient style for the paper background, applying if the property Fill
Type is set to gradient. Choose an option from the drop-down list.
Data type: Enumeration
Image File
Specifies the file name of the image, a portion of which will be displayed as the paper
background, applying if the property Fill Type is set to image.
Data type: String
Image Height
The four properties, Image X, Image Y, Image Width, and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Height specifies the height of the image portion, measured in a percentage of
the image height.
Data type: Integer
Image Layout
Specifies the layout style for the image. Choose an option from the drop-down list.
Data type: Enumeration
Image Width
The four properties, Image X, Image Y, Image Width, and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Width specifies the width of the image portion, measured in a percentage of
the image width.
Data type: Integer
Image X
The four properties, Image X, Image Y, Image Width, and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image X specifies the distance between the left border of image and the portion that
will contain the pattern, measured in a percentage of the image width.
Data type: Integer
Image Y
The four properties, Image X, Image Y, Image Width, and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Y specifies the distance between the top border of image and the portion that
will contain the pattern, measured in a percentage of the image height.
Data type: Integer
Inset Bottom
Inset Left
Specifies the left position of the background area, measured in a percentage of the
paper width, from the left edge of the paper.
Data type: Float
Inset Right
Specifies the right position of the background area, measured in a percentage of the
paper width, from the right edge of the paper.
Data type: Float
Inset Top
Specifies the top position of the background area, measured in a percentage of the
paper height, from the top edge of the paper.
Data type: Float
Specifies the background color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Specifies the foreground color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Texture Style
Specifies the texture style of the background, applying if the property Fill Type is set
to texture. Choose an option from the drop-down list.
Data type: Enumeration
Graph
Specifies whether to display the data label in the chart when its slice value is 0. This
property is available to these 2D chart types: bar, bench, line, area, pie and radar.
If the property is set to true, the data label whose slice value is 0 will not be
displayed. The default value is false.
Data type: Boolean
Specifies the distance between each bar/bench in a category, only applying to 2-D
clustered bar/bench charts. Enter a numeric value to change the gap.
Data type: Integer
Bar Style
Specifies the style of the bars/benches. Choose an option from the drop-down list. It
can be normal or cylinder, however, if you specify the style to be cylinder, it will take
effect only when the property Use Depth is set to true.
Data type: Enumeration
Bar Width
Depth
Specifies the depth of the bars/benches, applying if the value of the property Use
Depth is set to true. Only for 2-D bar/bench charts. Enter a numeric value to change
the depth.
Data type: Float
Direction
Specifies the angle of the axis along the depth of the bars/benches. Only for 2-D bar/
bench charts. Enter a numeric value to change the direction.
Data type: Integer
Use Depth
Specifies in which way the value labels will be displayed around the bars/benches.
Choose an option from the drop-down list.
value and percent - Shows the value and the percentage for the bar/bench
section.
Specifies whether to vary the bar colors with category values. Available for clustered
bar/bench charts which do not hold Z axis.
Data type: Boolean
Specifies patterns for the areas which are formed by the chart axes and the lines.
Applies to 2-D lines only.
in the value cell and click the small squares in the color tray one by one to
Click
specify the patterns for the areas. The patterns can be one or more of the following:
Automatic, Color, Texture, and Gradient.
Data type: String
Depth
Specifies the depth of the lines, applying if the value of the property Use Depth is set
to true. Only for 2-D line charts. Enter a numeric value to change the depth.
Data type: Float
Direction
Specifies the angle of the axis along the depth of the lines. Only for 2-D line charts.
Enter a numeric value to change the direction.
Data type: Integer
Line Thickness
Specifies the thickness of the line. Enter a numeric value to change the thickness.
Data type: Float
Specifies the border color of the line nodes. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Specifies the border style of the line nodes. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the width for border of the line nodes in inches or centimeters. Enter a
numeric value to change the thickness.
Data type: Float
Node Border
Transparency
Specifies the transparency for border of the line nodes, in percent. Enter a numeric
value to change the transparency.
Data type: Integer
Node Color
Specifies the color of the line nodes. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Node
Transparency
Specifies the transparency of the line nodes, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Node Height
Specifies the height of the value nodes. Enter a numeric value to change the height.
Data type: Float
Node Style
Specifies the line node style for the data series lines. Only for 2-D charts that contain
lines. Choose an option from the drop-down list.
Data type: Enumeration
Node Width
Specifies the width of the value nodes. Enter a numeric value to change the width.
Data type: Float
Use Depth
Specifies whether to make the lines visually three-dimensional, only applying to 2-D
line charts.
Data type: Boolean
Note: If the chart is a combo chart composed by lines and areas/bars, when you set
the depth properties for the lines, they will be applied to the areas/bars as well, and
vice versa.
Specifies in which way the value labels will be displayed around the lines. Choose an
option from the drop-down list.
value and percent - Shows the value and the percentage for the line section.
Specifies the depth of the areas, applying if the value of the property Use Depth is set
to true. Only for 2-D area charts. Enter a numeric value to change the depth.
Data type: Float
Direction
Specifies the angle of the axis along the depth of the areas. Only for 2-D area charts.
Enter a numeric value to change the direction.
Data type: Integer
Use Depth
Specifies whether to make the areas visually three-dimensional, only applying to 2-D
area charts.
Data type: Boolean
Note: If the chart is a combo chart composed by areas and bars/lines, when you set
the depth properties for the areas, they will be applied to the bars/lines as well, and
vice versa.
Use Dropline
Specifies whether to show the lines that represent the data categories. Only for 2-D
area charts.
Data type: Boolean
Specifies in which way the value labels will be displayed around the areas. Choose an
option from the drop-down list.
value and percent - Shows the value and the percentage for the area section.
Specifies the angle between the X axis and the first pie section which is listed first in
the legend.
Data type: Integer
Angle Y
Specifies the angle between the Y axis and each pie plane.
Data type: Integer
Donut Hole
Specifies the radius percentage of the donut hole to the total pie circle. This property
takes effect only for donut chart.
Data type: Float
Pie Gap
Specifies the distance between every two adjacent pies. Enter a numeric value to
change the gap.
Data type: Float
Specifies the distance between each pie section and the pie center. Enter a numeric
value to change the gap.
Data type: Float
Specifies in which way the value labels will be displayed around the pie. Choose an
option from the drop-down list.
category name - Shows the category name for the pie section.
value and percent - Shows the value and the percentage for the pie section.
Specifies whether to fill the areas formed by value nodes of the same data series in a
radar chart.
Data type: Boolean
Line Thickness
Specifies the thickness of the line. Enter a numeric value to change the thickness.
Data type: Float
Node Height
Specifies the height of the value nodes. Enter a numeric value to change the height.
Data type: Float
Node Style
Specifies the line node style for the data series lines. Only for 2-D charts that contain
lines. Choose an option from the drop-down list.
Data type: Enumeration
Node Width
Specifies the width of the value nodes. Enter a numeric value to change the width.
Data type: Float
Specifies the arrow style for the axes. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the transparency for the background in the radar chart, in percent. Enter a
numeric value to change the transparency.
Data type: Integer
Specifies in which way the value labels will be displayed around the value nodes.
Choose an option from the drop-down list.
value and percent - Shows the value and the percentage for the value node.
Specifies the color for the alert range. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the maximum value for the alert range. Enter a numeric value to specify the
value.
Data type: Float
Specifies the minimum value for the alert range. Enter a numeric value to specify the
value.
Data type: Float
Arrow Style
Specifies the style for pointer arrows, applying if the property Pointer Style is set to
Arrow. Only for dial gauge charts. Choose an option from the drop-down list.
Data type: Enumeration
Curve Style
Specifies the style for the curve. Only for dial gauge charts. Choose an option from
the drop-down list.
Data type: Enumeration
Error Color
Specifies the color for the error range. Choose a color from the drop-down list, enter
a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the maximum value for the error range. Enter a numeric value to specify
the value.
Data type: Float
Specifies the minimum value for the error range. Enter a numeric value to specify the
value.
Data type: Float
Fill Curve
Specifies whether to fill the dial with colors. Only for dial gauge charts.
Data type: Boolean
Specifies the color of the point where the gradient ends for the alert range. Choose a
color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or
choose a formula that returns a color.
Data type: String
Specifies the horizontal position where the gradient ends, measured in a percentage
of the alert range width.
Data type: Integer
Specifies the vertical position where the gradient ends, measured in a percentage of
the alert range height.
Data type: Integer
Specifies the color of the point where the gradient begins for the alert range. Choose
a color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or
choose a formula that returns a color.
Data type: String
Specifies the horizontal position where the gradient begins, measured in a percentage
of the alert range width.
Data type: Integer
Gauge Alert Gradient Start Y Specifies the vertical position where the gradient begins, measured in a percentage of
the alert range height.
Data type: Integer
Gauge Alert Gradient Style
Specifies the gradient style for the alert range, applied when Gauge Alert Type is set
to gradient. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the transparency of the alert range background, in percent. Enter a numeric
value to change the transparency.
Data type: Integer
Specifies the fill pattern for the alert range. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the color of the border of the object. Choose a color from the drop-down
list, enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a
color.
Data type: String
Gauge Bar Border End Caps Specifies the ending style of the scale border line, applying to bar gauge charts.
Choose an option from the drop-down list.
Data type: Enumeration
Gauge Bar Border Joint
Specifies the joint style of the scale border line, applying to bar gauge charts. Choose
an option from the drop-down list.
Data type: Enumeration
Specifies whether to show the scale border line in Outline Path, applying to bar gauge
charts. If the property is set to true, the border line will be shown in Outline Path;
otherwise, in Fill Path.
Data type: Boolean
Specifies the line style of the scale borders, applying to bar gauge charts. Choose an
option from the drop-down list.
Data type: Enumeration
Gauge Bar Border Thickness Specifies the width of the border in inches or centimeters. Enter a numeric value to
change the thickness.
Data type: Float
Gauge Bar Border
Transparency
Specifies the transparency of the borders, in percent, applying to bar gauge charts.
Enter a numeric value to change the transparency.
Data type: Integer
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Specifies the layout for the scales. Only for bar gauge charts. Choose an option from
the drop-down list.
Data type: Enumeration
Specifies the color of the point where the gradient ends for the error range. Choose a
color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or
choose a formula that returns a color.
Data type: String
Gauge Error Gradient End X Specifies the horizontal position where the gradient ends, measured in a percentage
of the error range width.
Data type: Integer
Gauge Error Gradient End Y Specifies the vertical position where the gradient ends, measured in a percentage of
the error range height.
Data type: Integer
Gauge Error Gradient Start
Color
Specifies the color of the point where the gradient begins for the error range. Choose
a color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or
choose a formula that returns a color.
Data type: String
Specifies the horizontal position where the gradient begins, measured in a percentage
of the error range width.
Data type: Integer
Specifies the vertical position where the gradient begins, measured in a percentage of
the error range height.
Data type: Integer
Specifies the gradient style for the error range, applied when Gauge Error Type is set
to gradient. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the transparency of the error range background, in percent. Enter a numeric
value to change the transparency.
Data type: Integer
Specifies the fill pattern for the error range. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the color of the point where the gradient ends for the normal range. Choose
a color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or
choose a formula that returns a color.
Data type: String
Specifies the horizontal position where the gradient ends, measured in a percentage
of the normal range width.
Data type: Integer
Specifies the vertical position where the gradient ends, measured in a percentage of
the normal range height.
Data type: Integer
Specifies the color of the point where the gradient begins for the normal range.
Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g.
0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the horizontal position where the gradient begins, measured in a percentage
of the normal range width.
Data type: Integer
Specifies the vertical position where the gradient begins, measured in a percentage of
the normal range height.
Data type: Integer
Specifies the gradient style for the normal range, applied when Gauge Normal Type is
set to gradient. Choose an option from the drop-down list.
Data type: Enumeration
Gauge Normal Transparency Specifies the transparency of the normal range background, in percent. Enter a
numeric value to change the transparency.
Data type: Integer
Gauge Normal Type
Specifies the fill pattern for the normal range. Choose an option from the drop-down
list.
Data type: Enumeration
Horizontal Margin
Specifies the left margin. Only for bubble gauge charts. Enter a numeric value to
change the margin.
Data type: Float
Normal Color
Specifies the color for the normal range. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Specifies the maximum value for the normal range. Enter a numeric value to specify
the value.
Data type: Float
Specifies the minimum value for the normal range. Enter a numeric value to specify
the value.
Data type: Float
Pointer Style
Specifies the style for the pointer. Only for dial gauge charts. Choose an option from
the drop-down list.
Data type: Enumeration
Range Radius
Specifies the relative size of a dial or ball. Only for dial or bubble gauge chart. Enter a
numeric value to change the size.
Data type: Integer
Start Angle
Specifies the angle of the dial beginning point. Only for dial gauge charts. Enter a
numeric value to change the angle.
Data type: Integer
Stop Angle
Specifies the angle of the dial endpoint. Only for dial gauge charts. Enter a numeric
value to change the angle.
Data type: Integer
Specifies the width of the dial. Only for dial gauge charts. Enter a numeric value to
change the gap.
Data type: Float
Vertical Margin
Specifies the top margin. Only for bubble gauge charts. Enter a numeric value to
change the margin.
Data type: Float
Specifies the thickness of the line, applying to the scatter chart which contains lines.
Enter a numeric value to change the thickness.
Data type: Float
Node Height
Specifies the height of the value nodes. Enter a numeric value to change the height.
Data type: Float
Node Style
Specifies the line node style for the data series lines. Only for 2-D charts that contain
lines. Choose an option from the drop-down list.
Data type: Enumeration
Node Width
Specifies the width of the value nodes. Enter a numeric value to change the width.
Data type: Float
Specifies the width of the stock bars, applying to Open-High-Low-Close stock charts.
Enter a numeric value to change the width.
Data type: Integer
Line Thickness
Specifies the thickness of the line. Enter a numeric value to change the thickness.
Data type: Float
Specifies the color to indicate that the opening price is higher than the closing price,
applying to Open-High-Low-Close stock charts. Choose a color from the drop-down
list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns
a color.
Data type: String
Specifies the color of the stock line. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the color to indicate that the opening price is lower than the closing price,
applying to Open-High-Low-Close stock charts. Choose a color from the drop-down
list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns
a color.
Data type: String
Specifies the fill effect of the comparative measures in the same data series. Click
in the value cell to specify the effect.
Data type: String
Comparative Measure Width Specifies the width of the comparative measures. Enter a numeric value to change
the width.
Data type: Integer
Featured Measure Width
Specifies the width of the featured measures. Enter a numeric value to change the
width.
Data type: Integer
Graph Direction
Specifies the direction to draw the bullet chart, horizontally or vertically. Choose an
option from the drop-down list.
Data type: Enumeration
Specifies the fill effect of the qualitative ranges in the same data series. Click
in
Specifies the width of the qualitative ranges. Enter a numeric value to change the
width.
Data type: Integer
Specifies the graph type for the featured measures when the value (Y) axis does not
start from the value zero. Choose an option from the drop-down list.
Data type: Enumeration
Contour
Contour
Line Color
Specifies the line color for the contour, not applying to 2-D line charts. Choose a color
from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a
formula that returns a color.
Data type: String
Specifies the ending style for the contour, not applying to 2-D line charts. Choose an
option from the drop-down list.
Data type: Enumeration
Line Joint
Specifies the line joint style for the contour, not applying to 2-D line charts. Choose
an option from the drop-down list.
Data type: Enumeration
Line Outlined
Specifies whether to show the contour in outline form, not applying to 2-D line charts.
If the property is set to true, the contour will be shown in outline form; otherwise, in
whole form.
Data type: Boolean
Line Style
Specifies the line style for the contour, not applying to 2-D line charts. Choose an
option from the drop-down list.
Data type: Enumeration
Line Thickness
Specifies the thickness for the contour, not applying to 2-D line charts. Enter a
numeric value to change the thickness.
Data type: Float
Line Transparency
Specifies the line transparency for the contour, in percent, not applying to 2-D line
charts. Enter a numeric value to change the transparency.
Data type: Integer
Specifies whether to resize the dash automatically, not applying to 2-D line charts. If
the property is set to true, the dash size will be adjusted automatically; otherwise,
the dash size will be of fixed size.
Data type: Boolean
Hint
Color
Specifies the color of the hint text, applying if the property Fill Type is set to color.
Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g.
0xff0000) or choose a formula that returns a color.
Data type: String
Fill Transparency
Fill Type
Specifies the fill pattern for the hint text. Choose an option from the drop-down list.
Data type: Enumeration
Font Effect
Specifies the special effect for the hint. Choose an option from the drop-down list.
Data type: Integer
Font Face
Specifies the font face for the hint. Choose an option from the drop-down list.
Data type: Enumeration
Font Rotation
Specifies the rotation angle of the hint around its center, in degrees. The default
value is 0. Enter a numeric value to change the rotation.
Data type: Float
Font Script
Specifies whether the hint will be in superscript or subscript form, or neither of them.
Choose an option from the drop-down list.
Data type: Enumeration
Font Shearing
Specifies the shearing transformation of the hint around its center. The default value
is 0. Enter a numeric value to change the shearing.
Data type: Float
Font Size
Specifies the font size for the hint. Enter an integer value to change the size.
Data type: Integer
Font Strikethrough
Specifies the style for the line by which the hint text is struck through. Choose an
option from the drop-down list.
Data type: Enumeration
Font Style
Specifies the font style for the hint. Choose an option from the drop-down list.
Data type: Enumeration
Font Underline
Specifies the underline style for the hint. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the color of the point where the gradient ends. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Gradient End X
Specifies the horizontal position where the gradient ends, measured in a percentage
of the hint width.
Data type: Integer
Gradient End Y
Specifies the vertical position where the gradient ends, measured in a percentage of
the hint height.
Data type: Integer
Specifies the color of the point where the gradient begins. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Gradient Start X
Specifies the horizontal position where the gradient begins, measured in a percentage
of the hint width.
Data type: Integer
Gradient Start Y
Specifies the vertical position where the gradient begins, measured in a percentage of
the hint height.
Data type: Integer
Gradient Style
Specifies the gradient style for the hint text, applying if the property Fill Type is set to
gradient. Choose an option from the drop-down list.
Data type: Enumeration
Outline Color
Specifies the color for the hint text outline. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Specifies the ending style for the hint text outline. Choose an option from the dropdown list.
Data type: Enumeration
Outline Joint
Specifies the joint style for the hint text outline. Choose an option from the dropdown list.
Data type: Enumeration
Outline Outlined
Specifies whether to show the hint text outline in outline form. If the property is set
to true, the outline will be shown in outline form; otherwise, in whole form.
Data type: Boolean
Outline Style
Specifies the style for the hint text outline. Choose an option from the drop-down list.
Data type: Enumeration
Outline Thickness
Specifies the thickness of the hint text outline. Enter a numeric value to change the
thickness.
Data type: Float
Outline Transparency
Specifies the transparency for the hint text outline, in percent. Enter a numeric value
to change the transparency.
Data type: Integer
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Show Tips
Specifies whether to show the corresponding data information when the mouse
pointer points at a target in the chart area in view mode, in HTML/DHTML result, or in
JReport Studio.
Data type: Boolean
Note: If this property is set to false, the other hint properties are ignored.
Specifies whether to show data on the category and value axes when the mouse
pointer points at a target in the chart area in view mode, in HTML/DHTML result, or in
JReport Studio. The property takes effect only when the property Show Tips is set to
true.
Data type: Boolean
Specifies the background color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Specifies the foreground color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Texture Style
Specifies the texture style for the hint text, applying if the property Fill Type is set to
texture. Choose an option from the drop-down list.
Data type: Enumeration
Axis Color
Specifies the color for the axis. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the ending style for the axis. Choose an option from the drop-down list.
Data type: Enumeration
Axis Joint
Specifies the joint style for the axis. Choose an option from the drop-down list.
Data type: Enumeration
Axis Outlined
Specifies whether to show the axis in outline form. If the property is set to true, the
axis will be shown in outline form; otherwise, in whole form.
Data type: Boolean
Axis Placement
Specifies the position of X axis across the Y axis. Choose an option from the dropdown list.
bottom - The X axis will cross the Y axis at its minimum value point.
Specifies the style for the axis. Choose an option from the drop-down list.
Data type: Enumeration
Axis Thickness
Specifies the thickness for the axis. Enter a numeric value to change the thickness.
Data type: Float
Axis Transparency
Specifies the transparency for the axis, in percent. Enter a numeric value to change
the transparency.
Data type: Integer
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Gridline Color
Specifies the color for the gridlines. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the ending style for the gridlines. Choose an option from the drop-down list.
Data type: Enumeration
Gridline Joint
Specifies the joint style for the gridlines. Choose an option from the drop-down list.
Data type: Enumeration
Gridline Outlined
Specifies whether to show the gridlines in outline form. If the property is set to true,
the gridlines will be shown in outline form; otherwise, in whole form.
Data type: Boolean
Gridline Style
Specifies the style for the gridlines. Choose an option from the drop-down list.
Data type: Integer
Gridline Thickness
Specifies the thickness for the gridlines. Enter a numeric value to change the
thickness.
Data type: Float
Gridline Transparency
Specifies the transparency for the gridlines, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Increment
Specifies the increased amount between two adjacent values on the X axis. The
default is to let the increased amount be determined by JReport Designer. Only for
scatter charts and bubble charts.
Data type: Integer
Specifies the distance between the labels and the axis. Enter a numeric value to
change the gap.
Data type: Float
Label Color
Specifies the color for the label text. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the frequency at which the tick marks will be labeled. Type 1 to label every
tick mark, type 2 to label every two tick marks, type 3 to label every three tick
marks, and so on.
Data type: Integer
Specifies the transparency for the label text, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Specifies the fill pattern for the label text. Choose an option from the drop-down list.
Data type: Enumeration
Specifies whether to adjust the rotation angle of the label text on the axis
automatically.
true - The rotation angle of the label text will be adjusted automatically
according to the length of the text, in degrees. If the text can be completely
displayed horizontally, the default rotation angle will be 0; if the text can not be
completely displayed horizontally, the default rotation angle will be 30
anticlockwise, and the cut off part will be shown as suspension points.
false - If selected, the rotation angle of the label text will be determined by value
of the property Label Font Rotation.
Specifies the special effect for the label text. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the font face for the label text. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the rotation angle of the label text around its center, in degrees. The default
value is 0. Enter a numeric value to change the rotation.
Data type: Float
Specifies whether the label text will in superscript or subscript form, or neither of
them. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the shearing transformation of the label text around its center. The default
value is 0. Enter a numeric value to change the shearing.
Data type: Float
Specifies the font size for the label text. Enter an integer value to change the size.
Data type: Integer
Specifies the style for the line by which the label text is struck through. Choose an
option from the drop-down list.
Data type: Enumeration
Specifies the font style for the label text. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the underline style for the label text. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the color of the point where the gradient ends. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Specifies the horizontal position where the gradient ends, measured in a percentage
of the label text width.
Data type: Integer
Specifies the color of the point where the gradient begins. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Specifies the horizontal position where the gradient begins, measured in a percentage
of the label text width.
Data type: Integer
Specifies the vertical position where the gradient begins, measured in a percentage of
the label text height.
Data type: Integer
Specifies the gradient style for the label text, applying if the property Label Fill Type
is set to gradient. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the color for the label text outline. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Specifies the ending style for the label text outline. Choose an option from the dropdown list.
Data type: Enumeration
Specifies the joint style for the label text outline. Choose an option from the dropdown list.
Data type: Enumeration
Specifies whether to show the label text outline in outline form. If the property is set
to true, the outline will be shown in outline form; otherwise, in whole form.
Data type: Boolean
Specifies the style for the label text outline. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the thickness for the label text outline. Enter a numeric value to change the
thickness.
Data type: Float
Specifies the transparency for the label text outline, in percent. Enter a numeric value
to change the transparency.
Data type: Integer
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Label Position
Specifies whether to show the label text outside or inside the axis.
Data type: Enumeration
Note: This property only applies to 2D chart types, and takes effect only when the
property Use Depth is set to false.
Specifies the background color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Specifies the foreground color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Specifies the texture style for the label text, applying if the property Label Fill Type is
set to texture. Choose an option from the drop-down list.
Data type: Enumeration
Specifies whether to enable the word wrap function for the label text. If the text
contains special characters (such as ",", "." and space), it will be broken at the
position of one of the special characters.
Data type: Boolean
Note: The word wrap function does not apply to radar charts, bubble charts, scatter
charts and gauge charts.
Specifies the length of the major tick marks. Enter a numeric value to change the
length.
Data type: Float
Specifies the position of the major tick marks relative to the axis. Choose an option
from the drop-down list.
Data type: Enumeration
Maximum Value
Specifies the maximum value of the data appearing on the X axis. Only for scatter
charts and bubble charts.
Data type: Float
Minimum Value
Specifies the minimum value of the data appearing on the X axis. Only for scatter
charts and bubble charts.
Data type: Float
Specifies the length of the minor tick marks. Enter a numeric value to change the
length.
Data type: Float
Specifies the position of the minor tick marks relative to the axis. Choose an option
from the drop-down list.
Data type: Enumeration
Number of Labels
Specifies the number of tick mark labels that will be shown. The default is to let
JReport Designer determine the number of labels to be shown.
Data type: Integer
Specifies the number of tick marks that will be shown. The default is to let the
number be determined by JReport Designer. Only for scatter charts and bubble
charts.
Data type: Integer
Show Axis
Specifies whether to show the complete label text when the mouse pointer points at a
label on the axis.
Data type: Boolean
Show Gridline
Start Value
Specifies the position where the X axis label starts to be shown, applying if the
property Use Start Value is set to true. Only for 2-D charts that have a wall.
Data type: Float
Specifies the color of the tick marks. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the ending style for the tick marks. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the joint style for the tick marks. Choose an option from the drop-down list.
Data type: Enumeration
Specifies whether to show the tick marks in outline form. If the property is set to
true, the tick marks will be shown in outline form; otherwise, in whole form.
Data type: Boolean
Specifies the line type for the tick marks. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the thickness of the tick marks. Enter a numeric value to change the
thickness.
Data type: Float
Tick Mark Line Transparency Specifies the transparency of the tick marks, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Tick Mark Line Variable
Dash
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Specifies whether to hide the label which would overlap with the one in front of it.
Data type: Boolean
Specifies whether to set the start value of X axis. This property applies to scatter and
bubble charts, and only if the value on the category axis is not numeric.
Data type: Boolean
Specifies the color for the axis. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the ending style for the axis. Choose an option from the drop-down list.
Data type: Enumeration
Axis Joint
Specifies the joint style for the axis. Choose an option from the drop-down list.
Data type: Enumeration
Axis Outlined
Specifies whether to show the axis in outline form. If the property is set to true, the
axis will be shown in outline form; otherwise, in whole form.
Data type: Boolean
Axis Placement
Specifies the position of the Y axis across the X axis. Choose an option from the dropdown list.
bottom - The Y axis will cross the X axis at its minimum value point.
Specifies the style for the axis. Choose an option from the drop-down list.
Data type: Enumeration
Axis Thickness
Specifies the thickness for the axis. Enter a numeric value to change the thickness.
Data type: Float
Axis Transparency
Specifies the transparency for the axis, in percent. Enter a numeric value to change
the transparency.
Data type: Integer
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Gridline Color
Specifies the color for the gridlines. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the ending style for the gridlines. Choose an option from the drop-down list.
Data type: Enumeration
Gridline Joint
Specifies the joint style for the gridlines. Choose an option from the drop-down list.
Data type: Enumeration
Gridline Outlined
Specifies whether to show the gridlines in outline form. If the property is set to true,
the gridlines will be shown in outline form; otherwise, in whole form.
Data type: Boolean
Gridline Style
Specifies the style for the gridlines. Choose an option from the drop-down list.
Data type: Enumeration
Gridline Thickness
Specifies the thickness for the gridlines. Enter a numeric value to change the
thickness.
Data type: Float
Gridline Transparency
Specifies the transparency for the gridlines, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Increment
Specifies the increased amount between two adjacent values on the X axis. The
default is to let the increased amount be determined by JReport Designer. Only for
scatter charts and bubble charts.
Data type: Integer
Specifies the distance between the labels and the axis. Enter a numeric value to
change the gap.
Data type: Float
Label Color
Specifies the color for the label text. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the frequency at which the tick marks will be labeled. Type 1 to label every
tick mark, type 2 to label every two tick marks, type 3 to label every three tick
marks, and so on.
Data type: Integer
Specifies the transparency for the label text, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Specifies the fill pattern for the label text. Choose an option from the drop-down list.
Data type: Enumeration
Specifies whether to adjust the rotation angle of the label text on the axis
automatically.
true - The rotation angle of the label text will be adjusted automatically
according to the length of the text, in degrees. If the text can be completely
displayed horizontally, the default rotation angle will be 0; if the text can not be
completely displayed horizontally, the default rotation angle will be 30
anticlockwise, and the cut off part will be shown as suspension points.
false - If selected, the rotation angle of the label text will be determined by value
of the property Label Font Rotation.
Specifies the special effect for the label text. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the font face for the label text. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the rotation angle of the label text around its center, in degrees. The default
value is 0. Enter a numeric value to change the rotation.
Data type: Float
Specifies whether the label text will in superscript or subscript form, or neither of
them. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the shearing transformation of the label text around its center. The default
value is 0. Enter a numeric value to change the shearing.
Data type: Float
Specifies the font size for the label text. Enter an integer value to change the size.
Data type: Integer
Specifies the style for the line by which the label text is struck through. Choose an
option from the drop-down list.
Data type: Enumeration
Specifies the font style for the label text. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the underline style for the label text. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the color of the point where the gradient ends. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Specifies the horizontal position where the gradient ends, measured in a percentage
of the label text width.
Data type: Integer
Specifies the color of the point where the gradient begins. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Specifies the horizontal position where the gradient begins, measured in a percentage
of the label text width.
Data type: Integer
Specifies the vertical position where the gradient begins, measured in a percentage of
the label text height.
Data type: Integer
Specifies the gradient style for the label text, applying if the property Label Fill Type
is set to gradient. Choose an option from the drop-down list.
Data type: Integer
Specifies the color for the label text outline. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Specifies the ending style for the label text outline. Choose an option from the dropdown list.
Data type: Enumeration
Specifies the joint style for the label text outline. Choose an option from the dropdown list.
Data type: Enumeration
Specifies whether to show the label text outline in outline form. If the property is set
to true, the outline will be shown in outline form; otherwise, in whole form.
Data type: Boolean
Specifies the style for the label text outline. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the thickness for the label text outline. Enter a numeric value to change the
thickness.
Data type: Float
Specifies the transparency for the label text outline, in percent. Enter a numeric value
to change the transparency.
Data type: Integer
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Label Position
Specifies whether to show the label text outside or inside the axis.
Data type: Enumeration
Note: This property only applies to 2D chart types, and takes effect only when the
property Use Depth is set to false.
Specifies the background color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Specifies the foreground color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Specifies the texture style for the label text, applying if the property Label Fill Type is
set to texture. Choose an option from the drop-down list.
Data type: Enumeration
Specifies whether to enable the word wrap function for the label text. If the text
contains special characters (such as ",", "." and space), it will be broken at the
position of one of the special characters.
Data type: Boolean
Note: The word wrap function does not apply to radar charts, bubble charts, scatter
charts and gauge charts.
Specifies the length of the major tick marks. Enter a numeric value to change the
length.
Data type: Float
Specifies the position of the major tick marks relative to the axis. Choose an option
from the drop-down list.
Data type: Enumeration
Maximum Value
Specifies the maximum value of the data appearing on the Y axis. Only for scatter
charts and bubble charts.
Data type: Float
Minimum Value
Specifies the minimum value of the data appearing on the Y axis. Only for scatter
charts and bubble charts.
Data type: Float
Specifies the length of the minor tick marks. Enter a numeric value to change the
length.
Data type: Float
Specifies the position of the minor tick marks relative to the axis. Choose an option
from the drop-down list.
Data type: Enumeration
Number of Labels
Specifies the number of tick mark labels that will be shown. The default is to let
JReport Designer determine the number of labels to be shown.
Data type: Integer
Specifies the number of tick marks that will be shown. The default is to let the
number be determined by JReport Designer. Only for scatter charts and bubble
charts.
Data type: Integer
Show Axis
Specifies whether to show the complete label text when the mouse pointer points at a
label on the axis.
Data type: Boolean
Show Gridline
Start Value
Specifies the position where the axis label starts to be shown, applying if the property
Use Start Value is set to true. Only for 2-D charts that have a wall.
Data type: Float
Specifies the color of the tick marks. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the ending style for the tick marks. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the joint style for the tick marks. Choose an option from the drop-down list.
Data type: Enumeration
Specifies whether to show the tick marks in outline form. If the property is set to
true, the tick marks will be shown in outline form; otherwise, in whole form.
Data type: Boolean
Specifies the line type for the tick marks. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the thickness of the tick marks. Enter a numeric value to change the
thickness.
Data type: Float
Tick Mark Line Transparency Specifies the transparency of the tick marks, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Tick Mark Line Variable
Dash
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Specifies whether to hide the label which would overlap with the one in front of it.
Data type: Boolean
Specifies whether to set the start value of the axis. Only for 2-D charts that have a
wall.
Data type: Boolean
Specifies the color for the axis. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the ending style for the axis. Choose an option from the drop-down list.
Data type: Enumeration
Axis Joint
Specifies the joint style for the axis. Choose an option from the drop-down list.
Data type: Enumeration
Axis Outlined
Specifies whether to show the axis in outline form. If the property is set to true, the
axis will be shown in outline form; otherwise, in whole form.
Data type: Boolean
Axis Placement
Specifies the position of the Z axis. Choose an option from the drop-down list.
Data type: Enumeration
Axis Style
Specifies the style for the axis. Choose an option from the drop-down list.
Data type: Enumeration
Axis Thickness
Specifies the thickness for the axis. Enter a numeric value to change the thickness.
Data type: Float
Axis Transparency
Specifies the transparency for the axis, in percent. Enter a numeric value to change
the transparency.
Data type: Integer
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Gridline Color
Specifies the color of the gridlines. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the ending style for the gridlines. Choose an option from the drop-down list.
Data type: Enumeration
Gridline Joint
Specifies the joint style for the gridlines. Choose an option from the drop-down list.
Data type: Enumeration
Gridline Outlined
Specifies whether to show the gridlines in outline form. If the property is set to true,
the gridlines will be shown in outline form; otherwise, in whole form.
Data type: Boolean
Gridline Style
Specifies the style for the gridlines. Choose an option from the drop-down list.
Data type: Enumeration
Gridline Thickness
Specifies the thickness for the gridlines. Enter a numeric value to change the
thickness.
Data type: Float
Gridline Transparency
Specifies the gridline transparency, in percent. Enter a numeric value to change the
transparency.
Data type: Integer
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Specifies the distance between the labels and the axis. Enter a numeric value to
change the gap.
Data type: Float
Label Color
Specifies the color for the label text. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the frequency at which the tick marks will be labeled. Type 1 to label every
tick mark, type 2 to label every two tick marks, type 3 to label every three tick
marks, and so on.
Data type: Integer
Specifies the transparency for the label text, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Specifies the fill pattern for the label text. Choose an option from the drop-down list.
Data type: Enumeration
Specifies whether to adjust the rotation angle of the label text on the axis
automatically.
true - The rotation angle of the label text will be adjusted automatically
according to the length of the text, in degrees. If the text can be completely
displayed horizontally, the default rotation angle will be 0; if the text can not be
completely displayed horizontally, the default rotation angle will be 30
anticlockwise, and the cut off part will be shown as suspension points.
false - If selected, the rotation angle of the label text will be determined by value
of the property Label Font Rotation.
Specifies the special effect for the label text. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the font face for the label text. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the rotation angle of the label text around its center, in degrees. The default
value is 0.
Data type: Float
Specifies whether the label text will in superscript or subscript form, or neither of
them. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the shearing transformation of the label text around its center. The default
value is 0.
Data type: Float
Specifies the font size for the label text. Enter an integer value to change the size.
Data type: Integer
Specifies the style for the line by which the label text is struck through. Choose an
option from the drop-down list.
Data type: Enumeration
Specifies the font style for the label text. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the underline style for the label text. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the color of the point where the gradient ends. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Specifies the horizontal position where the gradient ends, measured in a percentage
of the label text width.
Data type: Integer
Specifies the color of the point where the gradient begins. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Specifies the horizontal position where the gradient begins, measured in a percentage
of the label text width.
Data type: Integer
Specifies the vertical position where the gradient begins, measured in a percentage of
the label text height.
Data type: Integer
Specifies the gradient style for the label text, applying if the property Label Fill Type
is set to gradient. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the color for the label text outline. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Specifies the ending style for the label text outline. Choose an option from the dropdown list.
Data type: Enumeration
Specifies the joint style for the label text outline. Choose an option from the dropdown list.
Data type: Enumeration
Specifies whether to show the label text outline in outline form. If the property is set
to true, the outline will be shown in outline form; otherwise, in whole form.
Data type: Boolean
Specifies the style for the label text outline. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the thickness for the label text outline. Enter a numeric value to change the
thickness.
Data type: Float
Specifies the transparency for the label text outline, in percent. Enter a numeric value
to change the transparency.
Data type: Integer
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Specifies the background color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Specifies the foreground color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Specifies the texture style for the label text, applying if the property Label Fill Type is
set to texture. Choose an option from the drop-down list.
Data type: Enumeration
Specifies whether to enable the word wrap function for the label text. If the text
contains special characters (such as ",", "." and space), it will be broken at the
position of one of the special characters.
Data type: Boolean
Note: The word wrap function does not apply to radar charts, bubble charts, scatter
charts and gauge charts.
Specifies the length of the major tick marks. Enter a numeric value to change the
length.
Data type: Float
Specifies the position of the major tick marks relative to the axis. Choose an option
from the drop-down list.
Data type: Enumeration
Specifies the length of the minor tick marks. Enter a numeric value to change the
length.
Data type: Float
Specifies the position of the minor tick marks relative to the axis. Choose an option
from the drop-down list.
Data type: Enumeration
Number of Labels
Specifies the number of tick mark labels that will be shown. The default is to let
JReport Designer determine the number of labels to be shown.
Data type: Integer
Show Axis
Specifies whether to show the complete label text when the mouse pointer points at a
label on the axis.
Data type: Boolean
Show Gridline
Specifies the color of the tick marks. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the ending style for the tick marks. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the joint style for the tick marks. Choose an option from the drop-down list.
Data type: Enumeration
Specifies whether to show the tick marks in outline form. If the property is set to
true, the tick marks will be shown in outline form; otherwise, in whole form.
Data type: Boolean
Specifies the line type for the tick marks. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the thickness of the tick marks. Enter a numeric value to change the
thickness.
Data type: Float
Tick Mark Line Transparency Specifies the transparency of the tick marks, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Tick Mark Line Variable
Dash
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Specifies whether to hide the label which would overlap with the one in front of it.
Data type: Boolean
Wall
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down
list, enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a
color.
Data type: String
Specifies the ending style of the wall border line. Choose an option from the dropdown list.
Data type: Enumeration
Border Joint
Specifies the joint style of the wall border line. Choose an option from the drop-down
list.
Data type: Enumeration
Border Outlined
Specifies whether to show the wall border line in Outline Path. If the property is set to
true, the wall border line will be shown in Outline Path; otherwise, in Fill Path.
Data type: Boolean
Border Style
Specifies the line style of the wall borders. Choose an option from the drop-down list.
Data type: Enumeration
Border Thickness
Specifies the width of the border in inches or centimeters. Enter a numeric value to
change the thickness.
Data type: Float
Border Transparency
Specifies the transparency of the wall borders, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Bound Color
Specifies the color of the bound wall, applying if the property Bound Fill Type is set to
color. Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g.
0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the fill pattern for the bound wall. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the color of the point where the gradient begins. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Specifies the horizontal position where the gradient begins, measured in a percentage
of the bound wall width.
Data type: Integer
Specifies the vertical position where the gradient begins, measured in a percentage of
the bound wall height.
Data type: Integer
Specifies the color of the point where the gradient ends. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Specifies the horizontal position where the gradient ends, measured in a percentage
of the bound wall width.
Data type: Integer
Specifies the vertical position where the gradient ends, measured in a percentage of
the bound wall height.
Data type: Integer
Specifies the gradient style for the bound wall, applying if the property Bound Fill
Type is set to gradient. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the background color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Specifies the foreground color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Specifies the texture style for the bound wall, applying if the property Bound Fill Type
is set to texture. Choose an option from the drop-down list.
Data type: Enumeration
Color
Specifies the color of the wall, applying if the property Fill Type is set to color. Choose
a color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or
choose a formula that returns a color.
Data type: String
Fill Transparency
Fill Type
Specifies the fill pattern for the wall. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the color of the point where the gradient ends. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Gradient End X
Specifies the horizontal position where the gradient ends, measured in a percentage
of the wall width.
Data type: Integer
Gradient End Y
Specifies the vertical position where the gradient ends, measured in a percentage of
the wall height.
Data type: Integer
Specifies the color of the point where the gradient begins. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Gradient Start X
Specifies the horizontal position where the gradient begins, measured in a percentage
of the wall width.
Data type: Integer
Gradient Start Y
Specifies the vertical position where the gradient begins, measured in a percentage of
the wall height.
Data type: Integer
Gradient Style
Specifies the gradient style for the wall, applying if the property Fill Type is set to
gradient. Choose an option from the drop-down list.
Data type: Enumeration
Image File
Specifies the file name of the image, a portion of which will be displayed as the wall
background, applying if the property Fill Type is set to image.
Data type: String
Image Height
The four properties, Image X, Image Y, Image Width and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Height specifies the height of the image portion, measured in a percentage of
the image height.
Data type: Integer
Image Layout
Specifies the layout style for the image. Choose an option from the drop-down list.
Data type: Enumeration
Image Width
The four properties, Image X, Image Y, Image Width and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Width specifies the width of the image portion, measured in a percentage of
the image width.
Data type: Integer
Image X
The four properties, Image X, Image Y, Image Width and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image X specifies the distance between the left border of image and the portion that
will contain the pattern, measured in a percentage of the image width.
Data type: Integer
Image Y
The four properties, Image X, Image Y, Image Width and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Y specifies the distance between the top border of image and the portion that
will contain the pattern, measured in a percentage of the image height.
Data type: Integer
Show Wall
Specifies the background color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Specifies the foreground color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Texture Style
Specifies the texture style for the wall, applying if the property Fill Type is set to
texture. Choose an option from the drop-down list.
Data type: Enumeration
Floor
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down
list, enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a
color.
Data type: String
Specifies the ending style of the floor border line. Choose an option from the dropdown list.
Data type: Enumeration
Border Joint
Specifies the joint style of the floor border line. Choose an option from the drop-down
list.
Data type: Enumeration
Border Outlined
Specifies whether to show the floor border line in Outline Path. If the property is set
to true, the floor border line will be shown in Outline Path; otherwise, in Fill Path.
Data type: Boolean
Border Style
Specifies the line style of the floor borders. Choose an option from the drop-down list.
Data type: Enumeration
Border Thickness
Specifies the width of the border in inches or centimeters. Enter a numeric value to
change the thickness.
Data type: Float
Border Transparency
Specifies the transparency of the floor borders, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Color
Specifies the color of the floor, applying if the property Fill Type is set to color.
Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g.
0xff0000) or choose a formula that returns a color.
Data type: String
Fill Transparency
Fill Type
Specifies the fill pattern for the floor. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the color of the point where the gradient ends. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Gradient End X
Specifies the horizontal position where the gradient ends, measured in a percentage
of the floor width.
Data type: Integer
Gradient End Y
Specifies the vertical position where the gradient ends, measured in a percentage of
the floor height.
Data type: Integer
Specifies the color of the point where the gradient begins. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color. A String type value.
Gradient Start X
Specifies the horizontal position where the gradient begins, measured in a percentage
of the floor width.
Data type: Integer
Gradient Start Y
Specifies the vertical position where the gradient begins, measured in a percentage of
the floor height.
Data type: Integer
Gradient Style
Specifies the gradient style for the floor, applying if the property Fill Type is set to
gradient. Choose an option from the drop-down list.
Data type: Enumeration
Image File
Specifies the filename of the image, a portion of which will be displayed as the floor
background, applying if the property Fill Type is set to image.
Data type: String
Image Height
The four properties, Image X, Image Y, Image Width and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Height specifies the height of the image portion, measured in a percentage of
the image height.
Data type: Integer
Image Layout
Specifies the layout style for an image. Choose an option from the drop-down list.
Data type: Enumeration
Image Width
The four properties, Image X, Image Y, Image Width and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Width specifies the width of the image portion, measured in a percentage of
the image width.
Data type: Integer
Image X
The four properties, Image X, Image Y, Image Width and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image X specifies the distance between the left border of image and the portion that
will contain the pattern, measured in a percentage of the image width.
Data type: Integer
Image Y
The four properties, Image X, Image Y, Image Width and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Y specifies the distance between the top border of image and the portion that
will contain the pattern, measured in a percentage of the image height.
Data type: Integer
Show Floor
Specifies whether to show the floor, only for 3-D chart types.
Data type: Boolean
Specifies the background color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Specifies the foreground color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Texture Style
Specifies the texture style for the floor, applying if the property Fill Type is set to
texture. Choose an option from the drop-down list.
Data type: Enumeration
Threshold Line
Fill Threshold1
Specifies whether to fill the first threshold area with a semi-transparent color,
applying to 2-D charts (except stock charts).
Data type: Boolean
Fill Threshold2
Specifies whether to fill the second threshold area with a semi-transparent color,
applying to 2-D charts (except stock charts).
Data type: Boolean
Fill Transparency
Specifies whether to show the first threshold line, applying to 2-D charts (except
stock charts), 3-D bar charts, 3-D area charts, 3-D line charts and 3-D bench charts.
Data type: Boolean
Specifies whether to show the second threshold line, applying to 2-D charts (except
stock charts), 3-D bar charts, 3-D area charts, 3-D line charts and 3-D bench charts.
Data type: Boolean
Specifies the color for the first threshold line, applying to 2-D charts (except stock
charts), 3-D bar charts, 3-D area charts, 3-D line charts and 3-D bench charts.
Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g.
0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the color for the second threshold line, applying to 2-D charts (except stock
charts), 3-D bar charts, 3-D area charts, 3-D line charts and 3-D bench charts.
Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g.
0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the style for the threshold lines, applying to 2-D charts (except stock
charts). Choose an option from the drop-down list.
Data type: Enumeration
Threshold Value1
Specifies the value for the first threshold line, applying to 2-D charts (except stock
charts), 3-D bar charts, 3-D area charts, 3-D line charts and 3-D bench charts.
Data type: Float
Threshold Value2
Specifies the value for the second threshold line, applying to 2-D charts (except stock
charts), 3-D bar charts, 3-D area charts, 3-D line charts and 3-D bench charts.
Data type: Float
MeanLine
Color
Specifies the color of the mean line. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Node Style
Specifies the style of the nodes that represent the average values. Choose an option
from the drop-down list.
Data type: Enumeration
Show
Specifies whether to show a line that represents the average value of each category
group. Only for 2-D charts (except stock charts, scatter charts, radar charts and
bubble charts).
Data type: Boolean
Type
Specifies the type of the mean line. Choose an option from the drop-down list.
Data type: Enumeration
Notes:
For combo chart, the graph properties will respectively apply to the corresponding chart types.
A combo chart may contain two value axes, namely, the Y1 and Y2 axes. While a 3-D chart only
contains one value axis. The properties of the Y1 or Y2 axis are the same as those of the Y axis.
Chart legend
The properties of a chart legend are:
Property
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. Enter a numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. Enter a numeric value to change the position in inches or centimeters.
Data type: Float
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and when
there are styles in the Style Group that can be applied to the object, or type in the
style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Bottom Margin
Specifies the distance between the legend labels and the bottom border of the legend.
Enter a numeric value to change the margin.
Data type: Float
Specifies the data format option for the chart legend labels. Choose an option from the
drop-down list.
Axis Data Format - If selected, the data format of the legend labels will follow that
of the axis data: if the chart has series axis, the legend label format will be the same
as the series axis data format; if not, the category axis data format will be used to
the legend labels.
Legend Data Format - If selected, the data format of the legend labels will be
controlled by the property Legend Data Format.
Specifies the vertical distance between two adjacent legend labels. Enter a numeric value
to change the distance.
Data type: Float
Left Margin
Specifies the distance between the legend labels and the left border of the legend. Enter
a numeric value to change the margin.
Data type: Float
Specifies the data format of the legend labels manually, applying if Label Format Source
is set to Legend Data Format. Click
in the value cell to specify the format.
Data type: String
Placement
Specifies the position of the legend in the platform. Choose an option from the dropdown list.
Data type: Enumeration
Right Margin
Specifies the distance between the legend labels and the right border of the legend.
Enter a numeric value to change the margin.
Data type: Float
Secondary Placement
Specifies the position of the legend further based on the setting of the property
Placement. Choose an option from the drop-down list.
Data type: Enumeration
Show Tips
Specifies whether to show the corresponding data information when the mouse pointer
points at a target in the chart legend area in view mode, in HTML/DHTML result, or in
JReport Studio.
Data type: Boolean
Top Margin
Specifies the distance between the legend labels and the top border of the legend. Enter
a numeric value to change the margin.
Data type: Float
Background
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Specifies the ending style of the legend border line. Choose an option from the dropdown list.
Data type: Enumeration
Border Joint
Specifies the joint style of the legend border line. Choose an option from the drop-down
list.
Data type: Enumeration
Border Outlined
Specifies whether to show the legend border line in Outline Path. If the property is set to
true, the legend border line will be shown in Outline Path; otherwise, in Fill Path.
Data type: Boolean
Border Style
Specifies the line style of the legend borders. Choose an option from the drop-down list.
Data type: Enumeration
Border Thickness
Specifies the width of the border in inches or centimeters. Enter a numeric value to
change the thickness.
Data type: Float
Border Transparency
Specifies the transparency of the legend borders, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Border Type
Specifies the border type of the legend. Choose an option from the drop-down list.
Data type: Enumeration
true - The dash size will be adjusted automatically. And the option Auto Adjust Dash
in the Format Legend dialog will take effect.
false - The dash size will be of fixed size. And the option Fixed Dash Size in the
Format Legend dialog will take effect.
Specifies the color of the legend background, applying if the property Fill Type is set to
color. Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g.
0xff0000) or choose a formula that returns a color.
Data type: String
Fill Transparency
Fill Type
Specifies the fill pattern for the legend background. Choose an option from the dropdown list.
Data type: Enumeration
Specifies the color of the point where the gradient ends. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Gradient End X
Specifies the horizontal position where the gradient ends, measured in a percentage of
the legend width.
Data type: Integer
Gradient End Y
Specifies the vertical position where the gradient ends, measured in a percentage of the
legend height.
Data type: Integer
Specifies the color of the point where the gradient begins. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Gradient Start X
Specifies the horizontal position where the gradient begins, measured in a percentage of
the legend width.
Data type: Integer
Gradient Start Y
Specifies the vertical position where the gradient begins, measured in a percentage of
the legend height.
Data type: Integer
Gradient Style
Specifies the gradient style for the legend background, applying if the property Fill Type
is set to gradient. Choose an option from the drop-down list.
Data type: Enumeration
Image File
Specifies the file name of the image, a portion of which will be displayed as the legend
background, applying if the property Fill Type is set to image.
Data type: String
Image Height
The four properties, Image X, Image Y, Image Width, and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Height specifies the height of the image portion, measured in a percentage of the
image height.
Data type: Integer
Image Layout
Specifies the layout style for the image. Choose an option from the drop-down list.
Data type: Enumeration
Image Width
The four properties, Image X, Image Y, Image Width, and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Width specifies the width of the image portion, measured in a percentage of the
image width.
Data type: Integer
Image X
The four properties, Image X, Image Y, Image Width, and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image X specifies the distance between the left border of image and the portion that will
contain the pattern, measured in a percentage of the image width.
Data type: Integer
Image Y
The four properties, Image X, Image Y, Image Width, and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Y specifies the distance between the top border of image and the portion that will
contain the pattern, measured in a percentage of the image height.
Data type: Integer
Inset Bottom
Specifies the bottom position of the background area, measured in a percentage of the
legend height, from the bottom edge of the legend.
Data type: Float
Inset Left
Specifies the left position of the background area, measured in a percentage of the
legend width, from the left edge of the legend.
Data type: Float
Inset Right
Specifies the right position of the background area, measured in a percentage of the
legend width, from the right edge of the legend.
Data type: Float
Inset Top
Specifies the top position of the background area, measured in a percentage of the
legend height, from the top edge of the legend.
Data type: Float
Texture Background
Color
Specifies the background color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Texture Foreground
Color
Specifies the foreground color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Texture Style
Specifies the texture style of the legend background, applying if the property Fill Type is
set to texture. Choose an option from the drop-down list.
Data type: Enumeration
Label
Color
Specifies the color of the label, applying if the property Fill Type is set to color. Choose a
color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose
a formula that returns a color.
Data type: String
Fill Transparency
Fill Type
Specifies the fill pattern for the label. Choose an option from the drop-down list.
Data type: Enumeration
Font Effect
Specifies the special effect for the label text. Choose an option from the drop-down list.
Data type: Enumeration
Font Face
Specifies the font face for the legend labels. Choose an option from the drop-down list.
Data type: Enumeration
Font Rotation
Specifies the rotation angle of each legend label around its center, in degrees. The
default value is 0. Enter a numeric value to change the rotation.
Data type: Float
Font Script
Specifies whether the label text will in superscript or subscript form, or neither of them.
Choose an option from the drop-down list.
Data type: Enumeration
Font Shearing
Specifies the shearing transformation of each legend label around its center. The default
value is 0. Enter a numeric value to change the shearing.
Data type: Float
Font Size
Specifies the font size for the legend labels. Enter an integer value to change the size.
Data type: Integer
Font Strikethrough
Specifies the style of the line by which the label texts are struck through. Choose an
option from the drop-down list.
Data type: Enumeration
Font Style
Specifies the font style for the legend labels. Choose an option from the drop-down list.
Data type: Enumeration
Font Underline
Specifies the underline style for the legend labels. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the color of the point where the gradient ends. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Gradient End X
Specifies the horizontal position where the gradient ends, measured in a percentage of
the label text width.
Data type: Integer
Gradient End Y
Specifies the vertical position where the gradient ends, measured in a percentage of the
label text height.
Data type: Integer
Specifies the color of the point where the gradient begins. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Gradient Start X
Specifies the horizontal position where the gradient begins, measured in a percentage of
the label text width.
Data type: Integer
Gradient Start Y
Specifies the vertical position where the gradient begins, measured in a percentage of
the label text height.
Data type: Integer
Gradient Style
Specifies the gradient style for the label, applying if the property Fill Type is set to
gradient. The image fill type does not apply to the legend label. Choose an option from
the drop-down list.
Data type: Enumeration
Outline Color
Specifies the color for the label text outline. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the ending style for the label text outline. Choose an option from the dropdown list.
Data type: Enumeration
Outline Joint
Specifies the joint style for the label text outline. Choose an option from the drop-down
list.
Data type: Enumeration
Outline Outlined
Specifies whether to show the label text outline in outline form. If the property is set to
true, the outline will be shown in outline form; otherwise, in whole form.
Data type: Boolean
Outline Style
Specifies the style for the label text outline. Choose an option from the drop-down list.
Data type: Enumeration
Outline Thickness
Specifies the thickness for the label text outline. Enter a numeric value to change the
thickness.
Data type: Float
Outline Transparency
Specifies the transparency for the label text outline, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Specifies whether to resize the dash automatically. If the property is set to true, the dash
size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Percent Format
Specifies the number format for percentage values. Applies to pie, bench/bar charts that
in the value cell to specify the format.
have only one value axis. Click
Data type: String
Reverse Labels
Specifies whether to reverse the order of the labels in the legend object.
Data type: Boolean
Show Percent
Specifies whether to show the percentage of each legend. Applies to pie, bench/bar
charts that have only one value axis.
Data type: Boolean
Show Values
Specifies whether to show the value of each legend. Applies to pie, bench/bar charts that
have only one value axis.
Data type: Boolean
Texture Background
Color
Specifies the background color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Texture Foreground
Color
Specifies the foreground color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Texture Style
Specifies the texture style for the label, applying if the property Fill Type is set to
texture. Choose an option from the drop-down list.
Data type: Enumeration
Value Format
Specifies the number format for the legend values. Applies to pie, bench/bar charts that
in the value cell to specify the format.
have only one value axis. Click
Data type: String
Word Wrap
Specifies whether to enable the word wrap function for the label text. If the text contains
special characters (such as ",", "." and space), it will be broken at the position of one of
the special characters.
Data type: Boolean
Note: The word wrap function does not apply to radar charts, bubble charts, scatter
charts and gauge charts.
Icon
Border Color
Specifies the color of the icon borders. Choose a color from the drop-down list, enter a
hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Specifies the ending style of the icon border line. Choose an option from the drop-down
list.
Data type: Enumeration
Border Joint
Specifies the joint style of the icon border line. Choose an option from the drop-down
list.
Data type: Enumeration
Border Outlined
Specifies whether to show the icon border line in Outline Path. If the property is set to
true, the icon border line will be shown in Outline Path; otherwise, in Fill Path.
Data type: Boolean
Border Style
Specifies the line style of the icon borders. Choose an option from the drop-down list.
Data type: Enumeration
Border Thickness
Specifies the width of the icon borders in inches or centimeters. Enter a numeric value to
change the thickness.
Data type: Float
Border Transparency
Specifies the transparency of the icon borders, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Specifies whether to resize the dash automatically. If the property is set to true, the dash
size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Height
Specifies the height of the icon, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Icon Alignment
Specifies the relative position of the icon to the legend. Choose an option from the dropdown list.
Data type: Enumeration
Specifies the distance between each legend label and icon. Enter a numeric value to
change the gap.
Data type: Float
Style List
Specifies the style for the icon of each category name. The icon style for each category
in the value cell to specify the style list.
name can be different. Click
Data type: String
Width
Specifies the width of the icon, in inches or centimeters. Enter a numeric value to change
the width.
Data type: Float
Chart label
The properties of a chart label are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. Enter a numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. Enter a numeric value to change the position in inches or centimeters.
Data type: Float
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies the distance between the label text and the bottom border of the label. Enter
a numeric value to change the margin.
Data type: Float
Color
Specifies the color of the label, applying if the property Fill Type is set to color. Choose
a color from the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or
choose a formula that returns a color.
Data type: String
Fill Transparency
Fill Type
Specifies the fill pattern for the label. Choose an option from the drop-down list.
Data type: Integer
Font Effect
Specifies the special effect for the label text. Choose an option from the drop-down list.
Data type: Enumeration
Font Face
Specifies the font face of the label text. Choose an option from the drop-down list.
Data type: Enumeration
Font Rotation
Specifies the rotation angle of the label text around its center, in degrees. The default
value is 0. Enter a numeric value to change the rotation.
Data type: Float
Font Script
Specifies whether the label text will be in superscript or subscript form, or neither of
them. Choose an option from the drop-down list.
Data type: Enumeration
Font Shearing
Specifies the shearing transformation of the label text around its center. The default
value is 0. Enter a numeric value to change the shearing.
Data type: Float
Font Size
Specifies the font size of the label text. Enter an integer value to change the size.
Data type: Integer
Font Strikethrough
Specifies the style of the line by which the label text is struck through. Choose an
option from the drop-down list.
Data type: Enumeration
Font Style
Specifies the font style for the label text. Choose an option from the drop-down list.
Data type: Enumeration
Font Underline
Specifies the underline style for the label text. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the color of the point where the gradient ends. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Gradient End X
Specifies the horizontal position where the gradient ends, measured in a percentage of
the label text width.
Data type: Integer
Gradient End Y
Specifies the vertical position where the gradient ends, measured in a percentage of the
label text height.
Data type: Integer
Specifies the color of the point where the gradient begins. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Gradient Start X
Specifies the horizontal position where the gradient begins, measured in a percentage
of the label text width.
Data type: Integer
Gradient Start Y
Specifies the vertical position where the gradient begins, measured in a percentage of
the label text height.
Data type: Integer
Gradient Style
Specifies the gradient style for the label, applying if the property Fill Type is set to
gradient. Choose an option from the drop-down list.
Data type: Enumeration
Left Margin
Specifies the distance between the label text and the left border of the label. Enter a
numeric value to change the margin.
Data type: Float
Outline Color
Specifies the color for the label text outline. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies the ending style for the label text outline. Choose an option from the dropdown list.
Data type: Integer
Outline Joint
Specifies the joint style for the label text outline. Choose an option from the drop-down
list.
Data type: Enumeration
Outline Outlined
Specifies whether to show the label text outline in outline form. If the property is set to
true, the outline will be shown in outline form; otherwise, in whole form.
Data type: Boolean
Outline Style
Specifies the style for the label text outline. Choose an option from the drop-down list.
Data type: Enumeration
Outline Thickness
Outline Transparency
Specifies the transparency for the label text outline, in percent. Enter a numeric value
to change the transparency.
Data type: Integer
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Right Margin
Specifies the distance between the label text and the right border of the label. Enter a
numeric value to change the margin.
Data type: Float
Text
Specifies the text of the label. Enter a string to change the text.
Data type: String
Text Alignment
Specifies the alignment style of the label text. Choose an option from the drop-down
list.
Data type: Enumeration
Texture Background Color Specifies the background color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Texture Foreground Color Specifies the foreground color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Texture Style
Specifies the texture style for the label, applying if the property Fill Type is set to
texture. Choose an option from the drop-down list.
Data type: Enumeration
Top Margin
Specifies the distance between the label text and the top border of the label. Enter a
numeric value to change the margin.
Data type: Float
Word Wrap
Specifies whether to enable the word wrap function for the label text. If the text
contains special characters (such as ",", "." and space), it will be broken at the position
of one of the special characters.
Data type: Boolean
Note: The word wrap function does not apply to radar charts, bubble charts, scatter
charts and gauge charts.
Background
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Specifies the ending style of the label border line. Choose an option from the drop-down
list.
Data type: Enumeration
Border Joint
Specifies the joint style of the label border line. Choose an option from the drop-down
list.
Data type: Enumeration
Border Outlined
Specifies whether to show the label border line in Outline Path. If the property is set to
true, the label border line will be shown in Outline Path; otherwise, in Fill Path.
Data type: Boolean
Border Style
Specifies the line style of the label borders. Choose an option from the drop-down list.
Data type: Enumeration
Border Thickness
Specifies the width of the border in inches or centimeters. Enter a numeric value to
change the thickness.
Data type: Float
Border Transparency
Specifies the transparency of the label borders, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Border Type
Specifies the border type of the label. Choose an option from the drop-down list.
Data type: Enumeration
true - The dash size will be adjusted automatically. And the option Auto Adjust
Dash in the Format Label dialog will take effect.
false - The dash size will be of fixed size. And the option Fixed Dash Size in the
Format Label dialog will take effect.
Specifies the color of the label background, applying if the property Fill Type is set to
color. Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g.
0xff0000) or choose a formula that returns a color.
Data type: String
Fill Transparency
Fill Type
Specifies the fill pattern for the label background. Choose an option from the drop-down
list.
Data type: Enumeration
Specifies the color of the point where the gradient ends. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Gradient End X
Specifies the horizontal position where the gradient ends, measured in a percentage of
the label width.
Data type: Integer
Gradient End Y
Specifies the vertical position where the gradient ends, measured in a percentage of the
label height.
Data type: Integer
Specifies the color of the point where the gradient begins. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Gradient Start X
Specifies the horizontal position where the gradient begins, measured in a percentage
of the label width.
Data type: Integer
Gradient Start Y
Specifies the vertical position where the gradient begins, measured in a percentage of
the label height.
Data type: Integer
Gradient Style
Specifies the gradient style for the label background, applying if the property Fill Type is
set to gradient. Choose an option from the drop-down list.
Data type: Enumeration
Image File
Specifies the file name of the image, a portion of which will be displayed as the label
background, applying if the property Fill Type is set to image.
Data type: String
Image Height
The four properties, Image X, Image Y, Image Width, and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Height specifies the height of the image portion, measured in a percentage of
the image height.
Data type: Integer
Image Layout
Specifies the layout style for the image. Choose an option from the drop-down list.
Data type: Integer
Image Width
The four properties, Image X, Image Y, Image Width, and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Width specifies the width of the image portion, measured in a percentage of the
image width.
Data type: Integer
Image X
The four properties, Image X, Image Y, Image Width, and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image X specifies the distance between the left border of image and the portion that
will contain the pattern, measured in a percentage of the image width.
Data type: Integer
Image Y
The four properties, Image X, Image Y, Image Width, and Image Height, together are
used to define a portion of an image (the portion is a rectangle).
Image Y specifies the distance between the top border of image and the portion that
will contain the pattern, measured in a percentage of the image height.
Data type: Integer
Inset Bottom
Specifies the bottom position of the background area, measured in a percentage of the
label height, from the bottom edge of the label.
Data type: Float
Inset Left
Specifies the left position of the background area, measured in a percentage of the label
width, from the left edge of the label.
Data type: Float
Inset Right
Specifies the right position of the background area, measured in a percentage of the
label width, from the right edge of the label.
Data type: Float
Inset Top
Specifies the top position of the background area, measured in a percentage of the label
height, from the top edge of the label.
Data type: Float
Texture Background Color Specifies the background color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Texture Foreground Color Specifies the foreground color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Texture Style
Specifies the texture style for the label background, applying if the property Fill Type is
set to texture. Choose an option from the drop-down list.
Data type: Enumeration
Icon
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Specifies the ending style of the icon border line. Choose an option from the drop-down
list.
Data type: Enumeration
Border Joint
Specifies the joint style of the icon border line. Choose an option from the drop-down
list.
Data type: Enumeration
Border Outlined
Specifies whether to show the icon border line in Outline Path. If the property is set to
true, the icon border line will be shown in Outline Path; otherwise, in Fill Path.
Data type: Boolean
Border Style
Specifies the line style of the icon borders. Choose an option from the drop-down list.
Data type: Enumeration
Border Thickness
Specifies the width of the border in inches or centimeters. Enter a numeric value to
change the thickness.
Data type: Float
Border Transparency
Specifies the transparency of the icon borders, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Specifies whether to resize the dash automatically. If the property is set to true, the
dash size will be adjusted automatically; otherwise, the dash size will be of fixed size.
Data type: Boolean
Color
Specifies the color of the icon background, applying if the property Fill Type is set to
color. Choose a color from the drop-down list, enter a hexadecimal RGB value (e.g.
0xff0000) or choose a formula that returns a color.
Data type: String
Fill Transparency
Specifies the transparency of the icon background, in percent. Enter a numeric value to
change the transparency.
Data type: Integer
Fill Type
Specifies the fill pattern for the icon. Choose an option from the drop-down list.
Data type: Enumeration
Specifies the color of the point where the gradient ends. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Gradient End X
Specifies the horizontal position where the gradient ends, measured in a percentage of
the icon width.
Data type: Integer
Gradient End Y
Specifies the vertical position where the gradient ends, measured in a percentage of the
icon height.
Data type: Integer
Specifies the color of the point where the gradient begins. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Gradient Start X
Specifies the horizontal position where the gradient begins, measured in a percentage
of the icon width.
Data type: Integer
Gradient Start Y
Specifies the vertical position where the gradient begins, measured in a percentage of
the icon height.
Data type: Integer
Gradient Style
Specifies the gradient style for the icon, applying if the property Fill Type is set to
gradient. Choose an option from the drop-down list.
Data type: Enumeration
Height
Specifies the height of the icon, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Icon Alignment
Specifies the relative position of the icon to the label. Choose an option from the dropdown list.
Data type: Enumeration
Icon Style
Specifies the style of the icon attached to the label. Choose an option from the dropdown list.
Data type: Enumeration
Image File
Specifies the file name of the image, a portion of which will be displayed as the icon
background, applying if the property Fill Type is set to image.
Data type: String
Image Height
The four properties together are used to define a portion of an image (the portion is a
rectangle): Image X, Image Y, Image Width, and Image Height.
Image Height specifies the height of the image portion, measured in a percentage of
the image height.
Data type: Integer
Image Layout
Specifies the layout style for the image. Choose an option from the drop-down list.
Data type: Enumeration
Image Width
The four properties together are used to define a portion of an image (the portion is a
rectangle): Image X, Image Y, Image Width, and Image Height.
Image Width specifies the width of the image portion, measured in a percentage of the
image width.
Data type: Integer
Image X
The four properties together are used to define a portion of an image (the portion is a
rectangle): Image X, Image Y, Image Width, and Image Height.
Image X specifies the distance between the left border of image and the portion that
will contain the pattern, measured in a percentage of the image width.
Data type: Integer
Image Y
The four properties together are used to define a portion of an image (the portion is a
rectangle): Image X, Image Y, Image Width, and Image Height.
Image Y specifies the distance between the top border of image and the portion that
will contain the pattern, measured in a percentage of the image height.
Data type: Integer
Texture Background Color Specifies the background color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Texture Foreground Color Specifies the foreground color of the texture. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Texture Style
Specifies the texture style for the icon, applying if the property Fill Type is set to
texture. Choose an option from the drop-down list.
Data type: Enumeration
Width
Specifies the width of the icon, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
none
The object has no visible border lines (default value).
raised
The object has 3D borders that appear as if they are raised off the page.
recess
The object has 3D borders that appear as if they are pressed into the page.
shadow
The object has two shadowed borders, beneath and to the right of the object.
solid
The object has single-line borders.
Data Format
Specifies the data format for the labels of the axes or legend as required. Applies to chart platforms.
Click
Format
Type
Scale
Description (Sample)
Obtains a new value by a calculation on the value.
Logarithm
Hundreds
Thousands
Millions
Billions
Trillions
Number
#,##0
#,##0;-#,
##0
0.00
#,##0.00
0.00E00
##0.0E0
$0
$#,##0
$#,##0;-$#,
##0
$0.00
$#,##0.00
$#,##0.00;
-$#,##0.00
$0.00E00
$##0.0E0
0%
0.00%
Notes:
The number of 0 that appears in a pattern indicates the minimum digits, show 0 if
that digit is zero. The number of # that appears after the decimal point in a pattern
indicates the maximum digits of decimal, zero shows as absent.
Use ' (single quotation mark) to quote special characters in a prefix or suffix, for
example, '#'# formats 123 to #123. To create the single quote itself, use two in a
row: # o''clock.
Date/Time
yyyy
yy
yyyy G
MM
MMM
MMMMMMMM
dd/MM/yy
dd-MMM-yy
dd-MMM
MMM-yy
MMM yyyy
dd
DDD
ww
EEE
EEEEEE
HH
kk
KK a
Formats a date to hour in am/pm, 0~11, with am/pm marker (00 AM)
hh a
Formats a date to hour in am/pm, 1~12, with am/pm marker (12 AM)
mm
hh:mm a
ss
hh:mm:ss
hh:mm:ss a
mm:ss
MMMMM dd
yyyy G
(EEEEEE) hh:
mm:ss aa z
Formats a date to a full form date, which contains month in year (shown
in full form), days in a month, year, era designator, day in week (shown
in the full form), hour in a day, 1~12, minutes in an hour, second in
minute, am/pm marker, and time zone (December 25 2002 AD
(Wednesday) 12:00:00 AM GMT-08:00).
Notes:
Any characters in the pattern that are not in the ranges of ['a'..'z'] and ['A'..'Z'] will
be treated as quoted text. For instance, characters such as ':', '.', ' ', '#' and '@' will
appear in the resulting time text even they are not embraced within single quotes.
A pattern containing any invalid pattern letter cannot be added to the filter stack.
Text
Mapping
Maps a new value to one value. Type the argument number that you
want to replace, and then specify the new value in the Map to box. For
example, if you want to replace the second data label on the X axis,
which is Thu Jul 04 2002, with a new string US National Day, just type 2
in the Argument# box, type US National Day in the Map to box, and
then click Add to add it to the Filter Stack. If you want to map more
values, repeat this procedure.
Range
Mapping
Text Mapping
Changes the data in the axis data label to a customized string. For
example, if you want to change Chen in the first data label of the X axis
to Jinfonet, type Chen in the Original Text box, type Jinfonet in the Map
to box, and then click Add to add it to the Stack. You can only change
the data one by one. Make sure that your spelling in the Original Text
box is exactly the same as the data shown in the axis label.
Prefix
Adds a string before the text in the data label of the axis. For example,
if you want to add NA before the text in the data label of the X axis,
type NA in the Map to box, and click Add to add it to the Stack.
Suffix
Adds a string behind the text in the data label of the axis. For example,
if you want to add NA behind the text in the data label of the X axis,
type NA in the Map to box, and click Add to add it to the Stack.
Note: The data labels along each axis count from 0, which means the number of the
first data label you see on the axis will be 0, the second will be 1, the third will be 2, etc.
End Caps
Specifies the ending style of the border line. Can be one of the following:
butt
Ends unclosed subpaths and dash segments with no added decoration.
round
Ends unclosed subpaths and dash segments with a round decoration that has a radius equal to half of
the width of the pen.
square
Ends unclosed subpaths and dash segments with a square projection that extends beyond the end of
the segment to a distance equal to half of the line width.
Fill Type
Specifies the fill pattern of an object. Applies to chart platforms, chart paper, chart legends, walls,
floors, axes, tick marks, labels, fonts and icons. Can be one of the following:
none
No fill (default).
color
Fills with a specified color.
texture
Fills with a specified texture.
gradient
Fills with gradient colors.
image
Fills with a specified image (not available for legend icons).
Font Effect
Specifies the special effect for the text. Applies to fonts. Can be one of the following:
none
Does not apply any special effect to the text (default).
embossed
Makes the text appearing as if it is raised off the page.
engraved
Makes the text appearing as if it is imprinted or pressed into the page.
shadowed
Adds a shadow behind, beneath and to the right of the text.
outlined
Displays the inner and outer borders of each character.
shadowed & outlined
Makes the text to be outlined and shadowed.
Font Script
Specifies superscript/subscript form for the text. Applies to fonts. Can be one of the following:
none
Does not apply superscript or subscript form to the text (default).
superscript
Makes the text to be shown above the baseline and changes it to a smaller size.
subscript
Makes the text to be shown below the baseline and changes it to a smaller size.
Font Strikethrough
Specifies the style for the horizontal line with which the text is struck through. Applies to fonts. Can be
one of the following:
none
Does not draw any line through the text (default).
thin Line
Draws a normal line through the text.
bold Line
Draws a bold line through the text.
double Lines
Draws two lines through the text.
Font Underline
Specifies the style for the horizontal line under the text. Applies to fonts. Can be one of the following:
none
No underline (default).
single
Draws a single line under the text.
single lower
Draws a single line under the text at a lower position.
bold line
Draws a bold line under the text.
bold lower
Draws a bold line under the text at a lower position.
double lines
Draws two lines under the text.
bold double
Draws two bold lines under the text.
patterned line
Draws a line under the text, using the pattern of the text font.
bold patterned
Draws a bold line under the text, using the pattern of the text font.
Hyperlink
This property is used to add a hyperlink to the chart that refers to another report or a website. You can
control the hyperlink property with a formula, which will be a good way to get required data from
another report.
For example, you have two report sets A and B in the SampleReports.cat catalog. In report set A, the
data in a banded object is grouped by customer country and a chart is used to illustrate the count of
Customer_ID in every group. Report set B shows the information of customer, such as ID, Name, and
Annual Sales. Now we build a link between the two reports. In JReport Viewer, run report set A, click
the bar of a country, and report set B will appear, only showing the data of the specific country. The
steps are:
1. Copy ReportB.cls and SampleReports.cat to a new folder. Launch JReport Server and publish the
folder to the server.
2. Start JReport Designer and open ReportA.cls. Create a new formula named Link_b. It might be:
string t="http://localhost:8888/jrserver/test/SampleReports.cat/ReportB.cls?
jrs.cmd=jrs.web_vw&jrs.authorization=YWRtaW46YWRtaW4%3D&";
string t1="jrs.param$PCOUNTRY=";
string url=t+t1+"@INNER+&jrs.result_type=1";
return url
Notes:
Make sure that the paths of the catalog and the report set in the URL are corresponding
with their paths on the server.
The built-in parameter INNER is used for representing the category data. In addition, you
can use OUTER for the series data.
For the X HyperLink and Z HyperLink properties, you can use @XDIM and @ZDIM
respectively instead of @INNER and @OUTER.
3. In the Report Inspector, set the Hyperlink property of the chart platform to Link_b.
4. After publishing the report sets and catalog, run report set A, point to a bar and click it, the
corresponding records will be displayed. You can also view the information of the other countries
by clicking the corresponding bars in report set A.
Image Layout
Specifies the layout style of an image. Applies to images. Can be one of the following:
tile
Repeats the image over the entire area (default).
center
Displays the image in the center of the area.
scaled
Stretches the image to cover the entire area.
Line Joint
Specifies the line joint style. Can be one of the following:
miter
Joins path segments by extending their outside edges until they meet.
round
Joins path segments by rounding off the corner at a radius of half the line width.
bevel
Joins path segments by connecting the outer corners of their wide outlines with a straight segment.
joint round
Joins path segments by rounding off the corner at the specified radius.
THEN
Start Offset(1st.Data.Set) = 0
Description
Style1
Use two threshold areas (Threshold Line1 and Threshold Line2) to emphasize the data series
that are higher than the first threshold line or lower than the second threshold line.
Style2
Use a single threshold area (Threshold Line1) to emphasize the data series that are between
the higher and the lower threshold lines.
Crosstab
The properties of a crosstab are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Displays the height of the object, in inches or centimeters. This property is read only.
Width
Displays the width of the object, in inches or centimeters. This property is read only.
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Specifies whether the color defined by the property Pattern List will apply to the fields in
the same rows or columns in the crosstab.
vertical - The value of the property Pattern List will take effect on the fields in the
same columns, except for the total columns.
horizontal - The value of the property Pattern List will take effect on the fields in the
same rows, except for the total rows.
Specifies whether to enable setting alternating line color for the crosstab. Only when it is
set to true, the settings for the properties Direction and Pattern List can take effect.
Data type: Boolean
Pattern List
Specifies the color pattern for the fields in the same rows or columns in the crosstab.
in the value cell and click the small squares in the color tray one by one to
Click
specify the patterns. The patterns can be one or more of the following: Automatic, Color,
Texture, and Gradient.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and when
there are styles in the Style Group that can be applied to the object, or type in the
style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to cache the dataset for this object in the data buffer so other objects
which use the same dataset can share the data rather than perform their own SQL
query.
Data type: Boolean
Specifies the horizontal index of the data block that will be displayed. 0 means the first
block index, and 1 the second, and so on.
The four properties work together to control the data of the crosstab to be displayed in
continuous page mode: Current Row Block Index, Current Column Block Index, Items
per Row Block, and Items per Column Block.
Data type: Integer
Current Row Block Index Specifies the vertical index of the data block that will be displayed. 0 means the first
block index, and 1 the second, and so on.
The four properties work together to control the data of the crosstab to be displayed in
continuous page mode: Current Row Block Index, Current Column Block Index, Items
per Row Block, and Items per Column Block.
Data type: Integer
Enable Navigation
Specifies whether to enable data navigation on the table. This property takes effect for
studio report only. If it is set to true, when the studio report is opened in JReport Studio,
if the table contains more than one page, a navigation bar specific for the table will be
available right below it. You can use the bar to view the desired pages.
When this property is set to true, you can further specify the height and width of the
navigation bar by setting the two properties Navigation Height and Navigation Width.
Data type: Boolean
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Navigation Height
Specifies the height of the navigation bar, which will be displayed when Enable
Navigation is set to true. Enter a numeric value to specify the height.
Data type: Float
Navigation Width
Specifies the width of the navigation bar, which will be displayed when Enable Navigation
is set to true. Enter a numeric value to specify the width.
Data type: Float
Position
Specifies the position of the object. Choose an option from the drop-down list.
static - The object is positioned at the location in which it is inserted. If selected, the
X, Y and other position-related properties will be hidden or disabled. The position of
the object is affected by preceding objects in the same container.
absolute - The object will be located at the position specified by dragging and
dropping or by setting its X and Y property values. The position of the object is not
affected by preceding objects in the same container.
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Specifies whether to display the object in the report results when no record is returned to
it.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned to
its parent data container.
Data type: Boolean
Excel
Column Index
Specifies the X coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Has Border
Crosstab Property
Avoid Orphan Header
Specifies whether to make the column header be together with the data.
Sometimes the column header happens to be at the bottom of a page. To keep the
column header together with the data in the next page, set this property to true.
Data type: Boolean
Block Gap
Specifies the space between each part if the crosstab is split into more than one part.
Data type: Float
Boundary Value
Specifies the number of aggregate fields to be displayed in one column when displayed
vertically, or in one row when displayed horizontally. The left fields will be wordwrapped.
Data type: Integer
Specifies whether to display the Total column in the first column in the crosstab.
Data type: Boolean
Expand Data
Horizontal Gap
Specifies the space between the left/right edge of a crosstab cell and the contents in it.
Data type: Float
Specifies to place the summary labels to the left of the row values if true, right of the
row values if false.
Data type: Boolean
Repeat Aggregate
Specifies whether to display the Total row in the first row of the crosstab.
Data type: Boolean
Suppress Column
Header
Vertical Gap
Specifies the space between the top/bottom edge of a crosstab cell and the contents in
it.
Data type: Float
Vertical Layout
TOC
Indicates whether the aggregate fields are displayed vertically. The property is read only.
Specifies the text for the TOC entry for this object in the TOC browser. By default the
text is the unique object name assigned by JReport Designer. The TOC Anchor property
must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object, which
must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for the
object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of the
object's attribute values and text content.
Data type: String
Summary
It is mapped to the HTML attribute summary. This attribute provides a summary of the
object's purpose and structure.
Data type: String
A crosstab has some child objects, the properties of which will be shown in the following topics:
DBField
Formula field
Label
DBField
The properties of a DBField in a crosstab are:
Property Name
Description
General
Column
Shows the column name of the field in the raw database. This property is read only.
Data Type
Shows the data type of the field. This property is read only.
DBField Name
Shows the mapping name of the field in the catalog. This property is read only.
Field Type
Instance Name
Shows the instance name of the object. This property is read only.
Query
Table
Shows the table name of the field in the raw database. This property is read only.
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. Enter a numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. Enter a numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Foreground
Specifies the foreground color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
ID
Specifies the identifier of the object, which must be unique in the report set. The ID
property value can be a style sheet selector.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and when
there are styles in the Style Group that can be applied to the object, or type in the
style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Shadow
Specifies whether to draw two shadowed borders, beneath and to the right of the object.
Data type: Boolean
Shadow Color
Specifies the color of the shadow. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color in which to draw a pattern to fill the object. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the Pattern Color.
vertical - The pattern will be made of vertical lines of the Pattern Color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the
Pattern Color.
diagonal - The pattern will be made of diagonal lines of the Pattern Color.
Auto Fit
Specifies whether to adjust the width of the object according to the contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Format
Specifies the display format of the text in the report result. It varies with data type and
can be manually defined.
Data type: String
Note: For the BigDecimal type, to avoid precision loss, you should enter a prefix JRD
when setting the format property value.
Horizontal Alignment
Specifies the horizontal justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Specifies whether or not to ignore the HTML tags when exporting the report results to
HTML format.
true - The text will appear in the HTML file the same as that in JReport Designer
(HTML tag elements in the text, if any, will not be parsed).
false - HTML tag elements in the text will be parsed when exporting the report
results to HTML format.
This property is useful for exporting the report results to HTML format. You may want to
write the label contents in HTML tags in your report, and for the exported HTML files, the
tags will be transferred as they are translated into HTML.
Data type: Boolean
Italic
Maximum Width
Specifies the maximum width of the text displayed. Enter a numeric value to change the
width.
Data type: Float
Strikethrough
Underline
Vertical Alignment
Specifies the vertical justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Word Wrap
Others
Cache Value
Specifies whether to cache the value of the field instead of obtaining it repeatedly.
Data type: Boolean
Column Name
Substitutes the current field with another field by selecting from the drop-down list.
To make the property editable, uncheck Forbid changing column in the Options dialog
(File > Options > Panel > Forbid changing column).
Data type: String
Specifies the data mapping file to the object for NLS use.
For example, if the data mapping file name is Category_de_DE.properties, set the value
as Category (without the language and locale part).
Data type: String
Specifies the target window or frame in which to display the detailed information. This
property is enabled only when Go To Detail is set to true. Choose an option from the
drop-down list or directly input the name of the frame you have defined.
<Server Setting>
Loads the detailed information according to setting of the Pop Up New Window for
Links option in the Configure DHTML Profile panel of the Profile dialog in JReport
Server.
New Window
Loads the detailed information into a new window. The window is not named.
Whole Window
Loads the detailed information into the full browser window.
Same Frame
Loads the detailed information into the same frame as the object.
Parent Frame
Loads the detailed information into the parent frame of the frame in which the object
is.
Other Frame
Loads the detailed information into some other specified frame. If the frame name
does not exist, the detailed information will be loaded into a new window.
Enable Hyperlink in Excel Specifies whether to enable the hyperlink when exporting the report to an Excel file.
Data type: Boolean
Enable Hyperlink in
HTML
Specifies whether to enable the hyperlink when exporting the report to an HTML file.
Specifies whether to enable the hyperlink when exporting the report to a PDF file.
Specifies whether to enable JReport Viewer users to expand/collapse the details of the
field which is as dimension (group level) in the crosstab. This property works only in
continuous page mode and when the Expand Data property of the crosstab is set to true.
It is not available for aggregate field.
Data type: Boolean
Specifies whether to display the details of the field by default in DHTML format. This
property works only in continuous page mode, and is not available for aggregate field. It
is meangingful to enable the property only when the field's Expand Data property is set
to true.
Data type: Boolean
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Filter Options
Specifies the filter-related options that will be displayed on the shortcut menu when rightclicking the object in JReport Viewer.
If Default is selected, the filter options displayed are decided by the setting in the Profile
dialog in JReport Server (Profile > Configure DHTML Profile > Properties > Default >
Filter Menu).
For more information, refer to Setting filter options for a field.
Data type: Integer
Go to Detail
Specifies whether to show the detailed information when you click the object in JReport
Viewer. This property is available only when the object is in the group header/footer
panel of a banded object. For details about its usage, refer to Obtaining detailed
information from a banded object.
Data type: Boolean
Link
Specifies to link the object to another report, a website, or an e-mail address. The link is
available when you view the report in HTML, DHTML, PDF, or Excel format, or in JReport
Studio if it is a studio report.
Data type: String
Order By
Specifies the field by which to sort the data. Not available for aggregate field.
Data type: String
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned to
its parent data container.
Data type: Boolean
If true and its value is null, the field will not be displayed.
Data type: Boolean
Transfer Style
Specifies whether the style of the primary report will be applied to the linked report if the
object is linked to a report.
Data type: Boolean
Value Delimiter
Accessibility
Abbr
It is mapped to the HTML attribute abbr. This attribute specifies an abbreviated form of
the content of the object. The abbreviated text may be rendered by user agents when
appropriate in place of the object's content.
Data type: String
Axis
It is mapped to the HTML attribute axis. This attribute is used to place a cell into
conceptual categories that can be considered to form axes in an n-dimensional space.
The value of this attribute is a comma-separated list of category names.
Data type: String
External AccessKey
It is mapped to the HTML attribute accesskey. This attribute specifies an access key to
the object.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External Dir
It is mapped to the HTML attribute dir. This attribute specifies the base direction of
directionally neutral text in the object's content and attribute values. It also specifies the
directionality of tables. Possible values:
It is mapped to the HTML attribute id. This attribute specifies a name to the object, which
must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for the
object.
Data type: String
External TabIndex
It is mapped to the HTML attribute tabindex. This attribute specifies the position of the
object in the tabbing order for the current report. Enter an integer equal to or greater
than 0 and less than 65535.
Data type: Integer
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information about
the object.
Data type: String
Headers
It is mapped to the HTML attribute headers. This attribute specifies the list of header
cells that provide header information for the current data cell. The value of this attribute
is a space-separated list of cell names; those cells must be named by setting their id
attribute.
Data type: String
HrefLang
It is mapped to the HTML attribute hreflang. This attribute specifies the base language of
the resource designated by a link and may only be used when a link is specified.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of the
object's attribute values and text content.
Data type: String
LongDesc
It is mapped to the HTML attribute longdesc. This attribute specifies a link to a long
description of the object.
Data type: String
Scope
It is mapped to the HTML attribute scope. This attribute specifies the set of data cells for
which the current header cell provides header information. Available values are:
Row - The current cell provides header information for the rest of the row that
contains it.
Column - The current cell provides header information for the rest of the column
that contains it.
none - The scope attribute will not be generated when exporting to HTML.
Formula field
The properties of a formula field in a crosstab are:
Property Name
Description
General
Data Type
Shows the data type of the formula. This property is read only.
Expression
Formula Editor
Field Type
Instance Name
Shows the instance name of the object. This property is read only.
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. Enter a numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. Enter a numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Foreground
Specifies the foreground color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
ID
Specifies the identifier of the object, which must be unique in the report set. The ID
property can be a style sheet selector.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Shadow
Specifies whether to draw two shadowed borders, beneath and to the right of the
object.
Data type: Boolean
Shadow Color
Specifies the color of the shadow. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color in which to draw a pattern to fill the object. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the Pattern Color.
vertical - The pattern will be made of vertical lines of the Pattern Color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the
Pattern Color.
diagonal - The pattern will be made of diagonal lines of the Pattern Color.
Auto Fit
Specifies whether to adjust the width of the object according to the contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Format
Specifies the display format of the text in the report result. It varies with data type and
can be manually defined.
Data type: String
Note: For the BigDecimal type, to avoid precision loss, you should enter a prefix JRD
when setting the format property value.
Horizontal Alignment
Specifies the horizontal justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Specifies whether or not to ignore the HTML tags when exporting the report results to
HTML format.
true - The text will appear in the HTML file the same as that in JReport Designer
(HTML tag elements in the text, if any, will not be parsed).
false - HTML tag elements in the text will be parsed when exporting the report
results to HTML format.
This property is useful for exporting the report results to HTML format. You may want to
write the label contents in HTML tags in your report, and for the exported HTML files,
the tags will be transferred as they are translated into HTML.
Data type: Boolean
Italic
Maximum Width
Specifies the maximum width of the text displayed. Enter a numeric value to change the
width.
Data type: Float
Strikethrough
Underline
Vertical Alignment
Specifies the vertical justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Word Wrap
Others
Cache Value
Specifies whether to cache the value of the field instead of obtaining it repeatedly.
Data type: Boolean
Column Name
Substitutes the current field with another field by selecting from the drop-down list.
To make the property editable, uncheck Forbid changing column in the Options dialog
(File > Options > Panel > Forbid changing column).
Data type: String
Specifies the data mapping file to the object for NLS use.
For example, if the data mapping file name is Category_de_DE.properties, set the value
as Category (without the language and locale part).
Data type: String
Specifies the target window or frame in which to display the detailed information. This
property is enabled only when Go To Detail is set to true. Choose an option from the
drop-down list or directly input the name of the frame you have defined.
<Server Setting>
Loads the detailed information according to setting of the Pop Up New Window for
Links option in the Configure DHTML Profile panel of the Profile dialog in JReport
Server.
New Window
Loads the detailed information into a new window. The window is not named.
Whole Window
Loads the detailed information into the full browser window.
Same Frame
Loads the detailed information into the same frame as the object.
Parent Frame
Loads the detailed information into the parent frame of the frame in which the
object is.
Other Frame
Loads the detailed information into some other specified frame. If the frame name
does not exist, the detailed information will be loaded into a new window.
Specifies whether to enable the hyperlink when exporting the report to an Excel file.
Data type: Boolean
Enable Hyperlink in HTML Specifies whether to enable the hyperlink when exporting the report to an HTML file.
Data type: Boolean
Enable Hyperlink in PDF
Specifies whether to enable the hyperlink when exporting the report to a PDF file.
Data type: Boolean
Expand Data
Specifies whether to enable JReport Viewer users to expand/collapse the details of the
field which is as dimension (group level) in the crosstab. This property works only in
continuous page mode and when the Expand Data property of the crosstab is set to
true. It is not available for aggregate field.
Data type: Boolean
Specifies whether to display the details of the field by default in DHTML format. This
property works only in continuous page mode, and is not available for aggregate field.
It is meangingful to enable the property only when the field's Expand Data property is
set to true.
Data type: Boolean
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Filter Options
Specifies the filter-related options that will be displayed on the shortcut menu when
right-clicking the object in JReport Viewer.
If Default is selected, the filter options displayed are decided by the setting in the Profile
dialog in JReport Server (Profile > Configure DHTML Profile > Properties > Default >
Filter Menu).
For more information, refer to Setting filter options for a field.
Data type: Integer
Go to Detail
Specifies whether to show the detailed information when you click the object in JReport
Viewer. This property is available only when the object is in the group header/footer
panel of a banded object. For details about its usage, refer to Obtaining detailed
information from a banded object.
Data type: Boolean
Link
Specifies to link the object to another report, a website, or an e-mail address. The link
is available when you view the report in HTML, DHTML, PDF, or Excel format, or in
JReport Studio if it is a studio report.
Data type: String
Order By
Specifies the field by which to sort the data. Not available for aggregate field.
Data type: String
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
If true and its value is null, the field will not be displayed.
Data type: Boolean
Transfer Style
Specifies whether the style of the primary report will be applied to the linked report if
the object is linked to a report.
Data type: Boolean
Value Delimiter
Accessibility
Abbr
It is mapped to the HTML attribute abbr. This attribute specifies an abbreviated form of
the content of the object. The abbreviated text may be rendered by user agents when
appropriate in place of the object's content.
Data type: String
Axis
It is mapped to the HTML attribute axis. This attribute is used to place a cell into
conceptual categories that can be considered to form axes in an n-dimensional space.
The value of this attribute is a comma-separated list of category names.
Data type: String
External AccessKey
It is mapped to the HTML attribute accesskey. This attribute specifies an access key to
the object.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External Dir
It is mapped to the HTML attribute dir. This attribute specifies the base direction of
directionally neutral text in the object's content and attribute values. It also specifies
the directionality of tables. Possible values:
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External TabIndex
It is mapped to the HTML attribute tabindex. This attribute specifies the position of the
object in the tabbing order for the current report. Enter an integer equal to or greater
than 0 and less than 65535.
Data type: Integer
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information about
the object.
Data type: String
Headers
It is mapped to the HTML attribute headers. This attribute specifies the list of header
cells that provide header information for the current data cell. The value of this attribute
is a space-separated list of cell names; those cells must be named by setting their id
attribute.
Data type: String
HrefLang
It is mapped to the HTML attribute hreflang. This attribute specifies the base language
of the resource designated by a link and may only be used when a link is specified.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
LongDesc
It is mapped to the HTML attribute longdesc. This attribute specifies a link to a long
description of the object.
Data type: String
Scope
It is mapped to the HTML attribute scope. This attribute specifies the set of data cells
for which the current header cell provides header information. Available values are:
Row - The current cell provides header information for the rest of the row that
contains it.
Column - The current cell provides header information for the rest of the column
that contains it.
none - The scope attribute will not be generated when exporting to HTML.
Label
The header of a total row or column, the display name of a column or row field, and the display name
of an aggregate field are represented as labels in the Report Structure panel of the Report Inspector.
Their class types are CTTextField, CTDBTitleField, and CTLabelField respectively. The properties of a
label in a crosstab are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Text Format
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Horizontal Alignment
Specifies the horizontal justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Specifies whether or not to ignore the HTML tags when exporting the report results to
HTML format.
true - The text will appear in the HTML file the same as that in JReport Designer
(HTML tag elements in the text, if any, will not be parsed).
false - HTML tag elements in the text will be parsed when exporting the report
results to HTML format.
This property is useful for exporting the report results to HTML format. You may want to
write the label contents in HTML tags in your report, and for the exported HTML files, the
tags will be transferred as they are translated into HTML.
Data type: Boolean
Italic
Maximum Width
Specifies the maximum width of the text displayed. Enter a numeric value to change the
width.
Data type: Float
Strikethrough
Text
Specifies the text in the label. Enter a string to display as the label text.
Data type: String
Underline
Vertical Alignment
Specifies the vertical justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Word Wrap
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Foreground
Specifies the foreground color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
ID
Specifies the identifier of the object, which must be unique in the report set. The ID
property can be a style sheet selector.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and when
there are styles in the Style Group that can be applied to the object, or type in the
style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Shadow
Specifies whether to draw two shadowed borders, beneath and to the right of the object.
Data type: Boolean
Shadow Color
Specifies the color of the shadow. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color in which to draw a pattern to fill the object. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the Pattern Color.
vertical - The pattern will be made of vertical lines of the Pattern Color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the
Pattern Color.
diagonal - The pattern will be made of diagonal lines of the Pattern Color.
When the label's Sortable or Filterable property is set to true, you need specify a field as
the value so that the records of the field can be sorted or filtered via the proper button
beside the label when viewing the report in DHTML format.
Data type: String
Specifies the target window or frame in which to display the detailed information. This
property is enabled only when Go To Detail is set to true. Choose an option from the
drop-down list or directly input the name of the frame you have defined.
<Server Setting>
Loads the detailed information according to setting of the Pop Up New Window for
Links option in the Configure DHTML Profile panel of the Profile dialog in JReport
Server.
New Window
Loads the detailed information into a new window. The window is not named.
Whole Window
Loads the detailed information into the full browser window.
Same Frame
Loads the detailed information into the same frame as the object.
Parent Frame
Loads the detailed information into the parent frame of the frame in which the object
is.
Other Frame
Loads the detailed information into some other specified frame. If the frame name
does not exist, the detailed information will be loaded into a new window.
Specifies whether to enable the hyperlink when exporting the report to an HTML file.
Specifies whether to enable the hyperlink when exporting the report to a PDF file.
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean.
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Filter Options
Specifies the filter-related options that will be displayed on the shortcut menu when rightclicking the object in JReport Viewer.
If Default is selected, the filter options displayed will be determined by the setting in the
Profile dialog in JReport Server (Profile > Configure DHTML Profile > Properties > Default
> Filter Menu).
For more information, refer to Setting filter options for a field.
Data type: Integer
Filterable
Specifies whether the records can be filtered. If true, a filter button appears beside the
label when viewing the report in DHTML format. You can use the button to filter the
records based on a specific field's value. The field is specified via the Bind Column
property.
Data type: Boolean
Go to Detail
Specifies whether to show the detailed information when you click the object in JReport
Viewer. This property is available only when the object is in the group header/footer
panel of a banded object. For details about its usage, refer to Obtaining detailed
information from a banded object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Link
Specifies to link the object to another report, a website, or an e-mail address. The link is
available when you view the report in HTML, DHTML, PDF, or Excel format, or in JReport
Studio if it is a studio report.
Data type: String
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether the records can be sorted. If true, a sort button appears beside the
label when viewing the report in DHTML format. You can use the button to arrange the
records of a specific field in ascending or descending order. The field is specified via the
Bind Column property.
Data type: Boolean
Suppress
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress Aggregate
Specifies whether to hide the Total row or column. Not applicable for CTLabelField.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned to
its parent data container.
Data type: Boolean
Transfer Style
Specifies whether the style of the primary report will be applied to the linked report if the
object is linked to a report.
Data type: Boolean
Accessibility
Abbr
It is mapped to the HTML attribute abbr. This attribute specifies an abbreviated form of
the content of the object. The abbreviated text may be rendered by user agents when
appropriate in place of the object's content.
Data type: String
Axis
It is mapped to the HTML attribute axis. This attribute is used to place a cell into
conceptual categories that can be considered to form axes in an n-dimensional space.
The value of this attribute is a comma-separated list of category names.
Data type: String
External AccessKey
It is mapped to the HTML attribute accesskey. This attribute specifies an access key to
the object.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External Dir
It is mapped to the HTML attribute dir. This attribute specifies the base direction of
directionally neutral text in the object's content and attribute values. It also specifies the
directionality of tables. Possible values:
It is mapped to the HTML attribute id. This attribute specifies a name to the object, which
must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for the
object.
Data type: String
External TabIndex
It is mapped to the HTML attribute tabindex. This attribute specifies the position of the
object in the tabbing order for the current report. Enter an integer equal to or greater
than 0 and less than 65535.
Data type: Integer
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information about
the object.
Data type: String
Headers
It is mapped to the HTML attribute headers. This attribute specifies the list of header
cells that provide header information for the current data cell. The value of this attribute
is a space-separated list of cell names; those cells must be named by setting their id
attribute.
Data type: String
HrefLang
It is mapped to the HTML attribute hreflang. This attribute specifies the base language of
the resource designated by a link and may only be used when a link is specified.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of the
object's attribute values and text content.
Data type: String
LongDesc
It is mapped to the HTML attribute longdesc. This attribute specifies a link to a long
description of the object.
Data type: String
Scope
It is mapped to the HTML attribute scope. This attribute specifies the set of data cells for
which the current header cell provides header information. Available values are:
Row - The current cell provides header information for the rest of the row that
contains it.
Column - The current cell provides header information for the rest of the column
that contains it.
none - The scope attribute will not be generated when exporting to HTML.
Dataset
The properties of a dataset are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Others
Data Driver
Specifies the cached query result file as the data resource. Usually used for support
purpose.
The input format for cached query result file is as follows: jrquery:/jet.universe.
resultfile.UResultFileResultSet;Fullpath_of_cached_query_result
Data type: String
Maximum Records
Specifies the maximum number of records you want to display for all of the data containers
using this dataset. The default is to display all the records.
Data type: Integer
Query Editor
query as required.
Query Name
Shows the name of the query in use. This property is read only.
Security
Function
Record Security
Specifies the name of the data source security imported from the catalog.
Data type: String
Data Buffer
Maximum Page
Number
Data Driver
This property is usually for support purpose. When you have problems with your report, we need to run
it and reproduce the problem so as to fix it. Sometimes, the database is too large to be sent. If this
property is correctly set, then JReport engine will choose that query file to view the report instead of
using JDBC driver or User Data Source to run the report.
To generate the cached query result, in the Catalog Browser, right-click the query of your report, click
Create Cached Query Result, you can specify the folder and file name with or without extension (.
txt).
Data Buffer
You can improve report performance by setting data buffer size. By default, the size of one data buffer
is 2M. When data exceeds the default size, they will be written on the disk, which will slow down the
data processing. However, you may have enough memory which is much larger than the default buffer
size, so that you can use the memory resource efficiently to achieve better performance. JReport
enables you to set the data buffer size by specifying the two properties: Records per Page and
Maximum Page Number.
When a buffer is defined, JReport divides it into many pages and allocates records to be stored in the
pages. Data will be transferred with the unit of page. The data buffer size is determined by values of
maximum number of pages in the buffer and the number of records in every page. The default
maximum page number in the data buffer is 2048, page size is 1k(1024 bytes).
The value of Maximum Page Number should be changed with different datasets. Generally speaking, it
can be 1 ~ 50.
To view the data buffer information of a report and its subreports, click View > Data Buffer
Information on the menu bar. For details, see Data Buffer Information dialog.
Notes:
The properties should be set according to different databases, namely, different databases may have
different configurations of data buffer.
If the report runs in a different environment, the properties should be specified again.
If the report contains subreports, the data buffer for subreports should also be configured to improve
performance.
As tested, if enough physical memory is available, and you know the total number of records in the
dataset, then you can set Records per Page approximate to the total number of records to achieve
better performance. Maximum Page Number is related to the report, and should not be very large.
The size of data buffer should be less than the available physical memory.
The Heap Size should be set when the data buffer is quite large.
DBField
The properties of a DBField are:
Property Name
Description
General
Column
Shows the column name of the field in the raw database. This property is read only.
Data Type
Shows the data type of the field. This property is read only.
DBField Name
Shows the mapping name of the field in the catalog. This property is read only.
Field Type
Instance Name
Shows the instance name of the object. This property is read only.
Query
Table
Shows the table name of the field in the raw database. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Foreground
Specifies the foreground color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
ID
Specifies the identifier of the object, which must be unique in the report set. The ID
property can be a style sheet selector.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies the X coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Padding
Bottom Padding
Specifies the space between the text and the bottom border of the object. Enter a
numeric value to change the padding.
Data type: Float
Left Padding
Specifies the space between the text and the left border of the object. Enter a numeric
value to change the padding.
Data type: Float
Right Padding
Specifies the space between the text and the right border of the object. Enter a numeric
value to change the padding.
Data type: Float
Top Padding
Specifies the space between the text and the top border of the object. Enter a numeric
value to change the padding.
Data type: Float
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Shadow
Specifies whether to draw two shadowed borders, beneath and to the right of the
object.
Data type: Boolean
Shadow Color
Specifies the color of the shadow. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color in which to draw a pattern to fill the object. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the Pattern Color.
vertical - The pattern will be made of vertical lines of the Pattern Color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the
Pattern Color.
diagonal - The pattern will be made of diagonal lines of the Pattern Color.
Specifies whether to adjust the width and height of the object according to the
contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Format
Specifies the display format of the text in the report result. It varies with data type and
can be manually defined.
Data type: String
Note: For the BigDecimal type, to avoid precision loss, you should enter a prefix JRD
when setting the format property value.
Horizontal Alignment
Specifies the horizontal justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Specifies whether or not to ignore the HTML tags when exporting the report results to
HTML format.
true - The text will appear in the HTML file the same as that in JReport Designer
(HTML tag elements in the text, if any, will not be parsed).
false - HTML tag elements in the text will be parsed when exporting the report
results to HTML format.
This property is useful for exporting the report results to HTML format. You may want to
write the label contents in HTML tags in your report, and for the exported HTML files,
the tags will be transferred as they are translated into HTML.
Data type: Boolean
Italic
Maximum Width
Specifies the maximum width of the text displayed. Enter a numeric value to change the
width.
This property often works with the Auto Fit property. If Auto Fit = true and Maximum
Width is not equal to 0, the text will extend until the width is this value.
Data type: Float
Strikethrough
Underline
Vertical Alignment
Specifies the vertical justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Word Wrap
Others
Cache Value
Specifies whether to cache the value of the field instead of obtaining it repeatedly.
Data type: Boolean
Column Name
Substitutes the current field with another field by selecting from the drop-down list.
To make the property editable, uncheck Forbid changing column in the Options dialog
(File > Options > Panel > Forbid changing column).
Data type: String
Specifies the data mapping file to the object for NLS use.
For example, if the data mapping file name is Category_de_DE.properties, set the value
as Category (without the language and locale part).
Data type: String
Detail Report
Specifies the detail report that the object is linked to. The link is available when the
report is run in DHTML format. For details about how to set up the link, refer to Linking
a report to a detail report.
Data type: String
Specifies the target window or frame in which to display the detailed information. This
property is enabled only when Go To Detail is set to true. Choose an option from the
drop-down list or directly input the name of the frame you have defined.
<Server Setting>
Loads the detailed information according to setting of the Pop Up New Window for
Links option in the Configure DHTML Profile panel of the Profile dialog in JReport
Server.
New Window
Loads the detailed information into a new window. The window is not named.
Whole Window
Loads the detailed information into the full browser window.
Same Frame
Loads the detailed information into the same frame as the object.
Parent Frame
Loads the detailed information into the parent frame of the frame in which the
object is.
Other Frame
Loads the detailed information into some other specified frame. If the frame name
does not exist, the detailed information will be loaded into a new window.
Specifies whether to enable the hyperlink when exporting the report to an Excel file.
Data type: Boolean
Enable Hyperlink in HTML Specifies whether to enable the hyperlink when exporting the report to an HTML file.
Data type: Boolean
Enable Hyperlink in PDF
Specifies whether to enable the hyperlink when exporting the report to a PDF file.
Data type: Boolean
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Filter Options
Specifies the filter-related options that will be displayed on the shortcut menu when
right-clicking the object in JReport Viewer.
If Default is selected, the filter options displayed are decided by the setting in the Profile
dialog in JReport Server (Profile > Configure DHTML Profile > Properties > Default >
Filter Menu).
For more information, refer to Setting filter options for a field.
Data type: Integer
Go to Detail
Specifies whether to show the detailed information when you click the object in JReport
Viewer. This property is available only when the object is in the group header/footer
panel of a banded object. For details about its usage, refer to Obtaining detailed
information from a banded object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Link
Specifies to link the object to another report, a website, or an e-mail address. The link
is available when you view the report in HTML, DHTML, PDF, or Excel format, or in
JReport Studio if it is a studio report.
Data type: String
Logic Column
Specifies whether to show the object in the next visible table cell in the same row when
the column which holds the object is hidden. Choose an option from the drop-down list.
Data type: Enumeration
Notes:
Position
The next visible table cell should be completely empty, that is, the cell should not
hold any content including blank space.
When the property for several objects in the same row is set to next visible column,
and the columns holding these objects are all hidden, then only the object in the
rightmost column will be shown in the next visible cell.
Specifies the position of the object. Choose an option from the drop-down list
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
If true and its value is null, the field will not be displayed.
Data type: Boolean
Transfer Style
Specifies whether the style of the primary report will be applied to the linked report if
the object is linked to a report.
Data type: Boolean
Value Delimiter
TOC
Anchor Display Value
Specifies the text for the TOC entry for this object in the TOC browser. By default the
text is the unique object name assigned by JReport Designer. The TOC Anchor property
must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
Accessibility
External AccessKey
It is mapped to the HTML attribute accesskey. This attribute specifies an access key to
the object.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External Dir
It is mapped to the HTML attribute dir. This attribute specifies the base direction of
directionally neutral text in the object's content and attribute values. It also specifies
the directionality of tables. Possible values:
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External TabIndex
It is mapped to the HTML attribute tabindex. This attribute specifies the position of the
object in the tabbing order for the current report. Enter an integer equal to or greater
than 0 and less than 65535.
Data type: Integer
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information about
the object.
Data type: String
HrefLang
It is mapped to the HTML attribute hreflang. This attribute specifies the base language
of the resource designated by a link and may only be used when a link is specified.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
LongDesc
It is mapped to the HTML attribute longdesc. This attribute specifies a link to a long
description of the object.
Data type: String
Format
This property indicates what will be displayed in the report result. In other words, no matter in what
kind of format the data is stored in the database, you can specify the format in which to display the
result. For example, for a Number-type field about product price, we have the following formats for you
to choose:
#,###
#,###.##
$#,##0.00
...
You select $#,##0.00, and then a value displays as $6.05. You can enter manually as $#,##0.000,
then the value is displayed as $6.050.
Drawing object
In JReport, you can insert five kinds of drawing objects into a report. They are: arcs, boxes, lines, ovals
and round boxes, the properties of which are listed as below:
Arc
Box
Line
Oval
Round box
Arc
The properties of an arc object are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Bottom Attach Pos X
Specifies the horizontal coordinate of the bottom right point of the focus box in a
banded panel. A drawing object can cross panels and the coordinate indicates the
relative position in the involved panel.
Data type: Float
Specifies the vertical coordinate of the bottom right point of the focus box in a banded
panel. A drawing object can cross panels and the coordinate indicates the relative
position in the involved panel.
Data type: Float
Specifies the horizontal coordinate of the top left point of the focus box in a banded
panel. A drawing object can cross panels and the coordinate indicates the relative
position in the involved panel.
Data type: Float
Specifies the vertical coordinate of the top left point of the focus box in a banded
panel. A drawing object can cross panels and the coordinate indicates the relative
position in the involved panel.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies the angle of the arc, in degrees. The value ranges from 0 to 360. As it gets
closer to 360, the arc begins to take on an elliptical shape.
Data type: Float
Border Color
Specifies the color of the object's border. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Style
Specifies the line style of the object's border. Choose an option from the drop-down
list.
Data type: Enumeration
Border Thickness
Start Angle
Specifies the start angle of the arc, in degrees. The value ranges from 0 to 360. At 0,
the vertex of the arc starts at 12:15 clock position. As it gets closer to 360, the arc
travels in a counterclockwise motion.
Data type: Float
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information
about the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Note: When a report set is exported to an HTML/RTF/Excel format file, arcs in it cannot be shown.
There is no such problem for PDF, PS, and other output formats.
Box
The properties of a box object are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Bottom Attach Pos X
Specifies the horizontal coordinate of the bottom right point of the box in a banded
panel. A drawing object can cross panels and the coordinate indicates the relative
position in the involved panel.
Data type: Float
Specifies the vertical coordinate of the bottom right point of the box in a banded panel.
A drawing object can cross panels and the coordinate indicates the relative position in
the involved panel.
Data type: Float
Specifies the horizontal coordinate of the top left point of the box in a banded panel. A
drawing object can cross panels and the coordinate indicates the relative position in the
involved panel.
Data type: Float
Specifies the vertical coordinate of the top left point of the box in a banded panel. A
drawing object can cross panels and the coordinate indicates the relative position in the
involved panel.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Excel
Bottom Attach Column
The four Excel properties, Top Attach Column, Top Attach Row, Bottom Attach Column
and Bottom Attach Row, work together to control the position of a drawing object in the
exported Excel file.
Bottom Attach Column specifies the X coordinate of the lower right corner of the
drawing object in the exported Excel file, measured in cells. The Columned property at
the report level must be set to true for this property to take effect.
Data type: Float
The four Excel properties, Top Attach Column, Top Attach Row, Bottom Attach Column
and Bottom Attach Row, work together to control the position of a drawing object in the
exported Excel file.
Bottom Attach Row specifies the Y coordinate of the lower right corner of the drawing
object in the exported Excel file, measured in cells. The Columned property at the
report level must be set to true for this property to take effect.
Data type: Float
The four Excel properties, Top Attach Column, Top Attach Row, Bottom Attach Column
and Bottom Attach Row, work together to control the position of a drawing object in the
exported Excel file.
Top Attach Column specifies the X coordinate of the upper left corner of the drawing
object in the exported Excel file, measured in cells. The Columned property at the
report level must be set to true for this property to take effect.
Data type: Float
The four Excel properties, Top Attach Column, Top Attach Row, Bottom Attach Column
and Bottom Attach Row, work together to control the position of a drawing object in the
exported Excel file.
Top Attach Row specifies the Y coordinate of the upper left corner of the drawing object
in the exported Excel file, measured in cells. The Columned property at the report level
must be set to true for this property to take effect.
Data type: Float
Box Property
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Style
Specifies the line style of the box border. Choose an option from the drop-down list.
Data type: Enumeration
Border Thickness
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information about
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Line
The properties of a line object are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Bottom Attach Pos X
Specifies the horizontal coordinate of the bottom right point of the line in a banded
panel. A drawing object can cross panels and the coordinate indicates the relative
position in the involved panel.
Data type: Float
Specifies the vertical coordinate of the bottom right point of the line in a banded panel.
A drawing object can cross panels and the coordinate indicates the relative position in
the involved panel.
Data type: Float
Specifies the horizontal coordinate of the top left point of the line in a banded panel. A
drawing object can cross panels and the coordinate indicates the relative position in the
involved panel.
Data type: Float
Specifies the vertical coordinate of the top left point of the line in a banded panel. A
drawing object can cross panels and the coordinate indicates the relative position in the
involved panel.
Data type: Float
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Excel
Bottom Attach Column
The four Excel properties, Top Attach Column, Top Attach Row, Bottom Attach Column
and Bottom Attach Row, work together to control the position of a drawing object in the
exported Excel file.
Bottom Attach Column specifies the X coordinate of the lower right corner of the
drawing object in the exported Excel file, measured in cells. The Columned property at
the report level must be set to true for this property to take effect.
Data type: Float
The four Excel properties, Top Attach Column, Top Attach Row, Bottom Attach Column
and Bottom Attach Row, work together to control the position of a drawing object in the
exported Excel file.
Bottom Attach Row specifies the Y coordinate of the lower right corner of the drawing
object in the exported Excel file, measured in cells. The Columned property at the
report level must be set to true for this property to take effect.
Data type: Float
The four Excel properties, Top Attach Column, Top Attach Row, Bottom Attach Column
and Bottom Attach Row, work together to control the position of a drawing object in the
exported Excel file.
Top Attach Column specifies the X coordinate of the upper left corner of the drawing
object in the exported Excel file, measured in cells. The Columned property at the
report level must be set to true for this property to take effect.
Data type: Float
The four Excel properties, Top Attach Column, Top Attach Row, Bottom Attach Column
and Bottom Attach Row, work together to control the position of a drawing object in the
exported Excel file.
Top Attach Row specifies the Y coordinate of the upper left corner of the drawing object
in the exported Excel file, measured in cells. The Columned property at the report level
must be set to true for this property to take effect.
Data type: Float
Line Property
Line Color
Specifies the color of the line. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Line Style
Specifies the style of the line. Choose an option from the drop-down list.
Data type: Enumeration
Line Thickness
Specifies the thickness of the line. Enter a numeric value to change the thickness.
Data type: Float
Accessibility
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information about
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Note: When a report set is exported to HTML files, the lines in it should be vertical or horizontal lines.
Otherwise, they cannot be shown properly in the HTML file. You should make sure that Top Attach Pos
X = Bottom Attach Pos X or Top Attach Pos Y= Bottom Attach Pos Y. There is no such problem for PDF,
PS, RTF and other output formats.
Oval
The properties of an oval object are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Bottom Attach Pos X
Specifies the horizontal coordinate of the bottom right point of the focus box in a
banded panel. A drawing object can cross panels and the coordinate indicates the
relative position in the involved panel.
Data type: Float
Specifies the vertical coordinate of the bottom right point of the focus box in a banded
panel. A drawing object can cross panels and the coordinate indicates the relative
position in the involved panel.
Data type: Float
Specifies the horizontal coordinate of the top left point of the focus box in a banded
panel. A drawing object can cross panels and the coordinate indicates the relative
position in the involved panel.
Data type: Float
Specifies the vertical coordinate of the top left point of the focus box in a banded panel.
A drawing object can cross panels and the coordinate indicates the relative position in
the involved panel.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Excel
Bottom Attach Column
The four Excel properties, Top Attach Column, Top Attach Row, Bottom Attach Column
and Bottom Attach Row, work together to control the position of a drawing object in the
exported Excel file.
Bottom Attach Column specifies the X coordinate of the lower right corner of the
drawing object in the exported Excel file, measured in cells. The Columned property at
the report level must be set to true for this property to take effect.
Data type: Float
The four Excel properties, Top Attach Column, Top Attach Row, Bottom Attach Column
and Bottom Attach Row, work together to control the position of a drawing object in the
exported Excel file.
Bottom Attach Row specifies the Y coordinate of the lower right corner of the drawing
object in the exported Excel file, measured in cells. The Columned property at the
report level must be set to true for this property to take effect.
Data type: Float
The four Excel properties, Top Attach Column, Top Attach Row, Bottom Attach Column
and Bottom Attach Row, work together to control the position of a drawing object in the
exported Excel file.
Top Attach Column specifies the X coordinate of the upper left corner of the drawing
object in the exported Excel file, measured in cells. The Columned property at the
report level must be set to true for this property to take effect.
Data type: Float
The four Excel properties, Top Attach Column, Top Attach Row, Bottom Attach Column
and Bottom Attach Row, work together to control the position of a drawing object in the
exported Excel file.
Top Attach Row specifies the Y coordinate of the upper left corner of the drawing object
in the exported Excel file, measured in cells. The Columned property at the report level
must be set to true for this property to take effect.
Data type: Float
Oval Property
Border Color
Specifies the color of the object's border. Choose a color from the drop-down list, enter
a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Style
Specifies the line style of the object's border. Choose an option from the drop-down list.
Data type: Enumeration
Border Thickness
Specifies the width of the object's border, in inches or centimeters. Enter a numeric
value to change the thickness.
Data type: Float
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information about
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Note: When a report set is exported to an HTML or RTF format file, ovals in it cannot be shown. There
is no such problem for PDF, PS and other output formats.
Round box
The properties of a round box are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Bottom Attach Pos X
Specifies the horizontal coordinate of the bottom right point of the focus box in a
banded panel. A drawing object can cross panels and the coordinate indicates the
relative position in the involved panel.
Data type: Float
Specifies the vertical coordinate of the bottom right point of the focus box in a banded
panel. A drawing object can cross panels and the coordinate indicates the relative
position in the involved panel.
Data type: Float
Specifies the horizontal coordinate of the top left point of the focus box in a banded
panel. A drawing object can cross panels and the coordinate indicates the relative
position in the involved panel.
Data type: Float
Specifies the vertical coordinate of the top left point of the focus box in a banded panel.
A drawing object can cross panels and the coordinate indicates the relative position in
the involved panel.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Excel
Bottom Attach Column
The four Excel properties, Top Attach Column, Top Attach Row, Bottom Attach Column
and Bottom Attach Row, work together to control the position of a drawing object in the
exported Excel file.
Bottom Attach Column specifies the X coordinate of the lower right corner of the
drawing object in the exported Excel file, measured in cells. The Columned property at
the report level must be set to true for this property to take effect.
Data type: Float
The four Excel properties, Top Attach Column, Top Attach Row, Bottom Attach Column
and Bottom Attach Row, work together to control the position of a drawing object in the
exported Excel file.
Bottom Attach Row specifies the Y coordinate of the lower right corner of the drawing
object in the exported Excel file, measured in cells. The Columned property at the
report level must be set to true for this property to take effect.
Data type: Float
The four Excel properties, Top Attach Column, Top Attach Row, Bottom Attach Column
and Bottom Attach Row, work together to control the position of a drawing object in the
exported Excel file.
Top Attach Column specifies the X coordinate of the upper left corner of the drawing
object in the exported Excel file, measured in cells. The Columned property at the
report level must be set to true for this property to take effect.
Data type: Float
The four Excel properties, Top Attach Column, Top Attach Row, Bottom Attach Column
and Bottom Attach Row, work together to control the position of a drawing object in the
exported Excel file.
Top Attach Row specifies the Y coordinate of the upper left corner of the drawing object
in the exported Excel file, measured in cells. The Columned property at the report level
must be set to true for this property to take effect.
Data type: Float
Specifies the color of the object's border. Choose a color from the drop-down list, enter
a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Style
Specifies the line style of the object's border. Choose an option from the drop-down list.
Data type: Enumeration
Border Thickness
Specifies the width of the object's border, in inches or centimeters. Enter a numeric
value to change the thickness.
Data type: Float
Corner Factor
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information about
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Note: When a report set is exported to an HTML or PS format file, round boxes in it cannot be shown.
There is no such problem for PDF, RTF and other output formats.
Form
The properties of a form are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Form Action
Specifies the URL to which the form content is sent for processing.
Data type: String
Form ID
Form Method
Specifies how to send the form data to the server. Choose an option from the dropdown list.
get - Appends the arguments to the Form Action URL and opens it as if it were an
anchor.
post - Sends the data through an HTTP post transaction.
Form Target
Specifies the window or frame at which to target contents. Choose an option from the
drop-down list.
default - Loads the linked document into the window in which the link is clicked
(the active window). Same as "self".
blank - Loads the linked document into a new blank window. This window is not
named.
media - Loads the linked document into the HTML content area of the Media Bar.
Available in Microsoft Internet Explorer 6 or later.
parent - Loads the linked document into the immediate parent window of the active
window. If there is no parent window, the active window is used.
search - Loads the linked document into the browser search page. Available in
Internet Explorer 5 or later.
self - Loads the linked document into the window in which the link is clicked (the
active window).
top - Loads the linked document into the topmost window.
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information about
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Formula field
The properties of a formula field are:
Property Name
Description
General
Data Type
Shows the data type of the formula. This property is read only.
Expression
Field Type
Formula Editor
required.
Instance Name
Shows the instance name of the object. This property is read only.
Name
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter
a numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter
a numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Foreground
Specifies the foreground color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
ID
Specifies the identifier of the object, which must be unique in the report set. The ID
property can be a style sheet selector.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies the X coordinate of the object relative to its parent container when exported
to Excel or CSV, measured in cells. The Columned property at the report level must be
set to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported
to Excel or CSV, measured in cells. The Columned property at the report level must be
set to true for this property to take effect.
Data type: Integer
Padding
Bottom Padding
Specifies the space between the text and the bottom border of the object. Enter a
numeric value to change the padding.
Data type: Float
Left Padding
Specifies the space between the text and the left border of the object. Enter a numeric
value to change the padding.
Data type: Float
Right Padding
Specifies the space between the text and the right border of the object. Enter a
numeric value to change the padding.
Data type: Float
Top Padding
Specifies the space between the text and the top border of the object. Enter a numeric
value to change the padding.
Data type: Float
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the
drop-down list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Shadow
Specifies whether to draw two shadowed borders, beneath and to the right of the
object.
Data type: Boolean
Shadow Color
Specifies the color of the shadow. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color in which to draw a pattern to fill the object. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the Pattern Color.
vertical - The pattern will be made of vertical lines of the Pattern Color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the
Pattern Color.
diagonal - The pattern will be made of diagonal lines of the Pattern Color.
Specifies whether to adjust the width and height of the object according to the
contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Format
Specifies the display format of the text in the report result. It varies with data type
and can be manually defined.
Data type: String
Note: For the BigDecimal type, to avoid precision loss, you should enter a prefix JRD
when setting the format property value.
Horizontal Alignment
Specifies the horizontal justification of the text in the object. Choose an option from
the drop-down list.
Data type: Enumeration
Specifies whether or not to ignore the HTML tags when exporting the report results to
HTML format.
true - The text will appear in the HTML file the same as that in JReport Designer
(HTML tag elements in the text, if any, will not be parsed).
false - HTML tag elements in the text will be parsed when exporting the report
results to HTML format.
This property is useful for exporting the report results to HTML format. You may want
to write the label contents in HTML tags in your report, and for the exported HTML
files, the tags will be transferred as they are translated into HTML.
Data type: Boolean
Italic
Maximum Width
Specifies the maximum width of the text displayed. Enter a numeric value to change
the width.
This property often works with the Auto Fit property. If Auto Fit = true and Maximum
Width is not equal to 0, the text will extend until the width is this value.
Data type: Float
Strikethrough
Underline
Vertical Alignment
Specifies the vertical justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Word Wrap
Others
Cache Value
Specifies whether to cache the value of the field instead of obtaining it repeatedly.
Data type: Boolean
Column Name
Substitutes the current field with another field by selecting from the drop-down list.
To make the property editable, uncheck Forbid changing column in the Options dialog
(File > Options > Panel > Forbid changing column).
Data type: String
Specifies the data mapping file to the object for NLS use.
For example, if the data mapping file name is Category_de_DE.properties, set the
value as Category (without the language and locale part).
Data type: String
Detail Report
Specifies the detail report that the object is linked to. The link is available when the
report is run in DHTML format. For details about how to set up the link, refer to Linking
a report to a detail report.
Data type: String
Specifies the target window or frame in which to display the detailed information. This
property is enabled only when Go To Detail is set to true. Choose an option from the
drop-down list or directly input the name of the frame you have defined.
<Server Setting>
Loads the detailed information according to setting of the Pop Up New Window for
Links option in the Configure DHTML Profile panel of the Profile dialog in JReport
Server.
New Window
Loads the detailed information into a new window. The window is not named.
Whole Window
Loads the detailed information into the full browser window.
Same Frame
Loads the detailed information into the same frame as the object.
Parent Frame
Loads the detailed information into the parent frame of the frame in which the
object is.
Other Frame
Loads the detailed information into some other specified frame. If the frame name
does not exist, the detailed information will be loaded into a new window.
Specifies whether to enable the hyperlink when exporting the report to an Excel file.
Data type: Boolean
Specifies whether to enable the hyperlink when exporting the report to an HTML file.
Data type: Boolean
Specifies whether to enable the hyperlink when exporting the report to a PDF file.
Data type: Boolean
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This
property is available only when a web control has been inserted into the object.
Data type: Boolean
Filter Options
Specifies the filter-related options that will be displayed on the shortcut menu when
right-clicking the object in JReport Viewer.
If Default is selected, the filter options displayed are decided by the setting in the
Profile dialog in JReport Server (Profile > Configure DHTML Profile > Properties >
Default > Filter Menu).
For more information, refer to Setting filter options for a field.
Data type: Integer
Go to Detail
Specifies whether to show the detailed information when you click the object in
JReport Viewer. This property is available only when the object is in the group header/
footer panel of a banded object. For details about its usage, refer to Obtaining detailed
information from a banded object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Link
Specifies to link the object to another report, a website, or an e-mail address. The link
is available when you view the report in HTML, DHTML, PDF, or Excel format, or in
JReport Studio if it is a studio report.
Data type: String
Logic Column
Specifies whether to show the object in the next visible table cell in the same row
when the column which holds the object is hidden. Choose an option from the dropdown list.
Data type: Enumeration
Notes:
Position
The next visible table cell should be completely empty, that is, the cell should not
hold any content including blank space.
When the property for several objects in the same row is set to next visible
column, and the columns holding these objects are all hidden, then only the object
in the rightmost column will be shown in the next visible cell.
Specifies the position of the object. Choose an option from the drop-down list.
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No Records Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Suppress When Null
If true and its value is null, the field will not be displayed.
Data type: Boolean
Transfer Style
Specifies whether the style of the primary report will be applied to the linked report if
the object is linked to a report.
Data type: Boolean
Value Delimiter
TOC
Anchor Display Value
Specifies the text for the TOC entry for this object in the TOC browser. By default the
text is the unique object name assigned by JReport Designer. The TOC Anchor
property must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
Accessibility
External AccessKey
It is mapped to the HTML attribute accesskey. This attribute specifies an access key to
the object.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External Dir
It is mapped to the HTML attribute dir. This attribute specifies the base direction of
directionally neutral text in the object's content and attribute values. It also specifies
the directionality of tables. Possible values:
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External TabIndex
It is mapped to the HTML attribute tabindex. This attribute specifies the position of the
object in the tabbing order for the current report. Enter an integer equal to or greater
than 0 and less than 65535.
Data type: Integer
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information
about the object.
Data type: String
HrefLang
It is mapped to the HTML attribute hreflang. This attribute specifies the base language
of the resource designated by a link and may only be used when a link is specified.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
LongDesc
It is mapped to the HTML attribute longdesc. This attribute specifies a link to a long
description of the object.
Data type: String
Image
The properties of an image are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
ID
Specifies the identifier of the object, which must be unique in the report set. The ID
property can be a style sheet selector.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies the detail report that the object is linked to. The link is available when the
report is run in DHTML format. For details about how to set up the link, refer to Linking
a report to a detail report.
Data type: String
Specifies the target window or frame in which to display the detailed information. This
property is enabled only when Go To Detail is set to true. Choose an option from the
drop-down list or directly input the name of the frame you have defined.
<Server Setting>
Loads the detailed information according to setting of the Pop Up New Window for
Links option in the Configure DHTML Profile panel of the Profile dialog in JReport
Server.
New Window
Loads the detailed information into a new window. The window is not named.
Whole Window
Loads the detailed information into the full browser window.
Same Frame
Loads the detailed information into the same frame as the object.
Parent Frame
Loads the detailed information into the parent frame of the frame in which the
object is.
Other Frame
Loads the detailed information into some other specified frame. If the frame name
does not exist, the detailed information will be loaded into a new window.
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Go to Detail
Specifies whether to show the detailed information when you click the object in JReport
Viewer. This property is available only when the object is in the group header/footer
panel of a banded object. For details about its usage, refer to Obtaining detailed
information from a banded object.
Data type: Boolean
Horizontal Alignment
Specifies the horizontal alignment of the image in the container. Choose an option from
the drop-down list.
Data type: Enumeration
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Link
Specifies to link the object to another report, a website, or an e-mail address. The link
is available when you view the report in HTML, DHTML, PDF, or Excel format, or in
JReport Studio if it is a studio report.
Data type: String
Logic Column
Specifies whether to show the object in the next visible table cell in the same row when
the column which holds the object is hidden. Choose an option from the drop-down list.
Data type: Enumeration
Notes:
Position
The next visible table cell should be completely empty, that is, the cell should not
hold any content including blank space.
When the property for several objects in the same row is set to next visible column,
and the columns holding these objects are all hidden, then only the object in the
rightmost column will be shown in the next visible cell.
Specifies the position of the object. Choose an option from the drop-down list.
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Transfer Style
Specifies whether the style of the primary report will be applied to the linked report if
the object is linked to a report.
Data type: Boolean
Vertical Alignment
Specifies the vertical alignment of the image in the container. Choose an option from
the drop-down list.
Data type: Enumeration
Excel
Column Index
Specifies the X coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Column Number
Specifies the number of columns which will be the object's width in the exported Excel
file. The Columned property at the report level must be set to true for this property to
take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Row Number
Specifies the number of rows which will be the object's height in the exported Excel file.
The Columned property at the report level must be set to true for this property to take
effect.
Data type: Integer
Image Property
Alternate Text
Specifies the text that will be displayed instead if the image cannot be displayed.
Data type: String
Disabled
Image Name
Specifies the file name of the image. The image can be one on your local file system or
got from a URL.
Data type: String
Name
Rotation
Specifies the angle at which to rotate the image, in degrees. The following is the
meaning of different values:
0 - No rotation.
Specifies the scaling mode of the image, which controls the image behavior when you
try to adjust the image field size. Choose an option from the drop-down list.
actual size - The image will remain its original size. If the image field size is
smaller than the image size, part of the image will be cut off.
fit image - The image size will be automatically adjusted to fill up the image field,
with its original perspective remained but under the limitation of Maximum Scaling
Ratio.
fit width - The image will be automatically adjusted to fit the width of the image
field but under the limitation of Maximum Scaling Ratio.
fit height - The image will be automatically adjusted to fit the height of the image
field but under the limitation of Maximum Scaling Ratio.
customize - The image size will be automatically adjusted to fit the image field,
regardless of the Maximum Scaling Ratio's value.
Specifies the index that defines the tab order for the image.
Data type: Integer
Title
Specifies the tip information about the image, which will be displayed when you hover
the mouse pointer over the image in HTML/DHTML result, or in JReport Studio if the
report is a studio report.
Data type: String
Value
Event
On Blur
On Click
Specifies the action when the user clicks the left mouse button on the object.
Data type: String
On Double Click
On Focus
On Key Down
On Key Press
On Key Up
On Mouse Down
Specifies the action when the user clicks the object with either mouse button.
Data type: String
On Mouse Move
Specifies the action when the user moves the mouse over the object.
Data type: String
On Mouse Out
Specifies the action when the user moves the mouse pointer outside the boundaries of
the object.
Data type: String
On Mouse Over
Specifies the action when the user moves the mouse pointer into the object.
Data type: String
On Mouse Up
Specifies the action when the user releases a mouse button while the mouse is over the
object.
Data type: String
TOC
Anchor Display Value
Specifies the text for the TOC entry for this object in the TOC browser. By default the
text is the unique object name assigned by JReport Designer. The TOC Anchor property
must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
Accessibility
External AccessKey
It is mapped to the HTML attribute accesskey. This attribute specifies an access key to
the object.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
HrefLang
It is mapped to the HTML attribute hreflang. This attribute specifies the base language
of the resource designated by a link and may only be used when a link is specified.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Mapping Name
exit(popwin)
user_exit()
firstPage()
user_firstPage()
lastPage()
user_lastPage()
nextPage()
user_nextPage()
user_oneStepfilter(columnMappingNames, operators,
values, logics, instanceName)
user_oneStepSort(columnMappingNames, orders,
instanceName)
prevPage()
user_prevPage()
redo()
user_redo()
refresh()
user_refresh()
reset()
user_reset(instanceName)
saveRpt()
user_saveRpt()
searchNext(isFindTxt)
saveRst()
showExportExcelDlg()
showExportHTMLDlg()
showExportPDFDlg()
showExportPSDlg()
user_showSaveResultDialog()
showExportRtfDlg()
showExportTextDlg()
showExportXmlDlg()
showFilterPanel()
user_showFilterDialog()
showHelp()
user_showHelp(null)
showNavibar()
showPageSetupDlg()
user_showPageSetupDialog()
showPrintDialog()
user_showPrintDialog()
showSearchDlg()
user_showSearchDialog()
showSortPanel()
user_showSortDialog()
showTOC()
user_showTOC()
showUserPanel()
user_showUserPanel()
undo()
user_undo()
zoom(value)
user_zoomTo(value)
Label
The properties of a label are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Text Format
Auto Fit
Specifies whether to adjust the width and height of the object according to the
contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Horizontal Alignment
Specifies the horizontal justification of the text in the object. Choose an option from
the drop-down list.
Data type: Enumeration
Specifies whether or not to ignore the HTML tags when exporting the report results to
HTML format.
true - The text will appear in the HTML file the same as that in JReport Designer
(HTML tag elements in the text, if any, will not be parsed).
false - HTML tag elements in the text will be parsed when exporting the report
results to HTML format.
This property is useful for exporting the report results to HTML format. You may want
to write the label contents in HTML tags in your report, and for the exported HTML
files, the tags will be transferred as they are translated into HTML.
Data type: Boolean
Italic
Maximum Width
Specifies the maximum width of the text displayed. Enter a numeric value to change
the width.
This property often works with the Auto Fit property. If Auto Fit = true and Maximum
Width is not equal to 0, the text will extend until the width is this value.
Data type: Float
Strikethrough
Text
Specifies the text in the label. Enter a string to display as the label text.
Data type: String
Underline
Vertical Alignment
Specifies the vertical justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Word Wrap
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter
a numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter
a numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Foreground
Specifies the foreground color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
ID
Specifies the identifier of the object, which must be unique in the report set. The ID
property can be a style sheet selector.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies the X coordinate of the object relative to its parent container when exported
to Excel or CSV, measured in cells. The Columned property at the report level must be
set to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported
to Excel or CSV, measured in cells. The Columned property at the report level must be
set to true for this property to take effect.
Data type: Integer
Padding
Bottom Padding
Specifies the space between the text and the bottom border of the object. Enter a
numeric value to change the padding.
Data type: Float
Left Padding
Specifies the space between the text and the left border of the object. Enter a numeric
value to change the padding.
Data type: Float
Right Padding
Specifies the space between the text and the right border of the object. Enter a
numeric value to change the padding.
Data type: Float
Top Padding
Specifies the space between the text and the top border of the object. Enter a numeric
value to change the padding.
Data type: Float
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the
drop-down list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Shadow
Specifies whether to draw two shadowed borders, beneath and to the right of the
object.
Data type: Boolean
Shadow Color
Specifies the color of the shadow. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color in which to draw a pattern to fill the object. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the Pattern Color.
vertical - The pattern will be made of vertical lines of the Pattern Color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the
Pattern Color.
diagonal - The pattern will be made of diagonal lines of the Pattern Color.
When the label's Sortable or Filterable property is set to true, you need specify a field
as the value so that the records of the field can be sorted or filtered via the proper
button beside the label when viewing the report in DHTML format.
Data type: String
Detail Report
Specifies the detail report that the object is linked to. The link is available when the
report is run in DHTML format. For details about how to set up the link, refer to Linking
a report to a detail report.
Data type: String
Specifies the target window or frame in which to display the detailed information. This
property is enabled only when Go To Detail is set to true. Choose an option from the
drop-down list or directly input the name of the frame you have defined.
<Server Setting>
Loads the detailed information according to setting of the Pop Up New Window for
Links option in the Configure DHTML Profile panel of the Profile dialog in JReport
Server.
New Window
Loads the detailed information into a new window. The window is not named.
Whole Window
Loads the detailed information into the full browser window.
Same Frame
Loads the detailed information into the same frame as the object.
Parent Frame
Loads the detailed information into the parent frame of the frame in which the
object is.
Other Frame
Loads the detailed information into some other specified frame. If the frame name
does not exist, the detailed information will be loaded into a new window.
Specifies whether to enable the hyperlink when exporting the report to an Excel file.
Data type: Boolean
Specifies whether to enable the hyperlink when exporting the report to an HTML file.
Data type: Boolean
Specifies whether to enable the hyperlink when exporting the report to a PDF file.
Data type: Boolean
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This
property is available only when a web control has been inserted into the object.
Data type: Boolean
Filter Options
Specifies the filter-related options that will be displayed on the shortcut menu when
right-clicking the object in JReport Viewer.
If Default is selected, the filter options displayed will be determined by the setting in
the Profile dialog in JReport Server (Profile > Configure DHTML Profile > Properties >
Default > Filter Menu).
For more information, refer to Setting filter options for a field.
Data type: Integer
Filterable
Specifies whether the records can be filtered. If true, a filter button appears beside the
label when viewing the report in DHTML format. You can use the button to filter the
records based on a specific field's value. The field is specified via the Bind Column
property.
Data type: Boolean
Go to Detail
Specifies whether to show the detailed information when you click the object in
JReport Viewer. This property is available only when the object is in the group header/
footer panel of a banded object. For details about its usage, refer to Obtaining detailed
information from a banded object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Link
Specifies to link the object to another report, a website, or an e-mail address. The link
is available when you view the report in HTML, DHTML, PDF, or Excel format, or in
JReport Studio if it is a studio report.
Data type: String
Logic Column
Specifies whether to show the object in the next visible table cell in the same row
when the column which holds the object is hidden. Choose an option from the dropdown list.
Data type: Enumeration
Notes:
The next visible table cell should be completely empty, that is, the cell should not
hold any content including blank space.
When the property for several objects in the same row is set to next visible
column, and the columns holding these objects are all hidden, then only the object
in the rightmost column will be shown in the next visible cell.
Position
Specifies the position of the object. Choose an option from the drop-down list.
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether the records can be sorted. If true, a sort button appears beside the
label when viewing the report in DHTML format. You can use the button to arrange the
records of a specific field in ascending or descending order. The field is specified via
the Bind Column property.
Data type: Boolean
Suppress
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No Records Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Transfer Style
Specifies whether the style of the primary report will be applied to the linked report if
the object is linked to a report.
Data type: Boolean
TOC
Anchor Display Value
Specifies the text for the TOC entry for this object in the TOC browser. By default the
text is the unique object name assigned by JReport Designer. The TOC Anchor
property must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
Accessibility
External AccessKey
It is mapped to the HTML attribute accesskey. This attribute specifies an access key to
the object.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External Dir
It is mapped to the HTML attribute dir. This attribute specifies the base direction of
directionally neutral text in the object's content and attribute values. It also specifies
the directionality of tables. Possible values:
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External TabIndex
It is mapped to the HTML attribute tabindex. This attribute specifies the position of the
object in the tabbing order for the current report. Enter an integer equal to or greater
than 0 and less than 65535.
Data type: Integer
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information
about the object.
Data type: String
HrefLang
It is mapped to the HTML attribute hreflang. This attribute specifies the base language
of the resource designated by a link and may only be used when a link is specified.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
LongDesc
It is mapped to the HTML attribute longdesc. This attribute specifies a link to a long
description of the object.
Data type: String
Maximum Width: 1
Auto Fit=true enables the contents to grow horizontally but stop when the width becomes 1. Word
Wrap=true enables the remaining contents to wrap downward if no space is left horizontally.
The following is an example of using the Style, ID, Class property values as style sheet selectors in a
CSS style file:
NewCSSFile.css:
@charset "GBK";
TextField {Background: #ff0000}
/*Style=LabelX*/
TextField[Style="LabelX"]{Background: #0000FF}
/*ID=W*/
TextField#W{Background: #FFFF00}
/*class=C*/
TextField.C{Background: #00FFFF}
Record Location
This property is to specify the calculation point for the properties of the object. Here is an example:
A report specifies to display Continued on Next Page for every page that has another following it. If this
label is inserted in the PageHeader/PageFooter, then every page including the last page will contain the
message. There is a way to write formulas that can resolve the problem:
Continue1:
global boolean j=true;
j=false;
Continue2:
pagenumber;
j=true;
Continue3:
pagenumber;
return j;
Insert Continue1 into the ReportHeader, Continue2 into the ReportFooter. To track the calculation, you
can insert Continue3 into the PageFooter. If you do not want to see these formulas in view mode, you
can suppress them.
Insert label Continued on Next Page in the PageHeader, and use Continue3 to control its property
Invisible.
Set the property Record Location of the above label to be Page Footer, so that Continue3 returns value
which is calculated in the PageFooter instead of in the PageHeader.
Sortable
When you view your report in JReport Viewer, you can sort records in the data buffer on certain
DBFields. You are allowed to use a label to control the sorting order, which can be enabled in JReport
Designer by the Sortable property of the label object.
1. In the Report Inspector, set the Sortable property of this label to true.
2. Bind this label to a field on which you want to sort by setting this field as the value of the Bind
Column property.
3. Save and publish the report set to JReport Server.
4. Run the report set in JReport Viewer, and you will see a sorting button besides the label, which
can be clicked for sorting.
Filterable
When you view your report in JReport Viewer, you can set a series of conditions and use a DHTML
server to filter the data buffer and reproduce the report. You are allowed to use a label to control the
filter conditions for the data, which can be enabled in JReport Designer by the Filterable property of the
label object.
1. In the Report Inspector, set the Filterable property of this label to true.
2. Bind this label to a field on which you want to filter by setting this field as the value of the Bind
Column property.
3. Save the report set and publish it to JReport Server.
4. Run the report set in JReport Viewer. You can click the filtering button beside the label to filter the
data, in the same way as the shortcut menu.
Map
The properties of a map are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Others
Detail Target Frame
Specifies the target window or frame in which to display the detailed information. This
property is enabled only when Go To Detail is set to true. Choose an option from the
drop-down list or directly input the name of the frame you have defined.
<Server Setting>
Loads the detailed information according to setting of the Pop Up New Window for
Links option in the DHTML tab of the Profile dialog in JReport Server.
New Window
Loads the detailed information into a new window. The window is not named.
Whole Window
Loads the detailed information into the full browser window.
Same Frame
Loads the detailed information into the same frame as the object.
Parent Frame
Loads the detailed information into the parent frame of the frame in which the
object is.
Other Frame
Loads the detailed information into some other specified frame. If the frame name
does not exist, the detailed information will be loaded into a new window.
Data type: String
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Go to Detail
Specifies whether to show the detailed information when you click the object in JReport
Viewer. This property is available only when the object is in the group header/footer
panel of a banded object. For details about its usage, refer to Obtaining detailed
information from a banded object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Position
Specifies the position of the object. Choose an option from the drop-down list.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Excel
Column Index
Specifies the X coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Map
Alternate Content Type
Specifies the tip type of all the areas after the report is exported to HTML/DHTML
format. Choose an option from the drop-down list.
name - If selected, names of the areas will be used as the area tips.
value - If selected, the summary values on the areas will be used as the area tips.
If there is more than one value on an area, the summary values will be separated
by comma.
customized - If selected, you can specify the tip for each area via the Alternate
Text property of the area.
Displays the mapping name of the field used as the image source. This property is read
only.
Image Source
Name
TOC
Anchor Display Value
Specifies the text for the TOC entry for this object in the TOC browser. By default the
text is the unique object name assigned by JReport Designer. The TOC Anchor property
must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
A map has some child objects, the properties of which will be shown in the following topics:
Area
Label
Summary field
Line
Area
The properties of a map area are listed as follows. You can set these properties globally for all the map
areas, or respectively for each specific map area.
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Specifies whether to apply the settings that you have set globally for all the map areas
to this object.
true - If selected, the object will take the global settings, and all the properties for
the object will become read only.
false- If selected, the properties for the object can be edited if required.
Specifies the tip of the area which has data after the report is exported to HTML/DHTML
format. This property takes effect only when Alternate Content Type on the map object
is set to customized.
Data type: String
Detail Report
Specifies the detail report that the object is linked to. The link is available when the
report is run in DHTML format. For details about how to set up the link, refer to Linking
a report to a detail report.
Data type: String
Fill Color
Specifies the color with which to fill the area which has records. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Link
Specifies to link the object to another report, a website, or an e-mail address. The link
is available when you view the report in HTML, DHTML, or PDF format.
Data type: String
Name
Shape
Coordinates
Indicates the coordinates of the area for laying out the map. The coordinates are
displayed as: X1,Y1,X2,Y2,X3,Y3,... (X/Y: The X/Y coordinate of one of the polygon's
corner.) This property is read only.
Type
Boundary
Boundary Color
Specifies the color of the area border. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Boundary Style
Specifies the line style of the area border. Choose an option from the drop-down list.
Data type: Enumeration
Boundary Width
Specifies the width of the area border. Enter a numeric value to change the width.
Data type: Float
Accessibility
External AccessKey
It is mapped to the HTML attribute accesskey. This attribute specifies an access key to
the object.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External TabIndex
It is mapped to the HTML attribute tabindex. This attribute specifies the position of the
object in the tabbing order for the current report. Enter an integer equal to or greater
than 0 and less than 65535.
Data type: Integer
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information about
the object.
Data type: String
HrefLang
It is mapped to the HTML attribute hreflang. This attribute specifies the base language
of the resource designated by a link and may only be used when a link is specified.
Data type: String
Label
The properties of a label in a map are listed as follows. You can set these properties globally for all the
labels in a map, or respectively for the label in each specific map area, or for the one independently
inserted in the map object.
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Specifies whether to apply the settings that you have set globally for all labels in the
map to this object.
true - If selected, the object will take the global settings, and all the properties for
the object will become read only.
false- If selected, the properties for the object can be edited if required.
Specifies whether to adjust the width and height of the object according to the
contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Horizontal Alignment
Specifies the horizontal justification of the text in the object. Choose an option from
the drop-down list.
Data type: Enumeration
Italic
Maximum Width
Specifies the maximum width of the text displayed. Enter a numeric value to change
the width.
This property often works with the Auto Fit property. If Auto Fit = true and Maximum
Width is not equal to 0, the text will extend until the width is this value.
Data type: Float
Strikethrough
Text
Specifies the text in the label. Enter a string to display as the label text.
Data type: String
Underline
Vertical Alignment
Specifies the vertical justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Word Wrap
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. Enter a numeric value to change the position in inches or
centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its
parent container. Enter a numeric value to change the position in inches or
centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Foreground
Specifies the foreground color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Padding
Bottom Padding
Specifies the space between the text and the bottom border of the object. Enter a
numeric value to change the padding.
Data type: Float
Left Padding
Specifies the space between the text and the left border of the object. Enter a numeric
value to change the padding.
Data type: Float
Right Padding
Specifies the space between the text and the right border of the object. Enter a
numeric value to change the padding.
Data type: Float
Top Padding
Specifies the space between the text and the top border of the object. Enter a numeric
value to change the padding.
Data type: Float
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the
drop-down list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Shadow
Specifies whether to draw two shadowed borders, beneath and to the right of the
object.
Data type: Boolean
Shadow Color
Specifies the color of the shadow. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color in which to draw a pattern to fill the object. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the Pattern Color.
vertical - The pattern will be made of vertical lines of the Pattern Color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the
Pattern Color.
diagonal - The pattern will be made of diagonal lines of the Pattern Color.
Specifies whether a line between the area and the object will be automatically drawn,
when the object is dragged and dropped out of the area.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Accessibility
External AccessKey
It is mapped to the HTML attribute accesskey. This attribute specifies an access key to
the object.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External Dir
It is mapped to the HTML attribute dir. This attribute specifies the base direction of
directionally neutral text in the object's content and attribute values. It also specifies
the directionality of tables. Possible values:
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External TabIndex
It is mapped to the HTML attribute tabindex. This attribute specifies the position of the
object in the tabbing order for the current report. Enter an integer equal to or greater
than 0 and less than 65535.
Data type: Integer
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information
about the object.
Data type: String
HrefLang
It is mapped to the HTML attribute hreflang. This attribute specifies the base language
of the resource designated by a link and may only be used when a link is specified.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
LongDesc
It is mapped to the HTML attribute longdesc. This attribute specifies a link to a long
description of the object.
Data type: String
Summary field
The properties of a summary field in a map are listed as follows. You can set these properties globally
for all the summary fields in a map, or respectively for the summary field in each specific map area.
Property Name
Description
General
Aggregate Function
Field Type
Group By
Shows the group field that the summary is based on. If null, the summary is grouped
based on the whole dataset. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Summary Name
Summary On
Shows the name of the field on which to perform the summary function. This property is
read only.
Specifies whether to apply the settings that you have set globally for all summary fields
in the map to this object.
true - If selected, the object will take the global settings, and all the properties for
the object will become read only.
false- If selected, the properties for the object can be edited if required.
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. Enter a numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. Enter a numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Foreground
Specifies the foreground color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Padding
Bottom Padding
Specifies the space between the text and the bottom border of the object.
Data type: Float
Left Padding
Specifies the space between the text and the left border of the object.
Data type: Float
Right Padding
Specifies the space between the text and the right border of the object.
Data type: Float
Top Padding
Specifies the space between the text and the top border of the object.
Data type: Float
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Shadow
Specifies whether to draw two shadowed borders, beneath and to the right of the
object.
Data type: Boolean
Shadow Color
Specifies the color of the shadow. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color in which to draw a pattern to fill the object. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the Pattern Color.
vertical - The pattern will be made of vertical lines of the Pattern Color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the
Pattern Color.
diagonal - The pattern will be made of diagonal lines of the Pattern Color.
Auto Fit
Specifies whether to adjust the width and height of the object according to the
contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Format
Specifies the display format of the text in the report result. It varies with data type and
can be manually defined.
Data type: String
Note: For the BigDecimal type, to avoid precision loss, you should enter a prefix JRD
when setting the format property value.
Horizontal Alignment
Specifies the horizontal justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Italic
Maximum Width
Specifies the maximum width of the text displayed. Enter a numeric value to change the
width.
This property often works with the Auto Fit property. If Auto Fit = true and Maximum
Width is not equal to 0, the text will extend until the width is this value.
Data type: Float
Strikethrough
Underline
Vertical Alignment
Specifies the vertical justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Word Wrap
Others
Auto Connector
Specifies whether a line between the area and the object will be automatically drawn,
when the object is dragged and dropped out of the area.
Data type: Boolean
Cache Value
Specifies whether to cache the value of the field instead of obtaining it repeatedly.
Data type: Boolean
Column Name
Substitutes the current field with another field by selecting from the drop-down list.
To make the property editable, uncheck Forbid changing column in the Options dialog
(File > Options > Panel > Forbid changing column).
Data type: String
Specifies the data mapping file to the object for NLS use.
For example, if the data mapping file name is Category_de_DE.properties, set the value
as Category (without the language and locale part).
Data type: String
Display Null
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Accessibility
External AccessKey
It is mapped to the HTML attribute accesskey. This attribute specifies an access key to
the object.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External Dir
It is mapped to the HTML attribute dir. This attribute specifies the base direction of
directionally neutral text in the object's content and attribute values. It also specifies
the directionality of tables. Possible values:
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External TabIndex
It is mapped to the HTML attribute tabindex. This attribute specifies the position of the
object in the tabbing order for the current report. Enter an integer equal to or greater
than 0 and less than 65535.
Data type: Integer
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information about
the object.
Data type: String
HrefLang
It is mapped to the HTML attribute hreflang. This attribute specifies the base language
of the resource designated by a link and may only be used when a link is specified.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
LongDesc
It is mapped to the HTML attribute longdesc. This attribute specifies a link to a long
description of the object.
Data type: String
Line
The properties of a line object in a map are listed as follows:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Others
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed.
Data type: Boolean
Line Property
Line Color
Specifies the color of the line. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Line Style
Specifies the style of the line. Choose an option from the drop-down list.
Data type: Enumeration
Line Thickness
Specifies the thickness of the line. Enter a numeric value to change the thickness.
Data type: Float
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
OLE object
The properties of an OLE object are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Position
Specifies the position of the object. Choose an option from the drop-down list.
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Excel
Column Index
Specifies the X coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Object Property
Access Key
Alternate Text
Specifies the text will be displayed instead if the object cannot be displayed.
Data type: String
Archive
Specifies the character string that can be used to implement your own archive
functionality for the object.
Data type: String
Class ID
Code Base
Specifies the base path used to resolve relative URIs specified by the Class ID and
Archive properties. When null, its default value is the base URI of the current report.
Data type: String
Declare
Specifies whether to make the current object definition a declaration only. The object
must be instantiated by a subsequent object definition referring to this declaration.
Data type: Boolean
Horizontal Space
Name
Stand By
Tab Index
Specifies the index that defines the tab order for the object.
Data type: Integer
Title
Specifies the tip information of the object, which will be displayed when you hover the
mouse pointer over the object after the report is exported to HTML or DHTML.
Data type: String
Type
Specifies the MIME (Multipurpose Internet Mail Extensions) type of the object.
Data type: String
Use Map
Specifies the URL, often with a bookmark extension (#name), to use as a client-side
image map.
Data type: String
Vertical Space
Page panel
The properties of a page panel are:
Property Name Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Paper
Height
Specifies the height of the page in inches or centimeters. The Width and Height values change
when Orientation changes. The Page Type setting determines the Width and Height values but
you can change the latter as desired.
Data type: Float
Orientation
Specifies how to position the report page. The Orientation setting affects the Width and Height
values. Choose an option from the drop-down list.
Specifies the report page dimensions. Choose a size from the drop-down list.
Data type: Enumeration
Width
Specifies the width of the page in inches or centimeters. The Width and Height values change
when Orientation changes. The Page Type setting determines the Width and Height values but
you can change the latter as desired.
Data type: Float
Margin
Bottom Margin
Specifies the distance between the bottom page edge and the data area.
Data type: Float
Left Margin
Specifies the distance between the left page edge and the data area.
Data type: Float
Right Margin
Specifies the distance between the right page edge and the data area.
Data type: Float
Top Margin
Specifies the distance between the top page edge and the data area.
Data type: Float
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Displays the width of the object, in inches or centimeters. This property is read only.
Color
Background
Specifies the background color and fill effect of the object. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000), choose a formula that
returns a color, or select Custom from the drop-down list to specify the color and fill
effect.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to include a horizontal line at the bottom of the panel. This property
applies to panels in table components only. The default is false, which means that no
horizontal line appears at the bottom of the panel.
Data type: Boolean
Suppress
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Specifies whether a panel with no data is included in the report results. The default is
false which means an empty panel is shown.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Underlay
Specifies whether the panel will be layered beneath the next panel in the banded
object. A panel layered beneath a subsequent panel can be used to contain a
background picture or watermark. Banded page header, page footer, or group footer
panels cannot be layered. The default is false which means that the panel is not layered
beneath the next panel.
Data type: Boolean
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Accessibility
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Displays the width of the object, in inches or centimeters. This property is read only.
Color
Background
Specifies the background color and fill effect of the object. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000), choose a formula that
returns a color, or select Custom from the drop-down list to specify the color and fill
effect.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to include a horizontal line at the bottom of the panel. This property
applies to panels in table components only. The default is false, which means that no
horizontal line appears at the bottom of the panel.
Data type: Boolean
Suppress
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Specifies whether a panel with no data is included in the report results. The default is
false which means an empty panel is shown.
Data type: Boolean
If true, the footer panel on the last page will not be displayed.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Underlay
Specifies whether the panel will be layered beneath the next panel in the banded
object. A panel layered beneath a subsequent panel can be used to contain a
background picture or watermark. Banded page header, page footer, or group footer
panels cannot be layered. The default is false which means that the panel is not layered
beneath the next panel.
Data type: Boolean
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Parameter field
The properties of a parameter field are:
Property Name
Description
General
Data Type
Shows the data type of the parameter. This property is read only.
Default Value
Shows the default value of the parameter. This property is read only.
Field Type
Instance Name
Shows the instance name of the object. This property is read only.
Parameter Name
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static.
Enter a numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static.
Enter a numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Foreground
Specifies the foreground color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
CSS
ID
Specifies the identifier of the object, which must be unique in the report set. The ID
property can be a style sheet selector. A String type value.
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS
file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down
list which is available when a Style Group has been selected at the report level
and when there are styles in the Style Group that can be applied to the object,
or type in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name
from the CSS file.
Specifies the X coordinate of the object relative to its parent container when
exported to Excel or CSV, measured in cells. The Columned property at the report
level must be set to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when
exported to Excel or CSV, measured in cells. The Columned property at the report
level must be set to true for this property to take effect.
Data type: Integer
Padding
Bottom Padding
Specifies the space between the text and the bottom border of the object. Enter a
numeric value to change the padding.
Data type: Float
Left Padding
Specifies the space between the text and the left border of the object. Enter a
numeric value to change the padding.
Data type: Float
Right Padding
Specifies the space between the text and the right border of the object. Enter a
numeric value to change the padding.
Data type: Float
Top Padding
Specifies the space between the text and the top border of the object. Enter a
numeric value to change the padding.
Data type: Float
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down
list, enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a
color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the
drop-down list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the
drop-down list.
Data type: Enumeration
Shadow
Specifies whether to draw two shadowed borders, beneath and to the right of the
object.
Data type: Boolean
Shadow Color
Specifies the color of the shadow. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color in which to draw a pattern to fill the object. Choose a color from
the drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a
formula that returns a color.
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the Pattern Color.
vertical - The pattern will be made of vertical lines of the Pattern Color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the
Pattern Color.
diagonal - The pattern will be made of diagonal lines of the Pattern Color.
Specifies whether to adjust the width and height of the object according to the
contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Format
Specifies the display format of the text in the report result. It varies with data type
and can be manually defined.
Data type: String
Note: For the BigDecimal type, to avoid precision loss, you should enter a prefix
JRD when setting the format property value.
Horizontal Alignment
Specifies the horizontal justification of the text in the object. Choose an option from
the drop-down list.
Data type: Enumeration
Specifies whether or not to ignore the HTML tags when exporting the report results
to HTML format.
true - The text will appear in the HTML file the same as that in JReport Designer
(HTML tag elements in the text, if any, will not be parsed).
false - HTML tag elements in the text will be parsed when exporting the report
results to HTML format.
This property is useful for exporting the report results to HTML format. You may
want to write the label contents in HTML tags in your report, and for the exported
HTML files, the tags will be transferred as they are translated into HTML.
Data type: Boolean
Italic
Maximum Width
Specifies the maximum width of the text displayed. Enter a numeric value to change
the width.
This property often works with the Auto Fit property. If Auto Fit = true and
Maximum Width is not equal to 0, the text will extend until the width is this value.
Data type: Float
Strikethrough
Underline
Vertical Alignment
Specifies the vertical justification of the text in the object. Choose an option from
the drop-down list.
Data type: Enumeration
Word Wrap
Others
Data Mapping File
Specifies the data mapping file to the object for NLS use.
For example, if the data mapping file name is Category_de_DE.properties, set the
value as Category (without the language and locale part).
Data type: String
Detail Report
Specifies the detail report that the object is linked to. The link is available when the
report is run in DHTML format. For details about how to set up the link, refer to
Linking a report to a detail report.
Data type: Boolean
Specifies the target window or frame in which to display the detailed information.
This property is enabled only when Go To Detail is set to true. Choose an option
from the drop-down list or directly input the name of the frame you have defined.
<Server Setting>
Loads the detailed information according to setting of the Pop Up New Window
for Links option in the Configure DHTML Profile panel of the Profile dialog in
JReport Server.
New Window
Loads the detailed information into a new window. The window is not named.
Whole Window
Loads the detailed information into the full browser window.
Same Frame
Loads the detailed information into the same frame as the object.
Parent Frame
Loads the detailed information into the parent frame of the frame in which the
object is.
Other Frame
Loads the detailed information into some other specified frame. If the frame
name does not exist, the detailed information will be loaded into a new window.
Specifies whether to enable the hyperlink when exporting the report to an Excel file.
Data type: Boolean
Specifies whether to enable the hyperlink when exporting the report to an HTML file.
Data type: Boolean
Specifies whether to enable the hyperlink when exporting the report to a PDF file.
Data type: Boolean
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This
property is available only when a web control has been inserted into the object.
Data type: Boolean
Go to Detail
Specifies whether to show the detailed information when you click the object in
JReport Viewer. This property is available only when the object is in the group
header/footer panel of a banded object. For details about its usage, refer to
Obtaining detailed information from a banded object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Link
Specifies to link the object to another report, a website, or an e-mail address. The
link is available when you view the report in HTML, DHTML, PDF, or Excel format, or
in JReport Studio if it is a studio report.
Data type: String
Logic Column
Specifies whether to show the object in the next visible table cell in the same row
when the column which holds the object is hidden. Choose an option from the dropdown list.
Data type: Enumeration
Notes:
Position
The next visible table cell should be completely empty, that is, the cell should
not hold any content including blank space.
When the property for several objects in the same row is set to next visible
column, and the columns holding these objects are all hidden, then only the
object in the rightmost column will be shown in the next visible cell.
Specifies the position of the object. Choose an option from the drop-down list.
Substitutes the current parameter with another one by selecting from the drop-down
list.
To make the property editable, uncheck Forbid changing parameter in the Options
dialog (File > Options > Panel > Forbid changing parameter).
Data type: String
Record Location
Specifies the calculation point for the properties which use formulas. Choose an
option from the drop-down list.
Default - The values of the properties are calculated in the default location
where they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and
calculations will be skipped if the property is set to true.
Data type: Boolean
Specifies whether to display the object in the report results when no record is
returned to its parent data container.
Data type: Boolean
If true and its value is null, the field will not be displayed.
Data type: Boolean
Transfer Style
Specifies whether the style of the primary report will be applied to the linked report
if the object is linked to a report.
Data type: Boolean
TOC
Specifies the text for the TOC entry for this object in the TOC browser. By default
the text is the unique object name assigned by JReport Designer. The TOC Anchor
property must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
Accessibility
External AccessKey
It is mapped to the HTML attribute accesskey. This attribute specifies an access key
to the object.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External Dir
It is mapped to the HTML attribute dir. This attribute specifies the base direction of
directionally neutral text in the object's content and attribute values. It also specifies
the directionality of tables. Possible values:
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External TabIndex
It is mapped to the HTML attribute tabindex. This attribute specifies the position of
the object in the tabbing order for the current report. Enter an integer equal to or
greater than 0 and less than 65535.
Data type: Integer
HrefLang
It is mapped to the HTML attribute hreflang. This attribute specifies the base
language of the resource designated by a link and may only be used when a link is
specified.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language
of the object's attribute values and text content.
Data type: String
Report
The properties of a report object are:
Property Name
Description
General
Default Format for Viewing
Report
Specifies the default format with which to view the report on JReport Server. The
default value is to adopt the JReport Server setting. If you select a specific format,
you can click the button
beside to further configure the format settings.
After this property is configured, it will only control the directly-running results of
the report on JReport Server, but has no effect on the results of advanced running
and scheduled running.
<Server Setting>
Adopts the format setting on JReport Server.
DHTML
Specifies to display the report in DHTML format. Studio reports cannot run in
DHTML. Click
Option dialog.
HTML
in the value cell to
Specifies to display the report in HTML format. Click
configure the format settings in the HTML Option dialog.
PDF
in the value cell to
Specifies to display the report in PDF format. Click
configure the format settings in the PDF Option dialog.
Excel
in the value cell to
Specifies to display the report in Excel format. Click
configure the format settings in the Excel Option dialog.
Text
in the value cell to
Specifies to display the report in Text format. Click
configure the format settings in the Text Option dialog.
RTF
in the value cell to
Specifies to display the report in RTF format. Click
configure the format settings in the RTF Option dialog.
XML
in the value cell to
Specifies to display the report in XML format. Click
configure the format settings in the XML Option dialog.
PostScript
in the value cell to
Specifies to display the report in PostScript format. Click
configure the format settings in the PostScript Option dialog.
Applet
in the value cell to
Specifies to display the report in Applet format. Click
configure the format settings in the Applet Option dialog. Studio reports cannot
run in Applet.
Studio Report
Specifies to display the report in JReport Studio. Normal reports cannot run in
Shows the instance name of the object. This property is read only.
Displays the layout type of the report. This property is read only.
Result Buffer
Result Buffer Size
Specifies the number of report results pages which will be stored in the buffer.
Data type: Integer
Data
Automatic Cube Initialization Specifies whether or not to enable the automatic cube conversion.
true - If true, it is to convert the query based report to a report cube based
report automatically when opening the report in JReport Viewer for analytic
reporting purpose. If the converting fails due to error or incomplete conditions,
no warning message will be shown on UI but the information will be recorded
into the log file.
false - If false, the conversion of query to report cube will not be performed
automatically when opening the report in JReport Viewer. Instead, when you are
to perform analytic reporting actions such as drilling on the report, a dialog will
be displayed prompting you to do the conversion.
This property is for exit function usage. You can specify an external application file
(Java class file) which develops an action. The action will be called after you enter
parameters in the pop-up parameter dialog when running the report.
Data type: String
After Run
This property is for exit function usage. You can specify an external application file
(Java class file) which develops an action. The action will be called immediately after
JReport Engine has finished running the report result.
Data type: String
Applet Height
Specifies the applet height for running an exported applet in a web browser.
Data type: Float
Applet Width
Specifies the applet width for running an exported applet in a web browser.
Data type: Float
Before Run
This property is for exit function usage. You can specify an external application file
(Java class file) which develops an action. The action will be called at the point
JReport Engine is about to run the report.
Data type: String
Embedded Fonts
Specifies the True Type Fonts that have been used in the report so as to embed
them if you want to export the report results to a PDF file. You can select multiple
fonts by pressing the Ctrl or Shift key.
For more information, refer to Delivering the result in PDF.
Data type: String
Import JavaScript
Specifies the name of a JavaScript file you develop to apply customized functions in
DHTML, for example, user1.js.
Your JavaScript file should be located in <server_install_root>\public_html
\javascript\dhtml.
Data type: String
No Temp File
Specifies the background color of the report page. Choose a color from the dropdown list, or enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Precision Sensitive
Specifies whether to enable specified precision settings in the report results when
exporting the report to different formats.
Data type: Boolean
Specifies whether or not to show the page header and footer panels of subreports in
the report.
true - The page header and page footer panels of subreports in the report will
be displayed when the panels are set to be visible in the subreports.
false - The page header and page footer panels of subreports in the report will
not be displayed.
Excel
Column Width List
Specifies the width of columns beginning from the first column for the exported
Excel sheet. The Columned property at the report level must be set to true for this
property to take effect.
Use semicolon (;) to separate each width, for example: 12;8;15;10;9
The example specifies the width of the first 5 columns. For the other columns, they
take the default width of Microsoft Excel sheet.
8 indicates the default column width in Microsoft Excel sheet. It can be omitted. The
above example can also be written as 12;;15;10;9
Data type: String
Columned
If true, the engine performance will be improved when exporting the report to CSV
or Excel format.
Only after the Columned property is set to true, it is meaningful to specify values to
the following Excel properties of objects in the report, otherwise the specified values
for these Excel properties cannot take effect.
Specifies the number of report results sheets which will be stored in the buffer when
exporting the report to Excel.
Data type: Integer
Fast Pass
If true, the engine performance will be improved when running the report to CSV
format in multiple threads on JReport Server.
To make fast pass work, the property Columned should be true.
Data type: Boolean
Specifies the maximum number of rows for every worksheet when exporting the
report to Excel.
The value ranges from 0 to 65000. Any value out of the range will be considered as
65000.
Data type: Integer
Sheet Name
Specifies the sheet name for the report when exporting it to Excel. If the report is
split into several sheets when exported to Excel because of limited rows per sheet, a
postfix number will be added to the sheets starting from the second one
(SheetName, SheetName1, SheetName2, SheetName3, ...).
Data type: String
Note: The characters "|", ":", "/", "?", "\", "*", "]", "[" cannot be displayed in the
sheet name in Excel and the last character in the sheet name cannot be single
quotation mark ('). If any one of them is used when you specify the property, it will
be replaced by "_" in Excel.
Pre-sets a style group for use when exporting the report to DHTML. If you do not
specify a value here, the Style Group property value will be applied.
Data type: String
Pre-sets a style group for use when exporting the report to Excel. If you do not
specify a value here, the Style Group property value will be applied.
Data type: String
Pre-sets a style group for use when exporting the report to Fax. If you do not
specify a value here, the Style Group property value will be applied.
Data type: String
Pre-sets a style group for use when exporting the report to HTML. If you do not
specify a value here, the Style Group property value will be applied.
Data type: String
Pre-sets a style group for use when exporting the report to PDF. If you do not
specify a value here, the Style Group property value will be applied.
Data type: String
PS Style Group
Pre-sets a style group for use when exporting the report to PostScript. If you do not
specify a value here, the Style Group property value will be applied.
Data type: String
Pre-sets a style group for use when exporting the report to JReport Result or Applet.
If you do not specify a value here, the Style Group property value will be applied.
Data type: String
Pre-sets a style group for use when exporting the report to RTF. If you do not
specify a value here, the Style Group property value will be applied.
Data type: String
Pre-sets a style group for use when exporting the report to Text. If you do not
specify a value here, the Style Group property value will be applied.
Data type: String
Pre-sets a style group for use when exporting the report to XML. If you do not
specify a value here, the Style Group property value will be applied.
Data type: String
Result buffer
The result buffer is used to store the report results of one report in pages. Its default size 4 indicates 4
pages of a report results have been allocated to the result buffer. The other pages will be stored on
disk. If you have enough memory, you can increase the result buffer size to store more pages of the
report result. By doing this, you will achieve better performance.
Applet setting
Reports are developed in JReport Designer and saved as .cls file. Report files and their associated
resource files (.cat and .fml files) are published to JReport Server for running reports in client/server
mode. Once the report repository is properly set up, it can be accessed with any web browser, JReport
Viewer or Client Viewer Bean. Also, you can choose to export the report results to a printer, a PDF or
TXT file, etc.
If the report results have been specified to be transferred and viewed in the applet format, you can
change the display area by inputting the correct number in the Report Inspector. Alternatively, you can
edit the applet file directly in a text editor.
See also Exporting to Applet for more information about this format.
At any or all of these three points you have the option of executing a class of your choice. JReport has
developed three exit functions for you: After Init Parameter, Before Run and After Run. These functions
enable you to develop an action to be called before, after or during the process of running a report.
Your applications will return true or false. For true, JReport Engine will go on running. For false, JReport
Engine will stop at this point.
Import JavaScript
If you want to develop functions in your own JS file, you can use this property to support the control
objects in DHTML. Your own JS file should be located in <server_install_root>\public_html
\javascript\dhtml, and it will work together with the API.js file in the same folder, but with a higher
priority if both of them contain the same functions.
To use this property, simply set the property value to the name of your JS file.
For example, you have a JavaScript file named "user1.js" which contains the following function:
function promptMassage(message)
{
alert(message);
}
window.promptMassage("test")
In this example, set the property to "user1.js" in order to apply functions defined in the file.
Precision Sensitive
High/low precision
When exporting a report to various formats, the text of some formats will be exported with higher
precision, such as PDF, RTF, Excel, Fax, PS and when printing a report. Thus the report results layouts
of these formats are different from the other formats, such as HTML, DHTML, Applet, XML, and Text.
We distinguish the two types of layouts as PDF view and HTML view.
JReport provides two precision levels: high and low. High precision means that the report layout will be
in the PDF view (the report layout looks like the PDF file). Low precision indicates that the report layout
is in the HTML view (the report layout looks like the HMTL file).
High precision provides better layout but slower efficiency while low precision brings higher
performance but maybe poorer visual effect. If low precision can make the report a well look, it is
reasonable to apply low precision for at the same time faster performance is guaranteed.
About the property
Precision may result in text cut issue in report layout. This property decides whether the report can be
applied to specified precision settings.
JReport has better performance when precision insensitive than when sensitive for it is unnecessary for
the engine to run a report again since precision does not changes.
When the property is set to true, specified precision settings can be applied to the report when
exporting it to different formats. In JReport Designer, report designer can specify precision level for
different export formats using the Advanced Export Settings dialog. In JReport Server, administrators
can go to JReport Administration Page > Configuration > Export > Layout Precision to specify
precision settings.
If you do not care visual effect of the report, leave the value of the property to be false as default and
let JReport deal with the precision.
When the property is set to false, any specified precision setting for exporting formats does not work in
the report. Instead the contextual precision level is applied when viewing/running/exporting the report.
The context precision depends on the precision level applied when viewing/running/exporting the report
last time. That is to say, the current runtime uses the precision setting applied in last runtime. When it
is the first time to view/run/export the report in a format, there are default initial precision settings
available for adoption since there is no context for the first runtime. The following table lists the default
initial precision settings for different formats:
Format
Default Initial
Precision
High
HTML
Low
RTF
High
Excel
High
Fax
High
PostScript
High
Print to Printer
High
Low
XML
Low
Text
Low
RSD
Low
RST
Low
Columned
Right after you set the property to true from false each time:
Recalculate the values of the following Excel properties of all objects in the report and reset the
values to the defaults.
Column Number/Row Number. The properties are for images and UDOs.
Top Attach Column/Top Attach Row/Bottom Attach Column/Bottom Attach Row. The properties are
for drawing objects.
The default values are calculated based on the position of each object in the report. There is an
exception: if both the Export to Excel and Export to CSV properties of an object are false, the values
of these properties will not be recalculated and will be preserved as before.
Use the columned method to export the report to Excel when the option Normal Formatting in the
Export to Excel dialog is checked.
You can specify values for the Excel properties mentioned above of an object instead of using the
default.
The specified values for the above Excel properties of objects in the report are not applied when
exporting to CSV or Excel.
Report body
The properties of the report body are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Color
Background
Specifies the background color and fill effect of the object. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000), choose a formula that
returns a color, or select Custom from the drop-down list to specify the color and fill
effect.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to display the object in the report results when no record is returned
to it.
Data type: Boolean
Excel
Column Index
Specifies the X coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
TOC
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Report set
A report set may contain one or more reports, and each report contain a report body. The Report
Inspector enables you to focus on one of the three levels, namely the report set, report, and report
body. By default, the root node in the Report Inspector represents the current report. You can click the
Up button
on the toolbar to show the report set as the root node (if the current root node
represents the report body, you should click that button twice). After showing the report set node in
the Report Inspector, you can set its properties:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Others
Import Parameter Values
Specifies the name of a class file from which to import default values for parameters
used in the report set, for example, help.TestParamList. Then when viewing the report
set, the displayed Enter Parameter Values dialog will only list the imported default
parameters.
To make the property work, you need specify the Parameter List Auto property to false.
For more information, see Importing parameter values.
Data type: String
Specifies whether to get the default values for parameters used in the report set from
values defined in the catalog.
Special field
The properties of a special field are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Foreground
Specifies the foreground color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
ID
Specifies the identifier of the object, which must be unique in the report set. The ID
property can be a style sheet selector.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Column Index
Specifies the X coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Padding
Bottom Padding
Specifies the space between the text and the bottom border of the object. Enter a
numeric value to change the padding.
Data type: Float
Left Padding
Specifies the space between the text and the left border of the object. Enter a numeric
value to change the padding.
Data type: Float
Right Padding
Specifies the space between the text and the right border of the object. Enter a numeric
value to change the padding.
Data type: Float
Top Padding
Specifies the space between the text and the top border of the object. Enter a numeric
value to change the padding.
Data type: Float
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Shadow
Specifies whether to draw two shadowed borders, beneath and to the right of the
object.
Data type: Boolean
Shadow Color
Specifies the color of the shadow. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color in which to draw a pattern to fill the object. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the Pattern Color.
vertical - The pattern will be made of vertical lines of the Pattern Color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the
Pattern Color.
diagonal - The pattern will be made of diagonal lines of the Pattern Color.
Specifies whether to adjust the width and height of the object according to the
contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Format
Specifies the display format of the text in the report result. It varies with data type and
can be manually defined.
Data type: String
Note: For the BigDecimal type, to avoid precision loss, you should enter a prefix JRD
when setting the format property value.
Horizontal Alignment
Specifies the horizontal justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Specifies whether or not to ignore the HTML tags when exporting the report results to
HTML format.
true - The text will appear in the HTML file the same as that in JReport Designer
(HTML tag elements in the text, if any, will not be parsed).
false - HTML tag elements in the text will be parsed when exporting the report
results to HTML format.
This property is useful for exporting the report results to HTML format. You may want to
write the label contents in HTML tags in your report, and for the exported HTML files,
the tags will be transferred as they are translated into HTML.
Data type: Boolean
Italic
Maximum Width
Specifies the maximum width of the text displayed. Enter a numeric value to change the
width.
This property often works with the Auto Fit property. If Auto Fit = true and Maximum
Width is not equal to 0, the text will extend until the width is this value.
Data type: Float
Strikethrough
Underline
Vertical Alignment
Specifies the vertical justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Word Wrap
Others
Data Evaluation Setting
Specifies the group information for the object. Available only for the group by fields in
table group columns. Choose an option from the drop-down list.
current column
The object will take value of the group by field in the current column.
current row
The object will take value of the group by field in the current row.
Specifies the detail report that the object is linked to. The link is available when the
report is run in DHTML format. For details about how to set up the link, refer to Linking
a report to a detail report.
Data type: String
Specifies the target window or frame in which to display the detailed information. This
property is enabled only when Go To Detail is set to true. Choose an option from the
drop-down list or directly input the name of the frame you have defined.
<Server Setting>
Loads the detailed information according to setting of the Pop Up New Window for
Links option in the Configure DHTML Profile panel of the Profile dialog in JReport
Server.
New Window
Loads the detailed information into a new window. The window is not named.
Whole Window
Loads the detailed information into the full browser window.
Same Frame
Loads the detailed information into the same frame as the object.
Parent Frame
Loads the detailed information into the parent frame of the frame in which the
object is.
Other Frame
Loads the detailed information into some other specified frame. If the frame name
does not exist, the detailed information will be loaded into a new window.
Specifies whether to enable the hyperlink when exporting the report to an Excel file.
Data type: Boolean
Enable Hyperlink in HTML Specifies whether to enable the hyperlink when exporting the report to an HTML file.
Data type: Boolean
Enable Hyperlink in PDF
Specifies whether to enable the hyperlink when exporting the report to a PDF file.
Data type: Boolean
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Field Type
Specifies another special field format to substitute the current special field. Choose an
option from the drop-down list.
Data type: Enumeration
Go to Detail
Specifies whether to show the detailed information when you click the object in JReport
Viewer. This property is available only when the object is in the group header/footer
panel of a banded object. For details about its usage, refer to Obtaining detailed
information from a banded object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Link
Specifies to link the object to another report, a website, or an e-mail address. The link
is available when you view the report in HTML, DHTML, PDF, or Excel format.
Data type: String
Logic Column
Specifies whether to show the object in the next visible table cell in the same row when
the column which holds the object is hidden. Choose an option from the drop-down list.
Data type: Enumeration
Notes:
The next visible table cell should be completely empty, that is, the cell should not
hold any content including blank space.
When the property for several objects in the same row is set to next visible column,
and the columns holding these objects are all hidden, then only the object in the
rightmost column will be shown in the next visible cell.
Position
Specifies the position of the object. Choose an option from the drop-down list.
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to repeat the group name in the report results. This property is
available only for the group by fields in table, and it takes effect only when the group by
fields are in the table detail row.
Data type: Boolean
Suppress
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Transfer Style
Specifies whether the style of the primary report will be applied to the linked report if
the object is linked to a report.
Data type: Boolean
TOC
Anchor Display Value
Specifies the text for the TOC entry for this object in the TOC browser. By default the
text is the unique object name assigned by JReport Designer. The TOC Anchor property
must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
Accessibility
External AccessKey
It is mapped to the HTML attribute accesskey. This attribute specifies an access key to
the object.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External Dir
It is mapped to the HTML attribute dir. This attribute specifies the base direction of
directionally neutral text in the object's content and attribute values. It also specifies
the directionality of tables. Possible values:
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External TabIndex
It is mapped to the HTML attribute tabindex. This attribute specifies the position of the
object in the tabbing order for the current report. Enter an integer equal to or greater
than 0 and less than 65535.
Data type: Integer
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information about
the object.
Data type: String
HrefLang
It is mapped to the HTML attribute hreflang. This attribute specifies the base language
of the resource designated by a link and may only be used when a link is specified.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
LongDesc
It is mapped to the HTML attribute longdesc. This attribute specifies a link to a long
description of the object.
Data type: String
Subreport
The properties of a subreport are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter
a numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter
a numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Cache
Specifies whether to cache the dataset for this object in the data buffer so other
objects which use the same dataset can share the data rather than perform their own
SQL query.
Data type: Boolean
Embedded
If false, the page header and footer of the subreport will not be shown.
Data type: Boolean
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This
property is available only when a web control has been inserted into the object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Position
Specifies the position of the object. Choose an option from the drop-down list.
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Displays the name of the data source used by the subreport. If nothing is displayed,
the default data source will be used. This property is read only.
Displays the name of the query used by the subreport. This property is read only.
Displays the security name (record level security) used by the subreport. This property
is read only.
Suppress
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Specifies whether to display the object in the report results when no record is returned
to it.
Data type: Boolean
Suppress When No Records Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Excel
Column Index
Specifies the X coordinate of the object relative to its parent container when exported
to Excel or CSV, measured in cells. The Columned property at the report level must be
set to true for this property to take effect.
Data type: Integer
On New Sheet
Specifies whether to put the subreport in a new sheet when exporting the report to
Excel.
Data type: Boolean
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported
to Excel or CSV, measured in cells. The Columned property at the report level must be
set to true for this property to take effect.
Data type: Integer
Sheet Name
Specifies the name of the new sheet in which the subreport will be put. Make sure the
name specified here isn't used by any other sheets.
It is meaningful to specify the property value when the On New Sheet property is set
to true.
Data type: String
Note: The characters "|", ":", "/", "?", "\", "*", "]", "[" cannot be displayed in the
sheet name in Excel and the last character in the sheet name cannot be single
quotation mark ('). If any one of them is used when you specify the property, it will be
replaced by "_" in Excel.
Specifies how to add postfix number to the sheets in which the subreport will be put
when exporting the report to Excel. Choose an option from the drop-down list.
Add postfix number to every page - Specifies to add the postfix number to
every sheet for the subreport (Subreport1, Subreport2, Subreport3,
Subreport4, ...).
Add postfix number only to additional pages - Specifies to add the postfix
number to the subreport sheets starting from the second one (Subreport,
Subreport1, Subreport2, Subreport3, ...).
It is meaningful to specify the property value when the On New Sheet property is set
to true.
Data type: Enumeration
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the
drop-down list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
TOC
Anchor Display Value
Specifies the text for the TOC entry for this object in the TOC browser. By default the
text is the unique object name assigned by JReport Designer. The TOC Anchor
property must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Cache
In a report, when the subreport needs to be run more than once, set the property Cache to true. The
data of the subreport will be cached in the data buffer. When the subreport is run the next time, the
sub-engine will retrieve the data from the data buffer instead of DBMS, and if sub-link exists, it will also
be calculated in the data buffer, thus improving the engine performance.
When a data buffer is defined in the sub-engine, the data buffer is divided into many pages and records
are allocated in the pages. You can use the properties Records per Page and Maximum Page Number to
set the number of the records in one page and the maximum number of pages in the data buffer. If
enough physical memory is available and you know the total number of records in the subreport, to
achieve better performance, you can set Records per Page approximate to the total number of records.
Note: The Cache property will not work in the following cases:
When the parameter is displayed in the Parameters in subreport tab which is contained in the query
of the subreport.
Summary field
The properties of a summary field are:
Property Name
Description
General
Aggregate Function
Field Type
Group By
Shows the group field that the summary is based on. If null, the summary is grouped
based on the whole dataset. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Name
Summary On
Shows the name of the field on which to perform the summary function. This property is
read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Foreground
Specifies the foreground color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
ID
Specifies the identifier of the object, which must be unique in the report set. The ID
property can be a style sheet selector.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies the X coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Padding
Bottom Padding
Specifies the space between the text and the bottom border of the object.
Data type: Float
Left Padding
Specifies the space between the text and the left border of the object.
Data type: Float
Right Padding
Specifies the space between the text and the right border of the object.
Data type: Float
Top Padding
Specifies the space between the text and the top border of the object.
Data type: Float
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Shadow
Specifies whether to draw two shadowed borders, beneath and to the right of the
object.
Data type: Boolean
Shadow Color
Specifies the color of the shadow. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color in which to draw a pattern to fill the object. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that
returns a color.
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the Pattern Color.
vertical - The pattern will be made of vertical lines of the Pattern Color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the
Pattern Color.
diagonal - The pattern will be made of diagonal lines of the Pattern Color.
Specifies whether to adjust the width and height of the object according to the
contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Format
Specifies the display format of the text in the report result. It varies with data type and
can be manually defined.
Data type: String
Note: For the BigDecimal type, to avoid precision loss, you should enter a prefix JRD
when setting the format property value.
Horizontal Alignment
Specifies the horizontal justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Specifies whether or not to ignore the HTML tags when exporting the report results to
HTML format.
true - The text will appear in the HTML file the same as that in JReport Designer
(HTML tag elements in the text, if any, will not be parsed).
false - HTML tag elements in the text will be parsed when exporting the report
results to HTML format.
This property is useful for exporting the report results to HTML format. You may want to
write the label contents in HTML tags in your report, and for the exported HTML files,
the tags will be transferred as they are translated into HTML.
Data type: Boolean
Italic
Maximum Width
Specifies the maximum width of the text displayed. Enter a numeric value to change the
width.
This property often works with the Auto Fit property. If Auto Fit = true and Maximum
Width is not equal to 0, the text will extend until the width is this value.
Data type: Float
Strikethrough
Underline
Vertical Alignment
Specifies the vertical justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Word Wrap
Others
Cache Value
Specifies whether to cache the value of the field instead of obtaining it repeatedly.
Data type: Boolean
Column Name
Substitutes the current field with another field by selecting from the drop-down list.
To make the property editable, uncheck Forbid changing column in the Options dialog
(File > Options > Panel > Forbid changing column).
Data type: String
Specifies the data mapping file to the object for NLS use.
For example, if the data mapping file name is Category_de_DE.properties, set the value
as Category (without the language and locale part).
Data type: String
Detail Report
Specifies the detail report that the object is linked to. The link is available when the
report is run in DHTML format. For details about how to set up the link, refer to Linking
a report to a detail report.
Data type: String
Specifies the target window or frame in which to display the detailed information. This
property is enabled only when Go To Detail is set to true. Choose an option from the
drop-down list or directly input the name of the frame you have defined.
<Server Setting>
Loads the detailed information according to setting of the Pop Up New Window for
Links option in the Configure DHTML Profile panel of the Profile dialog in JReport
Server.
New Window
Loads the detailed information into a new window. The window is not named.
Whole Window
Loads the detailed information into the full browser window.
Same Frame
Loads the detailed information into the same frame as the object.
Parent Frame
Loads the detailed information into the parent frame of the frame in which the
object is.
Other Frame
Loads the detailed information into some other specified frame. If the frame name
does not exist, the detailed information will be loaded into a new window.
Display Null
Specifies whether to enable the hyperlink when exporting the report to an Excel file.
Data type: Boolean
Enable Hyperlink in HTML Specifies whether to enable the hyperlink when exporting the report to an HTML file.
Data type: Boolean
Enable Hyperlink in PDF
Specifies whether to enable the hyperlink when exporting the report to a PDF file.
Data type: Boolean
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Filter Options
Specifies the filter-related options that will be displayed on the shortcut menu when
right-clicking the object in JReport Viewer.
If Default is selected, the filter options displayed are decided by the setting in the Profile
dialog in JReport Server (Profile > Configure DHTML Profile > Properties > Default >
Filter Menu).
For more information, refer to Setting filter options for a field.
Data type: Integer
Go to Detail
Specifies whether to show the detailed information when you click the object in JReport
Viewer. This property is available only when the object is in the group header/footer
panel of a banded object. For details about its usage, refer to Obtaining detailed
information from a banded object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Link
Specifies to link the object to another report, a website, or an e-mail address. The link
is available when you view the report in HTML, DHTML, PDF, or Excel format, or in
JReport Studio if it is a studio report.
Data type: String
Logic Column
Specifies whether to show the object in the next visible table cell in the same row when
the column which holds the object is hidden. Choose an option from the drop-down list.
Data type: Enumeration
Notes:
The next visible table cell should be completely empty, that is, the cell should not
hold any content including blank space.
When the property for several objects in the same row is set to next visible column,
and the columns holding these objects are all hidden, then only the object in the
rightmost column will be shown in the next visible cell.
Position
Specifies the position of the object. Choose an option from the drop-down list.
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
If true and its value is null, the field will not be displayed.
Data type: Boolean
Transfer Style
Specifies whether the style of the primary report will be applied to the linked report if
the object is linked to a report.
Data type: Boolean
Value Delimiter
TOC
Anchor Display Value
Specifies the text for the TOC entry for this object in the TOC browser. By default the
text is the unique object name assigned by JReport Designer. The TOC Anchor property
must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
Accessibility
External AccessKey
It is mapped to the HTML attribute accesskey. This attribute specifies an access key to
the object.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External Dir
It is mapped to the HTML attribute dir. This attribute specifies the base direction of
directionally neutral text in the object's content and attribute values. It also specifies
the directionality of tables. Possible values:
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External TabIndex
It is mapped to the HTML attribute tabindex. This attribute specifies the position of the
object in the tabbing order for the current report. Enter an integer equal to or greater
than 0 and less than 65535.
Data type: Integer
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information about
the object.
Data type: String
HrefLang
It is mapped to the HTML attribute hreflang. This attribute specifies the base language
of the resource designated by a link and may only be used when a link is specified.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
LongDesc
It is mapped to the HTML attribute longdesc. This attribute specifies a link to a long
description of the object.
Data type: String
Table
The properties of a table are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Auto Expands
Specifies whether the objects in cells of the table will be expanded to their neighbouring
cells horizontally when the actual size of the objects is bigger than the cells'. The
property takes effect only when the property Auto Fit for the objects in the table cells is
set to true.
Data type: Boolean
Notes:
Cache
An object in a table cell could cover one or more neighbouring cells according to its
size.
When the neighbouring cell is occupied or merged, the property does not take effect.
Specifies whether to cache the dataset for this object in the data buffer so other objects
which use the same dataset can share the data rather than perform their own SQL
query.
Data type: Boolean
Enable Navigation
Specifies whether to enable data navigation on the table. This property takes effect for
studio report only. If it is set to true, when the studio report is opened in JReport
Studio, if the table contains more than one page, a navigation bar specific for the table
will be available right below it. You can use the bar to view the desired pages.
When this property is set to true, you can further specify the height and width of the
navigation bar by setting the two properties Navigation Height and Navigation Width.
Data type: Boolean
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Freeze Field
Specifies whether to disable fields from being selected in the design area.
Data type: Boolean
Horizontal
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Navigation Height
Specifies the height of the navigation bar, which will be displayed when Enable
Navigation is set to true. Enter a numeric value to specify the height.
Data type: Float
Navigation Width
Specifies the width of the navigation bar, which will be displayed when Enable
Navigation is set to true. Enter a numeric value to specify the width.
Data type: Float
Position
Specifies the position of the object. Choose an option from the drop-down list.
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Specifies whether to display the object in the report results when no record is returned
to it.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
TOC
Anchor Display Value
Specifies the text for the TOC entry for this object in the TOC browser. By default the
text is the unique object name assigned by JReport Designer. The TOC Anchor property
must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
Summary
It is mapped to the HTML attribute summary. This attribute provides a summary of the
object's purpose and structure.
Data type: String
Table group
Table column
Table cell
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Color
Background
Specifies the background color and fill effect of the object. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000), choose a formula that
returns a color, or select Custom from the drop-down list to specify the color and fill
effect.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Label
Specifies the popup text displayed when the mouse pointer hovers over the left edge of
the row.
Data type: String
On New Page
Specifies whether the row starts on a new page. This property is only applied if the
report has page layout enabled. The default is false which means the row starts on a
new page only if the previous page is filled.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to make the object appear in every page of the report results when
exporting the report to Excel.
Data type: Boolean
Specifies whether to make the object appear in every page of the report results when
exporting the report to a .txt file.
Data type: Boolean
Specifies whether to make the object appear in every page of the report results when
exporting the report to XML.
Data type: Boolean
Repeat on Pages
Specifies whether to make the object appear in every page of the report results.
Data type: Boolean
Suppress
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Table group
The properties of a table group are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Group By
Shows the group field that the object is based on. If null, the object is grouped based
on the whole dataset. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Others
Current Block Index
The two properties, Current Block Index and Items per Block, work together to control
the data of the object to be displayed in continuous page mode.
Current Block Index specifies the index of the data block that will be displayed. 0
means the first block index, and 1 the second, and so on.
Data type: Integer
The two properties, Current Block Index and Items per Block, work together to control
the data of the object to be displayed in continuous page mode.
Item per Block specifies the number of records in each data block.
Data type: Integer
Group Layout
Keep Group Together
TOC
Anchor Display Value
Specifies the text for the TOC entry for this object in the TOC browser. By default the
text is the unique object name assigned by JReport Designer. The TOC Anchor
property must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report. A Boolean
type value.
Security
Cascade
Specifies whether to allow the security identifiers specified by the following three
properties to view the group's detail or child groups.
true - The detail row, the group header row, and the group footer row will be
displayed.
false - Only the group header and footer rows will be displayed.
Enables to set cached report bursting. The property accepts user names delimited by
"|" as the value. You can specify which group of data can be viewed by which user.
Data type: String
Groups
Enables to set cached report bursting. The property accepts group names delimited by
"|" as the value. You can specify which group of data can be viewed by which group of
users.
Data type: String
Roles
Enables to set cached report bursting. The property accepts role names delimited by
"|" as the value. You can specify which group of data can be viewed by which role.
Data type: String
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Displays the width of the object, in inches or centimeters. This property is read only.
Color
Background
Specifies the background color and fill effect of the object. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000), choose a formula that
returns a color, or select Custom from the drop-down list to specify the color and fill
effect.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Specifies whether to make the row extended to the bottom of the page, so that the next
row starts on a new page.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Label
Specifies the popup text displayed when the mouse pointer hovers over the left edge of
the row.
Data type: String
On New Page
Specifies whether the row starts on a new page. This property is only applied if the
report has page layout enabled. The default is false which means the row starts on a
new page only if the previous page is filled.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Suppress
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Displays the width of the object, in inches or centimeters. This property is read only.
Color
Background
Specifies the background color and fill effect of the object. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000), choose a formula that
returns a color, or select Custom from the drop-down list to specify the color and fill
effect.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
The two properties, Current Block Index and Items per Block, work together to control
the data of the object to be displayed in continuous page mode.
Current Block Index specifies the index of the data block that will be displayed. 0 means
the first block index, and 1 the second, and so on.
Data type: Integer
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Specifies whether to make the row extended to the bottom of the page, so that the next
row starts on a new page.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
The two properties, Current Block Index and Items per Block, work together to control
the data of the object to be displayed in continuous page mode.
Item per Block specifies the number of records in each data block.
Data type: Integer
Label
Specifies the popup text displayed when the mouse pointer hovers over the left edge of
the row.
Data type: String
On New Page
Specifies whether the row starts on a new page. This property is only applied if the
report has page layout enabled. The default is false which means the row starts on a
new page only if the previous page is filled.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Displays the width of the object, in inches or centimeters. This property is read only.
Color
Background
Specifies the background color and fill effect of the object. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000), choose a formula that
returns a color, or select Custom from the drop-down list to specify the color and fill
effect.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Specifies whether to make the row extended to the bottom of the page, so that the next
row starts on a new page.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Label
Specifies the popup text displayed when the mouse pointer hovers over the left edge of
the row.
Data type: String
On New Page
Specifies whether the row starts on a new page. This property is only applied if the
report has page layout enabled. The default is false which means the row starts on a
new page only if the previous page is filled.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Displays the width of the object, in inches or centimeters. This property is read only.
Color
Background
Specifies the background color and fill effect of the object. Choose a color from the dropdown list, enter a hexadecimal RGB value (e.g. 0xff0000), choose a formula that
returns a color, or select Custom from the drop-down list to specify the color and fill
effect.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Specifies whether to make the row extended to the bottom of the page, so that the next
row starts on a new page.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Label
Specifies the popup text displayed when the mouse pointer hovers over the left edge of
the row.
Data type: String
On New Page
Specifies whether the row starts on a new page. This property is only applied if the
report has page layout enabled. The default is false which means the row starts on a
new page only if the previous page is filled.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Table column
There are four types of columns in a table, which are common column, detail common, group common
and summary common. These table column objects have the same properties as follows:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Others
Auto Fit
Specifies whether to adjust the width of the object according to the contents.
If the property is set to true, the width of the object will be adjusted automatically
only when:
The Position property for the field/label in this object is static or relative.
If the Position property for the field/label in this object is absolute, then the Auto
Fit property for the field/label should be set to true.
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Table cell
The properties of a table cell are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Displays the width of the object, in inches or centimeters. This property is read only.
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Horizontal Alignment
Specifies the horizontal justification of the content in the table cell. Choose an option
from the drop-down list.
Data type: Enumeration
Note: When the Position property of the object in the table cell is set to absolute, this
property does not take effect.
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed.
Data type: Boolean
Joining Merge
Specifies whether to make all the sequential rows included in the cell vertically merged
in the report results. It is meaningful to set the property only when the cell is merged
with other cells in the same column.
Data type: Boolean
Record Location
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to repeat the content of the cell in every page of the report results
when the cell is split into pages. Available only for vertically merged cell.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Vertical Alignment
Specifies the vertical justification of the content in the table cell. Choose an option from
the drop-down list.
Data type: Enumeration
Note: When the Position property of the object in the table cell is set to absolute, this
property does not take effect.
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Accessibility
Abbr
It is mapped to the HTML attribute abbr. This attribute specifies an abbreviated form of
the content of the object. The abbreviated text may be rendered by user agents when
appropriate in place of the object's content.
Data type: String
Axis
It is mapped to the HTML attribute axis. This attribute is used to place a cell into
conceptual categories that can be considered to form axes in an n-dimensional space.
The value of this attribute is a comma-separated list of category names.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
Headers
It is mapped to the HTML attribute headers. This attribute specifies the list of header
cells that provide header information for the current data cell. The value of this attribute
is a space-separated list of cell names; those cells must be named by setting their id
attribute.
Data type: String
Scope
It is mapped to the HTML attribute scope. This attribute specifies the set of data cells
for which the current header cell provides header information. Available values are:
Row - The current cell provides header information for the rest of the row that
contains it.
Column - The current cell provides header information for the rest of the column
that contains it.
none - The scope attribute will not be generated when exporting to HTML.
Tabular
The properties of a tabular are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Specifies whether to make the width of the object automatically expanded according to
the size of the components inserted.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Position
Specifies the position of the object. Choose an option from the drop-down list.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Specifies whether to make the height of the object automatically expanded according to
the size of the components inserted.
Data type: Boolean
Excel
Column Index
Specifies the X coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
TOC
Anchor Display Value
Specifies the text for the TOC entry for this object in the TOC browser. By default the
text is the unique object name assigned by JReport Designer. The TOC Anchor property
must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
Tabular cell
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Others
Cross Page
Specifies whether the panel can be split across a page break. This property is only applied if the
report has page layout enabled. The default is false which means that the panel is split only if it
exceeds the page height.
Data type: Boolean
Specifies whether to make the panel extended to the bottom of the page, so that the next panel
starts on a new page.
Data type: Boolean
On New Page
Specifies whether the panel starts on a new page. This property is only applied if the report has
page layout enabled. The default is false which means the panel starts on a new page only if the
previous page is filled.
Data type: Boolean
Tabular cell
The properties of a tabular cell are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. Enter a numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. Enter a numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Horizontal Alignment
Specifies the horizontal justification of the contents in the tabular cell. Choose an option
from the drop-down list.
Data type: Enumeration
Repeat Content
A cell may be extended to new pages for being affected by other cells even though it
can be wholly put in the current page. In this case, if the property value is true, then its
contents will appear on the new pages again.
Data type: Boolean
Note: If there are two or more cells that will be affected in the same row group and the
values of the property for these cells are true, then only the contents of the last one will
be repeated.
Vertical Alignment
Specifies the vertical justification of the contents in the tabular cell. Choose an option
from the drop-down list.
The property takes effect on the studio reports open in JReport Studio, and does not
control the exporting result.
Data type: Enumeration
Excel
Column Index
Specifies the X coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
TOC
Anchor Display Value
Specifies the text for the TOC entry for this object in the TOC browser. By default the
text is the unique object name assigned by JReport Designer. The TOC Anchor property
must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
Text box
The properties of a text box are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Position
Specifies the position of the object. Choose an option from the drop-down list.
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Vertical Alignment
Specifies the vertical justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
If true, the height of the object will be automatically adjusted according to the size of
the contents.
Data type: Boolean
Excel
Column Index
Specifies the X coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
TOC
Anchor Display Value
Specifies the text for the TOC entry for this object in the TOC browser. By default the
text is the unique object name assigned by JReport Designer. The TOC Anchor property
must be set to true for this property to take effect.
Data type: String
TOC Anchor
Specifies whether to include the object in the TOC browser for the report.
Data type: Boolean
TOC
The properties of a TOC object are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Root Label
Specifies the text of the label which will be displayed on the root of the TOC tree.
Data type: String
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Foreground
Specifies the foreground color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Italic
Strikethrough
Underline
Accessibility
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information about
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
UDO
As the name suggests, a UDO is an object defined by users. It has special properties defined by users.
The properties listed in JReport Report Inspector correspond with the ones defined your UDO programs.
Here are some default properties:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its parent
container. This property is ignored if the Position property is set to static. Enter a
numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Foreground
Specifies the foreground color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Others
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This property
is available only when a web control has been inserted into the object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Position
Specifies the position of the object. Choose an option from the drop-down list.
static - The object is positioned at the location in which it is inserted. The X and Y
properties are ignored. The position of the object is affected by preceding objects in
the same container.
relative - The object is positioned at an offset to the position at which it is inserted.
The offset is determined by the X and Y property values.
absolute - The object will be located at the position specified by dragging and
dropping or by setting its X and Y property values. The position of the object is not
affected by preceding objects in the same container.
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No
Records
Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Excel
Column Index
Specifies the X coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Column Number
Specifies the number of columns which will be the object's width in the exported Excel
file. The Columned property at the report level must be set to true for this property to
take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported to
Excel or CSV, measured in cells. The Columned property at the report level must be set
to true for this property to take effect.
Data type: Integer
Row Number
Specifies the number of rows which will be the object's height in the exported Excel file.
The Columned property at the report level must be set to true for this property to take
effect.
Data type: Integer
Font
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Italic
Notes:
The above are the basic properties of a UDO and more will be added with those defined in your
program.
JReport UDO does not support RTF and PDF format output. That is, when exporting to RTF and PDF,
a report with a UDO may not be rendered correctly. However, there is no such problem for HTML and
PS.
Built-in UDOs
JReport provides you with two built-in UDOs: JHyperLink and JRotator.
JHyperLink
It operates in a similar way to the hyperlink in an HTML file (only for Windows NT). Here are its special
properties:
Property Name
Description
Others
URL
Specifies the URL for accessing the linked file or website page.
Data type: String
If the specified URL is linked to a .rst file - the JReport Result export result
file, you should select jet.udos.RPTExecuter. For other links, use jet.udos.
IEExecuter.
Data type: String
Auto Fit
Specifies whether to adjust the width and height of the object according to
the contents.
Data type: Boolean
Target
blank - Loads the linked document into a new blank window. This
window is not named.
self - Loads the linked document into the window in which the link is
clicked (the active window).
parent - Loads the linked document into the immediate parent window
of the active window. If there is no parent window, the active window is
used.
top - Loads the linked document into the topmost window.
Specifies the text that will be shown when you hover the mouse pointer over
the JHyperLink in view mode or in HTML/DHTML result.
Data type: String
Display Value
Specifies the displayed text of the hyperlink. This property has lower priority
than Display Image.
Data type: String
Vertical Alignment
Horizontal Alignment
Word Wrap
Enable Hyperlink in
PDF
Specifies whether to enable the hyperlink when exporting the report to a PDF
file.
Data type: Boolean
Enable Hyperlink in
Excel
Enable Hyperlink in
HTML
HTML Style
Image
Display Image
Specifies the local path of the image displayed for the hyperlink (like a
hotspot in HTML). This property has higher priority than Display Value.
Data type: String
Original
Specifies from where the image is fetched when viewing or running the
report in JReport Server.
The property has following two options:
true - If selected, the image will not be delivered when publishing the
report set to JReport Server. JReport Server will find the image from the
local directory specified by the property Display Image when you view
the report.
false - If selected, the image will be delivered when publishing the
report to JReport Server. JReport Server will obtain the image from the
server side when you view or run the report.
Specifies the text that will be displayed instead if the image cannot be
displayed.
Data type: String
Accessibility
External CSS Class
Selector
External AccessKey
HrefLang
It is mapped to the HTML attribute hreflang. This attribute specifies the base
language of the resource designated by a link and may only be used when a
link is specified.
Data type: String
Example:
Insert two JHyperLink UDOs, and specify the following:
URL: http://www.jinfonet.com
Display Value: Click here.
URL: C:\docword.txt
Display Value: abc
Display Image: C:\JReport\Designer\Demo\SampleReports\Coffee.jpg
When you point your mouse at either UDO, a hand will show you that it is a hyperlink. By clicking it,
you will be taken to the destination. The application launched to open it (the linked file) is from your
Windows NT system. If Display Value and Display Image both have been specified, the image has the
higher priority to be displayed.
JRotator
It is a built-in UDO that can be rotated. Text and images can be held in JRotator. Following are its
special properties:
Property Name
Description
Rotate
0 - No rotation.
Specifies the text displayed in the JRotator. This property has lower priority
than Display Image.
Data type: String
Display Image
Specifies the local path of the image displayed in the JRotator. This property
has higher priority than Display Value.
Data type: String
Vertical Alignment
Specifies the vertical justification of the text in the JRotator container. Choose
an option from the drop-down list.
Data type: Enumeration
Horizontal
Alignment
Web control
The properties of web controls are listed as below:
Filter control
Multivalue container
Navigation control
Parameter control
Filter control
The properties of a filter control are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter
a numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter
a numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Foreground
Specifies the foreground color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
ID
Specifies the identifier of the object, which must be unique in the report set. The ID
property can be a style sheet selector.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Others
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Position
Specifies the position of the object. Choose an option from the drop-down list.
Specifies the X coordinate of the object relative to its parent container when exported
to Excel or CSV, measured in cells. The Columned property at the report level must be
set to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported
to Excel or CSV, measured in cells. The Columned property at the report level must be
set to true for this property to take effect.
Data type: Integer
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the
drop-down list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Title
Background
Specifies the background color of the title bar. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Bold
Font Face
Specifies the font of the text in the title bar. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text in the title bar. Enter an integer value to change the
size.
Data type: Integer
Foreground
Specifies the foreground color of the title bar. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Italic
Map Name
Specifies whether to use the name of the DBField added to the filter contorl as the text
displayed in the title bar.
Data type: Boolean
Show Title
Specifies whether to show the title bar. It is meanful to set all the other properties in
the Title category when this property is set to true.
Data type: Boolean
Text
Specifies the text displayed in the title bar. This property can be edited only when Map
Name is set to false. Enter a string to change the text.
Data type: String
Underline
Text Format
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Format
Specifies the display format of the text in the report result. It varies with data type
and can be manually defined.
Data type: String
Note: For the BigDecimal type, to avoid precision loss, you should enter a prefix JRD
when setting the format property value.
Italic
Underline
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External ID
It is mapped to the HTML attribute id. This attribute specifies a name to the object,
which must be unique in the report.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information
about the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Multivalue container
The properties of a multivalue container object are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Data Inherit
Indicates whether the dataset for this object is inherited from another object. This
property is read only.
Dataset
Indicates the dataset used by the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter
a numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter
a numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
ID
Specifies the identifier of the object, which must be unique in the report set. The ID
property can be a style sheet selector.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Export to PDF
Specifies whether to include the object when exporting the report to PDF. This
property is available only when a web control has been inserted into the object.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Position
Specifies the position of the object. Choose an option from the drop-down list.
Specifies the calculation point for the properties which use formulas. Choose an option
from the drop-down list.
Default - The values of the properties are calculated in the default location where
they are located.
Page Header - The values of the properties are calculated in the page header.
Page Footer - The values of the properties are calculated in the page footer.
Specifies whether to show the object in the report results. All formulas and calculations
will be skipped if the property is set to true.
Data type: Boolean
Suppress When No Records Specifies whether to display the object in the report results when no record is returned
to its parent data container.
Data type: Boolean
Excel
Column Index
Specifies the X coordinate of the object relative to its parent container when exported
to Excel or CSV, measured in cells. The Columned property at the report level must be
set to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported
to Excel or CSV, measured in cells. The Columned property at the report level must be
set to true for this property to take effect.
Data type: Integer
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the
drop-down list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Text Format
Bold
Font Face
Specifies the text font of the items in the multivalue container. Choose an option from
the drop-down list.
Data type: Enumeration
Font Size
Specifies the text font size of the items. Enter an integer value to change the size.
Data type: Integer
Foreground
Specifies the color of the item text. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Italic
Accessibility
External CSS Class
Selector
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information
about the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Navigation control
The properties of a navigation control are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter
a numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter
a numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Position
Specifies the position of the object. Choose an option from the drop-down list.
static - The object is positioned at the location in which it is inserted. The X and Y
properties are ignored. The position of the object is affected by preceding objects
in the same container.
relative - The object is positioned at an offset to the position at which it is
inserted. The offset is determined by the X and Y property values.
absolute - The object will be located at the position specified by dragging and
dropping or by setting its X and Y property values. The position of the object is not
affected by preceding objects in the same container.
Specifies the X coordinate of the object relative to its parent container when exported
to Excel or CSV, measured in cells. The Columned property at the report level must be
set to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported
to Excel or CSV, measured in cells. The Columned property at the report level must be
set to true for this property to take effect.
Data type: Integer
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the
drop-down list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Navigation item
Navigation item
The properties of a navigation item are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Text Format
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Horizontal Alignment
Specifies the horizontal justification of the text in the object. Choose an option from
the drop-down list.
Data type: Enumeration
Italic
Text
Specifies the text in the object. Enter a string to display as the object text.
Data type: String
Underline
Vertical Alignment
Specifies the vertical justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Foreground
Specifies the foreground color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Padding
Bottom Padding
Specifies the space between the text and the bottom border of the object. Enter a
numeric value to change the padding.
Data type: Float
Left Padding
Specifies the space between the text and the left border of the object. Enter a numeric
value to change the padding.
Data type: Float
Right Padding
Specifies the space between the text and the right border of the object. Enter a
numeric value to change the padding.
Data type: Float
Top Padding
Specifies the space between the text and the top border of the object. Enter a numeric
value to change the padding.
Data type: Float
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the
drop-down list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Shadow
Specifies whether to draw two shadowed borders, beneath and to the right of the
object.
Data type: Boolean
Shadow Color
Specifies the color of the shadow. Choose a color from the drop-down list, enter a
hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a color.
Data type: String
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color in which to draw a pattern to fill the object. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the Pattern Color.
vertical - The pattern will be made of vertical lines of the Pattern Color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the
Pattern Color.
diagonal - The pattern will be made of diagonal lines of the Pattern Color.
Parameter control
The properties of a parameter control are:
Property Name
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Foreground
Specifies the foreground color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
ID
Specifies the identifier of the object, which must be unique in the report set. The ID
property can be a style sheet selector.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies the X coordinate of the object relative to its parent container when exported
to Excel or CSV, measured in cells. The Columned property at the report level must be
set to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported
to Excel or CSV, measured in cells. The Columned property at the report level must be
set to true for this property to take effect.
Data type: Integer
Pattern
Pattern Color
Specifies the color in which to draw a pattern to fill the object. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the Pattern Color.
vertical - The pattern will be made of vertical lines of the Pattern Color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the
Pattern Color.
diagonal - The pattern will be made of diagonal lines of the Pattern Color.
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Format
Specifies the display format of the text in the report result. It varies with data type
and can be manually defined.
Data type: String
Note: For the BigDecimal type, to avoid precision loss, you should enter a prefix JRD
when setting the format property value.
Horizontal Alignment
Specifies the horizontal justification of the text in the object. Choose an option from
the drop-down list.
Data type: Enumeration
Italic
Underline
Vertical Alignment
Specifies the vertical justification of the text in the object. Choose an option from the
drop-down list.
Data type: Enumeration
Others
Export to CSV
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Parameter
Position
Specifies the position of the object. Choose an option from the drop-down list.
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
External Title
It is mapped to the HTML attribute title. This attribute offers advisory information
about the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
Description
General
Class Type
Indicates the class type of the object. This property is read only.
Instance Name
Shows the instance name of the object. This property is read only.
Geometry
Height
Specifies the height of the object, in inches or centimeters. Enter a numeric value to
change the height.
Data type: Float
Width
Specifies the width of the object, in inches or centimeters. Enter a numeric value to
change the width.
Data type: Float
Specifies the horizontal coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter
a numeric value to change the position in inches or centimeters.
Data type: Float
Specifies the vertical coordinate of the top left corner of the object, relative to its
parent container. This property is ignored if the Position property is set to static. Enter
a numeric value to change the position in inches or centimeters.
Data type: Float
Color
Background
Specifies the background color of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
CSS
Class
Specifies a CSS class to be applied to the object which is a valid class in the CSS file.
Data type: String
ID
Specifies the identifier of the object, which must be unique in the report set. The ID
property can be a style sheet selector.
Data type: String
Style
Specifies a style to be applied to the object. Choose a style from the drop-down list
which is available when a Style Group has been selected at the report level and
when there are styles in the Style Group that can be applied to the object, or type
in the style name.
Specifies a CSS selector to be applied to the object. Enter a valid class name from
the CSS file.
Specifies whether to include the object when exporting the report to CSV.
Data type: Boolean
Export to DHTML
Specifies whether to include the object when exporting the report to DHTML.
Data type: Boolean
Export to Excel
Specifies whether to include the object when exporting the report to Excel.
Data type: Boolean
Invisible
Specifies whether to show the object in the design area and in the report results. All
formulas and calculations will still be performed if the property is set to true.
Data type: Boolean
Position
Specifies the position of the object. Choose an option from the drop-down list.
Specifies the background color of the title bar. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Bold
Font Face
Specifies the font of the text in the title bar. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text in the title bar. Enter an integer value to change the
size.
Data type: Integer
Foreground
Specifies the foreground color of the title bar. Choose a color from the drop-down list,
enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula that returns a
color.
Data type: String
Horizontal Alignment
Specifies the horizontal justification of the text in the title bar. Choose an option from
the drop-down list.
Data type: Enumeration
Italic
Show Title
Specifies whether to show the title bar. It is meanful to set all the other properties in
the Title category when this property is set to true.
Data type: Boolean
Text
Specifies the text displayed in the title bar. Enter a string to change the text.
Data type: String
Underline
Excel
Column Index
Specifies the X coordinate of the object relative to its parent container when exported
to Excel or CSV, measured in cells. The Columned property at the report level must be
set to true for this property to take effect.
Data type: Integer
Row Index
Specifies the Y coordinate of the object relative to its parent container when exported
to Excel or CSV, measured in cells. The Columned property at the report level must be
set to true for this property to take effect.
Data type: Integer
Border
Border Color
Specifies the color of the border of the object. Choose a color from the drop-down list,
enter a hexadecimal RGB value (0xCCAA00) or choose a formula that returns a color.
Data type: String
Border Thickness
Bottom Line
Specifies the line style of the bottom border of the object. Choose a style from the
drop-down list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Top Line
Specifies the line style of the top border of the object. Choose a style from the dropdown list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color in which to draw a pattern to fill the object. Choose a color from the
drop-down list, enter a hexadecimal RGB value (e.g. 0xff0000) or choose a formula
that returns a color.
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the Pattern Color.
vertical - The pattern will be made of vertical lines of the Pattern Color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the
Pattern Color.
diagonal - The pattern will be made of diagonal lines of the Pattern Color.
Specifies a class selector to be applied to the object when exported as HTML. Enter a
valid class name from the CSS file.
Data type: String
External Style
It is mapped to the HTML attribute style. This attribute specifies style information for
the object.
Data type: String
Language
It is mapped to the HTML attribute lang. This attribute specifies the base language of
the object's attribute values and text content.
Data type: String
The default ones are the recommended values to be used, so it is better not to randomly modify
other properties except the two properties - Name and Description. Make changes only after you are
sure of the meaning of each property.
To modify the properties, you should first uncheck Forbid editing data object properties in the
Catalog category of the Options dialog.
Make sure that the precision set in catalog is same as that in database. This is to avoid inconsistency
between the database data values and the displayed report result.
Business/Report cube
Business view
Formula
Imported SQL
JDBC connection
Parameter
Query
Query modifier
Stored procedure
Summary
Table/View
XML connection
Business/Report cube
The properties of a business/report cube are:
Property Name
Description
Description
Specifies the description of the business/report cube, which will be shown when you hover the
mouse pointer over the business/report cube in the Resource View panel of JReport Viewer.
Data type: String
Display Name
Maximum Duration
Specifies the maximum elapsed time allowed to fetch data from the data source when the
business cube runs, measured in seconds. If the value is set to zero or is blank, it means the
time will be unlimited. Note that for a report cube, this property is set on the query on which
the report cube is created.
For usage about the property, see Limiting the query run time and number of records.
Data type: Integer
Maximum Rows
Specifies the maximum number of rows that will be fetched from the data source when the
business cube runs. If the value is set to zero or is blank, it means the number will be
unlimited. Note that for a report cube, this property is set on the query on which the report
cube is created.
For usage about the property, see Limiting the query run time and number of records.
Data type: Integer
Name
Type
Indicates the type of the cube element whose value is used by JReport internally. This
property is read only.
0 - Business cube
3 - Category
4 - Dimension object
5 - Measure object
9 - Hierarchy
Category
Dimension object
Measure object
Category
The properties of a category are:
Property Name
Description
Description
Specifies the description of the object, which will be shown when you hover the mouse
pointer over the object in the Resource View panel of JReport Viewer.
Data type: String
Display Name
Name
Type
Indicates the type of the cube element whose value is used by JReport internally. This
property is read only.
0 - Business cube
3 - Category
4 - Dimension object
5 - Measure object
9 - Hierarchy
Description
Description
Specifies the description of the object, which will be shown after the tooltip when you hover
the mouse pointer over the object in the Resource View panel of JReport Viewer.
Data type: String
Display Name
Mapping Name
Specifies the mapping name of the column to which the object is mapped.
Data type: String
Name
Specifies the name of the object which is used by the API calls.
Data type: String
Tip
Specifies the tooltip of the object, which will be shown when you hover the mouse pointer
over the object in the Resource View panel of JReport Viewer.
Data type: String
Type
Indicates the type of the cube element whose value is used by JReport internally. This
property is read only.
0 - Business cube
3 - Category
4 - Dimension object
5 - Measure object
9 - Hierarchy
Dimension object
The properties of a dimension object are:
Property Name
Description
Description
Specifies the description of the object, which will be shown after the tooltip when you hover
the mouse pointer over the object in the Resource View panel of JReport Viewer.
Data type: String
Display Name
Mapping Name
Specifies the mapping name of the column to which the object is mapped.
Data type: String
Name
Specifies the name of the object which is used by the API calls.
Data type: String
Tip
Specifies the tooltip of the object, which will be shown when you hover the mouse pointer
over the object in the Resource View panel of JReport Viewer.
Data type: String
Type
Indicates the type of the cube element whose value is used by JReport internally. This
property is read only.
0 - Business cube
3 - Category
4 - Dimension object
5 - Measure object
9 - Hierarchy
Measure object
The properties of a measure object are:
Property Name
Description
Aggregate Function
Description
Specifies the description of the object, which will be shown after the tooltip when you hover
the mouse pointer over the object in the Resource View panel of JReport Viewer.
Data type: String
Display Name
Mapping Name
Specifies the mapping name of the column to which the object is mapped.
Data type: String
Name
Specifies the internal name of the object which is used by the API calls.
Data type: String
Tip
Specifies the tooltip of the object, which will be shown when you hover the mouse pointer
over the object in the Resource View panel of JReport Viewer.
Data type: String
Type
Indicates the type of the cube element whose value is used by JReport internally. This
property is read only.
0 - Business cube
3 - Category
4 - Dimension object
5 - Measure object
9 - Hierarchy
Business view
The properties of a business view are:
Property Name
Description
Description
Specifies the description of the business view, which will be shown when you hover the
mouse pointer over the business view in the Resources panel of JReport Studio.
Data type: String
Display Name
Type
Indicates the type of the business view. This property is read only.
Aggregation object
Category
Detail object
Group object
Aggregation object
The properties of an aggregation object are:
Property Name
Description
Aggregate Function
Description
Specifies the description of the object, which will be shown when you hover the mouse
pointer over the object in the Resources panel of JReport Studio.
Data type: String
Display Name
Mapping Name
Specifies the mapping name of the column to which the object is mapped.
Data type: String
Tip
Specifies the tooltip of the object, which will be shown when you hover the mouse pointer
over the object in the Resources panel of JReport Studio.
Data type: String
Type
Indicates the type of the view element. This property is read only.
Category
The properties of a category are:
Property Name
Description
Description
Specifies the description of the object, which will be shown when you hover the mouse
pointer over the object in the Resources panel of JReport Studio.
Data type: String
Display Name
Type
Indicates the type of the view element. This property is read only.
Detail object
The properties of a detail object are:
Property Name
Description
Description
Specifies the description of the object, which will be shown when you hover the mouse
pointer over the object in the Resources panel of JReport Studio.
Data type: String
Display Name
Mapping Name
Specifies the mapping name of the column to which the object is mapped.
Data type: String
Tip
Specifies the tooltip of the object, which will be shown when you hover the mouse pointer
over the object in the Resources panel of JReport Studio.
Data type: String
Type
Indicates the type of the view element. This property is read only.
Group object
The properties of a group object are:
Property Name
Description
Description
Specifies the description of the object, which will be shown when you hover the mouse
pointer over the object in the Resources panel of JReport Studio.
Data type: String
Display Name
Mapping Name
Specifies the mapping name of the column to which the object is mapped.
Data type: String
Tip
Specifies the tooltip of the object, which will be shown when you hover the mouse pointer
over the object in the Resources panel of JReport Studio.
Data type: String
Type
Indicates the type of the view element. This property is read only.
Description
Description
Name
Formula
The properties of a formula are:
Property Name
Description
General
Description
Display Width
Specifies the display width of the formula. Enter a numeric value to change the width.
Data type: Float
Expression
Displays the whole statement of the formula. This property is read only.
Length
Name
Number Base
Precision
Specifies the precision of the formula's returned value. Specify the largest number of digits
that can ever occur. Significant digits will be lost if the precision value is too small; however,
memory is wasted when too large a value is specified.
Data type: Integer
Scale
Specifies the number of digits to the right of the decimal point of the formula's returned
value.
Data type: Integer
SQL Type
Specifies the SQL type of the formula defined in Java. Choose an option from the drop-down
list.
Data type: Integer
Text Format
Auto Fit
Specifies whether to adjust the width and height of the formula according to the contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Format
Specifies the display format of the formula's returned value. The format varies with the
formula's data type and can be defined manually.
Data type: String
Horizontal
Alignment
Specifies the horizontal justification of the text in the formula. Choose an option from the
drop-down list.
Data type: Enumeration
Italic
Strikethrough
Underline
Vertical Alignment
Specifies the vertical justification of the text in the formula. Choose an option from the dropdown list.
Data type: Enumeration
Word Wrap
Padding
Bottom Padding
Specifies the space between the text and the bottom border of the formula. Enter a numeric
value to change the padding.
Data type: Float
Left Padding
Specifies the space between the text and the left border of the formula. Enter a numeric
value to change the padding.
Data type: Float
Right Padding
Specifies the space between the text and the right border of the formula. Enter a numeric
value to change the padding.
Data type: Float
Top Padding
Specifies the space between the text and the top border of the formula. Enter a numeric
value to change the padding.
Data type: Float
Geometry
Height
Specifies the height of the formula, which takes effect when the formula is inserted into a
report. Enter a numeric value to change the height. The default is 0 which means a proper
height will be specified to the formula by JReport automatically.
Data type: Float
Width
Specifies the width of the formula, which takes effect when the formula is inserted into a
report. Enter a numeric value to change the width. The default is 0 which means a proper
width will be specified to the formula by JReport automatically.
Data type: Float
Color
Background
Specifies the background color of the formula. Choose a color from the drop-down list, or
enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Foreground
Specifies the foreground color of the formula. Choose a color from the drop-down list, or
enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Border
Border Color
Specifies the color of the border of the formula. Choose a color from the drop-down list, or
enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Border Thickness
Specifies the width of the border in inches or centimeters. Enter a numeric value to change
the thickness.
Data type: Float
Bottom Line
Specifies the line style of the bottom border of the formula. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the formula. Choose a style from the drop-down
list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the formula. Choose a style from the drop-down
list.
Data type: Enumeration
Shadow
Specifies whether or not to draw two shadowed borders, beneath and to the right of the
formula.
Data type: Boolean
Shadow Color
Specifies the color of the border shadow. Choose a color from the drop-down list, or enter a
hexadecimal RGB value (0xCCAA00).
Data type: String
Top Line
Specifies the line style of the top border of the formula. Choose a style from the drop-down
list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color with which to draw a pattern to fill the formula. Choose a color from the
drop-down list, or enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the specified color.
vertical - The pattern will be made of vertical lines of the specified color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the specified
color.
diagonal - The pattern will be made of slash lines of the specified color.
SQL Type
Option
Type
Option
Type
-7
BIT
-6
TINYINT
-5
BIGINT
-4
LONGVARBINARY
-3
VARBINARY
-2
BINARY
-1
LONGVARCHAR
CHAR
NUMERIC
DECIMAL
INTEGER
SMALLINT
FLOAT
REAL
DOUBLE
12
VARCHAR
16
BOOLEAN
91
DATE
92
TIME
93
TIMESTAMP
2003
ARRAY
2004
BLOB
2005
CLOB
Description
Attributes
Specifies whether or not columns of this HDS can be used to group by. If true, they can't.
Data type: Boolean
Class Name
Displays the name of the class provided by JReport that is used to implement hierarchical
data sources. This property is read only.
Description
Full Name
Displays the full path name of the HDS automatically generated by JReport. This property is
read only.
Maximum Duration
Specifies the maximum elapsed time allowed to fetch data from the data source when the
HDS runs, measured in seconds. If the value is set to zero or is blank, it means the time will
be unlimited.
For usage about the property, see Limiting the query run time and number of records.
Data type: Integer
Maximum Rows
Specifies the maximum number of rows that will be fetched from the data source when the
HDS runs. If the value is set to zero or is blank, it means the number will be unlimited.
For usage about the property, see Limiting the query run time and number of records.
Data type: Integer
Name
Parameter
Root Name
URI
Version
Displays the version number of the HDS API. This property is read only.
XSD URI
An HDS contains some tables and columns in those tables. The following topics show their properties in
detail:
HDS table
HDS column
HDS table
The properties of an HDS table are:
Property Name
Description
Attributes
Specifies whether or not the HDS columns of this HDS table can be used to group by. If true,
they can't.
Data type: Boolean
Description
Full Name
Displays the full path name of the HDS table automatically generated by JReport. This
property is read only.
Maximum Duration
Specifies the maximum elapsed time allowed to fetch data from the data source when the
HDS table runs, measured in seconds. If the value is set to zero or is blank, it means the time
will be unlimited.
For usage about the property, see Limiting the query run time and number of records.
Data type: Integer
Maximum Rows
Specifies the maximum number of rows that will be fetched from the data source when the
HDS table runs. If the value is set to zero or is blank, it means the number will be unlimited.
For usage about the property, see Limiting the query run time and number of records.
Data type: Integer
Name
HDS column
The properties of an HDS column are:
Property Name
Description
General
Array
Column Name
Currency
Specifies whether to control the SQL type of formulas or summaries in which the BigDecimal
type fields are imported.
true - The formula or summary which is built with the BigDecimal type field will be
BigDecimal type, and its SQL Type value will be set to 3.
false - The normal data type will be used for the formula or summary.
Display Width
Specifies the display width of the column. Enter a numeric value to change the width.
Data type: Float
Full Name
Displays the full path name of the column automatically generated by JReport. This property
is read only.
HDS Format
Name
Nullable
Specifies the nullability of the column's value. Choose an option from the drop-down list.
Data type: Enumeration
Precision
Specifies the precision of the column's value. Specify the largest number of digits that can
ever occur in the column. Significant digits will be lost if the value is too small; however,
memory is wasted when too large a value is specified.
Data type: Integer
Scale
Specifies the number of digits to the right of the decimal point for the column's value.
Data type: Integer
SQL Type
Specifies the SQL type of the column defined in Java. Choose an option from the drop-down
list.
Data type: Integer
Text Format
Auto Fit
Specifies whether to adjust the width and height of the column according to the contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Format
Specifies the display format of the column's value. The format varies with the column's data
type and can be defined manually.
Data type: String
Horizontal
Alignment
Specifies the horizontal justification of the text in the column. Choose an option from the dropdown list.
Data type: Enumeration
Italic
Strikethrough
Underline
Vertical Alignment
Specifies the vertical justification of the text in the column. Choose an option from the dropdown list.
Data type: Enumeration
Word Wrap
Padding
Bottom Padding
Specifies the space between the text and the bottom border of the column. Enter a numeric
value to change the padding.
Data type: Float
Left Padding
Specifies the space between the text and the left border of the column. Enter a numeric value
to change the padding.
Data type: Float
Right Padding
Specifies the space between the text and the right border of the column. Enter a numeric
value to change the padding.
Data type: Float
Top Padding
Specifies the space between the text and the top border of the column. Enter a numeric value
to change the padding.
Data type: Float
Geometry
Height
Specifies the height of the column, which takes effect when the column is inserted into a
report. Enter a numeric value to change the height. The default is 0 which means a height will
be assigned to the column by JReport automatically.
Data type: Float
Width
Specifies the width of the column, which takes effect when the column is inserted into a
report. Enter a numeric value to change the width. The default is 0 which means a width will
be assigned to the column by JReport automatically
Data type: Float
Color
Background
Specifies the background color of the column. Choose a color from the drop-down list, or
enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Foreground
Specifies the foreground color of the column. Choose a color from the drop-down list, or enter
a hexadecimal RGB value (0xCCAA00).
Data type: String
Border
Border Color
Specifies the color of the border of the column. Choose a color from the drop-down list, or
enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Border Thickness
Specifies the width of the border in inches or centimeters. Enter a numeric value to change
the thickness.
Data type: Float
Bottom Line
Specifies the line style of the bottom border of the column. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the column. Choose a style from the drop-down
list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the column. Choose a style from the drop-down
list.
Data type: Enumeration
Shadow
Specifies whether or not to draw two shadowed borders, beneath and to the right of the
column.
Data type: Boolean
Shadow Color
Specifies the color of the border shadow. Choose a color from the drop-down list, or enter a
hexadecimal RGB value (0xCCAA00).
Data type: String
Top Line
Specifies the line style of the top border of the column. Choose a style from the drop-down
list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color with which to draw a pattern to fill the column. Choose a color from the
drop-down list, or enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the specified color.
vertical - The pattern will be made of vertical lines of the specified color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the specified
color.
diagonal - The pattern will be made of slash lines of the specified color.
Nullable
The Nullable property decides the nullability of a column's value, and its value can be one of the
following:
unknown - Indicates whether the column's value can be null or not is unknown.
In versions prior to JReport Designer Version 8, when the returned value of a column is null, of which
the nullability is false, there will be a default value replacing that null value. When you upgrade JReport
Designer from a previous version to Version 8, there is a change considering better use and control of
null value, that is, if null value is returned whereas you specify null value is not allowed on the column,
the null value would display as it is. If you want to change the null value to any other desired values,
formulas can be applied. For example, with the following formula, the null value is changed to 0:
if (isnull (@theColumn))
return 0
else
return @theColumn;
Imported SQL
The properties of an imported SQL file are:
Property Name
Description
Description
Maximum Duration
Specifies the maximum elapsed time allowed to fetch data from the data source when the
SQL file runs, measured in seconds. If the value is set to zero or is blank, it means the time
will be unlimited.
For usage about the property, see Limiting the query run time and number of records.
Data type: Integer
Maximum Rows
Specifies the maximum number of rows that will be fetched from the data source when the
imported SQL file runs. If the value is set to zero or is blank, it means the number will be
unlimited.
For usage about the property, see Limiting the query run time and number of records.
Data type: Integer
Name
Qualifier
Read Only
Specifies whether or not the imported SQL file will be read only.
Data type: Enumeration
Transaction Mode
Specifies the transaction mode for the imported SQL file. Choose an option from the dropdown list.
default - Indicates the transaction information cannot be get from JDBC connection.
read uncommitted - Dirty reads, non-repeatable reads and phantom reads can occur.
This mode will speed up the transaction of the catalog.
read committed - Dirty reads are prevented; non-repeatable reads and phantom reads
can occur.
repeatable read - Dirty reads and non-repeatable reads are prevented; phantom reads
can occur.
serializable - Dirty reads, non-repeatable reads and phantom reads are prevented.
An imported SQL file contains several columns, the properties of which are shown in the following topic:
Description
General
Array
Column Index
Column Name
Currency
Specifies whether to control the SQL type of formulas or summaries in which the BigDecimal
type fields are imported.
true - The formula or summary which is built with the BigDecimal type field will be
BigDecimal type, and its SQL Type value will be set to 3.
false - The normal data type will be used for the formula or summary.
Display Width
Specifies the display width of the column. Enter a numeric value to change the width.
Data type: Float
Name
Nullable
Specifies the nullability of the column's value. Choose an option from the drop-down list.
Data type: Enumeration
Precision
Specifies the precision of the column's value. Specify the largest number of digits that can
ever occur in the column. Significant digits will be lost if the value is too small; however,
memory is wasted when too large a value is specified.
Data type: Integer
Scale
Specifies the number of digits to the right of the decimal point for the column's value.
Data type: Integer
SQL Type
Specifies the SQL type of the column defined in Java. Choose an option from the drop-down
list.
Data type: Integer
Text Format
Auto Fit
Specifies whether to adjust the width and height of the column according to the contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Format
Specifies the display format of the column's value. The format varies with the column's data
type and can be defined manually.
Data type: String
Horizontal
Alignment
Specifies the horizontal justification of the text in the column. Choose an option from the dropdown list.
Data type: Enumeration
Italic
Strikethrough
Underline
Vertical Alignment
Specifies the vertical justification of the text in the column. Choose an option from the dropdown list.
Data type: Enumeration
Word Wrap
Padding
Bottom Padding
Specifies the space between the text and the bottom border of the column. Enter a numeric
value to change the padding.
Data type: Float
Left Padding
Specifies the space between the text and the left border of the column. Enter a numeric value
to change the padding.
Data type: Float
Right Padding
Specifies the space between the text and the right border of the column. Enter a numeric
value to change the padding.
Data type: Float
Top Padding
Specifies the space between the text and the top border of the column. Enter a numeric value
to change the padding.
Data type: Float
Geometry
Height
Specifies the height of the column, which takes effect when the column is inserted into a
report. Enter a numeric value to change the height. The default is 0 which means a height will
be assigned to the column by JReport automatically.
Data type: Float
Width
Specifies the width of the column, which takes effect when the column is inserted into a
report. Enter a numeric value to change the width. The default is 0 which means a width will
be assigned to the column by JReport automatically.
Data type: Float
Color
Background
Specifies the background color of the column. Choose a color from the drop-down list, or
enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Foreground
Specifies the foreground color of the column. Choose a color from the drop-down list, or enter
a hexadecimal RGB value (0xCCAA00).
Data type: String
Border
Border Color
Specifies the color of the border of the column. Choose a color from the drop-down list, or
enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Border Thickness
Specifies the width of the border in inches or centimeters. Enter a numeric value to change
the thickness.
Data type: Float
Bottom Line
Specifies the line style of the bottom border of the column. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the column. Choose a style from the drop-down
list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the column. Choose a style from the drop-down
list.
Data type: Enumeration
Shadow
Specifies whether or not to draw two shadowed borders, beneath and to the right of the
column.
Data type: Boolean
Shadow Color
Specifies the color of the border shadow. Choose a color from the drop-down list, or enter a
hexadecimal RGB value (0xCCAA00).
Data type: String
Top Line
Specifies the line style of the top border of the column. Choose a style from the drop-down
list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color with which to draw a pattern to fill the column. Choose a color from the
drop-down list, or enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the specified color.
vertical - The pattern will be made of vertical lines of the specified color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the specified
color.
diagonal - The pattern will be made of slash lines of the specified color.
JDBC connection
The properties of a JDBC connection are:
Property Name
Description
Date Format
Description
Driver
Specifies whether to use Explicit Join notation or Implicit Join notation in the Where
clause for inner joins.
Displays the schema names specified for the connection in the Get JDBC Connection
Information dialog. The default is blank, which indicates that all schemas in the DBMS
can be used in the catalog. This property is read only. To modify it, use the Get JDBC
Connection Information dialog.
Name
Specifies the name of the connection which, by default, is the same as the connection
URL, but can also be a user friendly name for the connection.
Data type: String
Name Pattern
Specifies the password for connecting with the database, which is determined by the
database DBA.
Data type: String
Pre-join
Specifies whether or not to apply the pre-join information defined on the data source in
which the connection is set when building a query or defining join relationships in
business cubes in the same data source.
Data type: Boolean
Quote Qualifier
Specifies the characters, then a qualifier name which contains the characters that will not
be quoted. Choose an option from the drop-down list.
Default (JDBC) - If selected, the program will get the extra name characters from
JDBC.
User Defined - If selected, you can modify the quote character according to the
database system being used.
Specifies the mode to open the connection to the JDBC data source. The initial setting is
default which uses the mode specified by the DBMS Administrator which could be read
only or read & write. Choose an option from the drop-down list.
default - May be read & write or read only depending on the DBMS default setting.
read only - Allows the driver to optimize performance for reporting which does not
need to write to the DBMS.
read & write - Opens the DBMS with updates enabled which requires more
processing to ensure concurrency control.
Specifies the parameters to implement the SQLStmtCreator interface (for details about
the interface and its usage, refer to Dynamic queries).
Data type: String
Time Format
Timestamp Format
Transaction Mode
Specifies the transaction mode for the connection. Choose an option from the drop-down
list.
default - Indicates the transaction information cannot be get from JDBC connection.
read uncommitted - Dirty reads, non-repeatable reads and phantom reads can
occur. This mode will speed up the transaction of the catalog.
read committed - Dirty reads are prevented; non-repeatable reads and phantom
reads can occur.
repeatable read - Dirty reads and non-repeatable reads are prevented; phantom
reads can occur.
serializable - Dirty reads, non-repeatable reads and phantom reads are prevented.
Specifies the JDBC URL which establishes the connection to the database, for example
jdbc:oracle:thin:@localhost:1521:ORCL.
Data type: String
User
Specifies the user name for connecting to the database, which is determined by the
database DBA.
Data type: String
Meaning
Presentation
year
Number
month
Number
day in month
Number
Number
Number
minute in hour
Number
second in minute
Number
millisecond
Number
Parameter
The properties of a parameter are:
Property Name
Description
General
Bind Column
Binding
Specifies the parameter which will be bound with the current one to sort the column
controlled by the current parameter.
Data type: String
Specifies the parameter value that will be prompted by default at runtime. If it is set to 0,
the first parameter value in the Value property will be prompted; if it is set to -1, the last
parameter value in the Value property will be prompted.
Data type: Integer
Description
Display Column
Display Width
Specifies the display width of the parameter. Enter a numeric value to change the width.
Data type: Float
Distinct
When a parameter is bound with a column, you can choose to hide the parameter at
runtime when only a single value is returned for the parameter, and the returned single
value will be used as default value of the parameter.
Data type: Boolean
Import SQL
Specifies the statement of the imported SQL file, which is created manually.
Data type: String
Maximum Value/Length Specifies the maximum value allowed for this parameter, or the maximum length for a
String type parameter.
Data type: String
Minimum Value/Length Specifies the minimum value allowed for this parameter, or the minimum length for a
String type parameter.
Data type: String
Name
Object Name
Specifies the name for the OOJDBC class that is related to the parameter.
Data type: String
Object Parameter Name Specifies the parameter name for the OOJDBC class.
Data type: String
Operation
Specifies whether or not to check the minimum and maximum values that you specified
for the parameter at runtime. If -1, it will not check; if 1, it will check at runtime.
Data type: Integer
Prompt Text
Specifies the prompt text of the parameter, which is used for prompting users to provide
the value of the parameter.
Data type: String
When a parameter is bound with a column, you can specify a RLS policy defined on the
bind column in the data source to the parameter, then at runtime, end users will be
prompted to enter the security ID, which refers to the user name, and only the records
the specified SID allowed to view will be displayed in the parameter value drop-down list.
Data type: String
Required
String Encoding
Specifies the encoding for the parameter. This property is available only when the
parameter's data type is String.
Data type: String
String Format
Specifies the user-defined format of the parameter value. This property works only when
the parameter's data type is String.
Data type: String
Specifies whether or not to treat blank data value as null when the parameter's data type
is String.
Data type: Boolean
Use Current Date-Time Specifies whether or not to use the current system's date time as value of the parameter
when the parameter's data type is Date, Time or DateTime.
Data type: Boolean
Use Current Date-Time Specifies whether or not to use the current system's date time as value of the parameter
When Blank
when the parameter's data type is Date, Time or DateTime, and the parameter value is
blank.
Data type: Boolean
User Defined Format
Value List
Value Type
Specifies the data type of the parameter. Choose an option from the drop-down list.
Data type: Enumeration
Text Format
Auto Fit
Specifies whether to adjust the width and height of the parameter according to the
contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Format
Specifies the display format of the parameter's value. The format varies with the
parameter's data type and can be defined manually.
Data type: String
Horizontal Alignment
Specifies the horizontal justification of the text in the parameter. Choose an option from
the drop-down list.
Data type: Enumeration
Italic
Strikethrough
Underline
Vertical Alignment
Specifies the vertical justification of the text in the parameter. Choose an option from the
drop-down list.
Data type: Enumeration
Word Wrap
Padding
Bottom Padding
Specifies the space between the text and the bottom border of the parameter. Enter a
numeric value to change the padding.
Data type: Float
Left Padding
Specifies the space between the text and the left border of the parameter. Enter a
numeric value to change the padding.
Data type: Float
Right Padding
Specifies the space between the text and the right border of the parameter. Enter a
numeric value to change the padding.
Data type: Float
Top Padding
Specifies the space between the text and the top border of the parameter. Enter a
numeric value to change the padding.
Data type: Float
Geometry
Height
Specifies the height of the parameter, which takes effect when the parameter is inserted
into a report. Enter a numeric value to change the height. The default is 0 which means a
proper height will be specified to the parameter by JReport automatically.
Data type: Float
Width
Specifies the width of the parameter, which takes effect when the parameter is inserted
into a report. Enter a numeric value to change the width. The default is 0 which means a
proper width will be specified to the parameter by JReport automatically.
Data type: Float
Color
Background
Specifies the background color of the parameter. Choose a color from the drop-down list,
or enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Foreground
Specifies the foreground color of the parameter. Choose a color from the drop-down list,
or enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Border
Border Color
Specifies the color of the border of the parameter. Choose a color from the drop-down list,
or enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Border Thickness
Specifies the width of the border in inches or centimeters. Enter a numeric value to
change the thickness.
Data type: Float
Bottom Line
Specifies the line style of the bottom border of the parameter. Choose a style from the
drop-down list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the parameter. Choose a style from the dropdown list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the parameter. Choose a style from the dropdown list.
Data type: Enumeration
Shadow
Specifies whether or not to draw two shadowed borders, beneath and to the right of the
parameter.
Data type: Boolean
Shadow Color
Specifies the color of the border shadow. Choose a color from the drop-down list, or enter
a hexadecimal RGB value (0xCCAA00).
Data type: String
Pattern
Pattern Color
Specifies the color with which to draw a pattern to fill the parameter. Choose a color from
the drop-down list, or enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the specified color.
vertical - The pattern will be made of vertical lines of the specified color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the
specified color.
diagonal - The pattern will be made of slash lines of the specified color.
Query
The properties of a query are:
Property Name
Description
Description
Specifies whether or not the query uses the dynamic query interface to get the result
set. When it is set to true, the query can be re-generated at runtime using the
dynamic query interface (for more information, see Dynamic queries).
Data type: Boolean
Maximum Duration
Specifies the maximum elapsed time allowed to fetch data from the data source when
the query runs, measured in seconds. If the value is set to zero or is blank, it means
the time will be unlimited.
For usage about the property, see Limiting the query run time and number of records.
Data type: Integer
Maximum Rows
Specifies the maximum number of rows that will be fetched from the data source
when the query runs. If the value is set to zero or is blank, it means the number will
be unlimited.
For usage about the property, see Limiting the query run time and number of records.
Data type: Integer
Name
Path Name
Specifies the path in pre-join that the query is created on (for more information, see
Creating queries using pre-join).
Data type: String
Read Only
Share
Specifies whether or not to share the query (for details, see Locking queries).
Data type: Boolean
Transaction Mode
Specifies the transaction mode for the query. Choose an option from the drop-down
list.
Query column
Query column
There are two kinds of columns in a query: table columns and computed columns, the properties of
which are listed as follows. Note that, all the properties are read only for table columns, and some are
editable for computed columns.
Property Name
Description
Array
Column Name
Specifies the name of the column in the raw database. This property is read only.
Currency
Displays whether to control the SQL type of formulas or summaries in which the BigDecimal
type fields are imported.
true - The formula or summary which is built with the BigDecimal type field will be
BigDecimal type, and its SQL Type value will be set to 3.
false - The normal data type will be used for the formula or summary.
Display Width
Expression
Name
Shows the display name of the column. This property is read only.
Nullable
Precision
Specifies the precision of the column's value. Specify the largest number of digits that can
ever occur in the column. Significant digits will be lost if the value is too small; however,
memory is wasted when too large a value is specified.
Data type: Integer
Scale
Specifies the number of digits to the right of the decimal point for the column's value.
Data type: Integer
SQL Type
Specifies the SQL type of the column defined in Java. Choose an option from the drop-down
list.
Data type: Integer
Query modifier
The properties of a query modifier are:
Property Name
Description
Description
Name
Query
Query Modifier
Structured
Displays the type for defining the WHERE string. If true, it is Structured; if false, it is String.
Data type: Boolean
Stored procedure
The properties of a stored procedure are:
Property Name
Description
Description
Maximum Duration
Specifies the maximum elapsed time allowed to fetch data from the data source when the
stored procedure runs, measured in seconds. If the value is set to zero or is blank, it means
the time will be unlimited.
For usage about the property, see Limiting the query run time and number of records.
Data type: Integer
Maximum Rows
Specifies the maximum number of rows that will be fetched from the data source when the
stored procedure runs. If the value is set to zero or is blank, it means the number will be
unlimited.
For usage about the property, see Limiting the query run time and number of records.
Data type: Integer
Name
Procedure Name
Qualifier
Read Only
Specifies whether or not the stored procedure will be read only. Choose an option from the
drop-down list.
default - Accepts the settings from the database that you are connecting to.
read only - Users will only be able to access the database in read-only mode. Setting the
property value to read only will speed up the transaction of the catalog.
Transaction Mode
Specifies the transaction mode for the stored procedure. Choose an option from the dropdown list.
default - Indicates the transaction information cannot be get from JDBC connection.
read uncommitted - Dirty reads, non-repeatable reads and phantom reads can occur.
This mode will speed up the transaction of the catalog.
read committed - Dirty reads are prevented; non-repeatable reads and phantom reads
can occur.
repeatable read - Dirty reads and non-repeatable reads are prevented; phantom reads
can occur.
serializable - Dirty reads, non-repeatable reads and phantom reads are prevented.
A stored procedure contains several columns, the properties of which are shown in the following topic:
Description
General
Array
Column Index
Column Name
Currency
Specifies whether to control the SQL type of formulas or summaries in which the BigDecimal
type fields are imported.
true - The formula or summary which is built with the BigDecimal type field will be
BigDecimal type, and its SQL Type value will be set to 3.
false - The normal data type will be used for the formula or summary.
Display Width
Specifies the display width of the column. Enter a numeric value to change the width.
Data type: Float
Length
Name
Nullable
Specifies the nullability of the column's value. Choose an option from the drop-down list.
Data type: Enumeration
Number Base
Precision
Specifies the precision of the column's value. Specify the largest number of digits that can
ever occur in the column. Significant digits will be lost if the value is too small; however,
memory is wasted when too large a value is specified.
Data type: Integer
Scale
Specifies the number of digits to the right of the decimal point for the column's value.
Data type: Integer
SQL Type
Specifies the SQL type of the column defined in Java. Choose an option from the drop-down
list.
Data type: Integer
Text Format
Auto Fit
Specifies whether to adjust the width and height of the column according to the contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Format
Specifies the display format of the column's value. The format varies with the column's data
type and can be defined manually.
Data type: String
Horizontal
Alignment
Specifies the horizontal justification of the text in the column. Choose an option from the dropdown list.
Data type: Enumeration
Italic
Strikethrough
Underline
Vertical Alignment
Specifies the vertical justification of the text in the column. Choose an option from the dropdown list.
Data type: Enumeration
Word Wrap
Padding
Bottom Padding
Specifies the space between the text and the bottom border of the column. Enter a numeric
value to change the padding.
Data type: Float
Left Padding
Specifies the space between the text and the left border of the column. Enter a numeric value
to change the padding.
Data type: Float
Right Padding
Specifies the space between the text and the right border of the column. Enter a numeric
value to change the padding.
Data type: Float
Top Padding
Specifies the space between the text and the top border of the column. Enter a numeric value
to change the padding.
Data type: Float
Geometry
Height
Specifies the height of the column, which takes effect when the column is inserted into a
report. Enter a numeric value to change the height. The default is 0 which means a height will
be assigned to the column by JReport automatically.
Data type: Float
Width
Specifies the width of the column, which takes effect when the column is inserted into a
report. Enter a numeric value to change the width. The default is 0 which means a width will
be assigned to the column by JReport automatically.
Data type: Float
Color
Background
Specifies the background color of the column. Choose a color from the drop-down list, or
enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Foreground
Specifies the foreground color of the column. Choose a color from the drop-down list, or enter
a hexadecimal RGB value (0xCCAA00).
Data type: String
Border
Border Color
Specifies the color of the border of the column. Choose a color from the drop-down list, or
enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Border Thickness
Specifies the width of the border in inches or centimeters. Enter a numeric value to change
the thickness.
Data type: Float
Bottom Line
Specifies the line style of the bottom border of the column. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the column. Choose a style from the drop-down
list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the column. Choose a style from the drop-down
list.
Data type: Enumeration
Shadow
Specifies whether or not to draw two shadowed borders, beneath and to the right of the
column.
Data type: Boolean
Shadow Color
Specifies the color of the border shadow. Choose a color from the drop-down list, or enter a
hexadecimal RGB value (0xCCAA00).
Data type: String
Top Line
Specifies the line style of the top border of the column. Choose a style from the drop-down
list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color with which to draw a pattern to fill the column. Choose a color from the
drop-down list, or enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the specified color.
vertical - The pattern will be made of vertical lines of the specified color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the specified
color.
diagonal - The pattern will be made of slash lines of the specified color.
Summary
The properties of a summary are:
Property Name
Description
General
Description
Display Width
Specifies the display width of the summary. Enter a numeric value to change the width.
Data type: Float
Expression
Function
Specifies the function of the summary (for more information, refer to Summary functions).
Data type: String
Group By
Specifies the criteria (break-by group) that the summary will be performed.
Data type: String
Length
Name
Number Base
Precision
Specifies the precision of the summary's value. Specify the largest number of digits that can
ever occur in the summary. Significant digits will be lost if the value is too small; however,
memory is wasted when too large a value is specified.
Data type: Integer
Scale
Specifies the number of digits to the right of the decimal point for the summary's value.
Data type: Integer
Special Function
If the group by field is of Numeric, String, Date or Time type, you can further define to
calculate the summary by specifying a special function.
Data type: String
SQL Type
Specifies the SQL type of the summary defined in Java. Choose an option from the drop-down
list.
Data type: Integer c
Summary On
Text Format
Auto Fit
Specifies whether to adjust the width and height of the summary according to the contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Format
Specifies the display format of the summary's value. The format varies with the summary's
data type and can be defined manually.
Data type: String
Horizontal
Alignment
Specifies the horizontal justification of the text in the summary. Choose an option from the
drop-down list.
Data type: Enumeration
Italic
Strikethrough
Underline
Vertical Alignment
Specifies the vertical justification of the text in the summary. Choose an option from the dropdown list.
Data type: Enumeration
Word Wrap
Padding
Bottom Padding
Specifies the space between the text and the bottom border of the summary. Enter a numeric
value to change the padding.
Data type: Float
Left Padding
Specifies the space between the text and the left border of the summary. Enter a numeric
value to change the padding.
Data type: Float
Right Padding
Specifies the space between the text and the right border of the summary. Enter a numeric
value to change the padding.
Data type: Float
Top Padding
Specifies the space between the text and the top border of the summary. Enter a numeric
value to change the padding.
Data type: Float
Geometry
Height
Specifies the height of the summary, which takes effect when the summary is inserted into a
report. Enter a numeric value to change the height. The default is 0 which means a proper
height will be specified to the summary by JReport automatically.
Data type: Float
Width
Specifies the width of the summary, which takes effect when the summary is inserted into a
report. Enter a numeric value to change the width. The default is 0 which means a proper
width will be specified to the summary by JReport automatically.
Data type: Float
Color
Background
Specifies the background color of the summary. Choose a color from the drop-down list, or
enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Foreground
Specifies the foreground color of the summary. Choose a color from the drop-down list, or
enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Border
Border Color
Specifies the color of the border of the summary. Choose a color from the drop-down list, or
enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Border Thickness
Specifies the width of the border in inches or centimeters. Enter a numeric value to change
the thickness.
Data type: Float
Bottom Line
Specifies the line style of the bottom border of the summary. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the summary. Choose a style from the drop-down
list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the summary. Choose a style from the dropdown list.
Data type: Enumeration
Shadow
Specifies whether or not to draw two shadowed borders, beneath and to the right of the
summary.
Data type: Boolean
Shadow Color
Specifies the color of the border shadow. Choose a color from the drop-down list, or enter a
hexadecimal RGB value (0xCCAA00).
Data type: String
Top Line
Specifies the line style of the top border of the summary. Choose a style from the drop-down
list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color with which to draw a pattern to fill the summary. Choose a color from the
drop-down list, or enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the specified color.
vertical - The pattern will be made of vertical lines of the specified color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the specified
color.
diagonal - The pattern will be made of slash lines of the specified color.
Table/View
The properties of a table/view are:
Property Name
Description
Description
Linked Parameter
Name
Qualifier
Schema
Table Name
Type
Specifies the type of the table/view. Choose an option from the drop-down list.
Table
Indicates the table type is Table in the database.
View
Indicates the table type is View in the database.
Alias
Indicates the table type is Alias in the database.
Synonym
Indicates the table type is Synonym in the database.
A table/view contains several columns, the properties of which are shown in the following topic:
Table/View column
Table/View column
The properties of a table/view column are:
Property Name
Description
General
Array
Column Name
Currency
Specifies whether to control the SQL type of formulas or summaries in which the BigDecimal
type fields are imported.
true - The formula or summary which is built with the BigDecimal type field will be
BigDecimal type, and its SQL Type value will be set to 3.
false - The normal data type will be used for the formula or summary.
Display Width
Specifies the display width of the column. Enter a numeric value to change the width.
Data type: Float
Name
Nullable
Specifies the nullability of the column's value. Choose an option from the drop-down list.
Data type: Enumeration
Precision
Specifies the precision of the column's value. Specify the largest number of digits that can
ever occur in the column. Significant digits will be lost if the value is too small; however,
memory is wasted when too large a value is specified.
Data type: Integer
Scale
Specifies the number of digits to the right of the decimal point for the column's value.
Data type: Integer
SQL Type
Specifies the SQL type of the column defined in Java. Choose an option from the drop-down
list.
Data type: Integer
Text Format
Auto Fit
Specifies whether to adjust the width and height of the column according to the contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Format
Specifies the display format of the column's value. The format varies with the column's data
type and can be defined manually.
Data type: String
Horizontal
Alignment
Specifies the horizontal justification of the text in the column. Choose an option from the dropdown list.
Data type: Enumeration
Italic
Strikeout
Underline
Vertical Alignment
Specifies the vertical justification of the text in the column. Choose an option from the dropdown list.
Data type: Enumeration
Word Wrap
Padding
Bottom Padding
Specifies the space between the text and the bottom border of the column. Enter a numeric
value to change the padding.
Data type: Float
Left Padding
Specifies the space between the text and the left border of the column. Enter a numeric value
to change the padding.
Data type: Float
Right Padding
Specifies the space between the text and the right border of the column. Enter a numeric
value to change the padding.
Data type: Float
Top Padding
Specifies the space between the text and the top border of the column. Enter a numeric value
to change the padding.
Data type: Float
Geometry
Height
Specifies the height of the column, which takes effect when the column is inserted into a
report. Enter a numeric value to change the height. The default is 0 which means a height will
be assigned to the column by JReport automatically.
Data type: Float
Width
Specifies the width of the column, which takes effect when the column is inserted into a
report. Enter a numeric value to change the width. The default is 0 which means a width will
be assigned to the column by JReport automatically.
Data type: Float
Color
Background
Specifies the background color of the column. Choose a color from the drop-down list, or
enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Foreground
Specifies the foreground color of the column. Choose a color from the drop-down list, or enter
a hexadecimal RGB value (0xCCAA00).
Data type: String
Border
Border Color
Specifies the color of the border of the column. Choose a color from the drop-down list, or
enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Border Thickness
Specifies the width of the border in inches or centimeters. Enter a numeric value to change
the thickness.
Data type: Float
Bottom Line
Specifies the line style of the bottom border of the column. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the column. Choose a style from the drop-down
list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the column. Choose a style from the drop-down
list.
Data type: Enumeration
Shadow
Specifies whether or not to draw two shadowed borders, beneath and to the right of the
column.
Data type: Boolean
Shadow Color
Specifies the color of the border shadow. Choose a color from the drop-down list, or enter a
hexadecimal RGB value (0xCCAA00).
Data type: String
Top Line
Specifies the line style of the top border of the column. Choose a style from the drop-down
list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color with which to draw a pattern to fill the column. Choose a color from the
drop-down list, or enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the specified color.
vertical - The pattern will be made of vertical lines of the specified color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the specified
color.
diagonal - The pattern will be made of slash lines of the specified color.
Description
Class Name
Specifies the full name (including package name) of the class represented by the UDS. The
class you entered should actually exist and can be found by JReport Designer, which means
the class should be in the class path of the system environment.
Data type: String
Description
Maximum Duration
Specifies the maximum elapsed time allowed to fetch data from the data source when the
UDS runs, measured in seconds. If the value is set to zero or is blank, it means the time will
be unlimited.
For usage about the property, see Limiting the query run time and number of records.
Data type: Integer
Maximum Rows
Specifies the maximum number of rows that will be fetched from the data source when the
UDS runs. If the value is set to zero or is blank, it means the number will be unlimited.
For usage about the property, see Limiting the query run time and number of records.
Data type: Integer
Name
Parameter
Specify Metadata
A UDS contains several columns, the properties of which are shown in the following topic:
UDS column
UDS column
The properties of a UDS column are:
Property Name
Description
General
Array
Specifies the index of automatic group. The start index is 0, and if do not group by this field
automatically, the index is -1.
Data type: Integer
Column Index
Column Mapping
Index
Column Name
Specifies whether to control the SQL type of formulas or summaries in which the BigDecimal
type fields are imported.
true - The formula or summary which is built with the BigDecimal type field will be
BigDecimal type, and its SQL Type value will be set to 3.
false - The normal data type will be used for the formula or summary.
Display Width
Specifies the display width of the column. Enter a numeric value to change the width.
Data type: Float
Length
Name
Nullable
Specifies the nullability of the column's value. Choose an option from the drop-down list.
Data type: Enumeration
Number Base
Path String
Specifies the path of the column, which is used to identify the column in tree.
Data type: String
Precision
Specifies the precision of the column's value. Specify the largest number of digits that can
ever occur in the column. Significant digits will be lost if the value is too small; however,
memory is wasted when too large a value is specified.
Data type: Integer
Scale
Specifies the number of digits to the right of the decimal point for the column's value.
Data type: Integer
SQL Type
Specifies the SQL type of the column defined in Java. Choose an option from the drop-down
list.
Data type: Integer
Text Format
Auto Fit
Specifies whether to adjust the width and height of the column according to the contents.
Data type: Boolean
Bold
Font Face
Specifies the font of the text. Choose an option from the drop-down list.
Data type: Enumeration
Font Size
Specifies the font size of the text. Enter an integer value to change the size.
Data type: Integer
Horizontal Alignment Specifies the horizontal justification of the text in the column. Choose an option from the
drop-down list.
Data type: Enumeration
Italic
Strikethrough
Underline
Vertical Alignment
Specifies the vertical justification of the text in the column. Choose an option from the dropdown list.
Data type: Enumeration
Word Wrap
Padding
Bottom Padding
Specifies the space between the text and the bottom border of the column. Enter a numeric
value to change the padding.
Data type: Float
Left Padding
Specifies the space between the text and the left border of the column. Enter a numeric
value to change the padding.
Data type: Float
Right Padding
Specifies the space between the text and the right border of the column. Enter a numeric
value to change the padding.
Data type: Float
Top Padding
Specifies the space between the text and the top border of the column. Enter a numeric
value to change the padding.
Data type: Float
Geometry
Height
Specifies the height of the column, which takes effect when the column is inserted into a
report. Enter a numeric value to change the height. The default is 0 which means a height
will be assigned to the column by JReport automatically.
Data type: Float
Width
Specifies the width of the column, which takes effect when the column is inserted into a
report. Enter a numeric value to change the width. The default is 0 which means a width will
be assigned to the column by JReport automatically.
Data type: Float
Color
Background
Specifies the background color of the column. Choose a color from the drop-down list, or
enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Foreground
Specifies the foreground color of the column. Choose a color from the drop-down list, or
enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Border
Border Color
Specifies the color of the border of the column. Choose a color from the drop-down list, or
enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Border Thickness
Specifies the width of the border in inches or centimeters. Enter a numeric value to change
the thickness.
Data type: Float
Bottom Line
Specifies the line style of the bottom border of the column. Choose a style from the dropdown list.
Data type: Enumeration
Left Line
Specifies the line style of the left border of the column. Choose a style from the drop-down
list.
Data type: Enumeration
Right Line
Specifies the line style of the right border of the column. Choose a style from the drop-down
list.
Data type: Enumeration
Shadow
Specifies whether or not to draw two shadowed borders, beneath and to the right of the
column.
Data type: Boolean
Shadow Color
Specifies the color of the border shadow. Choose a color from the drop-down list, or enter a
hexadecimal RGB value (0xCCAA00).
Data type: String
Top Line
Specifies the line style of the top border of the column. Choose a style from the drop-down
list.
Data type: Enumeration
Pattern
Pattern Color
Specifies the color with which to draw a pattern to fill the column. Choose a color from the
drop-down list, or enter a hexadecimal RGB value (0xCCAA00).
Data type: String
Pattern Style
Specifies the style of the pattern. Choose an option from the drop-down list.
horizontal - The pattern will be made of horizontal lines of the specified color.
vertical - The pattern will be made of vertical lines of the specified color.
grid - The pattern will be an overlapping of horizontal and vertical lines of the specified
color.
diagonal - The pattern will be made of slash lines of the specified color.
Description
General
Date Format
Description
Name
Specifies the name of the connection which, by default, is the same as the connection
URL, but can also be a user defined name for the connection.
Data type: String
Name Pattern
Specifies the password used for accessing the WSDL file through the WSDL URI.
Data type: String
Pre-join
Specifies whether or not to apply the pre-join information defined on the data source in
which the connection is set when building a query or defining join relationships in
business cubes in the same data source.
Data type: Boolean
Time Format
Time Out
Timestamp Format
URI
Specifies the URI to get the WSDL file. This property is read only.
Data type: String
User
Specifies the user name used for accessing the WSDL file through the WSDL URI.
Data type: String
Security Configuration
Client Key Alias Name
Specifies the alias name which is used as client signature in the key store. This property
is read only.
Data type: String
Specifies the password for the alias name which is used as client signature in the key
store. This property is read only.
Data type: String
Specifies the URI to get the key store file. This property is read only.
Data type: String
Specifies the password to open the key store file. This property is read only.
Data type: String
Specifies the type for the key store. This property is read only.
Data type: String
Security Password
Specifies the password for the username token to be used. This property is read only.
Data type: String
Specifies the username for the username token to be used. This property is read only.
Data type: String
Specifies the alias name which is used to get the server-side certification or public key in
the key store. This property is read only.
Data type: String
Specifies the password for the alias name which is used to get the server-side
certification or public key in the key store. This property is read only.
Data type: String
XML connection
The properties of an XML connection are:
Property Name
Description
Date Format
Description
Name
Name Pattern
Specifies whether or not catalog or schema is used in data manipulation. Choose an option
from the drop-down list.
Specifies whether or not to apply the pre-join information defined on the data source in which
the connection is set when building a query or defining join relationships in business cubes in
the same data source.
Data type: Boolean
Time Format
Timestamp Format
XML schema
XML schema
The properties of an XML schema are:
Property Name
Description
Data Type
Specifies the data type of the element or attribute. This property on the reference of element
cannot be modified.
Default Value
Displays the value for the element or attribute, of which there is no specific value in the XML
instance. This property is read only.
Fixed Value
Displays the value for the element or attribute. This property is read only.
Format Pattern
Displays the format pattern for data of Date, Time or DateTime type. This property is read
only.
Format Pattern Type Specifies the format pattern type for the element, attribute or reference of element. It is
editable only for data of Date, Time or DateTime type.
Is Multiple
Indicates whether or not the element occurs more than once in the XML instance. This
property is read only.
List
Specifies whether or not to set the data type of the element or attribute as List. This property
on the reference of element cannot be modified.
List Delimiter
Displays the delimiter to separate items in a list. This property is read only.
Name
Displays the name of the element, attribute or reference of element in the XML instance. This
property is read only.
Related topics:
Appendixes
The following are some additional information about JReport Designer:
Appendix 3: Language and region name list for National Language Support
Date Component
Presentation
Examples
Era designator
Text
AD
Year
Year
1996; 96
Month in year
Month
July; Jul; 07
Week in year
Number
27
Day in year
Number
189
Day in month
Number
10
Number
Day in Week
Text
Tuesday; Tue
Am/pm marker
Text
PM
Number
Number
24
Number
Number
12
Minute in hour
Number
30
Second in minute
Number
55
Millisecond
Number
978
Time zone
Time zone
-0800
Year
The pattern string of year can be formatted as two types - yyyy and yy:
If the pattern string - yyyy is used to format year, the year will be interpreted literally, regardless
of the number of digits. Therefore, if the pattern MM/dd/yyyy is used, 08/25/22 will be parsed to
Aug 25, 22 A.D.
If the abbreviated pattern string - yy is used to format year, the abbreviated year relative to some
century must be interpreted. To do this, dates will be adjusted to be within 80 years before and 20
years after the current time. For example, a pattern of MM/dd/yy and the current time is Aug 25,
1998, the string 05/21/15 would be interpreted as May 21, 2015 while the string 06/02/88 would
be interpreted as Jun 2, 1988.
When the year string of a datetime data in the XML schema is parsing, only strings consisting of
exactly two digits will be parsed into the default century. Any other numeric string, such as a onedigit string, a three or more digit string, or a two-digit string but one is a sign (for example, -2), is
interpreted literally. So 03/06/4 or 03/06/004 is parsed, using the pattern of MM/dd/yy, as Mar 6, 4
AD. Also, 03/06/-4 is parsed as Mar 6, 5 BC.
Month
If the pattern string is MMMM, the month is interpreted as text; if the pattern string is MM, the
month will be interpreted as a number.
General time zone
Time zones are interpreted as text if they have names. For time zones representing a GMT offset
value, the following syntax is used:
GMTOffsetTimeZone:
GMT Sign Hours: Minutes
Sign: one of
+ Hours:
Digit
Digit Digit
Minutes:
Digit Digit
Digit: one of
0 1 2 3 4 5 6 7 8 9
Hours must be between 0 and 23, and Minutes must be between 00 and 59.
RFC822TimeZone:
Sign TwoDigitHours Minutes
TwoDigitHours:
Digit Digit
UPC-A
UPC-E
EAN-13
EAN-8
Code 39
Code 128
Codabar
Code 128A
Code 128B
Code 128C
UPC-A
UPC-A (Universal Product Code-A) is of fixed length. It encodes a twelve-digit numeric only number.
The final digit is a check digit, which cannot be omitted. The usual height of a UPC-A bar code is one
inch. The reduced size is 80% of the nominal size.
UPC-A is a subset of EAN-13. In fact, a UPC-A barcode is an EAN-13 barcode with the first EAN-13
number system digit set to "0". This means that any hardware or software capable of reading EAN-13
is automatically capable of reading UPC-A.
Usually, the number system digit is printed on the left of the barcode, and the check digit on the right;
while the manufacturer and product codes are printed just below the barcode, separated by a guard
bar.
Both the left and the right guard bar are encoded with 101 (bar space bar).
Usual X dimension is 13 mils. A magnification factor of 0.8 to 2.0 is permitted and, as a result, enables
a printable X dimension values range of 10.4 to 24 mils.
UPC-E
UPC-E (Universal Product Code-E) is fixed in length and is a compressed six-digit code used for
marking small packages including magazines and paperback books. The printed value of the UPC-E
code is a twelve-digit code. UPC-E symbols are UPC-A symbols that have been zero suppressed (i.e.
consecutive zeros are not included in the symbol). The nominal height for the UPC-E bar code is one
inch. The reduced size is 80% of the nominal size.
The left guard bar is encoded with 101, and the right guard bar is encoded with 010101.
EAN-13
The EAN/JAN-13 is of fixed length and is similar to the UPC-A symbology, but encodes a 13th digit.
Also, the 12th and 13th digits of an EAN-13 may represent a country code in its entirety or just the
beginning of one, and can vary from 2 to 3 digits. The codes 00-04 and 06-09 have been assigned to
the United States. The nominal height for the EAN-13 bar code is one inch. The reduced size is 80% of
the nominal size.
EAN-8
The EAN-8 is fixed length and is similar to the UPC-E code, but includes two more digits for the country
code. The nominal height for the EAN-8 bar code is one inch. The reduced size is 80% of the nominal
size.
Code 39
Code 39 is of variable length and is the most frequently used symbology in industrial bar code systems
today. The principal feature is that it encodes messages using a full alphanumeric character set. Three
of the nine elements (bars) are wide and six elements are narrow. The Code 39 barcode uses four
special characters "$", "/", "+", and "%" which allow a full ASCII character set when paired with
alphanumeric characters.
Code 39 is designed to encode 26 upper case letters, 10 digits and 7 special characters:
A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z
0, 1, 2, 3, 4, 5, 6, 7, 8, 9
-, ., *, $, /, +, %, SPACE.
It is called code 39 or three of nine because each encoded character is made up of 5 bars and 4 spaces
to make a total of 9 elements. Also 3 out of the 9 elements are always wide.
The height of the bars must be at least 0.15 times the symbol's length or 0.25 inches, whichever is
larger.
Code 39 is a discrete symbology. Two adjacent characters are separated by an inter-character gap. To
achieve good barcode quality, the width of the inter-character gap should equal the width of the
narrowest element, called X.
Code39 requires a starting quiet zone with a minimum 10 times the X dimension or 0.10 inch,
whichever is greater. The same width requirement also applies to the trailing quiet zone.
Code 128
Code 128 is of variable length and encodes a full 128 ASCII character set. Each character is
represented by 11 modules that can be one of four bar widths. Also, the encoding should not exceed
232 characters (including the starting and ending codes).
Among all the common linear symbologies, Code 128 is the most flexible. It supports both alpha and
numeric characters easily, has the highest number of characters per inch, and is of variable length.
Code 128 is usually the best choice when implementing a new symbology.
Check code is optional. Refer to the Code 128 code table to calculate it.
In an open system, the minimum value of the X dimension is 7.5 mils, and the minimum bar height is
15 percent of the symbol length or 0.25 inches, whichever is greater. The starting and trailing quiet
zones are at least 0.25 inches wide.
Codabar
Character set: 0 1 2 3 4 5 6 7 8 9 - $ . : / + *
Starting code and ending code can be A, B, C or D.
Every character is represented by 4 black bars + 3 white spaces. Variable length, maximum 32
characters (including the starting and ending codes).
Code table
Code
Logic
0000011
0000110
0001001
1100000
0010010
1000010
0100001
0100100
0110000
1001000
0011010
0101001
0001011
0001110
0001100
0011000
1010100
1010001
1000101
0010101
Digit 1, 3, 5 and 7 - black bar, 0 represents slim bar, and 1 represents thick bar.
Digit 2, 4 and 6 - white space, 0 represents slim space, and 1 represents thick space.
Code 128A
Code 128A allows for upper case characters, punctuation and numbers. Lower case characters create
several special functions in Code 128A such as a return or tab. It may be necessary to use Code 128A
to manually encode these functions in a barcode.
Code 128A includes all of the standard upper case alphanumeric keyboard characters plus the control
and special characters.
Code 128B
Code 128B is the most common because it encodes everything from ASCII 32 to ASCII 126. It allows
for upper and lower case letters, punctuation, numbers and a few select functions.
Code 128B includes all of the standard upper and lower case alphanumeric keyboard characters and
special characters.
Code 128C
Code 128C encodes only numbers containing an even number of characters. Since the numbers are
"interleaved" into pairs, with two numbers encoded into every barcode character, a very high-density
barcode is created. If the number that is to be encoded does not contain an even number of
characters, a leading zero will be added.
Code 128C includes a set of 100 numeric data character pairs from 00 through 99 inclusive, and also
includes special characters. This enables double-density numeric digits (two digits per bar coded
character) to be encoded. Data encoded in a Code 128C must contain an even number of characters. If
the data contains an odd number of characters, a zero (0) will be inserted at the beginning of the bar
code.
Language
Two-letter lower-case symbols
Language
aa
Afar
ab
Abkhazian
af
Afrikaans
am
Amharic
ar
Arabic
as
Assamese
ay
Aymara
az
Azerbaijani
ba
Bashkir
be
Byelorussian
bg
Bulgarian
bh
Bihari
bi
Bislama
bn
Bengali; Bangla
bo
Tibetan
br
Breton
ca
Catalan
co
Corsican
cs
Czech
cy
Welsh
da
Danish
de
German
dz
Bhutani
el
Greek
en
English
eo
Esperanto
es
Spanish
et
Estonian
eu
Basque
fa
Persian
fi
Finnish
fj
Fiji
fo
Faroese
fr
French
fy
Frisian
ga
Irish
gd
ScotsGaelic
gl
Galician
gn
Guarani
gu
Gujarati
ha
Hausa
he
hi
Hindi
hr
Croatian
hu
Hungarian
hy
Armenian
ia
Interlingua
id
ie
Interlingue
ik
Inupiak
is
Icelandic
it
Italian
iu
Inuktitut
ja
Japanese
jw
Javanese
ka
Georgian
kk
Kazakh
kl
Greenlandic
km
Cambodian
kn
Kannada
ko
Korean
ks
Kashmiri
ku
Kurdish
ky
Kirghiz
la
Latin
ln
Lingala
lo
Laothian
lt
Lithuanian
lv
Latvian, Lettish
mg
Malagasy
mi
Maori
mk
Macedonian
ml
Malayalam
mn
Mongolian
mo
Moldavian
mr
Marathi
ms
Malay
mt
Maltese
my
Burmese
na
Nauru
ne
Nepali
nl
Dutch
no
Norwegian
oc
Occitan
om
(Afan) Oromo
or
Oriya
pa
Punjabi
pl
Polish
ps
Pashto, Pushto
pt
Portuguese
qu
Quechua
rm
Rhaeto-Romance
rn
Kirundi
ro
Romanian
ru
Russian
rw
Kinyarwanda
sa
Sanskrit
sd
Sindhi
sg
Sangho
sh
Serbo-Croatian
si
Sinhalese
sk
Slovak
sl
Slovenian
sm
Samoan
sn
Shona
so
Somali
sq
Albanian
sr
Serbian
ss
Siswati
st
Sesotho
su
Sundanese
sv
Swedish
sw
Swahili
ta
Tamil
te
Telugu
tg
Tajik
th
Thai
ti
Tigrinya
tk
Turkmen
tl
Tagalog
tn
Setswana
to
Tonga
tr
Turkish
ts
Tsonga
tt
Tatar
tw
Twi
ug
Uighur
uk
Ukrainian
ur
Urdu
uz
Uzbek
vi
Vietnamese
vo
Volapuk
wo
Wolof
xh
Xhosa
yi
yo
Yoruba
za
Zhuang
zh
Chinese
zu
Zulu
Region
Region
A2
AFGHANISTAN
AF
ALBANIA
AL
ALGERIA
DZ
AMERICAN SAMOA
AS
ANDORRA
AD
ANGOLA
AO
ANGUILLA
AI
ANTARCTICA
AQ
AG
ARGENTINA
AR
ARMENIA
AM
ARUBA
AW
AUSTRALIA
AU
AUSTRIA
AT
AZERBAIJAN
AZ
BAHAMAS
BS
BAHRAIN
BH
BANGLADESH
BD
BARBADOS
BB
BELARUS
BY
BELGIUM
BE
BELIZE
BZ
BENIN
BJ
BERMUDA
BM
BHUTAN
BT
BOLIVIA
BO
BA
BOTSWANA
BW
BOUVET ISLAND
BV
BRAZIL
BR
BN
BULGARIA
BG
BURKINA FASO
BF
BURUNDI
BI
CAMBODIA
KH
CAMEROON
CM
CANADA
CA
CAPE VERDE
CV
CAYMAN ISLANDS
KY
CF
CHAD
TD
CHILE
CL
CHINA
CN
CHRISTMAS ISLAND
CX
CC
COLOMBIA
CO
COMOROS
KM
CD
CG
COOK ISLANDS
CK
COSTA RICA
CR
COTE D'IVOIRE
CI
HR
CUBA
CU
CYPRUS
CY
CZECH REPUBLIC
CZ
DENMARK
DK
DJIBOUTI
DJ
DOMINICA
DM
DOMINICAN REPUBLIC
DO
EAST TIMOR
TL
ECUADOR
EC
EGYPT
EG
EL SALVADOR
SV
EQUATORIAL GUINEA
GQ
ERITREA
ER
ESTONIA
EE
ETHIOPIA
ET
FK
FAROE ISLANDS
FO
FIJI
FJ
FINLAND
FI
FRANCE
FR
FRANCE, METROPOLITAN
FX
FRENCH GUIANA
GF
FRENCH POLYNESIA
PF
TF
GABON
GA
GAMBIA
GM
GEORGIA
GE
GERMANY
DE
GHANA
GH
GIBRALTAR
GI
GREECE
GR
GREENLAND
GL
GRENADA
GD
GUADELOUPE
GP
GUAM
GU
GUATEMALA
GT
GUINEA
GN
GUINEA-BISSAU
GW
GUYANA
GY
HAITI
HT
HM
HONDURAS
HN
HONG KONG
HK
HUNGARY
HU
ICELAND
IS
INDIA
IN
INDONESIA
ID
IR
IRAQ
IQ
IRELAND
IE
ISRAEL
IL
ITALY
IT
JAMAICA
JM
JAPAN
JP
JORDAN
JO
KAZAKHSTAN
KZ
KENYA
KE
KIRIBATI
KI
KP
KOREA, REPUBLIC OF
KR
KUWAIT
KW
KYRGYZSTAN
KG
LA
LATVIA
LV
LEBANON
LB
LESOTHO
LS
LIBERIA
LR
LY
LIECHTENSTEIN
LI
LITHUANIA
LT
LUXEMBOURG
LU
MACAU
MO
MK
MADAGASCAR
MG
MALAWI
MW
MALAYSIA
MY
MALDIVES
MV
MALI
ML
MALTA
MT
MARSHALL ISLANDS
MH
MARTINIQUE
MQ
MAURITANIA
MR
MAURITIUS
MU
MAYOTTE
YT
MEXICO
MX
FM
MOLDOVA, REPUBLIC OF
MD
MONACO
MC
MONGOLIA
MN
MONTSERRAT
MS
MOROCCO
MA
MOZAMBIQUE
MZ
MYANMAR
MM
NAMIBIA
NA
NAURU
NR
NEPAL
NP
NETHERLANDS
NL
NETHERLANDS ANTILLES
AN
NEW CALEDONIA
NC
NEW ZEALAND
NZ
NICARAGUA
NI
NIGER
NE
NIGERIA
NG
NIUE
NU
NORFOLK ISLAND
NF
MP
NORWAY
NO
OMAN
OM
PAKISTAN
PK
PALAU
PW
PA
PG
PARAGUAY
PY
PERU
PE
PHILIPPINES
PH
PITCAIRN
PN
POLAND
PL
PORTUGAL
PT
PUERTO RICO
PR
QATAR
QA
REUNION
RE
ROMANIA
RO
RUSSIAN FEDERATION
RU
RWANDA
RW
KN
SAINT LUCIA
LC
VC
SAMOA
WS
SAN MARINO
SM
ST
SAUDI ARABIA
SA
SENEGAL
SN
SEYCHELLES
SC
SIERRA LEONE
SL
SINGAPORE
SG
SK
SLOVENIA
SI
SOLOMON ISLANDS
SB
SOMALIA
SO
SOUTH AFRICA
ZA
GS
SPAIN
ES
SRI LANKA
LK
ST. HELENA
SH
PM
SUDAN
SD
SURINAME
SR
SJ
SWAZILAND
SZ
SWEDEN
SE
SWITZERLAND
CH
SY
TAIWAN
TW
TAJIKISTAN
TJ
TZ
THAILAND
TH
TOGO
TG
TOKELAU
TK
TONGA
TO
TT
TUNISIA
TN
TURKEY
TR
TURKMENISTAN
TM
TC
TUVALU
TV
UGANDA
UG
UKRAINE
UA
AE
UNITED KINGDOM
GB
UNITED STATES
US
UM
URUGUAY
UY
UZBEKISTAN
UZ
VANUATU
VU
VA
VENEZUELA
VE
VIET NAM
VN
VG
VI
WF
WESTERN SAHARA
EH
YEMEN
YE
YUGOSLAVIA
YU
ZAMBIA
ZM
ZIMBABWE
ZW