Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create blazor-reporting.md #1546

Open
wants to merge 68 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 25 commits
Commits
Show all changes
68 commits
Select commit Hold shift + click to select a range
a745203
Create blazor-reporting.md
todorarabadzhiev Nov 27, 2024
8e2d3ea
Update blazor-reporting.md
todorarabadzhiev Nov 27, 2024
4d63db4
Update blazor-reporting.md
todorarabadzhiev Nov 27, 2024
dcc759a
Update asp-net-core-reporting.md
todorarabadzhiev Nov 27, 2024
dd52b51
Update blazor-reporting.md
todorarabadzhiev Nov 29, 2024
366eb7b
Update blazor-reporting.md
todorarabadzhiev Nov 29, 2024
584b9a1
Update blazor-reporting.md
todorarabadzhiev Nov 29, 2024
3807957
Update asp-net-core-reporting.md
todorarabadzhiev Nov 29, 2024
714602f
Create spa-reporting.md
todorarabadzhiev Nov 29, 2024
d1ca4ca
Update spa-reporting.md
todorarabadzhiev Nov 29, 2024
b7f72d9
Create asp-net-reporting.md
todorarabadzhiev Dec 2, 2024
059b3d8
Create desktop-reporting.md
todorarabadzhiev Dec 2, 2024
533d996
Update _config.yml
todorarabadzhiev Dec 2, 2024
f8184e4
Create asp-net-core-reporting.md
todorarabadzhiev Dec 2, 2024
51c18a3
Delete embedding-reports/asp-net-core-reporting.md
todorarabadzhiev Dec 2, 2024
68739e5
Delete embedding-reports/asp-net-reporting.md
todorarabadzhiev Dec 2, 2024
c5e65cb
Delete embedding-reports/blazor-reporting.md
todorarabadzhiev Dec 2, 2024
b49017c
Delete embedding-reports/desktop-reporting.md
todorarabadzhiev Dec 2, 2024
70e055f
Delete embedding-reports/spa-reporting.md
todorarabadzhiev Dec 2, 2024
9568f58
Add files via upload
todorarabadzhiev Dec 2, 2024
b31f043
Rename asp-net-core-reporting.md to embedding-reports/asp-net-core-re…
todorarabadzhiev Dec 3, 2024
2317255
Rename asp-net-reporting.md to embedding-reports/asp-net-reporting.md
todorarabadzhiev Dec 3, 2024
d15a992
Rename blazor-reporting.md to embedding-reports/blazor-reporting.md
todorarabadzhiev Dec 3, 2024
621276d
Rename desktop-reporting.md to embedding-reports/desktop-reporting.md
todorarabadzhiev Dec 3, 2024
cc48f7e
Rename spa-reporting.md to embedding-reports/spa-reporting.md
todorarabadzhiev Dec 3, 2024
bae5d4f
Update asp-net-core-reporting.md
todorarabadzhiev Dec 13, 2024
700bf13
Update blazor-reporting.md
todorarabadzhiev Dec 13, 2024
2913635
Update spa-reporting.md
todorarabadzhiev Dec 13, 2024
cd27e40
Update asp-net-reporting.md
todorarabadzhiev Dec 13, 2024
6798554
Update desktop-reporting.md
todorarabadzhiev Dec 13, 2024
e91e3c3
Update introduction.md
todorarabadzhiev Dec 18, 2024
c0660fb
Update about-telerik-reporting.md
todorarabadzhiev Dec 18, 2024
696eddd
Update embedding-reports/blazor-reporting.md
todorarabadzhiev Dec 19, 2024
c86eb5b
Update asp-net-core-reporting.md
todorarabadzhiev Dec 19, 2024
df9efaf
Update asp-net-reporting.md
todorarabadzhiev Dec 19, 2024
87f58c3
Update desktop-reporting.md
todorarabadzhiev Dec 19, 2024
b25409a
Update spa-reporting.md
todorarabadzhiev Dec 19, 2024
e047c38
Update blazor-reporting.md
todorarabadzhiev Dec 19, 2024
091ad41
Update embedding-reports/blazor-reporting.md
todorarabadzhiev Dec 19, 2024
06ba8e9
Update embedding-reports/blazor-reporting.md
todorarabadzhiev Dec 19, 2024
c6cca72
Update embedding-reports/blazor-reporting.md
todorarabadzhiev Dec 19, 2024
9c08192
Update asp-net-reporting.md
todorarabadzhiev Dec 19, 2024
c875c8c
Update spa-reporting.md
todorarabadzhiev Dec 19, 2024
4a059b6
Update embedding-reports/blazor-reporting.md
todorarabadzhiev Dec 19, 2024
ea42afb
Update asp-net-core-reporting.md
todorarabadzhiev Dec 19, 2024
7996a97
Update asp-net-reporting.md
todorarabadzhiev Dec 19, 2024
e0d853b
Update desktop-reporting.md
todorarabadzhiev Dec 19, 2024
40ed237
Update spa-reporting.md
todorarabadzhiev Dec 19, 2024
9e5e784
Update blazor-reporting.md
todorarabadzhiev Dec 19, 2024
e4c45fd
Update embedding-reports/blazor-reporting.md
todorarabadzhiev Dec 19, 2024
c00ac8a
Update blazor-reporting.md
todorarabadzhiev Dec 19, 2024
677ab51
Update asp-net-core-reporting.md
todorarabadzhiev Dec 19, 2024
7708869
Update asp-net-reporting.md
todorarabadzhiev Dec 19, 2024
3c0a30d
Update spa-reporting.md
todorarabadzhiev Dec 19, 2024
4114d06
Update embedding-reports/asp-net-core-reporting.md
todorarabadzhiev Dec 19, 2024
385899a
Update embedding-reports/asp-net-core-reporting.md
todorarabadzhiev Dec 19, 2024
9ebfb8c
Update embedding-reports/asp-net-reporting.md
todorarabadzhiev Dec 19, 2024
9649c0f
Update desktop-reporting.md
todorarabadzhiev Dec 19, 2024
c3895f3
Update embedding-reports/blazor-reporting.md
todorarabadzhiev Dec 19, 2024
9948379
Update asp-net-core-reporting.md
todorarabadzhiev Dec 19, 2024
89f71d1
Update asp-net-reporting.md
todorarabadzhiev Dec 19, 2024
9616c53
Update blazor-reporting.md
todorarabadzhiev Dec 19, 2024
6b49d6d
Update spa-reporting.md
todorarabadzhiev Dec 19, 2024
9791b49
Update blazor-reporting.md
todorarabadzhiev Dec 23, 2024
288824e
Update blazor-reporting.md
todorarabadzhiev Dec 23, 2024
57459ac
Update spa-reporting.md
todorarabadzhiev Dec 23, 2024
6848740
Update asp-net-core-reporting.md
todorarabadzhiev Dec 23, 2024
4c7d710
Update asp-net-reporting.md
todorarabadzhiev Dec 23, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 13 additions & 13 deletions _config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,10 @@ exclude_navigation: ["knowledge-base/*","embedding-reports/host-the-report-engin
navigation:
## List your directory names and order here, like this:
getting-started:
position: 1
position: 10
title: "Getting Started"
security:
position: 2
position: 20
title: "Security"
getting-started/web-designer:
position: 5
Expand All @@ -25,10 +25,10 @@ navigation:
position: 6
title: "Download & Installation"
upgrade:
position: 11
position: 110
title: "Upgrade"
styling:
position: 7
position: 70
title: "Styles & Appearance"
styling/rendering-and-paging:
position: 8
Expand All @@ -40,7 +40,7 @@ navigation:
position: 1
title: "Styling"
report-items:
position: 3
position: 30
title: "Report Items"
report-items/barcode:
position: 1
Expand Down Expand Up @@ -85,7 +85,7 @@ navigation:
position: 6
title: "HtmlTextBox"
doc-output:
position: 10
position: 100
title: "Document Output"
doc-output/configure-the-report-engine:
position: 10
Expand All @@ -94,7 +94,7 @@ navigation:
position: 11
title: "Configuring the Output Formats"
interactivity:
position: 8
position: 80
title: "Interactivity"
interactivity/bookmarks:
position: 10
Expand All @@ -115,13 +115,13 @@ navigation:
position: 13
title: "Table of Contents"
globalization:
position: 9
position: 90
title: "Globalization"
importing-reports:
position: 6
position: 60
title: "Importing Reports"
embedding-reports:
position: 5
position: 50
title: "Embedding Reports"
embedding-reports/cache-management:
position: 70
Expand Down Expand Up @@ -280,7 +280,7 @@ navigation:
position: 15
title: "JSON Entities"
designing-reports:
position: 4
position: 40
title: "Creating Reports"
designing-reports/report-designer-tools:
position: 4
Expand Down Expand Up @@ -394,10 +394,10 @@ navigation:
position: 6
title: "Report Book"
knowledge-base:
position: 20
position: 200
title: "Knowledge Base"
api:
position: 30
position: 300
title: "API Reference"
## The application virtual path
baseurl: /reporting
Expand Down
2 changes: 2 additions & 0 deletions embedding-reports/asp-net-core-reporting.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,3 +58,5 @@ The tutorial [Setting up the Web Report Designer in .NET applications]({%slug te
* [Telerik Report Viewer and Telerik Reporting REST Service]({%slug telerikreporting/using-reports-in-applications/export-and-configure/cache-management/html5-report-viewer-and-reporting-rest-services%})
* [REST API Reference]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/rest-api-reference/overview%})
* [Report Sources]({%slug telerikreporting/designing-reports/report-sources/overview%})
* [Embedding Telerik Reporting in Blazor Reporting Applications]({%slug blazor-reporting%})
todorarabadzhiev marked this conversation as resolved.
Show resolved Hide resolved
* [Embedding Telerik Reporting in Single Page Web Reporting Applications]({%slug spa-reporting%})
todorarabadzhiev marked this conversation as resolved.
Show resolved Hide resolved
61 changes: 61 additions & 0 deletions embedding-reports/asp-net-reporting.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
---
title: ASP.NET Reporting
page_title: ASP.NET Reporting – Telerik Reporting
description: "ASP.NET Reporting is a framework for generating and delivering dynamic reports in web apps using ASP.NET technology."
slug: asp-net-reporting
tags: telerik, reporting, reports, web, asp, net
published: True
position: 9
---

# Embedding Telerik Reporting in ASP.NET Reporting Applications
todorarabadzhiev marked this conversation as resolved.
Show resolved Hide resolved

ASP.NET is a mature Microsoft Web technology for building 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 Web Reporting applications.

## Displaying Reports in ASP.NET Web Reporting Applications

The [HTML5 Report Viewer]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/web-application/html5-report-viewer/overview%}) 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.

