add images for each step (#1518)
* add images for each step * Update upgrade-wizard.md --------- Co-authored-by: Dimitar Nikolov <dnikolov@progress.com>
После Ширина: | Высота: | Размер: 19 KiB |
После Ширина: | Высота: | Размер: 43 KiB |
После Ширина: | Высота: | Размер: 36 KiB |
После Ширина: | Высота: | Размер: 36 KiB |
После Ширина: | Высота: | Размер: 32 KiB |
После Ширина: | Высота: | Размер: 7.9 KiB |
После Ширина: | Высота: | Размер: 22 KiB |
После Ширина: | Высота: | Размер: 17 KiB |
До Ширина: | Высота: | Размер: 21 KiB После Ширина: | Высота: | Размер: 18 KiB |
|
@ -11,14 +11,24 @@ previous_url: /ui-upgrade-wizard
|
|||
|
||||
# Upgrade Wizard Overview
|
||||
|
||||
The `Upgrade Wizard` will guide you through the process of upgrading Telerik Reporting projects to a newer (or older) version of Telerik Reporting. This wizard will upgrade the following:
|
||||
The Visual Studio Extensions offer the Project **Upgrade Wizard**. It will guide you through the process of upgrading **Telerik Reporting** projects to a newer (or older) version of Telerik Reporting.
|
||||
|
||||
Before starting the wizard, you can check what version of Telerik Reporting is currently referred in your project:
|
||||
|
||||
![Check Version](images/check-referred-version.png)
|
||||
|
||||
The **Upgrade Wizard** can be started by using the **Extensions > Telerik > Reporting > Upgrade Wizard** menu item:
|
||||
|
||||
![Start Upgrade Wizard](images/start-upgrade-wizard.png)
|
||||
|
||||
This wizard will upgrade the following:
|
||||
|
||||
* The references to Telerik Reporting assemblies to the selected version
|
||||
* The project’s `.config` file
|
||||
* All web page/user control files (`aspx`/`ascx`) with references to the Telerik Reporting assemblies
|
||||
* All resource files (`resx`) with references to the Telerik Reporting assemblies
|
||||
|
||||
The wizard __will not__ change any code, or namespaces, nor will it remove obsolete properties, events, and methods. You may need to manually update your code after this wizard completes.
|
||||
>note The wizard __will not__ change any code, or namespaces, nor will it remove obsolete properties, events, and methods. You may need to manually update your code after this wizard completes.
|
||||
|
||||
> Web Site projects are not supported by the Upgrade Wizard. In Web Sites assembly references are handled differently, and our recommendation is to upgrade manually or to turn the project into a Web Application that can be upgraded automatically - [Web Application Projects versus Web Site Projects in Visual Studio](https://learn.microsoft.com/en-us/previous-versions/aspnet/dd547590(v=vs.110)).
|
||||
|
||||
|
@ -28,6 +38,30 @@ The wizard __will not__ change any code, or namespaces, nor will it remove obsol
|
|||
>
|
||||
> * The HTML5 Report Viewer scripts
|
||||
|
||||
1. On the first step the wizard provides basic update process information:
|
||||
|
||||
![First Step in Upgrade Wizard](images/first-step-upgrade-wizard.png)
|
||||
|
||||
1. On the next step, the wizard lists all projects from the solution, which use Telerik Reporting. You can choose which projects will be updated (it is recommended to upgrade all projects to the chosen version, not just part of them) and the version which they will be upgraded to.
|
||||
|
||||
![Choose Project in Upgrade Wizard](images/choose-project-step-upgrade-wizard.png)
|
||||
|
||||
1. The next screen allows you to create a backup for the project.
|
||||
|
||||
![Backup in Upgrade Wizard](images/backup-step-upgrade-wizard.png)
|
||||
|
||||
1. Review the changes.
|
||||
|
||||
![Review Changes in Upgrade Wizard](images/review-step-upgrade-wizard.png)
|
||||
|
||||
1. The Complete step indicates whether the upgrade process is completed for all the projects successfully. It also indicates if any errors occured and the user is promped to decide whether to proceed or revert the changes:
|
||||
|
||||
![Errors in Upgrade Wizard](images/errors-in-upgrade-wizard.png)
|
||||
|
||||
1. Finally, the wizard shows a log file with the changes:
|
||||
|
||||
![Log in Upgrade Wizard](images/log-in-upgrade-wizard.png)
|
||||
|
||||
The Upgrade Wizard works only with project items. It is registered in Visual Studio and keeps track of Telerik Reporting installation folders on the machine. Telerik Reporting references are updated by using the selected in the wizard version and the installation folder registered for that version. If Telerik Reporting assemblies are referenced from a custom location, not the installation folder, the Upgrade Wizard will not update the content of the custom folder and references will be pointed to the installation folder.
|
||||
|
||||
The wizard requires access permissions to the solution folder and its files. If the solution or some of its projects are under source control, make sure that the correct source control plug-in is active in Visual Studio and that no files are exclusively checked out by another user.
|
||||
|
@ -55,3 +89,6 @@ Run the `Upgrade Wizard` to upgrade your _ReportLibrary_ projects hosting the re
|
|||
This wizard __will not__ change any of your current code. As a result __you may receive compilation errors and/or warnings__ for properties, methods, and events marked as obsolete. In this case, a manual update of your code is required. The [Release Notes](https://www.telerik.com/support/whats-new/reporting/release-history) contain the complete list of obsolete and deleted properties, methods, and events including information on what to be used instead, and why. Please, review the release notes of all Telerik Reporting versions starting from the version you upgraded from to the version you upgraded to, including the ones in between for information on how to update your project.
|
||||
|
||||
Feel free to contact us via the [support ticketing system](https://www.telerik.com/account/support-center/contact-us/technical-support) in case you still experience problems after the upgrade, and we will help you resolve any remaining issues. It will be faster and easier if you package your solution/project as a _ZIP_ file and send it to Telerik, together with information on the errors/warnings you see.
|
||||
|
||||
## See Also
|
||||
* [Missing Telerik menu in Visual Studio]({%slug missing-telerik-menu-in-visual-studio%})
|
||||
|
|