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.
Inheriting Relationships for Derived Types
Equipment types that derive from another equipment type follow all the relationships defined for the equipment type from which they derive. Additional parent-child relationships can be defined explicitly for equipment types that derive their relationships from another type.
Consider the following example scenario:
• A new equipment type named Drill is defined, which is derived from the Asset equipment type. Because Drill is derived from Asset, all parent-child relationships that are defined for the Asset type also apply to the Drill type.
• The parent-child relationships that are defined are: Site-to-Line and Line-to-Asset.
• The Line-to-Asset relationship applies to Drills. As a result, Drills can be created as children of Lines, just as Assets can be created as children of Lines.
• You can define an additional explicit Site-to-Drill parent-child relationship. This allows Drills to be created as children of Lines and of Sites, while Assets can still only be created as children of Lines.
 |
The above scenario is simplified for example purposes. It does not represent the equipment relationships that are provided out-of-the-box with ThingWorx Apps.
|