Digitale tweelingen en hun tweelinggrafiek

In dit artikel wordt beschreven wat digitale tweelingen zijn in de context van Azure Digital Twins en hoe relaties ertussen een tweelinggrafiek kunnen vormen. In een Azure Digital Twins oplossing worden de entiteiten in uw omgeving vertegenwoordigd door digitale tweelingen. Een digitale tweeling is een exemplaar van een van uw aangepaste gedefinieerde modellen. Het kan worden verbonden met andere digitale tweelingen via relaties om een tweelinggrafiek te vormen: deze tweelinggrafiek is de weergave van uw hele omgeving.

Digitale tweelingen

Voordat u een digitale tweeling in uw Azure Digital Twins maken, moet u een model uploaden naar de service. Een model beschrijft onder andere de set eigenschappen, telemetrieberichten en relaties die een bepaalde tweeling kan hebben. Zie Aangepaste modellen voor de typen informatie die in een model zijn gedefinieerd.

Nadat u een model hebt gemaakt en geüpload, kan uw client-app een exemplaar van het type maken. Dit exemplaar is een digitale tweeling. Nadat u bijvoorbeeld een model van Floor hebt gemaakt, kunt u een of meer digitale tweelingen maken die gebruikmaken van dit type (zoals een tweeling van het type Floor met de naam Ground Floor Floor, een andere met de naam Floor2, etc.).

Relaties: een grafiek van digitale tweelingen

Tweelingen zijn via hun relaties verbonden met een tweelinggrafiek. De relaties die een tweeling kan hebben, worden gedefinieerd als onderdeel van het model.

Het model Floor kan bijvoorbeeld een bevatrelatie definiëren die gericht is op tweelingen van het type Room. Met deze definitie kunt Azure Digital Twins u bevatrelaties maken van elke Floor-tweeling naar elke Room-tweeling (inclusief tweelingen die van room-subtypen zijn).

Het resultaat van dit proces is een set knooppunten (de digitale tweelingen) die zijn verbonden via randen (hun relaties) in een grafiek.

Visualisatie

Azure Digital Twins Explorer is een visueel hulpprogramma voor het verkennen van de gegevens in Azure Digital Twins grafiek. U kunt de verkenner gebruiken om uw modellen, tweelingen en relaties weer te geven, op te vragen en te bewerken.

Zie voor meer informatie over Azure Digital Twins Explorer hulpprogramma Azure Digital Twins Explorer. Zie Use Azure Digital Twins Explorer voor gedetailleerde stappen voor het gebruik Azure Digital Twins Explorer.

De visualisatie ziet er als volgende uit:

Maken met de API's

In deze sectie ziet u hoe het eruitziet om digitale tweelingen en relaties te maken vanuit een clienttoepassing. Het bevat .NET-codevoorbeelden die gebruikmaken van de DigitalTwins-API'som meer context te bieden over wat er binnen elk van deze concepten gebeurt.

Digitale tweelingen maken

Hieronder vindt u een fragment van clientcode dat gebruikmaakt van de DigitalTwins-API's om een dubbel van het type Room te maken met een die is gedefinieerd tijdens het twinId instantiëring.

U kunt de eigenschappen van een tweeling initialiseren wanneer deze wordt gemaakt of later instellen. Als u een tweeling met geitialiseerde eigenschappen wilt maken, maakt u een JSON-document met de benodigde initialisatiewaarden.

// Define a custom model type for the twin to be created

internal class CustomDigitalTwin
{
    [JsonPropertyName(DigitalTwinsJsonPropertyNames.DigitalTwinId)]
    public string Id { get; set; }

    [JsonPropertyName(DigitalTwinsJsonPropertyNames.DigitalTwinETag)]
    public string ETag { get; set; }

    [JsonPropertyName(DigitalTwinsJsonPropertyNames.DigitalTwinMetadata)]
    public MyCustomDigitalTwinMetadata Metadata { get; set; } = new MyCustomDigitalTwinMetadata();

    [JsonPropertyName("temperature")]
    public double Temperature { get; set; }

    [JsonPropertyName("humidity")]
    public double Humidity{ get; set; }
}

internal class MyCustomDigitalTwinMetadata
{
    [JsonPropertyName(DigitalTwinsJsonPropertyNames.MetadataModel)]
    public string ModelId { get; set; }

