Use Visual Studio Templates to Create an Angular Application with a Report Designer

• Mar 20, 2023
• 3 minutes to read

This document describes how to use the DevExpress Template Gallery to generate a Single-Page Application (SPA) with the following projects:

• An ASP.NET Core project that works as an API backend
• An Angular project that works as a UI and contains the End-User Report Designer control.

Use the DevExpress Template Gallery

The DevExpress Template Gallery implements a step-by-step process that allows you to create an Angular application with a Report Designer that relies on the ASP.NET Core backend application.

The created application implements the CustomReportStorageWebExtension class that saves the reports you change in the Report Designer to a file in the Reports folder. This sample storage is intended for demonstration purposes only. Do not use it in production. Create a ReportStorageWebExtension class descendant instead and implement logic to save reports.

Follow the steps below to create an application in Visual Studio:

1. Select FILE | New | Project in the main menu or press CTRL+SHIFT+N to create a new project.

   

2. Select the DevExpress v23.1 Web App Template Gallery, and click Next:

   

3. Specify a project name and location, and click Create:

   

4. Select Reporting Angular Application from the .NET 6 category in the invoked DevExpress Template Gallery.

   

   Select a framework version and click Create Project.

5. Set Add Designer Page to true to add the Report Designer to the web application.

   

   Use the following Report Designer settings:

   Report Storage Name

   Specifies the class name of a server-side report storage. This storage allows you to open report layout data from various sources. A storage service implemented in the template is based on the reportsData.db SQLite database in the Data folder. If you modify a report in the Web Report Designer, it is saved to the database in XML format. If you disable the Add Report Storage property, no report storage is created, but you can add a report storage at a later stage.

   Note

   The template generates a sample storage (a ReportStorageWebExtension descendant) for demonstration purposes only. Create your own implementation for use in production.

   Data Binding Mode

   Specifies the data fetch mode for report controls. You can switch between legacy binding mode and expression bindings.

   Add Sample Database

   Specifies whether to create a sample connection string and register it in the Report Designer to create SQL Data Sources in the Report Wizard and Data Source Wizard. The connection string is also used to register a predefined data source.

   Add Sample JSON Data Connection Storage

   Specifies whether to create a storage and register it to create JSON Data Sources in the Report Wizard and Data Source Wizard.

   Add Sample Data Object

   Specifies whether to add a sample data object to an application and register this data object to create Object Data Sources in the Report Wizard and Data Source Wizard.

   Enable Rich Text Editor

   Specifies whether to add an in-line Rich Text Editor for the RichText control.

   Click Create Project to apply these settings to the project.

6. Run the project. Visual Studio loads all packages and dependencies, and the project starts and displays the home page in the web browser. Click the Report Designer link on the navigation bar to display the Report Designer, as shown in the image below:

   

   You can configure the Report Designer to load a report when the application starts. Navigate to the ClientApp | app | components | report-designer | report-designer.ts file and specify the reportUrl setting.