Search results

Connecting Bold BI to RavenDB data source

The Bold BI dashboard designer supports connecting to RavenDB database using the RavenDB client.

Choose RavenDB data source

To configure the RavenDB data source, follow these steps:

  1. Click on the Data Sources button in the configuration panel to add a new data connection. Data source icon

  2. Click CREATE NEW to launch a new connection from the connection panel.

  3. Select the RavenDB connection in the connection panel.

    Choose data source

NOTE: You can also create a data source from the home page by clicking the Data Sources menu on the left menu panel and Create Data Source from the data sources page.

Choose data source from server

Create RavenDB data source

Once you click on the data source, the NEW DATA SOURCE configuration panel will open. Follow these steps to create a RavenDB data source.

  1. Enter a name and description (optional) for the data source.
  2. Enter a valid URL in the Server URL text box.
  3. Select the database in the listed database associated with the given RavenDB Server in Database combo box.
  4. Enter the valid query in RQL Query text box. To know more about RQL Query follow the link
  5. In Max Rows, enter the maximum number of rows to be fetched from the RavenDB data source. This value is used to fetch the data from the RavenDB data source using the pagination.
  6. Choose a time interval for the Refresh Settings using the combo box to periodically trigger a request to the RavenDB server and keep the data in sync with our dashboard.
  7. Select Enable SSL if the given RavenDB server is configured with SSL Encryption.
  8. Upload the PFX certificate file through the Client Certificate section. Please refer to the RavenDB documentation for instructions on how to create a certificate from RavenDB studio. To generate and upload the certificate, please follow this link
  9. Enter your certificate passpharse in Password text box.

Choose data source from server

Choose data source from server You can also edit the connection information set using the Edit Connection option.

Additional information

Refresh Settings The period of time before the next refresh call is triggered. This will automatically trigger a call for the API configured in the data source to keep the data up to date. If you do not want to sync your new data, choose 'Never'.
Pagination Upon initial connection, RavenDB will extract a maximum of 1000 records. By configuring the Refresh option, it will extract all tables and data for the selected database on each refresh call.

Preview and data import

  • Click Preview & Connect to connect with the configurations that have been set.

  • The Choose Schema(s) dialog opens. The schema represents the collection list that is retrieved from the RavenDB server. This dialog displays a list of schemas in the treeview and its corresponding values in the grid for preview. Select required schema(s) from the treeview to use in designer and click Connect.


  • Now, the data design view page with the selected table schema opens. Drag the table from the tree view on the left pane and drop it onto the Query designer page.

    Query Editor

  • Click Save to save the data source with a relevant name.

Connect using custom attribute and dashboard parameter

We have added support for custom attributes and dashboard parameters in the data source connection. You can now connect to the data source using custom attributes or dashboard parameters.

Custom Attribute


Dashboard Parameter

Dashboard Parameter

Note: Refer to the Dashboard Parameter Documentation and Custom Attributes Documentation for more details.

Data Transformation

Editing a Data Connection

Dashboard Designer Walkthrough

RavenDB Integration