    [JsonPropertyName("temperature")]
    public DigitalTwinPropertyMetadata Temperature { get; set; }

    [JsonPropertyName("humidity")]
    public DigitalTwinPropertyMetadata Humidity { get; set; }
}

// Initialize properties and create the twin
public class TwinOperationsCreateTwin
{
    public async Task CreateTwinAsync(DigitalTwinsClient client)
    {
        // Initialize the twin properties
        var myTwin = new CustomDigitalTwin
        {
            Metadata = { ModelId = "dtmi:example:Room;1" },
            Temperature = 25.0,
            Humidity = 50.0,
        };

        // Create the twin
        const string twinId = "<twin-ID>";
        Response<CustomDigitalTwin> response = await client.CreateOrReplaceDigitalTwinAsync(twinId, myTwin);
        Console.WriteLine($"Temperature last updated on {response.Value.Metadata.Temperature.LastUpdatedOn}");
    }
}

U kunt ook een helperklasse met de naam gebruiken om eigenschapsvelden rechtstreekser op te slaan in een dubbelobject, als alternatief voor het BasicDigitalTwin gebruik van een woordenlijst. Zie de sectie Een digitale tweeling maken van How-to: Manage digital twins(Een digitale tweeling maken: digitale tweelingen beheren) voor meer informatie over de helperklasse en voorbeelden van het gebruik ervan.

Relaties maken

Hier volgen enkele voorbeeldclientcodes die gebruikmaakt van de DigitalTwins-API's om een relatie te bouwen van de ene digitale tweeling (de 'bron'-tweeling) naar een andere digitale tweeling (de 'doel'-tweeling).

var rel = new BasicRelationship
{
    TargetId = "myTargetTwin",
    Name = "contains", // a relationship with this name must be defined in the model
    // Initialize properties
    Properties =
    {
        { "active", true },
    },
};
await client.CreateOrReplaceRelationshipAsync("mySourceTwin", "rel001", rel);

JSON-weergaven van grafiekelementen

Gegevens van digitale tweelingen en relatiegegevens worden beide opgeslagen in JSON-indeling, wat betekent dat wanneer u een query uitvoert op de tweelinggrafiek in uw Azure Digital Twins-exemplaar, het resultaat een JSON-weergave is van digitale tweelingen en relaties die u hebt gemaakt.

JSON-indeling van digitale tweeling

Wanneer een digitale tweeling wordt weergegeven als een JSON-object, worden de volgende velden weergegeven:

Hier is een voorbeeld van een digitale tweeling die is opgemaakt als een JSON-object:

{
  "$dtId": "Cafe",
  "$etag": "W/\"e59ce8f5-03c0-4356-aea9-249ecbdc07f9\"",
  "Temperature": 72,
  "Location": {
    "x": 101,
    "y": 33
  },
  "component": {
    "TableOccupancy": 1,
    "$metadata": {
      "TableOccupancy": {
        "desiredValue": 1,
        "desiredVersion": 3,
        "ackVersion": 2,
        "ackCode": 200,
        "ackDescription": "OK"
      }
    }
  },
  "$metadata": {
    "$model": "dtmi:com:contoso:Room;1",
    "Temperature": {
      "desiredValue": 72,
      "desiredVersion": 5,
      "ackVersion": 4,
      "ackCode": 200,
      "ackDescription": "OK"
    },
    "Location": {
      "desiredValue": {
        "x": 101,
        "y": 33,
      },
      "desiredVersion": 8,
      "ackVersion": 8,
      "ackCode": 200,
      "ackDescription": "OK"
    }
  }
}

JSON-indeling relatie

Wanneer een relatie van een digitale tweeling wordt weergegeven als een JSON-object, worden de volgende velden weergegeven:

Hier is een voorbeeld van een relatie die is opgemaakt als een JSON-object:

{
  "$relationshipId": "relationship-01",
  "$etag": "W/\"506e8391-2b21-4ac9-bca3-53e6620f6a90\"",
  "$sourceId": "GroundFloor",
  "$targetId": "Cafe",
  "$relationshipName": "contains",
  "startDate": "2020-02-04"
}

Volgende stappen

Zie grafiekelementen beheren met Azure Digital Twin-API's:

• Digitale tweelingen beheren
• De tweelinggrafiek en relaties beheren

Of meer informatie over het uitvoeren van query's op Azure Digital Twins tweelinggrafiek voor informatie:

• Querytaal