Skip to Content

Free-Hand SQL Extension Sample for Web Intelligence for 4.1 SP5


The attached file contains all needed resources of the Free-Hand SQL Extension Point sample. You can try it out with SAP BusinessObjects Web Intelligence 4.1 SP5 only.

  1. Download the ZIP file.
  2. Unpack it.
  3. Rename it to com.businessobjects.webpath.AnalyticalReporting_SAP_FHSQL_1.0.0.jar.
  4. Follow the instructions below to deploy the extension in your production environment.

You can also consult:


  1. Stop Apache Tomcat and the SIA.
  2. Copy the JAR file to the following folders:
    • <bip-install-dir>\warfiles\webapps\BOE\WEB-INF\eclipse\plugins
    • <tomcat-dir>\webapps\BOE\WEB-INF\eclipse\plugins
    • <tomcat-dir>\work\Catalina\localhost\BOE\eclipse\plugins
  3. Start Apache Tomcat and the SIA.

Perform the additional step below on a client machine to use the extension with the Java interface of Web Intelligence. You must have Java 7 installed. You do not have to perform this step when deploying the sample for Web Intelligence Rich Client.

  • Copy the jfxrt.jar file to the ext folder. How you do this depends on whether you are using a 32-bit or 64-bit client machine:
    • For a 32-bit client machine, copy the file C:\Program Files\Java\jre7\lib\jfxrt.jar to the folder: C:\Program Files\Java\jre7\lib\ext.
    • For a 64-bit client machine, copy the file C:\Program Files (x86)\Java\jre7\lib\jfxrt.jar to the folder: C:\Program Files (x86)\Java\jre7\lib\ext.

Note: You do not have to perform this step if you have upgraded to Java 8.


  1. Go to the CMC.
  2. Select Users and Groups, right-click on the user or group you want to apply the extension to, and select Customization.

  3. Select the Extensions tab to display all installed extensions.
  4. Check the Free Hand SQL 1.0.0 extension.


  1. Launch the BI launch pad and create a new document.
  2. Click the new icon in the left-side pane.

  3. Click Browse to fetch the available connections.

  4. Select a connection and click Next.
  5. In the SQL text area, enter a valid SQL statement, then Click Create.

    You should see the message:

  6. You'll be prompted with the possibility to modify the objects properties. You can do so if needed, then click Update.

    The report should be refreshing and you'll get the following message saying that the FHSQL data provider has been updated.

  7. Select the Available Objects icon. You should see the objects retrieved from your FHSQL query. You can now use them for the creation of your report.