Author: hansbak
Date: Mon Oct 19 07:47:40 2009 New Revision: 826599 URL: http://svn.apache.org/viewvc?rev=826599&view=rev Log: improve webtools, birt help.... Removed: ofbiz/branches/addBirt/framework/webtools/data/helpdata/BirtHelpData.xml Modified: ofbiz/branches/addBirt/applications/content/data/WebtoolsHelpData.xml ofbiz/branches/addBirt/framework/webtools/data/helpdata/HELP_BIRT.xml ofbiz/branches/addBirt/framework/webtools/data/helpdata/HELP_BIRT_reports.xml Modified: ofbiz/branches/addBirt/applications/content/data/WebtoolsHelpData.xml URL: http://svn.apache.org/viewvc/ofbiz/branches/addBirt/applications/content/data/WebtoolsHelpData.xml?rev=826599&r1=826598&r2=826599&view=diff ============================================================================== --- ofbiz/branches/addBirt/applications/content/data/WebtoolsHelpData.xml (original) +++ ofbiz/branches/addBirt/applications/content/data/WebtoolsHelpData.xml Mon Oct 19 07:47:40 2009 @@ -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 Modified: ofbiz/branches/addBirt/framework/webtools/data/helpdata/HELP_BIRT.xml URL: http://svn.apache.org/viewvc/ofbiz/branches/addBirt/framework/webtools/data/helpdata/HELP_BIRT.xml?rev=826599&r1=826598&r2=826599&view=diff ============================================================================== --- ofbiz/branches/addBirt/framework/webtools/data/helpdata/HELP_BIRT.xml (original) +++ ofbiz/branches/addBirt/framework/webtools/data/helpdata/HELP_BIRT.xml Mon Oct 19 07:47:40 2009 @@ -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>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>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>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 Modified: ofbiz/branches/addBirt/framework/webtools/data/helpdata/HELP_BIRT_reports.xml URL: http://svn.apache.org/viewvc/ofbiz/branches/addBirt/framework/webtools/data/helpdata/HELP_BIRT_reports.xml?rev=826599&r1=826598&r2=826599&view=diff ============================================================================== --- ofbiz/branches/addBirt/framework/webtools/data/helpdata/HELP_BIRT_reports.xml (original) +++ ofbiz/branches/addBirt/framework/webtools/data/helpdata/HELP_BIRT_reports.xml Mon Oct 19 07:47:40 2009 @@ -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 |
Free forum by Nabble | Edit this page |