Compilo Files

1. Introduction.

This is the file "readme.txt" originally written by Peter Shen.  I
just review his code and this document, mainly to correct a bug on the
compilation of subreports and to extend it to Compiere 252b.  Also I
add the correct copyright notice after an agreement with Peter.  This
is free software released under the GNU Lesser General Public License.

Thanks Peter to his good work. Centralize reports on server is the
better solution for me. Better than put them into the database, or
replicate them on each client, but we can discuss about this on the
Compilo Forums ;-)

The original document follows. I putted my notes at the end.

-------------------------- readme.txt --------------------------------

        Report SubProject Summary

The Report subProject's target is to set up an integration solution
between compiere and JasperReports.  And It is based on rus.jar,
though I change the package name.

        Author and Contributors
Peter Shen: Shanghai, China;    zpshen@gmail.com

        How to
1, The release package contains 2 jar file: ReportTools.jar includes JasperReports**.jar and the jars that the jasperReports needs.
    So, that means u can find these jars manually instead of using mine; Report.jar contains all the intergration classes.
2,  Copy the 2 jars into the COMPIERE_HOME\lib, including the 2 jar into the classpathi (3)
3,  Copy the report.jar into COMPIERE_HOME\jboss\server\compiere\deploy\
4,  copy the reportTools.jar into COMPIERE_HOME\jboss\server\compiere\lib\
5,  Modify the COMPIERE_HOME\util\Run_Server2.bat: like this:

    @Set ReportPath=%COMPIERE_HOME%/reports
    @Set JAVA_OPTS=-server %COMPIERE_JAVA_OPTIONS% -DReport_Home=%ReportPath%   

    ReportPath is the path you put your xml files
6,  The next is the same like the rus.jar:
    Login in with system adminsitrator, add a new column called JasperReport as VARCHAR into AD_Process table,
    Add the new field into Report&Process window,
    Here you can add the xml file path
7,  Example:
    1, make a report file with some jasperReports edit tools like iReport, save it as c:\compiere2\myReports\test\test.xml
       (suppose that you modify the ReportPath=c:\compiere2\myReports in Run_server2.bat)
    2, Create a process in Report&Process window, make the class as org.mycompiere.report.ReportStarter and jasperReport as test\test.xml
    3, Add the process into the menu
    4, relogin

        Developing plan for next release
Release 0.2, Planned Release Date: At the end of August
In this release, access check will be added, so that when the user develops the report xml file, he don't need to care for security problems.
    
        Release Log
    release 0.1.1     Release Date 2004-8-13
Add barcode support into Release 0.1 (Using IReport 0.3.1 with barbecue-1.1.jar)
    
        Release Log
    release 0.1     Release Date 2004-8-3
This is a alpha release, with is based on rus.jar and JasperReports-0.5.3. (JasperReports changes some package name, so maybe the other jasperReport
can not run with this one).
It moves all the xml file (report source file) to server side.

------------------------------ End of readme.txt ---------------------

2. Notes (by me).

0. Remember to setup the COMPIERE_HOME to build the library. In fact
you need the Compiere Source that is COMPIERE_HOME/../..

1. I did not put this on the Compilo cvs because there are no others
developers.  Just ask, if you want to improve this code.

2. The package name is changed. This is due to the fact that Peter do
not own the original "com.mycompiere" domain. So I changed it to
net.sf.compilo that I own as Compilo subAdministrator.

3. I prefere to include the jars inside the Compiere.jar, so
everything will run also from WebStart, and without to modify the
compiere.jnlp file.  You can modify the clientDistribute target inside
the client/build.xml file to do this.

4. Updating to the last version of Jasper Reports or iReport should
not be a problem. This code works with Compiere 252a and, at the
moment, with any subsequent version due to the change in the name of
the Logger class, actually named CLogger with different methods from
the preceding versions.

Regards,

Mar
Compilo subAdministrator
compilo.sf.net
lombardo@mayking.com, mar9000@gmail.com