Adding or Updating Equipment Relationship Definitions
To add or update entries in an equipment relationship definition data table:
1. Navigate to the equipment relationship definition data table to be edited, for example, PTC.SCA.SCO.C_DefaultEquipmentRelationshipDefinition_[ReleaseVersion].
2. View the Mashup page.
3. In the Entries Editor pane, define the relationship that is being added or updated by specifying the Parent and Child equipment types for the relationship. Both equipment types must already be present in the EquipmentTypeSettings configuration table on the launch point configuration thing, and the values entered for the Parent and Child fields must match the EquipmentType values for those types in the EquipmentTypeSettings configuration table. These values are case-sensitive.
4. If you want to be able to associate the same child equipment to more than one parent at a time, select the ManyToManyCardinality checkbox. For example, the ManyToManyCardinality checkbox must be selected for the Line-Asset relationship to associate Asset1 with both Line1 and Line2.
5. Select the Enabled checkbox to enable the relationship in ThingWorx Apps. Only enabled relationships can be created in ThingWorx Apps.
6. Click Add/Update. The action performed is based on the parent and child equipment types specified in the Entries Editor pane:
◦ If the specified combination of parent and child equipment types is not yet present in the Data Table Entries pane, a new relationship is added.
◦ If the specified combination of parent and child equipment types is already present in the Data Table Entries pane, the existing relationship is updated.
The relationship is automatically saved when Add/Update is clicked.
7. Repeat steps 3 through 6 as needed to define additional relationships. The relationships are validated each time the launch point configuration thing (PTC.Factory.C_LaunchPointConfigurationThing_[ReleaseVersion]) is saved.
 |
Equipment types that derive from another equipment type follow all the relationships defined for the equipment type from which they derive, unless a valid parent-child relationship is defined explicitly for them. Additional parent-child relationships can be defined explicitly for equipment types that otherwise derive their relationships from another type.
For example, if you define an equipment type named Drill that is derived from the Asset equipment type, then all parent-child relationships defined for the Asset type apply to the Drill type. If parent-child relationships are defined for Site-to-Line, and Line-to-Asset, then Drills follow the Line-to-Asset relationship and can be created as children of Lines. You can define an additional explicit Site-to-Drill parent-child relationship, which would then allow Drills to be created as children of Lines and of Sites, while Assets can still only be created as children of Lines.
|
Disabling or Deleting Equipment Relationship Definitions
Disabling or deleting an equipment relationship definition entry from an equipment relationship definition data table prevents any further relationships from being created between those particular parent and child equipment types:
If any existing equipment or equipment structure in a context no longer conforms to the valid relationships defined for the context, then the context-aware areas of ThingWorx Apps do not behave as expected.