We provide also dedicated wrappers of the pure HTML5 Report Viewer for the most popular ASP.NET MVC and Web Forms frameworks:

* [HTML5 ASP.NET MVC Report Viewer]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/web-application/html5-asp.net-mvc-report-viewer/overview%})
* [HTML5 ASP.NET Web Forms Report Viewer]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/web-application/html5-asp.net-web-forms-report-viewer/overview%})

### Implementation

The article [Using the HTML5 Report Viewer with REST Service]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/web-application/html5-report-viewer/how-to-use-html5-report-viewer-with-rest-service%}) is a step-by-step tutorial on embedding the HTML5 Report Viewer in ASP.NET Web Reporting projects.

The steps for integrating the viewers in ASP.NET MVC and Web Forms projects are as follows:

* [Using HTML5 ASP.NET __MVC__ Report Viewer With Reporting REST Service]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/web-application/html5-asp.net-mvc-report-viewer/how-to-use-html5-asp.net-mvc-report-viewer-with-rest-service%})
* [Using the HTML5 ASP.NET __Web Forms__ Report Viewer with REST Service]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/web-application/html5-asp.net-web-forms-report-viewer/how-to-use-html5-asp.net-web-forms-report-viewer-with-rest-service%})

## Generating Reports in ASP.NET Web Reporting Applications

