Ten przewodnik pomoże Ci szybko skonfigurować pierwszy przepływ danych w IoT Logic i rozpocząć przetwarzanie danych telematycznych.

Wymagania wstępne

Zanim zaczniesz tworzyć swój pierwszy przepływ, upewnij się, że masz:

• dostęp do roli/konta Właściciela na Twoim koncie TrackSystem,
• Aktywowane urządzenia na Twoim koncie,
• Zrozumienie, jakie źródła danych chcesz przetwarzać.

Przestrzeń robocza IoT Logic jest dostępna tylko na koncie Właściciela i nie jest wyświetlany dla zwykłych Użytkowników. Aby uzyskać szczegółowe informacje na temat ról użytkowników, zobacz Użytkownicy i role.

Konfiguracja przepływu

Obejrzyj krótki film przedstawiający proces tworzenia nowego przepływu z obliczeniami atrybutów danych i dodawania niestandardowych atrybutów do urządzeń na platformie:

Proces tworzenia nowego przepływu z obliczeniami atrybutów danych i dodawania niestandardowych atrybutów do urządzeń na platformie

Teraz przeanalizujmy krok po kroku proces konfiguracji przepływu.

Krok 1: Uzyskaj dostęp do obszaru roboczego IoT Logic

1. Zaloguj się na swoje konto TrackSystem
2. Kliknij ikonę swojego profilu w lewym górnym rogu ekranu, aby uzyskać dostęp Ustawienia konta
3. Wybierz Logika IoT na pasku bocznym ustawień

Obszar roboczy IoT Logic składa się z trzech głównych sekcji:

• Pasek ustawień przepływu – Zawiera elementy sterujące do zarządzania przepływami
• Panel węzłów – Wyświetla dostępne węzły do budowania przepływu
• Płótno – Główna przestrzeń robocza, w której projektujesz swój przepływ

Szczegółowe informacje na temat obszaru roboczego można znaleźć tutaj: Obszar roboczy i domyślny przepływ.

Krok 2: Utwórz nowy przepływ

1. Kliknij Nowy przepływ przycisk na pasku ustawień przepływu
2. W Nowy przepływ dialog:

• Wprowadź opisową nazwę swojego przepływu (np. „Przetwarzanie telemetrii floty”)
• Dodaj krótki opis wyjaśniający cel przepływu
• Upewnij się, że Włączony przepływ przełącznik jest włączony

1. Kliknij Zapisz aby stworzyć przepływ

Dodatkowe informacje na temat konfiguracji przepływu można znaleźć w artykule Zarządzanie przepływem -> Tworzenie nowego przepływu.

Wyłączone przepływy nie przetwarzają żadnych danych. Gdy przepływ jest wyłączony, urządzenia w tym przepływie nie będą przesyłać danych do żadnego miejsca docelowego, w tym do platformy TrackSystem.

Krok 3: Skonfiguruj węzeł źródła danych

1. Z Węzły panel, przeciągnij a Źródło danych węzeł na płótnie
2. Najedź myszką na węzeł, aby wyświetlić szybkie działania, lub kliknij dwukrotnie węzeł, aby otworzyć jego panel konfiguracyjny
3. Skonfiguruj następujące ustawienia:

• Nazwa węzła – Wprowadź nazwę opisową, określającą źródło wysłanych danych (np Pojazdy pracownicze)
• Źródła – Wybierz urządzenia, których odczyty chcesz wysłać do tego przepływu. Możesz filtrować dostępne urządzenia według danych Producent i urządzenie Model.

1. Kliknij Zapisz aby zastosować konfigurację

Szczegółowe informacje na temat konfiguracji węzła można znaleźć w artykule Węzeł źródła danych.

Krok 4: Dodaj wzbogacenie danych (opcjonalnie)

1. Przeciągnij Zainicjuj atrybut węzeł na płótnie
2. Najedź myszką na węzeł, aby wyświetlić szybkie działania, lub kliknij dwukrotnie węzeł, aby otworzyć jego panel konfiguracyjny
3. Dodaj opis Nazwa węzła aby określić jego cel i obliczenia, które wykonuje (np. Temperatura °F do °C)
4. Zdefiniuj swój atrybut:
   1. Nazwa atrybutu – Jasna, opisowa nazwa (np. „speed_mph”)
   2. Formuła – Wyrażenie obliczeniowe (np value('speed')/1.609 aby przeliczyć km/h na mph) 💡Uwaga: Nazwy atrybutów może być automatycznie napełniany aby zapewnić prawidłowe nazewnictwo. Autouzupełnianie domyślnie używa krótkiej składni, która odnosi się do najnowszej wartości atrybutu.
   3. Czas generacji – Kiedy na urządzeniu utworzono wpis danych (domyślnie now())
   4. Czas serwera – Kiedy dane zostały odebrane przez serwer (domyślnie now())
