Wizard Customization Overview

• Aug 18, 2023
• 4 minutes to read

The Report Wizard allows you to create new reports and customize existing ones in the End-User Report Designer. The Report Wizard includes Data Source Wizard pages for binding a report to data and adds extra pages for configuring the report layout.

Wizard Structural Elements

The Wizard architecture conforms to the MVP (Model-View-Presenter) design pattern and includes the following structural elements:

• Presenter

• View

• Model

You can create a custom wizard page using the following approaches:

• Provide your custom appearance for a specific wizard page by creating a XAML template with the required ViewModel type referenced by a Key. The specified Key is used to locate the corresponding template automatically.

• Customize an existing wizard page by inheriting from its Presenter and View objects.

• Create a custom wizard page from scratch by implementing a page Presenter, View, and Model (optional). Inherit the page Presenter from the abstract WizardPageBase<TView, TModel> class (the DevExpress.Data.WizardFramework namespace). To implement the View, inherit a ViewModel from the WizardPageBase class (the DevExpress.Xpf.DataAccess.DataSourceWizard namespace) and write a XAML template. To add custom fields to the Model, create the XtraReportModel class descendant.

Wizard Customization API

You can customize the Report and/or Data Source Wizard by implementing the IWizardCustomizationService interface, which provides the following four methods:

• IWizardCustomizationService.CustomizeDataSourceWizard - Provides the customization logic to the Data Source Wizard.
• IWizardCustomizationService.CustomizeReportWizard - Provides the customization logic to the Report Wizard.
• IWizardCustomizationService.TryCreateDataSource - Implements custom logic to create a data source based on settings accumulated in a data source model during the Wizard execution.
• IWizardCustomizationService.TryCreateReport - Implements custom logic to create a report based on settings accumulated in a report model during the Wizard execution.

Both the CustomizeDataSourceWizard and CustomizeReportWizard methods receive two arguments:

• The first argument (that has the DataSourceWizardCustomizationModel or ReportWizardCustomizationModel type, respectively) allows you to specify the first wizard page and the corresponding report and data source models.
• The second argument is a IntegrityContainer class descendant that allows you to register custom page Presenter and View objects. For instance, use the ViewModelSourceIntegrityContainer class which provides additional methods to register ViewModels.

To apply the wizard customization, assign your custom IWizardCustomizationService instance to the ReportDesignerBase.ServicesRegistry property.

Code Examples

The following code examples demonstrate how to customize the Report Wizard:

• Remove Data Providers from the Report Wizard
• Register a Custom Page in the Report Wizard