blob: 7201fe7b8bca43afc9e4110016cb29a3f6de321a [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 transitional//EN">
<html>
<head>
<title>BIRT Tutorial</title>
<link rel="stylesheet" href="../style/compose.css" type="text/css">
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
</head>
<body>
<p class="head">BIRT Tutorial</p>
<p class="subhead">Testing a Report</p>
<h1>Test your Report</h1>
<p>
We're now ready to test the report layout. We verified the
data set earlier, so now we want to verify that the report is presenting the
data as we expected.
<p>
We preview the report by clicking on the Preview tab within the report editor.
If our report had parameters, the GUI would ask us for them. But, since this
report does not have parameters, it simply runs.
<p>
The window that appears is a simple web browser, and displays the report in
HTML. The report appears as a single page. This works best for small
amount data sets. Since the sample database has quite a bit of data data, we used
a WHERE clause to limit the amount of data. We could also use
a report parameter and a data set filter to limit the amount of data displayed
at any one time.</p>
<p class="caution"><span class="caution-head">Release 1.0.1 Note:</span>
BIRT Release 1.0.1 displays the report as a single
HTML page. Future releases will display the report as a series of pages.</p>
<p>
Seeing the report in the preview suggests a number of ways we can improve the
report's appearance:
<ul>
<li>Add a title to the top of the report.
<li>Add some color to enhance the column headings.
<li>Shrink the size of the city and state columns.
<li>Add some color to make the state and city group headers stand out.
<li>Format the phone numbers.
<li>Sort customers by name.</ul>
Before we fix these issues, let's look at other ways to preview the report.
<h1>Preview as HTML</h1>
<p>
The Preview tab is handy for a quick review of your report. BIRT runs the report each
time you switch to Preview. However, you can have either the Layout or the
Preview tab open, but not both.
<p>
Instead, we can preview the report in a separate window. Find the Preview button in
the toolbar. Use the little arrow next to it to open the pull-down. You can then
Preview as HTML in a separate window. This allows you to switch back and forth
between your layout editor and your preview without rerunning the report.
<h1>
Preview as PDF</h1>
<p>
You can also choose Preview as PDF. This converts the layout to a multi-page
PDF format.
</p>
<p class="caution"><span class="caution-head">Release 1.0.1 Note:</span>
BIRT Release 1.0.1 uses the Apache XML-FO Processor
(FOP) package. Limitations in the current version of FOP cause problems with
the way the report appears in PDF. The BIRT team is aware of the problems and
is working to address them in a later release.</p>
</body>
</html>