The [Telerik Reporting REST Services]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/overview%}) provide an Application Programming Interface (API) over HTTP to the Reporting Engine that processes and renders [Telerik Reports]({%slug on-telerik-reporting%}#report-definition). The fully functional implementation of the service is available in the assembly/package [Telerik.Reporting.Services.WebApi](/api/telerik.reporting.services.webapi). It may be embedded in any ASP.NET 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

The article [Telerik Reporting REST Service ASP.NET Web API Implementation]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/asp.net-web-api-implementation/overview%}) elaborates on the requirements, implementation, and hosting of the REST Service.

## Designing Reports in ASP.NET Web Reporting Applications

The [Web Report Designer]({%slug telerikreporting/designing-reports/report-designer-tools/web-report-designer/overview%}) 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 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](/api/telerik.webreportdesigner.services) as explained in the section [Web Report Designer Implementation](#web-report-designer-implementation).

### Web Report Designer Implementation

The tutorial [Configuring the Web Report Designer in ASP.NET Framework application]({%slug telerikreporting/designing-reports/report-designer-tools/web-report-designer/how-to-set-up-in-.net-framework-application%}) elaborates on implementing the web designer widget and its REST Service in ASP.NET Web Reporting projects.

## See Also

* [Displaying Reports]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/overview%})
* [Telerik Report Viewer and Telerik Reporting REST Service]({%slug telerikreporting/using-reports-in-applications/export-and-configure/cache-management/html5-report-viewer-and-reporting-rest-services%})
* [REST API Reference]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/rest-api-reference/overview%})
* [Report Sources]({%slug telerikreporting/designing-reports/report-sources/overview%})
* [Embedding Telerik Reporting in ASP.NET Core Web Reporting Applications]({%slug asp-net-core-reporting%})
* [Embedding Telerik Reporting in Blazor Reporting Applications]({%slug blazor-reporting%})
* [Embedding Telerik Reporting in Single Page Web Reporting Applications]({%slug spa-reporting%})
68 changes: 68 additions & 0 deletions embedding-reports/blazor-reporting.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
---
title: Blazor Reporting
page_title: Blazor Reporting – Telerik Reporting
description: "Blazor Reporting is a framework for generating and delivering dynamic reports in web apps using Blazor technology."
slug: blazor-reporting
tags: telerik, reporting, reports, web, blazor
published: True
position: 7
todorarabadzhiev marked this conversation as resolved.
Show resolved Hide resolved
---

