Tutorial: Implementación de la versión preliminar de Azure Digital Twins y configuración de un grafo espacialTutorial: Deploy Azure Digital Twins Preview and configure a spatial graph

Puede usar el servicio en versión preliminar de Azure Digital Twins para reunir personas, lugares y dispositivos en un sistema espacial coherente.You can use the Azure Digital Twins Preview service to bring together people, places, and devices in a coherent spatial system. En esta serie de tutoriales se muestra cómo usar Azure Digital Twins para detectar la ocupación de salas con condiciones óptimas de temperatura y calidad del aire.This series of tutorials demonstrates how to use Azure Digital Twins to detect room occupancy with optimal conditions of temperature and air quality.

Estos tutoriales le guían a través de una aplicación de consola .NET para crear un escenario de un edificio de oficinas.These tutorials will walk you through a .NET console application to build a scenario of an office building. El edificio tiene varias plantas y salas dentro de cada planta.The building has multiple floors and rooms within each floor. Las salas contienen dispositivos, con sensores conectados, que detectan movimiento, la temperatura ambiente y la calidad del aire.The rooms contain devices with attached sensors that detect motion, ambient temperature, and air quality.

Aprenderá a replicar las entidades y áreas físicas del edificio como objetos digitales mediante el servicio Azure Digital Twins.You'll learn how to replicate the physical areas and entities in the building as digital objects by using the Azure Digital Twins service. Simulará los eventos de los dispositivos mediante otra aplicación de consola.You'll simulate device events by using another console application. Luego, aprenderá a supervisar los eventos procedentes de estas entidades y áreas físicas casi en tiempo real.Then, you'll learn how to monitor the events that come from these physical areas and entities in near real time.

Los administradores de las oficinas pueden usar esta información para ayudar a los empleados que trabajan en el edificio a reservar salas de reuniones con condiciones óptimas.An office administrator can use this information to help an employee working in this building to book meeting rooms with optimal conditions. Los administradores de las instalaciones de oficina pueden usar su configuración para averiguar las tendencias de uso de las salas, y para supervisar las condiciones laborales, con el fin de ajustar el mantenimiento.An office facilities manager can use your setup to get usage trends of the rooms, and to monitor working conditions for maintenance purposes.

En el primer tutorial de esta serie, aprenderá a:In the first tutorial of this series, you learn how to:

  • Implementar Digital TwinsDeploy Digital Twins.
  • Conceder permisos a una aplicaciónGrant permissions to your app.
  • Modificar una aplicación de ejemplo de Digital TwinsModify a Digital Twins sample app.
  • Aprovisionar un edificioProvision your building.

Estos tutoriales utilizan y modifican los mismos ejemplos que usa la guía de inicio rápido para buscar salas disponibles para proporcionar una cobertura más detallada y exhaustiva de los conceptos.These tutorials use and modify the same samples that the quickstart to find available rooms uses, for a more detailed and in-depth coverage of the concepts.

PrerrequisitosPrerequisites

  • Suscripción a Azure.An Azure subscription. Si no tiene una cuenta de Azure, cree una cuenta gratuita.If you don’t have an Azure account, create a free account.

  • SDK de .NET Core.The .NET Core SDK. Los ejemplos de Azure Digital Twins usados en estos tutoriales están escritos en C#.The Azure Digital Twins samples used in these tutorials are written in C#. Para compilar y ejecutar el ejemplo, asegúrese de instalar la versión 2.1.403 del SDK de .NET Core, o cualquier versión superior en la máquina de desarrollo.Make sure to install .NET Core SDK version 2.1.403 or later on your development machine to build and run the sample. Para comprobar que está instalada la versión correcta en la máquina, ejecute dotnet --version en una ventana de comandos.Check that the right version is installed on your machine by running dotnet --version in a command window.

  • Tiene Visual Studio Code para explorar el código de ejemplo.Visual Studio Code to explore the sample code.

Implementar Digital TwinsDeploy Digital Twins

