We are proud to share our inclusion in the 2024 Gartner Magic Quadrant for Data Integration Tools. We believe this recognition reflects the differentiated business outcomes CData delivers to our customers.
Get the Report →Explore Geographical Relationships in HCL Domino Data with Power Map
Create data visualizations with HCL Domino data in Power Map.
The CData ODBC Driver for HCL Domino is easy to set up and use with self-service analytics solutions like Power BI: Microsoft Excel provides built-in support for the ODBC standard. This article shows how to load the current HCL Domino data into Excel and start generating location-based insights on HCL Domino data in Power Map.
Create an ODBC Data Source for HCL Domino
If you have not already, first specify connection properties in an ODBC DSN (data source name). This is the last step of the driver installation. You can use the Microsoft ODBC Data Source Administrator to create and configure ODBC DSNs.
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 Azure Active Directory 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.
AzureAD
This authentication method uses Azure Active Directory as an IdP to obtain a JWT token. You need to create a custom OAuth application in Azure Active Directory 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 "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 Azure Active Directory > Properties page.
When you configure the DSN, you may also want to set the Max Rows connection property. This will limit the number of rows returned, which is especially helpful for improving performance when designing reports and visualizations.
When you configure the DSN, you may also want to set the Max Rows connection property. This will limit the number of rows returned, which is especially helpful for improving performance when designing reports and visualizations.
Import HCL Domino Data into Excel
You can import data into Power Map either from an Excel spreadsheet or from Power Pivot. For a step-by-step guide to use either method to import HCL Domino data, see the "Using the ODBC Driver" section in the help documentation.
Geocode HCL Domino Data
After importing the HCL Domino data into an Excel spreadsheet or into PowerPivot, you can drag and drop HCL Domino entities in Power Map. To open Power Map, click any cell in the spreadsheet and click Insert -> Map.
In the Choose Geography menu, Power Map detects the columns that have geographic information. In the Geography and Map Level menu in the Layer Pane, you can select the columns you want to work with. Power Map then plots the data. A dot represents a record that has this value. When you have selected the geographic columns you want, click Next.

Select Measures and Categories
You can then simply select columns: Measures and categories are automatically detected. The available chart types are Stacked Column, Clustered Column, Bubble, Heat Map, and Region.