5. Dodaj dodatkowe atrybuty, jeśli to konieczne, klikając Dodaj atrybut 💡Uwaga: Zresetuj formularz przycisk odrzuca wszystkie utworzone atrybuty w węźle. Jeśli chcesz usunąć określony atrybut, kliknij trzy kropki po prawej stronie wiersza atrybutu i wybierz Usuń.
6. Kliknij Zapisz aby zastosować konfigurację
7. Utwórz połączenie:
   1. Kliknij złącze wyjściowe Źródło danych węzeł
   2. Przeciągnij przejście do złącza wejściowego Zainicjuj atrybut węzeł

Aby uzyskać szczegółowe informacje na temat konfiguracji węzła, zobacz Zainicjuj węzeł atrybutu.

Aby uzyskać szczegółowe informacje na temat działań z atrybutami, zobacz Zarządzanie atrybutami.

Przykładowe wzory obliczeniowe można znaleźć w artykule Przykłady obliczeń.

Krok 5: Skonfiguruj wyjście danych

1. Przeciągnij Punkt końcowy wyjścia węzeł na płótnie
2. Najedź myszką na węzeł, aby wyświetlić szybkie działania, lub kliknij dwukrotnie węzeł, aby otworzyć jego panel konfiguracyjny
3. Wybierz Typ punktu końcowego:

• Punkt końcowy TrackSystem – domyślny punkt końcowy służący do wysyłania przetworzonych danych na platformę TrackSystem. Jest wstępnie skonfigurowany i nie pozwala na żadne zmiany
• Punkt końcowy MQTT – punkt końcowy służący do wysyłania danych do miejsc docelowych osób trzecich, wykorzystujący protokół transportowy MQTT. Wymaga ręcznej konfiguracji opisanej w dalszych krokach

Punkty końcowe utworzone w ramach konta są dostępne jako Presety. Możesz wybrać już istniejącą konfigurację zamiast konfigurować ją od podstaw. Punkt końcowy wyjścia TrackSystem jest zawsze dostępny jako preset.

1. Skonfiguruj następujące ustawienia:
   1. Nazwa punktu końcowego – Wprowadź nazwę opisową, aby określić miejsce docelowe, do którego wysyłane są dane
   2. Protokół – Wybierz protokół danych (tylko “Navixy Generic Protocol (JSON)” jest dostępny w tej chwili)
   3. IP/Domena – Wprowadź adres docelowy
   4. Port – Określ numer portu (domyślnie: 1883 dla standardowego MQTT, 8883 dla SSL)
   5. (opcjonalnie) Włącz SSL – Włącz, aby zapewnić bezpieczne połączenia
   6. Wersja MQTT – Wybierz odpowiednią wersję (3.1.1 lub 5,0)
   7. Identyfikator klienta – Wprowadź identyfikator swojego klienta, aby mieć pewność, że dane zostaną zaakceptowane przez stronę odbierającą
   8. (opcjonalnie) Tematy – Określ tematy MQTT dla transmisji danych
   9. Jakość usług – Wybierz poziom jakości usługi, aby określić logikę transmisji danych (0, 1, lub 2)
2. Jeśli po stronie odbiorczej wymagane jest uwierzytelnienie, przełącz Uwierzytelnianie MQTT ON Pojawiające się pola są automatycznie wstępnie wypełniane danymi logowania do konta platformy

The Zresetuj formularz przycisk odrzuca wszystkie utworzone atrybuty w węźle. Jeśli chcesz usunąć określony atrybut, kliknij trzy kropki po prawej stronie wiersza atrybutu i wybierz Usuń.

1. Kliknij Tworzyć aby zastosować konfigurację
2. Połącz pozostałe węzły z tym węzłem wyjściowym w razie potrzeby, aby sfinalizować strukturę przepływu

Każdy przepływ powinien zawierać a Domyślny punkt końcowy węzeł zapewniający przesyłanie danych na platformę. Bez tego połączenia dane urządzenia nie będą widoczne w interfejsie TrackSystem.

Aby uzyskać szczegółowe informacje na temat konfiguracji węzła, zobacz Węzeł punktu końcowego wyjściowego.

Krok 6: Zapisz i aktywuj swój przepływ

1. Sprawdź, czy wszystkie węzły są prawidłowo połączone w Twoim przepływie
2. Kliknij Zapisz przepływ przycisk w Węzły panel