# Embedding Telerik Reporting in Blazor Reporting Applications
todorarabadzhiev marked this conversation as resolved.
Show resolved Hide resolved

[Blazor](https://dotnet.microsoft.com/en-us/apps/aspnet/web-apps/blazor) is the latest Microsoft Web technology letting you build modern cross-platform client-side, server-side, and hybrid applications relying mainly on C# code for the web site functionality. This article offers an overview of the most popular approaches to integrate Telerik Reporting in Blazor Web Reporting applications.
todorarabadzhiev marked this conversation as resolved.
Show resolved Hide resolved

todorarabadzhiev marked this conversation as resolved.
Show resolved Hide resolved
## Supported Operating Systems and Docker Containers
todorarabadzhiev marked this conversation as resolved.
Show resolved Hide resolved

The article [Available .NET Support for Operating Systems and Docker Containers]({%slug telerikreporting/using-reports-in-applications/dot-net-core-support%}) elaborates on the specifics when deploying Telerik Reporting on different environments.

## Displaying Reports in Blazor Web Reporting Applications
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

My assumption is that displaying the report is one of the later steps. Don't you need to first design the report or integrate it into the app?
Consider moving this section further down and placing here the section that corresponds to the most logical first step in the process.


We provide two Web Report Viewers suitable for Blazor Web Reporting applications:
todorarabadzhiev marked this conversation as resolved.
Show resolved Hide resolved

* The [Blazor Report Viewer]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/web-application/blazor-report-viewer/overview%}) is a wrapper of the [pure HTML5 Report Viewer]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/web-application/html5-report-viewer/overview%}), which is an HTML/CSS/JS client-side widget suitable for any web application that works with JavaScript. The Blazor Report Viewer does not use [Telerik UI for Blazor](https://www.telerik.com/blazor-ui) components and doesn't require a subscription for this suite.

* The [Native Blazor Report Viewer]({%slug telerikreporting/embedding-reports/display-reports-in-applications/web-application/native-blazor-report-viewer/overview%}) is a native Blazor widget built on top of Telerik UI for Blazor](https://www.telerik.com/blazor-ui) components and as such requires subscription for this suite.
todorarabadzhiev marked this conversation as resolved.
Show resolved Hide resolved

### Requirements

.NET 6 introduced a [globalization-invariant mode](https://learn.microsoft.com/en-us/dotnet/core/runtime-config/globalization) 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]({%slug only-invariant-culture-is-supported-in-globalization-invariant-mode-error%}) article for instructions on how to disable the `Invariant Globalization` mode.

### Implementation

* Follow the instructions in the article [Integrating the Blazor Report Viewer]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/web-application/blazor-report-viewer/how-to-use-blazor-report-viewer%}) to embed the Blazor HTML5 Report Viewer in your Web Reporting client application.
todorarabadzhiev marked this conversation as resolved.
Show resolved Hide resolved

