Inzicht in Digital Twins-objectmodellen en ruimtelijke intelligentiegrafiek

Belangrijk

Er is een nieuwe versie van de Azure Digital Twins-service uitgebracht. In het licht van de uitgebreide mogelijkheden van de nieuwe service is de oorspronkelijke Azure Digital Twins-service (beschreven in deze documentatieset) buiten gebruik gesteld.

Als u de documentatie voor de nieuwe service wilt bekijken, gaat u naar de actieve Documentatie voor Azure Digital Twins.

Azure Digital Twins is een Azure IoT-service die uitgebreide virtuele weergaven van fysieke omgevingen en bijbehorende apparaten, sensoren en personen mogelijk maakt. Het verbetert de ontwikkeling door domeinspecifieke concepten in nuttige modellen te organiseren. De modellen bevinden zich vervolgens in een grafiek met ruimtelijke intelligentie. Dergelijke concepten modelleren de relaties en interacties tussen personen, ruimten en apparaten getrouw.

Digital Twins-objectmodellen beschrijven domeinspecifieke concepten, categorieën en eigenschappen. Modellen zijn vooraf gedefinieerd door gebruikers die de oplossing willen aanpassen aan hun specifieke behoeften. Samen vormen deze vooraf gedefinieerde Digital Twins-objectmodellen een ontologie. De ontologie van een slim gebouw beschrijft regio's, locaties, verdiepingen, kantoren, zones, vergaderruimten en focusruimten. Een energienetonologie beschrijft verschillende energiecentrales, substations, energiebronnen en klanten. Met Digital Twins-objectmodellen en ontologieën kunnen diverse scenario's en behoeften worden aangepast.

Met Digital Twins-objectmodellen en een ontologie kunt u een ruimtelijke grafiek vullen. Ruimtelijke grafieken zijn virtuele weergaven van de vele relaties tussen ruimten, apparaten en personen die relevant zijn voor een IoT-oplossing. In dit diagram ziet u een voorbeeld van een ruimtelijke grafiek die gebruikmaakt van de ontologie van een slim gebouw.

De ruimtelijke grafiek brengt ruimten, apparaten, sensoren en gebruikers samen. Elk is gekoppeld op een manier die de echte wereld modelleert. In dit voorbeeld heeft locatie 43 vier verdiepingen, elk met veel verschillende gebieden. Gebruikers zijn gekoppeld aan hun werkstations en krijgen toegang tot delen van de grafiek. Een beheerder heeft de rechten om wijzigingen aan te brengen in de ruimtelijke grafiek, terwijl een bezoeker rechten heeft om alleen bepaalde gebouwgegevens te bekijken.

Digital Twins-objectmodellen

Digital Twins-objectmodellen ondersteunen deze hoofdcategorieën van objecten:

• Spaties zijn virtuele of fysieke locaties, bijvoorbeeld, TenantCustomer, Regionen Venue.
• Apparaten zijn virtuele of fysieke apparatuurstukken, bijvoorbeeld AwesomeCompany Device en Raspberry Pi 3.
• Sensoren zijn objecten die gebeurtenissen detecteren, bijvoorbeeld AwesomeCompany Temperature Sensor en AwesomeCompany Presence Sensor.
• Gebruikers identificeren bewoners en hun kenmerken.

Andere categorieën objecten zijn:

