[jbosstools-commits] JBoss Tools SVN: r21507 - in trunk/birt/docs: en-US and 6 other directories.

Author: smukhina Date: 2010-04-15 16:02:26 -0400 (Thu, 15 Apr 2010) New Revision: 21507 Added: trunk/birt/docs/en-US/ trunk/birt/docs/en-US/files/ trunk/birt/docs/en-US/files/helloBirt.rptdesign trunk/birt/docs/en-US/images/ trunk/birt/docs/en-US/images/birt_integration_with_seam/ trunk/birt/docs/en-US/images/birt_integration_with_seam/addingBirtFacet.png trunk/birt/docs/en-US/images/birt_integration_with_seam/birtDeploymentSettings.png trunk/birt/docs/en-US/images/birt_integration_with_seam/birttestsPage.png trunk/birt/docs/en-US/images/birt_integration_with_seam/embeddedReportInSeamPage.png trunk/birt/docs/en-US/images/birt_integration_with_seam/helloBirtproject.png trunk/birt/docs/en-US/images/birt_integration_with_seam/projectBirtConfiguration.png trunk/birt/docs/en-US/images/birt_integration_with_seam/seamFacet.png trunk/birt/docs/en-US/images/birt_integration_with_seam/testBirtProject.png trunk/birt/docs/en-US/images/birt_integration_with_seam/testbirt1Page1.png trunk/birt/docs/en-US/images/birt_integration_with_seam/testbirt1Page2.png trunk/birt/docs/en-US/images/birt_integration_with_seam/testbirtPage.png trunk/birt/docs/en-US/images/birt_reports_deployment/ trunk/birt/docs/en-US/images/birt_reports_deployment/BirtPDFReport.png trunk/birt/docs/en-US/images/birt_reports_deployment/addingActionButton.png trunk/birt/docs/en-US/images/birt_reports_deployment/openingArticlesPage.png trunk/birt/docs/en-US/images/birt_reports_deployment/productReport.png trunk/birt/docs/en-US/images/favicon.ico trunk/birt/docs/en-US/images/hibernate_datasource/ trunk/birt/docs/en-US/images/hibernate_datasource/BIRTReportPreviewTab.png trunk/birt/docs/en-US/images/hibernate_datasource/BIRTReportUsingDataSourceAndSet.png trunk/birt/docs/en-US/images/hibernate_datasource/BirtPDFReport.png trunk/birt/docs/en-US/images/hibernate_datasource/addingHibernateODADataset.png trunk/birt/docs/en-US/images/hibernate_datasource/addingNewParameter.png trunk/birt/docs/en-US/images/hibernate_datasource/connectionSuccessful.png trunk/birt/docs/en-US/images/hibernate_datasource/creatingDataSet.png trunk/birt/docs/en-US/images/hibernate_datasource/creatingDataSource.png trunk/birt/docs/en-US/images/hibernate_datasource/creatingNewBirtReport.png trunk/birt/docs/en-US/images/hibernate_datasource/finalReport.png trunk/birt/docs/en-US/images/hibernate_datasource/hibernateDataSource.png trunk/birt/docs/en-US/images/hibernate_datasource/hqlFeaturesOutputColumns.png trunk/birt/docs/en-US/images/hibernate_datasource/hqlFeaturesPreviewResults.png trunk/birt/docs/en-US/images/hibernate_datasource/parametersWithinHibernateODADriver.png trunk/birt/docs/en-US/images/hibernate_datasource/previewingResults.png trunk/birt/docs/en-US/images/hibernate_datasource/testingQuery.png trunk/birt/docs/en-US/images/jbosstools_logo.png trunk/birt/docs/en-US/master.xml trunk/birt/docs/en-US/master_output.xml trunk/birt/docs/en-US/modules/ trunk/birt/docs/en-US/modules/birt_integration_with_seam.xml trunk/birt/docs/en-US/modules/birt_reports_deployment.xml trunk/birt/docs/en-US/modules/framework.xml trunk/birt/docs/en-US/modules/hibernate_datasource.xml trunk/birt/docs/en-US/modules/introduction.xml trunk/birt/docs/en-US/modules/links.xml trunk/birt/docs/en-US/modules/tasks.xml Log: TOOLSDOC-50 - Building docs with maven 3.0 - commiting a new folder en-US Added: trunk/birt/docs/en-US/files/helloBirt.rptdesign =================================================================== --- trunk/birt/docs/en-US/files/helloBirt.rptdesign (rev 0) +++ trunk/birt/docs/en-US/files/helloBirt.rptdesign 2010-04-15 20:02:26 UTC (rev 21507) @@ -0,0 +1,554 @@ +<?xml version="1.0" encoding="UTF-8"?> +<report xmlns="http://www.eclipse.org/birt/2005/design" version="3.2.20" id="1"> + <property name="createdBy">Eclipse BIRT Designer Version 2.5.1.v20090903 Build &lt;2.5.1.v20090922-0630></property> + <property name="units">in</property> + <property name="iconFile">/templates/first_report.gif</property> + <property name="cheatSheet">org.eclipse.birt.report.designer.ui.cheatsheet.firstreport</property> + <property name="bidiLayoutOrientation">ltr</property> + <template-parameter-definitions> + <template-parameter-definition name="NewTemplateParameterDefinition" id="28"> + <property name="allowedType">Table</property> + <text-property name="description">Customer Listing</text-property> + <default> + <table id="29"> + <property name="width">100%</property> + <property name="pageBreakInterval">50</property> + <column id="49"/> + <column id="50"/> + <column id="51"/> + <column id="52"/> + <header> + <row id="30"> + <cell id="31"> + <label id="32"> + <property name="fontFamily">sans-serif</property> + <property name="fontWeight">bold</property> + <text-property name="text">Contact</text-property> + </label> + </cell> + <cell id="33"> + <label id="34"> + <property name="fontFamily">sans-serif</property> + <property name="fontWeight">bold</property> + <text-property name="text">First</text-property> + </label> + </cell> + <cell id="35"> + <label id="36"> + <property name="fontFamily">sans-serif</property> + <property name="fontWeight">bold</property> + <text-property name="text">Last</text-property> + </label> + </cell> + <cell id="37"> + <label id="38"> + <property name="fontFamily">sans-serif</property> + <property name="fontWeight">bold</property> + <text-property name="text">Phone</text-property> + </label> + </cell> + </row> + </header> + <detail> + <row id="39"> + <cell id="40"/> + <cell id="41"/> + <cell id="42"/> + <cell id="43"/> + </row> + </detail> + <footer> + <row id="44"> + <cell id="45"/> + <cell id="46"/> + <cell id="47"/> + <cell id="48"/> + </row> + </footer> + </table> + </default> + </template-parameter-definition> + <template-parameter-definition name="NewTemplateParameterDefinition1" id="78"> + <property name="allowedType">Table</property> + <text-property name="description">Customer Listing Table</text-property> + <default> + <table id="79"> + <property name="width">100%</property> + <property name="refTemplateParameter">NewTemplateParameterDefinition</property> + <property name="pageBreakInterval">50</property> + <column id="99"/> + <column id="100"/> + <column id="101"/> + <column id="102"/> + <header> + <row id="80"> + <cell id="81"> + <label id="82"> + <property name="fontFamily">sans-serif</property> + <property name="fontWeight">bold</property> + <text-property name="text">Contact</text-property> + </label> + </cell> + <cell id="83"> + <label id="84"> + <property name="fontFamily">sans-serif</property> + <property name="fontWeight">bold</property> + <text-property name="text">First</text-property> + </label> + </cell> + <cell id="85"> + <label id="86"> + <property name="fontFamily">sans-serif</property> + <property name="fontWeight">bold</property> + <text-property name="text">Last</text-property> + </label> + </cell> + <cell id="87"> + <label id="88"> + <property name="fontFamily">sans-serif</property> + <property name="fontWeight">bold</property> + <text-property name="text">Phone</text-property> + </label> + </cell> + </row> + </header> + <detail> + <row id="89"> + <cell id="90"/> + <cell id="91"/> + <cell id="92"/> + <cell id="93"/> + </row> + </detail> + <footer> + <row id="94"> + <cell id="95"/> + <cell id="96"/> + <cell id="97"/> + <cell id="98"/> + </row> + </footer> + </table> + </default> + </template-parameter-definition> + <template-parameter-definition name="NewTemplateParameterDefinition2" id="132"> + <property name="allowedType">Table</property> + <text-property name="description">Customer Listing Table</text-property> + <default> + <table id="133"> + <property name="width">100%</property> + <property name="refTemplateParameter">NewTemplateParameterDefinition1</property> + <property name="pageBreakInterval">50</property> + <column id="157"/> + <column id="158"/> + <column id="159"/> + <column id="160"/> + <header> + <row id="134"> + <cell id="135"> + <label id="136"> + <property name="fontFamily">sans-serif</property> + <property name="fontWeight">bold</property> + <text-property name="text">Contact</text-property> + </label> + </cell> + <cell id="137"> + <label id="138"> + <property name="fontFamily">sans-serif</property> + <property name="fontWeight">bold</property> + <text-property name="text">First</text-property> + </label> + </cell> + <cell id="139"> + <label id="140"> + <property name="fontFamily">sans-serif</property> + <property name="fontWeight">bold</property> + <text-property name="text">Last</text-property> + </label> + </cell> + <cell id="141"> + <label id="142"> + <property name="fontFamily">sans-serif</property> + <property name="fontWeight">bold</property> + <text-property name="text">Phone</text-property> + </label> + </cell> + </row> + </header> + <detail> + <row id="143"> + <cell id="144"> + <data id="145"/> + </cell> + <cell id="146"> + <data id="147"/> + </cell> + <cell id="148"> + <data id="149"/> + </cell> + <cell id="150"> + <data id="151"/> + </cell> + </row> + </detail> + <footer> + <row id="152"> + <cell id="153"/> + <cell id="154"/> + <cell id="155"/> + <cell id="156"/> + </row> + </footer> + </table> + </default> + </template-parameter-definition> + </template-parameter-definitions> + <parameters> + <scalar-parameter name="reportTitle" id="254"> + <property name="valueType">static</property> + <property name="dataType">string</property> + <property name="distinct">true</property> + <simple-property-list name="defaultValue"> + <value type="constant">No Title</value> + </simple-property-list> + <property name="paramType">simple</property> + <property name="controlType">text-box</property> + <structure name="format"> + <property name="category">Unformatted</property> + </structure> + </scalar-parameter> + </parameters> + <data-sources> + <oda-data-source extensionID="org.eclipse.birt.report.data.oda.jdbc" name="Data Source" id="248"> + <text-property name="displayName"></text-property> + <property name="odaDriverClass">org.eclipse.birt.report.data.oda.sampledb.Driver</property> + <property name="odaURL">jdbc:classicmodels:sampledb</property> + <property name="odaUser">ClassicModels</property> + </oda-data-source> + </data-sources> + <data-sets> + <oda-data-set extensionID="org.eclipse.birt.report.data.oda.jdbc.JdbcSelectDataSet" name="Data Set" id="249"> + <list-property name="columnHints"> + <structure> + <property name="columnName">CUSTOMERNAME</property> + <text-property name="displayName">CUSTOMERNAME</text-property> + </structure> + <structure> + <property name="columnName">CONTACTLASTNAME</property> + <text-property name="displayName">CONTACTLASTNAME</text-property> + </structure> + <structure> + <property name="columnName">CONTACTFIRSTNAME</property> + <text-property name="displayName">CONTACTFIRSTNAME</text-property> + </structure> + <structure> + <property name="columnName">PHONE</property> + <text-property name="displayName">PHONE</text-property> + </structure> + </list-property> + <structure name="cachedMetaData"> + <list-property name="resultSet"> + <structure> + <property name="position">1</property> + <property name="name">CUSTOMERNAME</property> + <property name="dataType">string</property> + </structure> + <structure> + <property name="position">2</property> + <property name="name">CONTACTLASTNAME</property> + <property name="dataType">string</property> + </structure> + <structure> + <property name="position">3</property> + <property name="name">CONTACTFIRSTNAME</property> + <property name="dataType">string</property> + </structure> + <structure> + <property name="position">4</property> + <property name="name">PHONE</property> + <property name="dataType">string</property> + </structure> + </list-property> + </structure> + <property name="dataSource">Data Source</property> + <list-property name="resultSet"> + <structure> + <property name="position">1</property> + <property name="name">CUSTOMERNAME</property> + <property name="nativeName">CUSTOMERNAME</property> + <property name="dataType">string</property> + <property name="nativeDataType">12</property> + </structure> + <structure> + <property name="position">2</property> + <property name="name">CONTACTLASTNAME</property> + <property name="nativeName">CONTACTLASTNAME</property> + <property name="dataType">string</property> + <property name="nativeDataType">12</property> + </structure> + <structure> + <property name="position">3</property> + <property name="name">CONTACTFIRSTNAME</property> + <property name="nativeName">CONTACTFIRSTNAME</property> + <property name="dataType">string</property> + <property name="nativeDataType">12</property> + </structure> + <structure> + <property name="position">4</property> + <property name="name">PHONE</property> + <property name="nativeName">PHONE</property> + <property name="dataType">string</property> + <property name="nativeDataType">12</property> + </structure> + </list-property> + <xml-property name="queryText"><![CDATA[select CLASSICMODELS.CUSTOMERS.CUSTOMERNAME, +CLASSICMODELS.CUSTOMERS.CONTACTLASTNAME, +CLASSICMODELS.CUSTOMERS.CONTACTFIRSTNAME, +CLASSICMODELS.CUSTOMERS.PHONE +from CLASSICMODELS.CUSTOMERS]]></xml-property> + <xml-property name="designerValues"><![CDATA[<?xml version="1.0" encoding="UTF-8"?> +<model:DesignValues xmlns:design="http://www.eclipse.org/datatools/connectivity/oda/desi... xmlns:model="http://www.eclipse.org/birt/report/model/adapter/odaMod... + <Version>1.0</Version> + <design:ResultSets derivedMetaData="true"> + <design:resultSetDefinitions> + <design:resultSetColumns> + <design:resultColumnDefinitions> + <design:attributes> + <design:name>CUSTOMERNAME</design:name> + <design:position>1</design:position> + <design:nativeDataTypeCode>12</design:nativeDataTypeCode> + <design:precision>50</design:precision> + <design:scale>0</design:scale> + <design:nullability>Nullable</design:nullability> + <design:uiHints> + <design:displayName>CUSTOMERNAME</design:displayName> + </design:uiHints> + </design:attributes> + <design:usageHints> + <design:label>CUSTOMERNAME</design:label> + <design:formattingHints> + <design:displaySize>50</design:displaySize> + </design:formattingHints> + </design:usageHints> + </design:resultColumnDefinitions> + <design:resultColumnDefinitions> + <design:attributes> + <design:name>CONTACTLASTNAME</design:name> + <design:position>2</design:position> + <design:nativeDataTypeCode>12</design:nativeDataTypeCode> + <design:precision>50</design:precision> + <design:scale>0</design:scale> + <design:nullability>Nullable</design:nullability> + <design:uiHints> + <design:displayName>CONTACTLASTNAME</design:displayName> + </design:uiHints> + </design:attributes> + <design:usageHints> + <design:label>CONTACTLASTNAME</design:label> + <design:formattingHints> + <design:displaySize>50</design:displaySize> + </design:formattingHints> + </design:usageHints> + </design:resultColumnDefinitions> + <design:resultColumnDefinitions> + <design:attributes> + <design:name>CONTACTFIRSTNAME</design:name> + <design:position>3</design:position> + <design:nativeDataTypeCode>12</design:nativeDataTypeCode> + <design:precision>50</design:precision> + <design:scale>0</design:scale> + <design:nullability>Nullable</design:nullability> + <design:uiHints> + <design:displayName>CONTACTFIRSTNAME</design:displayName> + </design:uiHints> + </design:attributes> + <design:usageHints> + <design:label>CONTACTFIRSTNAME</design:label> + <design:formattingHints> + <design:displaySize>50</design:displaySize> + </design:formattingHints> + </design:usageHints> + </design:resultColumnDefinitions> + <design:resultColumnDefinitions> + <design:attributes> + <design:name>PHONE</design:name> + <design:position>4</design:position> + <design:nativeDataTypeCode>12</design:nativeDataTypeCode> + <design:precision>50</design:precision> + <design:scale>0</design:scale> + <design:nullability>Nullable</design:nullability> + <design:uiHints> + <design:displayName>PHONE</design:displayName> + </design:uiHints> + </design:attributes> + <design:usageHints> + <design:label>PHONE</design:label> + <design:formattingHints> + <design:displaySize>50</design:displaySize> + </design:formattingHints> + </design:usageHints> + </design:resultColumnDefinitions> + </design:resultSetColumns> + </design:resultSetDefinitions> + </design:ResultSets> +</model:DesignValues> +]]></xml-property> + </oda-data-set> + </data-sets> + <styles> + <style name="report" id="110"> + <property name="fontFamily">sans-serif</property> + <property name="fontSize">10pt</property> + </style> + <style name="crosstab-cell" id="246"> + <property name="borderBottomColor">#CCCCCC</property> + <property name="borderBottomStyle">solid</property> + <property name="borderBottomWidth">1pt</property> + <property name="borderLeftColor">#CCCCCC</property> + <property name="borderLeftStyle">solid</property> + <property name="borderLeftWidth">1pt</property> + <property name="borderRightColor">#CCCCCC</property> + <property name="borderRightStyle">solid</property> + <property name="borderRightWidth">1pt</property> + <property name="borderTopColor">#CCCCCC</property> + <property name="borderTopStyle">solid</property> + <property name="borderTopWidth">1pt</property> + </style> + <style name="crosstab" id="247"> + <property name="borderBottomColor">#CCCCCC</property> + <property name="borderBottomStyle">solid</property> + <property name="borderBottomWidth">1pt</property> + <property name="borderLeftColor">#CCCCCC</property> + <property name="borderLeftStyle">solid</property> + <property name="borderLeftWidth">1pt</property> + <property name="borderRightColor">#CCCCCC</property> + <property name="borderRightStyle">solid</property> + <property name="borderRightWidth">1pt</property> + <property name="borderTopColor">#CCCCCC</property> + <property name="borderTopStyle">solid</property> + <property name="borderTopWidth">1pt</property> + </style> + </styles> + <page-setup> + <simple-master-page name="Simple MasterPage" id="2"> + <page-footer> + <text id="3"> + <property name="contentType">html</property> + <text-property name="content"><![CDATA[<value-of>new Date()</value-of>]]></text-property> + </text> + </page-footer> + </simple-master-page> + </page-setup> + <body> + <data id="255"> + <list-property name="boundDataColumns"> + <structure> + <property name="name">reportTitle</property> + <expression name="expression">params["reportTitle"].value</expression> + <property name="dataType">string</property> + </structure> + </list-property> + <property name="resultSetColumn">reportTitle</property> + </data> + <table id="163"> + <property name="width">100%</property> + <property name="dataSet">Data Set</property> + <property name="refTemplateParameter">NewTemplateParameterDefinition2</property> + <list-property name="boundDataColumns"> + <structure> + <property name="name">CUSTOMERNAME</property> + <text-property name="displayName">CUSTOMERNAME</text-property> + <expression name="expression">dataSetRow["CUSTOMERNAME"]</expression> + <property name="dataType">string</property> + </structure> + <structure> + <property name="name">CONTACTLASTNAME</property> + <text-property name="displayName">CONTACTLASTNAME</text-property> + <expression name="expression">dataSetRow["CONTACTLASTNAME"]</expression> + <property name="dataType">string</property> + </structure> + <structure> + <property name="name">CONTACTFIRSTNAME</property> + <text-property name="displayName">CONTACTFIRSTNAME</text-property> + <expression name="expression">dataSetRow["CONTACTFIRSTNAME"]</expression> + <property name="dataType">string</property> + </structure> + <structure> + <property name="name">PHONE</property> + <text-property name="displayName">PHONE</text-property> + <expression name="expression">dataSetRow["PHONE"]</expression> + <property name="dataType">string</property> + </structure> + </list-property> + <property name="pageBreakInterval">50</property> + <column id="187"/> + <column id="188"/> + <column id="189"/> + <column id="190"/> + <header> + <row id="164"> + <cell id="165"> + <label id="166"> + <property name="fontFamily">sans-serif</property> + <property name="fontWeight">bold</property> + <text-property name="text">Customer</text-property> + </label> + </cell> + <cell id="167"> + <label id="168"> + <property name="fontFamily">sans-serif</property> + <property name="fontWeight">bold</property> + <text-property name="text">First</text-property> + </label> + </cell> + <cell id="169"> + <label id="170"> + <property name="fontFamily">sans-serif</property> + <property name="fontWeight">bold</property> + <text-property name="text">Last</text-property> + </label> + </cell> + <cell id="171"> + <label id="172"> + <property name="fontFamily">sans-serif</property> + <property name="fontWeight">bold</property> + <text-property name="text">Phone</text-property> + </label> + </cell> + </row> + </header> + <detail> + <row id="173"> + <cell id="174"> + <data id="250"> + <property name="resultSetColumn">CUSTOMERNAME</property> + </data> + </cell> + <cell id="176"> + <data id="251"> + <property name="resultSetColumn">CONTACTLASTNAME</property> + </data> + </cell> + <cell id="178"> + <data id="252"> + <property name="resultSetColumn">CONTACTFIRSTNAME</property> + </data> + </cell> + <cell id="180"> + <data id="253"> + <property name="resultSetColumn">PHONE</property> + </data> + </cell> + </row> + </detail> + <footer> + <row id="182"> + <cell id="183"/> + <cell id="184"/> + <cell id="185"/> + <cell id="186"/> + </row> + </footer> + </table> + </body> +</report> Added: trunk/birt/docs/en-US/images/birt_integration_with_seam/addingBirtFacet.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/birt_integration_with_seam/addingBirtFacet.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/birt_integration_with_seam/birtDeploymentSettings.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/birt_integration_with_seam/birtDeploymentSettings.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/birt_integration_with_seam/birttestsPage.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/birt_integration_with_seam/birttestsPage.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/birt_integration_with_seam/embeddedReportInSeamPage.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/birt_integration_with_seam/embeddedReportInSeamPage.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/birt_integration_with_seam/helloBirtproject.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/birt_integration_with_seam/helloBirtproject.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/birt_integration_with_seam/projectBirtConfiguration.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/birt_integration_with_seam/projectBirtConfiguration.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/birt_integration_with_seam/seamFacet.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/birt_integration_with_seam/seamFacet.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/birt_integration_with_seam/testBirtProject.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/birt_integration_with_seam/testBirtProject.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/birt_integration_with_seam/testbirt1Page1.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/birt_integration_with_seam/testbirt1Page1.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/birt_integration_with_seam/testbirt1Page2.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/birt_integration_with_seam/testbirt1Page2.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/birt_integration_with_seam/testbirtPage.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/birt_integration_with_seam/testbirtPage.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/birt_reports_deployment/BirtPDFReport.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/birt_reports_deployment/BirtPDFReport.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/birt_reports_deployment/addingActionButton.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/birt_reports_deployment/addingActionButton.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/birt_reports_deployment/openingArticlesPage.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/birt_reports_deployment/openingArticlesPage.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/birt_reports_deployment/productReport.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/birt_reports_deployment/productReport.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/favicon.ico =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/favicon.ico ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/hibernate_datasource/BIRTReportPreviewTab.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/hibernate_datasource/BIRTReportPreviewTab.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/hibernate_datasource/BIRTReportUsingDataSourceAndSet.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/hibernate_datasource/BIRTReportUsingDataSourceAndSet.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/hibernate_datasource/BirtPDFReport.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/hibernate_datasource/BirtPDFReport.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/hibernate_datasource/addingHibernateODADataset.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/hibernate_datasource/addingHibernateODADataset.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/hibernate_datasource/addingNewParameter.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/hibernate_datasource/addingNewParameter.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/hibernate_datasource/connectionSuccessful.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/hibernate_datasource/connectionSuccessful.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/hibernate_datasource/creatingDataSet.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/hibernate_datasource/creatingDataSet.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/hibernate_datasource/creatingDataSource.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/hibernate_datasource/creatingDataSource.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/hibernate_datasource/creatingNewBirtReport.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/hibernate_datasource/creatingNewBirtReport.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/hibernate_datasource/finalReport.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/hibernate_datasource/finalReport.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/hibernate_datasource/hibernateDataSource.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/hibernate_datasource/hibernateDataSource.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/hibernate_datasource/hqlFeaturesOutputColumns.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/hibernate_datasource/hqlFeaturesOutputColumns.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/hibernate_datasource/hqlFeaturesPreviewResults.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/hibernate_datasource/hqlFeaturesPreviewResults.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/hibernate_datasource/parametersWithinHibernateODADriver.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/hibernate_datasource/parametersWithinHibernateODADriver.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/hibernate_datasource/previewingResults.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/hibernate_datasource/previewingResults.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/hibernate_datasource/testingQuery.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/hibernate_datasource/testingQuery.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/images/jbosstools_logo.png =================================================================== (Binary files differ) Property changes on: trunk/birt/docs/en-US/images/jbosstools_logo.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/birt/docs/en-US/master.xml =================================================================== --- trunk/birt/docs/en-US/master.xml (rev 0) +++ trunk/birt/docs/en-US/master.xml 2010-04-15 20:02:26 UTC (rev 21507) @@ -0,0 +1,84 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN" +"http://www.docbook.org/xml/5.0/dtd/docbook.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 framework SYSTEM "modules/framework.xml"> +<!ENTITY tasks SYSTEM "modules/tasks.xml"> +<!ENTITY links SYSTEM "modules/links.xml"> +]> + +<book> + <bookinfo> + <title>JBoss BIRT Integration User Guide</title> + + <corpauthor> + <inlinemediaobject> + <imageobject role="fo"> + <imagedata format="PNG" fileref="images/jbosstools_logo.png" /> + </imageobject> + <imageobject role="html"> + <imagedata/> + </imageobject> + </inlinemediaobject> + </corpauthor> + + <author&gt;&lt;firstname&gt;Michael&lt;/firstname&gt;&lt;surname&gt;Sorokin&lt;/surname&gt;&lt;email&gt;msorokin(a)exadel.com&lt;/email&gt;&lt;/author&gt; + <author&gt;&lt;firstname&gt;Anastasiya&lt;/firstname&gt;&lt;surname&gt;Bogachuk&lt;/surname&gt;&lt;email&gt;abogachuk(a)exadel.com&lt;/email&gt;&lt;/author&gt; + <author><firstname>Olga</firstname><surname>Chikvina</surname></author> + + <othercredit> + + <contrib> + Special thanks to Snjezana Peco + </contrib> + + + + + </othercredit> + + + + + + + + + + + <copyright> + <year>2008</year> + <year>2009</year> + <year>2010</year> + <holder>JBoss by Red Hat</holder> + </copyright> + + + <releaseinfo> + Version: 1.1.0.GA + </releaseinfo> + + +<abstract> + <title/> + <para> + <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/jboss_birt... version</ulink> + </para> +</abstract> + + + </bookinfo> + <toc/> + + &introduction; + &tasks; + &framework; + &links; + + +</book> Added: trunk/birt/docs/en-US/master_output.xml =================================================================== --- trunk/birt/docs/en-US/master_output.xml (rev 0) +++ trunk/birt/docs/en-US/master_output.xml 2010-04-15 20:02:26 UTC (rev 21507) @@ -0,0 +1,1179 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN" +"http://www.docbook.org/xml/5.0/dtd/docbook.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 framework SYSTEM "modules/framework.xml"> +<!ENTITY tasks SYSTEM "modules/tasks.xml"> +<!ENTITY links SYSTEM "modules/links.xml"> +]><book xmlns="http://docbook.org/ns/docbook" xmlns:diffmk="http://diffmk.sf.net/ns/diff" xmlns:xlink="http://www.w3.org/1999/xlink"> + <bookinfo> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss BIRT Integration User Guide</title> + + <corpauthor> + <inlinemediaobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imageobject role="fo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imagedata fileref="images/jbosstools_logo.png" format="PNG" xmlns="http://docbook.org/ns/docbook"></imagedata> + </imageobject> + <imageobject role="html" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imagedata xmlns="http://docbook.org/ns/docbook"></imagedata> + </imageobject> + </inlinemediaobject> + </corpauthor> + + <author xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><firstname xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Michael</first... xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Sorokin</surna... xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">msorokin@exadel.c... + <author xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><firstname xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Anastasiya</fi... xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Bogachuk</surn... xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">abogachuk@exadel.... + <author xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><firstname xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Olga</firstnam... xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Chikvina</surn... + + <othercredit xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + <contrib xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + Special thanks to Snjezana Peco + </contrib> + + + + + </othercredit> + + + + + + + + + + + <copyright xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <year xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">2008</year> + <year xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">2009</year> + <year xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">2010</year> + <holder xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss by Red Hat</holder> + </copyright> + + + <releaseinfo xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><diffmk:wrapper diffmk:change="changed"> + Version: 1.1.0.GA + </diffmk:wrapper></releaseinfo> + + +<abstract xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"></title> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/jboss_birt... version</ulink> + </para> +</abstract> + + + </bookinfo> + <toc xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"></toc> + + +<chapter id="introduction" xml:base="file:///home/vchukhutsina/repos/ochik_jboss/birt/docs/en/modules/introduction.xml" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <?dbhtml filename="introduction.html"?> + + <chapterinfo> + <keywordset xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss Developer Studio</keyword> + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Eclipse</keywo... + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss</keyword... + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss Tools</keyword> + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBDS</keyword> + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">BIRT Plugin</keyword> + </keywordset> + </chapterinfo> + + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Introduction</... + + + + + <section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">What is BIRT?</title> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">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.</para> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">With the help of BIRT you can generate a great number of reports to be used in your + application:</para> + + <itemizedlist xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Lists</para> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Charts</para> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Crosstabs, or cross-tabulation, or matrix</para> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Letters and Documents</para> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Compound Reports</para> + </listitem> + </itemizedlist> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">You can find more detailed information on the BIRT plugin, its report types and + anatomy on the <ulink url="http://www.eclipse.org/birt/phoenix/intro/">BIRT Homepage</ulink>.</para> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">To understand the basic BIRT concepts and to know how to create a basic BIRT report, + refer to the <ulink url="http://www.eclipse.org/birt/phoenix/tutorial/">Eclipse BIRT + Tutorials</ulink>. What extensions <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss Tools</property> provides for + Eclipse BIRT you'll find out in the next sections.</para> + </section> + + + + <section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss BIRT Integration Functionality Overview</title> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + The key feature of JBoss BIRT Integration is the JBoss BIRT Integration Framework, which allows to integrate a BIRT report into Seam/JSF container. + The framework API reference is in the + <link linkend="framework" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss BIRT Integraion Framework API Reference</link> chapter of the guide. + </para> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + This guide also covers functionality of <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss Tools</property> module which assists in + integration with BIRT. + The integration plug-in allows you to visually configure <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Hibernate Data Source</property> (specify a Hibernate configuration or JNDI URL), + compose HQL queries with syntax-highlighting, content-assist, formatting as well as other functionalities available in the HQL editor. + + + </para> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + To enable <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss Tools</property> integration with BIRT you are intended to + have the next: + </para> + <itemizedlist xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Eclipse with <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss Tools</property> + installed (how to install <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss Tools</property> on Eclipse, what + dependences and versions requirements are needed reed in the <ulink url="#JBossToolsInstall">JBoss Tools Installation</ulink> section)</para> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">BIRT Report Designer (BIRT Report Designer 2.3.2 + you can download from <ulink url="http://www.eclipse.org/downloads/download.php?file=/birt/downlo... downloads site</ulink>)</para> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">BIRT Web Tools Integration ( BIRT WTP Integration 2.3.2 you can download from + <ulink url="http://www.eclipse.org/downloads/download.php?file=/birt/downlo... downloads site</ulink>)</para> + </listitem> + </itemizedlist> + + <note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Note:</title> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Versions of BIRT framework and BIRT WTP integration should be no less than RC4 in + order to the BIRT facet works correctly.</para> + </note> + </section> + + + +</chapter> + + + +<chapter id="tasks" xml:base="file:///home/vchukhutsina/repos/ochik_jboss/birt/docs/en/modules/tasks.xml" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xreflabel="tasks"> + <?dbhtml filename="tasks.html"?> + <chapterinfo> + <keywordset xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Eclipse</keywo... + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss</keyword... + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss Tools</keyword> + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">BIRT Integration</keyword> + </keywordset> + </chapterinfo> + + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Tasks</title> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> In this chapter of the guide you will find information on the tasks that you can perform integrating BIRT. The required version of BIRT is 2.3.2 or greater.</para> + + + + + +<section id="birt_integration_with_seam" xml:base="file:///home/vchukhutsina/repos/ochik_jboss/birt/docs/en/modules/birt_integration_with_seam.xml" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Adding BIRT Functionality to Standard Seam Web Project</title> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">In this section you'll know how to integrate BIRT into a Seam web project. </para> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">You are supposed to have Seam runtime and JBoss Application Server downloaded and + extracted on your hard drive. + You can download Seam from the + <ulink url="http://seamframework.org/Download">Seam Framework</ulink> web page and + JBoss Application Server from <ulink url="http://jboss.org/jbossas/downloads/">JBoss Application Server</ulink> official site. + + </para> + + <tip> + <title>Tip:</title> + <para>We used <ulink + url="http://sourceforge.net/project/showfiles.php?group_id=22866&... + >JBoss Seam 2.0.1 GA</ulink> and <ulink + url="http://sourceforge.net/project/showfiles.php?group_id=22866&... + >JBoss Application Server 4.2.2 GA</ulink> in examples of this guide.</para> + </tip> + + <section id="creatin_project_with_birt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Creating Seam Web Project with Birt Facet</title> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">We recommend to open <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Seam perspective</property> by going to <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Window &gt; Open Perspective &gt; Other &gt; Seam</property></emphasis> , this way you will have all the tools to work with Seam at hand. + To create a new Seam Web project navigate to <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">File &gt; New &gt; Seam Web Project</property> + </emphasis>. Otherwise you should go to <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">File &gt; New &gt; Other &gt; Seam &gt; Seam Web + Project</property> + </emphasis> if <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Seam</property... perspective is not active.</para> + + <orderedlist xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">On the first wizard page enter the project name, then specify the target runtime and + target server. We recommend to use JBoss AS server and runtime environment to ensure best performance. + </para> + + + <figure id="CreatingSeamWebProject" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Creating Seam Web Project</title> + <mediaobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imageobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imagedata fileref="images/birt_integration_with_seam/testBirtProject.png" xmlns="http://docbook.org/ns/docbook"></imagedata> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">In the <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Configuration<... group choose the version of <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Seam</property... + </emphasis> framework you are planning to use in your application. In this guide we used Seam 2.2. </para> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Click the <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Modify</proper... button + and enable the <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Birt Reporting Runtime Component</property> + </emphasis> facet by checking the appropriate option.</para> + + <figure xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Adding the Birt Reporting Runtime Component Facet </title> + <mediaobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imageobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imagedata fileref="images/birt_integration_with_seam/addingBirtFacet.png" xmlns="http://docbook.org/ns/docbook"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Alternatively you can just choose the <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss BIRT Integration Web Project</property> + </emphasis> configuration from the drop-down list in the <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Configuration<... group </para> + + <figure xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Choosing the JBoss BIRT Integration Web Project Configuration</title> + <mediaobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imageobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imagedata fileref="images/birt_integration_with_seam/projectBirtConfiguration.png" xmlns="http://docbook.org/ns/docbook"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </listitem> + + + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">You may leave the next two pages with default values, just press <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Next</property... to proceed. + </para> + </listitem> + + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">On the <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Birt Configuration</property></emphasis> page you can modify the BIRT deployment settings, which you can edit afterwards in the web.xml of the generated project. Let's keep the default values for now. + </para> + + <figure xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Configuring BIRT Deployment Settings</title> + <mediaobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imageobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imagedata fileref="images/birt_integration_with_seam/birtDeploymentSettings.png" xmlns="http://docbook.org/ns/docbook"></imagedata> + </imageobject> + </mediaobject> + </figure> + + + + </listitem> + + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">You can also leave the <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JSF Capabilities</property></emphasis> page with default values. </para> + </listitem> + + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">On the <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Seam Facet</property> + </emphasis> page you should specify the Seam runtime and Connection profile. Please note, that the Seam runtime must be of the version you initially specified in the project settings (See the <link linkend="CreatingSeamWebProject" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Creating Seam Web Project</link> figure). </para> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> When creating a Seam project with BIRT capabilities you can use the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">BIRT Classic Models Sample Database</property> connection profile to work with the BIRT sample database.</para> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">For more details on how to configure database connection for a Seam project please read the + <ulink url="http://docs.jboss.org/tools/3.0.0.GA/en/seam/html_single/index.... Seam Facet Settings</ulink> chapter of Seam Dev Tools Reference Guide.</para> + <figure xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Configuring the Seam Facet settings</title> + <mediaobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imageobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imagedata fileref="images/birt_integration_with_seam/seamFacet.png" xmlns="http://docbook.org/ns/docbook"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </listitem> + + + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Hit <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Finish</proper... + </emphasis> to create the project with BIRT functionality enabled.</para> + </listitem> + </orderedlist> + </section> + + <section id="integration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Integration with Seam</title> +<para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + In the previous section you have created a Seam project with BIRT capabilities. + Now you can create a simple kick start project to see that everything is configured correctly. +</para> + + + <orderedlist xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Now create a BIRT report file and insert test data into the file. + Name the report file <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">helloBirt.rptdesi...;, the report should print the data from the <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">CLASSICMODELS.CUS... table of the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">BIRT Classic Models Sample Database</property>, namely: customer number (<code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">CLASSICMODELS.CUS...>), + contact person first name ( <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">CLASSICMODELS.CUS...>) , + contact person last name (<code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">CLASSICMODELS.CUS...>) and + contact person phone number(<code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">CLASSICMODELS.CUS...>). + </para> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">The title of the report should be set via <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">reportTitle</c... parameter</para> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + As this guide is primarily focused on the BIRT integration and not the BIRT technology itself we will not show the steps required to make the report. If you do not feel strong about creating a BIRT report file please read <ulink url="http://eclipse.org/birt/phoenix/tutorial/">BIRT documentation</ulink>. + </para> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">You can download the file <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">helloBirt.rptdesi... <ulink url="files/helloBirt.rptdesign">here</ulink> and copy it to the WebContent folder of your Seam project.</para> + + </listitem> + + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + When you are done with the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">helloBirt.rptdesi... file, you should create a <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">.xhtml</proper... file that will contain the BIRT report you have just created. + </para> + + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + The JBoss BIRT Integration framework provides 2 components represented as <emphasis role="bold" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">&lt;b:birt&am... and <emphasis role="bold" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">&lt;b:param&a... tags. The jboss-seam-birt.jar library implements the functionality of the components. To find more information about the framework pleas read the <link linkend="framework" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss BIRT Integraion Framework API Reference</link> chapter. + To use that tags on the page you need to declare the tag library and define the name space like this: + </para> + + + <programlisting role="XML" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><![CDATA[ + xmlns:b="http://jboss.com/products/seam/birt" + ]]></programlisting> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + The <emphasis role="bold" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">&lt;b:birt&am... is a container for a BIRT report, that helps you integrate the report into Seam environment. + You can manage the properties of the report using the attributes of the <emphasis role="bold" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">&lt;b:birt&am... tag. + </para> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + The <emphasis role="bold" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">&lt;b:param&a... tag describes report parameters. To set a parameter you need to specify it's name the value you want to pass. + You can use EL expressions to bind the representation layer with back-end logic. + </para> + + </listitem> + + + + + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Create the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">helloBirt.xhtml&l... file in the WebContent with the following content: </para> + + <programlisting role="XML" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><![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:rich="http://richfaces.org/rich" + xmlns:b="http://jboss.com/products/seam/birt" + template="layout/template.xhtml"> + <ui:define name="body"> + <rich:panel> + <b:birt designType="embed" designName="helloBirt.rptdesign" + embeddable="true"> + <b:param name="reportTitle" value="Customers Contacts" /> + </b:birt> + </rich:panel> + </ui:define> +</ui:composition> +...]]></programlisting> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">From this listing above you see that the title of the report is set via <emphasis role="bold" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">&lt;b:param&a... by setting the parameter name and defining the <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">"value"... attribute with the "Customers Contacts" value.</para> + + </listitem> + + + + + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">We have created a Seam project and inserted the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">helloBirt</pro... report into the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">helloBirt.xhtml&l... view file.</para> + + +<para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">To see that the application works correctly and as you expect, you need to launch it on the server.</para> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">In the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Servers</prope... view (If it is not open navigate to <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Windows &gt; Show View &gt; Other &gt; Server &gt; Servers</property>), select the server the application is deployed to and hit the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Start</propert... button. </para></listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">When the server is started, open your favourite browser and point it to <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">http://localhost:... .</para> + + +<figure xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Integrating BIRT into Seam Project</title> + <mediaobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imageobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imagedata fileref="images/birt_integration_with_seam/helloBirtproject.png" xmlns="http://docbook.org/ns/docbook"></imagedata> + </imageobject> + </mediaobject> +</figure> + </listitem> + </orderedlist> + + </section> +</section> + +<section id="hibernate_datasource" xml:base="file:///home/vchukhutsina/repos/ochik_jboss/birt/docs/en/modules/hibernate_datasource.xml" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Using Hibernate ODA Data Source</title> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">The JBoss BIRT Integration feature includes the Hibernate ODA Data Source which is completely + integrated with Hibernate Tools. You can use it the way as you would use any of BIRT ODA drivers. + + </para> + +<orderedlist xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">First, you need to reverse engineer from the database to generate Seam entities. You can perform this operation going to <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">File &gt; New &gt; Seam Generate Entities</property> + </emphasis> in the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Seam perspective</property>. More details on the Seam Generate + Entities please read <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/seam/html_... Dev Tools Reference guide</ulink>). + In this guide we will use the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Employees</pro... table of the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">DATAMODELS</pr... database. +</para> + + <tip xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Tip:</title> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Before performing Seam Generate Entities, you should have a connection profile + adjusted and connected to a database. How to do this see in the <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/seam/html_... Database Application</ulink> chapter of the Seam Dev Tools Reference + guide.</para> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + If you followed the steps described in the + <link linkend="birt_integration_with_seam" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Adding BIRT Functionality to Standard Seam Web Project</link> chapter, + you would have a connection profile already configured. + </para> + </tip> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> +<para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + Next you should create a new BIRT report file ( <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">&gt;<property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">File &gt; New &gt; Other &gt; Business Intelligence and Reporting + Tools &gt; Report</property></emphasis>) to represent the data from the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Employees</pro... table. Call the file <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">employees.rptdesi...;. +</para> + </listitem> + +<listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Now switch to the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">BIRT Report Design</property> perspective.</para> +</listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">In the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Data Explorer</property> view right-click the <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Data Source</property> + </emphasis> node and choose <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">New Data Source</property>.</emphasis></para> + + <figure xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Creating a New Data Source</title> + <mediaobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imageobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imagedata fileref="images/hibernate_datasource/creatingDataSource.png" xmlns="http://docbook.org/ns/docbook"></imagedata> + </imageobject> + </mediaobject> + </figure> +</listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">The wizard will prompt you to select data source type. Choose <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Hibernate Data Source</property> + </emphasis> and give it a meaningful name, for instance <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">HibernateDataSour... + </emphasis>. Hit <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Next</property... to proceed.</emphasis></para> + + <figure xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Creating Hibernate Data Source</title> + <mediaobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imageobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imagedata fileref="images/hibernate_datasource/hibernateDataSource.png" xmlns="http://docbook.org/ns/docbook"></imagedata> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">On the next wizard's dialog you can leave the everything with default values, press the <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Test Connection</property> + </emphasis> button to verify that the connection is established successfully.</para> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + The <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Hibernate Data Source</property> enables you to specify a Hibernate Configuration or JNDI URL. + + </para> + + <figure xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Hibernate Data Source Profile</title> + <mediaobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imageobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imagedata fileref="images/hibernate_datasource/connectionSuccessful.png" xmlns="http://docbook.org/ns/docbook"></imagedata> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Press <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Finish</proper... + </emphasis> to complete <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">New Data Source</property> wizard.</para> + </listitem> + + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Now you need to configure a new Hibernate ODA data set. Launch the + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">New Data Set</property> wizard. In the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Data Explorer View</property> + right-click the <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Data Set</property> + </emphasis> node and select <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">New Data Set</property>.</emphasis></para> + + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Select <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">HibernateDataSour... as target data source and type in the new data set name. + Call it <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">HibernateDataSet&... + + + + + <figure xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Creating a Hibernate ODA Data Set</title> + <mediaobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imageobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imagedata fileref="images/hibernate_datasource/addingHibernateODADataset.png" xmlns="http://docbook.org/ns/docbook"></imagedata> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">The next dialog of the wizard will help you compose a query for the new data set.</para> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">We will make a report that will print all employees in the database who has Sales Rep job title.</para> + + <programlisting role="SQL" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><![CDATA[... +select jobtitle, firstname, lastname, email +from Employees as employees where employees.jobtitle = 'Sales Rep' +...]]></programlisting> + + + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + To validate the + entered query you can press the <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Test query</property> + </emphasis> button. All the HQL features like syntax highlighting, content assist, + formatting, drag-and-drop, etc., are available to facilitate query composing.</para> + + <figure xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Composing query for Data Set</title> + <mediaobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imageobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imagedata fileref="images/hibernate_datasource/testingQuery.png" xmlns="http://docbook.org/ns/docbook"></imagedata> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Pressing <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Finish</proper... will call the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Edit Data Set</property> dialog where you can adjust the parameters of the data set and preview the resulted set. + If everything looks good, hit <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Ok</property> to generate a new data set. + </para> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Now you can insert the data set items of <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">HibernateDataSet&... into the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">employees.rptdesi... + + + <tip xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Tip:</title> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">If you don't know how to do this we suggest that you refer to the <ulink url="http://www.eclipse.org/birt/phoenix/tutorial/">Eclipse BIRT Tutorial</ulink>.</para> + </tip> + + +<para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">You can also use parameters in the query to add dynamics to your report. In the previous example we hardcoded the selection criterion in the <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">where</code> clause. </para> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">To specify the job title on-the-fly your query should look like this:</para> + <programlisting role="XML" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><![CDATA[ +select jobtitle,firstname, lastname,email +from Employees as employees where employees.jobtitle = ? +]]></programlisting> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">The question mark represents a data set input parameter, which is not the same as a report parameter. + Now you need to define an new report parameter to pass the data to the report, call it <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JobTitle</code>;. + + + + The dataset parameter can be linked to a report parameter. + In the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Data Explorer</property> view click the Data Set node to open it and right-click + on the data set you created previously( in our case it is <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">HibernateDataSet&...>), + choose <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Edit</property... and navigate to the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Parameters</pr... section. + Declare a new data set parameter, name it <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">jobtitle</code... and map it to the already existing <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JobTitle</code... report parameter. + </para> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">You report is ready, you can view it by clicking on the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Preview</prope... tab of the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">BIRT Report Designer</property> editor. </para> + + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">You will be prompted to assign a value to the report parameter. For instance you can enter "Sales Rep". </para> + + <figure xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Resulted Dynamic Report</title> + <mediaobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imageobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imagedata fileref="images/hibernate_datasource/finalReport.png" xmlns="http://docbook.org/ns/docbook"></imagedata> + </imageobject> + </mediaobject> + </figure> + </listitem> +</orderedlist> +</section> + + +<section id="birt_reports_deployment" xml:base="file:///home/vchukhutsina/repos/ochik_jboss/birt/docs/en/modules/birt_reports_deployment.xml" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Creating a Dynamic BIRT Report</title> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">The <link linkend="birt_integration_with_seam" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Adding BIRT Functionality to Standard Seam Web Project</link> + and <link linkend="hibernate_datasource" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Using Hibernate ODA Data Sourc</link> sections tell how to integrate a BIRT report into + a Seam web project and how to use Hibernate data source to generate a dynamic report. + In this section we will create a Seam web project that can make a dynamic report using the parameters that are defined on a web page.</para> + + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">We will use the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">PRODUCTS</prop... table of <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">DATAMODELS</pr... database for the purpose of this demo project. + In the first place, you need to generate Seam entities like we did in the previous chapter (<link linkend="hibernate_datasource" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Hibernate ODA Data Source</link> ). The demo application will generate a report about the company's products, whereas it will allow to specify a product line. </para> + +<orderedlist xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">The next step is to create a Java class that will store the <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">sortOrder</cod... variable and its assessors, register the class in faces.config.xml. + The variable will be needed to pass dynamic data to the report via report parameters, therefore it has to be of session scope.</para> + </listitem> + + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + + The report will print the data from the <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Products</code... table, hence you need to create a report file first. + You can use either the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">BIRT JDBC Data Source</property> or <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Hibernate Data Source</property> data source to create the data set for this project. If you want to use the latter please read the previous chapter <link linkend="hibernate_datasource" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Hibernate ODA Data Source</link>. +</para> + + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + The data set should have at least the following data set items: product vendor, product name, quantity in stock and buy price. The data is retrieved from the database with this query : + </para> + + + <programlisting role="XML" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><![CDATA[ +SELECT productvedor, +productname, +quantityinstock, +buyprice +FROM Products as products + +]]></programlisting> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Make a table in the report and put each data set item into a column.</para> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">As it was stated in the beginning of the chapter the report will be dynamic, therefore you need to declare a report parameter first, let it be <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">sortOrder</cod... and to add the parameter to the query. BIRT offers rich JavaScript API, so you can modify the query programmatically like this:</para> +<programlisting role="XML" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + +&lt;xml-property name="queryText"&gt;&lt;![CDATA[ +SELECT productvedor, +productname, +quantityinstock, +buyprice +FROM Products as products +]]&gt;&lt;/xml-property&gt; + &lt;method name="beforeOpen"&gt;&lt;![CDATA[ +queryString = " ORDER BY products."+reportContext.getParameterValue("sortOrder")+" "+"DESC"; +this.queryText = this.queryText+queryString; +]]&gt;&lt;/method&gt; + +</programlisting> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> +<para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">The report is ready. You can preview it to make sure it works properly. </para> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">To set the report parameter you should create an <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">.xhtml</proper... view page, call it <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Products.xhtml<...;. On the page you can set the value of the <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">sortOrder</cod... Java bean variable and press the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Generate Report</property> button to open another view page that will display the resulted report. + </para> + + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">The source code of the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Products.xhtml<... should be the following:</para> + + <programlisting role="XML" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><![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:h="http://java.sun.com/jsf/html" + xmlns:f="http://java.sun.com/jsf/core" + xmlns:rich="http://richfaces.org/rich" + xmlns:a4j="http://richfaces.org/a4j" template="layout/template.xhtml"> + <ui:define name="body"> + <rich:panel> + <f:facet name="header">BIRT Report Generator</f:facet> + <a4j:form ajaxSubmit="true" reRender="criterion"> + <table> + <tr> + <td>Select sort order criterion:</td> + <td><h:selectOneMenu onchange="submit()" + value="#{yourJavaBean.sortOrder}"> <!-- Bind to your Java Bean --> + <f:selectItem itemValue="buyprice" itemLabel="buy price" /> + <f:selectItem itemValue="quantityinstock" itemLabel="quantity in stock" /> + </h:selectOneMenu> + </td> + </tr> + </table> + </a4j:form> + <s:button + view="/#{!empty reportParameters.order ? 'Products' : 'ProductsReport'}.xhtml" id="generate" value="Generate Report" /> <!-- If the sertOrder variable is not set the button won't work --> + </rich:panel> + </ui:define> +</ui:composition> +]]></programlisting> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">The logic of the file is quite simple, when the sort order criterion is select the value of <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">yourJavaBean.sort... + is set automatically via Ajax and the report is ready to be generated.</para> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Now you need to create the web page that will print the report, name the file <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">ProductsReport.xh...;. + The file to output the report should have the following content:</para> + +<programlisting role="XML" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><![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:b="http://jboss.com/products/seam/birt" + xmlns:rich="http://richfaces.org/rich" template="layout/template.xhtml"> + <ui:define name="body"> + <rich:panel> + <f:facet name="header">Products Report</f:facet> + <b:birt designType="embed" designName="products.rptdesign" + embeddable="true" masterpage="true"> + <b:param name="sortOrder" value="#{yourJavaBean.sortOrder}" /> + </b:birt> + </rich:panel> +</ui:define> +</ui:composition> +]]></programlisting> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + As you know from the <link linkend="birt_integration_with_seam" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Adding BIRT Functionality to Standard Seam Web Project</link> chapter, before using the BIRT Integration framework tags on the page you need to declare the tag library and specify the name space with this line: + </para> + + <programlisting role="XML" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><![CDATA[ + xmlns:b="http://jboss.com/products/seam/birt" +]]></programlisting> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + The dynamics to the report adds this line: + </para> + <programlisting role="XML" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><![CDATA[ +<b:param name="sortOrder" value="#{yourJavaBean.sortOrder}" /> +]]></programlisting> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">We bound the <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">sortOrder</cod... report parameter to Java Bean variable <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">value="#{you... using EL expression, and the value to the variable is assigned in the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Products.xhtml<... file. </para> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">By default if you embed a report into HTML page the HTML-format report contains the &lt;html&gt;, + &lt;head&gt;, &lt;body&gt; etc., tags. However if your HTML page already has those tags, you can rid of them using the <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">embeddable="... attribute of + + the <emphasis role="bold" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">&lt;b:birt&am... component.</para> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Deploy the project onto the server and open your browser to see the report is successfully generated. You should navigate to + + <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">http://localhost:... to select the criterion and press the <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Generate Report</property> button. You will be redirected to the <code xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">http://localhost:... + + </para> + <figure xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Dynamic Report</title> + <mediaobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imageobject xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <imagedata fileref="images/birt_reports_deployment/productReport.png" xmlns="http://docbook.org/ns/docbook"></imagedata> + </imageobject> + </mediaobject> + </figure> + </listitem> +</orderedlist> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">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 bound + 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:</para> + <itemizedlist xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">java:/&lt;pro... + </para> + </listitem> + <listitem xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">java:/&lt;pro... + </para> + </listitem> + </itemizedlist> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">When creating a Seam EAR project, Hibernate Entity Manager Factory is bound to + <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">java:/{projectNam...;. All you need to do is + to use the Hibernate Configuration created automatically. You can use default values for the + Hibernate Configuration and JNDI URL within the BIRT Hibernate Data Source.</para> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">When using a Seam WAR project, neither HSF nor HEMF aren't bound to JNDI by + default. You have to do this manually. For instance, HSF can be bound to JNDI by adding the + following property to the <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">persistence.xml&l... file:</para> + + <programlisting role="XHTML" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><![CDATA[<p... name="hibernate.session_factory_name" value="java:/projectname"/> + ]]></programlisting> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">And you can use <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">java:/projectname... as the JNDI URL property when creating a BIRT + Hibernate Data Source.</para> + + <note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Note:</title> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">If you want to test this feature using PDE Runtime, you need to add <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">osgi.dev=bin</... + </emphasis> to the <emphasis xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">WebContent/WEB-IN... + </emphasis> file.</para> + </note> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">In conclusion, the main goal of this document is to get you to know with a full feature set + that <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss BIRT Tools</property> provide. Thus if you have some questions, + comments or suggestions on the topic, please feel free to ask in the + <ulink url="http://www.jboss.org/index.html?module=bb&amp;op=viewforum&... + Tools Forum</ulink>. You can also influence on how you want to see JBoss Tools docs in + future leaving your vote on the article <ulink + url="http://www.jboss.org/community/docs/DOC-10795">Overview of the improvements required by JBossTools/JBDS Docs users</ulink>.</para> + +</section> + + + +</chapter> + + +<chapter id="framework" xml:base="file:///home/vchukhutsina/repos/ochik_jboss/birt/docs/en/modules/framework.xml" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <?dbhtml filename="framework.html"?> + + <chapterinfo> + <keywordset xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Eclipse</keywo... + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss</keyword... + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss Tools</keyword> + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">BIRT Integration</keyword> + </keywordset> + </chapterinfo> + + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss BIRT Integraion Framework API Reference</title> + + +<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <emphasis role="bold" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">&lt;b:birt&am... Component + </title> + + + +<para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + The <emphasis role="bold" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">&lt;b:birt&am... component servers to integrate a BIRT report into Seam/JSF container. + The <emphasis role="bold" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">&lt;b:birt&am... tag recognizes most of the parameters described on the BIRT + <ulink url="http://www.eclipse.org/birt/phoenix/deploy/viewerUsage2.2.php#p... Viewer Parameters</ulink> page, though it has attributes of its own. + +</para> + + + <table xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><emphasis role="bold" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">&lt;b:birt&am... Component Reference</title> + <tgroup cols="3" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <thead xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Attribute</ent... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Correspondance to BIRT Report Viewer parameters</entry> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Description/</... + + </row> + </thead> + <tbody xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">designType</en... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - </entry> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Corresponds to the BIRT servlet mappings. Possible values are run, frameset, preview and embed. + If the attribute is set to embed the component is used for + embeddable html. This type ignores all the attributes except designName + and masterpage. + </entry> + </row> + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">embeddable</en... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - </entry> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">A BIRT report occupies the whole page by default. It contains the &lt;html&gt;, + &lt;head&gt;, &lt;body&gt; etc., tags. Embedded report can be a part of another page. + It doesn't contain the above mentioned tags. Only HTML report can be embedded.</entry> + </row> + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">designName</en... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">__report</entr... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Sets the name of the report design to process. This can be an absolute path or relative to the working folder. Valid values are run, frameset and preview</entry> + </row> + + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">format</entry> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">__format</entr... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Specifies the desired output format, such as pdf, html, doc, ppt, or xls.</entry> + </row> + + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">title</entry> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">__title</entry... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Sets the report title.</entry> + </row> + + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">showtitle</ent... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">__showtitle</e... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Determines if the report title is shown in the frameset viewer. Defaults to true.</entry> + </row> + + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">toolbar</entry... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">__toolbar</ent... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + Determines if the report toolbar is shown in the frameset viewer.Defaults to true. Valid values are true and false.</entry> + </row> + + + + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">navigationbar<... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">__navigationbar&l... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + Determines if the navigation bar is shown in the frameset viewer. Defaults to true. Valid values are true and false.</entry> + </row> + + + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">document</entr... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">__document</en... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + Sets the name for the rptdocument. The document is created when the report engine separates run and render tasks, and + is used to support features like table of contents and pagination. + This setting can be an absolute path or relative to the working folder. If no document parameter is used, a unique document is created in the document folder. + </entry> + </row> + + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">locale</entry> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">__locale</entr... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + Specifies the locale for the specific operation. Note that this will override the default locale. + </entry> + </row> + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">svg</entry> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">__svg</entry> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + Specifies whether SVG is supported. + </entry> + </row> + + + + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">page</entry> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">__page</entry> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + Specifies specific page to render. + </entry> + </row> + + + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">pagerange</ent... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">__pagerange</e... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + Specifies page range to render. Eg 1-4,7. + </entry> + </row> + + + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">masterpage</en... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">__masterpage</... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + Indicates that the report master page should be used or not. Validvalues are true and false. + </entry> + </row> + + + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">overwrite</ent... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">__overwrite</e... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + This setting if set to true will force an overwrite of the existing report document. + </entry> + </row> + + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">bookmark</entr... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">__bookmark</en... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + Specifies a specific bookmark within the report to load. The viewer will automatically load the appropriate page. + </entry> + </row> + + + + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">rtl</entry> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">__rtl</entry> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + Specifies whether to display the report in right to left format. This setting defaults to false. + </entry> + </row> + + + + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">fittopage</ent... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">__fittopage</e... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + Specifies whether PDF generation should fit content to a page. Valid values are true and false. + </entry> + </row> + + + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">resourceFolder<... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">__resourceFolder&... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + Specifies the resource folder to use. This setting will override the default setting in the web.xml. The resource folder is used to locate libraries, images, and resource files. + </entry> + </row> + + </tbody> + </tgroup> + </table> + +</section> + + <section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><emphasis role="bold" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">&lt;b:param&a... Component</title> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + The <emphasis role="bold" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">&lt;b:param&a... tag describes report parameter. + </para> + + <table xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><emphasis role="bold" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <property xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">&lt;b:param&a... Component</title> + <tgroup cols="2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <thead xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Attribute</ent... + + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Description</e... + </row> + </thead> + <tbody xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">name</entry> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">The parameter name. Required.</entry> + </row> + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">value</entry> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">The parameter value. Required.</entry> + </row> + + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">isnull</entry> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Specifies that a report parameter has a null value</entry> + </row> + <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">islocale</entr... + <entry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Specifies whether the parameter is localized</entry> + </row> + + </tbody> + + </tgroup> + </table> + </section> + + + + + + + +</chapter> + + + +<chapter id="birt_plugin_rel_resources" xml:base="file:///home/vchukhutsina/repos/ochik_jboss/birt/docs/en/modules/links.xml" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xreflabel="birt_plugin_rel_resources"> + <?dbhtml filename="links.html"?> + <chapterinfo> + <keywordset xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Eclipse</keywo... + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss</keyword... + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">JBoss Tools</keyword> + <keyword xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">BIRT Integration</keyword> + </keywordset> + </chapterinfo> + + + <title xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">Other Relevant Resources on the Topic</title> + + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">All JBoss Developer Studio/JBoss Tools release documentation you can find at <ulink url="http://docs.jboss.org/tools/">http://docs.jboss.org/too... in the corresponding release directory.</para> + <para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">The latest documentation builds are available at <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">htt...;. + +</para> + +</chapter> + + + +</book> Added: trunk/birt/docs/en-US/modules/birt_integration_with_seam.xml =================================================================== --- trunk/birt/docs/en-US/modules/birt_integration_with_seam.xml (rev 0) +++ trunk/birt/docs/en-US/modules/birt_integration_with_seam.xml 2010-04-15 20:02:26 UTC (rev 21507) @@ -0,0 +1,255 @@ +<?xml version='1.0' encoding='UTF-8'?> +<section id="birt_integration_with_seam"> + <title>Adding BIRT Functionality to Standard Seam Web Project</title> + + <para>In this section you&apos;ll know how to integrate BIRT into a Seam web project. </para> + + <para>You are supposed to have Seam runtime and JBoss Application Server downloaded and + extracted on your hard drive. + You can download Seam from the + <ulink url="http://seamframework.org/Download">Seam Framework</ulink> web page and + JBoss Application Server from <ulink url="http://jboss.org/jbossas/downloads/">JBoss Application Server</ulink> official site. + + </para> + + <tip> + <title>Tip:</title> + <para>We used <ulink + url="http://sourceforge.net/project/showfiles.php?group_id=22866&... + >JBoss Seam 2.0.1 GA</ulink> and <ulink + url="http://sourceforge.net/project/showfiles.php?group_id=22866&... + >JBoss Application Server 4.2.2 GA</ulink> in examples of this guide.</para> + </tip> + + <section id="creatin_project_with_birt"> + <title>Creating Seam Web Project with Birt Facet</title> + + <para>We recommend to open <property>Seam perspective</property> by going to <emphasis> + <property>Window &gt; Open Perspective &gt; Other &gt; Seam</property></emphasis> , this way you will have all the tools to work with Seam at hand. + To create a new Seam Web project navigate to <emphasis> + <property>File &gt; New &gt; Seam Web Project</property> + </emphasis>. Otherwise you should go to <emphasis> + + <property>File &gt; New &gt; Other &gt; Seam &gt; Seam Web + Project</property> + </emphasis> if <property>Seam</property> perspective is not active.</para> + + <orderedlist> + + <listitem> + <para>On the first wizard page enter the project name, then specify the target runtime and + target server. We recommend to use JBoss AS server and runtime environment to ensure best performance. + </para> + + + <figure id="CreatingSeamWebProject"> + <title>Creating Seam Web Project</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/birt_integration_with_seam/testBirtProject.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem> + <para>In the <emphasis><property>Configuration</property></emphasis> group choose the version of <emphasis> + <property>Seam</property> + </emphasis> framework you are planning to use in your application. In this guide we used Seam 2.2. </para> + </listitem> + <listitem> + <para>Click the <emphasis><property>Modify</property></emphasis> button + and enable the <emphasis> + <property>Birt Reporting Runtime Component</property> + </emphasis> facet by checking the appropriate option.</para> + + <figure> + <title>Adding the Birt Reporting Runtime Component Facet </title> + <mediaobject> + <imageobject> + <imagedata fileref="images/birt_integration_with_seam/addingBirtFacet.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Alternatively you can just choose the <emphasis> + <property>JBoss BIRT Integration Web Project</property> + </emphasis> configuration from the drop-down list in the <emphasis><property>Configuration</property></emphasis> group </para> + + <figure> + <title>Choosing the JBoss BIRT Integration Web Project Configuration</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/birt_integration_with_seam/projectBirtConfiguration.png"/> + </imageobject> + </mediaobject> + </figure> + + </listitem> + + + <listitem> + <para>You may leave the next two pages with default values, just press <emphasis><property>Next</property></emphasis> to proceed. + </para> + </listitem> + + <listitem> + + <para>On the <emphasis><property>Birt Configuration</property></emphasis> page you can modify the BIRT deployment settings, which you can edit afterwards in the web.xml of the generated project. Let's keep the default values for now. + </para> + + <figure> + <title>Configuring BIRT Deployment Settings</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/birt_integration_with_seam/birtDeploymentSettings.png"/> + </imageobject> + </mediaobject> + </figure> + + + + </listitem> + + <listitem> + <para>You can also leave the <emphasis><property>JSF Capabilities</property></emphasis> page with default values. </para> + </listitem> + + <listitem> + <para>On the <emphasis> + <property>Seam Facet</property> + </emphasis> page you should specify the Seam runtime and Connection profile. Please note, that the Seam runtime must be of the version you initially specified in the project settings (See the <link linkend="CreatingSeamWebProject">Creating Seam Web Project</link> figure). </para> + <para> When creating a Seam project with BIRT capabilities you can use the <property>BIRT Classic Models Sample Database</property> connection profile to work with the BIRT sample database.</para> + + <para>For more details on how to configure database connection for a Seam project please read the + <ulink url="http://docs.jboss.org/tools/3.0.0.GA/en/seam/html_single/index.... Seam Facet Settings</ulink> chapter of Seam Dev Tools Reference Guide.</para> + <figure> + <title>Configuring the Seam Facet settings</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/birt_integration_with_seam/seamFacet.png"/> + </imageobject> + </mediaobject> + </figure> + + </listitem> + + + <listitem> + <para>Hit <emphasis> + <property>Finish</property> + </emphasis> to create the project with BIRT functionality enabled.</para> + </listitem> + </orderedlist> + </section> + + <section id="integration"> + <title>Integration with Seam</title> +<para> + In the previous section you have created a Seam project with BIRT capabilities. + Now you can create a simple kick start project to see that everything is configured correctly. +</para> + + + <orderedlist> + <listitem><para>Now create a BIRT report file and insert test data into the file. + Name the report file <property>helloBirt.rptdesign</property>, the report should print the data from the <code>CLASSICMODELS.CUSTOMERS</code> table of the <property>BIRT Classic Models Sample Database</property>, namely: customer number (<code>CLASSICMODELS.CUSTOMERS.CUSTOMERNAME</code>), + contact person first name ( <code>CLASSICMODELS.CUSTOMERS.CONTACTFIRSTNAME</code>) , + contact person last name (<code>CLASSICMODELS.CUSTOMERS.CONTACTLASTNAME</code>) and + contact person phone number(<code>CLASSICMODELS.CUSTOMERS.PHONE</code>). + </para> + <para>The title of the report should be set via <code>reportTitle</code> parameter</para> + <para> + As this guide is primarily focused on the BIRT integration and not the BIRT technology itself we will not show the steps required to make the report. If you do not feel strong about creating a BIRT report file please read <ulink url="http://eclipse.org/birt/phoenix/tutorial/">BIRT documentation</ulink>. + </para> + <para>You can download the file <property>helloBirt.rptdesign</property> <ulink url="files/helloBirt.rptdesign">here</ulink> and copy it to the WebContent folder of your Seam project.</para> + + </listitem> + + <listitem> + <para> + When you are done with the <property>helloBirt.rptdesign</property> file, you should create a <property>.xhtml</property> file that will contain the BIRT report you have just created. + </para> + + + <para> + The JBoss BIRT Integration framework provides 2 components represented as <emphasis role="bold"> <property>&lt;b:birt&gt;</property></emphasis> and <emphasis role="bold"> <property>&lt;b:param&gt;</property></emphasis> tags. The jboss-seam-birt.jar library implements the functionality of the components. To find more information about the framework pleas read the <link linkend="framework">JBoss BIRT Integraion Framework API Reference</link> chapter. + To use that tags on the page you need to declare the tag library and define the name space like this: + </para> + + + <programlisting role="XML"><![CDATA[ + xmlns:b="http://jboss.com/products/seam/birt" + ]]></programlisting> + + <para> + The <emphasis role="bold"> <property>&lt;b:birt&gt;</property></emphasis> is a container for a BIRT report, that helps you integrate the report into Seam environment. + You can manage the properties of the report using the attributes of the <emphasis role="bold"> <property>&lt;b:birt&gt;</property></emphasis> tag. + </para> + + <para> + + The <emphasis role="bold"> <property>&lt;b:param&gt;</property></emphasis> tag describes report parameters. To set a parameter you need to specify it's name the value you want to pass. + You can use EL expressions to bind the representation layer with back-end logic. + </para> + + </listitem> + + + + + <listitem> + + + <para>Create the <property>helloBirt.xhtml</property> file in the WebContent with the following content: </para> + + <programlisting role="XML"><![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:rich="http://richfaces.org/rich" + xmlns:b="http://jboss.com/products/seam/birt" + template="layout/template.xhtml"> + <ui:define name="body"> + <rich:panel> + <b:birt designType="embed" designName="helloBirt.rptdesign" + embeddable="true"> + <b:param name="reportTitle" value="Customers Contacts" /> + </b:birt> + </rich:panel> + </ui:define> +</ui:composition> +...]]></programlisting> + + <para>From this listing above you see that the title of the report is set via <emphasis role="bold"> <property>&lt;b:param&gt;</property></emphasis> by setting the parameter name and defining the <emphasis><property>&quot;value&quot;</property></emphasis> attribute with the &quot;Customers Contacts&quot; value.</para> + + </listitem> + + + + + <listitem> + <para>We have created a Seam project and inserted the <property>helloBirt</property> report into the <property>helloBirt.xhtml</property> view file.</para> + + +<para>To see that the application works correctly and as you expect, you need to launch it on the server.</para> + </listitem> + <listitem><para>In the <property>Servers</property> view (If it is not open navigate to <property>Windows > Show View > Other > Server > Servers</property>), select the server the application is deployed to and hit the <property>Start</property> button. </para></listitem> + <listitem> + <para>When the server is started, open your favourite browser and point it to <code>http://localhost:8080/HelloBirt/helloBirt.seam</code> .</para> + + +<figure> + <title>Integrating BIRT into Seam Project</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/birt_integration_with_seam/helloBirtproject.png"/> + </imageobject> + </mediaobject> +</figure> + </listitem> + </orderedlist> + + </section> +</section> \ No newline at end of file Added: trunk/birt/docs/en-US/modules/birt_reports_deployment.xml =================================================================== --- trunk/birt/docs/en-US/modules/birt_reports_deployment.xml (rev 0) +++ trunk/birt/docs/en-US/modules/birt_reports_deployment.xml 2010-04-15 20:02:26 UTC (rev 21507) @@ -0,0 +1,220 @@ +<?xml version='1.0' encoding='UTF-8'?> +<section id="birt_reports_deployment"> + <title>Creating a Dynamic BIRT Report</title> + + <para>The <link linkend="birt_integration_with_seam">Adding BIRT Functionality to Standard Seam Web Project</link> + and <link linkend="hibernate_datasource">Using Hibernate ODA Data Sourc</link> sections tell how to integrate a BIRT report into + a Seam web project and how to use Hibernate data source to generate a dynamic report. + In this section we will create a Seam web project that can make a dynamic report using the parameters that are defined on a web page.</para> + + + <para>We will use the <property>PRODUCTS</property> table of <property>DATAMODELS</property> database for the purpose of this demo project. + In the first place, you need to generate Seam entities like we did in the previous chapter (<link linkend="hibernate_datasource">Hibernate ODA Data Source</link> ). The demo application will generate a report about the company's products, whereas it will allow to specify a product line. </para> + +<orderedlist> + <listitem> + <para>The next step is to create a Java class that will store the <code>sortOrder</code> variable and its assessors, register the class in faces.config.xml. + The variable will be needed to pass dynamic data to the report via report parameters, therefore it has to be of session scope.</para> + </listitem> + + <listitem> + <para> + + + The report will print the data from the <code>Products</code> table, hence you need to create a report file first. + You can use either the <property>BIRT JDBC Data Source</property> or <property>Hibernate Data Source</property> data source to create the data set for this project. If you want to use the latter please read the previous chapter <link linkend="hibernate_datasource">Hibernate ODA Data Source</link>. +</para> + + + <para> + The data set should have at least the following data set items: product vendor, product name, quantity in stock and buy price. The data is retrieved from the database with this query : + </para> + + + <programlisting role="XML"><![CDATA[ +SELECT productvedor, +productname, +quantityinstock, +buyprice +FROM Products as products + +]]></programlisting> + </listitem> + <listitem> + <para>Make a table in the report and put each data set item into a column.</para> + </listitem> + <listitem> + <para>As it was stated in the beginning of the chapter the report will be dynamic, therefore you need to declare a report parameter first, let it be <code>sortOrder</code> and to add the parameter to the query. BIRT offers rich JavaScript API, so you can modify the query programmatically like this:</para> +<programlisting role="XML"> + +&lt;xml-property name=&quot;queryText&quot;&gt;&lt;![CDATA[ +SELECT productvedor, +productname, +quantityinstock, +buyprice +FROM Products as products +]]&gt;&lt;/xml-property&gt; + &lt;method name=&quot;beforeOpen&quot;&gt;&lt;![CDATA[ +queryString = " ORDER BY products."+reportContext.getParameterValue("sortOrder")+" "+"DESC"; +this.queryText = this.queryText+queryString; +]]&gt;&lt;/method&gt; + +</programlisting> + </listitem> + <listitem> +<para>The report is ready. You can preview it to make sure it works properly. </para> + </listitem> + <listitem> <para>To set the report parameter you should create an <property>.xhtml</property> view page, call it <property>Products.xhtml</property>. On the page you can set the value of the <code>sortOrder</code> Java bean variable and press the <property>Generate Report</property> button to open another view page that will display the resulted report. + </para> + + + <para>The source code of the <property>Products.xhtml</property> should be the following:</para> + + <programlisting role="XML"><![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:h="http://java.sun.com/jsf/html" + xmlns:f="http://java.sun.com/jsf/core" + xmlns:rich="http://richfaces.org/rich" + xmlns:a4j="http://richfaces.org/a4j" template="layout/template.xhtml"> + <ui:define name="body"> + <rich:panel> + <f:facet name="header">BIRT Report Generator</f:facet> + <a4j:form ajaxSubmit="true" reRender="criterion"> + <table> + <tr> + <td>Select sort order criterion:</td> + <td><h:selectOneMenu onchange="submit()" + value="#{yourJavaBean.sortOrder}"> <!-- Bind to your Java Bean --> + <f:selectItem itemValue="buyprice" itemLabel="buy price" /> + <f:selectItem itemValue="quantityinstock" itemLabel="quantity in stock" /> + </h:selectOneMenu> + </td> + </tr> + </table> + </a4j:form> + <s:button + view="/#{!empty reportParameters.order ? 'Products' : 'ProductsReport'}.xhtml" id="generate" value="Generate Report" /> <!-- If the sertOrder variable is not set the button won't work --> + </rich:panel> + </ui:define> +</ui:composition> +]]></programlisting> + <para>The logic of the file is quite simple, when the sort order criterion is select the value of <code>yourJavaBean.sortOrder</code> + is set automatically via Ajax and the report is ready to be generated.</para> + </listitem> + <listitem> + <para>Now you need to create the web page that will print the report, name the file <property>ProductsReport.xhtml</property>. + The file to output the report should have the following content:</para> + +<programlisting role="XML"><![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:b="http://jboss.com/products/seam/birt" + xmlns:rich="http://richfaces.org/rich" template="layout/template.xhtml"> + <ui:define name="body"> + <rich:panel> + <f:facet name="header">Products Report</f:facet> + <b:birt designType="embed" designName="products.rptdesign" + embeddable="true" masterpage="true"> + <b:param name="sortOrder" value="#{yourJavaBean.sortOrder}" /> + </b:birt> + </rich:panel> +</ui:define> +</ui:composition> +]]></programlisting> + <para> + As you know from the <link linkend="birt_integration_with_seam">Adding BIRT Functionality to Standard Seam Web Project</link> chapter, before using the BIRT Integration framework tags on the page you need to declare the tag library and specify the name space with this line: + </para> + + <programlisting role="XML"><![CDATA[ + xmlns:b="http://jboss.com/products/seam/birt" +]]></programlisting> + <para> + The dynamics to the report adds this line: + </para> + <programlisting role="XML"><![CDATA[ +<b:param name="sortOrder" value="#{yourJavaBean.sortOrder}" /> +]]></programlisting> + + <para>We bound the <code>sortOrder</code> report parameter to Java Bean variable <code>value=&quot;#{yourJavaBean.sortOrder}&quot;</code> using EL expression, and the value to the variable is assigned in the <property>Products.xhtml</property> file. </para> + <para>By default if you embed a report into HTML page the HTML-format report contains the &lt;html&gt;, + &lt;head&gt;, &lt;body&gt; etc., tags. However if your HTML page already has those tags, you can rid of them using the <code>embeddable=&quot;true&quot;</code> attribute of + + the <emphasis role="bold"><property>&lt;b:birt&gt;</property></emphasis> component.</para> + </listitem> + <listitem> + <para>Deploy the project onto the server and open your browser to see the report is successfully generated. You should navigate to + + <code>http://localhost:8080/yourProjectName/Products.seam</code> to select the criterion and press the <property>Generate Report</property> button. You will be redirected to the <code>http://localhost:8080/HelloBirt/ProductsReport.seam</code> + + </para> + <figure> + <title>Dynamic Report</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/birt_reports_deployment/productReport.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> +</orderedlist> + <para>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 bound + to either Hibernate Session Factory or Hibernate Entity Manager Factory. If you + don&apos;t specify the JNDI URL property, our engine will try the following JNDI + URLs:</para> + <itemizedlist> + <listitem> + <para> + <emphasis>java:/&lt;project_name&gt;</emphasis> + </para> + </listitem> + <listitem> + <para> + <emphasis>java:/&lt;project_name&gt;EntityManagerFactory</emphasis> + </para> + </listitem> + </itemizedlist> + + <para>When creating a Seam EAR project, Hibernate Entity Manager Factory is bound to + <emphasis>java:/{projectName}EntityManagerFactory</emphasis>. All you need to do is + to use the Hibernate Configuration created automatically. You can use default values for the + Hibernate Configuration and JNDI URL within the BIRT Hibernate Data Source.</para> + + <para>When using a Seam WAR project, neither HSF nor HEMF aren&apos;t bound to JNDI by + default. You have to do this manually. For instance, HSF can be bound to JNDI by adding the + following property to the <emphasis> + <property>persistence.xml</property></emphasis> file:</para> + + <programlisting role="XHTML"><![CDATA[<property name="hibernate.session_factory_name" value="java:/projectname"/> + ]]></programlisting> + + <para>And you can use <emphasis>java:/projectname</emphasis> as the JNDI URL property when creating a BIRT + Hibernate Data Source.</para> + + <note> + <title>Note:</title> + <para>If you want to test this feature using PDE Runtime, you need to add <emphasis> + <property>osgi.dev=bin</property> + </emphasis> to the <emphasis> + <property>WebContent/WEB-INF/platform/configuration/config.ini</property> + </emphasis> file.</para> + </note> + + <para>In conclusion, the main goal of this document is to get you to know with a full feature set + that <property>JBoss BIRT Tools</property> provide. Thus if you have some questions, + comments or suggestions on the topic, please feel free to ask in the <ulink + url="http://www.jboss.org/index.html?module=bb&amp;op=viewforum&... + Tools Forum</ulink>. You can also influence on how you want to see JBoss Tools docs in + future leaving your vote on the article <ulink + url="http://www.jboss.org/community/docs/DOC-10795">Overview of the improvements required by JBossTools/JBDS Docs users</ulink>.</para> + +</section> Added: trunk/birt/docs/en-US/modules/framework.xml =================================================================== --- trunk/birt/docs/en-US/modules/framework.xml (rev 0) +++ trunk/birt/docs/en-US/modules/framework.xml 2010-04-15 20:02:26 UTC (rev 21507) @@ -0,0 +1,260 @@ +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="framework"> + <?dbhtml filename="framework.html"?> + + <chapterinfo> + <keywordset> + + <keyword>Eclipse</keyword> + <keyword>JBoss</keyword> + <keyword>JBoss Tools</keyword> + <keyword>BIRT Integration</keyword> + </keywordset> + </chapterinfo> + + <title>JBoss BIRT Integraion Framework API Reference</title> + + +<section> + + <title> + <emphasis role="bold"> <property>&lt;b:birt&gt;</property></emphasis> Component + </title> + + + +<para> + The <emphasis role="bold"> <property>&lt;b:birt&gt;</property></emphasis> component servers to integrate a BIRT report into Seam/JSF container. + The <emphasis role="bold"> <property>&lt;b:birt&gt;</property></emphasis> tag recognizes most of the parameters described on the BIRT + <ulink url="http://www.eclipse.org/birt/phoenix/deploy/viewerUsage2.2.php#p... Viewer Parameters</ulink> page, though it has attributes of its own. + +</para> + + + <table> + <title><emphasis role="bold"> <property>&lt;b:birt&gt;</property></emphasis> Component Reference</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Attribute</entry> + <entry>Correspondance to BIRT Report Viewer parameters</entry> + <entry>Description/</entry> + + </row> + </thead> + <tbody> + <row> + <entry>designType</entry> + <entry> - </entry> + <entry>Corresponds to the BIRT servlet mappings. Possible values are run, frameset, preview and embed. + If the attribute is set to embed the component is used for + embeddable html. This type ignores all the attributes except designName + and masterpage. + </entry> + </row> + <row> + <entry>embeddable</entry> + <entry> - </entry> + <entry>A BIRT report occupies the whole page by default. It contains the &lt;html&gt;, + &lt;head&gt;, &lt;body&gt; etc., tags. Embedded report can be a part of another page. + It doesn't contain the above mentioned tags. Only HTML report can be embedded.</entry> + </row> + <row> + <entry>designName</entry> + <entry>__report</entry> + <entry>Sets the name of the report design to process. This can be an absolute path or relative to the working folder. Valid values are run, frameset and preview</entry> + </row> + + <row> + <entry>format</entry> + <entry>__format</entry> + <entry>Specifies the desired output format, such as pdf, html, doc, ppt, or xls.</entry> + </row> + + <row> + <entry>title</entry> + <entry>__title</entry> + <entry>Sets the report title.</entry> + </row> + + <row> + <entry>showtitle</entry> + <entry>__showtitle</entry> + <entry>Determines if the report title is shown in the frameset viewer. Defaults to true.</entry> + </row> + + <row> + <entry>toolbar</entry> + <entry>__toolbar</entry> + <entry> + + Determines if the report toolbar is shown in the frameset viewer.Defaults to true. Valid values are true and false.</entry> + </row> + + + + <row> + <entry>navigationbar</entry> + <entry>__navigationbar</entry> + <entry> + + Determines if the navigation bar is shown in the frameset viewer. Defaults to true. Valid values are true and false.</entry> + </row> + + + <row> + <entry>document</entry> + <entry>__document</entry> + <entry> + Sets the name for the rptdocument. The document is created when the report engine separates run and render tasks, and + is used to support features like table of contents and pagination. + This setting can be an absolute path or relative to the working folder. If no document parameter is used, a unique document is created in the document folder. + </entry> + </row> + + <row> + <entry>locale</entry> + <entry>__locale</entry> + <entry> + Specifies the locale for the specific operation. Note that this will override the default locale. + </entry> + </row> + <row> + <entry>svg</entry> + <entry>__svg</entry> + <entry> + Specifies whether SVG is supported. + </entry> + </row> + + + + <row> + <entry>page</entry> + <entry>__page</entry> + <entry> + Specifies specific page to render. + </entry> + </row> + + + <row> + <entry>pagerange</entry> + <entry>__pagerange</entry> + <entry> + Specifies page range to render. Eg 1-4,7. + </entry> + </row> + + + <row> + <entry>masterpage</entry> + <entry>__masterpage</entry> + <entry> + + Indicates that the report master page should be used or not. Validvalues are true and false. + </entry> + </row> + + + <row> + <entry>overwrite</entry> + <entry>__overwrite</entry> + <entry> + + This setting if set to true will force an overwrite of the existing report document. + </entry> + </row> + + <row> + <entry>bookmark</entry> + <entry>__bookmark</entry> + <entry> + + Specifies a specific bookmark within the report to load. The viewer will automatically load the appropriate page. + </entry> + </row> + + + + <row> + <entry>rtl</entry> + <entry>__rtl</entry> + <entry> + Specifies whether to display the report in right to left format. This setting defaults to false. + </entry> + </row> + + + + <row> + <entry>fittopage</entry> + <entry>__fittopage</entry> + <entry> + Specifies whether PDF generation should fit content to a page. Valid values are true and false. + </entry> + </row> + + + <row> + <entry>resourceFolder</entry> + <entry>__resourceFolder</entry> + <entry> + Specifies the resource folder to use. This setting will override the default setting in the web.xml. The resource folder is used to locate libraries, images, and resource files. + </entry> + </row> + + </tbody> + </tgroup> + </table> + +</section> + + <section> + <title><emphasis role="bold"> <property>&lt;b:param&gt;</property></emphasis> Component</title> + <para> + The <emphasis role="bold"> <property>&lt;b:param&gt;</property></emphasis> tag describes report parameter. + </para> + + <table> + <title><emphasis role="bold"> <property>&lt;b:param&gt;</property></emphasis> Component</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Attribute</entry> + + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>name</entry> + <entry>The parameter name. Required.</entry> + </row> + <row> + <entry>value</entry> + <entry>The parameter value. Required.</entry> + </row> + + <row> + <entry>isnull</entry> + <entry>Specifies that a report parameter has a null value</entry> + </row> + <row> + <entry>islocale</entry> + <entry>Specifies whether the parameter is localized</entry> + </row> + + </tbody> + + </tgroup> + </table> + </section> + + + + + + + +</chapter> Added: trunk/birt/docs/en-US/modules/hibernate_datasource.xml =================================================================== --- trunk/birt/docs/en-US/modules/hibernate_datasource.xml (rev 0) +++ trunk/birt/docs/en-US/modules/hibernate_datasource.xml 2010-04-15 20:02:26 UTC (rev 21507) @@ -0,0 +1,213 @@ +<?xml version='1.0' encoding='UTF-8'?> +<section id="hibernate_datasource"> + + + <title>Using Hibernate ODA Data Source</title> + + <para>The JBoss BIRT Integration feature includes the Hibernate ODA Data Source which is completely + integrated with Hibernate Tools. You can use it the way as you would use any of BIRT ODA drivers. + + </para> + +<orderedlist> + <listitem> + <para>First, you need to reverse engineer from the database to generate Seam entities. You can perform this operation going to <emphasis> + <property>File &gt; New &gt; Seam Generate Entities</property> + </emphasis> in the <property>Seam perspective</property>. More details on the Seam Generate + Entities please read <ulink + url="http://download.jboss.org/jbosstools/nightly-docs/en/seam/html_... + >Seam Dev Tools Reference guide</ulink>). + In this guide we will use the <property>Employees</property> table of the <property>DATAMODELS</property> database. +</para> + + <tip> + <title>Tip:</title> + <para>Before performing Seam Generate Entities, you should have a connection profile + adjusted and connected to a database. How to do this see in the <ulink + url="http://download.jboss.org/jbosstools/nightly-docs/en/seam/html_... + >CRUD Database Application</ulink> chapter of the Seam Dev Tools Reference + guide.</para> + <para> + If you followed the steps described in the + <link linkend="birt_integration_with_seam">Adding BIRT Functionality to Standard Seam Web Project</link> chapter, + you would have a connection profile already configured. + </para> + </tip> + </listitem> + <listitem> +<para> + Next you should create a new BIRT report file ( <emphasis>><property>File &gt; New &gt; Other &gt; Business Intelligence and Reporting + Tools &gt; Report</property></emphasis>) to represent the data from the <property>Employees</property> table. Call the file <property>employees.rptdesign</property>. +</para> + </listitem> + +<listitem> + + + <para>Now switch to the <property>BIRT Report Design</property> perspective.</para> +</listitem> + <listitem> + <para>In the <property>Data Explorer</property> view right-click the <emphasis> + <property>Data Source</property> + </emphasis> node and choose <emphasis> + <property>New Data Source</property>.</emphasis></para> + + <figure> + <title>Creating a New Data Source</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/hibernate_datasource/creatingDataSource.png"/> + </imageobject> + </mediaobject> + </figure> +</listitem> + <listitem> + <para>The wizard will prompt you to select data source type. Choose <emphasis> + <property>Hibernate Data Source</property> + </emphasis> and give it a meaningful name, for instance <emphasis> + <property>HibernateDataSource</property> + </emphasis>. Hit <emphasis> + <property>Next</property> to proceed.</emphasis></para> + + <figure> + <title>Creating Hibernate Data Source</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/hibernate_datasource/hibernateDataSource.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem> + <para>On the next wizard's dialog you can leave the everything with default values, press the <emphasis> + <property>Test Connection</property> + </emphasis> button to verify that the connection is established successfully.</para> + + <para> + The <property>Hibernate Data Source</property> enables you to specify a Hibernate Configuration or JNDI URL. + + </para> + + <figure> + <title>Hibernate Data Source Profile</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/hibernate_datasource/connectionSuccessful.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem> + <para>Press <emphasis> + <property>Finish</property> + </emphasis> to complete <property>New Data Source</property> wizard.</para> + </listitem> + + <listitem> + <para>Now you need to configure a new Hibernate ODA data set. Launch the + <property>New Data Set</property> wizard. In the <property>Data Explorer View</property> + right-click the <emphasis> + <property>Data Set</property> + </emphasis> node and select <emphasis> + <property>New Data Set</property>.</emphasis></para> + + </listitem> + <listitem> + <para>Select <property>HibernateDataSource</property> as target data source and type in the new data set name. + Call it <property>HibernateDataSet</property>.</para> + + + + + <figure> + <title>Creating a Hibernate ODA Data Set</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/hibernate_datasource/addingHibernateODADataset.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem> + + <para>The next dialog of the wizard will help you compose a query for the new data set.</para> + <para>We will make a report that will print all employees in the database who has Sales Rep job title.</para> + + <programlisting role="SQL"><![CDATA[... +select jobtitle, firstname, lastname, email +from Employees as employees where employees.jobtitle = 'Sales Rep' +...]]></programlisting> + + + + <para> + + To validate the + entered query you can press the <emphasis> + <property>Test query</property> + </emphasis> button. All the HQL features like syntax highlighting, content assist, + formatting, drag-and-drop, etc., are available to facilitate query composing.</para> + + <figure> + <title>Composing query for Data Set</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/hibernate_datasource/testingQuery.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem> + + <para>Pressing <property>Finish</property> will call the <property>Edit Data Set</property> dialog where you can adjust the parameters of the data set and preview the resulted set. + If everything looks good, hit <property>Ok</property> to generate a new data set. + </para> + </listitem> + <listitem> + + <para>Now you can insert the data set items of <property>HibernateDataSet</property> into the <property>employees.rptdesign</property>.</para> + + + <tip> + <title>Tip:</title> + <para>If you don&apos;t know how to do this we suggest that you refer to the <ulink + url="http://www.eclipse.org/birt/phoenix/tutorial/">Eclipse BIRT Tutorial</ulink>.</para> + </tip> + + +<para>You can also use parameters in the query to add dynamics to your report. In the previous example we hardcoded the selection criterion in the <code>where</code> clause. </para> + <para>To specify the job title on-the-fly your query should look like this:</para> + <programlisting role="XML"><![CDATA[ +select jobtitle,firstname, lastname,email +from Employees as employees where employees.jobtitle = ? +]]></programlisting> + + <para>The question mark represents a data set input parameter, which is not the same as a report parameter. + Now you need to define an new report parameter to pass the data to the report, call it <code>JobTitle</code>. + + + + The dataset parameter can be linked to a report parameter. + In the <property>Data Explorer</property> view click the Data Set node to open it and right-click + on the data set you created previously( in our case it is <property>HibernateDataSet</property>), + choose <property>Edit</property> and navigate to the <property>Parameters</property> section. + Declare a new data set parameter, name it <code>jobtitle</code> and map it to the already existing <code>JobTitle</code> report parameter. + </para> + </listitem> + <listitem> + <para>You report is ready, you can view it by clicking on the <property>Preview</property> tab of the <property>BIRT Report Designer</property> editor. </para> + + + <para>You will be prompted to assign a value to the report parameter. For instance you can enter &quot;Sales Rep&quot;. </para> + + <figure> + <title>Resulted Dynamic Report</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/hibernate_datasource/finalReport.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> +</orderedlist> +</section> Added: trunk/birt/docs/en-US/modules/introduction.xml =================================================================== --- trunk/birt/docs/en-US/modules/introduction.xml (rev 0) +++ trunk/birt/docs/en-US/modules/introduction.xml 2010-04-15 20:02:26 UTC (rev 21507) @@ -0,0 +1,113 @@ +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="introduction"> + <?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>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.</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>You can find more detailed information on the BIRT plugin, its report types and + anatomy on the <ulink url="http://www.eclipse.org/birt/phoenix/intro/">BIRT Homepage</ulink>.</para> + + <para>To understand the basic BIRT concepts and to know how to create a basic BIRT report, + refer to the <ulink url="http://www.eclipse.org/birt/phoenix/tutorial/">Eclipse BIRT + Tutorials</ulink>. What extensions <property>JBoss Tools</property> provides for + Eclipse BIRT you&apos;ll find out in the next sections.</para> + </section> + + + + <section> + <title>JBoss BIRT Integration Functionality Overview</title> + + <para> + The key feature of JBoss BIRT Integration is the JBoss BIRT Integration Framework, which allows to integrate a BIRT report into Seam/JSF container. + The framework API reference is in the + <link linkend="framework">JBoss BIRT Integraion Framework API Reference</link> chapter of the guide. + </para> + <para> + + This guide also covers functionality of <property>JBoss Tools</property> module which assists in + integration with BIRT. + The integration plug-in allows you to visually configure <property>Hibernate Data Source</property> (specify a Hibernate configuration or JNDI URL), + compose HQL queries with syntax-highlighting, content-assist, formatting as well as other functionalities available in the HQL editor. + + + </para> + + <para> + To enable <property>JBoss Tools</property> integration with BIRT you are intended to + have the next: + </para> + <itemizedlist> + <listitem> + <para>Eclipse with <property>JBoss Tools</property> + installed (how to install <property>JBoss Tools</property> on Eclipse, what + dependences and versions requirements are needed reed in the <ulink + url="&gsglink;#JBossToolsInstall" + >JBoss Tools Installation</ulink> section)</para> + </listitem> + <listitem> + <para>BIRT Report Designer (BIRT Report Designer 2.3.2 + you can download from <ulink + url="http://www.eclipse.org/downloads/download.php?file=/birt/downlo... + >Eclipse downloads site</ulink>)</para> + </listitem> + <listitem> + <para>BIRT Web Tools Integration ( BIRT WTP Integration 2.3.2 you can download from + <ulink + url="http://www.eclipse.org/downloads/download.php?file=/birt/downlo... + >Eclipse downloads site</ulink>)</para> + </listitem> + </itemizedlist> + + <note> + <title>Note:</title> + <para>Versions of BIRT framework and BIRT WTP integration should be no less than RC4 in + order to the BIRT facet works correctly.</para> + </note> + </section> + + + +</chapter> Added: trunk/birt/docs/en-US/modules/links.xml =================================================================== --- trunk/birt/docs/en-US/modules/links.xml (rev 0) +++ trunk/birt/docs/en-US/modules/links.xml 2010-04-15 20:02:26 UTC (rev 21507) @@ -0,0 +1,23 @@ +<?xml version='1.0' encoding='UTF-8'?> + +<chapter id="birt_plugin_rel_resources" xreflabel="birt_plugin_rel_resources"> + <?dbhtml filename="links.html"?> + <chapterinfo> + <keywordset> + + <keyword>Eclipse</keyword> + <keyword>JBoss</keyword> + <keyword>JBoss Tools</keyword> + <keyword>BIRT Integration</keyword> + </keywordset> + </chapterinfo> + + + <title>Other Relevant Resources on the Topic</title> + + <para>All JBoss Developer Studio/JBoss Tools release documentation you can find at <ulink url="http://docs.jboss.org/tools/">http://docs.jboss.org/too... in the corresponding release directory.</para> + <para>The latest documentation builds are available at <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">htt...;. + +</para> + +</chapter> Added: trunk/birt/docs/en-US/modules/tasks.xml =================================================================== --- trunk/birt/docs/en-US/modules/tasks.xml (rev 0) +++ trunk/birt/docs/en-US/modules/tasks.xml 2010-04-15 20:02:26 UTC (rev 21507) @@ -0,0 +1,26 @@ +<?xml version='1.0' encoding='UTF-8'?> + +<chapter id="tasks" xreflabel="tasks"> + <?dbhtml filename="tasks.html"?> + <chapterinfo> + <keywordset> + + <keyword>Eclipse</keyword> + <keyword>JBoss</keyword> + <keyword>JBoss Tools</keyword> + <keyword>BIRT Integration</keyword> + </keywordset> + </chapterinfo> + + <title>Tasks</title> + <para> In this chapter of the guide you will find information on the tasks that you can perform integrating BIRT. The required version of BIRT is 2.3.2 or greater.</para> + + + + + &birt_integration_with_seam; + &hibernate_datasource; + &birt_reports_deployment; + + +</chapter>