Tutoriel : Créer et déployer un modèle d’application d’analytique dans le store

Pour construire la solution de bout en bout, vous utilisez le modèle d’application IoT Central pour l'analyse des paiements en magasin. Ce modèle vous permet de vous connecter et de surveiller l’environnement d’un magasin via différents appareils de capteur. Ces appareils génèrent des données de télémétrie que vous pouvez convertir en insights métier pour réduire les coûts d’exploitation et créer une expérience optimale pour vos clients.

Dans ce tutoriel, vous allez apprendre à :

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Prerequisites

Pour suivre ce tutoriel, vous devez installer l’outil en ligne de commande dmr-client sur votre ordinateur local :

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

Architecture de l'application

Pour de nombreux détaillants, les conditions environnementales constituent un moyen clé de différencier leurs magasins des magasins de leurs concurrents. Les détaillants les plus performants font tous les efforts pour maintenir des conditions agréables au sein de leurs magasins pour le confort de leurs clients.

Le modèle d’application est fourni avec un ensemble de modèles d’appareil et utilise un ensemble d’appareils simulés pour remplir le tableau de bord :

Comme indiqué dans le diagramme d’architecture d’application précédent, vous pouvez utiliser le modèle d’application pour :

• (1) Connectez différents capteurs IoT à une instance d’application IoT Central.

  Une solution IoT commence par un ensemble de capteurs qui capturent des signaux significatifs à partir d’un environnement de magasin de vente au détail. Les différentes icônes à l’extrême gauche du diagramme d’architecture représentent les capteurs.

• (2) Surveillez et gérez l’intégrité du réseau de capteurs et de tous les appareils de passerelle dans l’environnement.

  De nombreux capteurs IoT peuvent alimenter des signaux bruts directement vers le cloud ou vers un appareil de passerelle situé près d’eux. L’appareil de passerelle agrège les données à la périphérie avant d’envoyer des insights récapitulatives à une application IoT Central. L’appareil de passerelle est également chargé de relayer les opérations de commande et de contrôle sur les appareils de capteur le cas échéant.

• (3) Créez des règles personnalisées qui utilisent des conditions environnementales dans un magasin pour déclencher des alertes pour les gestionnaires de magasin.

  L’application Azure IoT Central ingère les données des différents capteurs Et appareils de passerelle IoT dans l’environnement du magasin de vente au détail, puis génère un ensemble d’insights significatifs.

  Azure IoT Central offre également une expérience personnalisée pour les opérateurs de magasin qui leur permet de surveiller et de gérer à distance les appareils d’infrastructure.

• (4) Transformer les conditions environnementales dans les magasins en insights que l’équipe du magasin peut utiliser pour améliorer l’expérience client.

  Vous pouvez configurer une application Azure IoT Central au sein d’une solution pour exporter des insights bruts ou agrégés vers un ensemble de services PaaS (Platform as a Service). Les services PaaS peuvent effectuer une manipulation des données et enrichir ces insights avant de les atterrir dans une application métier.

• (5) Exportez les insights agrégés dans les applications commerciales existantes ou nouvelles afin de fournir des informations utiles et opportunes au personnel de la vente au détail.

  Les données IoT peuvent alimenter différents types d’applications métier déployées dans un environnement de vente au détail. Un responsable du magasin de vente au détail ou un membre du personnel peut utiliser ces applications pour visualiser les insights métier et prendre des mesures significatives en temps réel. Vous allez apprendre à créer un tableau de bord Power BI en temps réel dans les données d’exportation à partir d’Azure IoT Central et à visualiser des insights dans le didacticiel Power BI .

Créer une application d’analytique dans le magasin

Pour créer votre application IoT Central :

1. Accédez à la page Créer une application IoT Central dans le portail Azure. Si vous y êtes invité, connectez-vous avec votre compte Azure.

2. Entrez les informations suivantes :

   Champ	Descriptif
   Subscription	Abonnement Azure que vous souhaitez utiliser.
   groupe de ressources	Groupe de ressources que vous souhaitez utiliser. Vous pouvez créer un groupe de ressources ou en utiliser un existant.
   Nom de la ressource	Nom de ressource Azure valide.
   URL de l’application	Sous-domaine URL de votre application. L’URL d’une application IoT Central ressemble à https://yoursubdomain.azureiotcentral.com.
   Template	Analytique en magasin - Passage en caisse
   Région	Région Azure que vous souhaitez utiliser.
   Plan tarifaire	Le plan tarifaire que vous souhaitez utiliser.

3. Sélectionnez Vérifier + créer. Sélectionnez ensuite Créer.

Une fois l’application prête, vous pouvez y accéder à partir du portail Azure :

Pour plus d’informations, consultez Créer une application Azure IoT Central.

Parcourir l’application

Les sections suivantes décrivent les principales fonctionnalités de l’application.

Personnaliser les paramètres de l’application

Vous pouvez modifier plusieurs paramètres pour personnaliser l’expérience utilisateur dans votre application. Un thème personnalisé vous permet de définir les couleurs du navigateur d’application, l’icône du navigateur et le logo de l’application qui s’affiche dans le masthead.

Pour créer un thème personnalisé, utilisez les exemples d’images pour personnaliser l’application. Téléchargez les quatre exemples d’images Contoso à partir de GitHub.

Pour créer un thème personnalisé :

1. Dans le volet gauche, sélectionnez Apparence de personnalisation>.

2. Pour modifier le logo masthead, sélectionnez Modifier, puis sélectionnez l’image contoso_wht_mast.png à charger. Si vous le souhaitez, entrez une valeur pour le texte de remplacement du logo.

3. Pour modifier l’icône du navigateur, sélectionnez Modifier, puis sélectionnez l’image contoso_favicon.png à afficher sous les onglets du navigateur.

4. Remplacez les couleurs du navigateur par défaut en ajoutant des codes de couleur hexadécimaux HTML :

   • Pour En-tête, entrez #008575.
   • Pour Accentuation, entrez #A1F3EA.

5. Cliquez sur Enregistrer. Après avoir enregistré vos modifications, l’application met à jour les couleurs du navigateur, le logo dans le masthead et l’icône du navigateur.

Pour mettre à jour l’image de l’application qui apparaît sur la vignette de l’application sur la page Mes applications du site Azure IoT Central Mes applications :

1. Sélectionnez Gestion des applications>.

2. Sélectionnez Modifier, puis sélectionnez l’image contoso_main_lg.png à charger en tant qu’image d’application.

3. Cliquez sur Enregistrer.

Créer les modèles d’appareil

Les modèles d’appareil vous permettent de configurer et de gérer des appareils. Vous pouvez créer un modèle personnalisé, importer un fichier de modèle existant ou importer un modèle dans la liste des modèles d’appareil proposés. Après avoir créé et personnalisé un modèle d’appareil, utilisez-le pour connecter des appareils réels à votre application.

Si vous le souhaitez, vous pouvez utiliser un modèle d’appareil pour générer des appareils simulés à des fins de test.

Le modèle d’application Analytique en magasin – Validation de l’achat contient plusieurs modèles d’appareil préinstallés. Le modèle d’appareil RuuviTag n’est pas inclus dans le modèle d’application In-store analytics - checkout.

Dans cette section, vous allez ajouter un modèle d’appareil pour les capteurs RuuviTag à votre application. Pour ce faire :

1. Pour télécharger une copie du modèle d’appareil RuuviTag à partir du référentiel de modèles, exécutez la commande suivante :

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

2. Dans le volet gauche, sélectionnez Modèles d’appareil.

3. Sélectionnez + Nouveau pour créer un modèle d’appareil.

4. Sélectionnez la vignette de l’appareil IoT , puis sélectionnez Suivant : Personnaliser.

5. Dans la page Personnaliser , entrez RuuviTag comme nom de modèle d’appareil.

6. Sélectionnez Suivant : Vérifier.

7. Cliquez sur Créer.

8. Sélectionnez la vignette Importer un modèle . Ensuite, recherchez et importez le fichier ruuvitag.json que vous avez téléchargé précédemment.

9. Une fois l’importation terminée, sélectionnez Publier pour publier le modèle d’appareil.

10. Dans le volet gauche, sélectionnez Modèles d’appareil.

    La page affiche tous les modèles d’appareil dans le modèle d’application et le modèle d’appareil RuuviTag que vous venez d’ajouter.

Personnaliser les modèles d’appareil

Vous pouvez personnaliser les modèles d’appareil de votre application de trois façons :

• Personnalisez les interfaces intégrées natives dans vos appareils en modifiant les fonctionnalités de l’appareil.

  Par exemple, avec un capteur de température, vous pouvez modifier les détails tels que le nom d’affichage et les unités de mesure.

• Personnalisez vos modèles d’appareil en ajoutant des propriétés cloud.

  Les propriétés cloud sont des données personnalisées que votre application Azure IoT Central crée, stocke et associe à vos appareils. Voici quelques exemples de propriétés cloud :

  • Valeur calculée.
  • Métadonnées, telles qu’un emplacement que vous souhaitez associer à un ensemble d’appareils.

