Der Web Report Viewer unterstützt alle gängigen Browsertypen. Dadurch ist er auf Clients mit unterschiedlichen Betriebssystemen einsetzbar. Er erlaubt eine interaktive Eingabe durch Drilldown und Berichtsparameter.

Voraussetzungen

• Assemblies: Zunächst einmal müssen im Projekt Referenzen auf die beiden Assemblies combit.ListLabel27.dll und combit.ListLabel27.Web.dll hinzugefügt werden. Dies kann bspw. auch durch das Hinzufügen der entsprechenden NuGet-Packages erreicht werden.
• Zusätzlich werden die folgenden externen NuGet-Packages benötigt:
  • Newtonsoft.Json mindestens in der Version 13.0.1.
  • System.CodeDom mindestens in der Version 5.0.0.
  • Microsoft.AspNetCore.Mvc.NewtonsoftJson in der passenden .NET Version.
    Zusätzlich suchen Sie die Zeile builder.Services.AddControllersWithViews(); und ersetzen Sie sie durch builder.Services.AddControllersWithViews().AddNewtonsoftJson();.

Einbindung - Neuen Controller erstellen

Legen Sie anschließend wie üblich einen neuen Controller an - im Folgenden wird als Beispiel der Name MyWebReportViewerController verwendet. Leiten Sie den Controller von der Klasse WebReportViewerController ab:

...
public class MyWebReportViewerController : WebReportViewerController
...

...
Public Class MyWebReportViewerController
        Inherits WebReportViewerController
...

Einbindung - Wichtige Methoden überschreiben

Implementieren Sie dann die beiden abstrakten Methoden OnProvideListLabel und OnProvideRepository. Übergeben Sie in den jeweils bereitgestellten Argumenten Ihre List & Label-Instanz mit passender Datenquelle sowie temporären Exportpfad bzw. das zu verwendende Repository.

...
public override void OnProvideListLabel(ProvideListLabelContext provideListLabelContext)
{
    // List & Label Objekt erstellen
    ListLabel ll = new ListLabel();
    ll.LicensingInfo = "<ToDo: insert your license here>"

    // Datenquelle definieren
    var dataSource = GetDataProvider(provideListLabelContext.RepositoryItemId);
    ll.DataSource = dataSource;

    // Der Web Report Viewer benötigt ein Verzeichnis für temporäre Dateien. Diese werden einige Minuten nach Schließen eines Web Report Viewers automatisch gelöscht
    provideListLabelContext.ExportPath = Server.MapPath("~/App_Data/TempFiles");

    // Konfiguriertes List & Label Objekt zurückliefern
    provideListLabelContext.NewInstance = ll;
}

public override void OnProvideRepository(ProvideRepositoryContext provideFileRepositoryContext)
{
    provideFileRepositoryContext.FileRepository = GetRepository();
} 
...

...
Public Overrides Sub OnProvideListLabel(ByVal provideListLabelContext As ProvideListLabelContext)

    ' List & Label Objekt erstellen
    Dim ll As ListLabel = New ListLabel()
    ll.LicensingInfo = "<ToDo: insert your license here>"

    ' Datenquelle definieren
    Dim dataSource = GetDataProvider(provideListLabelContext.RepositoryItemId)
    ll.DataSource = dataSource

    ' Der Web Report Viewer benötigt ein Verzeichnis für temporäre Dateien. Diese werden einige Minuten nach Schließen eines Web Report Viewers automatisch gelöscht
    provideListLabelContext.ExportPath = Server.MapPath("~/App_Data/TempFiles")

    ' Konfiguriertes List & Label Objekt zurückliefern
    provideListLabelContext.NewInstance = ll

End Sub

Public Overrides Sub OnProvideRepository(ByVal provideFileRepositoryContext As ProvideRepositoryContext)

    provideFileRepositoryContext.FileRepository = GetRepository()

End Sub
...

Einbindung - .NET Weiche

Die weitere Vorgehensweise unterscheidet sich bei .NET Core 3.1/.NET 5/.NET 6 und .NET 4.x.

.NET Core 3.1/.NET 5/.NET 6:

Wenn Sie die Datei startup.cs vorfinden (ansonsten siehe unten), fügen Sie die folgenden Zeilen am Ende der Configure-Methode hinzu:

...
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // do some other stuff here
    // ...

    app.UseWebReportViewer();
}
...

Wenn es die Datei startup.cs nicht gibt, sollten Sie die Datei program.cs in .NET 6 haben. In diesem Fall fügen Sie app.UseWebReportViewer(); direkt nach jedem anderen app.Use...-Aufruf und builder.Services.AddWebReportViewer(); direkt nach jedem anderen builder.Services...-Aufruf hinzu.

.NET 4.x:

Fügen Sie in der Datei global.asax.cs/global.asax.vb vor dem RouteConfig.RegisterRoutes()-Aufruf die folgende Zeile ein:

...
WebReportViewerConfig.RegisterRoutes(RouteTable.Routes);
...

...
WebReportViewerConfig.RegisterRoutes(RouteTable.Routes)
...

Web Report Viewer verwenden

Damit ist nun die Konfiguration abgeschlossen. Nun kann im gewünschten View der Web Report Viewer wie folgt eingefügt und verwendet werden:

...
@using combit.Reporting.Web
@{
    Layout = null;
    string repositoryId = Request.QueryString["reportRepositoryID"];
    if (!String.IsNullOrEmpty(repositoryId))
    {
        repositoryId = repositoryId.Replace("repository://{", "").Replace("}", "");
    }
}
<!DOCTYPE html>
@Html.WebReportViewer("Web Report Viewer", repositoryId)
...

Ausblick

In der List & Label Installation finden sich entsprechende ASP.NET Beispiele, die die Verwendung des Web Report Viewers sowohl unter .NET Core, .NET 5/.NET 6 wie auch unter .NET 4.x im Detail zeigen.