Progress® Telerik® Reporting R2 2019

Upgrade

Depending on the new features and changes in each new Telerik Reporting release, you may have to upgrade your project.

Specific changes and dependencies for each major Telerik Reporting release are listed in the child articles.

General Workflow

  1. Check for any new features, fixes, breaking or dependency changes in the Telerik Reporting Release History.

  2. Install the desired Telerik Reporting version by using the Telerik Control Panel or through the MSI installer file.

  3. Upgrade all projects that use Telerik Reporting as described in this article.

  4. Refer to the child aricles to check for any updates between your current and desired versions. For example, if your project currently targets Q3 2013, to upgrade to Q1 2014, review the articles for Q3 2013 SP1 and Q1 2014. In this specific example the Q3 2013 SP1 article is missing because no breaking or dependency changes were introduced in that release.

For any persisting issues, either:

Major and Minor Releases

Telerik Reporting supports the following types of releases:

  • Major versions―Can simultaneously coexist on the same machine. For example, major versions are the Q3 2013 and Q1 2014 releases.

  • Minor versions―Also known as Service Packs (SP). A major version can coexist on the same machine with only a single minor version from the same release. For example, when you upgrade the major Q1 2014 release to the later minor Q1 2014 SP1 release, the installer will first uninstall the Q1 2014 version and then install the Q1 2014 SP1 one.

If the new Telerik Reporting version is a major release, it will be installed next to the earier releases. If the new Telerik Reporting version is a minor release, it will replace the corresponding major release.

Visual Studio Toolbox loads only the updates from the latest Telerik Reporting version that is installed on your computer. However, you will be able to work with the item and project templates from all Telerik Reporting versions that are installed on your computer.

Upgrading Projects Automatically

To automatically upgrade your project to a later Telerik Reporting version, use the Telerik Upgrade Wizard.

  • The Telerik Upgrade Wizzard does not support website projects. Websites handle assembly references in a different way. For more information, refer to the article on Web Application Projects versus Web Site Projects in Visual Studio. To upgrade your website project automatically, transform it into a web application or manually upgrade your website project.

  • Website, WPF, and Silverlight projects which use the WPF and Silverlight ReportViewers but do not have separately purchased Telerik UI for WPF and Telerik UI for Silverlight products, can only be updated manually.

Upgrading Website Projects Manually

  1. In Solution Explorer, click the Show All Files button.

  2. Select Delete all to remove all Telerik Reporting assemblies from the Bin folder.

  3. From the References tab on the Property Pages of the website, remove all references to Telerik Reporting assemblies. Remember the names of the deleted assemblies.

  4. Select Add all to add all required references to the new Telerik Reporting assembly versions. They correspond to the ones that you deleted in the previous step.

  5. Open the web.config file and update all version numbers to the new one in the following instances:

    • <configSections>―The location in which you can alter the atributes of the rendering extensions.

    • <httpHandlers>/<handlers>―The location in which the ASP.NET ReportViewer registers its handler.

    • <assemblies>―The Telerik Reporting assemblies that are references in the website.

  6. Open the .aspx/.master pages and change the version of the ReportViewer in the Register directive.

  7. Open all report resource files as XML―Each .resx file appears under the respective report file.

  8. Locate all occurrences of a Telerik Reporting Assembly and update their version number to the new one. Unlike the version name (for example, Q1 2014), the version number is a technical identifier (for example, 8.0.14.225).

  9. Restart Visual Studio.

  10. Rebuild all updated projects.

  11. If compilation errors or warnings occur, review the Release History section for any obsolete or deleted properties, methods, and events, and handle these according to the instructions in the section. Review the release history for all releases between the previous and the latest version you installed.

Upgrading Other Projects Manually

Apart from website projects, you can also manually upgrade class library projects, desktop and web applications.

  1. In Solution Explorer, click the Show All Files button.

  2. Open References and locate the references to the previous Telerik Reporting assemblies. Service Pack assemblies are marked with yellow exclamation marks which show that the assemblies cannot be located. This is normal behavior and indicates that you have an uninstalled the version to which they belong.

  3. Select the old assemblies that you identified in the previous step and click Delete to remove them. Remember the names of the deleted assemblies.

  4. Right-click References and select Add Reference.

  5. Select Add all to add all required references to the new Telerik Reporting assembly versions. They correspond to the ones that you deleted in the previous step. As a result, the newly added references appear in References without the yellow exclamation marks which means that they are valid.

  6. Open the web.config/app.config file and update all version numbers to the new one in the following instances:

    • <configSections>―The location in which you can alter the attributes of the rendering extensions.

    • <httpHandlers>/<handlers>―The location in which the ASP.NET ReportViewer registers its handler.

    • <assemblies>―The Reporting assemblies that are references in the web application.

  7. (Applicable to web applications only.) Open the .aspx or .master pages and change the version of the ASP.NET ReportViewer in the Register directive.

  8. (Applicable to web applications only.) Update the HTML5 Report Viewer files in the project. Open the .cshtml or .vbhtml and layout views, the pure HTMl pages or the .aspx or .master pages and change the version of the links which point to the following files:

    • telerikReportViewer-x.x.x.x(.min).css―The CSS of the HTML5 Report Viewer where x.x.x.x is the HTML5 ReportViewer and Telerik Reporting version (for example, 8.1.14.816).

    • telerikReportViewer-x.x.x.x(.min).js―The JavaScript files of the HTML5 Report Viewer where x.x.x.x is the HTML5 ReportViewer and Telerik Reporting version (for example, 8.1.14.816).

    • telerikReportViewerTemplate.html―The default template HTML page of the HTML5 Report Viewer.

  9. (Applicable to WPF applications only.) Update the references to Telerik UI for WPF and the corresponding binding redirects, if any. For more information, refer to the article on manually setting up the WPF ReportViewer.

    Update the XAML resources which correspond to the updated Telerik UI for WPF assemblies.

  10. (Applicable to Silverlight applications only.) Update the references to Telerik UI for Silverlight. For more information, refer to the article on adding the Sliverlight ReportViewer.

    Update the XAML resources which correspond to the updated Telerik UI for Silverlight assemblies.

  11. Open all report resource files as XML―each .resx file appears under the respective report file.

  12. Locate all occurrences of a Telerik Reporting Assembly and update the version number to the new one. Unlike the version name (for example, Q1 2008), the version number is a technical identifier (for example, 2.5.8.414).

  13. Restart Visual Studio.

  14. Rebuild all updated projects.

  15. If compilation errors or warnings occur, review the Release History section for any obsolete or deleted properties, methods, and events, and handle these according to the instructions in the section. Review the release history for all releases between the previous and the latest version you installed.

In this article
Not finding the help you need?