• Resources worden gekoppeld aan een ruimte en vertegenwoordigen doorgaans Azure-resources die moeten worden gebruikt door objecten in de ruimtelijke grafiek, bijvoorbeeld IoTHub.
• Blobs worden gekoppeld aan objecten (zoals ruimten, apparaten, sensoren en gebruikers). Ze worden gebruikt als bestanden met mime-type en metagegevens, bijvoorbeeld maps, picturesen manuals.
• Uitgebreide typen zijn uitbreidbare opsommingen waarmee entiteiten worden uitgebreid met specifieke kenmerken, bijvoorbeeld SpaceType en SpaceSubtype.
• Ontologieën vertegenwoordigen een reeks uitgebreide typen, bijvoorbeeld, DefaultBuilding, BACneten EnergyGrid.
• Eigenschapssleutels en -waarden zijn aangepaste kenmerken van ruimten, apparaten, sensoren en gebruikers. Ze kunnen samen met ingebouwde kenmerken worden gebruikt, bijvoorbeeld DeltaProcessingRefreshTime als sleutel en 10 als waarde.
• Rollen zijn sets machtigingen die zijn toegewezen aan gebruikers en apparaten in de ruimtelijke grafiek, bijvoorbeeld Space Administrator, User Administratoren Device Administrator.
• Roltoewijzingen zijn de koppeling tussen een rol en een object in de ruimtelijke grafiek. Een gebruiker of service-principal kan bijvoorbeeld toestemming krijgen om een ruimte in de ruimtelijke grafiek te beheren.
• Beveiligingssleutelarchieven bieden de beveiligingssleutels voor alle apparaten in de hiërarchie onder een bepaald ruimteobject, zodat het apparaat veilig kan communiceren met Digital Twins.
• Door de gebruiker gedefinieerde functies (UDF's) maken aanpasbare sensortelemetrieverwerking mogelijk in de ruimtelijke grafiek. Een UDF kan bijvoorbeeld het volgende doen:
  • Stel een sensorwaarde in.
  • Voer aangepaste logica uit op basis van sensorleesbewerkingen en stel de uitvoer in op een ruimte.
  • Voeg metagegevens toe aan een spatie.
  • Meldingen verzenden wanneer aan vooraf gedefinieerde voorwaarden wordt voldaan. Op dit moment kunnen UDF's worden geschreven in JavaScript.
• Matchers zijn objecten die bepalen welke UDF's worden uitgevoerd voor een bepaald telemetriebericht.
• Eindpunten zijn de locaties waar telemetrieberichten en Digital Twins-gebeurtenissen kunnen worden gerouteerd, bijvoorbeeld Event Hub, Service Busen Event Grid.

Grafiek voor ruimtelijke intelligentie

Ruimtelijke grafiek is de hiërarchische grafiek van ruimten, apparaten en personen die zijn gedefinieerd in het Digital Twins-objectmodel. De ruimtelijke grafiek ondersteunt overname, filteren, doorkruisen, schaalbaarheid en uitbreidbaarheid. U kunt uw ruimtelijke grafiek beheren en gebruiken met een verzameling REST API's.

Als u een Digital Twins-service in uw abonnement implementeert, wordt u de globale beheerder van het hoofdknooppunt. Vervolgens krijgt u automatisch volledige toegang tot de hele structuur. Richt spaties in de grafiek in met behulp van de Space-API. Services inrichten met behulp van de Apparaat-API en sensoren met behulp van de Sensor-API. Opensource-hulpprogramma's zijn ook beschikbaar om de grafiek bulksgewijs in te richten.

Grafiekovername. Overname is van toepassing op de machtigingen en eigenschappen die afdalen van een bovenliggend knooppunt naar alle knooppunten eronder. Wanneer een rol bijvoorbeeld wordt toegewezen aan een gebruiker op een bepaald knooppunt, heeft de gebruiker de machtigingen van die rol voor het opgegeven knooppunt en elk knooppunt eronder. Elke eigenschapssleutel en het uitgebreide type dat is gedefinieerd voor een bepaald knooppunt, worden overgenomen door alle knooppunten onder dat knooppunt.

Grafiekfiltering. Filteren wordt gebruikt om de aanvraagresultaten te beperken. U kunt filteren op id's, naam, typen, subtypen, bovenliggende ruimte en bijbehorende spaties. U kunt ook filteren op sensorgegevenstypen, eigenschapssleutels en -waarden, doorkruisen, minLevel, maxLevel en andere OData-filterparameters.

Grafiek doorkruisen. U kunt de ruimtelijke grafiek doorlopen door de diepte en breedte. Voor diepte doorkruist u de grafiek van boven naar beneden of onderaan met behulp van de parameters doorkruisen, minLevel en maxLevel. Doorkruis de grafiek om knooppunten op te halen die rechtstreeks zijn gekoppeld aan een bovenliggende ruimte of een van de onderliggende knooppunten voor breedte. Wanneer u een query uitvoert op een object, kunt u alle gerelateerde objecten ophalen die relaties met dat object hebben met behulp van de insluitingsparameter van de GET-API's.

Schaalbaarheid van grafieken. Digital Twins garandeert schaalbaarheid van grafieken, zodat deze uw echte workloads kan verwerken. Digital Twins kan worden gebruikt om grote portfolio's van onroerend goed, infrastructuur, apparaten, sensoren, telemetrie en meer te vertegenwoordigen.

Uitbreidbaarheid van grafieken. Gebruik uitbreidbaarheid om de onderliggende Digital Twins-objectmodellen aan te passen met nieuwe typen en ontologieën. Uw Digital Twins-gegevens kunnen ook worden verrijkt met uitbreidbare eigenschappen en waarden.

Beheer-API's voor ruimtelijke intelligentie

Nadat u Digital Twins hebt geïmplementeerd vanuit de Azure Portal, wordt de Swagger-URL van de Beheer-API's automatisch gegenereerd. Deze wordt weergegeven in de Azure Portal in de sectie Overzicht met de volgende indeling.

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/swagger

Naam	Vervangen door
YOUR_INSTANCE_NAME	De naam van uw Digital Twins-exemplaar
YOUR_LOCATION	De serverregio waarin het exemplaar wordt gehost

De volledige URL-indeling wordt weergegeven in deze afbeelding.

Ga naar de preview-preview van azure Digital Twins Management-API's voor meer informatie over het gebruik van grafieken voor ruimtelijke intelligentie.

Tip

Er wordt een Swagger sneak preview gegeven om de API-functieset te demonstreren. Het wordt gehost op docs.westcentralus.azuresmartspaces.net/management/swagger.

Meer informatie over het gebruik van Swagger.

Alle API-aanroepen moeten worden geverifieerd met behulp van OAuth. De API's volgen de richtlijnen voor Microsoft REST API's. De meeste API's die verzamelingen retourneren, ondersteunen OData-systeemqueryopties.

Volgende stappen

• Lees voor meer informatie over apparaatconnectiviteit en het verzenden van telemetrieberichten naar Digital Twins de connectiviteit en telemetrie van Azure Digital Twins.

• Lees azure Digital Twins API-beheer en -beperkingen voor meer informatie over beperkingen en beperkingen voor beheer-API's.