Use los pasos de esta sección para crear una nueva instancia del servicio Azure Digital Twins.Use the steps in this section to create a new instance of the Azure Digital Twins service. Solo se puede crear una instancia por suscripción.Only one instance can be created per subscription. Si ya tiene una en ejecución, vaya a la siguiente sección.Skip to the next section if you already have one running.

  1. Inicie sesión en Azure Portal.Sign in to the Azure portal.

  2. Seleccione la barra lateral principal, después + Crear un recurso.Select the home side-bar, then + Create a resource.

    Seleccione la barra lateral principal, después + Crear un recursoExpand the home side-bar, then select + Create a resource

  3. Busque Digital Twins y seleccione Digital Twins.Search for Digital Twins, and select Digital Twins.

    Selecciones para crear una nueva instancia de Digital TwinsSelections for creating a new Digital Twins instance

    Como alternativa, seleccione Internet de las cosasy seleccione Digital Twins(versión preliminar) .Alternatively, select Internet of Things, and select Digital Twins (preview).

  4. Haga clic en Crear para iniciar el proceso de implementación.Select Create to start the deployment process.

    Crear y confirmar la implementación del recursoCreate and confirm the deployment of the resource

  5. En el panel Digital Twins, escriba la siguiente información:In the Digital Twins pane, enter the following information:

    • Nombre del recurso: cree un nombre único para la instancia de Digital Twins.Resource Name: Create a unique name for your Digital Twins instance.

    • Suscripción: elija la suscripción que quiere usar para crear esta instancia de Digital Twins.Subscription: Choose the subscription that you want to use to create this Digital Twins instance.

    • Grupo de recursos: seleccione o cree un grupo de recursos para la instancia de Digital Twins.Resource group: Select or create a resource group for the Digital Twins instance.

    • Ubicación: seleccione la ubicación más cercana a sus dispositivos.Location: Select the closest location to your devices.

      Panel de Digital Twins en el que se ha especificado informaciónDigital Twins pane with entered information

  6. Revise la información de Digital Twins y, a continuación, seleccione Crear.Review your Digital Twins information, and then select Create. La instancia de Digital Twins podría tardar unos minutos en crearse.Your Digital Twins instance might take a few minutes to be created. Puede ver el progreso en el panel Notificaciones.You can monitor the progress in the Notifications pane.

  7. Abra el panel Información general de la instancia de Digital Twins.Open the Overview pane of your Digital Twins instance. Observe el vínculo situado bajo Management API.Note the link under Management API. La dirección URL de Management API tiene el formato siguiente:The Management API URL is formatted as:

    https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/swagger
    

    Esta dirección URL le lleva a la documentación de la API REST de Azure Digital Twins que se aplica a la instancia.This URL takes you to the Azure Digital Twins REST API documentation that applies to your instance. Lea Uso de Azure Digital Twins Swagger para aprender a leer y usar esta documentación de API.Read How to use Azure Digital Twins Swagger to learn how to read and use this API documentation. Copie y modifique la dirección URL de API de Administración para que tenga este formato:Copy and modify the Management API URL to this format:

    https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/
    

    La aplicación usará la dirección URL modificada como dirección URL base para acceder a la instancia.Your application will use the modified URL as the base URL to access your instance. Copie esta dirección URL modificada en un archivo temporal.Copy this modified URL to a temporary file. La necesitará en la siguiente sección.You'll need this in the next section.

    Introducción a la API de administraciónManagement API overview

Concesión de permisos a una aplicaciónGrant permissions to your app

Digital Twins usa Azure Active Directory (Azure AD) para controlar el acceso de lectura y escritura al servicio.Digital Twins uses Azure Active Directory (Azure AD) to control read/write access to the service. Todas las aplicaciones que necesita para conectarse a una instancia de Digital Twins deben estar registradas en Azure AD.Any application that needs to connect with your Digital Twins instance must be registered with Azure AD. Los pasos de esta sección muestran cómo crear una aplicación de ejemplo.The steps in this section show how to register your sample app.

Si ya tiene el registro de aplicaciones, puede reutilizarlo para el ejemplo.If you already have an app registration, you can reuse it for your sample. Sin embargo, en esta sección tiene la posibilidad de asegurarse de que el registro de la aplicación está configurado correctamente.However, browse through this section to make sure your app registration is configured correctly.

Nota

