Condividi tramite

Comprendere i modelli a oggetti dei Gemelli Digitali e il grafico dell'intelligenza spaziale

Importante

È stata rilasciata una nuova versione del servizio Gemelli digitali di Azure. Alla luce delle funzionalità espanse del nuovo servizio, il servizio Gemelli digitali di Azure originale (descritto in questo set di documentazione) è stato ritirato.

Per visualizzare la documentazione per il nuovo servizio, visitare la documentazione attiva di Azure Digital Twins.

Gemelli digitali di Azure è un servizio Azure IoT che supporta rappresentazioni virtuali complete di ambienti fisici e dispositivi, sensori e persone associati. Migliora lo sviluppo organizzando concetti specifici del dominio in modelli utili. I modelli vengono quindi posizionati all'interno di un grafico di intelligenza spaziale. Questi concetti modellano fedelmente le relazioni e le interazioni tra persone, spazi e dispositivi.

I modelli a oggetti di Gemelli digitali descrivono concetti, categorie e proprietà specifici del dominio. I modelli sono predefiniti dagli utenti che vogliono personalizzare la soluzione in base alle esigenze specifiche. Insieme, questi modelli a oggetti predefiniti di Gemelli digitali costituiscono un' ontologia. L'ontologia di un edificio intelligente descrive aree, sedi, piani, uffici, zone, sale riunioni e sale di concentrazione. Un'ontologia della rete energetica descrive varie centrali elettriche, sottostazioni, risorse energetiche e clienti. Con modelli a oggetti e onlogi di Gemelli digitali, è possibile personalizzare diversi scenari e esigenze.

Con modelli a oggetti di gemelli digitali e un'ontologia implementata, è possibile popolare un grafo spaziale . I grafici spaziali sono rappresentazioni virtuali delle numerose relazioni tra spazi, dispositivi e persone rilevanti per una soluzione IoT. Questo diagramma mostra un esempio di grafico spaziale che usa l'ontologia di un edificio intelligente.

grafo spaziale di Gemelli digitali

Il grafico spaziale riunisce spazi, dispositivi, sensori e utenti. Ognuno è collegato in modo che modella il mondo reale. In questo esempio, la sede 43 ha quattro piani, ognuno con molte aree diverse. Gli utenti sono associati alle loro workstation e hanno accesso a parti del grafico. Un amministratore ha i diritti per apportare modifiche al grafico spaziale, mentre un visitatore dispone dei diritti per visualizzare solo determinati dati di costruzione.

Modelli di oggetti di gemelli digitali

I modelli a oggetti di Gemelli digitali supportano queste categorie principali di oggetti:

  • Spaces sono posizioni virtuali o fisiche, ad esempio Tenant, Customer, Regione Venue.
  • i dispositivi sono dispositivi virtuali o fisici, ad esempio AwesomeCompany Device e Raspberry Pi 3.
  • Sensori sono oggetti che rilevano eventi, ad esempio AwesomeCompany Temperature Sensor e AwesomeCompany Presence Sensor.
  • Utenti identificano gli occupanti e le relative caratteristiche.

