Der Web Report Designer läuft vollkommen unabhängig im Browser und bedarf keinerlei lokaler Installation eines Windows-Programms, wie es beim Web Designer der Fall ist.

Voraussetzungen

• Assemblies: Zunächst einmal müssen im Projekt Referenzen auf die beiden Assemblies combit.ListLabel29.dll und combit.ListLabel29.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.
  • System.Drawing.Common by Microsoft.
  • 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 MyWebReportDesignerController verwendet. Leiten Sie den Controller von der Klasse WebReportDesignerController ab:

...
public class MyWebReportDesignerController : WebReportDesignerController
...

...
Public Class MyWebReportDesignerController
        Inherits WebReportDesignerController
...

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 bzw. das zu verwendende Repository.

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

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

    provideListLabelContext.NewInstance = ll;
}

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

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

    Dim ll As ListLabel = New ListLabel()
    ll.LicensingInfo = "<ToDo: insert your license here>"

    Dim dataSource = GetDataProvider(provideListLabelContext.RepositoryItemId)
    ll.DataSource = dataSource

    provideListLabelContext.NewInstance = ll

End Sub

Public Overrides Sub OnProvideRepository(ByVal provideFileRepositoryContext As ProvideRepositoryContext)

    provideFileRepositoryContext.FileRepository = DefaultSettings.GetRepository()

End Sub
...

Einbindung - .NET Weiche

Die weitere Vorgehensweise unterscheidet sich bei .NET 6/.NET 7/.NET 8 und .NET 4.8.

.NET 6/.NET 7/.NET 8:

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.UseWebReportDesigner();
}
...

Und in der ConfigureServices-Methode fügen Sie noch diese Zeile hinzu:

...
public void ConfigureServices(IServiceCollection services)
{
    // do some other stuff here
    // ...

    services.AddWebReportDesigner();
}
...

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

.NET 4.8:

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

...
WebReportDesignerConfig.RegisterRoutes(RouteTable.Routes);
...

...
WebReportDesignerConfig.RegisterRoutes(RouteTable.Routes)
...

Web Report Designer verwenden

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

...
@using combit.Reporting.Web
@{
    Layout = null;
}
<!DOCTYPE html>
@Html.WebReportDesigner() 
...

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

Ausblick

In der List & Label Installation finden sich entsprechende ASP.NET Beispiele, die die Verwendung des Web Report Designers im Detail zeigen.