Embedding Telerik Reporting in ASP.NET Core Reporting Applications
ASP.NET Core is an advanced Web technology that lets you build modern cross-platform client-side, server-side and combined applications. This article offers a brief overview of the most popular approaches to integrate and use Telerik Reporting in ASP.NET Core Web Reporting applications.
Supported Operating Systems and Docker Containers
The article Available .NET Support for Operating Systems and Docker Containers elaborates on the specifics when deploying Telerik Reporting on different environments.
Displaying Reports in ASP.NET Core Web Reporting Applications
The HTML5 Report Viewer is an HTML/CSS/JS client-side widget suitable for any web application that works with JavaScript. This makes it the perfect widget for displaying Telerik Reporting Reports in all Web Reporting Applications.
Requirements
.NET 6 introduced a globalization-invariant mode which, if enabled, does not allow the creation of any culture except the invariant culture. The Report Engine relies on instantiating cultures to support localization, formatting, and unit conversion, so enabling invariant globalization will break the engine's functionality. Refer to the Only invariant culture is supported in globalization-invariant mode article for instructions on how to disable the Invariant Globalization
mode.
Implementation
The article Using the HTML5 Report Viewer in an ASP.NET Core application in .NET is a step-by-step tutorial on embedding the HTML5 Report Viewer in ASP.NET Core Web Reporting projects.
Generating Reports in ASP.NET Core Web Reporting Applications
The Telerik Reporting REST Services provide an Application Programming Interface (API) over HTTP to the Reporting Engine that processes and renders Telerik Reports. The fully functional implementation of the service is available in the assembly/package Telerik.Reporting.Services.AspNetCore
. It may be embedded in any ASP.NET Core Reporting Application and exposed in a custom controller (for example, ReportsController
) inheriting the basic ReportsControllerBase
class. The ReportsController
may be used as a source of Report documents by Web Reporting, Desktop Reporting, and other third-party client applications.
Implementation
There are different methods for configuring the Telerik Reporting REST Service in an ASP.NET Core Reporting project:
- Hosting the Telerik Reporting REST Service in ASP.NET Core in .NET 6+ with Minimal API
- Hosting the Telerik Reporting REST Service in ASP.NET Core in .NET 6 and .NET 8 with Top-Level Statements
- Hosting the Telerik Reporting REST Service in an ASP.NET Core Application in .NET 6, .NET 8 and .NET 9 with Startup.cs
Designing Reports in ASP.NET Core Web Reporting Applications
The Web Report Designer is an HTML/CSS/JS client-side widget that lets developers embed a report designer into their web reporting applications. It is ready for embedding in the ASP.NET Core Reporting Applications to allow the users to create, edit, and preview their Telerik Web Reports directly from the browser.
Web Report Designer Requirements
The Web Report Designer requires a Report Designer REST service, whose fully functional implementation resides in the assembly/package Telerik.WebReportDesigner.Services
as explained in the section Web Report Designer Implementation.
Web Report Designer Implementation
The tutorial Setting up the Web Report Designer in .NET applications elaborates on implementing the web designer widget and its REST Service in ASP.NET Core Web Reporting projects.