Samouczek: tworzenie i wdrażanie szablonu aplikacji analitycznej w sklepie

Aby utworzyć kompleksowe rozwiązanie, użyj szablonu aplikacji analizy przy kasie IoT Central w sklepowych. Ten szablon umożliwia łączenie się ze środowiskiem sklepu i monitorowanie go za pośrednictwem różnych urządzeń czujników. Te urządzenia generują dane telemetryczne, które można przekształcić w szczegółowe informacje biznesowe, aby zmniejszyć koszty operacyjne i stworzyć doskonałe środowisko dla klientów.

W tym poradniku nauczysz się, jak:

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Wymagania wstępne

Aby ukończyć ten samouczek, musisz zainstalować narzędzie wiersza polecenia dmr-client na komputerze lokalnym:

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

Architektura aplikacji

Dla wielu sprzedawców detalicznych warunki środowiskowe są kluczowym sposobem odróżnienia swoich sklepów od sklepów konkurencji. Najbardziej udani sprzedawcy detaliczni dokładają wszelkich starań, aby utrzymać przyjemne warunki w swoich sklepach dla komfortu swoich klientów.

Szablon aplikacji zawiera zestaw szablonów urządzeń i używa zestawu symulowanych urządzeń do wypełnienia pulpitu nawigacyjnego:

Jak pokazano na poprzednim diagramie architektury aplikacji, możesz użyć szablonu aplikacji do:

• (1) Łączenie różnych czujników IoT z wystąpieniem aplikacji usługi IoT Central.

  Rozwiązanie IoT rozpoczyna się od zestawu czujników, które przechwytują znaczące sygnały z poziomu środowiska sklepu detalicznego. Różne ikony po lewej stronie diagramu architektury reprezentują czujniki.

• (2) Monitorowanie kondycji sieci czujników i wszystkich urządzeń bramy w środowisku oraz zarządzanie nimi.

  Wiele czujników IoT może dawać nieprzetworzone sygnały bezpośrednio do chmury lub do urządzenia bramy znajdującego się w pobliżu. Urządzenie bramy agreguje dane na brzegu sieci, zanim wyśle podsumowane spostrzeżenia do aplikacji usługi IoT Central. Urządzenie bramy jest również odpowiedzialne za przekazywanie komend i operacji kontrolnych do urządzeń sensorycznych, jeśli ma to zastosowanie.

• (3) Utwórz niestandardowe reguły, które używają warunków środowiskowych w magazynie do wyzwalania alertów dla menedżerów sklepów.

  Aplikacja usługi Azure IoT Central pozyskuje dane z różnych czujników IoT i urządzeń bramy w środowisku sklepu detalicznego, a następnie generuje zestaw znaczących szczegółowych informacji.

  Usługa Azure IoT Central udostępnia również dostosowane środowisko dla operatorów sklepów, które pozwala im zdalnie monitorować urządzenia infrastruktury i zarządzać nimi.

• (4) Przekształć warunki środowiskowe w sklepach w szczegółowe informacje, których zespół sklepu może użyć w celu poprawy jakości obsługi klienta.

  Aplikację usługi Azure IoT Central można skonfigurować w ramach rozwiązania, aby wyeksportować nieprzetworzone lub zagregowane szczegółowe informacje do zestawu usług Platformy jako usługi (PaaS) platformy Azure. Usługi PaaS mogą wykonywać manipulowanie danymi i wzbogacać te szczegółowe informacje przed rozpoczęciem pracy z aplikacją biznesową.

• (5) Wyeksportuj zagregowany wgląd w istniejące lub nowe aplikacje biznesowe, aby udostępnić przydatne i terminowe informacje pracownikom handlu detalicznego.

  Dane IoT mogą zasilać różne rodzaje aplikacji biznesowych wdrożonych w środowisku detalicznym. Menedżer sklepu detalicznego lub pracownik może używać tych aplikacji do wizualizowania analiz biznesowych i wykonywania znaczących działań w czasie rzeczywistym. Dowiesz się, jak stworzyć pulpit nawigacyjny Power BI w czasie rzeczywistym w samouczku Eksportowanie danych z Azure IoT Central i wizualizacja wniosków w Power BI.

