Descripción de los modelos de objetos de Digital Twins y del grafo de inteligencia espacialUnderstand Digital Twins object models and spatial intelligence graph

Azure Digital Twins es un servicio IoT de Azure que mejora las representaciones virtuales completas de entornos físicos y dispositivos, sensores y personas asociados.Azure Digital Twins is an Azure IoT service that powers comprehensive virtual representations of physical environments and associated devices, sensors, and people. Mejora el desarrollo con la organización de los conceptos específicos de dominio en modelos útilesIt improves development by organizing domain-specific concepts into helpful models. que se encuentran dentro de un grafo de inteligencia espacial.The models are then situated within a spatial intelligence graph. Estos conceptos modelan fielmente las relaciones y las interacciones entre personas, espacios y dispositivos.Such concepts faithfully model the relationships and interactions between people, spaces, and devices.

Los modelos de objetos de Digital Twins describen conceptos específicos de dominio, categorías y propiedades.Digital Twins object models describe domain-specific concepts, categories, and properties. Los modelos los predefinen los usuarios, que quieren adaptar la solución a sus necesidades específicas.Models are predefined by users who want to tailor the solution to their specific needs. Combinados, estos modelos de objetos de Digital Twins predefinidos constituyen una ontología.Together, these predefined Digital Twins object models make up an ontology. La ontología de un edificio inteligente describe regiones, locales, plantas, oficinas, zonas, salas de reuniones y salas de pensar.A smart building's ontology describes regions, venues, floors, offices, zones, conference rooms, and focus rooms. Una cuadrícula de energía describe varias centrales eléctricas, subestaciones, recursos energéticos y clientes.An energy grid ontology describes various power stations, substations, energy resources, and customers. Con los modelos de objetos de Digital Twins y las ontologías, se pueden personalizar las necesidades y diversos escenarios.With Digital Twins object models and ontologies, diverse scenarios and needs can be customized.

Con los modelos de objetos de Digital Twins y la ontología preparados, puede rellenar un grafo espacial.With Digital Twins object models and an ontology in place, you can populate a spatial graph. Los grafos espaciales son representaciones virtuales de las muchas relaciones entre espacios, dispositivos y personas importantes para una solución de IoT.Spatial graphs are virtual representations of the many relationships between spaces, devices, and people that are relevant to an IoT solution. En este diagrama se muestra un ejemplo de un grafo espacial que usa una ontología de edificio inteligente.This diagram shows an example of a spatial graph that uses a smart building's ontology.

Creación de un grafo espacial con Digital Twins

El grafo espacial reúne los espacios, los dispositivos, los sensores y los usuarios.The spatial graph brings together spaces, devices, sensors, and users. Cada uno de ellos se vincula de forma que modele el mundo real.Each is linked together in a way that models the real world. En este ejemplo, el lugar 43 tiene cuatro pisos, cada uno con diferentes áreas.In this sample, venue 43 has four floors, each with many different areas. Los usuarios se relacionan con las estaciones de trabajo y se les concede acceso a partes del grafo.Users are associated with their workstations and given access to portions of the graph. Un administrador tiene derechos para realizar cambios en el grafo espacial, mientras que un visitante solo puede ver determinados datos del edificio.An administrator has the rights to make changes to the spatial graph, while a visitor has rights to only view certain building data.

Modelos de objetos de Digital TwinsDigital Twins object models

Los modelos de objetos de Digital Twins admiten estas categorías principales de objetos:Digital Twins object models support these main categories of objects:

  • Los espacios son ubicaciones físicas o virtuales, como Tenant, Customer, Region y Venue.Spaces are virtual or physical locations, for example, Tenant, Customer, Region, and Venue.
  • Los dispositivos son equipos físicos o virtuales, como AwesomeCompany Device y Raspberry Pi 3.Devices are virtual or physical pieces of equipment, for example, AwesomeCompany Device and Raspberry Pi 3.
  • Los sensores son objetos que detectan eventos, como AwesomeCompany Temperature Sensor y AwesomeCompany Presence Sensor.Sensors are objects that detect events, for example, AwesomeCompany Temperature Sensor and AwesomeCompany Presence Sensor.
  • Los usuarios identifican a los ocupantes y sus características.Users identify occupants and their characteristics.

