Defining Property Display for Equipment Types
Define the properties for an equipment type on the Thing Template for that equipment type, or on the Thing Shapes implemented by the Thing Template. This ensures that all equipment of that equipment type inherits the same properties.
In ThingWorx Apps, there are three categories of equipment properties: properties that can be bound, trended, or displayed. The properties displayed for each category are controlled by services that the equipment type Thing Template inherits from the PTC.SCA.SCO.MonitoredPropertiesThingShape Thing Shape:
GetTagPickerProperties service—Returns properties of any base type that can be bound using the tag picker common component. The type of properties displayed in the tag picker common component can be configured further for each usage of the tag picker. For more information, see Customizing the Tag Picker Common Component.
GetMonitoredProperties service—Returns properties that are trended on the Monitored Properties page in Asset Advisor. Only numerical and Boolean base type properties that are logged are returned.
GetAdditionalProperties service—Returns properties for which the name and value are displayed on the Additional Properties page for an asset in Asset Advisor.
* 
The Additional Properties table for equipment being configured from the Equipment tab of Configuration and Setup displays all properties returned by these three services, with no duplicates.
Each service can be customized independently on the Thing Template for an equipment type.
The properties returned by each service are calculated from the following property sets:
Inherited properties—Properties defined in the Thing Template and implemented Thing Shapes that are inherited by the Thing.
My properties—Properties defined directly on the Thing, added either through the ThingWorx Apps user interface or in ThingWorx Composer. These properties appear in the My Properties table on the Properties and Alerts page for the Thing in ThingWorx Composer. These properties are always returned.
Service properties—Properties specified in the myList variable in the service.
Excluded properties—Inherited properties to be excluded by default from the ThingWorx Apps user interface if nothing is specified in the myList variable. These properties are listed in the GetExcludedProperties service, which is called by the other three services.
Each service also contains an IncludeInheritedProperties variable, which controls whether inherited properties (with the exception of any excluded properties) are included in the result set. This allows you to easily include or exclude inherited properties from being displayed for the equipment.
The service output is determined as follows:
When IncludeInheritedProperties is set to true, and no properties are specified in the myList variable, all properties in the My Properties table on the Thing and all inherited properties (with the exception of any excluded properties) are returned. This is the default behavior for the services.
When IncludeInheritedProperties is set to true, and any properties are specified in the myList variable, all properties in the My Properties table on the Thing and specified in the myList variable are returned.
When IncludeInheritedProperties is set to false, and no properties are specified in the myList variable, only properties in the My Properties table on the Thing are returned.
When IncludeInheritedProperties is set to false, and any properties are specified in the myList variable, all properties in the My Properties table on the Thing and specified in the myList variable are returned.
Was this helpful?