En esta sección se proporcionan instrucciones para el registro de la aplicación de Azure AD.This section provides instructions for Azure AD app registration.

  1. En Azure Portal, abra Azure Active Directory desde el menú expansible izquierdo y, luego, abra el panel Registros de aplicaciones.In the Azure portal, open Azure Active Directory from the expandable left menu, and then open the App registrations pane.

    Seleccione el panel Azure Active DirectorySelect the Azure Active Directory pane

  2. Seleccione el botón + Nuevo registro.Select the + New registration button.

    Seleccione el botón Nuevo registroSelect the New registration button

  3. Asigne un nombre descriptivo a este registro de aplicaciones en el cuadro Nombre.Give a friendly name for this app registration in the Name box.

    1. En la sección URI de redirección (opcional) , escriba https://microsoft.com en el cuadro de texto.Under Redirect URI (optional) section, enter https://microsoft.com in the textbox.

    2. Compruebe qué cuentas e inquilinos son compatibles con la aplicación Azure Active Directory.Verify which accounts and tenants are supported by your Azure Active Directory app.

    3. Seleccione Registrar.Select Register.

    Crear panelCreate pane

  4. En la hoja Autenticación se especifican valores de configuración de autenticación importantes.The Authentication blade specifies important authentication configuration settings.

    1. Seleccione + Agregar una plataforma para agregar valores de URI de redirección y configurar la opción Tokens de acceso.Add Redirect URIs and configure Access Tokens by selecting + Add a platform.

    2. Seleccione para especificar que la aplicación es un cliente público.Select Yes to specify that the app is a public client.

    3. Compruebe qué cuentas e inquilinos son compatibles con la aplicación Azure Active Directory.Verify which accounts and tenants are supported by your Azure Active Directory app.

    Opciones de configuración de cliente públicoPublic client configuration setting

  5. Después de seleccionar la plataforma adecuada, configure las opciones de URI de redirección y Tokens de acceso en el panel lateral a la derecha de la interfaz de usuario.After selecting the appropriate platform, configure your Redirect URIs and Access Tokens in the side panel to the right of the user interface.

    1. El valor de URI de redirección debe coincidir con la dirección proporcionada en la solicitud de autenticación:Redirect URIs must match the address supplied by the authentication request:

      • Si se trata de aplicaciones hospedadas en un entorno de desarrollo local, seleccione Cliente público (móvil y escritorio) .For apps hosted in a local development environment, select Public client (mobile & desktop). Asegúrese de establecer el cliente público en .Make sure to set public client to Yes.
      • En el caso de aplicaciones de página única hospedadas en Azure App Service, seleccione Web.For Single-Page Apps hosted on Azure App Service, select Web.
    2. Determine si procede agregar una URL de cierre de sesión.Determine whether a Logout URL is appropriate.

    3. Marque Tokens de acceso o Tokens de id. para habilitar el flujo de concesión implícita.Enable the implicit grant flow by checking Access tokens or ID tokens.

    Configuración de URI de redireccionamientoConfigure Redirect URIs

    Haga clic en Configurar y, a continuación, en Guardar.Click Configure, then Save.

  6. Abra el panel Introducción de la aplicación registrada y copie los valores de las siguientes entidades en un archivo temporal.Open the Overview pane of your registered app, and copy the values of the following entities to a temporary file. Usará estos valores para configurar la aplicación de ejemplo en las secciones siguientes.You'll use these values to configure your sample application in the following sections.

    • Id. de la aplicación (cliente)Application (client) ID
    • Id. de directorio (inquilino)Directory (tenant) ID

    Identificador de la aplicación de Azure Active DirectoryAzure Active Directory application ID

  7. Abra el panel Permisos de API para el registro de la aplicación.Open the API permissions pane for your app registration. Seleccione el botón + Agregar un permiso.Select + Add a permission button. En el panel Solicitud de permisos de API, seleccione la pestaña API usadas en mi organización y, a continuación, busque una de las siguientes:In the Request API permissions pane, select the APIs my organization uses tab, and then search for one of the following:

    1. Azure Digital Twins.Azure Digital Twins. Seleccione la API Azure Digital Twins.Select the Azure Digital Twins API.

      Search API o Azure Digital TwinsSearch API or Azure Digital Twins

    2. También puede buscar Azure Smart Spaces Service.Alternatively, search for Azure Smart Spaces Service. Seleccione la API de Azure Smart Spaces Service.Select the Azure Smart Spaces Service API.

      Search API de Azure Smart SpacesSearch API for Azure Smart Spaces

    Importante

    El nombre e identificador de la API de Azure AD que se muestran dependerán de su inquilino:The Azure AD API name and ID that will appear depends on your tenant:

    • Las cuentas de cliente y los inquilinos de prueba deben buscar Azure Digital Twins.Test tenant and customer accounts should search for Azure Digital Twins.
    • Otras cuentas de Microsoft deben buscar Azure Smart Spaces Service.Other Microsoft accounts should search for Azure Smart Spaces Service.
  8. Una vez seleccionada, la API se muestra como Azure Digital Twins en el mismo panel Solicitud de permisos de API.Either API will appear as Azure Digital Twins in the same Request API permissions pane once selected. Seleccione la opción desplegable Lectura y, a continuación, activa la casilla Read.Write.Select the Read drop-down option, and then select the Read.Write checkbox. Seleccione el botón Agregar permisos.Select the Add permissions button.

    Adición de permisos de APIAdd API permissions

  9. Dependiendo de la configuración de la organización, es posible que tenga que tomar medidas adicionales para conceder acceso de administrador a esta API.Depending on your organization's settings, you might need to take additional steps to grant admin access to this API. Para más información, póngase en contacto con el administrador.Contact your administrator for more information. Una vez aprobado el acceso de administrador, la columna Consentimiento del administrador necesario en el panel Permisos de API mostrará los permisos.Once the admin access is approved, the Admin Consent Required column in the API permissions pane will display your permissions.

    Aprobación del consentimiento del administradorAdmin consent approval

    Verifique que aparezca Azure Digital Twins.Verify that Azure Digital Twins appears.

