VCL Dashboards: Getting Started

• Mar 30, 2026
• 3 minutes to read

Review the following tutorials to get started with the TdxDashboardControl component.

Prerequisites

Note

• ExpressReports will require the purchase of our VCL Subscription + OR an active VCL Subscription (regular) with any active .NET subscription that includes DevExpress Reports for ASP.NET/JavaScript (these subscriptions include: Reporting, ASP.NET & Blazor (includes DevExtreme), DXperience, or Universal).
• ExpressDashboards will also require the purchase of our VCL Subscription + OR an active VCL Subscription (regular) with an active Universal Subscription that includes DevExpress Business Intelligence (BI) Dashboard.

Ensure that your development environment meets ExpressDashboards and ExpressReports prerequisites:

1. Microsoft Windows 10 or newer.
2. Embarcadero RAD Studio IDE 12.3 or newer (Community Edition IDEs are not supported).
3. DevExpress VCL v25.2.x.
4. The EdgeView2 SDK package installed from the GetIt package manager.

Tutorials

Create a Dashboard Using the Designer Dialog

Follow this tutorial to create a simple dashboard application: set up a memory-based data source, load JSON data, create Bubble Map and Chart dashboard items, and bind them to data.

Sample GitHub Projects

This section lists all public GitHub repositories (DevExpress-Examples) that demonstrate the primary usage scenarios for VCL Dashboards:

Store Dashboard Layouts

View Example: Store Dashboard Layouts in a DatabaseThis example stores a dashboard layout in a BLOB field of a memory-based dataset (TdxMemData).

Filter Dashboard Data

View Example: Pass a Hidden Dashboard Parameter to a SQL QueryThis example demonstrates a dashboard that displays sales data for a selected country. The selected country is passed to the underlying SQL query as a hidden dashboard parameter. This sample project uses the TdxCustomDashboardControl.Parameters property to access and modify the target dashboard parameter.

Generate & Export Dashboard Content Without User Interaction

View Example: Generate Dashboards in a Backend/Service Application

This example bypasses the DevExpress Dashboard Viewer dialog and generates a dashboard using the DevExpress Dashboards backend. You can use the demonstrated technique to implement REST/Web API backends, Windows Services, workflows, and scheduled jobs for the following usage scenarios:

• Bulk export dashboards to PDF, DOCX, image, and other formats.
• Share, email, and print dashboard documents without user interaction.
• Implement custom dashboard management UIs.

Related Compiled Demo

To see the TdxDashboardControl component in action, run the BI Dashboards Designer/Viewer demo in the VCL Demo Center installed with compiled DevExpress VCL demos. Click different items in the sidebar on the left to switch between demo features.

Download: Compiled VCL Demos

Tip

You can find full source code for the installed compiled Report demo in the following folder:

_%PUBLIC%\Documents\DevExpress VCL Demos\MegaDemos\Product Demos\ExpressDashboards_

See Also

VCL Dashboards (BI Dashboard Designer & Viewer) for Delphi/C++Builder

Sample GitHub Projects for VCL Dashboards (BI Dashboard Designer & Viewer)

Supported Database Systems