Tutorial: Creación e implementación de una plantilla de aplicación de análisis en la tienda

Para crear la solución de un extremo a otro, use la plantilla de aplicación de comprobación del análisis en la tienda de IoT Central. Esta plantilla le permite conectarse y supervisar el entorno de una tienda a través de varios dispositivos de sensor. Estos dispositivos generan telemetría que puede convertir en información empresarial para ayudar a reducir los costos operativos y crear una excelente experiencia para los clientes.

En este tutorial, aprenderá a:

Si no tiene una suscripción de Azure, cree una cuenta gratuita antes de empezar.

Prerrequisitos

Para completar este tutorial, debe instalar la herramienta de línea de comandos dmr-client en el equipo local:

dotnet tool install --global Microsoft.IoT.ModelsRepository.CommandLine --version 1.0.0-beta.9

Arquitectura de la aplicación

Para muchos minoristas, las condiciones ambientales son una manera clave de diferenciar sus tiendas de sus competidores. Los minoristas más exitosos realizan todos los esfuerzos para mantener condiciones agradables dentro de sus tiendas para la comodidad de sus clientes.

La plantilla de aplicación incluye un conjunto de plantillas de dispositivo y usa un conjunto de dispositivos simulados para rellenar el panel:

Como se muestra en el diagrama de arquitectura de la aplicación anterior, puede usar la plantilla de aplicación para:

• (1) Conecte varios sensores de IoT a una instancia de aplicación de IoT Central.

  Una solución de IoT comienza con un conjunto de sensores que capturan señales significativas desde dentro de un entorno de tienda minorista. Los distintos iconos situados en el extremo izquierdo del diagrama de arquitectura representan los sensores.

• (2) Supervisar y administrar la salud de la red de sensores y los dispositivos de puerta de enlace del entorno.

  Muchos sensores de IoT pueden alimentar señales sin procesar directamente a la nube o a un dispositivo de puerta de enlace ubicado cerca de ellos. El dispositivo de puerta de enlace agrupa datos en el borde de la red antes de enviar resúmenes a una aplicación de IoT Central. El dispositivo de puerta de enlace también es responsable de retransmitir las operaciones de control y comandos a los dispositivos del sensor cuando corresponda.

• (3) Cree reglas personalizadas que usen condiciones ambientales dentro de un almacén para desencadenar alertas para los administradores de la tienda.

  La aplicación Azure IoT Central ingiere datos de los distintos sensores de IoT y dispositivos de puerta de enlace dentro del entorno de la tienda minorista y, a continuación, genera un conjunto de conclusiones significativas.

  Azure IoT Central también proporciona una experiencia adaptada para los operadores de almacén que les permite supervisar y administrar de forma remota los dispositivos de infraestructura.

• (4) Transformar las condiciones ambientales dentro de las tiendas en conclusiones que el equipo de la tienda puede usar para mejorar la experiencia del cliente.

  Puede configurar una aplicación de Azure IoT Central dentro de una solución para exportar información sin procesar o agregada a un conjunto de servicios de plataforma como servicio (PaaS) de Azure. Los servicios paaS pueden realizar la manipulación de datos y enriquecer estas conclusiones antes de aterrizarlas en una aplicación empresarial.

• (5) Exporte la información agregada a las aplicaciones empresariales existentes o nuevas para proporcionar información útil y oportuna al personal minorista.

  Los datos de IoT pueden impulsar diferentes tipos de aplicaciones empresariales implementadas en un entorno comercial. Un administrador de tiendas minoristas o un miembro del personal pueden usar estas aplicaciones para visualizar la información empresarial y tomar medidas significativas en tiempo real. Aprenderá a crear un panel de Power BI en tiempo real en el tutorial Exportación de datos desde Azure IoT Central y visualización de información en Power BI .

Creación de una aplicación de análisis en la tienda

Para crear la aplicación de IoT Central:

1. Vaya a la página Crear aplicación de IoT Central en Azure Portal. Si se le solicita, inicie sesión con su cuenta de Azure.

2. Escriba la siguiente información:

   Campo	Description
   Subscription	La suscripción de Azure que quiere usar.
   Grupo de recursos	El grupo de recursos que desea usar. Puede crear un nuevo grupo de recursos o usar uno existente.
   Nombre del recurso	Un nombre de recurso de Azure válido.
   Dirección URL de la aplicación	Subdominio url de la aplicación. La dirección URL de una aplicación de IoT Central se ve como https://yoursubdomain.azureiotcentral.com.
   Template	Análisis en el almacén: finalización de la compra
   Región	Región de Azure que quiere usar.
   Plan de precios	Plan de precios que desea usar.