Altre categorie di oggetti sono:

  • le risorse sono collegate a uno spazio e in genere rappresentano le risorse di Azure da usare dagli oggetti nel grafico spaziale, ad esempio IoTHub.
  • i BLOB sono collegati a oggetti , ad esempio spazi, dispositivi, sensori e utenti. Vengono usati come file con tipo mime e metadati, ad esempio maps, picturese manuals.
  • tipi estesi sono enumerazioni estendibili che aumentano le entità con caratteristiche specifiche, ad esempio SpaceType e SpaceSubtype.
  • gli onlogi rappresentano un set di tipi estesi, ad esempio Default, Building, BACnete EnergyGrid.
  • le chiavi e i valori delle proprietà sono caratteristiche personalizzate di spazi, dispositivi, sensori e utenti. Possono essere usati insieme alle caratteristiche predefinite, ad esempio DeltaProcessingRefreshTime come chiave e 10 come valore.
  • Ruoli sono set di autorizzazioni assegnate a utenti e dispositivi nel grafico spaziale, ad esempio Space Administrator, User Administratore Device Administrator.
  • le assegnazioni di ruolo sono l'associazione tra un ruolo e un oggetto nel grafico spaziale. È ad esempio possibile concedere a un utente o a un'entità servizio l'autorizzazione per gestire uno spazio nel grafico spaziale.
  • I depositi di chiavi di sicurezza forniscono le chiavi di sicurezza per tutti i dispositivi nella gerarchia di un determinato oggetto spaziale per consentire al dispositivo di comunicare in modo sicuro con i Gemelli Digitali.
  • funzioni definite dall'utente (UDF) consentono l'elaborazione personalizzabile dei dati di telemetria dei sensori all'interno del grafico spaziale. Ad esempio, una funzione definita dall'utente può:
    • Impostare un valore del sensore.
    • Eseguire una logica personalizzata basata sui dati dei sensori e impostare l'output su un'area.
    • Allegare i metadati a uno spazio.
    • Inviare notifiche quando vengono soddisfatte condizioni predefinite. Attualmente, le funzioni definite dall'utente possono essere scritte in JavaScript.
  • Matcher sono oggetti che determinano quali UDF (funzioni definite dall'utente) vengono eseguite per un determinato messaggio di telemetria.
  • gli endpoint sono le posizioni in cui è possibile instradare i messaggi di telemetria e gli eventi Digital Twins, ad esempio Event Hub, Service Buse Event Grid.

Grafico di intelligenza spaziale

Il grafico spaziale è il grafico gerarchico di spazi, dispositivi e persone definiti nel modello a oggetti di Gemelli digitali. Il grafico spaziale supporta ereditarietà, filtro, attraversamento, scalabilità ed estendibilità. È possibile gestire e interagire con il grafico spaziale con una raccolta di API REST.

Se si distribuisce un servizio Gemelli digitali nella sottoscrizione, si diventa l'amministratore globale del nodo radice. Viene quindi concesso automaticamente l'accesso completo all'intera struttura. Distribuire gli spazi nel grafo usando l'API Space. Erogare i servizi utilizzando l'API del dispositivo e i sensori utilizzando l'API dei sensori. strumenti open source sono anche disponibili per fornire il grafico in grandi quantità.

ereditarietà del Grafico. L'ereditarietà si applica alle autorizzazioni e alle proprietà che derivano da un nodo padre a tutti i nodi sottostanti. Ad esempio, quando un ruolo viene assegnato a un utente in un determinato nodo, l'utente ha le autorizzazioni del ruolo per il nodo specificato e ogni nodo sottostante. Ogni chiave di proprietà e tipo esteso definito per un determinato nodo viene ereditata da tutti i nodi sotto tale nodo.

filtro grafico. Il filtro viene usato per limitare i risultati delle richieste. È possibile filtrare in base a ID, nome, tipi, sottotipi, spazio padre e spazi associati. È anche possibile filtrare in base a tipi di dati del sensore, chiavi e valori delle proprietà, attraversare, minLevel, maxLevele altri parametri di filtro OData.

Attraversamento di un grafo. È possibile esplorare il grafo spaziale in profondità e in ampiezza. Per la profondità, percorre il grafo dall'alto verso il basso o dal basso verso l'alto utilizzando i parametri attraversare, minLevele maxLevel. Attraversa il grafo per ottenere nodi fratelli direttamente collegati a uno spazio padre o a uno dei suoi discendenti in ampiezza. Quando si esegue una query su un oggetto, è possibile ottenere tutti gli oggetti correlati con relazioni con tale oggetto usando il include parametro delle API GET.

Scalabilità di Graph. I Gemelli digitali garantiscono la scalabilità del grafo, in modo che possa sostenere i carichi di lavoro reali. Gemelli digitali possono essere usati per rappresentare un grande portafoglio di immobili, infrastrutture, dispositivi, sensori, dati di telemetria e altro ancora.

estensibilità del grafico. Usare l'estendibilità per personalizzare i modelli a oggetti dei Gemelli digitali sottostanti con nuovi tipi e ontologie. I dati di Gemelli digitali possono anche essere arricchiti con proprietà e valori estendibili.

API di gestione dei gragrafi di intelligenza spaziale

Dopo aver distribuito Digital Twins dal portale di Azure , l'URL Swagger delle API di gestione viene generato automaticamente. Viene visualizzato nel portale di Azure nella sezione Panoramica con il formato seguente.

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/swagger
Nome Sostituire con
NOME_DELLA_TUA_ISTANZA Nome dell'istanza di Gemelli digitali
LA_TUA_POSIZIONE Area del server in cui è ospitata l'istanza

Il formato url completo viene visualizzato in questa immagine.

API di gestione del portale dei Gemelli digitali

Per altre informazioni su come usare i grafici di intelligenza spaziale, vedere l'anteprima delle API di gestione di Gemelli digitali di Azure.

Suggerimento

Viene fornita un'anteprima sneak di Swagger per illustrare il set di funzionalità api. È ospitato in docs.westcentralus.azuresmartspaces.net/management/swagger.

Altre informazioni su come usare Swagger.

Tutte le chiamate API devono essere autenticate usando OAuth. Le API seguono convenzioni delle linee guida dell'API REST Microsoft. La maggior parte delle API che restituiscono raccolte supportano opzioni di query di sistema OData.

Passaggi successivi

  • Last updated on