Configuración del ejemplo de Digital TwinsConfigure the Digital Twins sample

En esta sección recorrerá una aplicación de Azure Digital Twins que se comunica con las API REST de Digital Twins.This section walks you through an Azure Digital Twins application that communicates with the Digital Twins REST APIs.

Descarga del ejemploDownload the sample

Si ya tiene los ejemplos descargados para la guía de inicio rápido para la búsqueda de salas disponibles, puede omitir estos pasos.If you already have the samples downloaded for the quickstart to find available rooms, you can skip these steps.

  1. Descargue los ejemplos de .NET de Digital Twins.Download the Digital Twins .NET samples.
  2. Extraiga el contenido de la carpeta ZIP en la máquina.Extract the contents of the zip folder on your machine.

Exploración del ejemploExplore the sample

En la carpeta de ejemplo extraída, abra el archivo digital-twins-samples-csharp\digital-twins-samples.code-workspace en Visual Studio Code.In the extracted sample folder, open the file digital-twins-samples-csharp\digital-twins-samples.code-workspace in Visual Studio Code. Esta solución contiene dos proyectos:It contains two projects:

  • Puede usar el ejemplo de aprovisionamiento occupancy-quickstart para configurar y aprovisionar un grafo de inteligencia espacial.You can use the provisioning sample occupancy-quickstart to configure and provision a spatial intelligence graph. Este grafo es la imagen digitalizada de los espacios físicos y de los recursos que hay en ellos.This graph is the digitized image of your physical spaces and the resources in them. Usa un modelo de objetos, que define los objetos de un edificio inteligente.It uses an object model, which defines objects for a smart building. Para obtener una lista completa de los objetos y las API REST de Digital Twins, visite esta documentación de la API REST o la dirección URL de API Management que se creó para su instancia.For a complete list of Digital Twins objects and REST APIs, visit this REST API documentation or the Management API URL that was created for your instance.

    Para explorar el ejemplo y entender cómo se comunica con su instancia de Digital Twins, puede comenzar con la carpeta src\actions.To explore the sample to understand how it communicates with your Digital Twins instance, you can start with the src\actions folder. Los archivos de esta carpeta implementan los comandos que usará en estos tutoriales:The files in this folder implement the commands that you'll use in these tutorials:

    • El archivo provisionSample.cs muestra cómo aprovisionar el grafo espacial.The provisionSample.cs file shows how to provision your spatial graph.
    • El archivo getSpaces.cs obtiene información sobre los espacios aprovisionados.The getSpaces.cs file gets information about the provisioned spaces.
    • El archivo getAvailableAndFreshSpaces.cs obtiene los resultados de una función personalizada llamada función definida por el usuario.The getAvailableAndFreshSpaces.cs file gets the results of a custom function called a user-defined function.
    • El archivo createEndpoints.cs crea puntos de conexión que interactúan con otros servicios.The createEndpoints.cs file creates endpoints to interact with other services.
  • El ejemplo de simulación device-connectivity simula los datos del sensor y los envía a la instancia de IoT Hub aprovisionada para la instancia de Digital Twins.The simulation sample device-connectivity simulates sensor data and sends it to the IoT hub that's provisioned for your Digital Twins instance. Este ejemplo se usará en el siguiente tutorial después de aprovisionar su grafo espacial.You'll use this sample in the next tutorial after you provision your spatial graph. Los identificadores de sensores y dispositivos que se usan para configurar este ejemplo deben ser iguales a los que usará para aprovisionar su grafo.The sensor and device identifiers that you use to configure this sample should be the same as what you'll use to provision your graph.