3. Selecciona Revisar + crear. A continuación, seleccione Crear.

Cuando la aplicación esté lista, puede ir a ella desde Azure Portal:

Para más información, consulte Creación de una aplicación de Azure IoT Central.

Recorrido por la aplicación.

En las secciones siguientes se describen las características clave de la aplicación.

Personalización de la configuración de la aplicación

Puede cambiar varias opciones de configuración para personalizar la experiencia del usuario en la aplicación. Un tema personalizado le permite establecer los colores del explorador de la aplicación, el icono del explorador y el logotipo de la aplicación que aparece en el mástil.

Para crear un tema personalizado, use las imágenes de ejemplo para personalizar la aplicación. Descargue las cuatro imágenes de ejemplo de Contoso de GitHub.

Para crear un tema personalizado:

1. En el panel izquierdo, seleccione Apariencia de personalización>.

2. Para cambiar el logotipo de masthead, seleccione Cambiary, a continuación, seleccione la imagen contoso_wht_mast.png que se va a cargar. Opcionalmente, escriba un valor para Texto alternativo del logotipo.

3. Para cambiar el icono del explorador, seleccione Cambiar y, a continuación, seleccione la imagen decontoso_favicon.png que aparecerá en las pestañas del explorador.

4. Reemplace los colores predeterminados del explorador agregando códigos de color hexadecimales HTML:

   • En Encabezado, escriba #008575.
   • En Acento, escriba #A1F3EA.

5. Haga clic en Guardar. Después de guardar los cambios, la aplicación actualiza los colores del explorador, el logotipo en la punta del mástil y el icono del explorador.

Para actualizar la imagen de aplicación que aparece en el icono de la aplicación en la página Mis aplicaciones del sitio Mis aplicaciones de Azure IoT Central :

1. Seleccione Administración de aplicaciones>.

2. Seleccione Cambiar y, a continuación, seleccione la imagen decontoso_main_lg.png para cargarla como imagen de aplicación.

3. Haga clic en Guardar.

Creación de las plantillas de dispositivo

Las plantillas de dispositivo permiten configurar y administrar dispositivos. Puede crear una plantilla personalizada, importar un archivo de plantilla existente o importar una plantilla de la lista de plantillas de dispositivo destacadas. Después de crear y personalizar una plantilla de dispositivo, úsela para conectar dispositivos reales a la aplicación.

Opcionalmente, puede usar una plantilla de dispositivo para generar dispositivos simulados para realizar pruebas.

La plantilla de aplicación análisis en la tienda: finalización de la compra tiene varias plantillas de dispositivo preinstaladas. La plantilla de dispositivo RuuviTag no se incluye en la plantilla de aplicación Análisis en tienda - caja.

En esta sección, agregará una plantilla de dispositivo para sensores RuuviTag a la aplicación. Para ello:

1. Para descargar una copia de la plantilla de dispositivo RuuviTag desde el repositorio de modelos, ejecute el siguiente comando:

   dmr-client export --dtmi "dtmi:rigado:RuuviTag;2" --repo https://raw.githubusercontent.com/Azure/iot-plugandplay-models/main > ruuvitag.json
   

2. En el panel izquierdo, seleccione Plantillas de dispositivo.

3. Seleccione + Nuevo para crear una nueva plantilla de dispositivo.

4. Seleccione el icono del dispositivo IoT y, a continuación, seleccione Siguiente: Personalizar.

5. En la página Personalizar , escriba RuuviTag como el nombre de la plantilla de dispositivo.

6. Seleccione Siguiente: Revisar.

7. Selecciona Crear.

8. Seleccione el icono Importar un modelo . A continuación, busque e importe el archivo ruuvitag.json que descargó anteriormente.

9. Una vez completada la importación, seleccione Publicar para publicar la plantilla de dispositivo.

10. En el panel izquierdo, seleccione Plantillas de dispositivo.

    En la página se muestran todas las plantillas de dispositivo de la plantilla de aplicación y la plantilla de dispositivo RuuviTag que acaba de agregar.

Personalización de las plantillas de dispositivo

Puede personalizar las plantillas de dispositivo de la aplicación de tres maneras:

• Personalice las interfaces integradas nativas en los dispositivos cambiando las funcionalidades del dispositivo.

  Por ejemplo, con un sensor de temperatura, puede cambiar los detalles, como el nombre para mostrar y las unidades de medida.

