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

  • Artykuł

Aby utworzyć kompleksowe rozwiązanie, użyj szablonu aplikacji do wyewidencjonowania wyewidencjonowania usługi IoT Central w sklepie. 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.

Z tego samouczka dowiesz się, jak wykonywać następujące czynności:

  • Korzystanie z analizy w sklepie usługi Azure IoT Central — szablon wyewidencjonowania w celu utworzenia aplikacji sklepu detalicznego
  • Dostosowywanie ustawień aplikacji
  • Tworzenie i dostosowywanie szablonów urządzeń IoT
  • Połączenie urządzenia do aplikacji
  • Dodawanie reguł i akcji w celu monitorowania warunków

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:

Diagram architektury aplikacji analitycznych w sklepie.

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

  • (1) Połączenie różnych czujników IoT do wystąpienia 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, zanim wyśle podsumowanie szczegółowych informacji do aplikacji usługi IoT Central. Urządzenie bramy jest również odpowiedzialne za przekazywanie operacji poleceń i kontroli do urządzeń czujników, 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. Dowiedz się, jak utworzyć pulpit nawigacyjny usługi Power BI w czasie rzeczywistym w samouczku Eksportowanie danych z usługi Azure IoT Central i wizualizowanie szczegółowych informacji w usłudze Power BI .

Tworzenie aplikacji do analizy w sklepie

Aby utworzyć aplikację usługi IoT Central:

  1. Przejdź do strony Tworzenie aplikacji usługi IoT Central w witrynie Azure Portal. W przypadku wyświetlenia monitu zaloguj się przy użyciu konta platformy Azure.

  2. Wprowadź następujące informacje:

    Pole opis
    Subskrypcja Subskrypcja platformy Azure, której chcesz użyć.
    Grupa zasobów Grupa zasobów, której chcesz użyć. istnieje możliwość utworzenia nowej lub użycia istniejącej grupy zasobów.
    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 — wyewidencjonuj
    Region (Region) Region platformy Azure, którego chcesz użyć.
    Plan cenowy Plan cenowy, którego chcesz użyć.

  3. Wybierz pozycję Przejrzyj i utwórz. Następnie wybierz Utwórz.

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

Zrzut ekranu przedstawiający zasób aplikacji usługi IoT Central w witrynie Azure Portal. Adres URL aplikacji jest wyróżniony.

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 i logo aplikacji wyświetlanego w głowicy.

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ę Wygląd dostosowywania>.

  2. Aby zmienić logo masthead, wybierz pozycję Zmień, a następnie wybierz obraz contoso_wht_mast.png do przekazania. 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 wprowadź ciąg #008575.
    • W polu Akcent wprowadź #A1F3EA.

  5. Wybierz pozycję 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 witryny 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 pozycję 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 w sklepie — szablon aplikacji wyewidencjonowania zawiera kilka wstępnie zainstalowanych szablonów urządzeń. Szablon urządzenia RuuviTag nie jest uwzględniony w analizie w sklepie — wyewidencjonowanie szablonu aplikacji.

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 pozycję + 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 pozycję Dalej: Przejrzyj.

  7. Wybierz pozycję 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.

Zrzut ekranu przedstawiający szablony urządzeń aplikacji analitycznych w sklepie.

Dostosowywanie szablonów urządzeń

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

  • Dostosowywanie natywnych wbudowanych interfejsów na urządzeniach przez zmianę możliwości urządzenia.

    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ń.

  • Dostosowywanie szablonów urządzeń przez tworzenie widoków niestandardowych.

    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.

    Zrzut ekranu przedstawiający szablon urządzenia RuuviTag aplikacji analizy w sklepie.

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

  5. Na liście możliwości przewiń typ telemetrii RelativeHumidity . Jest to element wiersza z edytowalną wartością Nazwa wyświetlana RelativeHumidity.

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 pozycję Dodaj możliwość.

  2. W polu Nazwa wyświetlana wprowadź wartość 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 opcję Przycinanie białych znaków na wartość 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 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ź wartość C500 gateway jako nazwę urządzenia i wartość 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 pozycję 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 pozycję 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ź wartość RuuviTag 002 jako nazwę urządzenia i ruuvitag-002 jako identyfikator urządzenia.

Aby połączyć dwa czujniki RuuviTag i obłożenie urządzenia z urządzeniem bramy:

  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 bramy C500 — brama i wybierzesz kartę Urządzenia podrzędne, 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ć wysyłanie powiadomień e-mail lub wyzwalanie akcji elementu webhook w celu wysyłania danych 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. W obszarze Telemetria wybierz pozycję RelativeHumidity. Jest to możliwość urządzenia, którą dostosowano we wcześniejszym kroku.

  6. W obszarze Operator wybierz pozycję Jest 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 Wiadomość e-mail.

  2. W polu Przyjazna nazwa wyświetlana akcji wprowadź powiadomienie o wysokiej wilgotności.

  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 wiadomość e-mail za każdym razem, gdy czujnik wskazuje, że poziom wilgotności przekroczył wartość warunku.

Czyszczenie zasobów

Jeśli nie planujesz ukończenia dalszych przewodników Szybki start lub samouczków usługi IoT Central, możesz usunąć aplikację usługi 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

Dostosowywanie pulpitu nawigacyjnego