Migrate Report Designer application
To migrate an ASP.NET Core Report Designer application from Syncfusion® Essential Studio to Bold Reports®, replace the old scripts, styles, assemblies, packages, tag helpers and control tags with the Bold Reports® ones. Bold Reports® introduces new client-side and server-side assemblies to resolve the compatibility problem between Essential Studio Report Designer versions, with changes in both the Web API service and the client-side scripts.
The following sections provide step-by-step instructions for migrating the Report Designer from Syncfusion® Essential Studio release version to Bold Reports® version higher than v5.2.xx of ASP.NET Core Report Designer application.
Scripts
| Old Scripts |
New Scripts |
Description |
ej.web.all.min.js
|
bold.reports.common.min.js
bold.reports.widgets.min.js
bold.report-viewer.min.js
|
We have removed the dependency scripts for report designer from existing ej.web.all.min.js script and provided the dependency scripts as follows:
bold.reports.common.min.js - Common script for reporting widgets.
bold.reports.widgets.min.js - It contains the scripts of dependent controls that are common for both Report Designer and Report Viewer.
bold.report-viewer.min.js - Previews the reports designed with Report Designer.
|
ej.reportdesigner.min.js
|
bold.report-designer.min.js
|
Renamed the report designer script file. It renders the Bold Reports® Report Designer widget.
|
Styles
| Old Scripts |
New Scripts |
Description |
ej.web.all.min.css
|
bold.report-designer.min.css
|
We have removed the dependent controls styles for report designer from existing ej.web.all.min.css script and provided the dependent controls styles as bold.report-designer.min.css.
|
Remove the old scripts and styles references from existing application, then add the new scripts and styles references based on the preceding script name changes.
Assemblies
| Purpose |
Old Assembly Name |
New Assembly Name |
Description |
| Base Assemblies |
Syncfusion.EJ.ReportDesigner.dll
Syncfusion.EJ.ReportViewer.dll
Syncfusion.Report.Portable.dll
|
BoldReports.Web.dll
|
The Syncfusion.EJ.ReportDesigner.dll, Syncfusion.EJ.ReportViewer.dll, and Syncfusion.Report.Portable.dll assemblies have been combined as BoldReports.Web.dll. It builds the server-side implementations for both Report Designer and Report Viewer components.
|
| Tag Helper Assemblies |
Syncfusion.EJ.dll
Syncfusion.EJ.AspNet.Core.dll
|
BoldReports.AspNet.Core.dll
|
The Syncfusion.EJ.dll, Syncfusion.EJ.AspNet.Core.dll assemblies have been combined as BoldReports.AspNet.Core.dll.
|
Packages
| Purpose |
Old Packages |
New Packages |
| Server Side Helper |
Syncfusion.EJ.ReportDesigner.AspNet.Core
Syncfusion.EJ.ReportViewer.AspNet.Core
Syncfusion.Report.Net.Core
|
BoldReports.Net.Core
|
| Tag Helper |
Syncfusion.EJ.AspNet.Core
|
BoldReports.AspNet.Core
|
Based on the preceding assembly and namespace changes, modify the Report Designer Web API Controller in your application.
Tag helper
Modify the tag helpers in the _ViewImports.cshtml page.
| Old code snippet |
New code snippet |
@using Syncfusion.JavaScript
@addTagHelper *, Syncfusion.EJ
|
@using BoldReports.TagHelpers
@addTagHelper *, BoldReports.AspNet.Core
|
The ASP.NET core reporting components tag prefix has been changed from ej to sf.
| Old code snippet |
New code snippet |
<ej-script-manager></ej-script-manager>
|
<bold-script-manager></bold-script-manager>
|
Control initialization
| Old code snippet |
New code snippet |
<ej-report-designer id="designer"></ej-report-designer>
|
<bold-report-designer id="designer"></bold-report-designer>
|