• Personalice las plantillas de dispositivo agregando propiedades en la nube.

  Las propiedades en la nube son datos personalizados que crea, almacena y asocia la aplicación de Azure IoT Central a los dispositivos. Algunos ejemplos de propiedades en la nube son:

  • Valor calculado.
  • Metadatos, como una ubicación que desea asociar a un conjunto de dispositivos.

• Personalice las plantillas de dispositivo mediante la creación de vistas personalizadas.

  Las vistas proporcionan una manera de que los operadores visualicen la telemetría y los metadatos de los dispositivos, como las métricas y el estado del dispositivo.

En esta sección, usará los dos primeros métodos para personalizar la plantilla de dispositivo para los sensores RuuviTag.

Para personalizar las interfaces integradas de la plantilla de dispositivo RuuviTag:

1. En el panel izquierdo, seleccione Plantillas de dispositivo.

2. Seleccione RuuviTag.

3. Oculte el panel izquierdo. La vista de resumen de la plantilla muestra las funcionalidades del dispositivo.

   

4. Seleccione el modelo RuuviTag en el menú de la plantilla de dispositivo RuuviTag.

5. En la lista de capacidades, desplácese hasta el tipo de telemetría RelativeHumidity. Es el elemento de fila con el campo Display name (Nombre para mostrar) editable para RelativeHumidity.

En los pasos siguientes, personalizará el tipo de telemetría RelativeHumidity para los sensores RuuviTag. Opcionalmente, puede personalizar algunos de los otros tipos de telemetría.

Para el tipo de telemetría RelativeHumidity , realice los cambios siguientes:

1. Actualice el valor nombre para mostrar de RelativeHumidity a un valor personalizado como Humidity.

2. Cambie la opción Tipo semántico de Humedad relativa a Humedad.

   Opcionalmente, establezca valores de esquema para el tipo de telemetría de humedad en la vista de esquema expandido. Al establecer valores de esquema, puede crear requisitos de validación detallados para los datos a los que realizan el seguimiento de los sensores. Por ejemplo, podría establecer valores de intervalos operativos mínimos y máximos para una interfaz especificada.

3. Seleccione Guardar para guardar los cambios.

Para agregar una propiedad en la nube a una plantilla de dispositivo en la aplicación:

1. Seleccione Agregar funcionalidad.

2. En Nombre para mostrar, escriba Ubicación.

   Este valor, que es un nombre descriptivo para la propiedad, se copia automáticamente a Nombre. Puede usar el valor copiado o cambiarlo.

3. En Tipo de funcionalidad, seleccione Propiedad en la nube.

4. Seleccionar Expandir.

5. En la lista desplegable Esquema , seleccione Cadena.

   Esta opción permite asociar un nombre de ubicación a cualquier dispositivo en función de la plantilla. Por ejemplo, podría asociar un área con nombre en un almacén a cada dispositivo.

6. Establezca Longitud mínima en 2.

7. Establezca Recortar espacio en blanco en Activado.

8. Seleccione Guardar para guardar la propiedad personalizada en la nube.

9. Seleccione Publicar.

   La publicación de una plantilla de dispositivo hace que las actualizaciones estén visibles para los operadores de aplicación. Después de publicar una plantilla, úsela para generar dispositivos simulados para probar o conectar dispositivos reales a la aplicación. Si ya tiene dispositivos conectados a la aplicación, la publicación de una plantilla personalizada inserta los cambios en los dispositivos.

Adición de dispositivos

Después de crear y personalizar las plantillas de dispositivo, es el momento de agregar dispositivos. En este tutorial, usará el siguiente conjunto de dispositivos simulados para compilar la aplicación:

• Una puerta de enlace Rigado C500.
• Dos sensores RuuviTag .
• Sensor de ocupación. Este sensor simulado se incluye en la plantilla de aplicación, por lo que no es necesario crearlo.

Para agregar un dispositivo de puerta de enlace Rigado Cascade 500 simulado a la aplicación:

1. En el panel izquierdo, seleccione Dispositivos.

2. Seleccione C500 en la lista de plantillas de dispositivo disponibles y, a continuación, seleccione Nuevo.

3. Escriba la puerta de enlace de C500 como nombre del dispositivo y gateway-001 como identificador de dispositivo.

4. Asegúrese de que C500 es la plantilla de dispositivo seleccionada y, a continuación, establezca Simular este dispositivo enSí.

5. Selecciona Crear. La aplicación ahora contiene un dispositivo de puerta de enlace Rigado Cascade 500 simulado.

Para agregar un dispositivo de sensor RuuviTag simulado a la aplicación:

1. En el panel izquierdo, seleccione Dispositivos.

