Reports Module (Obsolete)
- 3 minutes to read
The Reports Module is required to provide compatibility with legacy XAF applications. If you create a new application, we recommend that you use the Reports V2 Module instead. With this new module, you can create reports within Visual Studio using Reporting, and effortlessly integrate reports into your XAF applications. Features provided by the Reports V2 module are not compatible with the old Reports module design. A new module is introduced to provide new features and to keep compatibility with existing XAF applications at the same time. You can use Reports and Reports V2 modules in one application simultaneously - to access existing reports created with the old module and to use the new module's features in newly created reports. To learn how to update your legacy applications, refer to the Ways to migrate reports to the ReportsV2 module knowledge base article.
To make business applications especially useful for managers and other end-users who analyze information, the eXpressApp Framework provides the Reports module. This module allows designing and printing reports easily. Reports are represented by persistent objects which are stored together with other persistent objects by default. For this purpose, the Reports module provides the ReportData business class. Actually, you need not create this class instances manually. The Reports module uses a fully-functional reporting engine - the XtraReports Suite. This engine provides the Designer which allows creating, previewing and customizing reports. So, with the Reports module added to your application, you have a powerful instrument to create various reports.
The Reports system is presented by two modules:
Adds references to the DevExpress.ExpressApp.Reports.v18.2.dll and DevExpress.ExpressApp.Reports.Win.v18.2.dll assemblies.
You can add this module to your Windows Forms module. For this purpose, invoke the Module Designer and drag ReportsWindowsFormsModule from the Toolbox to the RequiredModules panel. Alternatively, you can add this module to the Windows Forms application project. To do this, invoke the Application Designer and drag ReportsWindowsFormsModule from the Toolbox to the Modules panel. Do not forget to rebuild your solution after making changes in a Designer.
Adds references to the DevExpress.ExpressApp.Reports.v18.2.dll and DevExpress.ExpressApp.Reports.Web.v18.2.dll assemblies.
You can add this module to your ASP.NET module. For this purpose, invoke the Module Designer and drag ReportsASPNETModule from the Toolbox to the RequiredModules panel. Alternatively, you can add this module to the ASP.NET application project. To do this, invoke the Application Designer and drag ReportsASPNETModule from the Toolbox to the Modules panel. Do not forget to rebuild your solution after making changes in a Designer.
The one limitation is that you can only design reports in XAF Windows Forms applications (this limitation is resolved in Reports V2 Module). However, XAF ASP.NET applications provide access to the ReportData objects and allow end-users to preview and download reports.
To learn more about the integrated reporting system, refer to the following documents:
- Reports Module in Windows Forms Applications
- Reports Module in ASP.NET Applications
- Format-Specific Preview Actions in ASP.NET Applications
- Use Function Criteria Operators to Filter Report Data Source
- Access Report Parameters in Scripts
- Show Reports for Individual Views
- Distribute the Created Reports with the Application