Configuración del ejemplo de aprovisionamientoConfigure the provisioning sample

  1. Abra una ventana de comandos y vaya al ejemplo descargado.Open a command window and go to the downloaded sample. Ejecute el siguiente comando:Run the following command:

    cd occupancy-quickstart/src
    
  2. Restaure las dependencias en el proyecto de ejemplo mediante la ejecución de este comando:Restore dependencies to the sample project by running this command:

    dotnet restore
    
  3. En Visual Studio Code, abra el archivo appSettings.json en el proyecto occupancy-quickstart.In Visual Studio Code, open the appSettings.json file in the occupancy-quickstart project. Actualice los siguientes valores:Update the following values:

    • ClientId: Escriba el identificador de aplicación de su registro de aplicaciones de Azure AD.ClientId: Enter the application ID of your Azure AD app registration. Este identificador lo anotó en la sección donde se establecen los permisos de aplicación.You noted this ID in the section where you set app permissions.
    • Tenant: Escriba el identificador de directorio de su inquilino de Azure AD.Tenant: Enter the directory ID of your Azure AD tenant. También anotó este identificador en la sección donde se establecen los permisos de aplicación.You also noted this ID in the section where you set app permissions.
    • BaseUrl: Escriba la dirección URL de la instancia de Digital Twins.BaseUrl: Enter the URL of your Digital Twins instance. Para obtener esta dirección URL, sustituya los marcadores de posición de esta por los valores de su instancia: https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/.To get this URL, replace the placeholders in this URL with values for your instance: https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/. Para obtener esta dirección URL, también puede modificar la dirección URL de Management API en la sección de implementación.You can also get this URL by modifying the Management API URL from the deployment section. Reemplace swagger/ por api/v1.0/ .Replace swagger/ with api/v1.0/.
  4. Revise una lista de las características de Digital Twins que puede explorar mediante el ejemplo.Review a list of Digital Twins features that you can explore by using the sample. Ejecute el siguiente comando:Run the following command:

    dotnet run
    

Descripción del proceso de aprovisionamientoUnderstand the provisioning process

En esta sección se muestra la forma en que el ejemplo aprovisiona un grafo espacial de un edificio.This section shows how the sample provisions a spatial graph of a building.

En Visual Studio Code, vaya a la carpeta occupancy-quickstart\src\actions y abra el archivo provisionSample.cs.In Visual Studio Code, browse to the occupancy-quickstart\src\actions folder and open the file provisionSample.cs. Anote la siguiente función:Note the following function:

