How to Easily Query HubDB Data in OpenOffice Base

Apache OpenOffice Base is a versatile, free database tool that makes connecting and managing data easy. With CData ODBC Driver for HubDB, you can seamlessly integrate and query live HubDB data, bringing real-time insights directly into OpenOffice.

This guide simplifies the setup, showing you how to connect HubDB to OpenOffice Base so you can easily generate reports, analyze trends, and make informed decisions right within your familiar workspace.

Overview

Here is an overview of the steps:

1. CONFIGURE: Configure the DSN for HubDB data in the CData ODBC Driver for HubDB, using the required connection properties.
2. CONNECT: Set up the ODBC connection in OpenOffice Base using the configured DSN.
3. IMPORT: Once connected, review the available metadata and tables.
4. CREATE: Create a report based on the queried HubDB data data.

Configure the HubDB DSN Using the CData ODBC Driver for HubDB

To start, configure the DSN (Data Source Name) for HubDB data in your system using the CData ODBC Driver for HubDB. Download and install a 30-day free trial with all the features from here.

Once installed, launch the ODBC Data Source Administrator:

• On Windows: Search for ODBC Data Source Administrator in the Start menu and open the application.
• On Mac: Open Applications, go to Utilities, and select ODBC Manager.
• On Linux: Use the command line to launch ODBC Data Source Administrator or use unixODBC if installed.

👁 ODBC Data Source Administrator

Once launched, double-click on the CData HubDB data Source and enter the required values to establish a connection:

There are two authentication methods available for connecting to HubDB data source: OAuth Authentication with a public HubSpot application and authentication with a Private application token.

Using a Custom OAuth App

AuthScheme must be set to "OAuth" in all OAuth flows. Be sure to review the Help documentation for the required connection properties for you specific authentication needs (desktop applications, web applications, and headless machines).

Follow the steps below to register an application and obtain the OAuth client credentials:

1. Log into your HubSpot app developer account.
   • Note that it must be an app developer account. Standard HubSpot accounts cannot create public apps.
2. On the developer account home page, click the Apps tab.
3. Click Create app.
4. On the App info tab, enter and optionally modify values that are displayed to users when they connect. These values include the public application name, application logo, and a description of the application.
5. On the Auth tab, supply a callback URL in the "Redirect URLs" box.
   • If you're creating a desktop application, set this to a locally accessible URL like http://localhost:33333.
   • If you are creating a Web application, set this to a trusted URL where you want users to be redirected to when they authorize your application.
6. Click Create App. HubSpot then generates the application, along with its associated credentials.
7. On the Auth tab, note the Client ID and Client secret. You will use these later to configure the driver.

8. Under Scopes, select any scopes you need for your application's intended functionality.

   A minimum of the following scopes is required to access tables:

   • hubdb
   • oauth
   • crm.objects.owners.read
9. Click Save changes.
10. Install the application into a production portal with access to the features that are required by the integration.
    • Under "Install URL (OAuth)", click Copy full URL to copy the installation URL for your application.
    • Navigate to the copied link in your browser. Select a standard account in which to install the application.
    • Click Connect app. You can close the resulting tab.

Using a Private App

To connect using a HubSpot private application token, set the AuthScheme property to "PrivateApp."

You can generate a private application token by following the steps below:

1. In your HubDB account, click the settings icon (the gear) in the main navigation bar.
2. In the left sidebar menu, navigate to Integrations > Private Apps.
3. Click Create private app.
4. On the Basic Info tab, configure the details of your application (name, logo, and description).
5. On the Scopes tab, select Read or Write for each scope you want your private application to be able to access.
6. A minimum of hubdb and crm.objects.owners.read is required to access tables.
7. After you are done configuring your application, click Create app in the top right.
8. Review the info about your application's access token, click Continue creating, and then Show token.
9. Click Copy to copy the private application token.

To connect, set PrivateAppToken to the private application token you retrieved.

👁 Configuring a DSN (Salesforce is shown)

Setup an ODBC Connection in OpenOffice Base

Once you've set up the DSN, it's time to connect to it in OpenOffice Base and start querying data:

• Launch OpenOffice Base and select Database from the home screen.
👁 Apache OpenOffice Base Homescreen

• In the Database Wizard, choose ODBC from the 'Connect to an existing database' option and click Next.
👁 Apache OpenOffice Base Database Wizard

• Click Browse to locate and select the DSN you created, then click OK.
👁 Apache OpenOffice Base DSN (Salesforce is shown)

• Enter the username associated with the DSN, click Test Connection to verify, and then click Next.
👁 Apache OpenOffice Base Database Wizard (Salesforce details are shown)

• Finally, click Finish to save the new database file to your desired directory. This will connect OpenOffice Base to your live HubDB data data, ready for querying and analysis.
👁 Apache OpenOffice Base Database Save File

Your connection is now established — ready to query and analyze data seamlessly within OpenOffice Base.

Review the Metadata and Tables

After the database file is created and the connection is established, the table list will automatically display all available HubDB data objects.

• Review the HubDB data Object List: In the left pane, click on Tables to view the HubDB data objects now available within OpenOffice Base.
• View Object Data: Click on any object to view its contents. The HubDB data data will display directly within OpenOffice Base, allowing you to review records and fields with ease.

👁 Apache OpenOffice Base Metadata (Salesforce data is shown)

That's it! You have now successfully established a connection to HubDB data in OpenOffice Base, with data readily available for analysis and reporting.

Create a Report

Now, let's generate a report based on your HubDB data data.

• Open your database and go to the Reports tab, then select Create Report Using Wizard.
👁 Apache OpenOffice Base Report Screen

• In the Report Wizard, choose the HubDB data table from the Table or Query section. Select the columns from Available Fields that you want to include in your report and move them to the Fields in Report section using the arrows.
👁 Apache OpenOffice Base Report Table Objects (Salesforce is shown)

• After configuring the fields, click Finish to generate your report.
👁 Publishing Apache OpenOffice Base Report (with Salesforce data)

• Analyze, adjust, save, and publish the report as needed.

Your report is now created, drawing live data directly from HubDB data, and ready for analysis.

Try CData Free for 30 Days

Experience the power of live HubDB data data at your fingertips and seamlessly integrate it into OpenOffice Base. Start your free trial today!