• Personnalisez les modèles d’appareil en créant des vues personnalisées.

  Les vues permettent aux opérateurs de visualiser les données de télémétrie et les métadonnées de vos appareils, telles que les métriques des appareils et l’état de santé.

Dans cette section, vous utilisez les deux premières méthodes pour personnaliser le modèle d’appareil pour vos capteurs RuuviTag.

Pour personnaliser les interfaces intégrées du modèle d’appareil RuuviTag :

1. Dans le volet gauche, sélectionnez Modèles d’appareil.

2. Sélectionnez RuuviTag.

3. Masquez le volet gauche. La vue récapitulative du modèle affiche les fonctionnalités de l’appareil.

   

4. Sélectionnez le modèle RuuviTag dans le menu du modèle d’appareil RuuviTag.

5. Dans la liste des fonctionnalités, faites défiler le type de télémétrie RelativeHumidity. Il s’agit de l’élément de ligne avec la valeur Nom d’affichage modifiable de RelativeHumidity.

Dans les étapes suivantes, vous personnalisez le type de télémétrie RelativeHumidity pour les capteurs RuuviTag. Si vous le souhaitez, vous pouvez personnaliser certains des autres types de données de télémétrie.

Pour le type de télémétrie RelativeHumidity , apportez les modifications suivantes :

1. Mettez à jour la valeur nom d’affichage de RelativeHumidity en une valeur personnalisée telle que l’humidité.

2. Remplacez l’option Type sémantique de l’humidité relative par humidité.

   Si vous le souhaitez, définissez des valeurs de schéma pour le type de télémétrie d’humidité dans la vue de schéma développée. En définissant des valeurs de schéma, vous pouvez créer des exigences de validation détaillées pour les données suivies par vos capteurs. Par exemple, vous pouvez définir des valeurs minimales et maximales de plage d’exploitation pour une interface spécifiée.

3. Cliquez sur Enregistrer pour enregistrer vos modifications.

Pour ajouter une propriété cloud à un modèle d’appareil dans votre application :

1. Sélectionnez Ajouter une fonctionnalité.

2. Pour Display Name, saisissez Location.

   Cette valeur, qui est un nom convivial pour la propriété, est automatiquement copiée dans le nom. Vous pouvez utiliser la valeur copiée ou la modifier.

3. Pour le type de fonctionnalité, sélectionnez Propriété cloud.

4. Sélectionnez Afficher.

5. Dans la liste déroulante Schéma , sélectionnez Chaîne.

   Cette option vous permet d’associer un nom d’emplacement à n’importe quel appareil en fonction du modèle. Par exemple, vous pouvez associer une zone nommée dans un magasin à chaque appareil.

6. Définissez la longueur minimale sur 2.

7. Réglez Réduire les espaces blancssur Activé.

8. Sélectionnez Enregistrer pour enregistrer votre propriété cloud personnalisée.

9. Cliquez sur Publier.

   La publication d’un modèle d’appareil rend les mises à jour visibles par les opérateurs d’application. Après avoir publié un modèle, utilisez-le pour générer des appareils simulés à des fins de test ou pour connecter des appareils réels à votre application. Si vous avez déjà des appareils connectés à votre application, la publication d’un modèle personnalisé envoie les modifications aux appareils.

Ajouter des appareils

Après avoir créé et personnalisé les modèles d’appareil, il est temps d’ajouter des appareils. Pour ce tutoriel, vous utilisez l’ensemble suivant d’appareils simulés pour générer l’application :

• Une passerelle Rigado C500.
• Deux capteurs RuuviTag .
• Capteur d’occupation . Ce capteur simulé est inclus dans le modèle d’application. Vous n’avez donc pas besoin de le créer.

Pour ajouter un appareil de passerelle Rigado Cascade 500 simulé à votre application :

1. Dans le volet gauche, sélectionnez Appareils.

2. Sélectionnez C500 dans la liste des modèles d’appareil disponibles, puis sélectionnez Nouveau.

3. Entrez la passerelle C500 en tant que nom d’appareil et passerelle-001 comme ID d’appareil.

4. Assurez-vous que C500 est le modèle d’appareil sélectionné, puis définissez Simulate this device ? sur Oui.

5. Cliquez sur Créer. Votre application contient désormais un appareil de passerelle Rigado Cascade 500 simulé.

Pour ajouter un appareil de capteur RuuviTag simulé à votre application :

1. Dans le volet gauche, sélectionnez Appareils.

2. Sélectionnez RuuviTag dans la liste des modèles d’appareil disponibles, puis sélectionnez Nouveau.

