Use of the Web Report Viewer

In This Topic

The Web Report Viewer supports all common browser types. Thus, it can be used on clients with different operating systems. It allows interactive input through drilldown and report parameters.

Requirements

Assemblies: First of all, references to the two assemblies combit.ListLabel27.dll and combit.ListLabel27.Web.dll must be added in the project. This can also be achieved by adding the corresponding NuGet-Packages, for example.
The following external NuGet packages are also required:
- Newtonsoft.Json at least in version 13.0.1.
- System.CodeDom at least in version 5.0.0.

Integration - Create new Controller

Then create a new controller as usual - in the following the name MyWebReportViewerController is used as an example. Derive the controller from the WebReportViewerController class:

Integration - Override important Methods

Then implement the two abstract methods OnProvideListLabel and OnProvideRepository. Pass your List & Label instance with matching data source and temporary export path repectively the Repository to be used in the respective arguments provided.

C#
VB.NET

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

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

    // The Web Report Viewer requires a directory for temporary files. Some minutes after a Web Report Viewer is closed, these files will be deleted automatically
    provideListLabelContext.ExportPath = Server.MapPath("~/App_Data/TempFiles");

    // Return configured List & Label object
    provideListLabelContext.NewInstance = ll;
}

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

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

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

    ' Define datasource
    Dim dataSource = GetDataProvider(provideListLabelContext.RepositoryItemId)
    ll.DataSource = dataSource

    ' The Web Report Viewer requires a directory for temporary files. Some minutes after a Web Report Viewer is closed, these files will be deleted automatically
    provideListLabelContext.ExportPath = Server.MapPath("~/App_Data/TempFiles")

    ' Return configured List & Label object
    provideListLabelContext.NewInstance = ll

End Sub

Public Overrides Sub OnProvideRepository(ByVal provideFileRepositoryContext As ProvideRepositoryContext)

    provideFileRepositoryContext.Repository = GetRepository()

End Sub
...

In addition, the List & Label license key (see also LicensingInfo) must be specified.

Integration - .NET Switch

The further procedure differs for .NET Core 3.1/.NET 5/.NET 6 and .NET 4.x.

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

In the startup.cs file, add the following lines to the end of the Configure method:

.NET 4.x:

In the global.asax.cs/global.asax.vb file, add the following line before the RouteConfig.RegisterRoutes() call:

Using Web Report Viewer

The configuration is now complete. Now the Web Report Viewer can be inserted and used in the desired view as follows:

Further

The List & Label installation contains corresponding ASP.NET examples that show the use of the Web Report Viewer in detail both under .NET Core and under .NET 4.x.

Send Feedback