Tworzenie aplikacji analitycznej w sklepie

Aby utworzyć aplikację usługi IoT Central:

1. Przejdź do strony Tworzenie aplikacji usługi IoT Central w witrynie Azure Portal. Jeśli zostanie wyświetlony monit, zaloguj się przy użyciu konta platformy Azure.

2. Wprowadź następujące informacje:

   (No changes needed)	Description
   Subscription	Subskrypcja platformy Azure, której chcesz użyć.
   Grupa zasobów	Grupa zasobów, której chcesz użyć. Możesz utworzyć nową grupę zasobów lub użyć istniejącej.
   Nazwa zasobu	Prawidłowa nazwa zasobu platformy Azure.
   Adres URL aplikacji	Poddomena adresu URL dla aplikacji. Adres URL aplikacji usługi IoT Central wygląda następująco: https://yoursubdomain.azureiotcentral.com.
   Template	Analiza w sklepie — kasa
   Region	Region platformy Azure, którego chcesz użyć.
   Plan cenowy	Plan cenowy, którego chcesz użyć.

3. Wybierz opcję Recenzja i utwórz. Następnie wybierz Utwórz.

Gdy aplikacja jest gotowa, możesz przejść do niej z witryny Azure Portal:

Aby dowiedzieć się więcej, zobacz Tworzenie aplikacji usługi Azure IoT Central.

Zapoznaj się z aplikacją

W poniższych sekcjach opisano kluczowe funkcje aplikacji.

Dostosowywanie ustawień aplikacji

Możesz zmienić kilka ustawień, aby dostosować środowisko użytkownika w aplikacji. Motyw niestandardowy umożliwia ustawienie kolorów przeglądarki aplikacji, ikony przeglądarki oraz logo aplikacji wyświetlanego w nagłówku.

Aby utworzyć motyw niestandardowy, użyj przykładowych obrazów, aby dostosować aplikację. Pobierz cztery przykładowe obrazy firmy Contoso z usługi GitHub.

Aby utworzyć motyw niestandardowy:

1. W okienku po lewej stronie wybierz pozycję Dostosowywanie Wyglądu>.

2. Aby zmienić logo nagłówka, wybierz pozycję Zmień, a następnie wybierz obraz contoso_wht_mast.png do przesłania. Opcjonalnie wprowadź wartość w polu Tekst alternatywny logo.

3. Aby zmienić ikonę przeglądarki, wybierz pozycję Zmień, a następnie wybierz obraz contoso_favicon.png , który ma być wyświetlany na kartach przeglądarki.

4. Zastąp domyślne kolory przeglądarki , dodając kody kolorów szesnastkowych HTML:

   • W polu Nagłówek wpisz #008575.
   • W polu Akcent wprowadź #A1F3EA.

5. Wybierz Zapisz. Po zapisaniu zmian aplikacja aktualizuje kolory przeglądarki, logo na czole i ikonę przeglądarki.

Aby zaktualizować obraz aplikacji wyświetlany na kafelku aplikacji na stronie Moje aplikacje w witrynie Moje aplikacje usługi Azure IoT Central :

1. Wybierz pozycję Zarządzanie aplikacjami>.

2. Wybierz pozycję Zmień, a następnie wybierz obraz contoso_main_lg.png do przekazania jako obraz aplikacji.

3. Wybierz Zapisz.

Tworzenie szablonów urządzeń

Szablony urządzeń umożliwiają konfigurowanie urządzeń i zarządzanie nimi. Możesz utworzyć szablon niestandardowy, zaimportować istniejący plik szablonu lub zaimportować szablon z listy polecanych szablonów urządzeń. Po utworzeniu i dostosowaniu szablonu urządzenia użyj go do łączenia rzeczywistych urządzeń z aplikacją.

Opcjonalnie możesz użyć szablonu urządzenia do generowania symulowanych urządzeń na potrzeby testowania.

Analiza sklepowa — szablon aplikacji kasowej zawiera kilka wstępnie zainstalowanych szablonów urządzeń. Szablon urządzenia RuuviTag nie jest uwzględniony w szablonie aplikacji analiza w sklepie — wykonywanie transakcji.

W tej sekcji do aplikacji dodasz szablon urządzenia dla czujników RuuviTag. Aby to zrobić:

1. Aby pobrać kopię szablonu urządzenia RuuviTag z repozytorium modelu, uruchom następujące polecenie:

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

2. W okienku po lewej stronie wybierz pozycję Szablony urządzeń.

3. Wybierz opcję + Nowy, aby utworzyć nowy szablon urządzenia.

4. Wybierz kafelek urządzenia IoT, a następnie wybierz pozycję Dalej: Dostosuj.

5. Na stronie Dostosowywanie wprowadź ruuviTag jako nazwę szablonu urządzenia.

6. Wybierz Następnie: Przejrzyj.

7. Wybierz Utwórz.

8. Wybierz kafelek Importuj model . Następnie wyszukaj i zaimportuj pobrany wcześniej plik ruuvitag.json .

9. Po zakończeniu importowania wybierz pozycję Publikuj , aby opublikować szablon urządzenia.

10. W okienku po lewej stronie wybierz pozycję Szablony urządzeń.

    Na stronie zostaną wyświetlone wszystkie szablony urządzeń w szablonie aplikacji i właśnie dodany szablon urządzenia RuuviTag.

Dostosowywanie szablonów urządzeń

Szablony urządzeń można dostosować w aplikacji na trzy sposoby:

• Dostosuj natywne wbudowane interfejsy Twoich urządzeń, zmieniając ich funkcje.

  Na przykład za pomocą czujnika temperatury można zmienić szczegóły, takie jak nazwa wyświetlana i jednostki miary.

• Dostosuj szablony urządzeń, dodając właściwości chmury.

  Właściwości chmury to dane niestandardowe, które aplikacja usługi Azure IoT Central tworzy, przechowuje i kojarzy z urządzeniami. Przykłady właściwości chmury to:

  • Wartość obliczeniowa.
  • Metadane, takie jak lokalizacja, którą chcesz skojarzyć z zestawem urządzeń.

• Dostosuj szablony urządzeń, tworząc widoki własne.

  Widoki umożliwiają operatorom wizualizowanie danych telemetrycznych i metadanych dla urządzeń, takich jak metryki urządzeń i kondycja.

W tej sekcji użyjesz dwóch pierwszych metod, aby dostosować szablon urządzenia dla czujników RuuviTag.

Aby dostosować wbudowane interfejsy szablonu urządzenia RuuviTag:

1. W okienku po lewej stronie wybierz pozycję Szablony urządzeń.

2. Wybierz pozycję RuuviTag.

3. Ukryj lewe okienko. W widoku podsumowania szablonu są wyświetlane możliwości urządzenia.

   

4. Wybierz model RuuviTag w menu szablonu urządzenia RuuviTag.

5. W liście funkcji przewiń do typu telemetrii RelativeHumidity. Jest to element wiersza z edytowalną wartością Nazwa wyświetlanaRelativeHumidity.

W poniższych krokach dostosujesz typ telemetrii RelativeHumidity dla czujników RuuviTag. Opcjonalnie możesz dostosować niektóre z innych typów telemetrii.

Dla typu telemetrii RelativeHumidity wprowadź następujące zmiany:

1. Zaktualizuj wartość Nazwa wyświetlana z RelativeHumidity na wartość niestandardową, taką jak Wilgotność.

2. Zmień opcję Typ semantyczny z Względna wilgotność na Wilgotność.

   Opcjonalnie ustaw wartości schematu dla typu telemetrii wilgotności w rozszerzonym widoku schematu. Ustawiając wartości schematu, można utworzyć szczegółowe wymagania dotyczące walidacji dla danych śledzone przez czujniki. Można na przykład ustawić minimalne i maksymalne wartości zakresu operacyjnego dla określonego interfejsu.

3. Wybierz Zapisz, aby zapisać zmiany.

Aby dodać właściwość w chmurze do szablonu urządzenia w aplikacji:

1. Wybierz Dodaj funkcję.

2. Dla nazwa wyświetlana, wprowadź Lokalizacja.

   Ta wartość, która jest przyjazną nazwą właściwości, jest automatycznie kopiowana do nazwy. Możesz użyć skopiowanych wartości lub zmienić ją.

3. W polu Typ możliwości wybierz pozycję Właściwość chmury.

4. Wybierz pozycję Rozwiń.

5. Z listy rozwijanej Schemat wybierz pozycję Ciąg.

   Ta opcja umożliwia skojarzenie nazwy lokalizacji z dowolnym urządzeniem na podstawie szablonu. Można na przykład skojarzyć nazwany obszar w magazynie z każdym urządzeniem.

6. Ustaw minimalną długość na 2.

7. Ustaw Przycinanie białych znaków na Włączone.

8. Wybierz pozycję Zapisz , aby zapisać niestandardową właściwość chmury.

9. Wybierz Publikuj.

   Publikowanie szablonu urządzenia powoduje, że aktualizacje są widoczne dla operatorów aplikacji. Po opublikowaniu szablonu użyj go do wygenerowania symulowanych urządzeń na potrzeby testowania lub połączenia rzeczywistych urządzeń z aplikacją. Jeśli masz już urządzenia połączone z aplikacją, opublikowanie dostosowanego szablonu wypycha zmiany do urządzeń.

Dodawanie urządzeń

Po utworzeniu i dostosowaniu szablonów urządzeń nadszedł czas, aby dodać urządzenia. Na potrzeby tego samouczka użyjesz następującego zestawu symulowanych urządzeń do skompilowania aplikacji:

• Brama sieciowa Rigado C500.
• Dwa czujniki RuuviTag .
• Czujnik zajętości . Ten symulowany czujnik jest dołączony do szablonu aplikacji, więc nie trzeba go tworzyć.

Aby dodać symulowane urządzenie bramy Rigado Cascade 500 do aplikacji:

1. W okienku po lewej stronie wybierz pozycję Urządzenia.

2. Wybierz pozycję C500 na liście dostępnych szablonów urządzeń, a następnie wybierz pozycję Nowy.

3. Wprowadź C500 gateway jako nazwę urządzenia i gateway-001 jako identyfikator urządzenia.

4. Upewnij się, że wybrano szablon urządzenia C500 , a następnie ustaw opcję Symulowanie tego urządzenia? na wartość Tak.

5. Wybierz Utwórz. Aplikacja zawiera teraz symulowane urządzenie bramy Rigado Cascade 500.

Aby dodać symulowane urządzenie czujnika RuuviTag do aplikacji:

1. W okienku po lewej stronie wybierz pozycję Urządzenia.

2. Wybierz pozycję RuuviTag na liście dostępnych szablonów urządzeń, a następnie wybierz pozycję Nowy.

3. Wprowadź ruuviTag 001 jako nazwę urządzenia i ruuvitag-001 jako identyfikator urządzenia.

4. Upewnij się, że element RuuviTag jest wybranym szablonem urządzenia, a następnie ustaw opcję Symulowanie tego urządzenia? na wartość Tak.

5. Wybierz Utwórz. Aplikacja zawiera teraz symulowane urządzenie czujnika RuuviTag.

Powtórz poprzednie kroki, aby dodać drugie symulowane urządzenie czujnika RuuviTag do aplikacji. Wprowadź RuuviTag 002 jako nazwę urządzenia i ruuvitag-002 jako identyfikator urządzenia.

Aby połączyć dwa czujniki RuuviTag i urządzenia do monitorowania obecności z urządzeniem bramowym:

1. W okienku po lewej stronie wybierz pozycję Urządzenia.

2. Na liście urządzeń wybierz pozycję RuuviTag 001, RuuviTag 002 i Occupancy. Następnie na pasku poleceń wybierz pozycję Dołącz do bramy.

3. W okienku Dołączanie do bramy wybierz pozycję C500 jako szablon urządzenia, a jako urządzenie wybierz pozycję C500 — brama . Następnie wybierz pozycję Dołącz.

Jeśli przejdziesz do urządzenia C500 - brama i wybierzesz kartę Urządzenia poniżej, zobaczysz teraz trzy urządzenia dołączone do bramy.

Dodawanie reguł i akcji

W ramach korzystania z czujników w aplikacji usługi Azure IoT Central do monitorowania warunków można tworzyć reguły uruchamiania akcji po spełnieniu określonych warunków.

Reguła jest skojarzona z szablonem urządzenia i co najmniej jednym urządzeniem i zawiera warunki, które muszą zostać spełnione na podstawie danych telemetrycznych lub zdarzeń urządzenia. Reguła zawiera również jedną lub więcej skojarzonych akcji. Akcje mogą obejmować powiadomienia e-mail lub wyzwalanie akcji webhooka, aby wysyłać dane do innych usług. Analiza w sklepie — szablon aplikacji do wyewidencjonowania zawiera niektóre wstępnie zdefiniowane reguły dla urządzeń w aplikacji.

W tej sekcji utworzysz nową regułę, która sprawdza maksymalny poziom wilgotności względnej na podstawie telemetrii czujnika RuuviTag. Do reguły należy dodać akcję, aby w przypadku przekroczenia maksymalnej wilgotności aplikacja wysyłała powiadomienie e-mail.

Aby utworzyć regułę:

1. W okienku po lewej stronie wybierz pozycję Reguły.

2. Wybierz Nowy.

3. Wprowadź poziom wilgotności jako nazwę reguły.

4. W polu Szablon urządzenia wybierz szablon urządzenia RuuviTag.

   Zdefiniowana reguła dotyczy wszystkich czujników na podstawie tego szablonu. Opcjonalnie można utworzyć filtr, który będzie stosować regułę tylko do zdefiniowanego podzestawu czujników.

5. Dla Telemetria wybierz RelativeHumidity. Jest to możliwość urządzenia, którą dostosowano we wcześniejszym kroku.

6. Dla Operator wybierz Większe niż.

7. W polu Wartość wprowadź typowy górny poziom wilgotności wewnątrz środowiska (na przykład 65).

   Ten warunek ma zastosowanie, gdy względna wilgotność w dowolnym czujniku RuuviTag przekracza wartość. Może być konieczne dostosowanie wartości w górę lub w dół w zależności od normalnego zakresu wilgotności w środowisku.

Aby dodać akcję do reguły:

1. Wybierz pozycję Poczta e-mail.

2. Wprowadź powiadomienie o wysokiej wilgotności jako przyjazną nazwę wyświetlaną dla akcji.

3. W polu Do wprowadź adres e-mail skojarzony z kontem.

   Jeśli używasz innego adresu e-mail, należy użyć go dla użytkownika, który został dodany do aplikacji. Użytkownik musi również zalogować się i wylogować się co najmniej raz.

4. Opcjonalnie wprowadź notatkę do uwzględnienia w tekście wiadomości e-mail.

5. Wybierz pozycję Gotowe , aby ukończyć akcję.

6. Wybierz pozycję Zapisz , aby zapisać i aktywować nową regułę.

   W ciągu kilku minut określone konto e-mail powinno rozpocząć odbieranie wiadomości. Aplikacja wysyła e-mail za każdym razem, gdy czujnik wskazuje, że poziom wilgotności przekroczył wartość określoną w warunkach.

Uprzątnij zasoby

Jeśli nie planujesz ukończenia dalszych przewodników szybkiego startu lub samouczków IoT Central, możesz usunąć aplikację IoT Central.

1. W aplikacji usługi IoT Central przejdź do obszaru Zarządzanie aplikacjami>.
2. Wybierz pozycję Usuń , a następnie potwierdź akcję.

Następny krok