Twój przepływ jest teraz aktywny i przetwarza dane w czasie rzeczywistym!

Walidacja przepływu

Aby potwierdzić, że przepływ działa prawidłowo, użyj Analizator strumienia danych narzędzie:

1. Kliknij Analizator danych przycisk na pasku ustawień przepływu
2. Wybierz urządzenia, które chcesz monitorować z listy rozwijanej
3. Obserwuj przychodzące atrybuty danych i ich wartości
4. Użyj opcji filtrowania, aby skupić się na określonych parametrach
5. Sprawdź, czy wszystkie obliczone atrybuty pokazują prawidłowe wartości

Szczegółowe informacje na temat korzystania z narzędzia można znaleźć w artykule Analizator strumienia danych.

Gratulacje! Twój pierwszy przepływ danych IoT Logic działa.

Następne kroki

Teraz, gdy stworzyłeś swój pierwszy przepływ logiki IoT, możesz:

• Dostosuj ten przykład szybkiego startu do potrzeb Twojej firmy
• Twórz bardziej złożone transformacje danych z wieloma Inicjuj węzły atrybutów
• Skonfiguruj dodatkowe miejsca docelowe produkcji dla Twoich danych, które mogą stać się profilami wielokrotnego użytku dla spójnych konfiguracji
• Zarządzaj już utworzonymi przepływami aby dostosować przetwarzanie danych do wszelkich zmian, z którymi się spotykasz
• Projektuj zaawansowane przepływy dla konkretnych scenariuszy biznesowych wykorzystujących różne kombinacje i konfiguracje węzłów

Adaptacja tego przykładu

Przykład ten można dostosować do różnych przypadków użycia w branży, modyfikując:

• Wybór urządzenia: Wybierz urządzenia istotne dla Twoich konkretnych zasobów
• Konwersje jednostek: Dostosuj wzory w oparciu o standardowe jednostki miary
• Obliczone metryki:Twórz wskaźniki specyficzne dla branży w oparciu o potrzeby Twojej firmy
• Konfiguracja wyjściowa: Połącz się ze swoją konkretną platformą analityczną lub bazą danych

Podstawowy schemat gromadzenia, przekształcania i przekazywania danych pozostaje spójny we wszystkich branżach, co czyni go wszechstronnym szablonem do przetwarzania danych IoT.

Dostęp do API

Dostęp do funkcjonalności IoT Logic można również uzyskać programowo za pośrednictwem interfejsu API TrackSystem. Umożliwia to programistom automatyzację tworzenia przepływów, zarządzania nimi i monitorowania.

Ze względów bezpieczeństwa dostęp do API wymaga odpowiednich uprawnień. Skontaktuj się z administratorem konta, aby upewnić się, że masz niezbędne prawa dostępu.

Pełną dokumentację API, parametry, formaty żądań/odpowiedzi i przykłady kodu można znaleźć w Dokumentacja API logiki Navixy IoT.

Często zadawane pytania

Co dzieje się z urządzeniami, które nie są przypisane do niestandardowego przepływu?

Urządzenia, które nie są jawnie przypisane do żadnego niestandardowego przepływu, są automatycznie obsługiwane przez domyślny przepływ, który wysyła ich dane bezpośrednio do platformy TrackSystem.

Czy mogę używać tego samego urządzenia w wielu przepływach?

Nie, każde urządzenie można przypisać tylko do jednego przepływu na raz. Po dodaniu do niestandardowego przepływu urządzenie jest automatycznie usuwane z domyślnego przepływu, aby zapobiec duplikowaniu przetwarzania danych.

Czy mój przepływ będzie nadal działał, jeśli się wyloguję?

Tak, po aktywacji przepływy działają niezależnie od sesji użytkownika. Dopóki przepływ jest włączony, będzie przetwarzał dane nawet wtedy, gdy nie jesteś zalogowany.

Skąd mam wiedzieć, czy mój przepływ działa poprawnie?

Użyj analizatora strumienia danych do monitorowania transmisji danych w czasie rzeczywistym. Narzędzie to pokazuje zarówno surowe dane urządzenia, jak i obliczone atrybuty, co pozwala sprawdzić, czy transformacje działają zgodnie z oczekiwaniami.

Co się stanie, jeśli wyłączę przepływ?

Po wyłączeniu przepływu urządzenia przypisane do tego przepływu nie będą przesyłać danych do żadnego miejsca docelowego, w tym do platformy TrackSystem. Urządzenia będą wyświetlane w trybie offline w interfejsie TrackSystem do momentu ponownego włączenia przepływu.