* The article [Using Native Blazor Report Viewer]({%slug telerikreporting/embedding-reports/display-reports-in-applications/web-application/native-blazor-report-viewer/how-to-use-native-blazor-report-viewer%}) is a step-by-step tutorial on embedding the Native Blazor Report Viewer in Web Reporting projects.

## Generating Reports in Blazor Web Reporting Applications

The [Telerik Reporting REST Services]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/overview%}) provide an Application Programming Interface (API) over HTTP to the Reporting Engine that processes and renders [Telerik Reports]({%slug on-telerik-reporting%}#report-definition). The fully functional implementation of the service is available in the assembly/package `Telerik.Reporting.Services.AspNetCore`. It may be embedded in any Blazor Server 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.
todorarabadzhiev marked this conversation as resolved.
Show resolved Hide resolved

### Implementation

There are different methods for configuring the Telerik Reporting REST Service in a Blazor Server Reporting project:

* [Hosting the Telerik Reporting REST Service in ASP.NET Core in .NET 6+ with __Minimal API__]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/asp.net-core-web-api-implementation/how-to-host-reports-service-in-asp.net-core-in-.net-6-with-minimal-api%})
todorarabadzhiev marked this conversation as resolved.
Show resolved Hide resolved
* [Hosting the Telerik Reporting REST Service in ASP.NET Core in .NET 6 and .NET 8 with __Top-Level Statements__]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/asp.net-core-web-api-implementation/host-reports-service-in-.net-with-controllers%})
* [Hosting the Telerik Reporting REST Service in an ASP.NET Core Application in .NET 6, .NET 8 and .NET 9 with __Startup.cs__]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/asp.net-core-web-api-implementation/how-to-host-reports-service-in-asp.net-core-in-.net-5%})

## Designing Reports in Blazor Web Reporting Applications

The [Web Report Designer]({%slug telerikreporting/designing-reports/report-designer-tools/web-report-designer/overview%}) 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 Blazor 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).
todorarabadzhiev marked this conversation as resolved.
Show resolved Hide resolved

### Web Report Designer Implementation

The tutorial [How to set up in Blazor application]({%slug telerikreporting/designing-reports/report-designer-tools/web-report-designer/how-to-set-up-in-blazor-application%}) elaborates on implementing the web designer widget and its REST Service in Blazor Web Reporting projects.
todorarabadzhiev marked this conversation as resolved.
Show resolved Hide resolved

## See Also

* [Displaying Reports]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/overview%})
* [Telerik Report Viewer and Telerik Reporting REST Service]({%slug telerikreporting/using-reports-in-applications/export-and-configure/cache-management/html5-report-viewer-and-reporting-rest-services%})
* [REST API Reference]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/rest-api-reference/overview%})
* [Report Sources]({%slug telerikreporting/designing-reports/report-sources/overview%})
* [Embedding Telerik Reporting in ASP.NET Core Web Reporting Applications]({%slug asp-net-core-reporting%})
* [Embedding Telerik Reporting in Single Page Web Reporting Applications]({%slug spa-reporting%})
Loading