Articles in this section

Dynamically Changing Stored Procedure Parameters in Bold BI Dashboards

Published:

Overview

Bold BI allows you to build interactive dashboards where end users can change the input values passed to a stored procedure without modifying the dashboard design. By linking a Dashboard Parameter to a stored procedure parameter, users can dynamically refresh dashboard results directly from the Viewer.

This approach is useful when users need to switch between different business scenarios, regions, departments, customers, or other filter values while viewing the same dashboard.

Prerequisites

  • Before configuring dynamic stored procedure parameters, ensure that:
    • A supported database connection is available.
    • The stored procedure executes successfully in the database.
    • The stored procedure contains input parameters.
    • Dashboard Parameters are enabled and configured.
    • The user has permission to access the data source.

Steps to Dynamically Change Parameters

Step 1: Create a Dashboard Parameter

  • Create a new Dashboard Parameter of List Type, name it and bind values to the parameter

    • Open the dashboard in the Designer.
    • Navigate to Dashboard Parameters.
      image.png
  • Choose List as the parameter type.

    image.png

    • Enter a name for the parameter.
    • Configure and bind the list values that users can select.
    • Save the parameter.

Step 2: Configure the Stored Procedure Data Source

  • Click Add Data Source.
  • Select the same database connection used for the Dashboard Parameter.
  • Choose Stored Procedure as the data access type.
  • Select the required stored procedure.
  • Under Parameter Mapping, locate the stored procedure parameter.
  • Set:
    • Value Type = Parameter
    • Value = Select the Dashboard Parameter created in Step 1
  • Click Connect to preview the results.
  • Save the data source.
  • image.png

3: Design and Publish the Dashboard

  • Use the fields from the stored procedure data source to design your dashboard widgets.
  • Configure any required filters and visualizations.
  • Save and publish the dashboard.

After publication, users can change the Dashboard Parameter value directly from the Dashboard Viewer and refresh the dashboard data dynamically.

Step 4: Change Parameter Value in Viewer Mode

  • In the Dashboard Viewer, click on the Dashboard Parameter Icon.
  • Open the published dashboard in Viewer mode.
  • Click the Dashboard Parameter icon.
  • Choose the desired parameter value from the Dashboard Parameter Dialog
  • Click Apply or OK. The dashboard will instantly refresh, and display data filtered by the new parameter value passed to the stored procedure.

image.png

Conclusion

By mapping Dashboard Parameters to stored procedure parameters, Bold BI enables dynamic, self-service data exploration without requiring dashboard redesigns. This approach improves usability and allows business users to switch between scenarios, departments, regions, or customers directly from the dashboard viewer.

Related Articles

Was this article useful?
Like
Dislike
Help us improve this page
Please provide feedback or comments
GO
Written by GeorgeOwuor Ogolla
Updated:
Comments (0)
Access denied
Access denied