How to Easily Query HCL Domino 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 HCL Domino, you can seamlessly integrate and query live HCL Domino data, bringing real-time insights directly into OpenOffice.

This guide simplifies the setup, showing you how to connect HCL Domino 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 HCL Domino data in the CData ODBC Driver for HCL Domino, 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 HCL Domino data data.

Configure the HCL Domino DSN Using the CData ODBC Driver for HCL Domino

To start, configure the DSN (Data Source Name) for HCL Domino data in your system using the CData ODBC Driver for HCL Domino. 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 HCL Domino data Source and enter the required values to establish a connection:

Connecting to Domino

To connect to Domino data, set the following properties:

• URL: The host name or IP of the server hosting the Domino database. Include the port of the server hosting the Domino database. For example: http://sampleserver:1234/
• DatabaseScope: The name of a scope in the Domino Web UI. The driver exposes forms and views for the schema governed by the specified scope. In the Domino Admin UI, select the Scopes menu in the sidebar. Set this property to the name of an existing scope.

Authenticating with Domino

Domino supports authenticating via login credentials or an Entra ID (formerly Azure AD) OAuth application:

Login Credentials

To authenticate with login credentials, set the following properties:

• AuthScheme: Set this to "OAuthPassword"
• User: The username of the authenticating Domino user
• Password: The password associated with the authenticating Domino user

The driver uses the login credentials to automatically perform an OAuth token exchange.

EntraID (formerly AzureAD)

This authentication method uses Entra ID (formerly Azure AD) as an IdP to obtain a JWT token. You need to create a custom OAuth application in Entra ID (formerly Azure AD) and configure it as an IdP. To do so, follow the instructions in the Help documentation. Then set the following properties:

• AuthScheme: Set this to "EntraID (formerly AzureAD)"
• InitiateOAuth: Set this to GETANDREFRESH. You can use InitiateOAuth to avoid repeating the OAuth exchange and manually setting the OAuthAccessToken.
• OAuthClientId: The Client ID obtained when setting up the custom OAuth application.
• OAuthClientSecret: The Client secret obtained when setting up the custom OAuth application.
• CallbackURL: The redirect URI defined when you registered your app. For example: https://localhost:33333
• AzureTenant: The Microsoft Online tenant being used to access data. Supply either a value in the form companyname.microsoft.com or the tenant ID.

  The tenant ID is the same as the directory ID shown in the Azure Portal's Entra ID (formerly Azure AD) > Properties page.

👁 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 HCL Domino 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 HCL Domino data objects.

• Review the HCL Domino data Object List: In the left pane, click on Tables to view the HCL Domino data objects now available within OpenOffice Base.
• View Object Data: Click on any object to view its contents. The HCL Domino 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 HCL Domino data in OpenOffice Base, with data readily available for analysis and reporting.

Create a Report

Now, let's generate a report based on your HCL Domino 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 HCL Domino 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 HCL Domino data, and ready for analysis.

Try CData Free for 30 Days

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