combit List & Label 27 - .NET Hilfe
Einführung in die Programmierung / Beispiele / Web Reporting / Verwendung des Web Report Designers
In diesem Thema
    Verwendung des Web Report Designers
    In diesem Thema

    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.

    Um alle Designer-Funktionen und -Objekte vollständig verwenden zu können, kann weiterhin der Web Designer verwendet werden, der jedoch eine lokale Windows Installation voraussetzt und somit auch nicht mehr browserunabhängig ist.

     

    Voraussetzungen

    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.Repository = 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.Repository = GetRepository()
    
    End Sub
    ...
    

     

    Zusätzlich muss unbedingt der List & Label Lizenzschlüssel (siehe auch LicensingInfo) angegeben werden.

     

    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:

    Fügen Sie in der Datei startup.cs 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();
    }
    ...
    

     

    .NET 4.x:

    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 sowohl unter .NET Core, .NET 5/.NET 6 wie auch unter .NET 4.x im Detail zeigen.