Report Viewer SDK
Schedule Free Demo
Try it Free
Search results
Suggest a FeaturePDF

JavaScript Report Viewer viewing best practices

This section explains the best practices and optimized ways to render RDL/RDLC reports in JavaScript Report Viewer.

View large records in seconds

The PerformanceSetting class provides properties that allows JavaScript Report Viewer to render the millions of records in seconds. Here are the properties associated with it:

  • PageCreation
  • VirtualEvaluation
  • AutoGrowText
  • FetchLimit

Note : For optimal rendering, please set the PageCreation property to OnDemand, VirtualEvaluation to true, AutoGrowText to false, and FetchLimit to 1000. Alternatively, you can achieve this optimal rendering setting by just adding report custom property SmartRendering as true as shown below, Shows the configuration of handle page creation and processing in custom property dialog

Handle page creation and processing

This PageCreation enum helps to define how each page is processed and created in the Report Viewer engine.

Property Description
Default Starts page creation, after all, pages created then sends first page to client side for rendering.
OnDemand Creates first page then sends to the client side within seconds. Each page creation starts when user navigating to the next page.
Background Creates first page then sends to the client side within seconds. Remaining pages created at the background, completion status is updated in progress bar.

Here, the example shows how to configure PageCreation in the ReportViewerController.

public void OnInitReportOptions(ReportViewerOptions reportOption)
{
    reportOption.ReportModel.PerformanceSetting = new BoldReports.RDL.Data.PerformanceSetting
    {
        PageCreation = BoldReports.RDL.Data.PageCreation.OnDemand
    };
}

Also you can set this property for a specific report by using the PageCreation custom property. You can set PageCreation as a custom property as shown below, Shows the configuration of handle page creation and processing in custom property dialog

The PageCreation property must be added to report properties.

Efficient memory management in table processing

This VirtualEvaluation reuses tablix cell object to reduce memory utilization.

public void OnInitReportOptions(ReportViewerOptions reportOption)
{
    reportOption.ReportModel.PerformanceSetting = new BoldReports.RDL.Data.PerformanceSetting
    {
        VirtualEvaluation = true
    };
}

Also you can set this property for a specific report by using the VirtualEvaluation custom property. You can set the VirtualEvaluation as custom property as shown below, Shows configuration of virtual evalution property in custom property dialog

The VirtualEvaluation property must be added to report properties.

Dynamic textbox size calculation

The AutoGrowText property is used to measure dynamic text height in each text box. Please note: if we set AutoGrowText to true, the viewer will take time to measure the height of each textbox cell, depending on the amount of data. For more information refer this Improve the performance while loading report with huge data

public void OnInitReportOptions(ReportViewerOptions reportOption)
{
    reportOption.ReportModel.PerformanceSetting = new BoldReports.RDL.Data.PerformanceSetting
    {
        AutoGrowText = false
    };
}

Also you can set this property for a specific report by using the AutoGrowText custom property. You can set the AutoGrowText as custom property as shown below,

Shows the configuration of auto can grow in custom property dialog

Limit the data for rendering

The FetchLimit property is used to limit the number of records fetched in a report. For instance, if a report contains huge records by applying a FetchLimit of 1000 will ensure that only 1000 records will fetched from the dataset.

public void OnInitReportOptions(ReportViewerOptions reportOption)
{
    reportOption.ReportModel.PerformanceSetting = new BoldReports.RDL.Data.PerformanceSetting
    {
        FetchLimit = 1000
    };
}

Also you can set this property for a specific report by using the FetchLimit custom property. You can set the FetchLimit as custom property as shown below,

Shows configuration of enable fetch limit property in custom property dialog

Limitations

We have provided this feature for non-grouping Tablix-based reports. However, there are a few limitations that are listed below.

  1. Reports featuring nested tables are not supported.
  2. Reports that include multiple tables are not supported.
  3. Cells within a Tablix must contain only text; cells with images or charts are not supported.
  4. Reports containing image-based content cannot be used.
  5. Reports containing toggle items are not supported.
  6. Reports that contain sub-reports are not supported.
  7. Reports with document mapping or bookmark labels are not supported.
  8. Sorting of table cells in the viewer is limited in functionality.
  9. Tablix structures with repeat headers are not supported.
  10. File storage cache settings are not supported.
  11. Tablix structures with column groups are not supported.