Migrating Legacy Projects

Upgrade Command

In order to upgrade a legacy project, you just need to put the <project>.tProj file in the folder mapped to the Solutions Manager, so that project will be visible on the Solutions List (press Refresh after changing files in the folders).

Only projects from versions 9.1 and 9.2 can be upgraded directly. For older project files, first use the 9.1 or 9.2 product to upgrade to that version, the bring to the final step on version 10.

When a file with extension .tProj is found, it shows on the Solution list, with the prefix Project. When a legacy project is selected, the Upgrade Version command button is enabled. 

When Upgrading:

• The previous Project file remains intact, the system uses a copy of in the upgrade process. 
• A new Solution (extension dbSln) is created with the same name of upgraded project (only the extensions of the file will be distinct)
• After the upgrade, only the new Solution (.dbSln) will show on the solution list (the legacy project file is kept hidden from the list)

The first time you open an imported solution, the Designer will prompt you to do a Build Command (Runtime→Build And Publish).

Manual Upgrade Corrections

Most of the replacement of new names and properties is executed automatically, but there a few areas that a manual interface is necessary.

RuntimeUsers Database, TableName

The pre-defined value for the table name for RuntimeUsers is version 9.2 or older was: EditSecurityUsers_Runtime. That name was replace by SecurityRuntimeUsers. 

The Upgrade tools already tries to find and correct that name in Scripts and Database connections automatically, but the DATABASE itself you will be connecting, we can't change automatically. Therefore, before commission the version 10 to production, you need to rename the name is the target database, from EditSecurityUsers_Runtime to SecurityRuntimeUsers

Advanced Toolkit applications

Some advanced applications using the product toolkits, and the API for programatic engineering (EngWrapper API), are likely to lack compatibility due the renaming of internal data structures and tables. Contact support if upgrading such applications. 

Themes

The Themes features from 9.2 allowed extensive customization, with the drawback that could be quite complex to manage. 

The Themes features of version was expanded, with more built-in themes, and extremely simplified, but the migration can't be fully automated. Those solutions needs to have a review on the colors of screen and objects that were mapped to theme resources. 

Scripts Asynchronous Methods

Version 10 uses a more modern and efficient programming pattern that is Asynchronous methods. That allows better performance on displays, and it is one the technologies that enabled most of Windows WPF displays, to run also on WEB HTML5 with no modifications. 

When creating new solutions, that is done automatically for you, but legacy Displays that had heavy CodeBehind Scripts, may need to the methods modified to use the async operator. 

For more information on Async programming: https://learn.microsoft.com/en-us/dotnet/csharp/asynchronous-programming/

Calling Server Classes from Displays or. Client Classes

 Now when calling Script Class Server method from Client scripts (Script Class Client or Display CodeBehind) should add "await" (C#) "Await" (VB.NET) for the HTML5 to work successfully.

C#:

public async Task DisplayOpening() { await @Script.Class.ServerMain.Method1(); }

VB.NET:

Public Async Function DisplayOpening() As Task Await @Script.Class.ServerMain.Method1() End Function

Deprecated Features

List of Deprecated features:

• Synchronous calls on SQL Queries and various other methods. The system will still compile, but a warning will be issued.
• Custom Theme  Editing for specific controls, and allowing different solutions to have distinct IDs for the theme resources, whDirect ich are now standard. 
• Direct Access and mapping to external TagProvider data, without define its position on the AssetTree.

In this section: