blob: 8a7146049c9951b27437a3be2e5856343cc4ca71 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 transitional//EN">
<html>
<head>
<title>Eclipse BIRT Overview</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>
<!-- Google Tag Manager -->
<noscript><iframe src="//www.googletagmanager.com/ns.html?id=GTM-PW8LFV"
height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'//www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-PW8LFV');</script>
<!-- End Google Tag Manager -->
<p class="head">BIRT Overview</p>
<p class="subhead">Integrating BIRT into your Application</p>
<h1>BIRT in a J2EE Application</h1>
<p>
The BIRT Report Engine is packaged as a JAR file that you add to your J2EE
application. The Report Engine is a series of POJOs (Plain Old Java Objects)
that your JSP pages can call to integrate reporting into your application.
<p>
BIRT also delivers an example web application that can be deployed to an
existing application server.
</p>
<!-- Need more info here. -->
<img src="../project/chart1.jpg" width="658" height="237"> <br>
<!-- Revise image to show the user's web app. -->
<p>
BIRT has four main integration points with your application:
<dl class="arrow-list">
<dt>Parameter UI
<dd>Most reports allow the user to specify some kind of input, called a
<i>report parameter</i>. For example, a customer report might ask for the
customer to display. Your parameter page can be static: custom designed
for each report. Or, you can use a dynamic page powered by parameter
meta-data so that a single page works for any report. BIRT also supports
the concept of dynamic and cascaded parameters. This allows parameters to be
tied to Data Sets defined within the report.
<dt>Running the Report
<dd>When the user submits the parameter form, your web application passes the
parameters to the BIRT report engine which reads the report design file,
reads the data, and produces the report output. BIRT uses the term
<i>factory</i> when the engine runs a report.
<dt>Data Access
<dd>Reports obtain data from your application as explained above. Java applications
often provide data to the BIRT factory via Java objects.
<dt>Viewing
<dd>BIRT uses a Java servlet, called the viewer, to enable the user to view the output
of the report in paginated HTML. The viewer also supports exporting data to CSV, parameter
collection and table of contents functionality.
</dl>
<h1>Example Viewer</h1>
<p>
The BIRT project provides a sample "viewer" to help you get get started. The
sample viewer is also used to preview reports within Eclipse: BIRT includes an
Apache Tomcat server invoked each time you preview your report. The viewer
can also be used in any JSP-compliant J2EE server.
<p>
<!-- List supported servers -->
BIRT Release 2.0 provides web output as a single page, paginated HTML, and PDF. Additionally the
viewer allows exporting the data to CSV and Table of Contents functionality.<p>
More information about the sample viewer is available in the <a href="../deploy">
integration</a> section.</body></html>