public static async Task<IEnumerable<ProvisionResults.Space>> ProvisionSample(HttpClient httpClient, ILogger logger)
{
    IEnumerable<SpaceDescription> spaceCreateDescriptions;
    using (var r = new StreamReader("actions/provisionSample.yaml"))
    {
        spaceCreateDescriptions = await GetProvisionSampleTopology(r);
    }

    var results = await CreateSpaces(httpClient, logger, spaceCreateDescriptions, Guid.Empty);

    Console.WriteLine($"Completed Provisioning: {JsonConvert.SerializeObject(results, Formatting.Indented)}");

    return results;
}

Esta función usa el archivo provisionSample.yaml de la misma carpeta.This function uses provisionSample.yaml in the same folder. Abra este archivo y anote la jerarquía de un edificio de oficinas: Venue, Floor, Area y Rooms.Open this file, and note the hierarchy of an office building: Venue, Floor, Area, and Rooms. Todos estos espacios físicos pueden contener dispositivos y sensores.Any of these physical spaces can contain devices and sensors. Cada entrada tiene un valor de type— predefinido, por ejemplo, Floor o Room.Each entry has a predefined type—for example, Floor, Room.

El archivo yaml del ejemplo muestra un grafo espacial que usa el modelo de objetos de Digital Twins Default.The sample yaml file shows a spatial graph that uses the Default Digital Twins object model. Este modelo proporciona nombres genéricos para la mayoría de los tipos.This model provides generic names for most types. Los nombres genéricos son suficientes para un edificio.Generic names are sufficient for a building. Algunos ejemplos son Temperature para SensorDataType y Map para SpaceBlobType.Examples are Temperature for SensorDataType, and Map for SpaceBlobType. Un tipo de espacio de ejemplo es Room con los subtipos FocusRoom, ConferenceRoom, etc.An example space type is Room with subtypes FocusRoom, ConferenceRoom, and so on.

Si tuviera que crear un grafo espacial para una ubicación de un tipo diferente, como por ejemplo una fábrica, es posible que necesite un otro modelo de objetos.If you had to create a spatial graph for a different type venue, such as a factory, you might need a different object model. Para averiguar los modelos que están disponibles para su uso, ejecute el comando dotnet run GetOntologies en la línea de comandos del ejemplo de aprovisionamiento.You can find out which models are available to use by running the command dotnet run GetOntologies on the command line for the provisioning sample.

Para más información sobre los grafos espaciales y los modelos de objetos, lea Descripción de los modelos de objetos de Digital Twins y del grafo de inteligencia espacial.For more information on spatial graphs and object models, read Understanding Digital Twins object models and spatial intelligence graph.

Modificación del grafo espacial de ejemploModify the sample spatial graph

