Migrating Existing Applications

The latest release of ThingWorx Asset Manager and ThingWorx Software Content Management includes updates to the names of thing shapes 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 thing shape, TW.RSM.ThingShape.Asset.

The values of PTC Core properties 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 (thing shapes and properties) from a previous version, use Method 1.
If you have created new assets (thing shapes and properties) for this version of ThingWorx Utilities 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	AssetModelNumber
Operator	AssetOperator
SerialNumber	AssetSerialNumber
Blog	AssetBlog
Location	AssetLocation
Owner	AssetOwner
OperatorContact	AssetOperatorContact
OwnerContact	AssetOwnerContact

Click Save.

Method 2: Implement a New Thing Shape for Things and Thing Templates

Add the new TW.RSM.ThingShape.Asset thing shape to each thing or thing template that has been created for the latest version of ThingWorx Utilities.

All ThingWorx Utilities assets must implement the new TW.RSM.ThingShape.Asset thing shape, 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 thing template, 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 (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.