Digital twin builder (preview) tutorial part 3: Define semantic relationships between entities

In this tutorial section, you use digital twin builder's contextualization feature to represent the relationships between the entities.

Create relationships

In the semantic canvas, follow these steps to create five relationships.

1. Create a relationship Distiller has MaintenanceRequest.

   1. Select Distiller in your entities list. Create a relationship by selecting either the Add relationship button, or ... to the right of the Distiller and then Add relationship from the overflow menu.

      

   2. For the First entity, keep Distiller and join on the DistillerId property.

   3. For the Second entity, select MaintenanceRequest and join on the EquipmentId property.

   4. For the Relationship name, enter has.

   5. For Select relationship type, select 1:N. This choice indicates that multiple maintenance requests can be held by a single distiller.

   6. Select Create.

      

   7. In the Scheduling section that appears beneath the relationship configuration, select Run now.

      

2. Create a relationship Technician performs MaintenanceRequest.

   1. Select Technician in your entities list and add a relationship.

   2. For the First entity, keep Technician and join on the TechnicianId property.

   3. For the Second entity, select MaintenanceRequest and join on the TechnicianId property.

   4. For the Relationship name, enter performs.

   5. For Select relationship type, select 1:N. This choice indicates that multiple maintenance requests can be serviced by a single technician.

   6. Select Create.

      

   7. In the Scheduling section that appears beneath the relationship configuration, select Run now.

3. Create a relationship Distiller isPartOf Process.

   1. Select Distiller in your entities list and add a relationship.
   2. For the First entity, keep Distiller and join on the SiteId property.
   3. For the Second entity, select Process and join on the SiteId property.
   4. For the Relationship name, enter isPartOf.
   5. For Select relationship type, select N:1. This choice indicates that many distillers can be involved in a single distillation process.
   6. Select Create.
   7. In the Scheduling section that appears beneath the relationship configuration, select Run now.

4. Create a relationship Reboiler isPartOf Process.

   1. Select Reboiler in your entities list and add a relationship.
   2. For the First entity, keep Reboiler and join on the SiteId property.
   3. For the Second entity, select Process and join on the SiteId property.
   4. For the Relationship name, select isPartOf.
   5. For Select relationship type, select N:1. This choice indicates that many reboilers can be involved in a single distillation process.
   6. Select Create.
   7. In the Scheduling section that appears beneath the relationship configuration, select Run now.

5. Create a relationship Condenser isPartOf Process.

   1. Select Condenser in your entities list and add a relationship.
   2. For the First entity, keep Condenser and join on the SiteId property.
   3. For the Second entity, select Process and join on the SiteId property.
   4. For the Relationship name, select isPartOf.
   5. For Select relationship type, select N:1. This choice indicates that many condensers can be involved in a single distillation process.
   6. Select Create.
   7. In the Scheduling section that appears beneath the relationship configuration, select Run now.

Here's a representation of all the relationships that were created in this section. Sections of this diagram are visible from the semantic canvas, centered around each entity.

Check the status of your contextualization

Now that all the relationships are added, check the status of the contextualization operations to verify that they completed successfully.

Select the Manage operations button.

The Manage operations tab shows a list of your operations alongside their status. Look for the Contextualization type operations to verify their status.

Wait for all mappings to complete before you move on to the next part of the tutorial.

Next step