El archivo provisionSample.yaml contiene los siguientes nodos:The provisionSample.yaml file contains the following nodes:

  • resources: El nodo resources crea un recurso de Azure IoT Hub para comunicarse con los dispositivos en la instalación.resources: The resources node creates an Azure IoT Hub resource to communicate with the devices in your setup. Una instancia de IoT Hub en el nodo raíz del grafo puede comunicarse con todos los dispositivos y sensores del grafo.An IoT hub at the root node of your graph can communicate with all the devices and sensors in your graph.

  • spaces: En el modelo de objetos de Digital Twins spaces representa las ubicaciones físicas.spaces: In the Digital Twins object model, spaces represent the physical locations. Cada espacio tiene un valor de Type—, por ejemplo, Region, Venue o Customer—, y un nombre descriptivo en Name.Each space has a Type—for example, Region, Venue, or Customer—and a friendly Name. Los espacios pueden pertenecer a otros espacios, lo que crea una estructura jerárquica.Spaces can belong to other spaces, creating a hierarchical structure. El archivo provisionSample.yaml tiene un grafo espacial de un edificio imaginario.The provisionSample.yaml file has a spatial graph of an imaginary building. Observe el anidamiento lógico de los espacios del tipo Floor dentro de Venue, Area en una planta y los nodos de Room en un área.Note the logical nesting of spaces of type Floor within Venue, Area in a floor, and Room nodes in an area.

  • devices: Los espacios pueden contener devices, que son entidades físicas o virtuales que administran varios sensores.devices: Spaces can contain devices, which are physical or virtual entities that manage a number of sensors. Por ejemplo, un dispositivo puede ser el teléfono de un usuario, un pod de un sensor de Raspberry Pi o una puerta de enlace.For example, a device might be a user’s phone, a Raspberry Pi sensor pod, or a gateway. En el edificio imaginario del ejemplo, observe que la sala llamada Focus Room contiene un dispositivo Raspberry Pi 3 A1.In the imaginary building in your sample, note how the room named Focus Room contains a Raspberry Pi 3 A1 device. Cada nodo de dispositivo se identifica mediante un valor de hardwareId único, que está codificado de forma rígida en el ejemplo.Each device node is identified by a unique hardwareId, which is hardcoded in the sample. Para configurar este ejemplo para una producción real, reemplácelos por los valores de su configuración.To configure this sample for an actual production, replace these with values from your setup.

  • sensors: Un dispositivo puede contener varios valores de sensors.sensors: A device can contain multiple sensors. Estos sensores pueden detectar y registrar cambios físicos, como temperatura, movimiento y nivel de batería.They can detect and record physical changes like temperature, motion, and battery level. Cada nodo de sensor se identifica de forma única mediante hardwareId, que aquí está codificado de forma rígida.Each sensor node is uniquely identified by a hardwareId, hardcoded here. En una aplicación real, reemplácelos por los identificadores únicos de los sensores de su configuración.For an actual application, replace these by using the unique identifiers of the sensors in your setup. El archivo provisionSample.yaml tiene dos sensores para registrar los valores de Motion y CarbonDioxide.The provisionSample.yaml file has two sensors to record Motion and CarbonDioxide. Para agregar otro sensor para registrar el valor de Temperature, agregue las líneas siguientes debajo de las líneas del sensor CarbonDioxide.Add another sensor to record Temperature, by adding the following lines, below the lines for the CarbonDioxide sensor. Estas líneas se proporcionan en provisionSample.yaml como líneas comentadas.These are provided in provisionSample.yaml as commented-out lines. Puede quitarles las marcas de comentario si elimina el carácter # que aparece delante de cada línea.You can uncomment them by removing the # character in the front of each line.

            - dataType: Temperature
              hardwareId: SAMPLE_SENSOR_TEMPERATURE
    

    Nota

    Asegúrese de que las claves dataType y hardwareId se alinean con las instrucciones anteriores a este fragmento de código.Make sure the dataType and hardwareId keys align with the statements above this snippet. Asegúrese también de que el editor no reemplaza los espacios por caracteres de tabulación.Also make sure that your editor does not replace spaces with tabs.

Guarde y cierre el archivo provisionSample.yaml.Save and close the provisionSample.yaml file. En el siguiente tutorial, agregará más información a este archivo y, después, aprovisionará el edificio de ejemplo de Azure Digital Twins.In the next tutorial, you'll add more information to this file, and then provision your Azure Digital Twins sample building.

Sugerencia

Puede ver y modificar su grafo espacial con el visor de grafos de Azure Digital Twins.You can view and modify your spatial graph using the Azure Digital Twins Graph Viewer.

Limpieza de recursosClean up resources

Si quiere dejar de explorar Azure Digital Twins en este punto, elimine los recursos creados en este tutorial:If you want to stop exploring Azure Digital Twins at this point, feel free to delete resources created in this tutorial:

  1. En el menú izquierdo de Azure Portal, seleccione Todos los recursos, seleccione el grupo de recurso de Digital Twins y haga clic en Eliminar.From the left menu in the Azure portal, select All resources, select your Digital Twins resource group, and select Delete.

    Sugerencia

    Si tiene problemas al eliminar una instancia de Digital Twins, se ha incorporado una actualización del servicio con la corrección.If you experienced trouble deleting your Digital Twins instance, a service update has been rolled out with the fix. Vuelva a intentar eliminar la instancia.Please retry deleting your instance.

  2. Si es necesario, elimine la aplicación de ejemplo en la máquina de trabajo.If necessary, delete the sample application on your work machine.

Pasos siguientesNext steps

Para aprender a implementar una lógica personalizada para supervisar las condiciones del edificio de ejemplo, vaya al siguiente tutorial de la serie.To learn how to implement a custom logic to monitor conditions in your sample building, go to the next tutorial in the series: