Defining Equipment Relationships
Once an equipment type has been defined in the EquipmentTypeSettings configuration table on the launch point configuration thing, you can define the valid parent-child relationships for that equipment type. These parent-child relationships are used when creating your equipment and equipment structure. Equipment types that derive from another equipment type automatically inherit the relationships defined for the type from which it derives. In order for equipment of an equipment type to be created in ThingWorx Apps, the equipment type must be part of at least one valid equipment relationship definition, or be derived from an equipment type that is part of a valid equipment relationship definition.
Equipment relationships are defined in equipment relationship definition data tables. The available relationships for a context are determined by the equipment relationship definition data table referenced for its EquipmentRelationshipSettings value on the EquipmentContextSettings configuration table on the Configuration page of the launch point configuration thing (PTC.Factory.C_LaunchPointConfigurationThing_[ReleaseVersion]). An individual equipment relationship definition data table can be referenced by multiple contexts, allowing each of those contexts to have a unique equipment structure based on the same set of valid relationships.
The four equipment relationships defined for the Site, Line, and Asset equipment types provided out-of-the-box with ThingWorx Apps are defined in the PTC.SCA.SCO.DefaultEquipmentRelationshipDefinition data table, and shown in the following image. By default, this data table is referenced as the EquipmentRelationshipSettings value for the DefaultContext provided with ThingWorx Apps.
 |
The PTC.SCA.SCO.DefaultEquipmentRelationshipDefinition data table is overwritten during upgrades. A release-specific version of the data table (PTC.SCA.SCO.C_DefaultEquipmentRelationshipDefinition_[ReleaseVersion]) is provided for making changes to these default equipment relationship definitions. To make changes to the default equipment relationships that are provided with ThingWorx Apps, edit this release-specific data table, and update the EquipmentRelationshipSettings value for the default context (DefaultContext) to point to the edited release-specific data table.
|
Each relationship definition is a row in the Data Table Entries pane. The key value for a relationship definition is the combination of the child and parent equipment types in the relationship. By default, all information for a relationship is displayed in the Data Table Entries pane. When you add or update an equipment relationship, or click Refresh the table updates to show only the editable fields. Clicking Save returns the Data Table Entries pane to the full information display.