Migrating Existing Applications

The latest release of ThingWorx Remote Access and Control and ThingWorx Software Content Management includes updates to the names of ThingShapes and Properties for the core PTC Ontology. Specifically, PTCCoreAsset, PTC.Core.ClassifiedAsset, PTC.Core.OwnedAsset, and PTC.Core.PhysicalAsset are now merged into the new ThingShape, TW.RSM.ThingShape.Asset.

The values of PTC Core properties will only appear in the UI if they are mapped to the new Ontology names. There are two ways that this can be done:

If you are migrating pre-existing assets (ThingShapes and Properties) from a previous version, use Method 1.
If you have created new assets (ThingShapes and Properties) for this version of ThingWorx Converge Accelerator, use Method 2.

Method 1: Mapping Old Properties Using a Resource Provider

In ThingWorx Composer, click Things under the Modeling section.
In the list of Things, locate and search for and select the PTC.Resource.Asset.RSMAssetResourceProvider entity.
In the left panel, under Entity Information, click Configuration.

Under Resource Attribute Mapping Configuration, for the list of Normalized properties, update the corresponding Original values by entering the old property names into the input fields in the Original column.

The table below lists the Normalized properties whose corresponding Original values need to be updated. The required values for the Original inputs are listed:

Normalized	Original (to update)
Image	AssetImage
ModelNumber	AssetModelNumbe
Operator	AssetOperator
SerialNumber	AssetSerialNumber
Blog	AssetBlog
Location	AssetLocation
Owner	AssetOwner
OperatorContact	AssetOperatorContact
OwnerContact	AssetOwnerContact

Click Save.

Method 2: Implement a New ThingShape for Things and ThingTemplates

Add the new TW.RSM.ThingShape.Asset ThingShape to each Thing or ThingTemplate that has been created for the latest version of ThingWorx Converge.

All ThingWorx Converge assets must implement the new TW.RSM.ThingShape.Asset ThingShape, and the properties on those assets must be re-entered for the new implementation. Repeat the steps below for each asset.

Depending on whether you intend to update a Thing or a ThingTemplate, click either Things or ThingTemplates in the Modeling section of the ThingWorx Composer.
In the Things or Thing Templates list, locate and select the item to be updated.
On the General Information page, next to Implemented Shapes, click in the text field and type TW.RSM.ThingShape.Asset.
Click the TW.RSM.ThingShape.Asset entry in the search results to apply the shape.
Click Save.
In the left-hand panel, under Entity Information, click Properties.

In the list of “Base ThingTemplate - Properties”, edit the value for each “new property name” so that it matches the value of the corresponding “old property name”, as outlined in the table below.

Old Property Name	New Property Name
AssetImage	Image
AssetModelNumbe	ModelNumber
AssetOperator	Operator
AssetSerialNumber	SerialNumber
AssetBlog	Blog
AssetLocation	Location
AssetOwner	Owner
AssetOperatorContact	OperatorContact
AssetOwnerContact	OwnerContact

Click Save.