Author: ochikvina
Date: 2009-05-07 11:56:21 -0400 (Thu, 07 May 2009)
New Revision: 15111
Added:
trunk/birt/docs/en/master_output.xml
Log:
https://jira.jboss.org/jira/browse/JBDS-717 - master_output.xml is generated;
Added: trunk/birt/docs/en/master_output.xml
===================================================================
--- trunk/birt/docs/en/master_output.xml (rev 0)
+++ trunk/birt/docs/en/master_output.xml 2009-05-07 15:56:21 UTC (rev 15111)
@@ -0,0 +1,843 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+"http://www.docbook.org/xml/4.3/docbookx.dtd"
+
+[
+<!ENTITY introduction SYSTEM "modules/introduction.xml">
+<!ENTITY birt_integration_with_seam SYSTEM
"modules/birt_integration_with_seam.xml">
+<!ENTITY hibernate_datasource SYSTEM "modules/hibernate_datasource.xml">
+<!ENTITY birt_reports_deployment SYSTEM
"modules/birt_reports_deployment.xml">
+
+<!ENTITY gsglink "../../GettingStartedGuide/html_single/index.html">
+]><book
xmlns:diffmk="http://diffmk.sf.net/ns/diff">
+ <bookinfo>
+ <title><diffmk:wrapper diffmk:change="changed">Birt Plugin
Integration Reference Guide</diffmk:wrapper></title>
+
+
<author><firstname>Anastasiya</firstname><surname>Bogachuk</surname><email>abogachuk(a)exadel.com</email></author>
+ <author diffmk:change="added"><firstname
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Olga</diffmk:wrapper></firstname><surname
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Chikvina</diffmk:wrapper></surname></author>
+
+ <pubdate>August 2008</pubdate>
+ <copyright>
+ <year>2008</year>
+ <year>2009</year>
+ <holder>JBoss, a division of Red Hat</holder>
+ </copyright>
+ <releaseinfo>
+ Version: 1.0.0.GA
+ </releaseinfo>
+
+
+<abstract>
+ <title></title>
+ <para>
+ <ulink
url="http://download.jboss.org/jbosstools/nightly-docs/en/jboss_birt...
version</ulink>
+ </para>
+</abstract>
+
+
+ </bookinfo>
+ <toc></toc>
+
+
+<chapter id="introduction"
xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/introduction.xml">
+ <?dbhtml filename="introduction.html"?>
+
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>Eclipse</keyword>
+ <keyword>JBoss</keyword>
+ <keyword>JBoss Tools</keyword>
+ <keyword>JBDS</keyword>
+ <keyword>BIRT Plugin</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Introduction</title>
+
+ <section>
+
+ <title>What is BIRT?</title>
+ <para><diffmk:wrapper diffmk:change="changed">BIRT plugin
is an Eclipse-based open source reporting system for web applications
+ based on Java and J2EE. BIRT consists of two main components: a report
designer based on
+ Eclipse, and a runtime component that can be added to your app server. BIRT
also offers
+ a charting engine that lets you add charts to your own Web
application.</diffmk:wrapper></para>
+ <para>With the help of BIRT you can generate a great number of reports to
be used in your
+ application:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Lists</para>
+ </listitem>
+ <listitem>
+ <para>Charts</para>
+ </listitem>
+ <listitem>
+ <para>Crosstabs, or cross-tabulation, or matrix</para>
+ </listitem>
+ <listitem>
+ <para>Letters and Documents</para>
+ </listitem>
+ <listitem>
+ <para>Compound Reports</para>
+ </listitem>
+ </itemizedlist>
+
+ <para><diffmk:wrapper diffmk:change="added">You can find
more detailed information on the BIRT plugin, its report types and
+ anatomy on the </diffmk:wrapper><ulink
url="http://www.eclipse.org/birt/phoenix/intro/"><diffmk:...
diffmk:change="changed">BIRT
Homepage</diffmk:wrapper></ulink>.</para>
+
+ <para><diffmk:wrapper diffmk:change="added">To understand
the basic BIRT concepts and to know how to create a basic BIRT report,
+ refer to the </diffmk:wrapper><ulink diffmk:change="added"
url="http://www.eclipse.org/birt/phoenix/tutorial/"><diff...
diffmk:change="added">Eclipse BIRT
+ Tutorials</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added">. What extensions </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">JBoss
Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> provides for
+ Eclipse BIRT you'll find out in the next
sections.</diffmk:wrapper></para>
+ </section>
+
+ <section diffmk:change="added">
+ <title><diffmk:wrapper diffmk:change="changed">JBoss BIRT
Integration Functionality Overview</diffmk:wrapper></title>
+
+ <para><diffmk:wrapper diffmk:change="added">This reference
guide describes the one module of the </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">JBoss
Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> project which
+ performs the integration with BIRT. The integration includes the following
functionalities:</diffmk:wrapper></para>
+ <itemizedlist>
+ <listitem>
+ <para><diffmk:wrapper
diffmk:change="changed">Hibernate ODA driver that includes a dialog to create
HQL queries with
+ syntax-highlighting, content-assist, formatting as well as other
functionalities
+ available in the HQL editor. There is also a possibility to add
+ parameters.</diffmk:wrapper></para>
+ </listitem>
+ <listitem>
+ <para><diffmk:wrapper
diffmk:change="changed">possibility to add JBoss BIRT functionality to the
standard Seam web
+ project</diffmk:wrapper></para>
+ </listitem>
+ <listitem>
+ <para><diffmk:wrapper diffmk:change="changed">BIRT
JSF/Seam control</diffmk:wrapper></para>
+ </listitem>
+ <listitem>
+ <para><diffmk:wrapper
diffmk:change="changed">deployment of BIRT reports within web projects (Seam,
JSF, etc.)</diffmk:wrapper></para>
+ </listitem>
+ </itemizedlist>
+
+ <para><diffmk:wrapper diffmk:change="added">To enable
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss
Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> integration with BIRT you are intended to
+ have the next:</diffmk:wrapper></para>
+ <itemizedlist diffmk:change="added">
+ <listitem>
+ <para><diffmk:wrapper diffmk:change="added">Eclipse
with </diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss
Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">
+ installed (how to install </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">JBoss
Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> on Eclipse, what
+ dependences and versions requirements are needed reed in the
</diffmk:wrapper><ulink diffmk:change="added"
url="../../GettingStartedGuide/html_single/index.html#JBossToolsInstall"><diffmk:wrapper
diffmk:change="added">JBoss Tools
Installation</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added"> section)</diffmk:wrapper></para>
+ </listitem>
+ <listitem>
+ <para><diffmk:wrapper diffmk:change="added">BIRT
Report Designer (BIRT Report Designer 2.3.2
+ you can download from </diffmk:wrapper><ulink
diffmk:change="added"
url="http://www.eclipse.org/downloads/download.php?file=/birt/downlo...
diffmk:change="added">Eclipse downloads
site</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added">)</diffmk:wrapper></para>
+ </listitem>
+ <listitem>
+ <para><diffmk:wrapper diffmk:change="added">BIRT
Web Tools Integration ( BIRT WTP Integration 2.3.2 you can download from
+ </diffmk:wrapper><ulink diffmk:change="added"
url="http://www.eclipse.org/downloads/download.php?file=/birt/downlo...
diffmk:change="added">Eclipse downloads
site</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added">)</diffmk:wrapper></para>
+ </listitem>
+ </itemizedlist>
+
+ <note diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Note:</diffmk:wrapper></title>
+ <para><diffmk:wrapper diffmk:change="added">Versions of
BIRT framework and BIRT WTP integration should be no less than RC4 in
+ order to the BIRT facet works
correctly.</diffmk:wrapper></para>
+ </note>
+ </section>
+
+ <section diffmk:change="added"
id="birt_plugin_rel_resources">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Other Relevant Resources on the
Topic</diffmk:wrapper></title>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">All JBoss Developer Studio/JBoss Tools release
documentation you can find at</diffmk:wrapper><ulink
diffmk:change="added"
url="http://docs.jboss.org/tools/"><diffmk:wrapper
diffmk:change="added">http://docs.jboss.org/tools</diffmk...
diffmk:change="added"> in the corresponding release
directory.</diffmk:wrapper></para>
+ <para><diffmk:wrapper diffmk:change="added">The latest
documentation builds are available at </diffmk:wrapper><ulink
diffmk:change="added"
url="http://download.jboss.org/jbosstools/nightly-docs/"><...
diffmk:change="added">http://download.jboss.org/jbosstools/n...
diffmk:change="added">.</diffmk:wrapper></para>
+ </section>
+
+</chapter>
+
+
+<chapter diffmk:change="added" id="birt_integration_with_seam"
xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/birt_integration_with_seam.xml"
xreflabel="birt_integration_with_seam">
+
+ <?dbhtml filename="birt_integration_with_seam.html"?>
+ <chapterinfo diffmk:change="added">
+ <keywordset diffmk:change="added">
+ <keyword diffmk:change="added"><diffmk:wrapper
diffmk:change="added">JBoss</diffmk:wrapper></keyword>
+ <keyword diffmk:change="added"><diffmk:wrapper
diffmk:change="added">BIRT</diffmk:wrapper></keyword>
+ <keyword diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Seam</diffmk:wrapper></keyword>
+ </keywordset>
+ </chapterinfo>
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Adding BIRT Functionality to Standard Seam Web
Project</diffmk:wrapper></title>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">In this chapter you'll know how to create a Seam
web project with BIRT
+ capabilities included.</diffmk:wrapper></para>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">You are supposed to have Seam runtime and JBoss
Application Server downloaded and
+ extracted somewhere on you hard drive.</diffmk:wrapper></para>
+
+ <tip diffmk:change="added">
+ <title><diffmk:wrapper
diffmk:change="changed">Tip:</diffmk:wrapper></title>
+ <para><diffmk:wrapper diffmk:change="added">We
used</diffmk:wrapper><ulink diffmk:change="added"
url="http://sourceforge.net/project/showfiles.php?group_id=22866&...
diffmk:change="added">JBoss Seam 2.0.1
GA</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added"> and </diffmk:wrapper><ulink
diffmk:change="added"
url="http://sourceforge.net/project/showfiles.php?group_id=22866&...
diffmk:change="added">JBoss Application Server 4.2.2
GA</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added"> in examples of this
guide.</diffmk:wrapper></para>
+ </tip>
+
+ <section diffmk:change="added"
id="creatin_project_with_birt">
+ <title><diffmk:wrapper diffmk:change="changed">Creating
Seam Web Project with Birt Facet</diffmk:wrapper></title>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">First, open </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">Seam
perspective</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> by going to </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Window
> Open Perspective > Other >
Seam</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.
+ </diffmk:wrapper></emphasis><diffmk:wrapper
diffmk:change="added"> To create a new Seam Web project follow to
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">File
> New > Seam Web Project</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> (or
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">File
> New > Other > Seam > Seam Web
+ Project</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> if
you are not in the </diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Seam
perspective</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">).</diffmk:wrapper></para>
+
+ <para><diffmk:wrapper diffmk:change="added">On the first
wizard page enter the project name, then specify the target runtime and
+ target server. In the </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Configuration</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added">
section click </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Modify</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> to
configure the project facets.</diffmk:wrapper></para>
+
+ <figure diffmk:change="added" float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Creating
Seam Web Project</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added"
fileref="images/birt_integration_with_seam/testBirtProject.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="changed">Choose the
2.0 version of the </diffmk:wrapper><emphasis>
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Seam</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="changed">
facet and enable the </diffmk:wrapper><emphasis>
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Birt Reporting Runtime
Component</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added">
facet.</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Adding
the Birt Reporting Runtime Component Facet </diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/birt_integration_with_seam/addingBirtFacet.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Or you can just choose the
</diffmk:wrapper><emphasis>
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">JBoss BIRT Integration Web
Project</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="changed">
configuration.</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Choosing
the JBoss BIRT Integration Web Project Configuration</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+
fileref="images/birt_integration_with_seam/projectBirtConfiguration.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="changed">Next three
pages are filled out with defaults, just leave them through by pressing
</diffmk:wrapper><emphasis>
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Next</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></emphasis><diffmk:wrapper
diffmk:change="changed"> On the </diffmk:wrapper><emphasis>
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Seam Facet</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="changed">
page you should specify the Seam runtime and Connection
profile.</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper
diffmk:change="changed">Configuring the Seam Facet
settings</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/birt_integration_with_seam/seamFacet.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Hit </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Finish</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> to
create the project with Birt functionality enabled.</diffmk:wrapper></para>
+ </section>
+
+ <section diffmk:change="added" id="integration">
+ <title><diffmk:wrapper diffmk:change="changed">Integration
with Seam</diffmk:wrapper></title>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">The JBoss BIRT Integration feature contains the BIRT
tag that allows the user to add a
+ BIRT report to an </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">.xhtml</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added">
file:</diffmk:wrapper></para>
+
+ <programlisting diffmk:change="added"
format="linespecific" role="XHTML"><diffmk:wrapper
diffmk:change="added"><![CDATA[<p:birt
xmlns:ui="http://java.sun.com/jsf/facelets"
+
xmlns:s="http://jboss.com/products/seam/taglib"
+
xmlns:p="http://jboss.com/products/seam/birt"
+ designType="run"
+ format="pdf"
+ designName="test.rptdesign"
+ title="JBoss Birt Test">
+
+</p:birt>]]></diffmk:wrapper></programlisting>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Let's look how it
works.</diffmk:wrapper></para>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Create in the </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Web
Content</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added">
folder three </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">.xhtml</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> pages
with the following content:</diffmk:wrapper></para>
+
+ <itemizedlist diffmk:change="added">
+ <listitem diffmk:change="added">
+ <para diffmk:change="added">
+ <emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">birttests.xhtml</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">:</diffmk:wrapper></emphasis>
+ </para>
+ <programlisting diffmk:change="added"
format="linespecific" role="XHTML"><diffmk:wrapper
diffmk:change="added"><![CDATA[<!DOCTYPE composition PUBLIC
"-//W3C//DTD XHTML 1.0 Transitional//EN"
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+ <ui:composition
xmlns="http://www.w3.org/1999/xhtml"
+
xmlns:s="http://jboss.com/products/seam/taglib"
+
xmlns:ui="http://java.sun.com/jsf/facelets"
xmlns:f="http://java.sun.com/jsf/core"
+
xmlns:h="http://java.sun.com/jsf/html"
+
xmlns:rich="http://richfaces.org/rich"
+ template="layout/template.xhtml">
+
+ <ui:define name="body">
+ <h:messages globalOnly="true"
styleClass="message"/>
+ <rich:panel>
+ <f:facet name="header">Welcome to JBoss
BIRT!</f:facet>
+ <ul>
+ <li><s:link view="/testbirt.xhtml"
value="Test Birt" /></li>
+ <li><s:link
view="/testbirt1.xhtml" value="Test Birt 1" /></li>
+ </ul>
+ </rich:panel>
+ </ui:define>
+ </ui:composition>]]></diffmk:wrapper></programlisting>
+ </listitem>
+ <listitem diffmk:change="added">
+ <para>
+ <emphasis>
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">testbirt.xhtml</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">:</diffmk:wrapper></emphasis>
+ </para>
+ <programlisting diffmk:change="added"
format="linespecific" role="XHTML"><diffmk:wrapper
diffmk:change="added"><![CDATA[<p:birt
xmlns:ui="http://java.sun.com/jsf/facelets"
+
xmlns:s="http://jboss.com/products/seam/taglib"
+
xmlns:p="http://jboss.com/products/seam/birt"
+ designType="run"
+ format="pdf"
+ designName="test.rptdesign"
+ title="JBoss Birt Test">
+
+ <p:param name="sample" value="sample
param"/>
+</p:birt>]]></diffmk:wrapper></programlisting>
+ </listitem>
+ <listitem diffmk:change="added">
+ <para diffmk:change="added">
+ <emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">testbirt1.xhtml</diffmk:wrapper></property>:</emphasis>
+ </para>
+ <programlisting diffmk:change="added"
format="linespecific" role="XHTML"><diffmk:wrapper
diffmk:change="added"><![CDATA[<p:birt
xmlns:ui="http://java.sun.com/jsf/facelets"
+
xmlns:s="http://jboss.com/products/seam/taglib"
+
xmlns:p="http://jboss.com/products/seam/birt"
+ designType="frameset"
+ designName="test1.rptdesign"
+ title="JBoss Birt Test">
+</p:birt>]]></diffmk:wrapper></programlisting>
+ </listitem>
+ </itemizedlist>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Now start the application server by clicking the
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Start</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added">
option in the context menu of the server in the </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">JBoss Server
+ View</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> (if the view isn't open go to
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Window
> Show View > Other > JBoss Server
+ View</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">)</diffmk:wrapper></emphasis><diffmk:wrapper
diffmk:change="added">. Try the tests out by accessing
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">http://localhost:8080/hellobirt/birttests.seam</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> in
your web browser.</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Welcome
Page in the Browser</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/birt_integration_with_seam/birttestsPage.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="added">Now if you
click </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Test
Birt</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> you
should see the following </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">.pdf</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added">
file:</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">After
Clicking Test Birt</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/birt_integration_with_seam/testbirtPage.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="changed">After
clicking </diffmk:wrapper><emphasis>
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Test Birt 1</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> the
next page is displayed:</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">After
Clicking Test Birt 1</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/birt_integration_with_seam/testbirt1Page1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Put the </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">test
param</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> as
Sample Parameter value, specify the maximum possible Customer Number as
+ </diffmk:wrapper><emphasis>
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="added">1001</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">,</diffmk:wrapper></emphasis><diffmk:wrapper
diffmk:change="added"> for instance, and then press
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Ok</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></emphasis><diffmk:wrapper
diffmk:change="changed"> You'll see the following BIRT
+ report:</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">BIRT
Report in the Browser Window</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/birt_integration_with_seam/testbirt1Page2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">The BIRT tag recognizes most of the parameters
described on </diffmk:wrapper><ulink diffmk:change="added"
url="http://www.eclipse.org/birt/phoenix/deploy/viewerUsage2.2.php#p...
diffmk:change="added">the
+ BIRT Report Viewer Parameters
page</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added">. The attributes of the BIRT tag
+ don't contain the </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">"__"</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added">
prefix.</diffmk:wrapper></para>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">The </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">param</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> tag
describes report parameters (see the listing for the </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">testbirt.xhtml</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added">
above). It supports the following attributes: </diffmk:wrapper></para>
+ <itemizedlist diffmk:change="added">
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">name</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper
diffmk:change="added"> - the parameter name
(required)</diffmk:wrapper></para>
+ </listitem>
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">value</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper
diffmk:change="added"> - the parameter value
(required)</diffmk:wrapper></para>
+ </listitem>
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">isnull</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper
diffmk:change="added"> - specifies that a report parameter has a null value
+ (optional)</diffmk:wrapper></para>
+ </listitem>
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">islocale</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper
diffmk:change="added"> - specifies whether the parameter is localized
(optional)</diffmk:wrapper></para>
+ </listitem>
+ </itemizedlist>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">These tags are defined in the
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">org.jboss.birt.core/resources/jboss-seam-birt.jar</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added">
library that contains source. </diffmk:wrapper></para>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">It is also possible to embed a BIRT report in some Seam
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">.xhtml</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> page.
See how it may be done:</diffmk:wrapper></para>
+ <para diffmk:change="added"></para>
+
+ <para diffmk:change="added">
+ <emphasis diffmk:change="added"
role="bold"><diffmk:wrapper
diffmk:change="added">Example:</diffmk:wrapper></emphasis>
+ </para>
+ <programlisting diffmk:change="added"
format="linespecific" role="XHTML"><diffmk:wrapper
diffmk:change="added"><![CDATA[<!DOCTYPE composition PUBLIC
"-//W3C//DTD XHTML 1.0 Transitional//EN"
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<ui:composition
xmlns="http://www.w3.org/1999/xhtml"
+
xmlns:s="http://jboss.com/products/seam/taglib"
+
xmlns:ui="http://java.sun.com/jsf/facelets"
+
xmlns:f="http://java.sun.com/jsf/core"
+
xmlns:h="http://java.sun.com/jsf/html"
+
xmlns:rich="http://richfaces.org/rich"
+
xmlns:b="http://jboss.com/products/seam/birt"
+ template="layout/template.xhtml">
+ <ui:define name="body">
+ <h:messages globalOnly="true" styleClass="message"
id="globalMessages"/>
+ <rich:panel>
+ <f:facet name="header">Products</f:facet>
+ <b:birt designType="embed"
designName="ProductCatalog.rptdesign"
+ embeddable="true"
masterpage="false"/>
+ <div style="clear:both"/>
+ </rich:panel>
+ <div class="actionButtons">
+ <s:button view="/ProductsEdit.xhtml"
id="edit" value="Edit"/>
+
+ <s:button view="/#{empty productsFrom ?
'ProductsList' : productsFrom}.xhtml"
+ id="done"
value="Done"/>
+ </div>
+ </ui:define>
+</ui:composition>]]></diffmk:wrapper></programlisting>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">See the result in a
Browser:</diffmk:wrapper></para>
+
+ <figure diffmk:change="added" float="0">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Embedding BIRT Report in Seam xhtml
Page</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added"
fileref="images/birt_integration_with_seam/embeddedReportInSeamPage.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ </section>
+</chapter>
+
+
+<chapter diffmk:change="added" id="hibernate_datasource"
xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/hibernate_datasource.xml"
xreflabel="hibernate_datasource">
+
+ <?dbhtml filename="hibernate_datasource.html"?>
+ <chapterinfo diffmk:change="added">
+ <keywordset diffmk:change="added">
+ <keyword diffmk:change="added"><diffmk:wrapper
diffmk:change="added">JBoss</diffmk:wrapper></keyword>
+ <keyword diffmk:change="added"><diffmk:wrapper
diffmk:change="added">BIRT</diffmk:wrapper></keyword>
+ <keyword diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Seam</diffmk:wrapper></keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Hibernate ODA Data
Source</diffmk:wrapper></title>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">The JBoss BIRT Integration feature includes the
Hibernate ODA Data Source completely
+ integrated with Hibernate Tools. You can use it in the way you use any of BIRT
ODA drivers.
+ Let's perform simple actions that demonstrate
it.</diffmk:wrapper></para>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">First, run the </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Seam
Generate Entities</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> action
(You can access it from </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">File
> New > Seam Generate Entities</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> in the
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Seam
perspective</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">. More details on the Seam Generate
+ Entities read in our </diffmk:wrapper><ulink
diffmk:change="added"
url="http://download.jboss.org/jbosstools/nightly-docs/en/seam/html_...
diffmk:change="added">Seam Dev Tools Reference
guide</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added">). This action will create a Hibernate Console
+ configuration.</diffmk:wrapper></para>
+
+ <tip diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Tip:</diffmk:wrapper></title>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Before performing Seam Generate Entities, you should
have a connection profile
+ adjusted and connected to a database. How to do this see in the
</diffmk:wrapper><ulink diffmk:change="added"
url="http://download.jboss.org/jbosstools/nightly-docs/en/seam/html_...
diffmk:change="added">CRUD Database
Application</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added"> chapter of the Seam Dev Tools Reference
+ guide.</diffmk:wrapper></para>
+ </tip>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Next add a new BIRT report. To do that navigate to
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">File
> New > Other > Business Intelligence and Reporting
+ Tools >
Report</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></emphasis><diffmk:wrapper
diffmk:change="added"> In the </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">New Report
+ wizard</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> enter the report name, for instance
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">testHibernateOda.rptdesign</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">,</diffmk:wrapper></emphasis><diffmk:wrapper
diffmk:change="added"> then click </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Finish</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></emphasis></para>
+
+ <figure diffmk:change="added" float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Creating a
New BIRT Report </diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added"
fileref="images/hibernate_datasource/creatingNewBirtReport.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="added">Now switch to the
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Report
Design perspective</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></para>
+
+ <para><diffmk:wrapper diffmk:change="added">In the
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Data
Explorer View</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> right-click the </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Data
Source</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> node and
choose </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">New
Data Source</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></emphasis></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Creating a
New Data Source</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/hibernate_datasource/creatingDataSource.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="added">In the wizard
select </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Hibernate Data
Source</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> and give
it a proper name, </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">HbDataSource</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> for
instance. Hit </diffmk:wrapper><emphasis>
+ <property
moreinfo="none">Next</property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></emphasis></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Creating
Hibernate Data Source</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/hibernate_datasource/hibernateDataSource.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="added">On the next wizard
page leave everything as it is, just press the </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Test
Connection</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> button to
verify the connection is successful.</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Hibernate
Data Source Profile</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/hibernate_datasource/connectionSuccessful.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="added">Click
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Ok</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> and then
</diffmk:wrapper><emphasis>
+ <property moreinfo="none">Finish</property>
+ </emphasis><diffmk:wrapper diffmk:change="changed"> to
complete.</diffmk:wrapper></para>
+
+ <para><diffmk:wrapper diffmk:change="added">Now let's add a
Hibernate ODA dataset. To do that you should bring up the
+ </diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">New
Data Set wizard</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">. In the </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">Data Explorer
View</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">
+ right-click the </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Data
Set</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> node and
select </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">New
Data Set</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></emphasis></para>
+
+ <figure diffmk:change="added" float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Creating a
New Data Set</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added"
fileref="images/hibernate_datasource/creatingDataSet.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="added">In the
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Data
Set Name</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> section
specify the name. Let's it be </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">HbDataSet</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></emphasis></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Creating a
Hibernate ODA Data Set</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/hibernate_datasource/addingHibernateODADataset.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="changed">Next you'll
be prompted to define the query for this data set. To validate the
+ entered query you can press the </diffmk:wrapper><emphasis>
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Test query</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="changed"> button.
All the HQL features like syntax highlighting, content assist,
+ formatting, Drag and Drop, etc., are available to you
here.</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Testing
Query </diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/hibernate_datasource/testingQuery.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="changed">Next the output
columns will be displayed. It's possible to edit them
+ here.</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">HQL Features
- Output Columns Section</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/hibernate_datasource/hqlFeaturesOutputColumns.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="changed">To preview the
results of the defined query click the </diffmk:wrapper><emphasis>
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Preview
Results</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="changed">
item.</diffmk:wrapper></para>
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">HQL Features
- Preview Results Section</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/hibernate_datasource/hqlFeaturesPreviewResults.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">So far you have the Hibernate data source and data set
defined. Now you can create a BIRT
+ report using this data source and data set.</diffmk:wrapper></para>
+
+ <tip diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Tip:</diffmk:wrapper></title>
+ <para><diffmk:wrapper diffmk:change="added">If you
don't know how to do this we suggest that you refer to the
</diffmk:wrapper><ulink diffmk:change="added"
url="http://www.eclipse.org/birt/phoenix/tutorial/"><diff...
diffmk:change="added">Eclipse BIRT
Tutorial</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></para>
+ </tip>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Creating a
BIRT Report using Created Data Source and Data Set</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+
fileref="images/hibernate_datasource/BIRTReportUsingDataSourceAndSet.png "/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="changed">If you switch to
the </diffmk:wrapper><emphasis>
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Preview</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="changed"> tab, it will run your report and show the
output.</diffmk:wrapper></para>
+
+ <figure diffmk:change="added" float="0">
+ <title><diffmk:wrapper diffmk:change="changed">BIRT Report
-Preview Tab</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added"
fileref="images/hibernate_datasource/BIRTReportPreviewTab.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="added">You can also use
parameters within the Hibernate ODA driver.</diffmk:wrapper></para>
+
+ <figure diffmk:change="added" float="0">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Using Parameters within the Hibernate ODA
Driver</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added"
fileref="images/hibernate_datasource/parametersWithinHibernateODADriver.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+
+ <figure diffmk:change="added" float="0">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Adding New
Parameter</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added"
fileref="images/hibernate_datasource/addingNewParameter.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Again, to preview the results switch to the
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Preview
Results</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added">
item.</diffmk:wrapper></para>
+ <figure diffmk:change="added" float="0">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Previewing the
Results</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added"
fileref="images/hibernate_datasource/previewingResults.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+</chapter>
+
+
+<chapter diffmk:change="added" id="birt_reports_deployment"
xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/birt_reports_deployment.xml"
xreflabel="birt_reports_deployment">
+
+ <?dbhtml filename="birt_reports_deployment"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss</keyword>
+ <keyword>BIRT</keyword>
+ <keyword><diffmk:wrapper
diffmk:change="changed">Seam</diffmk:wrapper></keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title><diffmk:wrapper diffmk:change="changed">BIRT Reports
Deployment</diffmk:wrapper></title>
+
+ <para><diffmk:wrapper diffmk:change="changed">When everything
is configured correctly you will be able to view/render the designed
+ reports in your Seam (or any other) Web
application.</diffmk:wrapper></para>
+
+ <para><diffmk:wrapper diffmk:change="added">You can deploy a
report by adding an action button to the Seam's CRUD
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">.xhtml</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added">
file.</diffmk:wrapper></para>
+
+ <figure diffmk:change="added" float="0">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Adding Action Button to the Seam
file</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added"
fileref="images/birt_reports_deployment/addingActionButton.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="added">As you can see on
the figure you should have the </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">testHibernateOda.xhtml</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> file.
It's content should be the following:</diffmk:wrapper></para>
+
+ <programlisting diffmk:change="added" format="linespecific"
role="XHTML"><diffmk:wrapper
diffmk:change="added"><![CDATA[<p:birt
xmlns:ui="http://java.sun.com/jsf/facelets"
+
xmlns:s="http://jboss.com/products/seam/taglib"
+
xmlns:p="http://jboss.com/products/seam/birt"
+ designType="run"
+ format="pdf"
+ designName="testHibernateOda.rptdesign"
+ title="JBoss Birt Test">
+
+</p:birt>
+]]></diffmk:wrapper></programlisting>
+
+ <para><diffmk:wrapper diffmk:change="added">Next run the Seam
page with embedded report on the server by right-clicking the file and
+ going to </diffmk:wrapper><emphasis diffmk:change="added">
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Run > Run on
Server</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></emphasis></para>
+
+ <figure diffmk:change="added" float="0">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Opening Employees.xhtml
Page</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added"
fileref="images/birt_reports_deployment/openingArticlesPage.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="added">After clicking the
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">BIRT
PDF Report</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> button,
you should see the following report:</diffmk:wrapper></para>
+
+ <figure diffmk:change="added" float="0">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Birt PDF Report</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added"
fileref="images/birt_reports_deployment/BirtPDFReport.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="added">Thus, a Seam
project that includes the BIRT facet can be deployed as any project. If you
+ define the Hibernate ODA driver, the JBoss BIRT engine will use JNDI URL that has
to be bind
+ to either Hibernate Session Factory or Hibernate Entity Manager Factory. If you
+ don't specify the JNDI URL property, our engine will try the following JNDI
+ URLs:</diffmk:wrapper></para>
+ <itemizedlist diffmk:change="added">
+ <listitem>
+ <para>
+ <emphasis><diffmk:wrapper
diffmk:change="changed">java:/<project_name></diffmk:wrapper></emphasis>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis diffmk:change="added"><diffmk:wrapper
diffmk:change="added">java:/<project_name>EntityManagerFactory</diffmk:wrapper></emphasis>
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <para><diffmk:wrapper diffmk:change="added">When creating a
Seam EAR project, Hibernate Entity Manager Factory is bound to
+ </diffmk:wrapper><emphasis
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">java:/{projectName}EntityManagerFactory</diffmk:wrapper></emphasis><diffmk:wrapper
diffmk:change="added">. All you need to do is
+ using the Hibernate Configuration created automatically. You can use default
values for the
+ Hibernate Configuration and JNDI URL within the BIRT Hibernate Data
Source.</diffmk:wrapper></para>
+
+ <para><diffmk:wrapper diffmk:change="added">When using a Seam
WAR project, neither HSF nor HEMF aren't binded to JNDI by
+ default. You has to do this manually. For instance, HSF can be bound to JNDI by
adding the
+ following property to the </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">persistence.xml</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> file:</diffmk:wrapper></para>
+
+ <programlisting diffmk:change="added" format="linespecific"
role="XHTML"><diffmk:wrapper
diffmk:change="added"><![CDATA[<property
name="hibernate.session_factory_name" value="java:/projectname"/>
+ ]]></diffmk:wrapper></programlisting>
+
+ <para><diffmk:wrapper diffmk:change="added">And you can use
</diffmk:wrapper><emphasis diffmk:change="added"><diffmk:wrapper
diffmk:change="added">java:/projectname</diffmk:wrapper></emphasis><diffmk:wrapper
diffmk:change="added"> as the JNDI URL property when creating a BIRT
+ Hibernate Data Source.</diffmk:wrapper></para>
+
+ <note diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Note:</diffmk:wrapper></title>
+ <para><diffmk:wrapper diffmk:change="added">If you want to
test this feature using PDE Runtime, you need to add </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">osgi.dev=bin</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> to
the </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">WebContent/WEB-INF/platform/configuration/config.ini</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added">
file.</diffmk:wrapper></para>
+ </note>
+ <para><diffmk:wrapper diffmk:change="added">In conclusion, the
main goal of this document is to get you know with a full featureset
+ that </diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss
BIRT Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> provide. Thus if you have some questions,
+ comments or suggestions on the topic, please feel free to ask in the
</diffmk:wrapper><ulink diffmk:change="added"
url="http://www.jboss.org/index.html?module=bb&op=viewforum&...
diffmk:change="added">JBoss
+ Tools Forum</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added">. You can also influence on how you want to see JBoss
Tools docs in
+ future leaving your vote on our page </diffmk:wrapper><ulink
diffmk:change="added"
url="http://www.jboss.org/community/docs/DOC-10795"><diff...
diffmk:change="added">here</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></para>
+
+
+
+
+</chapter></book>