Upgrade Guide from Version 2019 to 2019 R2

Last Updated: March 2020

If you have installed SnapDevelop 2019 and SnapObjects 1.0, you can follow steps below to upgrade to SnapDevelop 2019 R2 and SnapObjects 2.0.

Step 1: Re-install Nuget packages.

  1. Upgrade the existing SnapObjects package to version 2.0.0.

  2. Remove the old packages first and then install the new packages, as the following Nuget packages have been renamed:

    PowerBuilder.Data is renamed to DWNet.Data.

    PowerBuilder.Data.AspNetCore is renamed to DWNet.Data.AspNetCore.

Step 2: Upgrade .NET DataStore.

  1. Remove the DataWindow SRD files and model files from the project, and then re-generate the data models for DataWindows using the DataWindow Converter tool.

  2. In non-ASP .NET Core project, change the method to load DataWindow: from DataObjectFactory.LoadDataWindow() to DwModelManager.LoadDwModels().

    If using DataStore to replace the original DataStores, then you don't need to use the DwModelManager.LoadDwModels().

  3. Make corresponding changes to DataObject, as now DataStore.Object returns an IDwMeta object, and it is no longer possible to access the DataWindow object properties related with UI (these properties as well as DataObject have been moved to PowerScript.Bridge).

Step 3: Install and use the new PowerScript.Bridge package.

When using the C# functions which is migrated from PowerScript or using DataObject which is moved from DwNet.Data to PowerScript.Bridge, you will need to add the PowerScript.Bridge namepspace.

Step 4: Compile the project and modify the script according to the error prompts.

There are a few method names or usages that have been changed.