2. Seleccione RuuviTag en la lista de plantillas de dispositivo disponibles y, a continuación, seleccione Nuevo.

3. Escriba RuuviTag 001 como nombre del dispositivo y ruuvitag-001 como identificador del dispositivo.

4. Asegúrese de que RuuviTag es la plantilla de dispositivo seleccionada y, a continuación, establezca Simulate this device? (Simular este dispositivo) en Sí.

5. Selecciona Crear. La aplicación ahora contiene un dispositivo de sensor RuuviTag simulado.

Repita los pasos anteriores para agregar un segundo dispositivo de sensor RuuviTag simulado a la aplicación. Escriba RuuviTag 002 como nombre del dispositivo y ruuvitag-002 como identificador de dispositivo.

Para conectar los dos dispositivos RuuviTag y de Ocupación al dispositivo de puerta de enlace:

1. En el panel izquierdo, seleccione Dispositivos.

2. En la lista de dispositivos, seleccione RuuviTag 001, RuuviTag 002 y Ocupación. A continuación, en la barra de comandos, seleccione Adjuntar al gateway.

3. En el panel Asociar a puerta de enlace , seleccione C500 como plantilla de dispositivo y C500 - puerta de enlace como dispositivo. A continuación, seleccione Adjuntar.

Si navega al dispositivo C500 - gateway y selecciona la pestaña Dispositivos descendentes, ahora se ven tres dispositivos conectados a la puerta de enlace.

Adición de reglas y acciones

Como parte del uso de sensores en la aplicación de Azure IoT Central para supervisar las condiciones, puede crear reglas para ejecutar acciones cuando se cumplan determinadas condiciones.

Una regla está asociada a una plantilla de dispositivo y a uno o varios dispositivos, y contiene condiciones que se deben cumplir en función de la telemetría o los eventos del dispositivo. Una regla también tiene una o varias acciones asociadas. Las acciones pueden incluir el envío de notificaciones por correo electrónico o desencadenar una acción de webhook para enviar datos a otros servicios. La plantilla de aplicación In-store analytics - checkout (Análisis en tienda: finalización de la compra) incluye algunas reglas predefinidas para los dispositivos de la aplicación.

En esta sección, creará una nueva regla que comprueba el nivel máximo de humedad relativa en función de la telemetría del sensor RuuviTag. Agregue una acción a la regla para que, si la humedad supera el máximo, la aplicación envía una notificación por correo electrónico.

Para crear una regla:

1. En el panel izquierdo, seleccione Reglas.

2. Seleccione Nuevo.

3. Escriba Nivel de humedad como nombre de la regla.

4. En Plantilla de dispositivo, seleccione la plantilla de dispositivo RuuviTag.

   La regla que defina se aplica a todos los sensores, en función de esa plantilla. Opcionalmente, podría crear un filtro que aplicaría la regla solo a un subconjunto definido de los sensores.

5. En Telemetría, seleccione RelativeHumidity. Es la funcionalidad del dispositivo que ha personalizado en un paso anterior.

6. En Operador, seleccione Es mayor que.

7. En Valor, escriba un nivel típico de humedad interior de rango superior para su entorno (por ejemplo, 65).

   Esta condición se aplica cuando la humedad relativa en cualquier sensor RuuviTag supera el valor. Es posible que tenga que ajustar el valor hacia arriba o hacia abajo en función del intervalo de humedad normal en su entorno.

Para agregar una acción a la regla:

1. Seleccione Correo electrónico.

2. Para obtener un nombre para mostrar descriptivo para la acción, escriba Notificación de humedad alta.

3. En Para, escriba la dirección de correo electrónico asociada a su cuenta.

   Si usa una dirección de correo electrónico diferente, la que use debe ser para un usuario que se haya agregado a la aplicación. El usuario también debe iniciar sesión y cerrarla al menos una vez.

4. Opcionalmente, escriba una nota para incluir en el texto del correo electrónico.

5. Seleccione Listo para completar la acción.

6. Seleccione Guardar para guardar y activar la nueva regla.

   En unos minutos, la cuenta de correo electrónico especificada debe comenzar a recibir mensajes. La aplicación envía un correo electrónico cada vez que un sensor indica que el nivel de humedad ha superado el umbral de su condición.

Limpieza de recursos

Si no tiene previsto completar más inicios rápidos o tutoriales de IoT Central, puede eliminar la aplicación de IoT Central:

1. En la aplicación de IoT Central, vaya a Administración de >aplicaciones.
2. Seleccione Eliminar y confirme la acción.

Paso siguiente