improve webtools, birt help....
git-svn-id: https://svn.apache.org/repos/asf/ofbiz/branches/addBirt@826599 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/applications/content/data/WebtoolsHelpData.xml b/applications/content/data/WebtoolsHelpData.xml
index 527fd4a..b5d706b 100644
--- a/applications/content/data/WebtoolsHelpData.xml
+++ b/applications/content/data/WebtoolsHelpData.xml
@@ -45,5 +45,12 @@
<Content contentId="SELENIUM_HTTPS" contentTypeId="DOCUMENT" contentName="OFBiz Selenium with HTTPS" templateDataResourceId="HELP_TEMPL" dataResourceId="SELENIUM_HTTPS" localeString="en" statusId="CTNT_IN_PROGRESS" mimeTypeId="text/html"/>/>
<ContentAssoc contentId="DOCUMENTS" contentIdTo="SELENIUM_HTTPS" contentAssocTypeId="SUB_CONTENT" fromDate="2006-01-12 01:01:01" sequenceNum="" />
+ <!-- BIRT Help -->
+ <DataResource dataResourceId="HELP_BIRT" localeString="en" dataResourceTypeId="OFBIZ_FILE"
+ objectInfo="framework/webtools/data/helpdata/HELP_BIRT.xml" dataTemplateTypeId="NONE" statusId="CTNT_IN_PROGRESS"
+ dataResourceName="BIRT" mimeTypeId="text/xml" isPublic="Y" />
+ <Content contentId="HELP_BIRT" contentTypeId="DOCUMENT" contentName="BIRT" templateDataResourceId="HELP_TEMPL"
+ dataResourceId="HELP_BIRT" statusId="CTNT_IN_PROGRESS" mimeTypeId="text/html"/>/>
+ <ContentAssoc contentId="HELP_WEBTOOLS" contentIdTo="HELP_BIRT" contentAssocTypeId="TREE_CHILD" fromDate="2006-01-12 01:01:01" sequenceNum="" mapKey="WEBTOOLS_birt"/>
</entity-engine-xml>
\ No newline at end of file
diff --git a/framework/webtools/data/helpdata/BirtHelpData.xml b/framework/webtools/data/helpdata/BirtHelpData.xml
deleted file mode 100644
index b37f357..0000000
--- a/framework/webtools/data/helpdata/BirtHelpData.xml
+++ /dev/null
@@ -1,32 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
-Licensed to the Apache Software Foundation (ASF) under one
-or more contributor license agreements. See the NOTICE file
-distributed with this work for additional information
-regarding copyright ownership. The ASF licenses this file
-to you under the Apache License, Version 2.0 (the
-"License"); you may not use this file except in compliance
-with the License. You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing,
-software distributed under the License is distributed on an
-"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, either express or implied. See the License for the
-specific language governing permissions and limitations
-under the License.
--->
-<entity-engine-xml>
- <DataResource dataResourceId="HELP_BIRT" localeString="en" dataResourceTypeId="OFBIZ_FILE"
- objectInfo="framework/webtools/data/helpdata/HELP_BIRT.xml" dataTemplateTypeId="NONE" statusId="CTNT_IN_PROGRESS"
- dataResourceName="BIRT Overview" mimeTypeId="text/xml" isPublic="Y" />
- <Content contentId="HELP_BIRT" contentTypeId="DOCUMENT" contentName="BIRT Overview" templateDataResourceId="HELP_TEMPL"
- dataResourceId="HELP_BIRT" statusId="CTNT_IN_PROGRESS" mimeTypeId="text/html"/>/>
- <ContentAssoc contentId="HELP_ROOT" contentIdTo="HELP_BIRT" contentAssocTypeId="TREE_CHILD" fromDate="2006-01-12 01:01:01" sequenceNum="000"/>
-
- <DataResource dataResourceId="BIRT_reports" localeString="en" dataResourceTypeId="OFBIZ_FILE"
- objectInfo="framework/webtools/data/helpdata/HELP_BIRT_reports.xml" dataTemplateTypeId="NONE" statusId="CTNT_IN_PROGRESS" dataResourceName="BIRT Reports" mimeTypeId="text/xml" isPublic="Y" />
- <Content contentId="BIRT_reports" contentTypeId="DOCUMENT" contentName="Reports" templateDataResourceId="HELP_TEMPL" dataResourceId="BIRT_reports" statusId="CTNT_IN_PROGRESS" mimeTypeId="text/html"/>
- <ContentAssoc contentId="HELP_BIRT" contentIdTo="BIRT_reports" contentAssocTypeId="TREE_CHILD" fromDate="2006-01-12 01:01:01" sequenceNum="000"/>
-</entity-engine-xml>
\ No newline at end of file
diff --git a/framework/webtools/data/helpdata/HELP_BIRT.xml b/framework/webtools/data/helpdata/HELP_BIRT.xml
index ed9f58a..a041331 100644
--- a/framework/webtools/data/helpdata/HELP_BIRT.xml
+++ b/framework/webtools/data/helpdata/HELP_BIRT.xml
@@ -23,27 +23,64 @@
xsi:schemaLocation="http://docbook.org/ns/docbook ../../../content/dtd/docbook.xsd"
xmlns="http://docbook.org/ns/docbook">
- <title>BIRT Overview</title>
+ <title>OFBiz BIRT </title>
<para>
- BIRT is an Eclipse-based open source reporting system for web applications,
- especially those based on Java and J2EE. BIRT has two main components: a report designer based on Eclipse,
- and a runtime component that you can add to your app server.
- BIRT also offers a charting engine that lets you add charts to your own application.
+ Welcome to OFBiz Birt. The part installed within OFBiz allows you to run the reports which are prepared using Eclipse with the Birt plugin installed.
+ As a demo we have prepared a product report as an example.
+ Look at the <link xl:href="http://eclipse.org/birt/phoenix/">Eclipse BIRT web site</link> for more information.
+ </para>
+ <para>
+ This is a short document to help you get started using BIRT to make a report.
</para>
<section>
- <title>With BIRT, you can add a rich variety of reports to your application.</title>
- <para>Lists - The simplest reports are lists of data. As the lists get longer,
- you can add grouping to organize related data together (orders grouped by customer,
- products grouped by supplier). If your data is numeric, you can easily add totals, averages and other summaries.</para>
- <para>Charts - Numeric data is much easier to understand when presented as a chart.
- BIRT provides pie charts, line & bar charts and many more.
- BIRT charts can be rendered in SVG and support events to allow user interaction.</para>
- <para>Crosstabs - Crosstabs (also called a cross-tabulation or matrix) shows data in two dimensions: sales per quarter or hits per web page.</para>
- <para>Letters & Documents - Notices, form letters, and other textual documents are easy to create with BIRT.
- Documents can include text, formatting, lists, charts and more.</para>
- <para>Compound Reports - Many reports need to combine the above into a single document.
- For example, a customer statement may list the information for the customer,
- provide text about current promotions, and provide side-by-side lists of payments and charges. A financial report may include disclaimers,
- charts, tables all with extensive formatting that matches corporate color schemes.</para>
+ <title>1. Viewer tab</title>
+ <para>When you click on the Viewer tab. It will show the report in the viewer where the report can be paged.</para>
+ </section>
+ <section>
+ <title>2. Report tab</title>
+ <para>When you click on the Report tab. It will show the complete report in an iframe.</para>
+ </section>
+ <section>
+ <title>3. Mail tab</title>
+ <para>When you click on the Mail tab. It will show a form that can send the report per email.</para>
+ </section>
+ <section>
+ <title>4. View Handler tab</title>
+ <para>When you click on the View Handler tab. It will render the report in a pdf format</para>
+ </section>
+ <section>
+ <title>Examine the Example Report</title>
+ <para>
+ The example report that run in OFBiz is in the file component://webtools/webapp/birt/report/product.rptdesign. When you have started Eclipse Birt, open this document.
+ This report show how a report receives data from OFBiz through Scripted Data Source using the OFBiz delegator.
+ This report has the scripted data source name "OFBiz" and the data set that use the script data source name is called "Product".
+ Open the script editor for Product data set, it uses the delegator object query data from the Product entity.
+ A report that runs on the OFBiz platform can use the delegator object, dispatcher object, security object and classpath of OFBiz environment in the script.</para>
+ </section>
+ <section>
+ <title>Important file for using BIRT's jsp tags</title>
+ <para>
+ If a web applications wants to use the report in a screen, copy birt.tld file to [WEB APP]/WEB-INF/ directory ant assign in in ftl
+ like <#assign birt = JspTaglibs["/WEB-INF/birt.tld"]/></para>
+ </section>
+ <section>
+ <title>Important tag's attribute in ftl.</title>
+ <para>
+ The BIRT Viewer uses some servlets and resource files such as image, js, css for rendering the report and viewer.
+ When you use the viewer tag or report tag in a ftl file you must add a specific "baseURL" attribute to the birt webapp for these resources like baseURL="/birt".
+ </para>
+ </section>
+ <section>
+ <title>How do I send parameter to report.</title>
+ <para>If a report is to be rendered through a view map, you can send a parameter through attribute of the request object, the attribute's name is "birtParameters" which is a map.</para>
+ <para>If a report is to be rendered through an e-mail, you can send the parameter through the service's parameter name called birtParameters.</para>
+ </section>
+ <section>
+ <title>Which are the supported content types?</title>
+ <para>text/html</para>
+ <para>application/pdf</para>
+ <para>application/vnd.ms-excel</para>
+ <para>application/vnd.ms-word</para>
+ <para>application/vnd.ms-powerpoint</para>
</section>
</section>
\ No newline at end of file
diff --git a/framework/webtools/data/helpdata/HELP_BIRT_reports.xml b/framework/webtools/data/helpdata/HELP_BIRT_reports.xml
index 9fb5947..e69de29 100644
--- a/framework/webtools/data/helpdata/HELP_BIRT_reports.xml
+++ b/framework/webtools/data/helpdata/HELP_BIRT_reports.xml
@@ -1,66 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
-Licensed to the Apache Software Foundation (ASF) under one
-or more contributor license agreements. See the NOTICE file
-distributed with this work for additional information
-regarding copyright ownership. The ASF licenses this file
-to you under the Apache License, Version 2.0 (the
-"License"); you may not use this file except in compliance
-with the License. You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing,
-software distributed under the License is distributed on an
-"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, either express or implied. See the License for the
-specific language governing permissions and limitations
-under the License.
--->
-<section xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="5.0"
- xmlns:xl="http://www.w3.org/1999/xlink"
- xmlns:xi="http://www.w3.org/2001/XInclude"
- xsi:schemaLocation="http://docbook.org/ns/docbook ../../../content/dtd/docbook.xsd"
- xmlns="http://docbook.org/ns/docbook">
-
- <section>
- <title>How do I create BIRT report in OFBiz.</title>
- <para>Create new report</para>
- <para>Create Scripted Data Source</para>
- <para>Create Data Set that use Scripted Data Source</para>
- <para>Add output columns</para>
- <para>Add script to Data Set</para>
- <para>Bind report's element to Data Set</para>
- </section>
- <section>
- <title>How do I add script code to report.</title>
- <para>Report can use delegator, dispatcher and security object in script.</para>
- <para>Report can use same classpath with ofbiz.</para>
- </section>
- <section>
- <title>How do I send parameter to report.</title>
- <para>If report be rendered through view map, you can send parameter through attribute of request object, attribute's name "birtParameters" that is map.</para>
- <para>If report be rendered through e-mail, you can send parameter through service's parameter name is birtParameters.</para>
- </section>
- <section>
- <title>How do I send report through e-mail.</title>
- <para>Report can sent through email by using sendBirtMail service.</para>
- </section>
- <section>
- <title>How do I embed report to screen.</title>
- <para>Report can embeded in screen by using jsp tag, viewer and report tag, that can use in ftl file.</para>
- </section>
- <section>
- <title>What content's type that report supported.</title>
- <para>text/html</para>
- <para>application/pdf</para>
- <para>application/vnd.ms-excel</para>
- <para>application/vnd.ms-word</para>
- <para>application/vnd.ms-powerpoint</para>
- </section>
- <section>
- <title>How do I change report content's type</title>
- <para>If report be rendered through view map, can set content's type at content-type attribute of view map.</para>
- <para>If report be rendered through e-mail, can set content's type at service's parameter name is birtContentType.</para>
- </section>
-</section>
\ No newline at end of file