Otras categorías de objetos son:Other categories of objects are:

  • Recursos: conectados a un espacio, suelen representar recursos de Azure que van a utilizar los objetos del grafo espacial, como IoTHub.Resources are attached to a space and typically represent Azure resources to be used by objects in the spatial graph, for example, IoTHub.
  • Los blobs están asociados a objetos (como espacios, dispositivos, sensores y usuarios).Blobs are attached to objects (such as spaces, devices, sensors, and users). Se usan como archivos con tipo MIME y metadatos, como maps, pictures y manuals.They're used as files with mime type and metadata, for example, maps, pictures, and manuals.
  • Tipos extendidos: enumeraciones extensibles que aumentan las entidades con características específicas, como SpaceType y SpaceSubtype.Extended types are extensible enumerations that augment entities with specific characteristics, for example SpaceType and SpaceSubtype.
  • Ontologías: representan un conjunto de tipos extendidos, como Default, Building, BACnet y EnergyGrid.Ontologies represent a set of extended types, for example, Default, Building, BACnet, and EnergyGrid.
  • Claves y valores de propiedad: características personalizadas de los usuarios, los dispositivos, los sensores y los espacios.Property keys and values are custom characteristics of spaces, devices, sensors, and users. Se pueden usar junto con las características integradas, por ejemplo, DeltaProcessingRefreshTime como clave y 10 como valor.They can be used along with built-in characteristics, for example, DeltaProcessingRefreshTime as key and 10 as value.
  • Roles: conjuntos de permisos asignados a los usuarios y los dispositivos en el grafo espacial, como Space Administrator, User Administrator y Device Administrator.Roles are sets of permissions assigned to users and devices in the spatial graph, for example, Space Administrator, User Administrator, and Device Administrator.
  • Las asignaciones de roles son la asociación entre un rol y un objeto en el gráfico espacial.Role assignments are the association between a role and an object in the spatial graph. Por ejemplo, un usuario o una entidad de servicio pueden tener permiso para administrar un espacio en el gráfico espacial.For example, a user or a service principal can be granted permission to manage a space in the spatial graph.
  • Almacenes de claves de seguridad: proporcionan las claves de seguridad para todos los dispositivos de la jerarquía bajo un objeto de espacio determinado con el fin de que el dispositivo se pueda comunicar con Digital Twins de manera segura.Security key stores provide the security keys for all devices in the hierarchy under a given space object to allow the device to securely communicate with Digital Twins.
  • Funciones definidas por el usuario (UDF): permiten el procesamiento de los datos de telemetría del sensor personalizable dentro del grafo espacial.User-defined functions (UDFs) allow customizable sensor telemetry processing within the spatial graph. Por ejemplo, una UDF puede hacer lo siguiente:For example, a UDF can:
    • Establecer un valor del sensor.Set a sensor value.
    • Realizar lógica personalizada en función de las lecturas de sensores y establecer la salida en un espacio.Perform custom logic based on sensor readings, and set the output to a space.
    • Asociar metadatos a un espacio.Attach metadata to a space.
    • Enviar notificaciones cuando se cumplen las condiciones predefinidas.Send notifications when predefined conditions are met. Actualmente, las UDF pueden escribirse en JavaScript.Currently, UDFs can be written in JavaScript.
  • Buscadores de coincidencias: objetos que determinan qué UDF se ejecuta para un mensaje de telemetría determinado.Matchers are objects that determine which UDFs are executed for a given telemetry message.
  • Puntos de conexión: ubicaciones donde pueden enrutarse los mensajes de telemetría y los eventos de Digital Twins, como Event Hub, Service Bus y Event Grid.Endpoints are the locations where telemetry messages and Digital Twins events can be routed, for example, Event Hub, Service Bus, and Event Grid.

Grafo de inteligencia espacialSpatial intelligence graph

Gráfico espacial: grafo jerárquico de los espacios, los dispositivos y las personas que se definen en el modelo de objetos de Digital Twins.Spatial graph is the hierarchical graph of spaces, devices, and people defined in the Digital Twins object model. El grafo espacial es compatible con la herencia, el filtrado, el recorrido, el escalado y la extensibilidad.The spatial graph supports inheritance, filtering, traversing, scalability, and extensibility. Los usuarios pueden administrar el grafo espacial e interactuar con él con una colección de API REST.You can manage and interact with your spatial graph with a collection of REST APIs.

Si implementa un servicio de Digital Twins en su suscripción, será el administrador global del nodo raíz.If you deploy a Digital Twins service in your subscription, you become the global administrator of the root node. De este modo, se le concede automáticamente acceso completo a la estructura completa.You're then automatically granted full access to the entire structure. Aprovisione los espacios en el grafo mediante Space API.Provision spaces in the graph by using the Space API. Aprovisione los servicios mediante los sensores y la API de dispositivos mediante la API de sensor.Provision services by using the Device API and sensors by using the Sensor API. También hay herramientas de código abierto disponibles para aprovisionar el grafo en bloque.Open source tools also are available to provision the graph in bulk.

