Upgrade and Customizations
When upgrading to a new version of ThingWorx Apps, different customizations are impacted differently.
Direct Edits to Extension Entities
Direct edits to entities provided with the extensions, such as the schedulers and media entities, are overwritten during an upgrade. If these customizations are wanted in the new release, they will need to be re-implemented after the upgrade is complete. These customizations are clearly identified when they are discussed.
Localization Table Changes
The localization tables are overwritten when an upgrade is installed. To keep your localization table modifications, export the customized localization table before performing an upgrade, and import it back after the upgrade is complete.
Launch Point Configuration Thing and Duplicate Mashup Changes
A new PTC.Factory.C_LaunchPointConfigurationThing_[ReleaseVersion] is delivered with the application for each release. Similarly, new release-specific duplicate mashups are provided with each release. Your customized PTC.Factory.C_LaunchPointConfigurationThing_[OldReleaseVersion] and any release-specific duplicate mashups that you have customized are not overwritten during an upgrade, but they are not automatically applied in the upgraded extension.
Release-specific launch point configuration thing changes include any LaunchPointEntitySettings changes pointing to customized mashups, custom equipment types added to the EquipmentTypeSettings configuration table, additional contexts added to the EquipmentContextSettings configuration table, new connections defined on the RemoteConnectionSettings configuration table, and so on. Any such changes made in the old PTC.Factory.C_LaunchPointConfigurationThing_[OldReleaseVersion] that you want to keep in the upgraded extension must be reapplied in the new PTC.Factory.C_LaunchPointConfigurationThing_[NewReleaseVersion]. After you see the new changes in the application, you can compare your old PTC.Factory.C_LaunchPointConfigurationThing_[OldReleaseVersion] with the new PTC.Factory.C_LaunchPointConfigurationThing_[NewReleaseVersion], and modify the settings for the new release as needed.
Tile Changes in the Data Table
Changes made for tiles in the release-specific data table (PTC.FactoryConsole.C_DataTable_[ReleaseVersion]) are retained, but not automatically applied in the upgraded extension. If you want those changes in the upgraded extensions, the following steps need to be performed after completing the upgrade:
1. Modify the configuration table of the launch point configuration thing PTC.Factory.C_LaunchPointConfigurationThing_[NewReleaseVersion] to point to the new data table of PTC.FactoryConsole.C_DataTable_[NewReleaseVersion].
2. Modify the data table of PTC.FactoryConsole.C_DataTable_[NewReleaseVersion] with all changes that were made in the PTC.FactoryConsole.C_DataTable_[OldReleaseVersion].