Lernprogramm: Erstellen und Bereitstellen einer In-Store-Analyseanwendungsvorlage

Um die End-to-End-Lösung zu erstellen, verwenden Sie die IoT Central-Anwendungsvorlage für die In-Store-Analyse. Mit dieser Vorlage können Sie eine Verbindung mit der Umgebung eines Stores über verschiedene Sensorgeräte herstellen und überwachen. Diese Geräte generieren Telemetrie, die Sie in Geschäftseinblicke umwandeln können, um die Betriebskosten zu senken und für Ihre Kunden eine großartige Erfahrung zu schaffen.

In diesem Tutorial erfahren Sie, wie:

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Voraussetzungen

Um dieses Lernprogramm abzuschließen, müssen Sie das Befehlszeilentool dmr-client auf Ihrem lokalen Computer installieren:

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

Anwendungsarchitektur

Für viele Einzelhändler sind Umweltbedingungen eine wichtige Möglichkeit, ihre Geschäfte von den Filialen ihrer Konkurrenten zu unterscheiden. Die erfolgreichsten Einzelhändler bemühen sich, angenehme Bedingungen in ihren Geschäften für den Komfort ihrer Kunden aufrechtzuerhalten.

Die Anwendungsvorlage enthält eine Reihe von Gerätevorlagen und verwendet eine Reihe simulierter Geräte, um das Dashboard aufzufüllen:

Wie im vorherigen Anwendungsarchitekturdiagramm gezeigt, können Sie die Anwendungsvorlage verwenden, um:

• (1) Verbinden Sie verschiedene IoT-Sensoren mit einer IoT Central-Anwendungsinstanz.

  Eine IoT-Lösung beginnt mit einer Reihe von Sensoren, die aussagekräftige Signale aus einer Einzelhandelsgeschäftsumgebung erfassen. Die verschiedenen Symbole ganz links im Architekturdiagramm stellen die Sensoren dar.

• (2) Überwachen und Verwalten der Gesundheit des Sensornetzwerks und aller Gateway-Geräte in der Umgebung.

  Viele IoT-Sensoren können rohe Signale direkt in die Cloud oder auf ein Gatewaygerät in der Nähe einspeist. Das Gatewaygerät aggregiert Daten am Edge, bevor zusammenfassungserkenntnisse an eine IoT Central-Anwendung gesendet werden. Das Gatewaygerät ist auch für das Weiterleiten von Befehls- und Steuerungsvorgängen an die Sensorgeräte verantwortlich, falls zutreffend.

• (3) Erstellen Sie benutzerdefinierte Regeln, die Umgebungsbedingungen innerhalb eines Stores verwenden, um Warnungen für Store-Manager auszulösen.

  Die Azure IoT Central-Anwendung erfasst Daten aus den verschiedenen IoT-Sensoren und Gatewaygeräten innerhalb der Einzelhandelsgeschäftsumgebung und generiert dann eine Reihe aussagekräftiger Erkenntnisse.

  Azure IoT Central bietet außerdem eine maßgeschneiderte Benutzeroberfläche für Store-Betreiber, mit denen sie die Infrastrukturgeräte remote überwachen und verwalten können.

• (4) Transformieren Sie die Umweltbedingungen in den Geschäften in Einblicke, die das Store-Team verwenden kann, um die Kundenerfahrung zu verbessern.

  Sie können eine Azure IoT Central-Anwendung innerhalb einer Lösung konfigurieren, um rohe oder aggregierte Einblicke in eine Reihe von PaaS-Diensten (Azure Platform as a Service) zu exportieren. PaaS-Dienste können Datenmanipulation durchführen und diese Erkenntnisse erweitern, bevor sie in einer Geschäftsanwendung landen.

• (5) Exportieren Sie die aggregierten Erkenntnisse in bestehende oder neue Geschäftsanwendungen, um nützliche und zeitnahe Informationen für Einzelhandelsmitarbeiter bereitzustellen.

  Die IoT-Daten können verschiedene Arten von Geschäftsanwendungen bereitstellen, die in einer Einzelhandelsumgebung bereitgestellt werden. Ein Einzelhandelsgeschäftsleiter oder Mitarbeiter kann diese Anwendungen verwenden, um Geschäftseinblicke zu visualisieren und sinnvolle Maßnahmen in Echtzeit zu ergreifen. Sie erfahren, wie Sie ein Power BI-Dashboard in Echtzeit in den Exportdaten aus Azure IoT Central erstellen und Erkenntnisse im Power BI-Lernprogramm visualisieren .

Erstellen einer In-Store-Analyseanwendung

So erstellen Sie Ihre IoT Central-Anwendung:

1. Navigieren Sie im Azure-Portal zur Seite "IoT Central Application erstellen ". Wenn Sie dazu aufgefordert werden, melden Sie sich mit Ihrem Azure-Konto an.

2. Geben Sie die folgenden Informationen ein:

   Feld	Description
   Subscription	Das Azure-Abonnement, das Sie verwenden möchten.
   Ressourcengruppe	Die Ressourcengruppe, die Sie verwenden möchten. Sie können eine neue Ressourcengruppe erstellen oder eine vorhandene verwenden.
   Ressourcenname	Ein gültiger Azure-Ressourcenname.
   Anwendungs-URL	Die URL-Unterdomäne für Ihre Anwendung. Die URL für eine IoT Central-Anwendung sieht aus wie https://yoursubdomain.azureiotcentral.com.
   Template	In-Store-Analyse – Auschecken
   Region	Die Azure-Region, die Sie verwenden möchten.
   Preisplan	Der Preisplan, den Sie verwenden möchten.

3. Klicken Sie auf Überprüfen + erstellen. Wählen Sie dann Erstellen aus.

Wenn die App bereit ist, können Sie über das Azure-Portal zu ihr navigieren:

Weitere Informationen finden Sie unter Erstellen einer Azure IoT Central-Anwendung.

Die Anwendung durchgehen

In den folgenden Abschnitten werden die wichtigsten Features der Anwendung beschrieben.

Anpassen der Anwendungseinstellungen

Sie können mehrere Einstellungen ändern, um die Benutzererfahrung in Ihrer Anwendung anzupassen. Mit einem benutzerdefinierten Design können Sie die Anwendungsbrowserfarben, das Browsersymbol und das Anwendungslogo festlegen, das in der Kopfspitze angezeigt wird.

Verwenden Sie zum Erstellen eines benutzerdefinierten Designs die Beispielbilder, um die Anwendung anzupassen. Laden Sie die vier Contoso-Beispielbilder von GitHub herunter.

So erstellen Sie ein benutzerdefiniertes Design:

1. Wählen Sie im linken Bereich die Option "Anpassungsdarstellung" >aus.

2. Um das Mastkopflogo zu ändern, wählen Sie "Ändern" und dann das contoso_wht_mast.png Bild aus, das hochgeladen werden soll. Geben Sie optional einen Wert für Alternativtext für Logo ein.

3. Um das Browsersymbol zu ändern, wählen Sie "Ändern" aus, und wählen Sie dann das contoso_favicon.png Bild aus, das auf Browserregisterkarten angezeigt werden soll.

4. Ersetzen Sie die Standardbrowserfarben durch Hinzufügen von HTML-Hexadezimalfarbcodes:

   • Geben Sie für "Kopfzeile" "#008575" ein.
   • Geben Sie für Akzent#A1F3EA ein.

5. Wählen Sie Speichern aus. Nachdem Sie Ihre Änderungen gespeichert haben, aktualisiert die Anwendung die Browserfarben, das Logo im Mastkopf und das Browsersymbol.

So aktualisieren Sie das Anwendungsbild, das auf der Anwendungskachel auf der Seite "Meine Apps" der Website "Meine Apps" von Azure IoT Central My angezeigt wird:

1. Wählen Sie "Anwendungsverwaltung" >aus.

2. Wählen Sie "Ändern" und dann das contoso_main_lg.png Bild aus, das als Anwendungsbild hochgeladen werden soll.

3. Wählen Sie Speichern aus.

Erstellen der Gerätevorlagen

Mit Gerätevorlagen können Sie Geräte konfigurieren und verwalten. Sie können eine benutzerdefinierte Vorlage erstellen, eine vorhandene Vorlagendatei importieren oder eine Vorlage aus der Liste der empfohlenen Gerätevorlagen importieren. Nachdem Sie eine Gerätevorlage erstellt und angepasst haben, verwenden Sie sie, um echte Geräte mit Ihrer Anwendung zu verbinden.

Optional können Sie eine Gerätevorlage verwenden, um simulierte Geräte zu Testzwecken zu generieren.

Die Anwendungsvorlage In-store analytics - checkout enthält mehrere vorinstallierte Gerätevorlagen. Die RuuviTag-Gerätevorlage ist nicht in der Anwendungsvorlage In-Store-Analyse, Checkout enthalten.

In diesem Abschnitt fügen Sie Ihrer Anwendung eine Gerätevorlage für RuuviTag-Sensoren hinzu. Gehen Sie folgendermaßen vor:

1. Führen Sie den folgenden Befehl aus, um eine Kopie der RuuviTag-Gerätevorlage aus dem Modell-Repository herunterzuladen:

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

2. Wählen Sie im linken Bereich "Gerätevorlagen" aus.

3. Wählen Sie +Neu aus, um eine neue Gerätevorlage zu erstellen.

4. Wählen Sie die IoT-Gerätekachel und dann "Weiter: Anpassen" aus.

5. Geben Sie auf der Seite "Anpassen"RuuviTag als Gerätevorlagennamen ein.

6. Klicken Sie auf Weiter: Überprüfen.

7. Wählen Sie "Erstellen" aus.

8. Wählen Sie die Kachel "Modell importieren " aus. Suchen und importieren Sie dann die ruuvitag.json-Datei, die Sie zuvor heruntergeladen haben.

9. Nachdem der Import abgeschlossen ist, wählen Sie "Veröffentlichen " aus, um die Gerätevorlage zu veröffentlichen.

10. Wählen Sie im linken Bereich "Gerätevorlagen" aus.

    Auf der Seite werden alle Gerätevorlagen in der Anwendungsvorlage und die soeben hinzugefügte RuuviTag-Gerätevorlage angezeigt.

Anpassen der Gerätevorlagen

Sie können die Gerätevorlagen in Ihrer Anwendung auf drei Arten anpassen:

• Passen Sie die systemeigenen integrierten Schnittstellen in Ihren Geräten an, indem Sie die Gerätefunktionen ändern.

  Beispielsweise können Sie mit einem Temperatursensor Details wie den Anzeigenamen und die Maßeinheiten ändern.

• Passen Sie Ihre Gerätevorlagen an, indem Sie Cloudeigenschaften hinzufügen.

  Cloudeigenschaften sind benutzerdefinierte Daten, die Ihre Azure IoT Central-Anwendung erstellt, speichert und mit Ihren Geräten verknüpft. Beispiele für Cloudeigenschaften sind:

  • Ein berechneter Wert.
  • Metadaten, z. B. einen Speicherort, den Sie einer Gruppe von Geräten zuordnen möchten.

• Passen Sie Gerätevorlagen an, indem Sie benutzerdefinierte Ansichten erstellen.

  Ansichten bieten eine Möglichkeit für Bediener, Telemetrie und Metadaten für deren Geräte zu visualisieren, z. B. Gerätemetriken und Gesundheit.

In diesem Abschnitt verwenden Sie die ersten beiden Methoden, um die Gerätevorlage für Ihre RuuviTag-Sensoren anzupassen.

So passen Sie die integrierten Schnittstellen der RuuviTag-Gerätevorlage an:

1. Wählen Sie im linken Bereich "Gerätevorlagen" aus.

2. Wählen Sie "RuuviTag" aus.

3. Blenden Sie den linken Bereich aus. In der Zusammenfassungsansicht der Vorlage werden die Gerätefunktionen angezeigt.

   

4. Wählen Sie das RuuviTag-Modell im Menü "RuuviTag-Gerätevorlage" aus.

5. Scrollen Sie in der Liste der Funktionen nach dem Telemetrietyp RelativeHumidity (Relative Luftfeuchtigkeit). Dies ist das Zeilenelement mit dem bearbeitbaren Wert RelativeHumidity (Relative Luftfeuchtigkeit) für Anzeigename.

In den folgenden Schritten passen Sie den Telemetrietyp "RelativeHumidity " für die RuuviTag-Sensoren an. Optional können Sie einige der anderen Telemetrietypen anpassen.

Nehmen Sie für den Telemetrietyp "RelativeHumidity " die folgenden Änderungen vor:

1. Aktualisieren Sie den Anzeigenamenwert von RelativeHumidity auf einen benutzerdefinierten Wert wie Luftfeuchtigkeit.

2. Ändern Sie die Option "Semantischer Typ " von "Relative Luftfeuchtigkeit " in "Feuchtigkeit".

   Legen Sie optional Schemawerte für den Telemetrietyp Luftfeuchtigkeit in der erweiterten Schemaansicht fest. Durch Festlegen von Schemawerten können Sie detaillierte Validierungsanforderungen für die Daten erstellen, die Ihre Sensoren nachverfolgen. Sie können z. B. mindest- und maximal zulässige Betriebsbereiche für eine angegebene Schnittstelle festlegen.

3. Wählen Sie Speichern, um Ihre Änderungen zu speichern.

So fügen Sie einer Gerätevorlage in Ihrer Anwendung eine Cloudeigenschaft hinzu:

1. Wählen Sie "Funktion hinzufügen" aus.

2. Geben Sie unter Anzeigename den Ort ein.

   Dieser Wert, der als benutzerfreundlicher Name für die Eigenschaft dient, wird automatisch in das Feld Name kopiert. Sie können den kopierten Wert verwenden oder ihn ändern.

3. Wählen Sie für funktionstyp die Option "Cloud-Eigenschaft" aus.

4. Wählen Sie "Erweitern" aus.

5. Wählen Sie in der Dropdownliste "Schema" die Option "Zeichenfolge" aus.

   Mit dieser Option können Sie einem beliebigen Gerät basierend auf der Vorlage einen Standortnamen zuordnen. Sie könnten zum Beispiel einen benannten Bereich in einem Geschäft jedem Gerät zuordnen.

6. Legen Sie die Mindestlänge auf 2 fest.

7. Stellen Sie die Option Leerzeichen kürzen auf Ein.

8. Wählen Sie "Speichern" aus, um Ihre benutzerdefinierte Cloudeigenschaft zu speichern.

9. Wählen Sie Veröffentlichen aus.

   Durch das Veröffentlichen einer Gerätevorlage werden die Aktualisierungen für Anwendungsoperatoren sichtbar. Nachdem Sie eine Vorlage veröffentlicht haben, verwenden Sie sie, um simulierte Geräte zum Testen zu generieren oder echte Geräte mit Ihrer Anwendung zu verbinden. Wenn Bereits Geräte mit Ihrer Anwendung verbunden sind, verschiebt die Veröffentlichung einer angepassten Vorlage die Änderungen an die Geräte.

Hinzufügen von Geräten

Nachdem Sie die Gerätevorlagen erstellt und angepasst haben, ist es an der Zeit, Geräte hinzuzufügen. In diesem Lernprogramm verwenden Sie die folgende Gruppe simulierter Geräte, um die Anwendung zu erstellen:

• Ein Rigado C500-Gateway.
• Zwei RuuviTag-Sensoren .
• Ein Belegungssensor . Dieser simulierte Sensor ist in der Anwendungsvorlage enthalten, sodass Sie ihn nicht erstellen müssen.

So fügen Sie Ihrer Anwendung ein simuliertes Rigado Cascade 500-Gatewaygerät hinzu:

1. Wählen Sie im linken Bereich "Geräte" aus.

2. Wählen Sie C500 in der Liste der verfügbaren Gerätevorlagen und dann "Neu" aus.

3. Geben Sie C500-Gateway als Gerätenamen und Gateway-001 als Geräte-ID ein.

4. Stellen Sie sicher, dass C500 die ausgewählte Gerätevorlage ist, und legen Sie dann " Dieses Gerät simulieren" auf "Ja" fest.

5. Wählen Sie "Erstellen" aus. Ihre Anwendung enthält jetzt ein simuliertes Rigado Cascade 500-Gatewaygerät.

So fügen Sie Ihrer Anwendung ein simuliertes RuuviTag-Sensorgerät hinzu:

1. Wählen Sie im linken Bereich "Geräte" aus.

2. Wählen Sie "RuuviTag " in der Liste der verfügbaren Gerätevorlagen und dann " Neu" aus.

3. Geben Sie RuuviTag 001 als Gerätenamen und ruuvitag-001 als Geräte-ID ein.

4. Stellen Sie sicher, dass RuuviTag die ausgewählte Gerätevorlage ist, und legen Sie dann " Dieses Gerät simulieren" auf "Ja" fest.

5. Wählen Sie "Erstellen" aus. Ihre Anwendung enthält jetzt ein simuliertes RuuviTag-Sensorgerät.

Wiederholen Sie die vorherigen Schritte, um Ihrer Anwendung ein zweites simuliertes RuuviTag-Sensorgerät hinzuzufügen. Geben Sie RuuviTag 002 als Gerätenamen und ruuvitag-002 als Geräte-ID ein.

So verbinden Sie die beiden RuuviTag-Sensor- und Belegungsgeräte mit dem Gatewaygerät:

1. Wählen Sie im linken Bereich "Geräte" aus.

2. Wählen Sie in der Liste der Geräte RuuviTag 001, RuuviTag 002 und Belegung aus. Wählen Sie dann in der Befehlsleiste Mit Gateway verbinden aus.