3. Entrez RuuviTag 001 comme nom de l’appareil et ruuvitag-001 comme ID d’appareil.

4. Assurez-vous que RuuviTag est le modèle d’appareil sélectionné, puis définissez Simuler cet appareil surOui.

5. Cliquez sur Créer. Votre application contient désormais un appareil de capteur RuuviTag simulé.

Répétez les étapes précédentes pour ajouter un deuxième appareil de capteur RuuviTag simulé à votre application. Entrez RuuviTag 002 comme nom de l’appareil et ruuvitag-002 comme ID d’appareil.

Pour connecter les deux capteurs RuuviTag et les dispositifs d’occupation au dispositif de passerelle :

1. Dans le volet gauche, sélectionnez Appareils.

2. Dans la liste des appareils, sélectionnez RuuviTag 001, RuuviTag 002 et Occupation. Ensuite, dans la barre de commandes, sélectionnez Attacher à la passerelle.

3. Dans le volet Attacher à la passerelle , sélectionnez C500 comme modèle d’appareil et C500 : passerelle en tant qu’appareil. Ensuite, sélectionnez Attacher.

Si vous accédez à l’appareil C500 - passerelle et sélectionnez l’onglet Appareils en aval , vous voyez maintenant trois appareils attachés à la passerelle.

Ajouter des règles et des actions

Dans le cadre de l’utilisation de capteurs dans votre application Azure IoT Central pour surveiller les conditions, vous pouvez créer des règles pour exécuter des actions lorsque certaines conditions sont remplies.

Une règle est associée à un modèle d’appareil et à un ou plusieurs appareils, et contient des conditions qui doivent être remplies en fonction de la télémétrie ou des événements de l’appareil. Une règle a également une ou plusieurs actions associées. Les actions peuvent inclure l’envoi de notifications par e-mail ou le déclenchement d’une action webhook pour envoyer des données à d’autres services. Le modèle d’application Analytique en magasin – caisse contient quelques règles prédéfinies pour les appareils de l’application.

Dans cette section, vous allez créer une règle qui vérifie le niveau maximal d’humidité relative en fonction de la télémétrie du capteur RuuviTag. Vous ajoutez une action à la règle afin que si l’humidité dépasse le maximum, l’application envoie une notification par e-mail.

Pour créer une règle :

1. Dans le volet gauche, sélectionnez Règles.

2. Cliquez sur Nouveau.

3. Entrez le niveau d’humidité comme nom de la règle.

4. Pour le modèle d’appareil, sélectionnez le modèle d’appareil RuuviTag.

   La règle que vous définissez s’applique à tous les capteurs, en fonction de ce modèle. Si vous le souhaitez, vous pouvez créer un filtre qui appliquerait la règle à un sous-ensemble défini des capteurs.

5. Pour la télémétrie, sélectionnez RelativeHumidity. Il s’agit de la fonctionnalité d’appareil que vous avez personnalisée à une étape antérieure.

6. Pour Opérateur, sélectionnez Est supérieur à.

7. Pour Valeur, entrez un niveau supérieur typique d'humidité pour votre environnement (par exemple, 65).

   Cette condition s’applique lorsque l’humidité relative dans n’importe quel capteur RuuviTag dépasse la valeur. Vous devrez peut-être ajuster la valeur vers le haut ou vers le bas en fonction de la plage d’humidité normale dans votre environnement.

Pour ajouter une action à la règle :

1. Sélectionnez Envoyer par e-mail.

2. Pour obtenir un nom d’affichage convivial pour l’action, entrez une notification d’humidité élevée.

3. Pour To, entrez l’adresse e-mail associée à votre compte.

   Si vous utilisez une autre adresse e-mail, celle que vous utilisez doit être pour un utilisateur qui a été ajouté à l’application. L’utilisateur doit également se connecter et sortir au moins une fois.

4. Si vous le souhaitez, entrez une note à inclure dans le texte de l’e-mail.

5. Sélectionnez Terminé pour terminer l’action.

6. Sélectionnez Enregistrer pour enregistrer et activer la nouvelle règle.

   Dans quelques minutes, le compte de messagerie spécifié doit commencer à recevoir des messages. L’application envoie un e-mail chaque fois qu’un capteur indique que le niveau d’humidité a dépassé la valeur dans votre condition.

Nettoyer les ressources

Si vous n’envisagez pas de suivre d’autres guides de démarrage rapide ou didacticiels IoT Central, vous pouvez supprimer votre application IoT Central :

1. Dans votre application IoT Central, accédez à Gestion des applications>.
2. Sélectionnez Supprimer , puis confirmez votre action.

Étape suivante