| [birt-dev] Internet Pages structure, text and links updated, need some info for finishing |
Hi ! I have updated and partially revised the structure, text and links of the internet pages. You can find the result here: BIRT BIRT | BIRT (chloetz.github.io) To able to finalize the pages I need the info below. Who is able to procure the info and mail it to me? @you all Please edit the text and give me feedback on what you would like to see changed, improved, complemented. I need your information and image to be mentioned on the About page. I removed the blog menu as I have no blog entries for the moment. It can be complemented at any time. @Wayne Where shall I publish the final pages? Which Link shall I use as download page? Or what is the github address under which BIRT can be downloaded? Which link shall I use if somebody wants to subscribe the BIRT mailing list? Which link shall I give to someone who wants to join in as contributor? Do I need you approval that the text can be released. Or is there somebody else’s approval that is necessary? @Wim or some else ? I need somebody to update the text and hardcopies below and sends the update back to me. Building BIRTIntroductionThis document describes how to get the BIRT source from CVS and build it under Eclipse. If you simply want to use BIRT, it is easier to simply download an existing build. Building BIRT 2.1.1 is described below. RequirementsDownload the BIRT all in one designer. It is listed under "Report Designer Full Eclipse Install" on the download page. It is possible to build BIRT with an existing Eclipse install, but this method is the quickest, as all the required files, with the exception of iText.jar and iTextAsian.jar are present. Configuring EclipseThe BIRT source code uses some features that are only present in JDK 1.4.2 or later. In order for it to successfully build you need to set your compiler compliance to 1.4. Make sure this is not set to 5.0. You can set this for the entire workbench as follows: · From the menu, choose Window->Preferences. · In the tree, expand Java and choose Compiler. · On Compiler compliance level, select 1.4. · Unselect Use default compliance settings. · On Generated .class files compatibility, select 1.4. · On Source compatibility, select 1.4. · Choose OK. Understanding the CVS StructureThe BIRT modules are available in CVS in the source folder under /home/birt. BIRT has over 150 modules, some of these are described below.
Checking out Code from CVSConfigure the Repository Under Eclipse· To open the CVS Repository Exploring perspective, choose Window -> Open Perspective -> Other. In Select Perspective, select CVS Repository Exploring and choose OK. · Right-click on the CVS repositories window. From the context menu, choose New -> Repository Location. · On Add CVS Repository, set the following values:
· · Choose Finish A new node appears in the CVS Repositories window. Check Out Code for the First Time· Expand the new node in the repositories tree. · Select Versions · Select source · Open the source BIRT_2_1_1_Release_20060927 node · Select all the nodes under this node, with the exception of the these projects: · On CVS Repositories, right-click and choose Check Out from the context menu. Import Additional FilesImport iText 1.3 and iTextAsian into the com.lowagie.itext/lib directory.
If your Eclipse environment is not setup to build automatically, build the source now. This designer should build correctly. If you wish to build the Web Viewer proceed to the next section. Do this if you wish to make changes to the deployable Web Viewer Example. Preparing the ViewerThe viewer project contains an ant build script that builds the Web Viewer. When executed it will create a birt_web directory in the root of the viewer project. This directory can then be exported and deployed in a similar fasion to the Web Viewer example in the Report Engine download. To use this script, perform the following steps. · Copy the following plugins from the all in one download to the source directory of the workspace you are currently using to build BIRT. · In Package Explorer, expand the org.eclipse.birt.report.viewer project. · Right-click the BuildWebViewer.xml file. From the context menu, choose Run -> Ant Build.... · In the org.eclipse.birt.report.viewer BuildViewer.xml, select the Properties tab. Unselect Use global properties specified in the Ant runtime preferences as shown in the following illustration. Add the eclipse.home property and set it to your all in one Eclipse install directory. · Choose Run. The ant build of the Web Viewer runs in the console. This will create the birt_web directory within the project that contains the Web Viewer. Refresh the viewer project and the birt_web directory will be displayed. Running BIRTStart BIRT by running it as an Eclipse Application. This can be done as follows: · Select Run... from the Run menu on the menu bar · Select Eclipse Applicaiton from the list on the left and click on the New button as shown in the following illustration: · Click the Run button to launch the Eclipse Application. In the new Eclipse application start a new BIRT project and build reports as usual. You should be able to step through and debug the BIRT code. Instructions for Running JUnit Tests· Open debug perspective · click on Run --> Run --> Double click on JUnit Plug-in Test , this will create a new configuration. In the window, you can select among different options. Sample DatabaseInstallThe sample database is available in two forms: · Apache Derby database, which is included in the BIRT download · Scripts to load a MySQL database (Instructions below) The scripts to load a MySQL database are contained in the sample database zip file. This zip also has documentation and logos for the sample database. MySQL VersionTo install the MySQL version of the sample database, you must have MySQL installed. See mysql.com for instructions. Install the MySQL JDBC driver into BIRT: · Download and unzip MySQL Connector/J 3.1 JDBC driver located at: · Install the JDBC driver using the instructions on the install page. Enter the following for the URL template: You are now ready to create the Classic Models database: · Download the zip file containing the MySQL database scripts. · Expand the zip file into a convenient location. · Expanding the zip file created the ClassicModels/mysql directory with some MySQL scripts. From the command line, move to the this directory: · Start the mysql utility, giving the name (and password, if needed) of a user permission to create databases. For example, to use the default root user: · Create the ClassicModels database and load the schema. (Loading the schema the schema the first time will give error messages as it attemps to empty any existing tables, just ignore these.) · Load the table contents: · Exit from mysql: Localized Version of the Sample DatabaseFollowing is the Derby Database localized into French, German, Spanish, Japanese, Korean, and Simplified Chinese. · Localized Derby Sample Database UsageYou can now use the sample database within BIRT to create reports. The key information you need to get started is how to create a data source for the database. The details vary depending on the database system you selected. Apache DerbyThe Apache Derby version of the database is included in the BIRT download as a built-in data source. To access it, simply select the "Classic Models Inc. Sample Database" entry in the new data source dialog. MySQLData source properties for the MySQL sample database:
Christophe Loetz -------------------------------------------------------------------------------------------------- |