3. Wählen Sie im Bereich "An Gateway anfügen " C500 als Gerätevorlage und C500 – Gateway als Gerät aus. Wählen Sie dann "Anfügen" aus.

Wenn Sie zum C500 - Gatewaygerät navigieren und die Registerkarte "Nachgeschaltete Geräte " auswählen, werden nun drei Geräte an das Gateway angeschlossen.

Hinzufügen von Regeln und Aktionen

Im Rahmen der Verwendung von Sensoren in Ihrer Azure IoT Central-Anwendung zum Überwachen von Bedingungen können Sie Regeln zum Ausführen von Aktionen erstellen, wenn bestimmte Bedingungen erfüllt sind.

Eine Regel ist einer Gerätevorlage und einem oder mehreren Geräten zugeordnet und enthält Bedingungen, die auf der Grundlage von Gerätetelemetrie oder Ereignissen erfüllt werden müssen. Eine Regel verfügt auch über eine oder mehrere zugeordnete Aktionen. Die Aktionen können das Senden von E-Mail-Benachrichtigungen oder das Auslösen einer Webhook-Aktion zum Senden von Daten an andere Dienste umfassen. Die In-Store-Analyse – Auscheckanwendungsvorlage enthält einige vordefinierte Regeln für die Geräte in der Anwendung.

In diesem Abschnitt erstellen Sie eine neue Regel, die die maximale relative Luftfeuchtigkeitsstufe basierend auf der RuuviTag-Sensortelemetrie überprüft. Sie fügen der Regel eine Aktion hinzu, sodass die Anwendung eine E-Mail-Benachrichtigung sendet, wenn die Luftfeuchtigkeit das Maximum überschreitet.

So erstellen Sie eine Regel:

1. Wählen Sie im linken Bereich "Regeln" aus.

2. Wählen Sie "Neu" aus.

3. Geben Sie den Luftfeuchtigkeitsgrad als Namen der Regel ein.

4. Wählen Sie für die Gerätevorlage die RuuviTag-Gerätevorlage aus.

   Die regel, die Sie definieren, gilt für alle Sensoren, die auf dieser Vorlage basieren. Optional können Sie einen Filter erstellen, der die Regel nur auf eine definierte Teilmenge der Sensoren anwenden würde.

5. Wählen Sie für Telemetriedie Option "RelativeHumidity" aus. Es handelt sich um die Gerätefunktion, die Sie in einem früheren Schritt angepasst haben.

6. Wählen Sie bei OperatorGrößer als aus.

7. Geben Sie für "Wert" einen typischen oberen Luftfeuchtigkeitsgrad für Ihre Umgebung ein (z. B. 65).

   Diese Bedingung gilt, wenn die relative Luftfeuchtigkeit in einem RuuviTag-Sensor den Wert überschreitet. Möglicherweise müssen Sie den Wert je nach normaler Luftfeuchtigkeit in Ihrer Umgebung nach oben oder unten anpassen.

So fügen Sie der Regel eine Aktion hinzu:

1. Wählen Sie E-Mail aus.

2. Geben Sie einen freundlichen Anzeigenamen für die Aktion ein, z.B. Benachrichtigung über hohe Luftfeuchtigkeit.

3. Geben Sie für "An" die E-Mail-Adresse ein, die Ihrem Konto zugeordnet ist.

   Wenn Sie eine andere E-Mail-Adresse verwenden, muss es sich um einen Benutzer handeln, der der Anwendung hinzugefügt wurde. Der Benutzer muss sich auch mindestens einmal anmelden und abmelden.

4. Geben Sie optional eine Notiz ein, die in den Text der E-Mail aufgenommen werden soll.

5. Wählen Sie "Fertig" aus, um die Aktion abzuschließen.

6. Wählen Sie "Speichern" aus, um die neue Regel zu speichern und zu aktivieren.

   Innerhalb weniger Minuten sollte das angegebene E-Mail-Konto mit dem Empfangen von Nachrichten beginnen. Die Anwendung sendet E-Mails jedes Mal, wenn ein Sensor angibt, dass der Luftfeuchtigkeitsgrad den Wert in Ihrer Bedingung überschritten hat.

Bereinigen von Ressourcen

Falls Sie keine weiteren IoT Central-Schnellstarts oder -Tutorials absolvieren möchten, können Sie die IoT Central-Anwendung löschen:

1. Navigieren Sie in Ihrer IoT Central-Anwendung zu "Anwendungsverwaltung > ".
2. Wählen Sie Löschen aus, und bestätigen Sie anschließend Ihre Aktion.

Nächster Schritt