Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


Example Forms

Download the Database Connector Tutorial application. This application contains all of the example forms used in this tutorial. This download is a

 application zip file that you can uploaded into your user account. See Application Home Page documentation for more information on uploading this application zip file.


  1. Install and start the Database Connector on an in-house server in Standalone mode.

    titleClick here for the details
    1. Download the Standalone connector zipfile here.
    2. Unzip the file to a location of your choice. We will refer to this directory as <db-home>
    3. Install the JDBC driver, if required.
    4. You can start the connector using plain java command or execute one of the files in this directory to install the DB Connector as a Windows service or *nix console instance:
      1. Choose one of these methods to start the connector:
        1. Method 1: Using java in a command window
          1. Navigate to the <directory where you unzipped the database.zipfile>
          2. Type java -jar database.war
        2. Method 2: for Windows OS
          1. Install the DB Connector as a Windows service by double clicking the Install-Service.bat file. Click the Start DBConnector Service.bat to start the service.
        3. Method 2 for *nix OS
          1. Execute the  DB shell script for *nix operating systems.
    5. Test the connector installation by copying this URL directly into your browser:


    • Note the standalone connector runs on port 8081 by default. The port number can be changed when you configure the DB Connector in the next step. Use port 8081 to verify that the Db Connector is up and running for now. 
    • Verify that query validation page is loaded with status Passed for the built-in database BIRT and myStore querysets
  2. Verify that the Database Connector is accessible from the frevvo servers.
  3. Login as a designer user. Change the <localhost:8082> in all Rules and Doc URi's in the application to point to the <server:port> where you installed the DB Connector in Standalone mode. Save the changes.

Define a Queryset

The first step is to define a queryset and give it a name - BIRT in the configuration.xml file. Since we are using the built-in configuration.xml file, you do not have to do this. Here is an example of the BIRT queryset and the "allCustomers query that is described below.