Herencia del grafo.Graph inheritance. La herencia se aplica a los permisos y las propiedades que descienden de un nodo primario y a todos los nodos por debajo de este.Inheritance applies to the permissions and properties that descend from a parent node to all nodes beneath it. Por ejemplo, cuando se asigna un rol a un usuario en un nodo determinado, el usuario tiene los permisos de ese rol para el nodo especificado y todos los nodos debajo de él.For example, when a role is assigned to a user on a given node, the user has that role's permissions to the given node and every node below it. Todos los nodos debajo de ese nodo determinado heredarán las claves de propiedad y el tipo extendido definidos para él.Each property key and extended type defined for a given node is inherited by all the nodes beneath that node.

Filtrado del grafo.Graph filtering. El filtrado se usa para restringir los resultados de la solicitud.Filtering is used to narrow down request results. Puede filtrar por id., nombre, tipos, subtipos, espacio primario y espacios asociados.You can filter by IDs, name, types, subtypes, parent space, and associated spaces. También puede filtrar por tipos de datos de sensor, claves de propiedad y valores, traverse, minLevel, maxLevel, así como por otros parámetros de filtro de OData.You also can filter by sensor data types, property keys and values, traverse, minLevel, maxLevel, and other OData filter parameters.

Recorrido del grafo.Graph traversing. Puede recorrer el grafo espacial mediante su profundidad y amplitud.You can traverse the spatial graph through its depth and breadth. Recorra el grafo en profundidad de arriba a abajo o de abajo a arriba con los parámetros traverse, minLevel y maxLevel.For depth, traverse the graph top-down or bottom-up by using the parameters traverse, minLevel, and maxLevel. Recorra el grafo en amplitud para obtener nodos secundarios directamente conectados a un espacio primario o a uno de los secundarios.Traverse the graph to get sibling nodes directly attached to a parent space or one of its descendants for breadth. Al consultar un objeto, puede obtener todos los objetos relacionados con dicho objeto mediante el parámetro includes de GET API.When you query an object, you can get all related objects that have relationships to that object by using the includes parameter of the GET APIs.

Escalabilidad del grafo.Graph scalability. Digital Twins garantiza la escalabilidad del grafo para poder ocuparse de las cargas de trabajo del mundo real.Digital Twins guarantees graph scalability, so it can handle your real-world workloads. Digital Twins puede usarse para representar grandes carteras de bienes inmuebles, infraestructura, dispositivos, sensores, telemetría y mucho más.Digital Twins can be used to represent large portfolios of real estate, infrastructure, devices, sensors, telemetry, and more.

Extensibilidad del grafo.Graph extensibility. Use la extensibilidad para personalizar los modelos de objetos de Digital Twins subyacentes con nuevos tipos y ontologías.Use extensibility to customize the underlying Digital Twins object models with new types and ontologies. Los datos de Digital Twins también se pueden enriquecer con propiedades y valores extensibles.Your Digital Twins data also can be enriched with extensible properties and values.

API de administración del grafo con inteligencia espacialSpatial intelligence graph Management APIs

Después de implementar Digital Twins desde Azure Portal, se genera automáticamente la dirección URL del Swagger de las API de Administración.After you deploy Digital Twins from the Azure portal, the Swagger URL of the Management APIs is automatically generated. Se muestra en Azure Portal en la sección Introducción con el formato siguiente.It's displayed in the Azure portal in the Overview section with the following format.

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/swagger
NOMBREName Reemplazar porReplace with
YOUR_INSTANCE_NAMEYOUR_INSTANCE_NAME El nombre de la instancia de Digital Twins.The name of your Digital Twins instance
YOUR_LOCATIONYOUR_LOCATION La región de servidor en la que está hospedada la instanciaWhich server region your instance is hosted on

El formato de dirección URL completo que aparece en esta imagen.The full URL format appears in this image.

API de Administración del portal de Digital Twins

Para más detalles sobre cómo usar los grafos de inteligencia espacial, consulte la versión preliminar de las API de Administración de Azure Digital Twins.For more details on how to use spatial intelligence graphs, visit the Azure Digital Twins Management APIs sneak preview.

Sugerencia

Se proporciona un preestreno de Swagger para demostrar el conjunto de características de la API.A Swagger sneak preview is provided to demonstrate the API feature set. Se hospeda en docs.westcentralus.azuresmartspaces.net/management/swagger.It's hosted at docs.westcentralus.azuresmartspaces.net/management/swagger.

Más información sobre cómo usar Swagger.Learn more about how to use Swagger.

Todas las llamadas a API se deben autenticar mediante OAuth.All API calls must be authenticated by using OAuth. Las API siguen las convenciones de las directrices de API REST de Microsoft.The APIs follow Microsoft REST API Guidelines conventions. La mayoría de las API que devuelven colecciones admiten opciones de consulta del sistema de OData.Most of the APIs that return collections support OData system query options.

Pasos siguientesNext steps