Creating Custom Thing Templates for Equipment Types
When an instance (thing) of an equipment type is created, the thing template specified for the equipment type in the EquipmentTypeSettings configuration table is set as the Base Thing Template for the equipment thing. Any properties defined on the thing template for an equipment type, or on a thing shape implemented by the thing template, are automatically present on all equipment of that equipment type.
For each new equipment type, create a new thing template. An individual thing template should be associated with only one equipment type.
To create a thing template:
1. In ThingWorx Composer, select > from the top toolbar.
2. Provide a name for the thing template, and select a Base Thing Template. ThingWorx Apps provides a generic thing template (PTC.ISA95.EquipmentThingTemplate) which includes as its Implemented Shapes the thing shapes required to support basic ThingWorx Apps functionality. You can use PTC.ISA95.EquipmentThingTemplate as the Base Thing Template for your new thing template.
4. Click Save.
5. On the thing template, navigate to > . The toggle
switches between setting permissions for the entity itself (the thing template) and for instances of the thing template (things). For both the entity and the instance, search for and add the
PTC.Factory.MachineVisibility organization to the
Org or Org Unit table.
6. Navigate to > . For both the entity and the instance, search for and add the FactoryUsers user group to the User or Group table, and grant all permissions by clicking the checkmark for each permission.
Required Thing Shapes
Thing templates for equipment types that you want to appear in Asset Advisor must implement the following thing shapes:
• PTC.Factory.PhysicalAssetThingShape
• PTC.SCA.SCO.AssetIdentifierThingShape
• PTC.SCA.SCO.StatusThingShape
• PTC.SCA.SCO.ShiftThingShape
• PTC.ISA95.IdentifierThingShape
• PTC.SCA.SCO.MonitoredPropertiesThingShape
Thing templates for all other equipment types must implement the following thing shapes:
• PTC.ISA95.DisplayNameThingShape
• PTC.ISA95.IdentifierThingShape
• PTC.SCA.SCO.IdentifierThingShape
• PTC.ISA95.GeneralEquipmentThingShape
• PTC.SCA.SCO.MonitoredPropertiesThingShape
Thing Shapes for Specific Functionality
Implement the following thing shapes in your thing template to include specific functionality in your equipment type:
Functionality | Thing Shapes to Implement |
---|
KPI calculations. | PTC.SCA.SCO.KPIElementThingShape PTC.SCA.SCO.QualityRatioThingShape PTC.SCA.SCO.OEEThingShape PTC.SCA.SCO.AvailabilityThingShape PTC.SCA.SCO.EffectivenessThingShape PTC.SCA.SCO.ShiftThingShape |
Include crew and job order information with KPI historical data. | PTC.SCA.SCO.WorkforceThingShape PTC.SCA.SCO.JobOrderThingShape |
Status calculations. For more information, see Status. | PTC.SCA.SCO.StatusThingShape PTC.SCA.SCO.ShiftThingShape |
Provides the modelNumber and serialNumber properties for equipment that appears in Asset Advisor. | PTC.SCA.SCO.AssetIdentifierNumberThingShape |
Managing geo-location. | PTC.SCA.SCO.LocationThingShape |
File transfer capabilities for equipment that appears in Asset Advisor. | PTC.SCA.SCO.FileTransferHistoryHandlerThingShape |
Remote access capabilities for equipment that appears in Asset Advisor (including Axeda assets). | RemoteAccessible |
Remote access capabilities for equipment that appears in Asset Advisor (does not apply for Axeda assets). | PTC.SCA.SCO.RemoteTunnelingThingShape |
Defines links between an asset and other objects in the ISA 95 thing model. | PTC.ISA95.GeneralPhysicalAssetThingShape |