Overvis Cloud to kompleksowa platforma IoT do monitorowania i sterowania urządzeniami przemysłowymi. Podłącz urządzenia Modbus, wizualizuj dane w czasie rzeczywistym, konfiguruj alerty i integruj się z systemami za pomocą API.
Overvis Cloud to przemysłowa platforma IoT do zdalnego monitorowania i sterowania urządzeniami przez protokół Modbus. Łączy urządzenia w terenie — regulatory temperatury, liczniki energii, PLC i czujniki — z chmurą, zapewniając dostęp do danych w czasie rzeczywistym, rejestrowanie historii, alerty i zdalne sterowanie z dowolnego miejsca przez przeglądarkę internetową.
Przewodnik jest przeznaczony dla inżynierów, integratorów i entuzjastów automatyki, którzy znają Modbus i urządzenia przemysłowe, ale dopiero zaczynają pracę z platformą Overvis. Szczegółowe informacje o diagnostyce połączeń i alternatywnych metodach łączenia znajdziesz w Podłączanie urządzeń. Funkcje platformy, takie jak alerty, wizualizacje i raporty, znajdziesz w dokumentacji Overvis Cloud.
Sterownika komunikacyjnego Modbus TCP — działa jako brama między Twoimi urządzeniami Modbus RTU a internetem. Dla najprostszego uruchomienia polecamy Overvis MC252. Inne urządzenia kompatybilne z Overvis znajdziesz na overvis.com/equipment.
Urządzenia Modbus RTU — urządzenia, które chcesz monitorować lub którymi chcesz sterować (na przykład regulator temperatury, licznik energii, PLC albo czujnik). To urządzenie łączy się ze sterownikiem przez RS-485.
Przewodu RS-485 — skrętki do połączenia urządzenia Modbus RTU z portem RS-485 sterownika.
Połączenia z internetem — kabla Ethernet lub sieci komórkowej (karty SIM) dla sterownika komunikacyjnego.
Komputera albo smartfona — z przeglądarką internetową do dostępu do Overvis Cloud.
Mogą się też przydać:
Zasilacz do sterownika komunikacyjnego (szczegóły napięcia i złącza znajdziesz w dokumentacji sterownika).
Dokumentacja urządzenia Modbus — mapa rejestrów, adres Modbus i parametry komunikacji Twojego urządzenia RTU. Będą potrzebne do skonfigurowania parametrów w Overvis.
Zanim zarejestrujesz sterownik w Overvis, musi on być włączony i podłączony do internetu.
Poniższe kroki dotyczą Overvis MC252. Inne sterowniki kompatybilne z Overvis z naklejką z kodem PIN działają podobnie — szczegóły znajdziesz w instrukcji konkretnego sterownika.
Zamontuj urządzenie i podłącz zasilanie 12 V DC (obsługiwany zakres 9–30 V).
Podłącz kabel Ethernet do portu LAN albo włóż kartę SIM z transmisją danych do gniazda SIM i podłącz antenę GSM.
Włącz zasilanie. Inicjalizacja urządzenia trwa około 15 sekund.
Naciśnij przycisk R, aby wybudzić wyświetlacz. Zobaczysz aktualny adres IP z prefiksem (E) dla Ethernetu albo (G) dla GSM oraz szybkości transmisji danych.
Sterownik domyślnie używa DHCP, więc w większości przypadków po podłączeniu kabla Ethernet automatycznie pobierze adres IP. Przy karcie SIM bez blokady PIN połączenie komórkowe zwykle nawiązuje się w ciągu minuty bez dodatkowej interwencji użytkownika.
Jeżeli na wyświetlaczu widzisz 0.0.0.0, urządzenie jeszcze nie uzyskało adresu — sprawdź kabel albo kartę SIM. Szczegółowe instrukcje konfiguracji i diagnostyki znajdziesz w Przewodniku szybkiego startu MC252.
Email — będzie używany do logowania i powiadomień. Sprawdź adres przed wysłaniem formularza.
Hasło — minimum 5 znaków.
Nazwa organizacji — opcjonalnie. Jeśli zostawisz pole puste, domyślna nazwa zostanie utworzona na podstawie Twojego adresu e-mail. Później można ją zmienić.
Pole zgody — aby kontynuować, musisz zaakceptować Warunki korzystania z usług oraz Politykę prywatności.
Kliknij Zarejestruj się.
Po rejestracji zostaniesz automatycznie zalogowany i przekierowany na stronę Utwórz sieć (opisaną w następnym kroku). Na podany adres otrzymasz e-mail z potwierdzeniem — kliknij link w ciągu 24 godzin, aby konto pozostało aktywne.
Podczas rejestracji Overvis tworzy organizację dla Twojego konta. W Overvis organizacja jest jednostką rozliczeń i kontroli dostępu — grupuje sieci, użytkowników i uprawnienia. Nie musi odpowiadać rzeczywistej firmie: jedna firma może korzystać z kilku organizacji Overvis, aby oddzielić od siebie obiekty, projekty lub centra kosztów. Szczegóły zarządzania organizacjami i zapraszania członków zespołu znajdziesz w Organizacje i użytkownicy.
W Overvis sieć reprezentuje sterownik komunikacyjny oraz wszystkie urządzenia Modbus RTU dostępne przez ten sterownik. Następnym krokiem jest utworzenie sieci — czyli wskazanie Overvis, jak odnaleźć i połączyć się z Twoim sterownikiem.
Przejdź na stronę Utwórz sieć — jeśli właśnie się zarejestrowałeś, już tam jesteś.
Znajdź naklejkę na urządzeniu MC252 (albo innym sterowniku kompatybilnym z Overvis). Zawiera kod QR i PIN — 8-znakowy kod alfanumeryczny (na przykład A1B2C3D4).
Wpisz PIN z naklejki urządzenia w pole Kod PIN i kliknij Sprawdź połączenie, aby potwierdzić, że sterownik jest online i dostępny.
Jeśli test zakończy się powodzeniem, Overvis potwierdzi połączenie i pokaże informacje o sterowniku. Jeśli się nie powiedzie, upewnij się, że sterownik jest włączony i ma połączenie z internetem (zobacz Krok 1), a następnie spróbuj ponownie.
Nadaj sieci opisową nazwę (na przykład “Magazyn”, “HVAC biura”, “Ogrzewanie domu”) i kliknij Stwórz sieć, aby zakończyć konfigurację.
Po utworzeniu przejdziesz na stronę sieci, na której zobaczysz sterownik i jego status połączenia. Przed przejściem dalej upewnij się, że status pokazuje sterownik jako połączony.
Krok 4: Podłącz urządzenie Modbus RTU przez RS-485
Gdy sterownik jest już zarejestrowany w Overvis, czas podłączyć do niego rzeczywiste urządzenie Modbus RTU. Ten krok ma dwie części: fizyczne okablowanie przez RS-485 oraz rejestrację urządzenia w Overvis.
Połącz urządzenie Modbus RTU ze sterownikiem komunikacyjnym za pomocą skrętki:
Zacisk sterownika A (nieodwrócony, D+) → zacisk urządzenia A (D+, +)
Zacisk sterownika B (odwrócony, D−) → zacisk urządzenia B (D−, −)
Upewnij się, że oba urządzenia używają tych samych ustawień portu szeregowego: prędkości transmisji (baud), parzystości i bitów stopu. MC252 domyślnie używa 9600 bodów, Modbus RTU i automatycznego wykrywania liczby bitów stopu. Sprawdź dokumentację urządzenia i w razie potrzeby zmień ustawienia sterownika w interfejsie WWW MC252 na karcie Modbus — zobacz Przewodnik szybkiego startu MC252.
Wypełnij pola Nazwa i Modbus ID (adres urządzenia, 0–255 — sprawdź dokumentację urządzenia albo ustawienia przełączników DIP).
Na liście Zainicjuj za pomocą szablonu wybierz szablon pasujący do modelu Twojego urządzenia. Szablony wstępnie konfigurują wszystkie parametry (adresy rejestrów, typy danych, nazwy i jednostki), dzięki czemu nie trzeba ustawiać ich ręcznie. Overvis zawiera szablony dla wielu popularnych urządzeń przemysłowych.
Kliknij Utwórz urządzenie.
Jeśli dla Twojego urządzenia nie ma szablonu, możesz dodać parametry ręcznie po utworzeniu urządzenia — zobacz Krok 5 i dokumentację Sieci, urządzenia i parametry. Możesz też tworzyć własne szablony do ponownego wykorzystania — zobacz Szablony urządzeń.
Po dodaniu urządzenia do sieci możesz przeglądać jego dane w Overvis.
Na stronie sieci kliknij nazwę urządzenia, aby otworzyć jego stronę.
Strona Szczegóły pokazuje u góry czas ostatniego odczytu, a poniżej listę parametrów. Parametry są pogrupowane w sekcje: Monitorowane parametry (wartości są zapisywane historycznie), Programowalne parametry (ustawienia, które można zmieniać) oraz Nieśledzone parametry (odczytywane, ale niezapisywane). Jeśli użyto szablonu urządzenia, wszystkie parametry są już skonfigurowane z nazwami, typami danych i tymi znacznikami.
Każdy wiersz parametru pokazuje nazwę parametru, jego adres Modbus oraz bieżącą wartość (z jednostkami). Kliknij wartość, aby na żądanie odświeżyć odczyt z urządzenia.
Jeśli nie użyto szablonu albo trzeba dodać dodatkowe parametry, kliknij Dodaj parametr w panelu bocznym i określ:
Nazwa — czytelna nazwa parametru.
Adres pamięci urządzenia — numer rejestru Modbus (z dokumentacji urządzenia).
Rodzaj rejestru — Rejestr przechowywania, Rejestr wejściowy, Rejestr bitów albo Wejście dyskretne.
Typ — sposób interpretacji wartości rejestru (Int16, Uint16, Int32, Float32 itd.).
Jednostki — jednostki wyświetlania (°C, kWh, V, A itd.).
Overvis pozwala zapisywać wartości do rejestrów Modbus urządzenia — na przykład zmieniać nastawę temperatury, włączać lub wyłączać wyjście albo korygować parametr konfiguracyjny.
Parametry w sekcji Programowalne parametry (czyli parametry ze znacznikiem Programowalne, ustawionym przez szablon albo ręcznie podczas dodawania parametru) mają ikonę ołówka obok wartości. Aby zmienić wartość:
Kliknij ikonę ołówka obok parametru, który chcesz zmienić.
W wierszu pojawi się edytor — wpisz nową wartość (albo wybierz ją z listy rozwijanej dla parametrów wyliczeniowych).
Potwierdź zapis.
Overvis wysyła polecenie zapisu Modbus do urządzenia przez sterownik. Wyświetlana wartość zaktualizuje się przy następnym cyklu odczytu (domyślnie co 10 minut, z możliwością zmiany w ustawieniach urządzenia).
Masz już działającą konfigurację Overvis Cloud z danymi na żywo z urządzeń. Oto funkcje, które warto sprawdzić w następnej kolejności:
Alerty — skonfiguruj automatyczne powiadomienia (e-mail, SMS, połączenie głosowe), gdy wartości parametrów przekroczą progi albo urządzenia utracą połączenie.
Wizualizacje — buduj własne interaktywne dashboardy z wykresami, wskaźnikami i elementami sterowania.
Szablony urządzeń — używaj gotowych zestawów parametrów do szybkiej konfiguracji urządzeń albo twórz własne.
Każde nowe konto otrzymuje 30 € bonusu — to wystarcza na 1–2 miesiące bezpłatnych testów, zależnie od liczby podłączonych sieci. Aby rozpocząć, płatność nie jest wymagana. Szczegóły cen i metod płatności znajdziesz w Rozliczenia.
Problemy z połączeniem (urządzenie się nie łączy, błędy przekroczenia limitu czasu, brak danych) — zobacz Podłączanie urządzeń w celu diagnostyki i poznania alternatywnych metod połączenia.
Pytania dotyczące platformy (nawigacja, funkcje, konfiguracja) — zobacz odpowiednią sekcję dokumentacji Overvis Cloud.
Overvis Cloud komunikuje się z urządzeniami polowymi przez Modbus TCP. W typowej konfiguracji kontroler komunikacji (brama Modbus TCP) łączy się z internetem i utrzymuje połączenie z serwerem Overvis. Urządzenia Modbus RTU — regulatory temperatury, liczniki energii, sterowniki PLC, czujniki — podłączają się do bramy przez RS-485; Overvis uzyskuje do nich dostęp przez bramę.
graph LR
A["Urządzenia<br/>Modbus RTU"] -->|"RS-485<br/>Modbus RTU"| B["Kontroler<br/>komunikacji<br/>(brama Modbus TCP)"]
B -->|"Internet<br/>Modbus TCP"| C["Overvis Cloud"]
C -->|"WWW / HTTPS"| D["Użytkownik<br/>(przeglądarka)"]
W Overvis cały ten łańcuch jest reprezentowany jako sieć: jeden kontroler komunikacji oraz wszystkie urządzenia Modbus RTU dostępne przez niego. Każde urządzenie w sieci ma unikalny adres Modbus (ID jednostki) oraz zestaw parametrów — pojedynczych wartości rejestrów, które Overvis odczytuje z urządzenia lub zapisuje do niego. Szczegóły zarządzania sieciami, urządzeniami i parametrami po podłączeniu znajdziesz w Sieci, urządzenia i parametry.
Ta strona obejmuje wszystko, co potrzebne do nawiązania połączenia: rejestrację bramy w Overvis, okablowanie urządzeń RS-485, konfigurację ustawień komunikacji szeregowej, rozwiązywanie konfliktów z wcześniej zarejestrowanymi urządzeniami oraz diagnozowanie problemów z połączeniem.
Overvis obsługuje trzy metody podłączenia bramy Modbus TCP do platformy. Pierwsze dwie (kod PIN i kod aktywacji) używają połączenia zwrotnego — kontroler inicjuje wychodzące połączenie TCP do Overvis, co omija problemy z firewallem i NAT. Trzecia metoda (połączenie bezpośrednie) wymaga, aby Overvis nawiązywał połączenie przychodzące do kontrolera; potrzebny jest wtedy statyczny publiczny adres IP i przekierowanie portów.
Kod PIN to 8-znakowy kod alfanumeryczny (np. A1B2C3D4) wydrukowany na naklejce na urządzeniu. Na naklejce znajduje się także kod QR kodujący adres URL w postaci https://c.overvis.com/A1B2C3D4.
To najprostsza metoda połączenia i zalecany wybór przy pierwszej konfiguracji kontrolerów zgodnych z Overvis (MC252, EM-482, EM-483 i inne).
Jak to działa:
Kontroler łączy się wychodząco z Overvis i identyfikuje się adresem MAC. Gdy użytkownik wprowadzi kod PIN, Overvis wyszukuje adres MAC powiązany z tym PIN-em i przypisuje go do sieci użytkownika. Ponieważ połączenie inicjuje kontroler, nie jest potrzebne przekierowanie portów ani statyczny IP — połączenie działa przez firewalle, NAT i dynamiczne adresy IP.
sequenceDiagram
participant C as Kontroler
participant O as Overvis
participant U as Użytkownik
C->>O: Połącz i wyślij uzgodnienie (adres MAC)
O->>C: Potwierdź uzgodnienie
Note over C,O: Połączenie zwrotne nawiązane, oczekiwanie na przypisanie
U->>O: Wprowadź kod PIN na stronie Utwórz sieć
O->>O: Wyszukaj adres MAC po PIN
O->>O: Przypisz połączenie do sieci użytkownika
O->>U: Sieć utworzona
loop Odpytywanie
O->>C: Odczyt rejestrów (Modbus TCP)
C->>O: Zwróć dane
end
Kroki:
Upewnij się, że kontroler jest zasilany i podłączony do internetu (Ethernet lub GSM). Sprawdź łączność na wyświetlaczu urządzenia lub w interfejsie WWW.
Znajdź naklejkę na urządzeniu. Zeskanuj kod QR telefonem (otworzy stronę Utwórz sieć z wstępnie wypełnionym PIN-em) lub zanotuj PIN, aby wprowadzić go ręcznie.
Zaloguj się do Overvis pod adresem ocp.overvis.com i przejdź do strony Utwórz sieć.
Wybierz Użyj kodu PIN wydrukowanego na naklejce urządzenia, wprowadź PIN i kliknij Sprawdź połączenie.
Jeśli weryfikacja zakończy się powodzeniem, Overvis potwierdza, że kontroler jest online, i pokazuje jego szczegóły (model kontrolera i wersja oprogramowania). Jeśli się nie powiedzie, sprawdź, czy kontroler ma dostęp do internetu, i spróbuj ponownie.
Wpisz opisową nazwę sieci i kliknij Stwórz sieć.
Ważne cechy:
Kod PIN jest wielokrotnego użycia — można go używać wielokrotnie, np. po usunięciu i ponownym utworzeniu sieci.
Jeśli kontroler jest już przypisany do sieci w Twoim koncie, Overvis ostrzeże, że istniejąca sieć zostanie rozłączona, i zapyta, czy kontynuować. Wszystkie dane w starej sieci są zachowywane.
Jeśli kontroler jest już przypisany do sieci w innym koncie, kod PIN nie może go ponownie przypisać. Musisz zastosować metodę kodu aktywacji (zob. Kod aktywacji) lub poprosić obecnego właściciela o odłączenie urządzenia (zob. Konflikty urządzeń i przejęcie).
Kod aktywacji to 8-cyfrowy kod numeryczny (np. 38571098) generowany przez serwer Overvis i wysyłany do kontrolera po nawiązaniu połączenia zwrotnego. Kod jest wyświetlany na ekranie kontrolera (jeśli go posiada) lub w lokalnym interfejsie WWW.
Z tej metody korzysta się, gdy naklejka z kodem PIN jest niedostępna lub gdy trzeba przejąć kontroler już zarejestrowany pod innym kontem Overvis. Odczyt kodu aktywacji wymaga fizycznego lub lokalnego dostępu do urządzenia, co stanowi dowód posiadania.
Jak to działa:
Kontroler łączy się wychodząco z Overvis i otrzymuje unikalny kod aktywacji, który wyświetla na ekranie lub w interfejsie WWW. Użytkownik odczytuje ten kod i wprowadza go w Overvis, aby przypisać urządzenie do swojego konta. Kod zmienia się przy każdym ponownym nawiązaniu połączenia z serwerem (dopóki urządzenie nie zostanie przypisane).
sequenceDiagram
participant C as Kontroler
participant O as Overvis
participant U as Użytkownik
C->>O: Połącz i wyślij uzgodnienie (adres MAC)
O->>O: Wygeneruj 8-cyfrowy kod aktywacji
O->>C: Wyślij kod aktywacji
C->>C: Wyświetl kod na ekranie / w interfejsie WWW
Note over C,O: Połączenie zwrotne nawiązane, oczekiwanie na przypisanie
U->>C: Odczytaj kod aktywacji z wyświetlacza lub interfejsu WWW
U->>O: Wprowadź kod aktywacji na stronie Utwórz sieć
O->>O: Zweryfikuj kod, wyszukaj adres MAC
O->>O: Przypisz połączenie do sieci użytkownika
O->>C: Potwierdź przypisanie
C->>C: Wyświetl „active”
O->>U: Sieć utworzona
loop Odpytywanie
O->>C: Odczyt rejestrów (Modbus TCP)
C->>O: Zwróć dane
end
Kroki:
Upewnij się, że kontroler jest zasilany i podłączony do internetu.
Uzyskaj kod aktywacji:
Kontrolery z wyświetlaczem (np. MC252): 8-cyfrowy kod pojawia się na ekranie po nawiązaniu połączenia z serwerem. Na wyświetlaczu kod jest poprzedzony (E) dla Ethernet lub (G) dla GSM (np. (E) 38571098).
Kontrolery bez wyświetlacza (np. EM-482, EM-483, EM-130): wejdź do lokalnego interfejsu WWW kontrolera po jego adresie IP. Kod znajduje się zwykle na stronie statusu/parametrów, często w polu „Kod aktywacyjny serwera przechowywania danych” lub podobnym.
Zaloguj się do Overvis pod adresem ocp.overvis.com i przejdź do strony Utwórz sieć.
Wybierz Użyj jednorazowego kodu wyświetlanego na ekranie urządzenia, wprowadź 8-cyfrowy kod i kliknij Sprawdź połączenie.
Jeśli weryfikacja zakończy się powodzeniem, wpisz nazwę sieci i kliknij Stwórz sieć.
Po pomyślnym przypisaniu na wyświetlaczu kontrolera (MC252) zamiast kodu numerycznego pojawi się active, albo na stronie statusu interfejsu WWW (EM-483, EM-130) pojawi się „Active”. Kod aktywacji przestaje się zmieniać — urządzenie jest trwale przypisane do tej sieci.
Ważne cechy:
Kod aktywacji ma wyższy priorytet niż kod PIN. Może przejąć kontroler obecnie przypisany do innego konta, ponieważ odczyt kodu potwierdza fizyczny dostęp.
Po przypisaniu kontroler pozostaje powiązany z tą siecią także po ponownych połączeniach — Overvis nie wygeneruje nowego kodu aktywacji, dopóki urządzenie nie zostanie odłączone.
Kod aktywacji jest jednorazowy: każdy kod jest ważny tylko do momentu użycia lub do ponownego połączenia kontrolera (co generuje nowy kod).
Gdzie znaleźć kod aktywacji w zależności od urządzenia:
Urządzenie
Miejsce
MC252
Wyświetlacz urządzenia i interfejs WWW (zakładka Cloud)
Przy połączeniu bezpośrednim Overvis inicjuje połączenie TCP z kontrolerem po jego publicznym adresie IP i porcie. Metoda ta działa z dowolnym standardowym urządzeniem Modbus TCP — nie wymaga oprogramowania ani integracji specyficznej dla Overvis. Jest jednak bardziej skomplikowana w konfiguracji i mniej bezpieczna niż metody połączenia zwrotnego.
Jak to działa:
Overvis nawiązuje połączenie TCP z podanym adresem IP i portem, a następnie komunikuje się standardowym protokołem Modbus TCP. Połączenie inicjuje serwer Overvis, więc urządzenie docelowe musi być osiągalne z internetu.
sequenceDiagram
participant U as Użytkownik
participant O as Overvis
participant R as Router
participant C as Kontroler
U->>O: Utwórz sieć z połączeniem bezpośrednim<br/>(IP, port, ID Modbus bramy)
O->>R: Połączenie TCP z publicznym IP:port
R->>C: Przekieruj do kontrolera (przekierowanie portów)
C->>R: Odpowiedź Modbus TCP
R->>O: Przekaż odpowiedź
O->>U: Połączenie zweryfikowano, sieć utworzona
loop Odpytywanie
O->>R: Żądanie odczytu rejestrów
R->>C: Przekieruj do kontrolera
C->>R: Zwróć dane
R->>O: Przekaż odpowiedź
end
Wymagania wstępne:
Statyczny publiczny adres IP od dostawcy internetu. Dynamiczne adresy IP nie są obsługiwane — jeśli IP się zmieni, Overvis utraci połączenie.
Przekierowanie portów skonfigurowane na routerze, aby ruch zewnętrzny był kierowany na lokalny adres kontrolera i port Modbus TCP (domyślnie 502).
Rezerwacja DHCP lub statyczny IP kontrolera w sieci lokalnej, aby reguły przekierowania portów pozostały ważne.
Kroki:
Uzyskaj statyczny publiczny adres IP od dostawcy internetu.
Skonfiguruj router tak, aby wybrany port zewnętrzny był przekierowywany na wewnętrzny adres kontrolera i port Modbus TCP (domyślnie 502).
Zapewnij, aby kontroler miał zawsze ten sam lokalny adres IP — przez rezerwację DHCP na routerze lub statyczny IP na kontrolerze.
Zaloguj się do Overvis i przejdź do strony Utwórz sieć.
Wybierz Ustanów bezpośrednie połączenie Modbus TCP.
Wypełnij wymagane pola:
Sterownik Modbus TCP — wybierz model kontrolera z listy lub opcję Inne urządzenie Modbus TCP dla sprzętu innych producentów.
Gateway Modbus Address — identyfikator jednostki Modbus samego kontrolera-bramy (domyślnie 111 dla MC252; sprawdź dokumentację urządzenia).
Adres IP — statyczny publiczny adres IP routera.
Port — zewnętrzny port skonfigurowany do przekierowania.
Kliknij Sprawdź połączenie, aby zweryfikować, czy Overvis może dotrzeć do urządzenia.
Jeśli weryfikacja zakończy się powodzeniem, wpisz nazwę sieci i kliknij Stwórz sieć.
Kiedy stosować połączenie bezpośrednie:
Urządzenia lub bramy Modbus TCP innych producentów, które nie obsługują połączeń zwrotnych Overvis.
Urządzenia, które mają już statyczny publiczny IP i są skonfigurowane do zdalnego dostępu Modbus TCP (np. przez system SCADA).
Środowiska, w których kontroler nie może nawiązywać połączeń wychodzących do serwera Overvis.
Po zarejestrowaniu kontrolera komunikacji w Overvis kolejnym krokiem jest podłączenie rzeczywistych urządzeń polowych — regulatorów temperatury, liczników energii, sterowników PLC, czujników, falowników i innego sprzętu Modbus RTU — do portu RS-485 kontrolera.
RS-485 wykorzystuje parę różnicową — dwa przewody niosące ten sam sygnał o przeciwnych polaryzacjach. Podłącz zaciski kontrolera i urządzenia w następujący sposób:
Zacisk kontrolera A (nieodwrócony, D+) → zacisk urządzenia A (D+)
Zacisk kontrolera B (odwrócony, D−) → zacisk urządzenia B (D−)
Opcjonalnie połącz zacisk ekranu/masy (oznaczony ⊥, GND lub G) między urządzeniami, jeśli jest dostępny.
Używaj ekranowanej skrętki (kategoria 1 lub lepsza). Ekran połącz z masą na jednym końcu magistrali zgodnie z ANSI/TIA/EIA-485-A-1998.
Topologia magistrali:
RS-485 ma topologię magistrali — wszystkie urządzenia są połączone w łańcuch (urządzenie do urządzenia), a nie w gwiazdę. Unikaj odgałęzień (kabli w kształcie T) dłuższych niż kilka centymetrów, bo powodują odbicia sygnału.
graph LR
A["Kontroler<br/>(master)"] --- B["Urządzenie 1<br/>ID: 1"]
B --- C["Urządzenie 2<br/>ID: 2"]
C --- D["Urządzenie 3<br/>ID: 3"]
D --- E["..."]
Terminacja:
Długie magistrale RS-485 lub praca przy wysokich prędkościach transmisji mogą wymagać rezystorów terminujących (zwykle 120 Ω) na obu końcach magistrali w celu ograniczenia odbić sygnału. Niektóre kontrolery mają wbudowaną terminację (np. EM-482 ma wewnętrzny terminator 1000 Ω). Przy przerywanej komunikacji na długiej magistrali dodanie rezystorów terminujących to pierwsza rzecz, którą warto wypróbować.
Wszystkie urządzenia na magistrali RS-485 muszą używać tych samych ustawień komunikacji szeregowej. Niezgodność któregokolwiek z tych parametrów uniemożliwi komunikację.
Prędkość transmisji (baud) — szybkość transmisji danych w bitach na sekundę. Typowe wartości:
Baud
Typowe zastosowanie
1200
Wolne / starsze urządzenia
2400
Starsze urządzenia
4800
Starszy sprzęt
9600
Najczęstszy domyślny
19200
Szybsze odpytywanie
38400
Szybkie urządzenia
57600
Urządzenia wysokiej prędkości
115200
Maksimum dla większości urządzeń RS-485
Prędkość musi być zgodna między kontrolerem i wszystkimi podłączonymi urządzeniami. Wyższe prędkości pozwalają na szybsze odpytywanie, ale mogą być zawodne na długich odcinkach kabla lub w środowisku z zakłóceniami elektrycznymi.
Format bajtu (bit parzystości i bity stopu):
Każdy bajt przesyłany na magistrali RS-485 może zawierać opcjonalny bit parzystości i bity stopu do wykrywania błędów. Format bajtu musi być zgodny we wszystkich urządzeniach. Typowe opcje:
Format
Opis
8N1 (ABSENT)
8 bitów danych, brak parzystości, 1 bit stopu
8N2 (STOP)
8 bitów danych, brak parzystości, 2 bity stopu
8E1 (EVEN)
8 bitów danych, bit parzystości parzystej (EVEN), 1 bit stopu
8O1 (ODD)
8 bitów danych, bit parzystości nieparzystej (ODD), 1 bit stopu
SPACE
8 bitów danych, bit parzystości SPACE (zero), 1 bit stopu
MARK
8 bitów danych, bit parzystości MARK (jedynka), 1 bit stopu
AUTO-STOP
Automatyczne wykrywanie — wysyłka z 2 bitami stopu, akceptacja 1 lub 2 bitów stopu. Dostępne na niektórych kontrolerach zgodnych z Overvis.
Najczęstsze konfiguracje to 9600 baud, 8N1 lub 9600 baud, 8E1. Wymagane ustawienia znajdziesz w dokumentacji urządzenia.
Konfiguracja ustawień szeregowych na kontrolerach zgodnych z Overvis:
Dla kontrolerów podłączonych połączeniem zwrotnym (PIN lub kod aktywacji) Overvis może zdalnie odczytywać i zapisywać ustawienia szeregowe RS-485. Po utworzeniu sieci strona ustawień sieci pokazuje bieżącą szybkość transmisji i format bajtów kontrolera oraz pozwala je zmienić.
Dla kontrolerów innych producentów podłączonych połączeniem bezpośrednim skonfiguruj ustawienia szeregowe w interfejsie samego kontrolera (WWW, panel przedni, przełączniki DIP itd.).
Standard RS-485 (ANSI/TIA/EIA-485-A) określa maksymalną długość magistrali 1200 metrów (4000 stóp). W praktyce osiągalny zasięg zależy od prędkości transmisji, jakości kabla i poziomu zakłóceń elektrycznych:
Baud
Praktyczna maks. odległość
9600
do 1200 m
19200
do 1200 m
38400
do 1000 m
57600
do 700 m
115200
do 500 m
To wartości przybliżone. W środowiskach silnie zakłócanych (obok falowników, linii wysokiego napięcia, urządzeń spawalniczych) stosuj krótsze odcinki. Jeśli trzeba przekroczyć 1200 m, użyj regeneratorów RS-485 lub drugiego kontrolera komunikacji z własną siecią Overvis.
Maksymalna liczba urządzeń:
Liczba urządzeń na jednej magistrali RS-485 zależy od impedancji wejściowej odbiorników urządzeń:
Prąd wejściowy odbiornika
Maks. liczba urządzeń
1 mA (standard)
32
0,5 mA (1/2 jednostki obciążenia)
64
0,25 mA (1/4 jednostki)
128
0,125 mA (1/8 jednostki)
256
Większość współczesnych urządzeń Modbus RTU używa odbiorników 1/4 lub 1/8 jednostki obciążenia, co pozwala na 128–256 urządzeń na jednej magistrali. Sprawdź specyfikacje transceiverów RS-485 w kartach katalogowych urządzeń.
Każde urządzenie musi mieć unikalny adres Modbus (ID jednostki) w zakresie 0–255. Adres 0 jest zarezerwowany w protokole Modbus do transmisji rozgłoszeniowej (zapisy do wszystkich urządzeń, bez oczekiwanej odpowiedzi).
Modbus przez RS-485 obsługuje dwa tryby ramkowania:
Modbus RTU — ramkowanie binarne z kontrolą CRC-16. To standardowy tryb używany przez zdecydowaną większość urządzeń. Format danych jest zwarty, a transmisja wydajna.
Modbus ASCII — ramkowanie w kodzie ASCII z kontrolą LRC. Każdy bajt jest przesyłany jako dwa znaki szesnastkowe ASCII, co czyni dane czytelne dla człowieka, ale podwaja wymagania na pasmo. Stosowane przez niektóre starsze lub specjalistyczne urządzenia.
Oba tryby używają tego samego modelu rejestrów i kodów funkcji — różnica dotyczy wyłącznie kodowania bajtów na linii.
Większość kontrolerów zgodnych z Overvis domyślnie używa Modbus RTU. Jeśli podłączone urządzenie wymaga Modbus ASCII, skonfiguruj to w ustawieniach portu szeregowego kontrolera (interfejs WWW lub rejestry Modbus). Sam Overvis komunikuje się z kontrolerem przez Modbus TCP, który jest niezależny od trybu RTU/ASCII — kontroler obsługuje translację RTU/ASCII po stronie RS-485.
Każde fizyczne urządzenie Modbus RTU podłączone do portu RS-485 kontrolera jest reprezentowane w Overvis jako urządzenie, identyfikowane przez swój identyfikator jednostki Modbus w sieci.
Aby dodać urządzenie, otwórz stronę sieci w Overvis i kliknij Dodaj urządzenie. Podaj nazwę urządzenia, identyfikator Modbus oraz opcjonalnie wybierz szablon urządzenia, aby wstępnie skonfigurować wszystkie parametry. Jeśli szablon nie jest dostępny, możesz dodać parametry ręcznie, podając adresy rejestrów, typy danych i nazwy.
Informacje o mapie rejestrów Modbus urządzenia, obsługiwanych kodach funkcji i typach danych znajdziesz zwykle w dokumentacji lub karcie katalogowej urządzenia, najczęściej w rozdziale „Rejestry Modbus”, „Protokół komunikacji” lub „Mapa rejestrów”.
Gdy próbujesz utworzyć sieć przy użyciu kontrolera już zarejestrowanego w Overvis, zachowanie zależy od metody połączenia oraz tego, czy kontroler należy do Twojego konta, czy do innego.
Jeśli kod PIN jest już przypisany do sieci w Twoim koncie, Overvis wyświetla ostrzeżenie:
Kod połączenia ABCD1234 jest już przypisany do sieci Magazyn. Po wysłaniu tego formularza ta sieć zostanie rozłączona. Wszystkie dane zostaną zachowane.
Możesz kontynuować — stara sieć zostanie rozłączona, a kontroler przypisany do nowej sieci. Stara sieć i jej dane (parametry urządzeń, historia odczytów) pozostają dostępne.
Jeśli kontroler jest już przypisany do sieci w innym koncie Overvis, kod PIN nie może go ponownie przypisać. Kod PIN ma niższy priorytet — potwierdza posiadanie naklejki, ale niekoniecznie fizyczny dostęp do urządzenia.
Aby przejąć kontroler, zamiast tego użyj metody kodu aktywacji.
Kod aktywacji ma wyższy priorytet niż kod PIN, ponieważ wymaga odczytu kodu z wyświetlacza lub interfejsu WWW urządzenia, co potwierdza fizyczny dostęp. Kod aktywacji może przejąć kontroler z dowolnego konta — po przypisaniu urządzenie jest usuwane z sieci poprzedniego właściciela.
Aby odłączyć kontroler od bieżącej sieci (aby mógł być ponownie zarejestrowany przez Ciebie lub innego użytkownika), użyj dowolnej z metod:
Usuń sieć w Overvis, do której kontroler jest przypisany.
Zmień ustawienia połączenia sieci na inną metodę połączenia (np. przełącz z połączenia zwrotnego na bezpośrednie).
Zresetuj aktywację na urządzeniu — wejdź do interfejsu WWW kontrolera i kliknij przycisk „Restart Activation” (MC252, EM-483) lub „Reset Activation Code” (EM-130). To usuwa urządzenie z sieci Overvis i generuje nowy kod aktywacji.
Po odłączeniu kontroler ponownie łączy się z Overvis i otrzymuje nowy kod aktywacji, gotowy do ponownej rejestracji.
Niektóre kontrolery obsługują ochronę dostępu hasłem do odczytu i/lub zapisu rejestrów. Jeśli na kontrolerze skonfigurowano hasła, dodaj je w sekcji Hasło(a) dostępu do kontrolera. Overvis wysyła te hasła do kontrolera po połączeniu, dokładnie tak, jak zostały wprowadzone.
Możesz dodać wiele haseł — np. osobne do odczytu i zapisu. Kontroler określa, jaki poziom dostępu przyznaje każde hasło.
Steruje tym, ile żądań Modbus Overvis wysyła jednocześnie do tej sieci (równolegle). Domyślnie jest 1 — Overvis czeka na każdą odpowiedź przed wysłaniem następnego żądania (tryb sekwencyjny).
Zwiększenie tej wartości pozwala wysyłać wiele żądań naraz, co może przyspieszyć odpytywanie, gdy kontroler to obsługuje. Wiele kontrolerów RS-485 i tak przetwarza żądania sekwencyjnie na magistrali szeregowej, więc wysoka wartość może nie poprawić wydajności i może powodować timeouty, jeśli kolejka żądań kontrolera się przepełni.
Używaj domyślnej wartości 1, chyba że wiesz, że kontroler obsługuje równoległe przetwarzanie żądań.
Sieci można wyłączyć, aby wstrzymać całą komunikację bez usuwania sieci i utraty danych. Wyłączona sieć zatrzymuje wszystkie odczyty, zapisy, śledzenie w tle i przetwarzanie alertów. Pulpit i wizualizacje nie mają dostępu do wyłączonych sieci. Wszystkie istniejące dane i ustawienia są zachowywane, a sieć można w dowolnym momencie ponownie włączyć.
Problemy z połączeniem dzielą się na trzy poziomy. Zacznij od góry i idź w dół — każdy poziom zakłada rozwiązanie poprzedniego.
graph TD
A["Problem z dostępem do danych"] --> B{"Czy brama<br/>jest online w Overvis?"}
B -->|Nie| C["Poziom 1:<br/>Brama nieosiągalna"]
B -->|Tak| D{"Czy urządzenie<br/>odpowiada na odczyty?"}
D -->|Nie| E["Poziom 2:<br/>Urządzenie nieosiągalne"]
D -->|Tak| F{"Czy dane<br/>są poprawne?"}
F -->|Nie| G["Poziom 3:<br/>Błędne dane"]
F -->|Tak| H["Poza zakresem<br/>tego przewodnika"]
Objaw: Sieć jest widoczna jako offline w Overvis. Żadne dane nie są odczytywane z żadnego urządzenia. Stan połączenia pokazuje „Urządzenie nie jest połączone z serwerem” (połączenia zwrotne) lub „Serwer nie nawiązał połączenia” (połączenia bezpośrednie).
To oznacza, że Overvis nie może komunikować się z kontrolerem komunikacji. Przy połączeniach zwrotnych kontroler nie nawiązał lub utracił wychodzące połączenie z Overvis. Przy połączeniach bezpośrednich Overvis nie może dotrzeć do adresu IP i portu kontrolera.
Jeśli dioda PWR MC252 nie świeci, sprawdź zasilanie 9–30 V DC i bezpiecznik. Jeśli wskaźnik PWR EM-482 jest stale czerwony lub szybko miga na czerwono, urządzenie może być uszkodzone — skontaktuj się z producentem. Jeśli wskaźnik błędu EM-483 (⚠) jest stale czerwony lub okresowo po włączeniu zasilania, występuje usterka urządzenia.
2. Połączenie sieciowe (Ethernet / Wi-Fi)
Kontroler musi mieć działające połączenie z siecią lokalną, zanim będzie mógł połączyć się z Overvis przez internet.
MC252 (Ethernet): Sprawdź, czy kabel Ethernet jest podłączony i czy dioda LAN jest aktywna (miga podczas transmisji danych). Wyświetlacz pokazuje przypisany IP z prefiksem (E). Jeśli wyświetla (E) 0.0.0.0, trwa jeszcze uzgadnianie adresu przez DHCP — poczekaj 20–60 s. Jeśli pokazuje (E) 192.168.0.111, uzgadnianie adresu przez DHCP nie powiodło się i urządzenie przeszło na fabryczny statyczny adres IP. Sprawdź kabel, DHCP routera lub skonfiguruj statyczny IP w interfejsie WWW (zakładka LAN/Internet).
EM-482 (Wi-Fi): Dioda WI-FI miga wolno (co 3 s) podczas łączenia i świeci stale po połączeniu. Jeśli WI-FI miga dłużej niż 2 min, skonfigurowany punkt dostępu Wi-Fi jest niedostępny — sprawdź SSID, hasło, odległość od AP i zasilanie AP. Jeśli diody WI-FI i SRV migają naprzemiennie, urządzenie jest w trybie konfiguracji Wi-Fi — dokończ konfigurację w interfejsie WWW lub wyjdź z trybu, przytrzymując przycisk R około 3 s.
EM-130 (Wi-Fi): Urządzenie musi być w trybie klienta Wi-Fi z włączonym klientem Overvis. Jeśli Wi-Fi jest wyłączone lub w trybie punktu dostępowego, nie połączy się z internetem. Skonfiguruj tryb klienta Wi-Fi w interfejsie WWW urządzenia.
3. Dostęp do internetu i połączenie z serwerem Overvis
Nawet przy działającym łączu lokalnym kontroler musi móc dotrzeć do serwera Overvis przez internet.
MC252: Sprawdź, czy świeci dioda SRV — oznacza aktywne połączenie z chmurą/serwerem. W interfejsie WWW (zakładka Cloud) sprawdź, czy połączenie z chmurą jest włączone i czy adres serwera jest poprawny (domyślnie: ocp.overvis.com, port 20502).
EM-482: Dioda SRV powinna zapalić się wkrótce po WI-FI. Jeśli SRV pozostaje wyłączona dłużej niż 2 min, urządzenie nie ma dostępu do internetu. Sprawdź adres serwera w interfejsie WWW. Upewnij się, że zapora sieciowa nie blokuje połączeń wychodzących.
EM-130: W ustawieniach zdalnego dostępu w interfejsie WWW sprawdź, czy klient Overvis jest włączony („Overvis turning on” = Tak) i czy adres serwera jest poprawny (domyślnie: modbus.overvis.com, port 20502).
4. Zapora i wymagania portów
Kontroler inicjuje wychodzące połączenie TCP z serwerem Overvis na porcie 20502. Sieci firmowe i zapory mogą to blokować. Poproś administratora sieci o zezwolenie na wychodzący ruch TCP do ocp.overvis.com:20502 (lub modbus.overvis.com:20502 dla EM-130).
5. Rozwiązywanie DNS
Kontroler musi rozwiązywać nazwę hosta serwera Overvis. Jeśli DNS w sieci lokalnej nie działa, skonfiguruj publiczny serwer DNS (np. 8.8.8.8) na kontrolerze. EM-130 domyślnie używa 208.67.222.222 i 8.8.8.8 jako serwerów DNS.
6. Połączenie GSM/LTE (MC252)
Dla kontrolerów z łącznością komórkową:
Upewnij się, że karta SIM jest włożona do końca (aż do kliknięcia) i ma aktywną usługę danych.
Sprawdź, czy antena jest podłączona do złącza ANT.
Sprawdź siłę sygnału GSM na wyświetlaczu MC252 (powinna być >0%).
W interfejsie WWW (zakładka LAN/Internet → sekcja GSM) sprawdź, czy ustawienia APN odpowiadają wymaganiom operatora.
Jeśli karta ma blokadę PIN, wprowadź ją w ustawieniach GSM. W razie wątpliwości wyłącz najpierw PIN karty w telefonie.
Spróbuj zmienić położenie anteny dla lepszego sygnału.
7. Połączenie z chmurą wyłączone na kontrolerze
Niektóre kontrolery są dostarczane z domyślnie wyłączonym połączeniem z chmurą:
MC252: W interfejsie WWW otwórz zakładkę Cloud i sprawdź, czy połączenie z chmurą jest włączone. Po włączeniu kliknij „Save & Reset”.
EM-130: Klient Overvis jest domyślnie wyłączony. Włącz go w ustawieniach zdalnego dostępu w interfejsie WWW.
EM-482, EM-483: Połączenie z chmurą jest domyślnie włączone. Jeśli zostało wyłączone, włącz ponownie w interfejsie WWW.
Statyczny IP — sprawdź, czy publiczny adres IP się nie zmienił. Zapytaj dostawcę internetu lub z sieci, w której jest kontroler, sprawdź publiczny adres (np. w wyszukiwarce: „jaki jest mój IP”).
Przekierowanie portów — sprawdź, czy reguła przekierowania na routerze jest nadal aktywna i wskazuje poprawny wewnętrzny adres IP i port (domyślny port Modbus TCP: 502).
Lokalny IP kontrolera — czy lokalny IP kontrolera się zmienił (wygasła dzierżawa DHCP)? Skonfiguruj ponownie rezerwację DHCP lub użyj statycznego IP na kontrolerze.
Zapora — sprawdź, czy żadna zapora między Overvis a routerem nie blokuje skonfigurowanego portu.
Kontroler — sprawdź, czy kontroler jest zasilany, działa i czy usługa Modbus TCP jest aktywna na oczekiwanym porcie. Na MC252 w interfejsie WWW sprawdź zakładkę Modbus, czy serwer Modbus TCP jest włączony na porcie 502.
Objaw: Sieć jest online (brama połączona), ale jedno lub więcej urządzeń pokazuje błędy odczytu, timeouty lub „brak odpowiedzi” dla wszystkich parametrów.
Kontroler komunikuje się z Overvis, ale nie może nawiązać komunikacji z urządzeniem końcowym na magistrali RS-485.
1. Sprawdź adres Modbus
Upewnij się, że adres Modbus (ID jednostki) urządzenia w Overvis zgadza się z adresem skonfigurowanym na urządzeniu fizycznym. Adres zwykle ustawia się przełącznikami DIP, panelem przednim lub oprogramowaniem konfiguracyjnym. Typowe adresy domyślne zależą od producenta — sprawdź instrukcję urządzenia.
2. Sprawdź polaryzację okablowania RS-485
Zamień przewody A i B na kontrolerze lub na urządzeniu. Odwrotna polaryzacja to najczęstszy problem RS-485 i nie uszkadza sprzętu. Różni producenci oznaczają zaciski niespójnie — to, co jeden nazywa „A”, inny może nazywać „B”. Szukaj oznaczeń D+/D- lub +/- jako bardziej wiarygodnej wskazówki.
3. Dopasuj ustawienia komunikacji szeregowej
Wszystkie urządzenia na magistrali RS-485 muszą mieć identyczne ustawienia szeregowe. Niezgodność któregokolwiek parametru powoduje całkowitą ciszę (brak odpowiedzi) lub błędy CRC:
Prędkość transmisji — sprawdź, czy prędkość na kontrolerze zgadza się z prędkością urządzenia. Najczęstszy domyślny to 9600.
Parzystość / bity stopu — sprawdź, czy format bajtu (np. 8N1 vs 8E1) jest zgodny między kontrolerem a wszystkimi urządzeniami. Jeśli nie masz pewności, spróbuj trybu AUTO-STOP na kontrolerach, które go obsługują (MC252, EM-482) — wysyłka z 2 bitami stopu, akceptacja 1 lub 2 bitów stopu.
Modbus RTU vs ASCII — zdecydowana większość urządzeń używa trybu RTU. Jeśli urządzenie wymaga trybu ASCII, skonfiguruj kontroler odpowiednio.
Dla kontrolerów zgodnych z Overvis ustawienia te można zmienić przez:
MC252: Interfejs WWW (zakładka Modbus → sekcja RS-485) lub zdalnie przez ustawienia sieci Overvis.
EM-482: Interfejs WWW podczas konfiguracji lub zdalnie przez ustawienia sieci Overvis.
4. Narzędzie wyszukiwania urządzeń MC252
Interfejs WWW MC252 ma wbudowane narzędzie Search Devices (zakładka Modbus → przycisk Search Devices), które skanuje wszystkie adresy Modbus i opcjonalnie próbuje różnych prędkości, parzystości i ustawień protokołu. Może zidentyfikować podłączone urządzenia i ich rzeczywistą konfigurację. Pełne wyszukiwanie trwa 30–60 min; użyj opcji Fast search, jeśli wiesz, że wszystkie urządzenia mają te same ustawienia.
5. Narzędzie Send Request w MC252
Interfejs WWW MC252 ma narzędzie Send Request (zakładka Modbus → przycisk Send Request), które wysyła pojedyncze żądanie Modbus i pokazuje surową odpowiedź. Użyj go do testu komunikacji z konkretnym adresem urządzenia i weryfikacji odpowiedzi. Kod wyjątku w odpowiedzi nie musi oznaczać usterki urządzenia — może tylko znaczyć, że urządzenie nie ma żądanego rejestru.
6. Sprawdź kabel i topologię magistrali
Sprawdź uszkodzenie kabla, luźne zaciski lub przerwane przewody.
RS-485 musi być prowadzony w łańcuchu (topologia magistrali), a nie w gwiazdę. Unikaj odgałęzień (T) dłuższych niż kilka centymetrów.
Na długich magistralach (>100 m) lub przy wysokich prędkościach (>38400) dodaj rezystory terminujące 120 Ω na obu końcach magistrali. Uwaga: EM-482 ma wbudowany terminator wewnętrzny 1000 Ω.
Jako test użyj krótszego kabla, aby wykluczyć problem kabla.
7. Sprawdź zasilanie i stan urządzenia
Upewnij się, że urządzenie jest zasilane i w normalnym trybie pracy (nie w konfiguracji, aktualizacji oprogramowania ani stanie błędu). Niektóre urządzenia wyłączają komunikację Modbus w określonych trybach.
8. Sprawdź konflikty na magistrali
Upewnij się, że żadne dwa urządzenia na tej samej magistrali RS-485 nie mają tego samego adresu Modbus. Zduplikowane adresy powodują kolizje i zniekształcone odpowiedzi.
Jeśli zbliżasz się do limitu urządzeń dla danego typu transceivera (32 dla standardowych odbiorników 1 mA, 128–256 dla odbiorników niskiego poboru), spróbuj odłączyć część urządzeń i sprawdź, czy komunikacja się poprawia.
9. Zakłócenia elektryczne
Komunikację RS-485 mogą zakłócać pobliskie falowniki (VFD), silniki, przełączanie wysokiego napięcia lub urządzenia spawalnicze. Prowadź kable RS-485 z dala od linii zasilających i używaj ekranowanej skrętki. Ekran kabla połącz z masą na jednym końcu magistrali.
Poziom 3: urządzenie odpowiada, ale dane są błędne
Objaw: Urządzenie odpowiada, ale wartości w Overvis są nieprawidłowe — złe liczby, stale zero, wartości ujemne tam, gdzie oczekiwane są dodatnie itd.
Ścieżka komunikacji działa, ale konfiguracja parametrów nie jest zgodna z mapą rejestrów urządzenia.
1. Przesunięcie adresu rejestru
Konwencje adresowania rejestrów Modbus różnią się między producentami. Niektóre instrukcje dokumentują adresy od 0, inne od 1, a jeszcze inne od 40001 (konwencja Modicon, gdzie 40001 = rejestr przechowywania 0). Jeśli wartość jest przesunięta o jeden rejestr lub stale przesunięta, spróbuj skorygować adres rejestru o ±1.
2. Niezgodność typu rejestru
Modbus definiuje cztery typy rejestrów. Użycie niewłaściwego typu powoduje odczyt z innej przestrzeni adresowej:
Typ rejestru
Kody funkcji
Typowe zastosowanie
Rejestry holdingowe
3 (odczyt), 6/16 (zapis)
Konfiguracja i dane z możliwością odczytu i zapisu
Rejestry wejściowe
4 (odczyt)
Pomiary tylko do odczytu
Cewki
1 (odczyt), 5/15 (zapis)
Stany jednobitowe wł./wył.
Wejścia dyskretne
2 (odczyt)
Stany jednobitowe tylko do odczytu
Sprawdź, czy parametr w Overvis używa tego samego typu rejestru, co w dokumentacji urządzenia.
3. Typ danych i kolejność bajtów
Jeśli temperatura jest zapisana jako 32-bitowa liczba zmiennoprzecinkowa, a odczytasz ją jak dwie niezależne 16-bitowe liczby całkowite, zobaczysz nieprawidłowe wartości. Typowe typy danych:
16-bitowa liczba całkowita bez znaku (1 rejestr)
16-bitowa liczba całkowita ze znakiem (1 rejestr)
32-bitowa liczba zmiennoprzecinkowa IEEE 754 (2 rejestry)
32-bitowa liczba całkowita bez znaku / ze znakiem (2 rejestry)
Dla wartości wielorejestrowych sprawdź zarówno kolejność bajtów (big-endian vs little-endian), jak i kolejność słów (AB CD vs CD AB). Narzędzie Send Request w interfejsie WWW MC252 może pomóc ustalić poprawną interpretację, pokazując surowe wartości rejestrów.
4. Współczynnik skalowania
Wiele urządzeń przechowuje wartości z domyślną pozycją dziesiętną. Na przykład temperatura 23,5 °C może być zapisana jako liczba całkowita 235 (×10) lub 2350 (×100). EM-130 na przykład reprezentuje wszystkie wartości dziesiętne jako liczby całkowite ze współczynnikiem zależnym od liczby miejsc po przecinku (1 miejsce = ×10, 2 = ×100, 3 = ×1000). Sprawdź w dokumentacji urządzenia współczynnik skalowania.
5. Dokumentacja urządzenia
Mapa rejestrów Modbus urządzenia jest źródłem prawdy dla adresów, typów i skalowania. Zwykle znajduje się w instrukcji urządzenia, osobnym dokumencie z opisem protokołu komunikacji lub na stronie producenta. Dla urządzeń zgodnych z Overvis mapy rejestrów są dostępne w dokumentacji urządzenia:
Na stronie statusu interfejsu WWW EM-483 widać stan połączenia z serwerem: kod aktywacji (oczekiwanie na przypisanie), „Active” (przypisane do Overvis) lub „No Code” (zarejestrowane przez naklejkę QR/PIN).
EM-130 ma pojedynczy wskaźnik On/Off i przycisk Wi-Fi — brak wyświetlacza. Diagnozuj stan połączenia przez interfejs WWW. W ustawieniach zdalnego dostępu sprawdź, czy klient Overvis jest włączony i czy wyświetlany jest kod aktywacji (oznacza nawiązanie połączenia z serwerem).
Overvis Cloud Documentation
Sieci, urządzenia i parametry
Overvis organizuje dane z terenu w trójpoziomowej hierarchii:
Poziom
Element nadrzędny
Reprezentuje
Główna odpowiedzialność
Sieć
Organizacja
Jedno połączenie ze sterownikiem lub bramą
Osiągalność i komunikacja na poziomie sterownika
Urządzenie
Sieć
Jedna jednostka Modbus w tej sieci
Odpytywanie i zapis dla tej jednostki
Parametr
Urządzenie
Jedna odczytywalna lub zapisywalna wartość na tym urządzeniu
Adresowanie, konwersja typu, przechowywanie danych i możliwość zapisu wartości
Ta strona to opis wszystkich trzech poziomów — co przechowują, jak są ze sobą powiązane i jak ich ustawienia wpływają na komunikację i obsługę danych. Kolejność jest taka sama jak w hierarchii: najpierw sieci, potem urządzenia, na końcu parametry. Praktyczny przewodnik znajdziesz w Pierwsze kroki. Sposoby podłączenia i rozwiązywanie problemów opisano w Podłączanie sprzętu.
Każda sieć, każde urządzenie i każdy parametr mają po dwa identyfikatory:
Wewnętrzny ID — numeryczny klucz główny używany w API i bazie danych.
Slug — przyjazny dla URL ciąg znaków wyprowadzony z nazwy obiektu (np. warehouse, temperature-controller, current-temperature). Slugi są unikalne w zakresie elementu nadrzędnego: slugi sieci — w obrębie organizacji, slugi urządzeń — w obrębie sieci, slugi parametrów — w obrębie urządzenia. Overvis używa slugów w adresach URL stron.
Sieci i urządzenia można wyłączyć bez usuwania. Wyłączenie zachowuje całą konfigurację i zapisane dane, ale zatrzymuje komunikację:
Wyłączona sieć zatrzymuje wszystkie odczyty, zapisy i odpytywanie w tle dla każdego urządzenia i parametru w niej.
Wyłączone urządzenie zatrzymuje wszystkie odczyty, zapisy i odpytywanie w tle dla każdego parametru pod nim.
Sieci i urządzenia mogą być wyłączane przez użytkownika, przez system rozliczeń (gdy saldo organizacji się wyczerpie) lub przez administratora platformy. Zapisywane są czas wyłączenia oraz informacja, kto je wyłączył, dzięki czemu przyczyna jest zawsze widoczna.
Ponowne włączenie przywraca normalną pracę od razu — ponowna konfiguracja nie jest potrzebna.
Nie ma osobnego przełącznika włączone / wyłączone dla pojedynczych parametrów. Flagi śledzony i programowalny sterują odpytywaniem, historią i zapisami (patrz Flagi zachowania); parametr z obiema flagami wyłączonymi nadal można odczytać na żądanie. Aby zatrzymać cały ruch Modbus dla urządzenia — w tym odczyty na żądanie — wyłącz urządzenie lub sieć.
Aby utworzyć sieć, przejdź do listy sieci organizacji i kliknij Dodaj sieć. Formularz tworzenia prowadzi przez wybór metody połączenia i wprowadzenie szczegółów. Krok po kroku dla każdej metody połączenia opisano w Podłączanie sprzętu.
Opisowa etykieta sieci (np. „Magazyn”, „HVAC biura”).
Opis
Opcjonalny dowolny tekst opisu.
Połączenie
Sposób, w jaki Overvis dociera do sterownika: połączenie zwrotne (kod PIN lub kod aktywacyjny) lub bezpośrednie Modbus TCP (adres IP i port). Szczegóły każdej metody — w Podłączanie sprzętu.
Sterownik Modbus TCP:
Model kontrolera komunikacji (np. MC252, EM-482, EM-130 lub „Inne urządzenie Modbus TCP” dla sprzętu innych producentów). Określa dostępne wbudowane funkcje i ustawienia. Odpowiada polu Sterownik Modbus TCP: w formularzu sieci.
Gateway Modbus Address:
Identyfikator jednostki Modbus samego sterownika na łączu TCP (domyślnie: 111). Używany, gdy Overvis musi adresować bramę bezpośrednio — np. aby odczytać lub zmienić ustawienia portu szeregowego na kompatybilnym ze Overvis sterowniku. To nie jest adres żadnego urządzenia polowego.
Hasło(a) dostępu do kontrolera:
Hasła wysyłane do sterownika po połączeniu. Niektóre sterowniki wymagają jednego lub więcej haseł do odczytu i/lub zapisu. Można skonfigurować wiele haseł (np. osobne do odczytu i zapisu).
Maksymalna liczba żądań w toku:
Ile żądań Modbus Overvis wysyła jednocześnie do tej sieci (domyślnie: 8). Zwiększenie wartości pozwala na równoległe żądania, co może przyspieszyć odpytywanie, jeśli sterownik to obsługuje. Wiele sterowników i tak przetwarza żądania RS-485 sekwencyjnie, więc wysoka wartość może nie poprawić wydajności i powodować timeouty.
Na obsługiwanych sterownikach pojawia się blok Ustawienia Modbus sterownika (prędkość transmisji i format bajtu). Overvis odczytuje bieżące wartości ze sterownika i może zapisać zmiany tym samym łączem. Widoczny tylko, gdy typ sterownika to obsługuje i sieć jest połączona. Dobór wartości zgodnych z urządzeniami polowymi — w Ustawienia komunikacji szeregowej.
Ustawienia sieci nie obejmują adresów Modbus urządzeń za sterownikiem, adresów rejestrów parametrów ani reguł interpretacji danych. Te elementy należą do poziomu urządzenia i parametru.
Strona sieci pokazuje stan połączenia z bramą oraz listę wszystkich urządzeń w sieci.
Dla każdego urządzenia lista pokazuje: Modbus ID, nazwę, liczbę monitorowanych parametrów, interwał odczytu i czas ostatniego odczytu. Z tej strony można włączać lub wyłączać poszczególne urządzenia, otwierać ustawienia urządzenia lub je usunąć.
Dla sieci z połączeniem zwrotnym (kod PIN lub kod aktywacyjny) strona pokazuje także stan połączenia i akcje zarządzania, takie jak zerwanie połączenia.
Urządzenie reprezentuje jedną jednostkę Modbus w sieci — jeden adresowalny punkt końcowy za sterownikiem. Wszystkie urządzenia w sieci korzystają z tego samego połączenia ze sterownikiem.
Kluczowym identyfikatorem jest Modbus ID (ID jednostki, 0–255); musi być unikalny w obrębie sieci i zgadzać się z adresem skonfigurowanym na fizycznym urządzeniu (przełączniki DIP, panel przedni lub oprogramowanie konfiguracyjne urządzenia).
Aby utworzyć urządzenie, otwórz stronę sieci i kliknij Dodaj urządzenie.
Formularz tworzenia obejmuje:
Nazwę i opcjonalny opis.
Modbus ID — adres jednostki fizycznego urządzenia.
Szablon urządzenia (opcjonalnie) — wybór szablonu wstępnie konfigurującego wszystkie parametry automatycznie. Do wyboru są szablony wbudowane lub utworzone w organizacji. Szczegóły — w Szablony urządzeń.
Jeśli nie ma szablonu dla Twojego urządzenia, parametry możesz dodać ręcznie po utworzeniu urządzenia.
Po utworzeniu urządzenia Overvis od razu zaczyna się z nim komunikować (o ile sieć jest połączona i urządzenie jest włączone).
Modbus ID (0–255). Musi odpowiadać adresowi fizycznego urządzenia i być unikalny w sieci.
Interwał odczytu (sek.):
10 minut
Jak często Overvis wykonuje w tle odczyty monitorowanych parametrów na tym urządzeniu. Krótsze okresy dają częstsze dane, ale zwiększają obciążenie sieci.
Wielkość grupy czytania:
1
Maksymalna liczba kolejnych rejestrów, które Overvis łączy w jedno żądanie odczytu Modbus. Interfejs ustawień urządzenia przyjmuje 1–16; baza danych dopuszcza do 255 (np. przy imporcie z szablonu). Wyższe wartości zmniejszają liczbę żądań, odczytując większe bloki rejestrów naraz, co przyspiesza odpytywanie. Wartość 1 oznacza odczyt każdego parametru osobno.
Funkcja zapisu Modbus:
0x6 do zapisu jednego rejestru, 0x10 dla kilku
Której funkcji Modbus użyć przy zapisie wartości parametrów. Opcje: 0x6 do zapisu jednego rejestru, 0x10 dla kilku (Overvis wybiera automatycznie — funkcja 06 dla pojedynczego rejestru, funkcja 16 dla wielu rejestrów), Zawsze używaj funkcji 0x6 (wymusza zapis pojedynczym rejestrem), Zawsze używaj funkcji 0x10 (wymusza zapis wieloma rejestrami). Niektóre urządzenia akceptują tylko jedną funkcję zapisu — sprawdź dokumentację urządzenia.
Maksymalna liczba ponownych prób żądania:
3
Ile razy Overvis ponawia żądanie po timeoutie lub braku odpowiedzi, zanim uzna urządzenie za nieosiągalne.
Ustawienia urządzenia nie definiują ścieżki połączenia ze sterownikiem (to poziom sieci) ani sposobu dekodowania poszczególnych wartości rejestrów (to poziom parametru).
Strona urządzenia służy do przeglądania i obsługi wartości parametrów. Parametry są grupowane według flag zachowania (śledzony, programowalny) w sekcje — patrz Flagi zachowania.
Strona urządzenia pokazuje:
Ostatni odczyt — znacznik czasu ostatniego odczytu w tle dla tego urządzenia.
Następny odczyt — kiedy zaplanowany jest następny odczyt w tle.
Lista parametrów — wszystkie parametry w trzech sekcjach (monitorowane, programowalne, nieśledzone), z kategoriami w każdej sekcji.
Śledzone parametry domyślnie pokazują ostatnią zapisaną wartość. Może ona pochodzić z ostatniego odpytywania w tle, niekoniecznie na żywo.
Aby odczytać wartość na żywo z urządzenia:
Kliknij wartość parametru, aby rozpocząć jej odczyt z urządzenia w czasie rzeczywistym. Overvis będzie odświeżał tę wartość automatycznie, dopóki nie klikniesz ponownie. Działa to dla parametrów śledzonych i nieśledzonych.
Kliknij ikonę odświeżania w nagłówku kolumny, aby odczytać naraz wszystkie widoczne wartości parametrów.
Nieśledzone parametry pokazują „---”, dopóki nie uruchomisz odczytu na żądanie.
Programowalne parametry mają obok wartości ikonę ołówka. Kliknięcie otwiera edytor w miejscu:
Dla parametrów numerycznych pojawia się pole tekstowe, w którym wpisujesz nową wartość.
Dla parametrów wyliczeniowych pojawia się lista rozwijana ze zdefiniowanymi etykietami (np. „Standby”, „Grzanie”, „Chłodzenie”) — Overvis zapisuje odpowiadającą wartość numeryczną na urządzeniu.
Zapis jest wysyłany do urządzenia od razu. Jeśli zapis się nie powiedzie, Overvis pokazuje komunikat błędu z przyczyną.
Parametr to najmniejszy obiekt operacyjny w hierarchii. Reprezentuje jedną definicję wartości na urządzeniu — pojedynczy fragment danych, który Overvis może odczytać lub zapisać.
Parametr może reprezentować:
Jeden rejestr holdingowy lub wejściowy.
Jedną cewkę lub wejście dyskretne.
Jeden bit w rejestrze.
Ciągły zakres bitów w rejestrze.
Wartość wielorejestrową (np. float 32-bitowy na dwóch rejestrach lub liczba całkowita 64-bitowa na czterech).
Aby dodać parametr ręcznie, otwórz stronę urządzenia i kliknij Dodaj parametr. Formularz zawiera wszystkie pola opisane poniżej: nazwa, adres, rodzaj rejestru, typ wartości, flagi zachowania, ustawienia konwersji oraz opcjonalne wartości wyliczenia.
Aby edytować istniejący parametr, kliknij jego nazwę na stronie urządzenia, aby otworzyć ustawienia parametru. Pojawia się ten sam formularz z wypełnionymi bieżącymi wartościami.
Jeśli urządzenie ma wiele parametrów, szybsze jest użycie szablonu urządzenia niż dodawanie ich pojedynczo.
Każdy parametr przechowuje następujące pola identyfikacyjne i organizacyjne:
Pole
Opis
Nazwa
Główna etykieta wyświetlana (np. „Aktualna temperatura”, „Nastawa”, „Tryb pracy”).
Mnemonik
Opcjonalny krótki kod lub skrót (do 20 znaków), zwykle z dokumentacji urządzenia (np. „PV”, „SV”, „St”). Po ustawieniu Overvis wyświetla go przed nazwą.
Opis
Opcjonalny tekst wyjaśniający.
Kategoria
Grupuje parametry na stronie urządzenia (np. „Pomiar”, „Ustawienia”, „Diagnostyka”). Kategorie mają wyłącznie charakter organizacyjny — nie wpływają na adresowanie, odpytywanie ani zapisy. Parametry bez kategorii trafiają pod „Brak kategorii”.
Jednostki
Etykieta jednostki miary do wyświetlania (np. °C, kWh, V, A, %).
Dla typów wartości bit i grupa bitów: który bit w rejestrze (0 = najmniej znaczący).
Długość grupy bitów
Dla typu grupa bitów: ile kolejnych bitów obejmuje wartość.
Długość łańcucha
Dla typów wartości łańcuch: ile rejestrów zajmuje łańcuch.
Ten sam adres pamięci urządzenia może legalnie występować w więcej niż jednym parametrze, gdy parametry reprezentują różne widoki tych samych danych — np. wartość numeryczną całego rejestru i pojedynczą flagę bitową w tym samym rejestrze lub kilka niezależnych flag bitowych z jednego rejestru statusu.
Typ wartości określa, jak interpretowane są surowe dane rejestru. Określa układ binarny, kolejność bajtów i liczbę rejestrów zajmowanych przez parametr.
Overvis obsługuje szeroki zakres typów wartości:
Kategoria
Typy wartości
Rejestry
Liczby całkowite 8-bitowe
Bajt bez znaku, bajt ze znakiem
1
Liczby całkowite 16-bitowe
Short bez znaku / ze znakiem (warianty big-endian i zamiana bajtów)
1
Liczby całkowite 32-bitowe
Int bez znaku / ze znakiem (warianty big-endian, zamiana bajtów, zamiana słów)
2
Liczby całkowite 64-bitowe
Long bez znaku / ze znakiem (warianty big-endian, zamiana bajtów, zamiana słów)
Łańcuch bajtowy (2 znaki ASCII na rejestr) lub łańcuch słowowy (1 znak ASCII na rejestr)
Zmienna
Adres IP
Adres IPv4 w kolejności bajtów lub słów
2
Adres MAC
Adres MAC w kolejności bajtów lub słów
3
Specjalne
Int 48-bit bez znaku (3 rejestry), 3 ostatnie bajty w słowach (3 rejestry)
3
Kolejność bajtów ma znaczenie. Wiele urządzeń przechowuje wartości wielobajtowe w kolejności big-endian (najpierw najbardziej znaczący bajt), ale niektóre używają układów z zamianą bajtów lub słów. Jeśli wartość wygląda na śmieci lub nieracjonalną liczbę, kolejność bajtów jest prawdopodobnie zła — wypróbuj inne warianty dla tej samej szerokości danych.
Trzy flagi sterują tym, jak Overvis traktuje parametr operacyjnie:
Śledzony — taki parametr uczestniczy w odpytywaniu w tle i trwałym przechowywaniu danych:
Overvis odczytuje go okresowo zgodnie z interwałem odczytu nadrzędnego urządzenia.
Każdy odczyt jest zapisywany w bazie ze znacznikiem czasu.
Dane historyczne są dostępne na wykresach, w raportach i na pulpicie.
Nieśledzony parametr nadal jest częścią modelu urządzenia i można go odczytać na żądanie, ale nie jest odpytywany automatycznie i jego wartości nie są zapisywane.
Programowalny — programowalny parametr można zapisać przez Overvis. Parametry nieprogramowalne są tylko do odczytu w interfejsie Overvis niezależnie od tego, czy podstawowy rejestr obsługuje zapisy.
Śledzony i programowalny są niezależnymi flagami. Parametr może być:
Tylko śledzony — monitorowany i zapisywany w historii, ale bez możliwości zapisu przez Overvis.
Tylko programowalny — zapisywalny, ale nie odpytywany automatycznie ani zapisywany w historii.
Oba — odpytywany, zapisywany w historii i zapisywalny.
Żaden — istnieje w modelu urządzenia wyłącznie do odczytów na żądanie.
Zawsze czytaj i pisz w jednym żądaniu — po włączeniu Overvis utrzymuje całą wartość wielorejestrową w jednym żądaniu Modbus zamiast pozwalać na podział na osobne żądania. Ma to znaczenie dla parametrów obejmujących więcej niż jeden rejestr (np. liczby zmiennoprzecinkowe 32-bitowe, liczby całkowite 64-bitowe, łańcuchy), gdzie częściowe odczyty mogłyby dać uszkodzone wartości, jeśli urządzenie nie aktualizuje wszystkich rejestrów w tej samej chwili.
Na stronie urządzenia parametry są grupowane w trzy sekcje według tych flag:
Monitorowane parametry — flaga śledzenia włączona (niezależnie od tego, czy jest też programowalny).
Programowalne parametry — programowalny, ale nie śledzony. Nazwa sekcji Programowalne parametry odnosi się do znaczenia „programowalny”, a nie do programowania w stylu PLC.
Nieśledzone parametry — ani śledzone, ani programowalne.
W każdej sekcji parametry są dodatkowo grupowane według kategorii.
Po odczycie surowej wartości z urządzenia Overvis może ją przekształcić na potrzeby wyświetlania za pomocą trzech ustawień na poziomie parametru:
Ustawienie
Opis
Mnożnik
Skaluje surową wartość — stosuje się go przez pomnożenie.
Przesunięcie
Dodaje stałe przesunięcie po skalowaniu.
Miejsca dziesiętne
Określa, ile cyfr po przecinku pokazuje sformatowana wartość.
Wzór konwersji:
wartość wyświetlana = surowa wartość × mnożnik + przesunięcie
Na przykład: jeśli czujnik temperatury przechowuje wartości w dziesiątych stopnia (surowa wartość 235 oznacza 23,5 °C), ustaw mnożnik na 0,1, aby przeliczyć na stopnie. Jeśli urządzenie przechowuje wartość ze stałym przesunięciem, użyj przesunięcia, aby to skompensować.
Overvis przechowuje surowe wartości rejestrów w bazie i stosuje konwersję przy wyświetlaniu. Oznacza to, że mnożnik i przesunięcie wpływają na wygląd wszystkich odczytów — zarówno historycznych, jak i nowych. Zmiana mnożnika retroaktywnie zmienia sposób wyświetlania starych danych na wykresach i w raportach. Miejsca dziesiętne wpływają tylko na formatowanie, nie na zapisaną wartość.
Gdy ani mnożnik, ani przesunięcie nie są ustawione, Overvis traktuje wartość jako nieskalowaną: wyświetlana wartość równa się surowej wartości rejestru (równoważnie mnożnik 1 i przesunięcie 0).
Wyliczenie to typ wartości dla parametrów, w których numeryczny rejestr koduje dyskretny stan lub tryb — np. status maszyny, tryb pracy lub typ alarmu. Na poziomie Modbus działa jak każdy inny parametr numeryczny, ale Overvis mapuje surowe wartości na czytelne etykiety za pomocą tabeli odwzorowań.
Każdy wpis w tabeli wyliczenia zawiera:
Pole
Opis
Wartość
Surowa wartość numeryczna z urządzenia.
Reprezentuj jako
Etykieta pokazywana w interfejsie (np. „Praca”, „Standby”, „Błąd”).
Opis
Opcjonalny tekst wyjaśniający ten stan.
Na przykład parametr „Tryb pracy” może mieć mapowanie:
Wartość
Reprezentuj jako
0
Standby
1
Grzanie
2
Chłodzenie
3
Błąd
Przy odczycie Overvis pokazuje „Grzanie” zamiast 1. Przy zapisie programowalnego parametru wyliczeniowego użytkownik wybiera z listy rozwijanej zdefiniowanych etykiet, a Overvis zapisuje odpowiednią wartość numeryczną.
Tabele wyliczenia można współdzielić między wieloma parametrami — przydatne, gdy kilka parametrów na różnych urządzeniach używa tego samego zestawu stanów.
Parametry mogą opcjonalnie definiować wartości minimalną i maksymalną. To granice informacyjne — pomagają ograniczać pola zapisu w interfejsie i dają kontekst oczekiwanych zakresów. Nie wpływają na sposób odczytu wartości z urządzenia.
Zwykle oznacza to, że typ wartości lub kolejność bajtów nie odpowiada temu, co urządzenie faktycznie wysyła. Na przykład odczyt liczby zmiennoprzecinkowej 32-bitowej jako 16-bitowej liczby całkowitej bez znaku albo użycie big-endian, gdy urządzenie stosuje zamianę słów.
Jak naprawić:
Otwórz ustawienia parametru i sprawdź typ wartości. Upewnij się, że zgadza się z dokumentacją urządzenia dla tego rejestru.
Jeśli szerokość danych jest poprawna, a wartość nadal wygląda źle, wypróbuj inne warianty kolejności bajtów dla tej samej szerokości (np. przełącz z „Float big-endian” na „Float word-swapped” lub „Float byte-swapped”).
Sprawdź adres pamięci urządzenia — niektóre instrukcje używają numeracji od 1, a Overvis od 0. Jeśli w instrukcji jest rejestr 40001, adres w Overvis to zwykle 0 (rejestr holdingowy).
Jeśli skonfigurowano mnożnik lub przesunięcie, zweryfikuj, czy wzór konwersji daje sensowne wyniki.
Urządzenie nie odpowiada na żądania Modbus w ramach limitu czasu odpowiedzi (timeoutu).
Typowe przyczyny i rozwiązania:
Zły Modbus ID — upewnij się, że ID ustawione w Overvis zgadza się z adresem na fizycznym urządzeniu. Sprawdź przełączniki DIP, ustawienia panelu lub oprogramowanie konfiguracyjne.
Urządzenie bez zasilania lub bez połączenia — potwierdź zasilanie i okablowanie do magistrali RS-485 podłączonej do sterownika bramy.
Sieć rozłączona — sprawdź wskaźnik stanu połączenia sieci. Jeśli sama brama jest offline, żadnego urządzenia w tej sieci nie da się osiągnąć. Patrz Podłączanie sprzętu — Rozwiązywanie problemów.
Niezgodność ustawień RS-485 — prędkość transmisji i format bajtu (parzystość, bity stopu) na bramie muszą być zgodne z urządzeniem. Niezgodne ustawienia szeregowe powodują błędy komunikacji. Patrz Podłączanie sprzętu — Ustawienia szeregowe.
Zduplikowane identyfikatory Modbus — dwa fizyczne urządzenia na tej samej magistrali RS-485 z tym samym adresem Modbus będą się wzajemnie zakłócać i powodować sporadyczne błędy lub uszkodzone odpowiedzi.
Wartość ”---” oznacza, że Overvis nie ma zapisanego odczytu dla tego parametru. To normalne dla nieśledzonych parametrów, dla których nigdy nie wykonano odczytu na żądanie.
Jak naprawić:
Kliknij pole wartości, aby wywołać odczyt na żądanie z urządzenia. Jeśli urządzenie jest online i adres parametru jest prawidłowy, pojawi się bieżąca wartość.
Jeśli potrzebujesz danych historycznych dla tego parametru, włącz flagę śledzony w ustawieniach parametru.
Gdy Overvis nie może zapisać wartości parametru, typowe przyczyny to:
Parametr nie jest programowalny — zapis jest dozwolony tylko dla parametrów z włączoną flagą programowalny. Włącz ją w ustawieniach parametru.
Zła funkcja zapisu — niektóre urządzenia akceptują tylko kod funkcji 06 (zapis pojedynczego rejestru) lub 16 (zapis wielu rejestrów), ale nie oba. Zmień funkcję zapisu Modbus w ustawieniach urządzenia z opcji 0x6 do zapisu jednego rejestru, 0x10 dla kilku na Zawsze używaj funkcji 0x6 lub Zawsze używaj funkcji 0x10, zgodnie z tym, czego wymaga urządzenie.
Rejestr tylko do odczytu — podstawowy typ rejestru Modbus (np. rejestr wejściowy, wejście dyskretne) nie obsługuje zapisów. Sprawdź dokumentację urządzenia.
Wartość poza zakresem urządzenia — urządzenie może odrzucać wartości poza wewnętrznymi limitami, nawet jeśli parametr w Overvis je dopuszcza.
Brak hasła dostępu do kontrolera — niektóre sterowniki wymagają hasła do zapisu. Sprawdź hasło(a) dostępu do kontrolera w ustawieniach sieci.
Jeśli śledzone parametry aktualizują się rzadziej niż skonfigurowany okres aktualizacji:
Wiele urządzeń na jednym sterowniku — wszystkie urządzenia w sieci dzielą to samo połączenie. Jeśli w jednej sieci jest wiele urządzeń z wieloma parametrami, odpytanie wszystkich zajmuje czas. Rzeczywisty cykl może przekraczać okres aktualizacji.
Zbyt mały rozmiar grupy odczytu — rozmiar 1 oznacza odczyt każdego parametru osobno, czyli jedno żądanie Modbus na parametr. Zwiększenie rozmiaru grupy odczytu (w zakresie 1–16 w interfejsie ustawień urządzenia lub do 255, gdy dozwolone) łączy kolejne rejestry w mniejszą liczbę żądań, co przyspiesza odpytywanie.
Wiele równoległych żądań przy wolnym sterowniku — wiele sterowników RS-485 przetwarza żądania sekwencyjnie. Zbyt wysoka liczba równoległych żądań może powodować kolejkowanie i timeouty podczas oczekiwania, wywołując ponowienia i dalsze spowolnienie cyklu.
Częste ponowienia — jeśli niektóre urządzenia na magistrali są nieosiągalne lub okresowo zawodzą, Overvis traci czas na ponowienia przed przejściem dalej. Każde ponowienie czeka na timeout, zanim uzna niepowodzenie.
Na stronie urządzenia możesz masowo zmieniać flagi zachowania. Zaznacz parametry w polach wyboru i użyj przycisków pod listą parametrów, aby oznaczyć je jako śledzone lub nieśledzone. Śledzenie można też zmieniać w ustawieniach pojedynczego parametru.
Włączenie śledzenia uruchamia odpytywanie w tle i zapis danych dla tego parametru. Wyłączenie śledzenia zatrzymuje odpytywanie i zapis, ale istniejące dane historyczne są zachowane.
Czy mogę użyć tego samego adresu pamięci urządzenia dla wielu parametrów?
Tak. To częste, gdy jeden rejestr zawiera wiele niezależnych flag bitowych — możesz utworzyć osobne parametry typu bit z tym samym adresem pamięci urządzenia, ale różnymi pozycjami bitów. Podobnie możesz mieć jeden parametr odczytujący cały rejestr jako wartość numeryczną i drugi odczytujący pojedynczy bit statusu z tego rejestru.
Co dzieje się z danymi historycznymi po zmianie ustawień parametru?
Zmiana typu wartości, mnożnika lub przesunięcia retroaktywnie zmienia wygląd wszystkich zapisanych odczytów — patrz Konwersja wartości. Zmiana adresu pamięci urządzenia lub rodzaju rejestru powoduje, że parametr odczytuje się od tej chwili z innej lokalizacji; stare dane nadal pokazują wartości z poprzedniego adresu.
Sieci, urządzenia i parametry są fundamentem innych funkcji Overvis:
Przegląd — śledzone parametry można przypinać do przeglądu organizacji do szybkiego podglądu. Przegląd grupuje widoki według sieci i urządzenia.
Alerty — alerty progów i offline konfiguruje się dla poszczególnych parametrów lub urządzeń. Stan alertów jest widoczny na stronie urządzenia i na przeglądzie.
Wizualizacje — niestandardowe interaktywne pulpity odczytujące wartości parametrów w czasie rzeczywistym.
Raporty HACCP — raporty zgodności z HACCP zbudowane ze śledzonych parametrów temperatury.
Szablony urządzeń — konfiguracje parametrów do wielokrotnego użycia przy szybkim uruchamianiu urządzeń.
Overvis Cloud Documentation
Przegląd
Przegląd to widok na poziomie organizacji w Overvis Cloud. Łączy najważniejsze parametry ze wszystkich sieci i urządzeń na jednym ekranie, dzięki czemu możesz monitorować wartości na żywo, sprawdzać stan połączenia, widzieć aktywne alerty i zapisywać wartości do parametrów programowalnych — bez przechodzenia na poszczególne strony urządzeń.
Na przeglądzie wyświetlane są dwa rodzaje treści:
Widżety parametrów — pojedyncze parametry dodane do przeglądu. Są automatycznie grupowane według sieci i urządzenia.
Wizualizacje — niestandardowe interaktywne widżety skonfigurowane tak, aby pojawiały się na przeglądzie. Renderowane są nad widżetami parametrów. Szczegóły w Wizualizacje.
Zestaw widżetów parametrów jest wspólny dla całej organizacji — wszyscy użytkownicy w tej samej organizacji widzą na przeglądzie te same parametry. Nie ma układów przypisanych do poszczególnych użytkowników, własnych rozmieszczeń ani wielu przeglądów na organizację.
Pełnofunkcyjny przegląd dla operatorów i administratorów. Obsługuje dodawanie/usuwanie widżetów parametrów, zapisywanie wartości do parametrów programowalnych oraz przechodzenie do ustawień sieci i urządzeń.
Monitorowanie
/view/
Przegląd tylko do odczytu dla ekranów monitorujących i użytkowników z dostępem wyłącznie do podglądu. Pokazuje te same dane i układ, ale ukrywa elementy zarządzania (dodawanie/usuwanie, zapis).
Oba tryby pokazują te same widżety parametrów i wizualizacje w całej organizacji. Użytkownicy otwierający przegląd w trybie zarządzania bez uprawnień do zarządzania są automatycznie przekierowywani na przegląd w trybie monitorowania.
Przegląd oferuje dwie opcje układu, przełączane przyciskami Widok widżetu / Widok tabeli u góry strony. Wybrany widok jest zapamiętywany w przeglądarce.
Gdy na przeglądzie jest więcej niż trzy urządzenia (we wszystkich sieciach), obok przełącznika widoku pojawiają się przyciski Zwiń wszystko / Rozwiń wszystko, pozwalające jednocześnie rozwinąć lub zwinąć wszystkie panele sieci i urządzeń.
Widok widżetu jest domyślnym układem. Strona jest zorganizowana jako rozwijane panele pogrupowane według sieci i urządzenia.
Panele sieci — każda sieć pojawia się jako zwijana sekcja z:
Nazwą sieci (przyciemnioną, jeśli sieć jest wyłączona).
Ikoną stanu połączenia — zielony znacznik przy połączeniu lub czerwony krzyżyk przy braku połączenia.
Czasem od ostatniego połączenia (np. „3 minuty temu”) lub „Brak połączenia.”, jeśli sieć nigdy się nie połączyła.
Ikoną dzwonka alarmowego, gdy jest aktywny alert związany z tą siecią.
Po rozwinięciu w trybie zarządzania: linkiem Informacje o sieci oraz linkiem Zarządzanie dla sieci typu VPN.
Panele urządzeń — w każdej sieci każde urządzenie z parametrami na przeglądzie pojawia się jako zwijana karta z:
Nazwą urządzenia.
Czasem ostatniego odczytu (np. „Ostatni odczyt: 3 minuty temu”) lub „Brak odczytów.”, jeśli urządzenie nie było jeszcze odczytywane.
Następnym zaplanowanym odczytem (np. „Następny odczyt: za 2 minuty”) lub komunikatem o stanie, gdy coś uniemożliwia odczyt:
„Sieć niedostępna” — brama/kontroler jest offline.
„Brak połączenia przychodzącego” — brama połączenia zwrotnego jeszcze się nie połączyła.
„Urządzenie niedostępne” — brama jest online, ale urządzenie nie odpowiada.
„Podczas czytania” — odczyt jest właśnie wykonywany.
„Urządzenie jest zablokowane” — urządzenie zostało wyłączone.
„Odczyty w tle dezaktywowane” — automatyczne odczyty są wyłączone.
„Nieznane urządzenie” — nie można zidentyfikować urządzenia.
Wskaźnikami alertów i zdarzeń dla tego urządzenia.
Linkiem Raport zbiorczy danych, otwierającym raport odczytów dla wszystkich widżetów parametrów wyświetlanych dla tego urządzenia.
Widżety parametrów — w każdym panelu urządzenia każdy parametr pokazuje:
Nazwę parametru.
Ostatnią sformatowaną wartość (z jednostkami) lub „–”, gdy brak odczytu lub urządzenie jest zablokowane.
Czas ostatniego odczytu.
Wizualny stan na podstawie aktywnych alertów — normalny (domyślny), ostrzeżenie lub styl krytyczny.
Rozwijanie widżetu parametru. Kliknięcie widżetu parametru rozwija go i pokazuje:
Wartości min i max z ostatnich 24 godzin.
Wykres historii 24 h z odczytami z ostatniego dnia w interwałach 15-minutowych.
Link Pełna historia do pełnego raportu odczytów dla tego parametru.
Sekcję odczytów w czasie rzeczywistym, która co sekundę pobiera z urządzenia wartości na żywo, dopóki widżet pozostaje rozwinięty. Wartości są pokazane jako zwarty wykres słupkowy wypełniający się odczytami z biegiem czasu.
Odczyty w czasie rzeczywistym działają tylko wtedy, gdy widżet parametru jest rozwinięty. Zwinięcie widżetu zatrzymuje odpytywanie. Jeśli urządzenie jest zablokowane, sekcja czasu rzeczywistego pokazuje „Urządzenie jest zablokowane” zamiast wartości na żywo.
Zapisywanie wartości. W przeglądzie w trybie zarządzania kliknięcie wartości programowalnego parametru otwiera okno zapisu, w którym można wprowadzić nową wartość liczbową i wysłać ją do urządzenia. Parametry programowalne są oznaczone przerywanym podkreśleniem i ikoną długopisu przy wartości. Kliknięcie wartości otwiera okno zapisu; kliknięcie w inne miejsce widżetu rozwija go lub zwija.
Widok tabeli pokazuje te same widżety parametrów w zwartym układzie tabelarycznym. Zamiast zagnieżdżonych paneli sieci i urządzeń, urządzenia są wypisane jako płaskie wiersze: każdy wiersz ma etykietę złożoną z nazwy sieci i nazwy urządzenia, rozdzielonych znakiem » (ten sam schemat co w interfejsie).
Rozwinięcie wiersza urządzenia pokazuje tabelę z kolumnami opisanymi poniżej. W interfejsie wiersz nagłówka pokazuje tekst Parametr; następna komórka nagłówka to tylko ikona synchronizacji; trzecia i czwarta komórka nagłówka nie mają etykiet tekstowych.
Kolumna
Treść
Parametr
Nazwa parametru oraz wskaźniki alertów/zdarzeń.
Synchronizacja
Przełącznik uruchamiania/zatrzymania odczytu w czasie rzeczywistym dla tego parametru. Ikona się obraca, gdy jest aktywna.
Wartość
Ostatnia sformatowana wartość (wartość na żywo, gdy synchronizacja jest aktywna).
Wykres
Link do pełnej historii odczytów dla tego parametru.
Ikona synchronizacji w nagłówku wiersza urządzenia przełącza odczyt w czasie rzeczywistym dla wszystkich wyświetlanych parametrów tego urządzenia jednocześnie.
Widok tabeli nie udostępnia kontroli zapisu ani usuwania. Używaj go na ekranach monitorujących, gdy trzeba zobaczyć wiele parametrów jednym rzutem oka.
Każdy panel urządzenia w widoku widżetu ma przycisk Dodaj widżet parametru (widoczny tylko w trybie zarządzania). Kliknięcie otwiera okno z listą śledzonych parametrów urządzenia, pogrupowanych według kategorii. Parametry już na przeglądzie są z listy wyłączone.
Ta metoda oferuje wyłącznie parametry już oznaczone jako śledzone. Jeśli potrzebnego parametru nie ma na liście, dodaj go ze strony urządzenia (patrz niżej).
Na stronie szczegółów urządzenia zaznacz jeden lub więcej parametrów polem wyboru i kliknij Dodaj do dashboardu.
Ta metoda jest bardziej elastyczna:
Można dodać kilka parametrów naraz.
Jeśli zaznaczony parametr nie jest jeszcze śledzony, Overvis automatycznie oznacza go jako śledzony przed dodaniem (wyświetlanie na przeglądzie wymaga okresowych odczytów).
W przeglądzie w trybie zarządzania w widoku widżetu każdy widżet parametru ma przycisk usuwania (ikona kosza), który odpina go z przeglądu. Usunięcie widżetu parametru z przeglądu nie usuwa samego parametru ani jego danych historycznych — tylko usuwa go z widoku przeglądu.
Jeśli parametr zostanie usunięty z konfiguracji urządzenia, jego widżet na przeglądzie znika automatycznie.
Pole wyszukiwania u góry przeglądu filtruje według nazwy sieci i nazwy urządzenia. Nie przeszukuje nazw parametrów.
Gdy wpiszesz kilka słów, Overvis dopasowuje urządzenia, których łączna nazwa sieci i urządzenia zawiera wszystkie słowa (w dowolnej kolejności). Na przykład wpisanie „magazyn temperatura” dopasuje urządzenie o nazwie „Regulator temperatury” w sieci „Magazyn”.
Przegląd utrzymuje aktualność danych przez automatyczne aktualizacje:
Pełna struktura (lista sieci, lista urządzeń, widżety parametrów) jest wczytywana raz przy otwarciu strony.
Wartości i status (odczyty parametrów, stan połączenia, czasy odczytu urządzeń, stan alertów) są odświeżane co 10 sekund dla rozwiniętych sieci i urządzeń. Zwinięte panele nie są odpytywane — ich wartości aktualizują się po rozwinięciu.
Odczyty w czasie rzeczywistym dla poszczególnie rozwiniętych widżetów parametrów są odpytywane co 1 sekundę, dopóki pozostają rozwinięte.
Wyłączone sieci i urządzenia pozostają widoczne na przeglądzie, ale ich zachowanie się zmienia:
Wyłączone urządzenia pokazują status „Urządzenie jest zablokowane” zamiast czasu następnego odczytu.
Wartości parametrów pokazują „–” i nie są aktualizowane (nie wykonuje się odczytów ani zapisów).
Okno zapisu nie jest dostępne dla parametrów na wyłączonych urządzeniach.
Odczyty w czasie rzeczywistym pokazują „Urządzenie jest zablokowane” zamiast wartości na żywo.
Wyłączenie nie usuwa widżetów parametrów z przeglądu. Po ponownym włączeniu sieci lub urządzenia wznawia się normalne odpytywanie i aktualizacje wyświetlania. Więcej o wyłączaniu: Sieci, urządzenia i parametry — Wyłączanie.
Jeśli po dodaniu parametr się nie pojawia, odśwież stronę — przegląd wczytuje pełną strukturę raz przy otwarciu i może nie odzwierciedlać zmian dokonanych w innej karcie. Jeśli parametr nadal się nie pojawia, sprawdź, czy należy do urządzenia w bieżącej organizacji i czy parametr nie został usunięty.
Parametr nigdy nie był odczytywany — jeśli przy urządzeniu jest „Brak odczytów.”, poczekaj na następny zaplanowany cykl odczytu lub uruchom ręczny odczyt ze strony urządzenia.
Jeśli wartości aktualizują się na stronie urządzenia, ale nie na przeglądzie, rozwiń panele sieci i urządzeń — zwinięte panele nie są odpytywane o nowe wartości.
Pole wyszukiwania dopasowuje wyłącznie nazwy sieci i nazwy urządzeń — nie przeszukuje nazw parametrów. Jeśli szukasz parametru po nazwie, musisz go znaleźć po nazwie urządzenia lub sieci.
Słowa z zapytania są dopasowywane niezależnie: wszystkie muszą pojawić się gdzieś w połączonej nazwie sieci i urządzenia (w dowolnej kolejności).
Odczyty w czasie rzeczywistym wymagają rozwinięcia (kliknięcia) pojedynczego widżetu parametru. Jeśli po rozwinięciu widżetu nadal nie pojawiają się wartości na żywo:
Urządzenie może być zablokowane lub niedostępne — sprawdź status urządzenia.
Sieć może być rozłączona — sprawdź ikonę stanu połączenia w nagłówku sieci.
W widoku tabeli użyj ikony przełącznika synchronizacji, aby uruchomić odczyty w czasie rzeczywistym dla poszczególnych parametrów lub wszystkich parametrów na urządzeniu.
Nie. Każda organizacja ma jeden przegląd ze wspólnym zestawem widżetów parametrów. Wszyscy użytkownicy w organizacji widzą te same parametry. Układ przeglądu (grupowanie według sieci i urządzenia) jest automatyczny i nie można go przestawiać.
Dlaczego rozwinięte panele resetują się po odświeżeniu strony?
Stan rozwinięcia/zwinięcia paneli sieci i urządzeń jest zapisywany w pamięci lokalnej przeglądarki — przetrwa odświeżenia. Natomiast rozwinięte widżety parametrów (pod odczyty w czasie rzeczywistym) oraz zapytania wyszukiwania resetują się przy odświeżeniu z założenia.
Jeśli stan paneli znika, przyczyną może być wyczyszczenie danych przeglądarki lub korzystanie z innej przeglądarki bądź urządzenia.
Rozwiń widżet parametru w widoku widżetu, aby zobaczyć 24-godzinny miniwykres (sparkline). Kliknij link Pełna historia pod wykresem, aby otworzyć szczegółowy raport odczytów. W widoku tabeli użyj ikony wykresu w ostatniej kolumnie, aby przejść bezpośrednio do raportu odczytów.
Jaka jest różnica między widokiem widżetu a widokiem tabeli?
Widok widżetu pokazuje parametry jako interaktywne karty z miniwykresami (sparkline), odczytami w czasie rzeczywistym, kontrolami zapisu oraz możliwością dodawania/usuwania parametrów. Najlepiej nadaje się do aktywnego monitorowania i sterowania.
Widok tabeli pokazuje parametry w zwartej tabeli z przełącznikami synchronizacji dla wartości na żywo. Nie ma kontroli zapisu ani dodawania/usuwania. Najlepiej nadaje się do ekranów monitorujących i sytuacji, gdy trzeba zobaczyć wiele parametrów naraz.
Dlaczego przegląd pokazuje nieaktualne wartości dla niektórych urządzeń?
Przegląd odświeża wartości tylko dla rozwiniętych paneli sieci i urządzeń. Jeśli panel sieci lub urządzenia jest zwinięty, wartości parametrów nie są odpytywane, dopóki go nie rozwiniesz. Rozwiń panel, aby zobaczyć najnowsze wartości.
Jak dodać parametr, którego nie ma na liście w oknie „Dodaj widżet parametru”?
Okno „Dodaj widżet parametru” na przeglądzie pokazuje tylko parametry już śledzone (z włączonymi automatycznymi okresowymi odczytami). Jeśli potrzebnego parametru nie ma na liście:
Przejdź na stronę urządzenia.
Zaznacz parametr polem wyboru.
Kliknij Dodaj do dashboardu.
Overvis automatycznie włączy śledzenie parametru i doda go do przeglądu.
Overvis Cloud Documentation
Szablony urządzeń
Każde urządzenie Modbus wymaga zestawu parametrów, zanim Overvis będzie mógł odczytywać z niego dane — adresy rejestrów, typy wartości, nazwy, jednostki, flagi śledzenia itd. Ręczna konfiguracja dla licznika energii z 50 rejestrami jest czasochłonna; dla dwudziestu identycznych liczników — niepraktyczna.
Szablony urządzeń rozwiązują ten problem. Szablon to zapisana, wielokrotnie używalna konfiguracja parametrów dla konkretnego modelu urządzenia. Wybierz szablon przy tworzeniu urządzenia (lub zastosuj go później), a Overvis automatycznie skonfiguruje wszystkie parametry, widżety pulpitu, wizualizacje i alerty.
Szablon urządzenia przechowuje dwa rodzaje informacji:
Ustawienia na poziomie urządzenia — metadane i domyślne ustawienia komunikacji:
Nazwa, producent i wersja — identyfikują szablon (np. PAC3200, Siemens, 1.0). Szablon jest jednoznacznie identyfikowany w swoim zakresie (globalnym lub organizacyjnym) przez kombinację nazwy, producenta i wersji.
Kategoria — dowolny tekst służący do grupowania (np. Regulator temperatury, Licznik energii).
Rozmiar grupy odczytu — ile kolejnych rejestrów łączyć w jedno żądanie odczytu Modbus (1–255, domyślnie 1).
Funkcja zapisu — który kod funkcji zapisu Modbus użyć: normal (automatyczny wybór wg liczby rejestrów), always-6 (zawsze kod 06 — Write Single Register) lub always-16 (zawsze kod 16 — Write Multiple Registers).
Opis — opcjonalne uwagi o urządzeniu lub szablonie.
Definicje parametrów — jeden wpis na każdy rejestr lub bit udostępniany przez urządzenie:
Nazwa — czytelna etykieta (np. Temperatura zasilania).
Adres — numer rejestru Modbus (0–65535).
Rodzaj rejestru — holding, input, coil lub discrete-input.
Typ wartości — sposób interpretacji surowych danych rejestru. Overvis obsługuje szeroki zakres typów: liczby całkowite ze znakiem i bez znaku o różnej szerokości (8/16/32/48/64 bity), zmiennoprzecinkowe (32 i 64 bity), BCD, wyodrębnienia bitowe i wielobitowe, łańcuchy, adresy IP, adresy MAC oraz wartości wyliczeniowe. Typy wielorejestrowe mogą używać kolejności bajtów big-endian, zamiany bajtów lub zamiany słów. Rejestry typu coil i discrete-input muszą używać typu wartości bit.
Jednostki — jednostki miary (°C, kW, bar itd.).
Kategoria i etykieta — do grupowania i krótkiej identyfikacji w interfejsie.
Mnożnik i przesunięcie — liniowa skala surowej wartości: wyświetlana = surowa × mnożnik + przesunięcie. Niedostępne dla typów wartości: bit, łańcuch, adres IP i MAC.
Precyzja dziesiętna — liczba miejsc po przecinku (0–20).
Pozycja bitu (0–15) i liczba bitów (1–16) — dla typów wartości bit i bits, które bity w rejestrze wyodrębnić.
Długość łańcucha — dla typów byte-str i word-str, liczba znaków (1–255).
Śledzone — czy Overvis przechowuje historię odczytów dla tego parametru.
Programowalne — czy parametr można zapisywać z interfejsu.
Odczyt w grupie — czy uwzględnić ten parametr w odczytach grupowych.
Automatyczny widżet — czy utworzyć widżet pulpitu dla tego parametru przy stosowaniu szablonu.
Mapowania wyliczeń — dla parametrów typu enum, tabela mapująca wartości liczbowe na tekst (np. 0 → Wył., 1 → Wł., 2 → Błąd).
Wartości min./maks. — oczekiwany zakres do walidacji i wyświetlania.
Opcjonalne elementy dodatkowe:
Szablony alertów — wstępnie zdefiniowane alerty w formacie YAML. Po zastosowaniu szablonu Overvis może utworzyć alerty automatycznie (np. „wyślij e-mail, gdy temperatura przekroczy 80°C”). Składnię YAML opisuje Referencja szablonów alertów.
Wizualizacja urządzenia — osadzalna wizualizacja (HTML/JS) dołączana do strony urządzenia.
Tłumaczenia — nazwy parametrów, opisy, kategorie, jednostki i etykiety wyliczeń w wielu językach (angielski, ukraiński, polski, rosyjski).
Szablony globalne są utrzymywane przez Overvis i dostępne dla wszystkich użytkowników. Obejmują typowe urządzenia przemysłowe — sterowniki, liczniki energii, PLC, czujniki i bramy. Nie można edytować szablonów globalnych, ale można je sklonować do organizacji i dostosować.
Szablony organizacyjne należą do konkretnej organizacji. Są widoczne tylko dla jej członków. Można je tworzyć, edytować, klonować, usuwać i eksportować bez ograniczeń.
W interfejsie webowym Overvis przejdź do Szablony na lewym pasku bocznym:
Twoje szablony pokazuje szablony należące do bieżącej organizacji.
Szablony Globalne pokazuje wspólną bibliotekę.
Oba widoki wyświetlają nazwę szablonu, producenta, wersję oraz liczbę parametrów (śledzonych i programowalnych). Kliknij szablon, aby zobaczyć pełną listę parametrów i ustawienia.
Twoje szablony pokazuje szablony należące do Twojej organizacji lub przez nią sklonowane:
Szablony Globalne pokazuje wspólną bibliotekę utrzymywaną przez Overvis:
Jeśli szablon globalny jest bliski temu, czego potrzebujesz, ale wymaga zmian — innej skali, dodatkowych parametrów, dostosowanych alertów — sklonuj go:
Otwórz szablon globalny.
Kliknij Kopiuj szablon.
Klon pojawi się w szablonach organizacji z tymi samymi parametrami, gotowy do edycji.
Jeśli szablon o tej samej nazwie już istnieje, klon jest tworzony z numerycznym sufiksem (np. PAC3200 (1)). Mapowania wyliczeń i tłumaczenia są w pełni kopiowane do klona.
Jeśli urządzenie zostało już skonfigurowane ręcznie — wszystkie parametry, jednostki, flagi śledzenia itd. — możesz zapisać tę konfigurację jako szablon:
Otwórz stronę urządzenia.
Kliknij Zapisz jako szablon.
Wpisz nazwę szablonu (wymagane). Formularz pyta tylko o nazwę; Overvis kopiuje wszystkie parametry, ustawienia rejestrów, mapowania wyliczeń, rozmiar grupy odczytu, funkcję zapisu i metadane urządzenia do nowego szablonu.
Kliknij Utwórz szablon.
Nowy szablon pojawia się w bibliotece organizacji z tymi samymi parametrami, ustawieniami rejestrów i mapowaniami wyliczeń co urządzenie. Nazwę, producenta, wersję, kategorię i opis można później zmienić na stronie ustawień szablonu.
Dla nowych modeli urządzeń lub gdy potrzebna jest pełna kontrola nad każdym polem, utwórz szablon jako plik Excel .xlsx i zaimportuj go.
Przejdź do Twoje szablony.
Kliknij Załadować szablon.
Prześlij plik .xlsx.
Overvis waliduje strukturę i treść pliku. Błędy są zgłaszane wraz z nazwą arkusza, numerem wiersza i odwołaniem do komórki.
Gdy import się powiedzie, szablon jest dodawany do biblioteki organizacji.
Jeśli w organizacji istnieje już szablon o tej samej nazwie, wersji i producencie, import zastępuje go — stary szablon jest usuwany, a nowy zajmuje jego miejsce.
Plik Excel musi zawierać arkusz Info i arkusz Params. Opcjonalne arkusze: Visualization (kod źródłowy wizualizacji urządzenia) i Alerts (YAML szablonu alertów). Inne nazwy arkuszy są niedozwolone. Pełną specyfikację opisuje Referencja szablonów urządzeń.
Po utworzeniu lub sklonowaniu szablonu możesz edytować metadane (nazwę, producenta, wersję, kategorię i opis) na stronie ustawień szablonu. Strona ustawień zawiera też pole Szablon alertów w formacie YAML:, w którym można dodać lub edytować definicje alertów bez ponownego importu z Excela.
Aby zmienić pojedyncze definicje parametrów, wyeksportuj szablon do Excela, wprowadź zmiany w arkuszu i zaimportuj ponownie.
Każdy szablon — globalny lub organizacyjny — można wyeksportować jako plik .xlsx. Wyeksportowany plik ma taką samą strukturę jak format importu, więc można wykonać pełny cykl: eksport, edycja w arkuszu, ponowny import.
Dodając urządzenie do sieci, wybierz szablon z listy rozwijanej. Urządzenie zostanie utworzone ze wszystkimi parametrami szablonu wstępnie skonfigurowanymi. Overvis zapisuje, którego szablonu użyto, więc na stronie urządzenia widać oryginalny szablon.
Przy stosowaniu szablonu sterujesz zachowaniem za pomocą kilku ustawień:
Parametry:
Parametry szablonu są dopasowywane do istniejących parametrów urządzenia według złożonego klucza: adres rejestru, rodzaj rejestru, pozycja bitu i liczba bitów. Jeśli pasujący parametr już istnieje na urządzeniu, jest aktualizowany w miejscu. W przeciwnym razie tworzony jest nowy parametr.
Usuń parametry urządzenia, których brakuje w szablonie — opcjonalnie usuń wszystkie parametry urządzenia bez dopasowania w szablonie. Przydatne przy zamianie jednego szablonu na drugi.
Alerty:
Dodaj alerty z szablonu — główne pole wyboru (domyślnie zaznaczone). Gdy jest zaznaczone, Overvis tworzy alerty z YAML szablonu. Dwa opcjonalne zagnieżdżone pola wyboru działają tylko wtedy, gdy główne jest zaznaczone:
Zastąp istniejące alerty prezentowane w szablonie — usuń istniejące alerty pasujące do definicji w szablonie, potem dodaj alerty ze szablonu (czyste ponowne zastosowanie tych definicji).
Usuń alerty powiązane z tym urządzeniem i brakujące w szablonie — usuń istniejące alerty, których nie ma w szablonie.
Gdy zaznaczone jest tylko Dodaj alerty z szablonu, alerty ze szablonu są dodawane obok istniejących.
Włączenie tylko pierwszego zagnieżdżonego pola stosuje dodaj i usuń prezentowane. Włączenie tylko drugiego — dodaj i usuń brakujące.
Włączenie obu zagnieżdżonych pól usuwa wszystkie istniejące alerty, potem dodaje alerty ze szablonu.
Odznacz Dodaj alerty z szablonu, aby pominąć tworzenie alertów (zagnieżdżone pola muszą być wyłączone).
Widżety pulpitu:
Dodaj widżety z szablonu do pulpitu nawigacyjnego — główne pole wyboru (domyślnie zaznaczone). Gdy jest zaznaczone, Overvis tworzy widżety pulpitu dla parametrów, przy których w szablonie włączono automatyczny widżet.
Opcjonalne zagnieżdżone pole Usuń widżety urządzenia, których brakuje w szablonie — usuwa widżety pulpitu dla parametrów, które nie odpowiadają wierszowi szablonu z włączonym auto-add widget (w tym parametrów bez powiązania z zastosowanym szablonem).
Odznacz Dodaj widżety z szablonu do pulpitu nawigacyjnego, aby pominąć tworzenie widżetów (zagnieżdżone pole musi być wyłączone).
Wizualizacje:
Utwórz wizualizację urządzenia z szablonu — główne pole wyboru (domyślnie zaznaczone). Gdy szablon zawiera wizualizację urządzenia, jest ona dołączana do urządzenia.
Zagnieżdżone pole Usuń aktualnie istniejące wizualizacje urządzeń (domyślnie zaznaczone): gdy oba są włączone, istniejąca wizualizacja jest zastępowana wersją ze szablonu.
Gdy zaznaczone jest tylko Utwórz wizualizację urządzenia z szablonu, dodawana jest wizualizacja ze szablonu bez usuwania istniejących.
Odznacz Utwórz wizualizację urządzenia z szablonu, aby pominąć tworzenie wizualizacji (Usuń aktualnie istniejące wizualizacje urządzeń musi być wyłączone).
Po zastosowaniu Overvis odświeża konfigurację urządzenia na operatorze komunikacji, więc odpytywanie rozpoczyna się od razu z nowymi parametrami.
Kliknij dowolny szablon, aby zobaczyć pełne szczegóły: ustawienia na poziomie urządzenia, pełną listę parametrów z adresami, typami wartości, flagami śledzenia i mapowaniami wyliczeń.
Szablony obsługują wielojęzyczne nazwy parametrów, opisy, kategorie, jednostki i etykiety wyliczeń. Język bazowy to zawsze angielski. Dodatkowe tłumaczenia (ukraiński, polski, rosyjski) można umieścić w pliku Excel lub zarządzać nimi w ustawieniach szablonu.
Przy stosowaniu szablonu wybierasz używany język. Overvis wyszukuje tłumaczenia dla tego języka i stosuje je do nazw parametrów i innych pól tekstowych. Jeśli brakuje tłumaczenia dla konkretnego pola, używana jest wartość angielska.
Niektóre parametry urządzenia reprezentują stany dyskretne zamiast wartości ciągłych — tryby pracy, kody błędów, flagi statusu. Szablony obsługują je typem wartości enum.
Mapowanie wyliczenia określa, która wartość liczbowa rejestru odpowiada któremu tekstowi. Na przykład rejestr statusu może mapować 0 → Zatrzymany, 1 → Praca, 2 → Błąd, 3 → Konserwacja.
Mapowania wyliczeń są definiowane osobno dla każdego parametru w szablonie i mogą zawierać tłumaczenia. Gdy stosowany jest szablon z parametrami typu enum, Overvis tworzy mapowanie automatycznie, więc pulpit i widoki parametrów pokazują etykiety tekstowe zamiast surowych liczb.
Przy imporcie szablonu z Excela Overvis waliduje strukturę pliku i każdą wartość pola. Typowe przyczyny błędów walidacji:
Brak wymaganych arkuszy — plik musi zawierać arkusze Info i Params. Arkusz o nieznanej nazwie powoduje błąd.
Brak wymaganych pól Info — rozmiar grupy odczytu i funkcja zapisu muszą być podane na arkuszu Info.
Nieprawidłowy typ wartości lub rodzaj rejestru — sprawdź, czy kolumny Type i Register Kind używają dokładnych wartości z Referencji szablonów urządzeń.
Coil/discrete-input z niewłaściwym typem wartości — rejestry coil i discrete-input muszą używać typu wartości bit. Inne typy są niedozwolone.
Mnożnik/przesunięcie przy niekompatybilnych typach — typy bit, łańcuch, adres IP i MAC nie obsługują mnożnika ani przesunięcia. Ustaw je na 1 i 0 (lub pozostaw puste).
Pola bitów przy typach innych niż bit — pozycja bitu i liczba bitów powinny być ustawione tylko dla typów wartości bit i bits.
Enum bez mapowań — parametry z typem wartości enum muszą zawierać co najmniej jedno mapowanie w kolumnie Represent As.
Niezgodność tłumaczeń enum — jeśli mapowania enum są tłumaczone, każdy język musi mieć tę samą liczbę mapowań z tymi samymi wartościami liczbowymi.
Komunikat błędu zawiera nazwę arkusza, numer wiersza i odwołanie do komórki, aby ułatwić lokalizację problemu.
Parametry nie aktualizują się po zastosowaniu szablonu
Jeśli zastosowanie szablonu nie aktualizuje istniejących parametrów zgodnie z oczekiwaniami:
Dopasowanie jest po adresie i rodzaju rejestru, nie po nazwie parametru. Parametr szablonu aktualizuje istniejący parametr urządzenia tylko wtedy, gdy oba mają ten sam adres rejestru, rodzaj rejestru, pozycję bitu i liczbę bitów. Jeśli się różnią (np. zmieniono adres w szablonie), stary parametr pozostaje, a tworzony jest nowy.
Sprawdź duplikaty adresów — jeśli urządzenie ma dwa parametry przy tym samym adresie i rodzaju rejestru, zachowanie dopasowania może być nieoczekiwane. Usuń duplikaty przed zastosowaniem.
Sprawdź, czy parametry wskazane w warunkach istnieją — każdy warunek alertu wskazuje parametr po adresie i rodzaju rejestru. Jeśli takiego parametru nie ma w szablonie, alertu nie można utworzyć.
Sprawdź opcje stosowania — upewnij się, że w formularzu zaznaczono Dodaj alerty z szablonu (oraz że YAML alertów i odwołania do parametrów są poprawne).
Urządzenie nie jest odpytywane po zastosowaniu szablonu
Sprawdź błędy — jeśli strona importu nie pokazuje błędów, a szablon się nie pojawia, odśwież stronę.
Sprawdź właściwą organizację — szablony są powiązane z bieżącą organizacją. Upewnij się, że przeglądasz szablony właściwej organizacji.
Zastąpienie o tej samej nazwie — jeśli szablon o tej samej nazwie, producencie i wersji już istniał, został zastąpiony. Szablon jest na miejscu, ale stara treść została nadpisana.
Tak. Możesz stosować szablony kolejno. Każde zastosowanie łączy lub zastępuje parametry według logiki dopasowania (adres, rodzaj rejestru, pozycja bitu, liczba bitów). Aby połączyć parametry z dwóch szablonów, zastosuj pierwszy, potem drugi bez włączania Usuń parametry urządzenia, których brakuje w szablonie.
Co dzieje się z istniejącymi parametrami przy zastosowaniu szablonu?
Domyślnie istniejące parametry są zachowywane. Parametry pasujące do parametru szablonu (po adresie, rodzaju rejestru, pozycji bitu i liczbie bitów) są aktualizowane ustawieniami szablonu. Parametry szablonu bez dopasowania są dodawane jako nowe. Włącz Usuń parametry urządzenia, których brakuje w szablonie, aby usunąć niedopasowane parametry urządzenia.
Nie ma funkcji masowego ponownego zastosowania. Aby zaktualizować wszystkie urządzenia używające szablonu, zaimportuj zaktualizowany szablon, potem zastosuj go do każdego urządzenia osobno. Użyj Usuń parametry urządzenia, których brakuje w szablonie, jeśli każde urządzenie ma dokładnie odpowiadać szablonowi.
Czy mogę udostępniać szablony między organizacjami?
Bezpośrednio nie. Szablon należy do jednej organizacji lub do biblioteki globalnej. Aby udostępnić szablon, wyeksportuj go jako plik .xlsx i zaimportuj w drugiej organizacji. Biblioteka globalna jest wspólna dla wszystkich organizacji, ale może być modyfikowana tylko przez superużytkowników.
Jaka jest różnica między szablonami globalnymi a organizacyjnymi?
Szablony globalne są utrzymywane przez Overvis, dostępne dla wszystkich i tylko do odczytu. Szablony organizacyjne należą do Twojej organizacji, są prywatne dla jej członków i można je swobodnie edytować. Sklonuj szablon globalny do organizacji, jeśli musisz go zmodyfikować.
Czy mogę edytować pojedyncze parametry w szablonie bez ponownego importu?
Nie. Interfejs webowy pozwala edytować tylko metadane szablonu (nazwę, producenta, wersję, kategorię, opis) oraz pole Szablon alertów w formacie YAML:. Aby zmienić definicje parametrów, wyeksportuj szablon do Excela, edytuj arkusz i zaimportuj ponownie.
Co się stanie, jeśli usunę szablon, z którego utworzono urządzenia?
To nie powoduje awarii. Urządzenia zachowują parametry i działają normalnie. Odwołanie urządzenia do szablonu jest czyszczone, ale żadne parametry ani ustawienia nie są usuwane.
Referencja szablonów urządzeń — pełna specyfikacja techniczna formatu pliku Excel, wszystkie obsługiwane typy wartości, składnia YAML alertów i reguły walidacji.
Overvis stale odczytuje wartości parametrów z Twoich urządzeń. Alerty pozwalają określać warunki dla tych odczytów — i otrzymywać powiadomienia e-mailem, SMS-em lub połączeniem głosowym, gdy coś jest nie tak. Alerty prowadzą też dziennik każdego spełnienia warunku i jego zniesienia, co daje ślad audytowy incydentów.
Warunki — reguły porównujące bieżące odczyty parametrów z wartościami progowymi. Na przykład: „temperatura powyżej 8°C” lub „błąd odczytu parametru”.
Działania — komunikaty wysyłane, gdy warunki stają się prawdziwe. Wybierasz kanał (e-mail, SMS, połączenie głosowe), odbiorcę oraz w razie potrzeby opóźnienie.
Konsekwencje — dodatkowe powiadomienia na późniejszych etapach incydentu: gdy ktoś potwierdzi alert, gdy rozwiąże się sam lub gdy nikt nie odpowie w określonym czasie.
Overvis sprawdza warunki automatycznie po każdym cyklu odczytu parametrów. Gdy warunki są spełnione, alert aktywuje się i zaczyna wykonywać działania. Gdy warunki przestają być spełnione, alert rozwiązuje się automatycznie.
Nadaj alertowi znaczącą nazwę (np. „Zbyt wysoka temperatura komory chłodniczej”). Nazwa pojawia się w komunikatach i w dzienniku alertów, więc powinna być od razu zrozumiała dla osoby otrzymującej wiadomość. Długość nazwy — do 200 znaków.
Opis jest opcjonalny i może zawierać dodatkowy kontekst.
Każdy warunek śledzi jeden parametr urządzenia i porównuje jego wartość z progiem.
Aby dodać warunek, wybierz sieć, potem urządzenie w tej sieci, potem parametr na tym urządzeniu. Dostępne są wyłącznie śledzone parametry — nieśledzone parametry nie są odpytywane, więc nie ma z czym porównywać.
Następnie wybierz operator porównania i wprowadź wartość progową:
Operator
Znaczenie
Więcej niż
Wartość > próg
Większe lub równe
Wartość ≥ próg
Mniej niż
Wartość < próg
Mniejsze lub równe
Wartość ≤ próg
Równa się
Wartość = próg
Nie równa się
Wartość ≠ próg
Błąd odczytu
Nie udało się odczytać parametru (próg nie jest potrzebny)
Próg jest porównywany z wyświetlaną wartością parametru — wartością po zastosowaniu mnożnika z ustawień parametru. Wprowadzaj próg w tych samych jednostkach inżynierskich co na stronie urządzenia (np. °C, kW), a nie w surowych wartościach rejestrów.
„Błąd odczytu” — to warunek specjalny: zadziała, gdy nie da się w ogóle odczytać parametru — np. gdy urządzenie jest niedostępne w sieci lub adres Modbus jest nieprawidłowy. Wartość progowa nie jest potrzebna. Aby uniknąć fałszywych alarmów podczas uruchamiania systemu, warunki błędu odczytu są wyciszane przez około 2 minuty po starcie systemu.
Logika warunków. Jeśli w alercie jest kilka warunków, wybierasz, jak są łączone:
Wszystkie warunki muszą być spełnione (AND) — alert aktywuje się tylko wtedy, gdy wszystkie warunki są jednocześnie prawdziwe.
Gdy którykolwiek z warunków jest spełniony (OR) — alert aktywuje się, gdy przynajmniej jeden warunek jest prawdziwy.
Działania określają, co dzieje się, gdy alert się aktywuje. Każde działanie definiuje:
Kanał: e-mail, SMS lub połączenie głosowe.
Odbiorca: adres e-mail lub numer telefonu. Pozostaw puste, aby użyć domyślnego adresu lub telefonu organizacji dla alertów (w ustawieniach organizacji). Jeśli odbiorca jest pusty i wartość domyślna nie jest ustawiona, komunikat jest pomijany.
Opóźnienie: jak długo czekać przed wysłaniem komunikatu. Opcje od „Natychmiast” do „Jeśli nie rozwiązano w ciągu 2 godzin”.
Opóźnienie pomaga uniknąć fałszywych alarmów przez krótkie wahania. Jeśli alert rozwiąże się przed upływem opóźnienia, komunikat nie jest wysyłany.
Konsekwencje pozwalają eskalować lub powiadamiać na późniejszych etapach incydentu:
Etap
Znaczenie
Po rozwiązaniu
Warunki nie są już spełnione i alert sam przestaje być aktywny. Użyj, aby poinformować, że sytuacja wróciła do normy.
Po potwierdzeniu
Ktoś potwierdził alert (zob. Potwierdzanie alertów poniżej). Użyj, aby poinformować zespół, że ktoś zajmuje się problemem.
Potwierdzenie w ciągu …
Nikt nie potwierdził alertu w podanym czasie. Użyj do eskalacji — np. zadzwoń do przełożonego, jeśli początkowy SMS nie został potwierdzony w ciągu 30 minut.
Dla etapu „Potwierdzenie w ciągu …” wybierasz limit czasu (od 5 minut do 48 godzin). Jeśli alert zostanie potwierdzony lub rozwiąże się przed upływem limitu czasu, zaplanowane powiadomienie z konsekwencji jest anulowane.
Każda konsekwencja określa kanał (e-mail / SMS / połączenie głosowe) i odbiorcę, tak jak działania.
flowchart LR
A["Nieaktywne<br/>(monitorowanie)"] -->|"Warunki<br/>spełnione"| B["Aktywne<br/>(wysłano powiadomienia)"]
B -->|"Użytkownik<br/>potwierdza"| C["Potwierdzone"]
B -->|"Warunki<br/>ustępują"| D["Rozwiązane"]
C -->|"Warunki<br/>ustępują"| D
D -.->|"Gotowe na<br/>kolejny incydent"| A
Nieaktywne — warunki nie są spełnione. Alert monitoruje sytuację, ale jeszcze nie zadziałał.
Aktywne — co najmniej jeden warunek jest spełniony (w zależności od logiki AND/OR). Overvis tworzy wpis alertu w dzienniku i zaczyna wykonywać działania „Działanie…”. Generowany jest kod potwierdzenia. Jeśli skonfigurowano konsekwencje „Potwierdzenie w ciągu …”, ich liczniki eskalacji zaczynają odliczanie.
Potwierdzone — ktoś potwierdził alert przez link w wiadomości e-mail lub odpowiedź SMS (zob. poniżej). Wykonywane są konsekwencje „Po potwierdzeniu”, a wszystkie zaplanowane liczniki eskalacji są anulowane.
Rozwiązane — warunki nie są już prawdziwe. Overvis zamyka wpis alertu i wykonuje konsekwencje „Po rozwiązaniu” (jeśli wysłano „początkowy” komunikat). Wszystkie pozostałe zaplanowane działania są anulowane. Alert wraca do stanu Nieaktywne i jest gotowy do ponownej aktywacji przy następnym incydencie.
Dopóki alert pozostaje aktywny i nie został potwierdzony, konsekwencje eskalacji („Potwierdzenie w ciągu …”) uruchamiają się w skonfigurowanych terminach. To nie jest osobny stan — alert pozostaje aktywny, eskalacja może się powtarzać z różnymi limitami czasu (np. SMS po 15 minutach, połączenie głosowe po 1 godzinie).
Za każdym razem, gdy alert się aktywuje, a następnie rozwiązuje się, w dzienniku tworzony jest osobny wpis alertu. Jednocześnie może być tylko jeden aktywny (nierozwiązany) wpis.
Gdy alert zadziała, komunikaty zawierają sposób potwierdzenia alertu:
Wiadomości e-mail zawierają link potwierdzający. Kliknięcie otwiera stronę potwierdzającą alert i pokazującą szczegóły zdarzenia.
Wiadomości SMS zawierają 5-cyfrowy kod potwierdzenia. Odpowiedz tym kodem na ten sam numer, aby potwierdzić.
Potwierdzenie pełni dwie funkcje:
Uruchamia konsekwencje „Po potwierdzeniu” (np. powiadomienie zespołu, że ktoś zajmuje się problemem).
Anuluje wszystkie zaplanowane działania eskalacji „Potwierdzenie w ciągu …”.
Po potwierdzeniu alert pozostaje aktywny, dopóki warunki nie ustąpią i alert nie rozwiąże się automatycznie. Potwierdzenie nie wycisza alertu ani nie powoduje jego rozwiązania — tylko sygnalizuje, że o problemie już wiadomo.
Strona Alerty wymienia wszystkie alerty bieżącej organizacji. Dla każdego alertu widać:
nazwę alertu oraz opis;
ikonę dzwonka w kolorze zgodnym z poziomem dziennika. Jeśli alert jest teraz aktywny, ikona jest podświetlona;
tabelę warunków z siecią, urządzeniem, parametrem, warunkiem, ostatnią odczytaną wartością i datą odczytu dla każdego warunku. Spełnione warunki są wyróżnione wizualnie;
Działania: lista skonfigurowanych komunikatów.
Z tej strony dostępne są Ustawienia, Dziennik, Duplikuj lub Usuń dla każdego alertu.
Dziennik alertów rejestruje każdą aktywację i rozwiązanie alertu. Są dwa widoki:
Dziennik organizacji (Alerty → Dziennik alertów na pasku bocznym) — wszystkie wpisy alertów wszystkich alertów, najpierw nowsze.
Dziennik jednego alertu (otwórz alert → Dziennik) — tylko wpisy dla jednego alertu.
Każdy wpis dziennika pokazuje:
Kolumna
Treść
Data
Kiedy alert został aktywowany.
Nazwa wydarzenia
Nazwa alertu z prefiksem poziomu dziennika (np. „Ostrzeżenie: Zbyt wysoka temperatura komory chłodniczej”).
Status
Aktywne, Potwierdzony (data) lub Zakończony (data).
Można rozwinąć każdy wpis, aby zobaczyć szczegóły ze znacznikami czasu — chronologiczną listę zdarzeń incydentu (spełnione warunki, wysłane komunikaty, potwierdzenie, rozwiązanie).
Menedżerowie techniczni mogą wyczyścić dziennik dla alertu — usuwając zakończone (rozwiązane) wpisy starsze niż wybrany okres: 1 dzień, 1 tydzień, 1 miesiąc, 1 rok lub wszystkie zakończone wpisy.
Jeśli zarządzasz wieloma podobnymi urządzeniami, możesz umieszczać definicje alertów w szablonie urządzenia. Po zastosowaniu szablonu do urządzenia Overvis tworzy alerty automatycznie — bez ponownego ustawiania tych samych progów i działań dla każdego urządzenia.
Szablony alertów zapisuje się w YAML i dodaje do szablonu urządzenia przez interfejs webowy lub w pliku Excel szablonu. Zob. Dokumentacja szablonów alertów co do składni YAML i przykładów.
Dziennik SMS (pozycja paska bocznego w sekcji „Alerty”) pokazuje wpisy wszystkich SMS-ów i połączeń głosowych wysłanych przez system alertów. Każdy wpis zawiera:
datę i godzinę wysłania komunikatu;
powiązaną nazwę alertu;
treść komunikatu;
numery telefonów nadawcy i odbiorcy;
czy to SMS, czy połączenie głosowe;
koszt dostarczenia.
Przydatne do sprawdzania, czy komunikaty zostały dostarczone, oraz do śledzenia użycia i kosztów SMS-ów i połączeń głosowych.
Parametr nie jest śledzony. Tylko śledzone parametry są odpytywane w odczytach. Jeśli parametr nie jest śledzony, Overvis nie ma wartości do porównania. Przejdź na stronę urządzenia i upewnij się, że dla parametru włączono pole „Śledzone”. Zob. Flagi zachowania.
Urządzenie lub sieć wyłączone. Wyłączone urządzenia i sieci nie przetwarzają alertów. Upewnij się, że zarówno sieć, jak i urządzenie są włączone.
Parametr nie ma niedawnych odczytów. Jeśli parametr nigdy nie był odczytywany (np. urządzenie jeszcze nie było odpytywane), warunków nie da się ocenić. Sprawdź kolumnę „Ostatni odczyt” na stronie przeglądu alertów — jeśli jest „-”, parametr jeszcze nie był odczytywany.
Próg w niewłaściwych jednostkach. Próg jest porównywany z wartością wyświetlaną (po mnożniku). Jeśli wprowadzisz surową wartość rejestru zamiast inżynierskiej, warunek może nigdy nie zadziałać. Upewnij się, że próg jest w tych samych jednostkach co na stronie urządzenia.
Niezgodność logiki warunków. Jeśli kilka warunków ma „Wszystkie warunki muszą być spełnione” (AND), wszystkie muszą być prawdziwe jednocześnie. Sprawdź, czy jeden warunek nie blokuje aktywacji alertu.
Nie ustawiono domyślnego odbiorcy. Jeśli pole odbiorcy jest puste, Overvis używa domyślnego adresu e-mail lub telefonu organizacji dla alertów. Jeśli nic nie jest skonfigurowane, komunikat jest cicho pomijany. Ustaw domyślnych odbiorców w ustawieniach organizacji lub podaj odbiorcę jawnie w działaniu alertu.
Wiadomość trafia do spamu. Sprawdź folder „Spam” lub folder niechcianej poczty. Dodaj adres nadawcy alertów Overvis do białej listy.
SMS wyłączony dla organizacji. Jeśli wysyłanie SMS jest wyłączone (np. z powodu rozliczeń), SMS-y i komunikaty głosowe nie są dostarczane. Sprawdź, czy u góry strony „Alerty” nie pojawia się komunikat o wyłączonych SMS.
Opóźnienie jeszcze nie minęło. Jeśli skonfigurowano opóźnienie (np. „Jeśli nie rozwiązano w ciągu 30 min”), komunikat nie zostanie wysłany, dopóki nie upłynie okres opóźnienia. Jeśli alert rozwiąże się wcześniej, komunikat jest anulowany.
Używaj opóźnień działań. Ustaw opóźnienie w stylu „Jeśli nie rozwiązano w ciągu 5 min” lub dłuższe. Krótkie wahania, które szybko znikają, nie wywołują komunikatu.
Dostosuj progi. Jeśli próg jest zbyt blisko normalnego zakresu pracy, małe wahania wywołają alert. Dodaj margines na normalne wahania.
Używaj logiki AND dla wielu warunków. Wymóg spełnienia wszystkich warunków jednocześnie zmniejsza fałszywe alarmy od pojedynczych skoków.
Konsekwencje „Po rozwiązaniu” są wysyłane tylko wtedy, gdy przynajmniej jeden komunikat aktywacji został już wysłany lub zaplanowany. Jeśli alert aktywował się i rozwiązał zbyt szybko, zanim wykonano jakiekolwiek działanie z bloku „Działanie…”, komunikat o zakończeniu nie jest wysyłany. Jest to zamierzone — aby uniknąć osieroconych komunikatów o zakończeniu dla zdarzeń zbyt krótkich, aby o nich powiadomić.
Link potwierdzający w wiadomości e-mail. Upewnij się, że korzystasz z linku z oryginalnej wiadomości. Linki są powiązane z konkretnym zdarzeniem alertu — link z poprzedniego zdarzenia nie zadziała dla nowego.
Kod SMS potwierdzający. Odpowiedz 5-cyfrowym kodem na ten sam numer, z którego wysłano SMS. Kod jest ważny tylko dopóki alert jest aktywny i jeszcze niepotwierdzony.
Alert już rozwiązany. Jeśli alert rozwiązał się przed Twoim potwierdzeniem, strona potwierdzenia wskaże, że zdarzenie zostało już rozwiązane. W takim przypadku potwierdzenie nie jest już potrzebne.
Tak. Każde działanie i każda konsekwencja mają własne pole odbiorcy. Można skonfigurować jeden alert na e-mail do operatora i drugi na SMS do przełożonego. W ramach jednego alertu można dodać kilka działań, aby powiadomić różne osoby różnymi kanałami.
Jeśli urządzenie jest niedostępne, parametry będą miały błędy odczytu. Możesz użyć warunku „Błąd odczytu”, aby otrzymywać alerty, gdy urządzenie przestaje odpowiadać. Po starcie systemu warunki błędu odczytu są wyciszane przez około 2 minuty, aby uniknąć fałszywych alarmów podczas uruchamiania.
W ustawieniach alertu nie ma przycisku „pauza”. Aby tymczasowo wyłączyć wywoływanie alertu, można usunąć warunki lub działania i później je przywrócić, albo ustawić wszystkie działania na „Nic” (bez komunikatu). Alternatywnie, duplikowanie alertu przed edycją zachowuje pierwotną konfigurację do łatwego przywrócenia.
Overvis oblicza warunki alertów zaraz po każdym odczycie parametru. Szybkość zależy od odstępu między odpytywaniami sieci — zwykle od kilku sekund do minuty. Nie ma dodatkowego opóźnienia między odczytem parametru a sprawdzeniem warunków.
Działania („Działanie…”) uruchamiane są przy pierwszej aktywacji alertu. To początkowe komunikaty. Można dodać opóźnienie (np. „Jeśli nie rozwiązano w ciągu 10 min”), aby odfiltrować krótkie zdarzenia.
Konsekwencje („Konsekwencje…”) wykonywane są na późniejszych etapach: gdy alert się rozwiązuje, gdy ktoś go potwierdzi oraz gdy w wyznaczonym czasie nikt go nie potwierdzi. Służą do eskalacji i śledzenia rozwiązania incydentu.
Czy czyszczenie dziennika wpływa na aktywne alerty?
Nie. Czyszczenie dziennika usuwa tylko rozwiązane wpisy alertów starsze niż wybrany okres. Aktywne wpisy alertów i sama konfiguracja alertu nie ulegają zmianie.
Czy można zobaczyć, jakie komunikaty zostały wysłane?
Tak. Rozwiń wpis dziennika alertu, aby zobaczyć szczegółową oś czasu wszystkich komunikatów podczas incydentu, ze znacznikami czasu i odbiorcami. Aby sprawdzić szczegóły dostarczenia SMS i połączeń głosowych, otwórz stronę Dziennik wysłanych SMS.
Raport wartości parametrów to interaktywne narzędzie do przeglądania historycznych danych ze śledzonych parametrów. Łączy wykres szeregów czasowych, tabelę danych i możliwości eksportu na jednej stronie. Możesz nakładać wiele parametrów z różnych urządzeń, powiększać wybrane przedziały czasu i pobierać surowe dane jako CSV lub Excel.
Menu główne — przejdź do Raporty > Wartości parametrów. Raport otwiera się bez wybranych parametrów; użyj drzewa parametrów, aby wybrać, co wyświetlić.
Strona szczegółów urządzenia — kliknij ikonę wykresu przy dowolnym śledzonym parametrze. Raport otwiera się z tym parametrem już wczytanym.
Strona parametru — kliknij link akcji Odczyty na pasku bocznym.
Tryb monitorowania — ten sam raport jest dostępny w interfejsie monitorowania tylko do odczytu. Użytkownicy z dostępem wyłącznie do podglądu są tutaj przekierowywani automatycznie.
Gdy otwierasz raport ze strony urządzenia lub parametru, adres URL zawiera paramIds=..., więc wykres od razu ładuje dane dla tych parametrów.
Drzewo parametrów u góry strony pokazuje hierarchię organizacji: sieci, urządzenia i ich parametry. W drzewie pojawiają się wyłącznie parametry śledzone (z włączonym zapisem historii).
Rozwiń węzły drzewa, aby znaleźć parametry do analizy.
Zaznacz parametry, które mają być uwzględnione. Licznik obok drzewa pokazuje, ile parametrów jest aktualnie wybranych. Obowiązuje konfigurowalny limit liczby parametrów wyświetlanych jednocześnie (komunikat zastępczy pod drzewem).
Kliknij Pokaż raport, aby wczytać dane.
Po zmianie wyboru parametrów zakres czasu wraca do ustawienia wstępnego Ostatnie 24 godziny, jeśli bieżące ustawienie wstępne to Własny…. Jeśli wybrane jest już ustawienie inne niż Własny…, pozostaje ono bez zmian. Wykres i tabela odświeżają się z nowym wyborem.
Dwa pola daty i godziny (YYYY-MM-DD HH:mm) pozwalają ustawić dowolne od i do. Możesz wpisać wartości bezpośrednio lub użyć kalendarza. Naciśnij Enter, aby zatwierdzić wpisaną wartość, lub Escape, aby ją odrzucić.
Gdy przesuwasz lub powiększasz wykres (patrz niżej), ustawienie wstępne przełącza się automatycznie na Własny…, a pola daty i godziny odzwierciedlają nowy zakres.
Dokładność dziesiętna — lista (0–6 miejsc po przecinku) steruje wyświetlaniem wartości na osi wykresu, w podpowiedzi, legendzie i w tabeli. Domyślnie 2 miejsca po przecinku.
Rozwiń wykres / Zwiń wykres — przełącza wykres między normalną a podwójną wysokością.
Wykres przedstawia wartości parametrów w czasie jako kolorowe linie. Każdy wybrany parametr ma własną linię w innym kolorze (do 10 kolorów, potem cykl). Gdy urządzenie było offline lub odpytywanie zostało przerwane, na wykresie widać przerwy w linii tam, gdzie nie zapisano odczytów.
Gdy najedziesz kursorem na wykres, pojawia się podpowiedź ze znacznikiem czasu i wartością każdego widocznego parametru w tym punkcie. Najbliższa linia jest pogrubiona. Gdy widoczne okno czasu jest krótsze niż 10 minut, znaczniki czasu zawierają sekundy.
Przeciąganie w poziomie przesuwa okno czasu w lewo lub w prawo.
Shift + przeciąganie zaznacza prostokątny obszar i powiększa go.
Kółko myszy nad wykresem powiększa lub pomniejsza, wyśrodkowując na pozycji kursora.
Na urządzeniach dotykowych: przeciąganie jednym palcem — przesuwanie, gest szczypania dwoma palcami — powiększanie.
Przyciski szybkiego powiększenia pod wykresem ustawiają stały czas trwania (10m, 15m, 30m, 1h, 8h, 24h) kończący się na prawej krawędzi bieżącego widoku.
Przyciski kroku (< i >) przesuwają okno o jedną jego szerokość w lewo lub w prawo.
Cała nawigacja synchronizuje pola daty i godziny oraz tabelę danych.
Pod głównym wykresem znajduje się mniejszy wykres nawigatora z przeglądem pełnego zakresu danych. Zacienione okno wskazuje aktualnie widoczny fragment.
Możesz:
Przeciągać zacienione okno, aby przesuwać widok.
Przeciągać lewą lub prawą krawędź okna, aby zmieniać jego szerokość.
Nawigator automatycznie poszerza zakres, gdy przesuwasz widok poza jego bieżące granice.
W każdym wierszu legendy są wbudowane sterowania mnożnikiem (×) i przesunięciem (+). Pozwalają one wizualnie przeskalować poszczególne linie, aby na jednym wykresie można było porównać parametry o różnych jednostkach lub rzędach wielkości.
Mnożnik — skaluje wartości parametru. Wpisz liczbę i naciśnij Enter, aby zastosować (np. 0.001, aby zamienić miliwolty na wolty).
Przesunięcie — przesuwa wartości parametru w górę lub w dół.
normalizuj — automatycznie dobiera mnożnik i przesunięcie, aby linia mieściła się w aktualnie widocznym zakresie osi Y.
resetuj — przywraca mnożnik 1 i przesunięcie 0. Widoczne tylko, gdy linia ma niestandardowe przekształcenia.
Przekształcenia mają wyłącznie charakter wizualny — wpływają na wyświetlanie wykresu, nie na tabelę danych ani na wyeksportowane dane.
Domyślnie oś Y ma skalę dopasowaną do wszystkich widocznych linii. Kliknięcie linii na wykresie przypina etykiety osi Y do skali tego parametru (wpis w legendzie jest podświetlony). Kolejne kliknięcie lub kliknięcie innej linii zmienia odniesienie. Kliknięcie w tło wykresu (poza linią) czyści odniesienie i przywraca automatyczne skalowanie.
Pod wykresem tabela wypisuje odczyty z bieżącego okna czasu.
Kolumny to:
Kolumna
Treść
Czas
Znacznik czasu odczytu
Kolumny parametrów
Jedna kolumna na wybrany parametr; w nagłówku nazwa urządzenia, pod spodem nazwa parametru
Odczyty z różnych parametrów w odstępie do 60 sekund są scalane w jeden wiersz. Gdy przesuwasz lub powiększasz wykres, tabela pokazuje tylko wiersze z widocznego okna.
Formularz eksportu pojawia się pod tabelą danych po wybraniu parametrów. Ma własne pola dat Od i do (tylko data, bez godziny — eksport zawsze obejmuje pełne dni), niezależne od zakresu widoku wykresu.
Ustaw daty Od i do okresu eksportu.
Wybierz format: CSV lub Excel (XLSX).
Kliknij Pobierz. Plik pobiera się w nowej karcie przeglądarki.
Wyeksportowany plik zawiera wszystkie surowe odczyty (bez próbkowania) dla wybranych parametrów w wybranym zakresie dat. Domyślnie pola dat ustawione są na ostatnie 7 dni. Znaczniki czasu w pliku używają strefy czasowej przeglądarki.
Przy wyświetlonym zapisanym raporcie formularz zapisu jest zastępowany formularzem aktualizacji (nagłówek strony może brzmieć Zaktualizuj zapisany raport). Możesz zmienić nazwę, dobór parametrów, przekształcenia linii i kliknąć Odśwież raport, aby zapisać zmiany.
Otwórz Raporty > Wartości parametrów, a następnie w sekcji odczytów użyj Zapisane raporty, aby przejść do listy zapisanych raportów (to nie jest osobna pozycja menu na tym samym poziomie co pierwsze dwa elementy). Lista pokazuje nazwę każdego raportu i datę utworzenia.
Stąd możesz:
Otworzyć raport do podglądu lub edycji.
Skonfigurować automatyczną wysyłkę (ikona koła zębatego).
Dla każdego zapisanego raportu można skonfigurować automatyczną wysyłkę odczytów na adresy e-mail odbiorców:
Otwórz ustawienia wysyłki zapisanego raportu (ikona koła zębatego na liście zapisanych raportów).
Wpisz adres e-mail.
Wybierz okres: Codziennie, Co tydzień lub Co miesiąc.
Wybierz format: Excel (XLSX) lub CSV.
Kliknij Dodaj odbiorcę.
Możesz dodać wielu odbiorców z różnymi okresami i formatami. Kombinacja e-mail — okres — format musi być unikalna w obrębie raportu.
Tabela listy wysyłki pokazuje dla każdego odbiorcy:
Kolumna
Treść
Email
Adres e-mail odbiorcy
Ostatnia wysyłka
Data ostatniego wysłania raportu do tego odbiorcy
Błąd wysyłania
Komunikat błędu, jeśli ostatnia próba wysłania się nie powiodła
Następne wysyłanie
Zaplanowana data następnej dostawy raportu
Okres
Codziennie, Co tydzień lub Co miesiąc
Format
XLSX lub CSV
Automatyczna wysyłka przesyła dane za poprzedni okres: wysyłki dzienne obejmują poprzedni dzień, tygodniowe — poprzednie 7 dni, miesięczne — poprzedni miesiąc. Znaczniki czasu w raportach z wysyłki są w UTC.
Adres URL raportu zachowuje pełny stan widoku we fragmencie hash adresu, w tym zakres czasu, dokładność dziesiętną oraz widoczność i przekształcenia poszczególnych linii. Możesz skopiować URL z paska adresu przeglądarki i udostępnić go — każda osoba z dostępem do organizacji zobaczy ten sam widok.
Przerwy oznaczają okresy bez zapisanych odczytów. Zwykle dzieje się tak, gdy:
Urządzenie było offline lub bramka straciła połączenie z internetem.
Odpytywanie było chwilowo przerwane (np. podczas rekonfiguracji sieci).
Parametr dodano do śledzenia po tym, jak dla innych parametrów zebrano już część danych.
Nie da się „naprawić” przeszłych przerw — odzwierciedlają one rzeczywistą dostępność danych. Aby ograniczyć przyszłe przerwy, zapewnij bramce stabilne połączenie z internetem i zasilanie urządzenia.
Plik eksportu jest pusty lub ma mniej wierszy niż oczekiwano
Użyj krótszego ustawienia wstępnego zakresu czasu.
Przy bardzo długim zakresie (np. Ostatnie 365 dni) pamiętaj, że wykres próbkuje do 1000 punktów na parametr dla wydajności. Pełne dane są dostępne przez eksport.
Obowiązuje limit konfigurowany dla wdrożenia. Dokładna liczba jest podana w komunikacie zastępczym pod drzewem parametrów, gdy nic nie wybrano (to samo brzmienie co w aplikacji, np. Wybierz do {} parametrów do wyświetlenia. — z wstawionym limitem, np. 10). Jeśli chcesz porównać więcej parametrów, utwórz kilka zapisanych raportów z różnymi zestawami parametrów.
Czy wykres pokazuje każdy pojedynczy punkt danych?
Nie. Wykres przedstawia do 1000 próbkowanych punktów na parametr dla widocznego okna. Próbkowanie utrzymuje responsywność także przy długich zakresach. Pełne surowe dane bez próbkowania uzyskasz przez Pobierz w formularzu eksportu — obejmuje on wszystkie odczyty w wybranym zakresie dat.
Tak. Skopiuj adres URL z paska przeglądarki — zawiera bieżący zakres czasu, dokładność dziesiętną i ustawienia przekształceń linii we fragmencie hash adresu. Każda osoba z dostępem do tej samej organizacji może otworzyć link i zobaczyć ten sam widok. Musi być zalogowana w Overvis.
Czym różnią się dane na wykresie od wyeksportowanych?
Wykres i tabela pokazują dane próbkowane — do 1000 punktów na parametr rozłożonych na widoczny przedział czasu. To wystarcza do analizy wizualnej, ale nie jest pełnym zbiorem.
Eksport tworzy plik zawierający wszystkie surowe odczyty — każdą zarejestrowaną wartość wybranych parametrów w zakresie dat eksportu. Używaj eksportu, gdy potrzebujesz pełnych danych do analizy zewnętrznej lub archiwizacji.
Dlaczego niektóre komórki tabeli nie mają wartości dla niektórych parametrów?
Tabela scala odczyty z różnych parametrów w odstępie do 60 sekund w jeden wiersz. Jeśli parametr nie zgłosił wartości blisko tego znacznika czasu, w komórce jest myślnik (-). To normalne przy różnych interwałach odpytywania lub częstotliwości raportowania.
Co się stanie po usunięciu zapisanego raportu z automatyczną wysyłką?
Usunięcie zapisanego raportu usuwa także wszystkie powiązane wpisy wysyłki. Odbiorcy przestaną dostawać automatyczne raporty. Przed usunięciem wyświetlane jest potwierdzenie.
Czy mogę używać raportu w interfejsie monitorowania (tylko podgląd)?
Tak. Raport jest dostępny w interfejsie monitorowania pod tym samym wzorcem adresu URL. Użytkownicy z dostępem tylko do podglądu mogą przeglądać wykresy, tabele i korzystać z eksportu. Zapisywanie raportów i konfiguracja automatycznej wysyłki wymagają jednak uprawnień na poziomie zarządzania.
Overvis Cloud Documentation
Raport zużycia zasobów
Raport zużycia zasobów to narzędzie do analizy zgromadzonych danych z liczników mediów i innych narastających liczników; pokazuje przyrost zużycia zasobów w wybranych okresach, podzielonych na interwały półgodzinne, godzinowe lub dobowe.
Raport pomaga analizować odczyty z parametrów reprezentujących ciągłe zużycie zasobów, takich jak liczniki energii (kWh), wody (m³), gazu oraz dowolne narastające wartości licznikowe. Jeśli wartość parametru w czasie stale rośnie, raport może analizować wzorce tego wzrostu.
Raport dzieli wybrany zakres czasu na segmenty półgodzinne, godzinne lub dobowe. Dla każdego segmentu wyszukuje najwyższy zapisany w nim odczyt i odejmuje od niego najnowszy odczyt zapisany przed rozpoczęciem segmentu. Ta różnica — delta — odpowiada temu, o ile narósł licznik w danym interwale. Jeśli dla parametru skonfigurowano mnożnik lub przesunięcie, są one stosowane do delty (delta × mnożnik + przesunięcie).
Raporty mają strukturę drzewa. Gałęzie główne (na najwyższym poziomie) — każda z nich generuje osobny wykres. Gałęzie mogą zawierać węzły potomne — inne gałęzie, pojedyncze wartości parametrów, wzory lub odnośniki do gałęzi z innych raportów. Wartość gałęzi jest sumą wszystkich dzieci, więc można grupować liczniki według działu, budynku lub rodzaju zasobu i widzieć zarówno sumę, jak i rozbicie.
Wyobraź sobie obiekt z kilkoma działami, z własnymi licznikami w każdym z nich:
Dział 1
Licznik energii 1 (E11) — kWh
Licznik energii 2 (E12) — kWh
Licznik wody 1 (W11) — m³
Dział 2
Licznik energii 3 (E21) — kWh
Licznik wody 2 (W21) — m³
Możesz zbudować raport analizujący te dane:
Total Resources
├── Total Energy
│ ├── Department 1 Energy
│ │ ├── E11
│ │ └── E12
│ └── Department 2 Energy
│ └── E21
└── Total Water
├── Department 1 Water
│ └── W11
└── Department 2 Water
└── W21
Przy takiej strukturze raport pokazuje całkowite zużycie energii i wody dla całej firmy, z podziałem na działy, aż do pojedynczych liczników. Możesz porównywać działy obok siebie i zobaczyć, który dział lub licznik najbardziej przyczynia się do ogólnego zużycia.
Widok raportu pokazuje interaktywne wykresy słupkowe — po jednym na gałąź główną. Każdy słupek odpowiada segmentowi czasu, a jego wysokość pokazuje deltę zużycia w tym okresie. Jeśli skonfigurowano znaczniki poziomów, pojawiają się jako poziome linie odniesienia na wykresie, a słupki są kolorowane po przekroczeniu progu.
Legenda nad wykresami wymienia wszystkie gałęzie główne jako pola wyboru. Odznacz gałąź, aby ukryć jej wykres. Lista rozwijana u góry pozwala przełączać się między raportami w tej samej organizacji.
Pod wykresami dostępne są trzy przyciski eksportu: Eksport do Excela, Pobierz jako PDF oraz Wyślij PDF na e-mail. Do eksportów włączone są tylko gałęzie aktualnie widoczne (zaznaczone w legendzie).
Raport szczegółowy — pole wyboru obok przycisków eksportu (widoczne tylko dla menedżerów). Po zaznaczeniu wyeksportowany plik zawiera pełną hierarchię gałęzi, podgałęzi, pojedyncze odczyty liczników i obliczenia z wzorów. Gdy pole jest odznaczone (lub przy widoku jako monitor), eksport pokazuje tylko gałęzie główne (najwyższego poziomu) — podsumowanie nadające się do raportów dla kierownictwa.
Wyślij PDF na e-mail — kliknij przycisk, wpisz adres e-mail odbiorcy, a raport zostanie wygenerowany i dostarczony od razu. Używany jest ten sam zakres czasu, podział na segmenty i wybór gałęzi co przy zwykłym eksporcie PDF.
Przejdź do Raporty → Zużycie zasobów i kliknij Dodaj, aby otworzyć konstruktor raportu. Definicję raportu stanowi struktura drzewa — budujesz hierarchię gałęzi opisującą, jak mają być grupowane i liczone dane o zużyciu.
Każdy węzeł w drzewie ma typ, który określa źródło jego wartości:
Typ
Zastosowanie
Gałąź
Kontener na węzły potomne. Jej wartość jest sumą wszystkich dzieci. Używaj gałęzi do grupowania — według działu, budynku, rodzaju zasobu itd. Gałęzie można zagnieżdżać do 5 poziomów poniżej korzenia.
Wartość
Odnosi się do jednego parametru urządzenia. W każdym segmencie czasu pokazuje deltę zużycia tego parametru. Parametr wybierasz trójstopniową listą: sieć → urządzenie → parametr.
Oblicz
Oblicza wzór łączący wiele parametrów. Odwołuj się do parametrów po ich identyfikatorze z prefiksem # (np. #561 * 2 + #558). Składnię opisuje sekcja Korzystanie ze wzorów.
Link
Wskazuje istniejącą gałąź z tego lub innego raportu w tej samej organizacji. Selektor gałęzi pokazuje wszystkie gałęzie ze wszystkich raportów, więc możesz ponownie wykorzystywać wspólne struktury bez duplikowania.
Aby zbudować drzewo, zacznij od Dodaj gałąź główną, aby utworzyć gałąź najwyższego poziomu (korzeń). W każdej gałęzi klikaj Dodaj gałąź, aby dodać potomki dowolnego typu. Drzewo rośnie od góry do dołu — gałęzie główne u góry, liście (Wartość, Oblicz, Link) na dole.
Gałęzie główne (najwyższego poziomu) mają dwa dodatkowe ustawienia wpływające na widok online:
Kategoria — opcjonalna etykieta grupująca powiązane gałęzie pod jednym nagłówkiem. Na przykład możesz zebrać wszystkie gałęzie energii pod „Energia”, a wodne pod „Woda”. Gałęzie bez kategorii pojawiają się najpierw, potem grupy kategorii. Kategorie są używane tylko w widoku online i nie występują w eksportach Excel/PDF.
Znaczniki poziomów — do 4 wartości progów, każda z kolorem. Na wykresie pojawiają się jako poziome linie odniesienia oraz jako kolorowe segmenty słupków skumulowanych. Na przykład możesz ustawić żółty znacznik przy 50 kWh i czerwony przy 100 kWh, aby podświetlić przekroczenie oczekiwanego zużycia. Znaczniki poziomów są używane tylko w widoku online i nie występują w eksportach Excel/PDF.
Podczas przeglądania raportu zakres czasu i interwał segmentacji wybierasz elementami sterowania nad wykresami.
Zakres czasu określa, jaki okres analizować. Na liście rozwijanej dostępne są Ostatni dzień, Ostatnie 7 dni i Ostatnie 30 dni; możesz też wybrać Własny… i wskazać daty w selektorach.
Segmentacja określa, jak zakres czasu jest dzielony na interwały: Półgodzinna (interwały 30-minutowe), Według godziny lub Według dni (interwały dobowe). Mniejsze interwały dają więcej szczegółów, ale też więcej punktów danych — przy dużych zakresach dat i wielu parametrach może być potrzebny większy interwał, aby uniknąć limitów eksportu.
Wykresy i eksporty używają strefy czasowej wykrytej z przeglądarki. Wszystkie granice segmentów są wyrównane do lokalnej strefy czasowej.
Typ węzła Oblicz używa wzorów łączących wiele parametrów. Wzory odwołują się do parametrów po identyfikatorze (z prefiksem #) i są obliczane dla każdego segmentu czasu na podstawie delt tego segmentu.
Przykładowy wzór:
(#561 + 10) / 2 + #558
We wzorze do delty parametru #561 dodawane jest 10, wynik dzielony jest przez 2, a następnie dodawana jest delta parametru #558.
Jeśli parametr użyty we wzorze nie ma danych w danym segmencie (np. urządzenie było rozłączone lub parametr został usunięty), jego wartość jest traktowana jako 0.
Użytkownicy z rolą Menedżera mogą tworzyć, edytować i usuwać raporty oraz mają dostęp do pola wyboru Raport szczegółowy przy eksporcie.
Użytkownicy monitoringu mogą mieć przyznany dostęp tylko do odczytu do wybranego raportu zużycia zasobów. Mogą przeglądać wykresy i pobierać eksporty, ale wyłącznie w wersji krótkiej (bez szczegółów) — pole szczegółowego raportu jest ukryte. Użytkownicy monitoringu nie mogą tworzyć ani edytować raportów. Dostęp dla monitoringu konfiguruje się przy zapraszaniu użytkownika do organizacji, gdzie można powiązać rolę monitoringu z konkretnym raportem.
Żądana kombinacja zakresu dat, segmentacji i liczby parametrów przekracza limit eksportu. Komunikat błędu podaje najbliższą dostępną datę dla wybranej segmentacji.
Rozwiązania:
Zmniejsz zakres dat.
Użyj większego interwału segmentacji (np. „Według dni” zamiast „Według godziny”).
Ukryj część gałęzi głównych przed eksportem — do eksportu włączone są tylko widoczne gałęzie (zaznaczone w legendzie).
Wybrane parametry prawdopodobnie nie są narastającymi licznikami. Raport wylicza deltę, czyli różnicę między odczytami w obrębie każdego segmentu. Jeśli wartość parametru nie zmienia się między odczytami (np. to pomiar chwilowy jak temperatura), wszystkie delty będą zerem.
Ujemne delty mogą wystąpić przy resecie licznika lub przy nawrocie licznika (przekroczeniu maksimum zakresu).
Rozwiązania:
Sprawdź surowe odczyty parametru na stronie urządzenia, aby potwierdzić reset licznika.
Jeśli parametr ma skonfigurowany mnożnik lub przesunięcie, zweryfikuj te wartości — delta liczona jest jako (wartość − wartość_poprzednia) × mnożnik + przesunięcie.
Identyfikator parametru we wzorze nie odpowiada żadnemu istniejącemu parametrowi (brakujące identyfikatory są traktowane jak 0).
Składnia wzoru jest niepoprawna (błędy parsowania domyślnie dają 0).
Rozwiązania:
Najedź na każdy parametr na stronie urządzenia, aby potwierdzić jego identyfikator.
Sprawdź, czy wszystkie odwołania #id we wzorze odpowiadają istniejącym parametrom w organizacji.
Zweryfikuj składnię wzoru — podczas wpisywania pod polem edycji pojawiają się nazwy parametrów, a brakujące lub nieprawidłowe identyfikatory są podświetlone.
Wyeksportowany raport jest pusty lub brakuje gałęzi
Wykres online może ograniczyć widoczną datę początkową, jeśli pełny żądany przedział przekroczyłby limit punktów danych na wykresie. Eksport obejmuje natomiast cały żądany zakres dat. Możesz więc zobaczyć na wykresie krótszy przedział czasu niż w pobranym pliku XLSX/PDF.
Dowolny parametr reprezentujący narastający licznik — wartość rośnie w czasie. Typowe przykłady: liczniki energii (kWh), wody (m³), gazu, liczniki czasu pracy, liczniki produkcji. Parametry reprezentujące wartości chwilowe (temperatura, ciśnienie, napięcie) nie nadają się do tego raportu; użyj zamiast tego raportu wartości parametrów.
Czy mogę uwzględnić parametry z różnych urządzeń w jednym raporcie?
Tak. Struktura drzewa pozwala łączyć parametry z dowolnych urządzeń w dowolnych sieciach w tej samej organizacji. Przydaje się to do sumowania zużycia z wielu liczników lub lokalizacji.
Dla każdego segmentu czasu system znajduje najwyższy zapisany odczyt w tym segmencie i odejmuje najnowszy odczyt zapisany przed rozpoczęciem segmentu. Jeśli nie ma wcześniejszego odczytu, używane jest zero. Wynik jest następnie mnożony przez mnożnik parametru i korygowany o wartość przesunięcia (jeśli jest skonfigurowana).
Czy mogę ponownie wykorzystać fragmenty jednego raportu w innym?
Tak, użyj typu węzła Link podczas tworzenia raportu. Pozwala odwołać się do dowolnej gałęzi z dowolnego raportu w tej samej organizacji, więc nie trzeba od nowa budować wspólnych struktur.
Nie. Raporty zużycia zasobów można wysłać e-mailem tylko ręcznie, przyciskiem Wyślij PDF na e-mail. Zaplanowaną automatyczną wysyłkę opisuje raport wartości parametrów.
Opcja eksportu szczegółowego jest dostępna tylko użytkownikom z rolą Menedżera. Użytkownicy monitoringu widzą wyłącznie krótką (podsumowującą) wersję eksportów.
Co się stanie, jeśli usunę urządzenie lub parametr użyty w raporcie?
Jeśli parametr przywoływany przez węzeł Wartość zostanie usunięty, ten węzeł nie pokaże danych (puste delty). Jeśli parametr we wzorze Oblicz zostanie usunięty, jego wartość we wzorze jest traktowana jako 0. Sama struktura raportu jest zachowana — możesz ją edytować, aby zastąpić brakujący parametr.
Tak. Eksporty są ograniczone łączną liczbą punktów danych (segmenty × parametry). Dokładne limity zależą od formatu — PDF ma niższy limit niż Excel. Po przekroczeniu limitu zobaczysz komunikat o przekroczeniu limitu liczby segmentów (z sugerowaną datą). Zmniejsz zakres dat lub użyj większego interwału segmentacji.
Raport HACCP w Overvis (analiza zagrożeń i punkty kontroli krytycznych)
HACCP (Hazard Analysis and Critical Control Points) to systematyczne podejście do zarządzania bezpieczeństwem żywności, które identyfikuje, ocenia i kontroluje zagrożenia w całym łańcuchu produkcji i przechowywania żywności. W działalności chłodniczej i w łańcuchu chłodnim HACCP wymaga ciągłego monitorowania temperatury w krytycznych punktach kontroli oraz udokumentowanego potwierdzenia, że limity bezpieczeństwa były utrzymywane.
Narzędzie Raport HACCP w Overvis automatyzuje dokumentowanie zgodności monitorowania temperatury dla punktów kontrolnych chłodni i zamrażarek. Pobiera odczyty temperatury z monitorowanych urządzeń i tworzy uporządkowane raporty, które:
Wyświetlają wartości temperatury w konfigurowalnych interwałach czasowych (od 15 minut do 1 dnia)
Wykrywają przekroczenia progów operacyjnych i krytycznych
Oznaczają brak danych lub nieznany status urządzenia
Umożliwiają dokumentowanie działań korygujących dla wykrytych odchyleń
Umożliwiają formalny przegląd i zatwierdzenie przez upoważnione osoby
Umożliwiają eksport do Excel w celu archiwizacji i audytów
To narzędzie wspiera wymagania dokumentacyjne monitorowania temperatury w powszechnych ramach HACCP, w tym w zasadach Codex Alimentarius i przepisach UE dotyczących higieny żywności (EC 852/2004). Jest przeznaczone wyłącznie do przeglądu HACCP dla chłodni i zamrażarek i nie jest ogólnym systemem HACCP obejmującym wszystkie rodzaje zagrożeń.
Każdy raport dotyczy jednej organizacji. Jeśli zarządzasz wieloma obiektami, generuj osobne raporty dla każdej organizacji.
Wszystkie temperatury są traktowane jako wartości w stopniach Celsjusza. Wszystkie obliczenia daty i czasu używają strefy czasowej skonfigurowanej dla organizacji, łącznie z prawidłową obsługą zmian czasu letniego.
Skonfiguruj raport (zobacz Konstruktor raportu). Przejdź do Raporty > HACCP: na zakładce paska akcji będzie Raport HACCP, a nagłówek strony konstruktora — HACCP. Ustaw nazwę raportu, zakres dat, interwał czasowy oraz tryb prezentacji temperatury. Dodaj jeden lub więcej parametrów temperatury, wybierając dla każdego sieć, urządzenie i parametr. Opcjonalnie skonfiguruj parametr wartości zadanej, odszraniania oraz włącz/wyłącz. Ustaw progi operacyjne i krytyczne według potrzeb.
Zapisz jako szablon (opcjonalnie, zobacz Szablony raportów). Zapisz bieżącą konfigurację jako szablon do przyszłego wykorzystania. Szablony przechowują wszystko poza zakresem dat, dzięki czemu można szybko ponownie generować raporty dla nowych okresów bez ponownego konfigurowania parametrów i progów.
Pokaż raport (zobacz Wygenerowany raport). Kliknij Pokaż raport, aby utworzyć raport z bieżących danych. Podsumowanie odchyleń pojawi się od razu, pokazując wszelkie przekroczenia progów, braki danych i nieznane stany urządzeń w wybranym okresie.
Udokumentuj działania korygujące (zobacz Notatki działań korygujących). Przejrzyj podsumowanie odchyleń i dodaj notatki działań korygujących do odchyleń, które tego wymagają. Notatki są przypisane do konkretnych przedziałów odchyleń i są uwzględniane w końcowym raporcie.
Zatwierdź przegląd (zobacz Przegląd raportu). Upoważniony użytkownik dodaje uwagi do przeglądu i zatwierdza przegląd. Tworzy to trwały, niezmienny zrzut raportu — łącznie ze wszystkimi odczytami, odchyleniami i notatkami działań korygujących w stanie z momentu generowania.
Eksport do Excela (zobacz Eksport do Excel). Eksportuj raport do pliku Excel w dowolnym momencie po wygenerowaniu, zarówno przed, jak i po przeglądzie. Wyeksportowany skoroszyt zawiera te same dane, które są widoczne w przeglądarce.
Aby otworzyć raport HACCP, przejdź do Raporty > HACCP w głównym menu nawigacyjnym (1) (zakładka Raport HACCP, nagłówek strony konstruktora — HACCP).
Funkcja jest zorganizowana w trzy sekcje (2), dostępne przez zakładki na górze strony:
Raport HACCP — krótka etykieta na zakładce; nagłówek strony konstruktora to HACCP. Konstruktor raportu, w którym konfigurujesz parametry, generujesz raporty, dokumentujesz działania korygujące i przesyłasz raport do przeglądu.
Szablony — krótka etykieta na zakładce; nagłówek strony listy to Szablony HACCP. Zapisane konfiguracje raportów można wczytać do konstruktora w celu szybkiego ponownego generowania dla nowych zakresów dat.
Sprawdzone raporty — krótka etykieta na zakładce; nagłówek strony listy to Sprawdzone raporty HACCP. Lista zawiera wszystkie przesłane zrzuty raportów, dostępne do przeglądania i eksportu.
Zakładki nawigacyjne pozostają widoczne na wszystkich stronach HACCP, w tym na stronie szczegółów szablonu, stronie potwierdzenia usunięcia i stronie szczegółów sprawdzonego raportu.
Konstruktor raportu jest głównym obszarem roboczym strony z nagłówkiem HACCP (na zakładce paska akcji — Raport HACCP). Umożliwia skonfigurowanie parametrów temperatury do monitorowania, ustawienie okresu raportowania i interwału czasowego, zdefiniowanie dopuszczalnych progów temperatury oraz wygenerowanie raportu.
Konstruktor jest zawsze widoczny w górnej części tej strony. Po wygenerowaniu raportu wyniki pojawiają się poniżej konstruktora. Możesz swobodnie zmieniać ustawienia konstruktora bez utraty wygenerowanego raportu ani roboczych notatek działań korygujących — zmiany zaczynają obowiązywać dopiero po kliknięciu Pokaż raport. Ponowne wygenerowanie raportu zastępuje poprzednie wyniki i usuwa wszystkie robocze notatki działań korygujących.
Nazwa raportu — dowolna nazwa raportu. Ta nazwa pojawia się w nagłówku raportu, na listach szablonów i sprawdzonych raportów oraz w wyeksportowanym pliku Excel. Wymagana.
Data od: / Data do: — zakres dat raportu, włącznie. Domyślnie ustawione jest ostatnie 7 dni. Możesz wybrać dowolny zakres dat; system wymusza limit całkowitego rozmiaru danych zależny od liczby parametrów i rozmiaru interwału. Wszystkie daty i godziny w raporcie używają strefy czasowej zapisanej dla organizacji. Jeśli potrzebujesz innej strefy, poproś administratora Overvis lub wsparcie — interfejs może nie udostępniać osobnego pola Strefa czasowa w Ustawieniach organizacji we wszystkich instalacjach.
Rozmiar interwału — kadencja czasowa, według której odczyty są grupowane w segmenty. Dostępne opcje:
1 dzień — jeden segment na dzień kalendarzowy
1 godzina — segmenty wyrównane do każdej godziny dnia
30 minut — segmenty wyrównane do każdej połowy godziny
15 minut — segmenty wyrównane do każdego kwadransa
Krótsze interwały dają bardziej szczegółowe raporty, ale zwiększają rozmiar raportu. Kombinacja zakresu dat, rozmiaru interwału i liczby skonfigurowanych parametrów określa całkowity rozmiar danych.
Wartość temperatury — określa, jak obliczana jest wartość temperatury dla każdego segmentu, gdy w jego obrębie istnieje wiele odczytów:
Początek interwału — odczyt najbliższy początku segmentu
Średnia — średnia arytmetyczna wszystkich odczytów w segmencie
Minimum — najniższy odczyt w segmencie
Maksimum — najwyższy odczyt w segmencie
Ten wybór wpływa zarówno na wyświetlane wartości, jak i na wykrywanie odchyleń progowych. Na przykład, jeśli wybrano Średnia, krótkotrwały skok powyżej limitu krytycznego może nie wywołać odchylenia, jeśli średnia pozostanie w zakresie.
Lista parametrów temperatury definiuje, które punkty kontrolne są uwzględnione w raporcie. Każdy wpis reprezentuje jeden monitorowany parametr temperatury wraz z opcjonalnymi parametrami pomocniczymi i progami.
Przed wygenerowaniem raportu musisz skonfigurować co najmniej jeden parametr temperatury. W pojedynczym raporcie można uwzględnić do 100 parametrów.
Aby dodać parametr, kliknij Dodaj parametr temperatury pod listą. Aby edytować istniejący parametr, kliknij jego nazwę na liście. Aby go usunąć, kliknij ikonę kosza w jego wierszu. Aby zmienić kolejność parametrów, przeciągnij za uchwyt po lewej stronie każdego wiersza — lista pokazuje nową pozycję podczas przeciągania.
Okno konfiguracji parametru otwiera się podczas dodawania lub edytowania parametru temperatury. Zawiera następujące sekcje:
Parametr temperatury (wymagany) — podstawowy odczyt temperatury dla tego punktu kontrolnego. Wybierz sieć, następnie urządzenie, a potem konkretny parametr. Do wyboru dostępne są tylko śledzone parametry, czyli parametry urządzeń, które Overvis cyklicznie odczytuje w tle i zapisuje w bazie danych. Jeśli potrzebny parametr nie znajduje się na liście, upewnij się, że jest skonfigurowany jako śledzony w ustawieniach urządzenia.
Parametr nastawy (opcjonalny) — referencyjna wartość zadana używana do kolorowania odchylenia w tabeli raportu. Po skonfigurowaniu każda komórka jest kolorowana gradientem od niebieskiego przez biały do pomarańczowego w zależności od tego, jak bardzo temperatura odbiega od wartości zadanej. Skala odchylenia wykorzystuje kroki co 1°C na poziom koloru. Wartość zadana nie wpływa na wykrywanie odchyleń — służy wyłącznie do wizualizacji.
Aby dodać wartość zadaną, kliknij Parametr nastawy, aby rozwinąć sekcję, a następnie wybierz sieć, urządzenie i parametr. Aby ją usunąć, kliknij ikonę kosza obok nazwy sekcji.
Parametr odszraniania (opcjonalny) — wskazuje, czy urządzenie znajduje się w cyklu odszraniania. Gdy odszranianie jest aktywne, odpowiednie komórki są wyróżnione żółtym tłem w tabeli raportu. Status odszraniania jest pokazywany wyłącznie jako kontekst informacyjny — nie tworzy odchyleń i nie tłumi naruszeń progów.
Parametr włącz/wyłącz (opcjonalny) — wskazuje, czy urządzenie pracuje. Gdy urządzenie jest wyłączone, odpowiednie komórki są pokazywane na szarym tle. Stan wyłączenia ma charakter informacyjny i sam w sobie nie tworzy odchyleń. Jednak naruszenia progów są nadal wykrywane nawet wtedy, gdy urządzenie jest wyłączone. Jeśli urządzenie jest włączone (lub jego stan jest nieznany), a odczyt temperatury jest brakujący, jest to oznaczane jako odchylenie typu „nieznany status/dane”.
Dla parametrów odszraniania i włącz/wyłącz dostępne są dodatkowo dwa ustawienia:
Tryb oceny — określa, w jaki sposób stan logiczny jest wyprowadzany z odczytów w obrębie segmentu:
Uznaj za true, jeśli w przedziale było choć jedno true — stan jest uznawany za aktywny, jeśli jakikolwiek odczyt w segmencie odpowiada wartości true
Uznaj za false, jeśli w przedziale było choć jedno false — stan jest uznawany za aktywny, jeśli jakikolwiek odczyt w segmencie nie odpowiada wartości true
Według wartości na początku przedziału — używany jest tylko odczyt najbliższy początku segmentu (to ta sama logika „najbliżej początku”, która jest używana przez Wartość temperatury > Początek interwału, zastosowana tutaj do parametru logicznego zamiast parametru temperatury)
Wartość true — wartość liczbowa reprezentująca stan aktywny. Domyślnie jest to 1. Wszystkie parametry są porównywane numerycznie niezależnie od sposobu ich prezentacji w innych miejscach Overvis. Dla urządzeń, w których stan aktywny jest reprezentowany przez 0 (odwrotne okablowanie), ustaw wartość true na 0.
Każdy parametr temperatury może mieć skonfigurowane do czterech wartości progowych. Progi definiują dopuszczalne zakresy temperatury dla punktu kontrolnego i sterują wykrywaniem odchyleń w wygenerowanym raporcie.
Progi operacyjne definiują normalny zakres pracy:
Dolny — najniższa dopuszczalna temperatura podczas normalnej pracy. Temperatury poniżej tej wartości powodują odchylenie operacyjne.
Górny — najwyższa dopuszczalna temperatura podczas normalnej pracy. Temperatury powyżej tej wartości powodują odchylenie operacyjne.
Odchylenia operacyjne oznaczają, że temperatura wyszła poza pożądany zakres pracy, ale nie osiągnęła jeszcze poziomu krytycznego dla bezpieczeństwa. Zwykle wymagają zbadania przyczyny i działań korygujących, aby zapobiec dalszemu odchyleniu.
Dolny — minimalna bezpieczna temperatura. Temperatury poniżej tej wartości powodują krytyczne przekroczenie limitu.
Górny — maksymalna bezpieczna temperatura. Temperatury powyżej tej wartości powodują krytyczne przekroczenie limitu.
Przekroczenia limitów krytycznych oznaczają bezpośrednie ryzyko dla bezpieczeństwa żywności i wymagają natychmiastowych działań korygujących oraz dokumentacji.
Ustaw progi krytyczne zgodnie z limitami krytycznymi określonymi w Twoim planie HACCP. Progi operacyjne powinny być ustawione ściślej niż limity krytyczne, aby zapewnić wczesne ostrzeganie przed przekroczeniem krytycznym — daje to zespołowi czas na podjęcie działań korygujących, zanim bezpieczeństwo żywności zostanie zagrożone.
Wszystkie wartości progów są opcjonalne. Jeśli próg nie jest skonfigurowany, odpowiedni typ odchylenia nie jest sprawdzany dla tego parametru. W każdej parze (operacyjnej lub krytycznej) dolna wartość nie może być większa od górnej.
Naruszenia progów są wykrywane na podstawie obliczonej wartości segmentu (określonej przez ustawienie Wartość temperatury), a nie na podstawie pojedynczych surowych odczytów w obrębie segmentu. Jeśli próg krytyczny zostanie naruszony, ma on pierwszeństwo przed naruszeniem progu operacyjnego dla tego samego segmentu.
Po kliknięciu Pokaż raport raport pojawia się poniżej konstruktora. Składa się z trzech obszarów: bloku nagłówka (z legendą, licznikami odchyleń i formularzem przeglądu), tabeli podsumowania odchyleń oraz tabeli szczegółowej ładowanej na żądanie.
Nagłówek wyświetla nazwę raportu, wybrany zakres dat i rozmiar interwału. Obok metadanych znajduje się legenda kolorów wyjaśniająca znaczenie wszystkich stylów wizualnych użytych w raporcie:
Gradient odchylenia — 11-stopniowa skala od niebieskiego przez biały do pomarańczowego pokazująca, jak bardzo temperatura odbiega od wartości zadanej. Każdy krok odpowiada 1°C. Niebieski oznacza poniżej nastawy, pomarańczowy powyżej nastawy, biały oznacza wartość bliską nastawie.
Poniżej dolnej granicy / Powyżej górnej granicy (próg operacyjny) — cienka wewnętrzna ramka w kolorze niebieskim (poniżej operacyjnego limitu dolnego) albo czerwonym (powyżej operacyjnego limitu górnego), bez pogrubienia tekstu. Grubość obramowania odróżnia naruszenie operacyjne od krytycznego po tej samej stronie.
Poniżej progu krytycznego / Powyżej progu krytycznego — grubsza wewnętrzna ramka w tym samym kolorze niebieskim albo czerwonym oraz pogrubiony tekst. Naruszenie krytyczne używa mocniejszego obrysu niż operacyjne, dzięki czemu oba typy łatwo rozróżnić bez zmiany koloru.
Odszranianie — żółte tło oznacza, że urządzenie jest w cyklu odszraniania.
Wyłączone — szare tło oznacza, że urządzenie jest wyłączone.
Brak lub nieznana wartość — kursywa (często z wartością - w komórce) oznacza brak temperatury lub nieznany/wnioskowany kontekst; szczegóły są dostępne w podpowiedziach.
Poniżej legendy wyświetlane są liczniki odchyleń:
Łącznie odchyleń — łączna liczba wykrytych przedziałów odchyleń dla wszystkich parametrów.
Odchylenia bez działania korygującego — liczba przedziałów odchyleń, które nie mają jeszcze przypisanej notatki działania korygującego.
Przedziały z nieznanym stanem/danymi — liczba przedziałów, w których brakowało danych lub status urządzenia był nieznany.
Tabela podsumowania odchyleń jest główną powierzchnią przeglądu HACCP. Zawiera każdy wykryty przedział odchylenia dla wszystkich skonfigurowanych parametrów, posortowany według parametru i czasu.
Każdy wiersz pokazuje:
Parametr — nazwę parametru temperatury, z podaną nad nią siecią i urządzeniem dla kontekstu.
Odchylenie — jeden z trzech typów odchyleń (opisanych poniżej); w tabeli interfejsu nagłówek kolumny jest krótki (Odchylenie).
Początek / Koniec — lokalną datę i godzinę rozpoczęcia i zakończenia przedziału odchylenia.
Czas trwania — czas trwania odchylenia.
Min. / Maks. — minimalne i maksymalne obliczone wartości segmentów we wszystkich segmentach danego przedziału odchylenia. Odzwierciedlają one wybrany tryb Wartość temperatury (początek interwału, średnia, minimum lub maksimum), a nie surowe pojedyncze odczyty.
Limit / wartość zadana — wartość progu lub wartości zadanej, która została naruszona.
Działanie korygujące — informację, czy do tego odchylenia dodano notatkę działania korygującego.
Raport wykrywa trzy typy odchyleń. Jeśli do tego samego segmentu czasu odnoszą się jednocześnie różne warunki, obowiązuje odchylenie o najwyższym priorytecie.
Krytyczne przekroczenie limitu (najwyższy priorytet) — obliczona wartość temperatury dla segmentu jest niższa od skonfigurowanego krytycznego progu dolnego lub wyższa od skonfigurowanego krytycznego progu górnego. Oznacza to bezpośrednie zagrożenie dla bezpieczeństwa żywności i wymaga natychmiastowego działania korygującego oraz dokumentacji. W tabeli szczegółowej naruszenia krytyczne są pokazywane pogrubionym tekstem i grubszą kolorową wewnętrzną ramką (niebieską dla wartości zbyt niskich, czerwoną dla zbyt wysokich).
Odchylenie operacyjne (średni priorytet) — obliczona wartość temperatury znajduje się poza zakresem progów operacyjnych, ale nie osiągnęła jeszcze limitu krytycznego. Oznacza to, że system odchyla się od docelowych warunków pracy i może wymagać korekty, aby zapobiec przekroczeniu limitu krytycznego. Odchylenia operacyjne używają tych samych niebieskich/czerwonych kolorów obrysu co odchylenia krytyczne po tej samej stronie, ale z cieńszą ramką i bez pogrubienia tekstu.
Nieznany status/dane (najniższy priorytet) — brakuje danych temperatury lub parametr statusu urządzenia ma nieznany stan. Może się to zdarzyć, gdy:
brakuje odczytu temperatury, a urządzenie jest potwierdzone jako włączone
brakuje odczytu temperatury, a parametr włącz/wyłącz nie jest skonfigurowany
brakuje odczytu temperatury, a sam stan włącz/wyłącz jest nieznany
skonfigurowany parametr odszraniania lub włącz/wyłącz nie ma żadnych odczytów w segmencie
Ten typ odchylenia obejmuje dwie różne sytuacje pod jedną nazwą: brak odczytów temperatury (awaria monitorowania) oraz nierozstrzygnięte stany urządzeń (problem z ustaleniem statusu urządzenia). Obie sytuacje pojawiają się w podsumowaniu jako „nieznany status/dane”, ale szczegółowy powód jest widoczny w podpowiedzi lub opisie komórki. Jeśli urządzenie jest potwierdzone jako wyłączone i brakuje odczytu temperatury, nie jest to oznaczane jako odchylenie typu „nieznany status/dane”.
Jak tworzone są przedziały odchyleń: raport analizuje każdy segment czasu niezależnie, klasyfikuje go zgodnie z powyższymi regułami, a następnie łączy kolejne segmenty tego samego typu odchylenia w ciągłe przedziały. Gdy typ odchylenia zmienia się między sąsiednimi segmentami, rozpoczyna się nowy przedział. Na przykład dwie godziny odchylenia operacyjnego z 20-minutowym naruszeniem krytycznym w środku dają w efekcie trzy osobne przedziały: odchylenie operacyjne, krytyczne przekroczenie limitu oraz ponownie odchylenie operacyjne.
Ważne: stany odszraniania i wyłączenia mają wyłącznie charakter informacyjny — same nie tworzą odchyleń i nie tłumią naruszeń progów. Jeśli próg krytyczny lub operacyjny zostanie naruszony podczas cyklu odszraniania lub gdy urządzenie jest wyłączone, odchylenie nadal zostanie wykryte i pokazane. W tabeli szczegółowej wskaźniki naruszeń progów (ramki i pogrubienie) są nakładane na tło odszraniania lub wyłączenia, dzięki czemu oba stany pozostają jednocześnie widoczne (zobacz stylizację komórek).
Do dowolnego przedziału odchylenia w podsumowaniu możesz dołączyć notatkę działania korygującego. Notatki służą do udokumentowania działań podjętych w odpowiedzi na wykryte odchylenie.
Aby dodać notatkę, kliknij komórkę działania korygującego w odpowiednim wierszu odchylenia. Każda notatka zapisuje wprowadzony tekst, nazwę wyświetlaną użytkownika oraz czas jej utworzenia. Podczas pracy z wygenerowanym raportem notatki można swobodnie edytować i usuwać.
Po przesłaniu raportu do przeglądu wszystkie notatki działań korygujących stają się częścią niezmiennego zrzutu sprawdzonego raportu i nie mogą być już modyfikowane.
Tabela szczegółowa pokazuje pełną macierz segmentów czasu dla wszystkich skonfigurowanych parametrów. Domyślnie jest ukryta i nie jest ładowana, dopóki jej nie rozwiniesz, klikając Pokaż szczegółową tabelę. Dzięki temu początkowe generowanie raportu pozostaje szybkie, ponieważ tabela szczegółowa może być duża.
Każdy wiersz w tabeli reprezentuje jeden skonfigurowany parametr temperatury (identyfikowany przez sieć, urządzenie i nazwę parametru). Kolumny są pogrupowane według dni, a każdy dzień zawiera:
Nastawa — wartość zadana na początku dnia. Jeśli nastawa zmienia się w ciągu dnia, przy wartości z początku dnia pojawia się znacznik *. Jeśli dla tego dnia nie ma odczytu nastawy, wyświetlane jest -.
Kolumny segmentów — jedna kolumna na każdy segment czasu w danym dniu. Każda komórka pokazuje obliczoną wartość temperatury (albo - w przypadku braku danych) wraz ze stylizacją wizualną informującą o statusie segmentu.
Status — podsumowanie najgorszego stanu zaobserwowanego w ciągu dnia według następującego priorytetu: krytyczne naruszenie > odchylenie operacyjne > brak danych > nieznane wartości > OK.
Stylizacja wizualna komórek działa według następującego priorytetu (od najwyższego):
Wyłączone (szare tło) — urządzenie jest wyłączone w tym segmencie.
Odszranianie (żółte tło) — urządzenie jest w cyklu odszraniania.
Kolorowanie odchylenia (gradient od niebieskiego do pomarańczowego) — odchylenie temperatury od nastawy, gdy nastawa jest dostępna. Każdy krok koloru odpowiada 1°C odchylenia.
Białe tło — brak skonfigurowanej nastawy lub temperatura równa nastawie.
Naruszenia progów są nakładane na tło komórki:
Operacyjne naruszenie progu: cienka wewnętrzna ramka — niebieska poniżej operacyjnego limitu dolnego, czerwona powyżej operacyjnego limitu górnego.
Krytyczne naruszenie progu: grubsza wewnętrzna ramka w tym samym niebieskim lub czerwonym kolorze oraz pogrubiony tekst.
Brakujące lub nieznane wartości są pokazywane kursywą z wartością -.
Na dole każdej grupy kolumn dla dnia wiersz stopki pokazuje liczniki podsumowujące: całkowitą liczbę segmentów, liczbę segmentów z odchyleniami operacyjnymi, liczbę segmentów z naruszeniami krytycznymi oraz liczbę segmentów z nieznanymi wartościami.
Raport można eksportować do pliku Excel (.xlsx) w dowolnym momencie po wygenerowaniu. Na wygenerowanym raporcie kliknij Eksport do Excela. Na stronie szczegółów sprawdzonego raportu użyj Eksport do Excela lub Eksportuj sprawdzony raport (etykiety mogą nieznacznie różnić się w zależności od widoku; oba prowadzą do eksportu w bieżącym kontekście). Przy eksporcie wygenerowanego raportu dane odzwierciedlają odczyty zapisane w momencie generowania. Przy eksporcie sprawdzonego raportu dane pochodzą z zapisanego, niezmiennego zrzutu.
Wyeksportowany skoroszyt zawiera dwa arkusze:
Arkusz 1 — „Sprawozdanie HACCP” zawiera:
Nagłówek raportu: nazwę raportu, organizację, zakres dat, interwał i znacznik czasu wygenerowania.
Metadane przeglądu: typ eksportu (Eksport wygenerowanego raportu lub Eksport sprawdzonego raportu), nazwę sprawdzającego, datę przeglądu i uwagi do przeglądu.
Liczniki odchyleń: łączną liczbę odchyleń, liczbę odchyleń bez działań korygujących oraz liczbę przedziałów z nieznanym stanem/danymi.
Tabelę podsumowania odchyleń: te same informacje co w podsumowaniu odchyleń w przeglądarce — parametr, Odchylenie (typ odchylenia; nagłówek kolumny w tabeli to krótka etykieta Odchylenie), czasy rozpoczęcia i zakończenia, czas trwania, minimalne i maksymalne temperatury, odpowiedni limit lub nastawa oraz notatki działań korygujących. Notatki są uwzględniane w eksporcie niezależnie od tego, czy raport został już przesłany do przeglądu.
Arkusz 2 — „Szczegóły” zawiera:
Legendę kolorów: klucz referencyjny wyjaśniający kolory komórek, grubości obramowań (cieńsze dla progów operacyjnych, grubsze dla krytycznych) i style tekstu, zgodne z tabelą w przeglądarce.
Pełną macierz segmentów: tę samą tabelę szczegółową co w przeglądarce — jeden wiersz na parametr, jedna kolumna na segment czasu, pogrupowane według dni. Obejmuje kolumny nastawy, dzienne statusy i liczniki w stopkach dni.
Komentarze komórek: tam, gdzie przeglądarka pokazuje podpowiedzi dla nieznanych lub wnioskowanych wartości, plik Excel umieszcza te same wyjaśnienia jako komentarze komórek.
Skoroszyt jest formatowany do druku z układem strony A4 w orientacji poziomej, powtarzaniem wierszy nagłówka na każdej drukowanej stronie oraz stopką z numerami stron i tekstem „Generated by Overvis (www.overvis.com)” (w eksporcie pozostaje po angielsku).
Szablony zapisują konfigurację raportu do ponownego użycia, dzięki czemu można szybko generować raporty dla nowych zakresów dat bez ponownego konfigurowania parametrów i progów. Szablony są współdzielone na poziomie organizacji — wszyscy użytkownicy organizacji mogą je widzieć i używać.
Szablon przechowuje:
nazwę raportu
skonfigurowane parametry temperatury (wraz ze wszystkimi opcjonalnymi parametrami i progami)
rozmiar interwału (kadencję)
tryb wyświetlania wartości temperatury
Szablon nie przechowuje zakresu dat, wygenerowanych danych raportu, notatek działań korygujących ani metadanych przeglądu. Po załadowaniu szablonu zakres dat jest domyślnie ustawiany na ostatnie 7 dni.
Zapisywanie szablonu. Po skonfigurowaniu konstruktora na głównej stronie raportu HACCP kliknij Zapisz szablon. Szablon zostaje zapisany z bieżącą nazwą raportu i konfiguracją. Następnie następuje przekierowanie do strony szczegółów szablonu. (Gdy konstruktor jest już otwarty w kontekście szablonu, przycisk zapisu nowego szablonu może brzmieć Zapisz nowy szablon — zob. niżej.)
Ładowanie szablonu. Otwórz zakładkę Szablony, aby zobaczyć listę zapisanych szablonów. Kliknij nazwę szablonu, aby otworzyć konstruktor z już wypełnioną konfiguracją szablonu. Następnie w razie potrzeby zmień zakres dat i kliknij Pokaż raport.
Aktualizacja szablonu. Na stronie konstruktora powiązanej z danym szablonem zmodyfikuj ustawienia według potrzeb i kliknij Zaktualizuj szablon, aby zapisać zmiany. Możesz także kliknąć Zapisz nowy szablon, aby utworzyć osobny szablon ze zmodyfikowaną konfiguracją.
Usuwanie szablonu. Na liście szablonów kliknij ikonę kosza obok szablonu. Zanim szablon zostanie trwale usunięty, pojawi się strona potwierdzenia.
Lista szablonów pokazuje nazwę każdego szablonu (jako klikalny link) oraz datę utworzenia. Zapisywanie, aktualizowanie i usuwanie szablonów wymaga uprawnień edycji w organizacji.
Po wygenerowaniu raportu i udokumentowaniu wszelkich działań korygujących upoważniony użytkownik może przesłać raport do przeglądu. Tworzy to trwały, niezmienny zapis raportu.
Formularz przeglądu pojawia się w obszarze nagłówka wygenerowanego raportu i zawiera:
Sprawdził — automatycznie ustawianą nazwę użytkownika przesyłającego raport. Pole nieedytowalne.
Sprawdzono — automatycznie ustawianą bieżącą datę i godzinę. Pole nieedytowalne.
Uwagi do przeglądu — pole tekstowe na komentarz; edytowalne przed przesłaniem.
Kliknij Zatwierdź przegląd, aby sfinalizować raport. System zapisuje kompletny zrzut wszystkich odczytów, przedziałów odchyleń i notatek działań korygujących w stanie z momentu generowania. Po przesłaniu następuje przekierowanie do strony szczegółów sprawdzonego raportu.
Przesłanie przeglądu wymaga uprawnień edycji w organizacji. Przeglądu nie można cofnąć — po przesłaniu zrzut i cała jego zawartość stają się trwałe.
Zakładka Sprawdzone raporty (pasek akcji) otwiera stronę z nagłówkiem Sprawdzone raporty HACCP; pokazuje wszystkie przesłane zrzuty raportów dla organizacji. Lista wyświetla:
nazwę raportu (klikalny link do strony szczegółów)
zakres dat
Sprawdził
Sprawdzono
Uwagi do przeglądu
Kliknij nazwę raportu, aby otworzyć stronę szczegółów. Strona szczegółów pokazuje ten sam widok raportu co raport wygenerowany — nagłówek, legendę, podsumowanie odchyleń z notatkami działań korygujących oraz rozwijaną tabelę szczegółową — ale w trybie tylko do odczytu. Formularz konstruktora nie jest widoczny na tej stronie. Wszystkie dane pochodzą z zapisanego zrzutu, a nie z bieżących odczytów.
Sprawdzone raporty są przechowywane bezterminowo. Możesz eksportować sprawdzony raport do Excel z jego strony szczegółów. Wyeksportowany plik używa danych z zapisanego zrzutu, dzięki czemu zawsze dokładnie odpowiada temu, co zostało sprawdzone.
Właściciele organizacji mogą usunąć sprawdzony raport, klikając akcję usuwania na liście. Usunięcie powoduje zniknięcie raportu z listy i brak dostępu do jego strony szczegółów. Jeśli usunięty raport musi zostać przywrócony (na przykład na potrzeby audytu), skontaktuj się z support@overvis.com.
Mojego parametru temperatury nie ma na liście w oknie dialogowym. Co zrobić?
Na listach wyboru pojawiają się tylko śledzone parametry. Upewnij się, że parametr jest skonfigurowany jako śledzony w ustawieniach urządzenia. Gdy zacznie być śledzony, Overvis rozpocznie jego odczyt i zapisywanie wartości, a parametr pojawi się w oknie wyboru HACCP.
Urządzenie przekracza progi podczas cykli odszraniania. Jak to obsłużyć?
Cykle odszraniania nie tłumią wykrywania odchyleń progowych. Jeśli Twoje urządzenie rutynowo przekracza progi podczas odszraniania, raport będzie pokazywał takie sytuacje jako odchylenia za każdym razem. Możesz je dokumentować standardową notatką działania korygującego wyjaśniającą, że odchylenie wystąpiło podczas planowanego cyklu odszraniania. Jeśli odchylenia związane z odszranianiem są oczekiwane i nie oznaczają ryzyka dla bezpieczeństwa żywności, rozważ dostosowanie wartości progowych do normalnego zachowania urządzenia albo pozostaw progi nieustawione dla parametrów, w których skoki podczas odszraniania są rutynowe.
Przesłałem sprawdzony raport z błędnymi informacjami. Czy mogę to poprawić?
Sprawdzone raporty są niezmienne i nie można ich edytować po przesłaniu. Aby skorygować zapis, wygeneruj nowy raport dla tego samego zakresu dat z poprawnymi ustawieniami, dodaj odpowiednie notatki działań korygujących i prześlij go do przeglądu. Właściciele organizacji mogą usunąć niepoprawny sprawdzony raport z listy.
Co się dzieje, jeśli w segmencie jest tylko jeden odczyt?
Wszystkie tryby wartości temperatury (początek interwału, średnia, minimum, maksimum) zwracają tę samą wartość, gdy w segmencie istnieje tylko jeden odczyt. Wybrany tryb ma znaczenie dopiero wtedy, gdy w tym samym segmencie znajduje się wiele odczytów.
Jak zmiana czasu letniego wpływa na raport?
Raport używa strefy czasowej skonfigurowanej dla organizacji i prawidłowo uwzględnia zmiany czasu letniego. W dniach zmiany czasu liczba segmentów może być inna niż zwykle — doba 23-godzinna będzie miała mniej segmentów, a doba 25-godzinna więcej. Granice segmentów zawsze są wyrównane do lokalnego czasu zegarowego.
Czy można zaplanować automatyczne generowanie raportów?
Nie. Raporty HACCP są generowane na żądanie. Możesz zapisać szablon, aby przyspieszyć powtarzalną konfigurację, ale za każdym razem musisz ręcznie ustawić zakres dat i kliknąć Pokaż raport.
Jak często powinienem generować raporty?
To zależy od wymagań Twojego planu HACCP. Niektóre obiekty generują raporty codziennie, inne co tydzień. Korzystaj z zakresu dat i szablonów, aby dopasować raportowanie do harmonogramu przeglądów.
Co jeśli urządzenie będzie offline przez dłuższy czas?
Brakujące odczyty są oznaczane w raporcie jako odchylenia typu „nieznany status/dane”. Podsumowanie odchyleń pokaże dokładne przedziały czasu z brakującymi danymi, aby można było zbadać przyczynę i udokumentować działania korygujące. Jeśli urządzenie było celowo wyłączone, skonfiguruj parametr włącz/wyłącz, aby uniknąć fałszywych alarmów.
Czy wielu użytkowników może równocześnie pracować nad działaniami korygującymi dla tego samego raportu?
Nie. Wygenerowany raport istnieje tylko w przeglądarce użytkownika, który go wygenerował. Każdy użytkownik musi wygenerować własną instancję raportu. Tylko jeden użytkownik może przesłać raport do przeglądu.
Jaki jest maksymalny zakres dat raportu?
Nie ma sztywnego limitu zakresu dat. System wymusza limit całkowitego rozmiaru danych zależny od kombinacji zakresu dat, rozmiaru interwału i liczby skonfigurowanych parametrów. Jeśli raport byłby zbyt duży, przy próbie generowania zobaczysz komunikat błędu. W takim przypadku skróć zakres dat, użyj dłuższego interwału albo wygeneruj kilka mniejszych raportów.
Czy mogę dołączyć dokumenty pomocnicze (zdjęcia, certyfikaty kalibracji) do raportu?
Załączniki nie są bezpośrednio obsługiwane w raporcie HACCP. Jeśli musisz dołączyć dokumenty pomocnicze, wyeksportuj raport do Excel i połącz go z załącznikami w swoim systemie zarządzania dokumentami. Podobnie, jeśli sprawdzony raport wymaga podpisu elektronicznego, wyeksportuj go do Excel i podpisz w systemie elektronicznego obiegu dokumentów używanym w Twojej organizacji.
Jak długo przechowywane są sprawdzone raporty?
Sprawdzone raporty są przechowywane bezterminowo. Można je przeglądać, eksportować i wykorzystywać podczas audytów w dowolnym czasie. Właściciele organizacji mogą usuwać sprawdzone raporty, które nie są już potrzebne; usunięte raporty mogą zostać przywrócone po kontakcie z support@overvis.com.
Punkt kontroli — punkt w łańcuchu chłodniczym, w którym monitorowana jest temperatura; zwykle lodówka, zamrażarka lub chłodnia.
Działanie korygujące — działanie podjęte w odpowiedzi na wykryte odchylenie, udokumentowane jako notatka przypięta do przedziału odchylenia w raporcie.
Przedział odchylenia — ciągły okres, w którym utrzymuje się warunek odchylenia. Sąsiednie segmenty czasu z tym samym typem odchylenia są łączone w jeden przedział.
Rozmiar interwału — okres czasu używany do podziału raportu na segmenty do analizy. Nazywany również kadencją. Opcje w interfejsie: 1 dzień, 1 godzina, 30 minut, 15 minut.
Szablon — zapisana konfiguracja raportu (parametry, progi, rozmiar interwału, tryb wyświetlania), która może zostać ponownie załadowana w celu szybkiego wygenerowania raportu dla nowego zakresu dat.
Sprawdzony raport — niezmienny zrzut wygenerowanego raportu przesłanego do przeglądu, zawierający wszystkie odczyty, odchylenia, notatki działań korygujących i metadane przeglądu.
Segment — pojedynczy przedział czasu w ciągu dnia, określony przez rozmiar interwału. Na przykład przy jednogodzinnym interwale każdy dzień ma 24 segmenty (23 lub 25 w dniu zmiany czasu).
Nastawa — docelowa temperatura punktu kontrolnego, używana do kolorowania odchylenia w tabeli raportu.
Śledzony parametr — parametr urządzenia, który Overvis okresowo odczytuje i zapisuje w bazie danych. Tylko śledzone parametry mogą być używane w raportach HACCP.
Overvis Cloud Documentation
Wizualizacje
Wizualizacje w Overvis Cloud to niestandardowe, interaktywne strony (HTML/SVG/JavaScript), które pokazują bieżący stan urządzeń i umożliwiają zdalne sterowanie. To ta sama funkcja, którą w aplikacji oznaczono jako Wizualizacje. Overvis sam zapewnia łączność z urządzeniami, zbieranie danych i obsługę alarmów; wizualizacje dają natomiast swobodę w prezentacji tych informacji dokładnie tak, jak tego potrzebujesz.
Wizualizacje to kod HTML/SVG/JavaScript osadzony na stronach Overvis. Wygląd przygotowujesz w dowolnym edytorze grafiki wektorowej, eksportujesz go jako SVG, a następnie dodajesz specjalne atrybuty, które wiążą elementy grafiki z danymi z urządzeń na żywo.
Ta wizualizacja jest statyczna. Aby wyświetlić rzeczywiste dane urządzenia, musisz użyć powiązań danych — specjalnych atrybutów HTML/SVG łączących elementy wizualne z parametrami urządzenia.
Ten samouczek prowadzi przez utworzenie pełnej wizualizacji do monitorowania urządzeń chłodniczych. Dowiesz się, jak wyświetlać temperatury na żywo, dodać interaktywne sterowanie nastawami, wskaźniki alarmów i przełączniki.
Utwórz projekt wizualizacji w edytorze grafiki wektorowej. W tym przykładzie zrobimy rzut pomieszczenia magazynowego z agregatami chłodniczymi pokazującymi:
Rzut pomieszczenia
Wyświetlacze temperatury dla każdej lodówki
Sterowanie nastawami
Wskaźniki alarmów
Licznik energii
Przełącznik trybu odrośniania
Wskaźnik stanu drzwi
Projektując wizualizację, stosuj się do tych zasad:
Używaj wartości zastępczych. Wstaw reprezentatywne wartości zastępcze dla wszystkich danych dynamicznych. Dla temperatur ujemnych z jednym miejscem po przecinku użyj „-12.3”. Ułatwia to układ i pozycjonowanie podczas projektowania.
Oddziel elementy dynamiczne od statycznych. Wartości dynamiczne i etykiety statyczne zachowaj jako osobne obiekty tekstowe. Na przykład „-12.3” i „°C” powinny być osobnymi obiektami, aby na żywo podmieniać wyłącznie liczbę.
Tekst zostaw jako tekst. Nie zamieniaj dynamicznych elementów tekstowych na krzywe ani ścieżki. Tekst statyczny można przekonwertować, aby zmniejszyć rozmiar pliku, ale elementy dynamiczne muszą pozostać edytowalnym tekstem.
Używaj kompatybilnych czcionek. Trzymaj się czcionek bezpiecznych dla sieci (Arial, Times New Roman, Courier) lub użyj Droid Sans, które Overvis dostarcza do wszystkich wizualizacji. Własne czcionki wymagają dodatkowej konfiguracji CSS.
Ułóż wszystko od razu. Narysuj wszystkie elementy w docelowych pozycjach, także te początkowo ukryte (np. wskaźniki alarmów w stanie aktywnym i normalnym lub przełączniki w obu pozycjach włącz/wyłącz).
Nazwij warstwy opisowo. Używaj czytelnych nazw warstw w edytorze. Te nazwy często stają się identyfikatorami elementów w SVG, co ułatwia znajdowanie konkretnych elementów przy dodawaniu powiązań danych.
Aby wyświetlić wartość parametru urządzenia jako tekst, dodaj atrybut param-value do elementu tekstowego. Na przykład, aby pokazać temperaturę z czujnika sterownika lodówki:
Znajdź element tekstowy w kodzie SVG (szukaj nazw warstw ustawionych wcześniej):
Atrybut on-click="edit-param:..." po kliknięciu otwiera okno dialogowe do wprowadzenia nowej wartości. Po zapisaniu Overvis zapisuje wartość do urządzenia i odświeża wizualizację.
Dodanie cursor:pointer do stylu zmienia kursor tak, by wskazywał, że element można kliknąć.
Użyj on-param-value, aby pokazywać lub ukrywać elementy w zależności od wartości parametru. Sprawdza się to np. przy wskaźnikach alarmów, które mają być widoczne dopiero po wystąpieniu alarmu:
:block — wartość gdy warunek prawdziwy (pokaż element)
:none — wartość gdy warunek fałszywy (ukryj element)
:r — odczyt bezpośrednio z urządzenia w czasie rzeczywistym
Ustaw domyślnie style="display:none;", aby element był początkowo ukryty. Gdy parametr wynosi 1, styl display zmienia się na block, co czyni wskaźnik widocznym.
Połącz on-param-value z on-click dla przełączników. Zaprojektuj oba stany przełącznika, a następnie pokazuj jeden lub drugi w zależności od bieżącej wartości:
Każdy stan ma on-param-value, który go pokazuje, gdy parametr pasuje (:=1 dla ON, :=0 dla OFF). Grupa nadrzędna ma on-click="toggle-param:PARAM_REF:DEFAULT_VALUE:VALUE_ON:OPTIONS", co przełącza parametr między 0 i 1 po kliknięciu. Opcja :g na końcu odświeża wszystkie dane wizualizacji po zmianie.
Aby użytkownicy mogli edytować etykiety lub nazwy nieprzechowywane w rejestrach urządzenia, użyj własnej pamięci wizualizacji w bazie. Najpierw włącz tę funkcję, dodając atrybut do głównego znacznika <svg>:
<svguse-vis-data="yes" ...>
Następnie oznacz elementy tekstowe, które mają być edytowalne i zapisywane:
Atrybut text-replacement określa klucz zapisu. Początkowa treść tekstu staje się wartością domyślną. Po kliknięciu elementu (przez on-click="edit-visdata:...") użytkownik może edytować i zapisać nową wartość, która trafia do bazy i tam pozostaje.
Zwróć uwagę, że nie ma flagi :r. Odczytywana jest ostatnia wartość z bazy (aktualizowana co 5 minut), a nie bezpośrednie odpytywanie urządzenia. To zmniejsza obciążenie sieci dla wartości, które nie wymagają aktualizacji w czasie rzeczywistym.
Ukończona wizualizacja pokazuje dane urządzeń na żywo, umożliwia interakcję i aktualizuje się automatycznie:
Domyślnie param-value odczytuje ostatnią zapisaną wartość z bazy. Dodaj opcję :r, aby odczytać bezpośrednio z urządzenia w czasie rzeczywistym. Wybierz według potrzeb:
Używaj odczytu z bazy (bez opcji :r), gdy:
Wartość zmienia się rzadko
Dokładne dane w czasie rzeczywistym nie są krytyczne
Chcesz zmniejszyć ruch sieciowy i przyspieszyć odświeżanie
Wiele wizualizacji pokazuje te same dane
Parametr jest śledzony w systemie
Używaj odczytu w czasie rzeczywistym (opcja :r), gdy:
Potrzebujesz absolutnie aktualnej wartości
Parametr zmienia się często
Interakcje użytkownika zależą od natychmiastowej informacji zwrotnej
Wyświetlasz stany sterowania, które użytkownik właśnie zmienił
Gdy wyświetlasz wiele alarmów jednocześnie, utwórz osobne elementy wskaźników dla każdego typu alarmu i rozmieść je tak, aby się nie nakładały. Użyj osobnych powiązań on-param-value dla każdego. W złożonych scenariuszach rozważ JavaScript do dynamicznego pozycjonowania wskaźników.
Choć powiązania danych obsługują większość typowych przypadków, możesz użyć JavaScriptu do zaawansowanych funkcji. Wizualizacje działają w kontekście strony Overvis, co daje dostęp do pełnego API przeglądarki i funkcji specyficznych dla Overvis.
Aby wykonywać uwierzytelnione wywołania API z wizualizacji, musisz dołączyć token sesji. Token jest przechowywany w pamięci przeglądarki i dostępny przez JavaScript.
Użyj funkcji preInitViz(), aby wykonać kod przed inicjalizacją wizualizacji. Przydaje się do pobierania danych z API lub konfiguracji własnej logiki:
<script>
window.preInitViz=function(callback) {
// Get the authentication token from session storage
Sprawdź, czy interwał odświeżania jest poprawnie ustawiony, czy adresy parametrów zgadzają się z konfiguracją urządzeń oraz czy urządzenia są online i odpowiadają. W konsoli deweloperskiej przeglądarki (F12) zobaczysz ewentualne błędy JavaScriptu.
Dane pokazują kody błędów (NOLR, NOPR, NORV itd.)
NOLR (No Last Reading) — parametr nigdy nie był odczytany lub nie jest śledzony. Zaznacz „Śledzone” w ustawieniach parametru urządzenia lub dodaj opcję :r dla odczytów w czasie rzeczywistym.
NOPR (No Parameter for realtime) — nie udało się rozwiązać parametru dla slotu czasu rzeczywistego. Sprawdź, czy referencja parametru w wizualizacji jest prawidłowa.
NORV (No realtime value) — odczyt w czasie rzeczywistym nie zwrócił wartości. Sprawdź łączność z urządzeniem i spróbuj odczytać parametr na stronie parametrów urządzenia, aby zobaczyć faktyczny błąd.
NON (No Network) — wskazana sieć nie istnieje lub nie masz do niej dostępu.
NOP (No Parameter) — wskazany parametr nie istnieje w urządzeniu.
Elementy interaktywne nie działają
Zweryfikuj składnię on-click zgodnie z dokumentacją. Upewnij się, że cursor:pointer jest w atrybucie stylu. Sprawdź, czy inny element nie zasłania klikalnego elementu (kolejność warstw SVG ma znaczenie).
Styl wygląda źle
Upewnij się, że eksport SVG nie zamienił tekstu na krzywe. Używaj stylów wbudowanych w elementach SVG, aby uniknąć konfliktów z CSS strony. Zweryfikuj strukturę SVG narzędziem walidacji SVG.
Odświeżanie jest wolniejsze niż oczekiwane
Jeśli odczytujesz wiele parametrów z opcją :r (odczyty w czasie rzeczywistym), każdy wymaga zapytania do urządzenia. Kolejny cykl odświeżania nie startuje, dopóki poprzedni się nie zakończy. Dla wartości mniej istotnych w czasie rzeczywistym użyj odczytów z bazy (bez :r), aby skrócić czas cyklu odświeżania, lub zwiększ ustawienie update-period-sec.
Czy mogę używać zewnętrznych bibliotek JavaScript, np. Chart.js lub D3.js?
Tak. Dołącz je przez CDN w znaczniku <script> na początku kodu źródłowego wizualizacji. Pamiętaj jednak, że duże biblioteki mogą spowolnić ładowanie strony.
Czy mogę tworzyć wielostronicowe wizualizacje?
Wizualizacje z założenia są jednostronicowe, ale możesz symulować wiele stron używając JavaScriptu do pokazywania/ukrywania sekcji albo utworzyć kilka osobnych wizualizacji i linkować między nimi przez on-click="goto:vis:...".
Jak debugować JavaScript wizualizacji?
Użyj narzędzi deweloperskich przeglądarki (F12). Logi konsoli, punkty przerwania i inspekcja sieci działają normalnie. Sprawdź konsolę pod kątem błędów wywołań API lub powiązań danych.
Czy wizualizacje mogą odczytywać dane z wielu organizacji?
Nie. Każda wizualizacja należy do jednej organizacji i może uzyskiwać dane tylko z sieci i urządzeń w tej organizacji. API wymusza to przez tokeny uwierzytelniania.
Jaka jest różnica między identyfikatorem systemowym parametru a adresem parametru?
Adres parametru to adres rejestru Modbus na urządzeniu (np. 101). Identyfikator systemowy to wewnętrzny identyfikator bazy Overvis dla tego parametru. Używaj adresów w referencjach postaci 12-34-56-78-90-ab>1>101 albo identyfikatorów systemowych z prefiksem #: #1234567.
Czy mogę stylować wizualizacje własnymi frameworkami CSS?
Tak, ale dołącz plik CSS frameworka w <style> lub <link>. Pamiętaj, że strona Overvis ma własne style, które mogą kolidować. Używaj konkretnych selektorów lub stylów wbudowanych, aby uniknąć problemów.
Jak obsługiwać strefy czasowe?
Wszystkie daty z API Overvis są w UTC. Użyj obiektu Date w JavaScript i toLocaleString(), aby przeliczyć na lokalną strefę użytkownika, lub podaj konkretną strefę, jeśli to potrzebne.
Jeśli potrzebujesz wsparcia przy tworzeniu wizualizacji Overvis, napisz na support@overvis.com. Chętnie pomożemy przy niestandardowych wizualizacjach, odpowiemy na pytania o funkcje zaawansowane lub doprecyzujemy dokumentację.
Overvis Cloud Documentation
Organizacje i użytkownicy
Overvis Cloud używa organizacji, aby oddzielać sprzęt, dane i rozliczenia poszczególnych klientów lub projektów. Każde konto użytkownika może należeć do jednej lub więcej organizacji, a każde członkostwo ma określoną rolę, która decyduje o tym, co użytkownik może robić.
Organizacja to kontener najwyższego poziomu w Overvis. Wszystkie sieci, urządzenia, parametry, alerty, wizualizacje, raporty i rozliczenia należą do konkretnej organizacji. Dane są w pełni izolowane między organizacjami — użytkownicy widzą wyłącznie dane organizacji, w której aktualnie pracują.
Właściciele i menedżerowie organizacji mogą edytować następujące ustawienia. Na pasku bocznym stronę tę otwiera pozycja Szczegóły pod nazwą organizacji; tytuł strony to Ustawienia organizacji.
Nazwa — wyświetlana nazwa organizacji (do 200 znaków)
Kraj i telefon kontaktowy
Język powiadomień — język automatycznych wiadomości e-mail i SMS. Dostępne języki: angielski, ukraiński, polski, rosyjski.
Domyślny e-mail i telefon do powiadomień — używane jako wartości domyślne przy tworzeniu nowych alertów
Dane do rozliczeń — imię i nazwisko, kraj, miasto, adres, kod pocztowy, telefon, e-mail oraz numer VAT (używane na fakturach)
Właściciele widzą ponadto na stronach organizacji opcje zarządzania członkami.
Organizacja jest tworzona automatycznie przy rejestracji nowego konta Overvis. Nazwa organizacji jest ustawiana podczas rejestracji. Jeśli pozostawisz ją pustą, domyślna nazwa jest tworzona na podstawie adresu e-mail:
Jeśli domena e-mail ma 10 lub więcej znaków (np. user@longcompany.com), jako nazwa używana jest domena (longcompany.com).
Jeśli domena jest krótsza (np. user@acme.co), jako nazwa używany jest pełny adres e-mail (user@acme.co).
Zawsze należysz do co najmniej jednej organizacji. Jeśli właściciel usunie Cię z organizacji i nie masz innych członkostw, dla Ciebie automatycznie tworzona jest nowa, pusta organizacja.
Jeśli należysz do kilku organizacji (np. jako właściciel własnej organizacji i jako osoba z rolą Tylko odczyt w organizacji klienta), pracujesz w jednej organizacji na raz. Możesz przełączać się między nimi za pomocą przełącznika organizacji na górnym pasku nawigacji.
Po zalogowaniu Overvis automatycznie wybiera organizację, w której masz rolę właściciela lub menedżera. Jeśli nie masz roli właściciela ani menedżera w żadnej organizacji, wybierana jest pierwsza dostępna organizacja.
Konto użytkownika reprezentuje jedną osobę. Każde konto ma unikalny adres e-mail i automatycznie generowaną nazwę użytkownika oraz należy do jednej lub więcej organizacji.
Adres e-mail — służy do logowania i powiadomień (musi zostać potwierdzony po rejestracji)
Hasło — minimum 5 znaków
Nazwa organizacji (opcjonalna) — nazwa organizacji, która zostanie dla Ciebie utworzona
Nazwa użytkownika jest generowana automatycznie z adresu e-mail przy rejestracji. Możesz logować się zarówno adresem e-mail, jak i nazwą użytkownika.
Jeśli otrzymałeś link zaproszenia, możesz zarejestrować się przez ten link — Twoje konto zostanie dodane do zapraszającej organizacji zamiast utworzyć nową organizację.
Po rejestracji lub zmianie adresu e-mail otrzymujesz wiadomość z prośbą o potwierdzenie. Masz 24 godziny na potwierdzenie nowego adresu. Przez ten czas platforma traktuje e-mail jako potwierdzony i możesz korzystać ze wszystkich funkcji normalnie. Po upływie 24 godzin bez potwierdzenia niektóre działania (np. zarządzanie urządzeniami lub tworzenie alertów) pozostają ograniczone do momentu potwierdzenia adresu e-mail.
W ustawieniach konta (Ustawienia użytkownika > Prywatne informacje na pasku bocznym) możesz zmienić:
Imię, drugie imię, nazwisko i numer telefonu
Dodatkowe akcje konta dostępne na pasku bocznym:
Zmień e-mail — wymaga ponownego potwierdzenia w ciągu 24 godzin
Zmień hasło — wymaga aktualnego hasła
Klucze API — zarządzanie tokenami dostępu programowego (zob. Klucze API)
Usuń konto — trwałe usunięcie konta
Język interfejsu zmienia się przełącznikiem języka na pasku nawigacji (angielski, ukraiński, polski, rosyjski). To ustawienie jest zapisywane na koncie.
Możesz usunąć konto w Ustawienia użytkownika > Usuń konto. Trwale usuwa to Twoje konto użytkownika, klucze API i powiązane dane.
Usunięcie konta może być zablokowane w następujących przypadkach:
Jesteś właścicielem organizacji, która ma innych członków. Najpierw musisz usunąć wszystkich pozostałych członków lub przekazać własność innemu użytkownikowi, zanim usuniesz konto.
Twoja organizacja ma dodatnie saldo konta. Skontaktuj się z pomocą techniczną, aby uregulować saldo przed usunięciem konta.
Jeśli jesteś jedynym członkiem organizacji, ta organizacja oraz wszystkie jej sieci i urządzenia są dezaktywowane przy usunięciu konta.
Każde członkostwo w organizacji ma dokładnie jedną rolę. Rola określa, co użytkownik może robić w tej organizacji. Istnieje osiem ról, podzielonych na dwie grupy: role pełnego interfejsu (dostęp do pełnego interfejsu zarządzania Overvis) oraz role monitoringu (dostęp tylko do uproszczonego interfejsu monitorowania pod /view/).
Te role dają dostęp do pełnego interfejsu zarządzania Overvis z różnym poziomem uprawnień.
Właściciel to najwyższa rola. Właściciel ma pełną kontrolę nad organizacją, w tym:
Przeglądanie wszystkich danych, wysyłanie poleceń do urządzeń
Tworzenie i edycję sieci, urządzeń, parametrów, alertów, szablonów, wizualizacji i raportów
Zapraszanie, edycję i usuwanie członków organizacji
Dostęp do rozliczeń, historii płatności i salda konta
Edycję ustawień organizacji
Tylko właściciele mogą zarządzać członkami organizacji. Nie ma limitu liczby właścicieli na organizację, ale zwykle jest jeden.
Menedżer ma te same możliwości co właściciel, z wyjątkiem zarządzania członkami organizacji. Menedżerowie mogą:
Przeglądać wszystkie dane, wysyłać polecenia do urządzeń
Tworzyć i edytować sieci, urządzenia, parametry, alerty, szablony, wizualizacje i raporty
Korzystać z rozliczeń, historii płatności i salda konta
Edytować ustawienia organizacji
Menedżer techniczny jest podobny do menedżera, ale bez dostępu do rozliczeń i ustawień organizacji. Menedżerowie techniczni mogą:
Przeglądać wszystkie dane, wysyłać polecenia do urządzeń
Tworzyć i edytować sieci, urządzenia, parametry, alerty, szablony, wizualizacje i raporty
Nie mają dostępu do rozliczeń ani informacji o płatnościach, nie zarządzają członkami i nie edytują ustawień organizacji.
Operator może przeglądać dane i wysyłać polecenia zapisu do urządzeń, ale nie może zmieniać struktury organizacji. Operatorzy mogą:
Przeglądać wszystkie sieci, urządzenia, parametry i raporty
Wysyłać polecenia zapisu do urządzeń (np. zmiana wartości zadanej lub przełączenie przekaźnika)
Nie mogą tworzyć, edytować ani usuwać sieci, urządzeń, alertów ani innych obiektów.
Tylko odczyt — ta rola zapewnia wyłącznie dostęp do odczytu. Użytkownicy z tą rolą mogą:
Przeglądać wszystkie sieci, urządzenia, parametry, pulpity i raporty
Nie mogą zapisywać do urządzeń ani modyfikować niczego. Rola ta jest przydatna dla interesariuszy, kadry zarządzającej lub każdego, kto potrzebuje tylko podglądu danych bez możliwości ich zmiany.
Role monitoringu zapewniają dostęp wyłącznie do uproszczonego interfejsu monitorowania (sekcja /view/). Użytkownicy z tymi rolami nie mają dostępu do pełnego interfejsu zarządzania. Role monitoringu są przeznaczone dla wyświetlaczy ściennych, techników w terenie z ograniczonym dostępem lub zewnętrznych obserwatorów.
Operator monitoringu może przeglądać pulpity monitorowania i wysyłać polecenia zapisu do urządzeń.
Tylko odczyt monitoringu ma wyłącznie dostęp do odczytu pulpitów monitorowania.
Monitor bez parametrów może przeglądać pulpity monitorowania, ale nie widzi listy parametrów. Tę rolę może przypisać wyłącznie administrator platformy i nie jest ona dostępna w standardowych formularzach zaproszenia ani edycji członka.
Przypisywanie użytkowników monitoringu do konkretnego widoku
Role monitoringu mogą być opcjonalnie powiązane z konkretną wizualizacją lub raportem zużycia zasobów. Po powiązaniu użytkownik jest automatycznie przekierowywany do tego widoku po zalogowaniu lub po przejściu poza dozwolone strony. Przydaje się to przy konfiguracji dedykowanego ekranu, który stale pokazuje jeden pulpit lub raport.
Użytkownika monitoringu można powiązać albo z wizualizacją, albo z raportem zużycia zasobów — nie z oboma jednocześnie.
Przejdź do Organizacja > Członkowie na pasku bocznym
Kliknij Zaproś członka
Wpisz adres e-mail osoby
Wybierz rolę: Menedżer, Menedżer techniczny, Operator, Tylko odczyt, Operator monitoringu lub Tylko odczyt monitoringu
W przypadku ról monitoringu opcjonalnie wybierz wizualizację lub raport zużycia zasobów, z którym powiązać użytkownika
Wyślij zaproszenie
Zaproszona osoba otrzymuje wiadomość e-mail z linkiem. Link jest ważny 2 dni. Jeśli ma już konto Overvis, zostanie poproszona o zalogowanie, a następnie zaproszenie zostanie zastosowane. Jeśli nie ma konta, najpierw trafia na stronę rejestracji.
Nie można zaprosić kogoś bezpośrednio jako Właściciel — własność można nadać wyłącznie edytując rolę istniejącego członka.
Przejdź do Organizacja > Członkowie, aby zobaczyć wszystkich aktualnych członków i oczekujące zaproszenia. Każdy wpis pokazuje imię członka (lub e-mail, jeśli nie ustawiono imienia), jego rolę oraz akcje zarządzania.
Kliknij ikonę edycji (ołówka) w wierszu tego członka
Kliknij Usuń dostęp
Potwierdź działanie
Usunięty użytkownik traci dostęp do organizacji natychmiast i otrzymuje powiadomienie e-mail. Jeśli nie ma innych członkostw w organizacjach, dla jego konta automatycznie tworzona jest nowa, pusta organizacja.
Nie możesz usunąć siebie z organizacji przez interfejs zarządzania członkami.
Klucze API zapewniają dostęp programowy do REST API Overvis. Należą do konta użytkownika (nie do konkretnej organizacji) i dziedziczą wszystkie członkostwa oraz role w organizacjach.
Aby korzystać z API, najpierw uwierzytelnij się żądaniem POST:
POST /v1/authenticate/
{
"apiKey": "513cf747-eb5c-4d5f-931f-d22c9872c73c",
"password": "your_password_here"
}
Odpowiedź zawiera token sesji i czas jego wygaśnięcia. Użyj tego tokena do uwierzytelniania kolejnych żądań API. Token wygasa po okresie bezczynności — każde żądanie API przedłuża czas życia tokena automatycznie.
Na stronie Ustawienia użytkownika > Klucze API możesz:
Wyświetlać wszystkie klucze i daty ich utworzenia
Ustawić maksymalną liczbę zapytań na minutę — opcjonalnie ograniczyć klucz do 1–100 żądań na minutę. Gdy limit nie jest ustawiony, obowiązuje domyślny limit platformy.
Usunąć klucz — jeśli klucz został ujawniony, usuń go natychmiast i utwórz nowy
Jeśli od rejestracji lub zmiany e-maila minęło więcej niż 24 godziny bez potwierdzenia, dostęp do większości funkcji jest ograniczony. Przejdź do Ustawienia użytkownika > Zmień e-mail, wpisz ponownie adres e-mail, a zostanie wysłana nowa wiadomość z potwierdzeniem. Otrzymujesz kolejne 24 godziny na potwierdzenie.
Nie mam dostępu do rozliczeń ani ustawień organizacji
Tylko właściciele i menedżerowie mogą przeglądać informacje rozliczeniowe i edytować ustawienia organizacji. Jeśli potrzebujesz dostępu, poproś właściciela organizacji o zmianę Twojej roli. Aktualną rolę sprawdzisz na górnym pasku nawigacji obok nazwy organizacji.
Zarządzanie członkami (zapraszanie, edycja ról i usuwanie członków) jest ograniczone do roli właściciela. Menedżerowie i inne role nie mogą zarządzać członkami. Jeśli musisz kogoś zaprosić, poproś właściciela organizacji.
Linki zaproszeń są ważne 2 dni. Jeśli link wygasł, poproś właściciela organizacji o wysłanie nowego zaproszenia. Stare zaproszenie można usunąć ze strony członków.
Gdy zostaniesz usunięty z organizacji, tracisz dostęp do danych tej organizacji. Same dane nie są usuwane — inni członkowie organizacji nadal mają dostęp. Jeśli usunięto Cię przez pomyłkę, poproś właściciela organizacji o ponowne zaproszenie. Jeśli nie miałeś innych członkostw w organizacjach, dla Twojego konta automatycznie utworzono nową, pustą organizację.
Jesteś właścicielem organizacji, która ma innych członków. Najpierw przekaż własność innemu członkowi (zmień jego rolę na Właściciel), a następnie opuść organizację lub spróbuj usunąć konto ponownie.
Twoja organizacja ma dodatnie saldo konta. Skontaktuj się z support@overvis.com, aby uregulować saldo.
Jeśli użytkownik monitoringu jest powiązany z konkretną wizualizacją lub raportem zużycia zasobów, jest automatycznie przekierowywany do tego widoku. Aby zmienić lub usunąć powiązanie, właściciel organizacji powinien edytować ustawienia członka i zaktualizować powiązaną wizualizację lub raport.
Tak. Możesz być członkiem tylu organizacji, ilu potrzebujesz, z inną rolą w każdej. Użyj przełącznika organizacji na górnym pasku nawigacji, aby się między nimi przełączać. Dane, rozliczenia i ustawienia każdej organizacji są całkowicie oddzielone.
Tak. Nie ma limitu liczby właścicieli. Większość organizacji ma jednak jednego właściciela. Aby uczynić innego członka właścicielem, obecny właściciel zmienia jego rolę na stronie członków.
Nie możesz usunąć siebie z organizacji przez interfejs zarządzania członkami. Jeśli chcesz odejść, najpierw nadaj rolę Właściciel innemu członkowi, a następnie poproś go, aby usunął Cię z organizacji.
Jaka jest różnica między Operatorem a Operatorem monitoringu?
Obie role mogą przeglądać dane i wysyłać polecenia zapisu do urządzeń. Różnica dotyczy interfejsu:
Operator korzysta z pełnego interfejsu zarządzania z dostępem do wszystkich stron (sieci, urządzenia, parametry, raporty itd.), ale nie może tworzyć ani edytować obiektów.
Operator monitoringu ma dostęp tylko do uproszczonego interfejsu monitorowania (sekcja /view/) z pulpitami. Nie ma dostępu do pełnego interfejsu zarządzania.
Tak. Użyj przełącznika języka na pasku nawigacji, aby zmienić język interfejsu. Dostępne języki: angielski, ukraiński, polski, rosyjski. To ustawienie jest zapisywane na koncie i obowiązuje przy następnym logowaniu.
Język powiadomień to ustawienie na poziomie organizacji, które określa język automatycznych wiadomości e-mail i SMS (powiadomienia alertów, komunikaty systemowe). Jest oddzielny od osobistego języka interfejsu. Właściciele i menedżerowie mogą go zmienić w Organizacja > Ustawienia organizacji.
Klucze API należą do konta użytkownika, a nie do konkretnej organizacji. Po uwierzytelnieniu kluczem API otrzymujesz sesję z dostępem do wszystkich organizacji, w których Twoje konto jest członkiem, z tymi samymi rolami i uprawnieniami, jakie ma Twoje konto użytkownika.
Overvis Cloud stosuje model salda przedpłaconego. Twoja organizacja ma saldo w EUR, a system codziennie automatycznie pobiera z niego koszt usług. Przy niskim saldzie otrzymujesz wiadomości e-mail z ostrzeżeniem. Gdy środki się wyczerpią, wszystkie Twoje sieci są wyłączane, dopóki saldo nie zostanie doładowane.
Nie ma planów taryfowych ani miesięcznej subskrypcji — płacisz wyłącznie za usługi, z których faktycznie korzystasz. Strony rozliczeń są dostępne dla użytkowników z rolami Właściciel i Menedżer; użytkownicy z rolą Tylko odczyt nie mają do nich dostępu.
Przetwarzanie sieci — stała dzienna stawka za każdą sieć, czyli za każde podłączenie bramy. Standardowa stawka to €0,50/dzień (€15/miesiąc) za sieć. Kody rabatowe promocyjne lub polecające mogą obniżać tę stawkę (zob. Kody rabatowe). Przy wdrożeniach z co najmniej 10 bramami dostępne są rabaty wolumenowe — szczegóły uzyskasz w dziale sprzedaży.
Przechowywanie danych — każda sieć obejmuje podstawowy limit przechowywania danych bez dopłaty. Dodatkowy wolumen danych jest rozliczany według €0,20/miesiąc za 1 000 000 punktów danych. Dla porównania: zapis wartości 100 parametrów co 60 sekund daje około 150 000 punktów danych miesięcznie, więc większość użytkowników mieści się w wliczonym limicie.
Powiadomienia SMS — płatne za każdą wiadomość w momencie wysyłki według kraju odbiorcy. Typowe stawki: €0,03–0,05 za SMS w UE, w zależności od kraju docelowego. Koszt SMS jest pobierany ze salda zaraz po wysłaniu. Powiadomienia e-mail są bezpłatne i bez limitów.
Dzienna opłata za przetwarzanie sieci jest pobierana raz dziennie za poprzedni dzień kalendarzowy. Jeśli sieć była włączona choć przez część poprzedniego dnia, naliczane jest obciążenie.
Wszystkie ceny podane są netto (bez VAT). Aktualne szczegóły znajdziesz na stronie cennika Overvis.
Maksymalna kwota doładowania zależy od bieżącego salda konta — system ogranicza łączne saldo konta górną granicą, np. €1 000. Jeśli saldo jest już blisko tego limitu, dostępna kwota doładowania będzie mniejsza, a formularz płatności kartą może być tymczasowo niedostępny.
Aby zapłacić przelewem bankowym lub gotówką, skontaktuj się z przypisanym osobistym opiekunem klienta (jeśli jest widoczny na stronie) lub z pomocą Overvis. Dane kontaktowe są widoczne na stronie doładowania.
Strona Raport salda konta (dostępna z menu salda na pasku bocznym) to główne miejsce do analizy wydatków. Ma dwa główne bloki: szacowane wydatki oraz historię wydatków.
Ta sekcja pokazuje prognozę przyszłych obciążeń na podstawie obecnie włączonych sieci. Dane są pokazane w tabeli z trzema zakładkami:
Pierwsza zakładka — prognoza kosztów od dziś do końca bieżącego miesiąca kalendarzowego. Etykieta pokazuje nazwę miesiąca i liczbę pozostałych dni; w nagłówkach kolumn jest oznaczenie do końca miesiąca w prognozie do końca bieżącego miesiąca.
30 dni — prognoza na następne 30 dni
365 dni — prognoza na następne 365 dni
Dla każdej sieci tabela pokazuje:
Kolumna
Opis
Nazwa sieci
Nazwa sieci; wyłączone sieci są pokazane na szaro
Przetwarzanie / dzień
Dzienny koszt przetwarzania tej sieci
Przetwarzanie / okres
Łączny koszt przetwarzania za wybrany okres
Przechowywanie odczytów / dzień
Dzienny koszt przechowywania
Przechowywanie odczytów / okres
Łączny koszt przechowywania za okres
Łącznie / dzień
Łączny koszt dzienny
Łącznie / okres
Łączny koszt za wybrany okres
Na dole tabeli jest wiersz podsumowania dla wszystkich sieci.
Pod prognozą znajduje się tabela faktycznych obciążeń i uznań za wybrany miesiąc. Użyj listy rozwijanej Miesiąc:, aby przełączać się między miesiącami (dane dostępne od miesiąca pierwszego obciążenia Twojej organizacji).
Wiersze są pogrupowane według kategorii. Kliknij wiersz kategorii, aby rozwinąć i zobaczyć poszczególne wpisy:
Doładowanie — otrzymane płatności (karta, przelew bankowy, gotówka) ze sposobem płatności, numerem dokumentu potwierdzenia i datą; w tym uznania na saldo bonusowe.
System — uznania generowane przez system (np. bonus rejestracyjny).
Przetwarzanie sieci — codzienne obciążenia za sieci. Po rozwinięciu widać poszczególne wpisy dzienne z datą naliczenia i kodem rabatowym (jeśli występuje).
Przechowywanie sieci — koszty przechowywania danych za sieć.
Powiadomienia SMS — obciążenia za SMS, pogrupowane według numeru telefonu, z możliwością rozwinięcia do pojedynczych wiadomości ze znacznikami czasu i liczbą.
Zwrot gotówki — zwroty z programu polecającego, jeśli występują (zob. Kody rabatowe).
Inne — inne korekty.
Każdy wiersz ma cztery kolumny:
Kolumna
Opis
Opis
Za co dokładnie było obciążenie lub uznanie
Ilość
Liczba pojedynczych wpisów w grupie
Kwota
Kwota w EUR (uznania na zielono, obciążenia na czerwono)
Premia
Zmiana salda bonusowego, jeśli wystąpiła
Na dole tabeli są:
Razem — czysta zmiana za wybrany miesiąc
Saldo na początku okresu — saldo konta i saldo bonusowe na początku miesiąca
Saldo na koniec okresu — saldo konta i saldo bonusowe na końcu miesiąca
System monitoruje saldo i wysyła powiadomienia e-mail, gdy pozostałe środki szacunkowo wystarczą na około 30 dni, 10 dni i 5 dni przy obecnej stawce dziennej.
Gdy saldo jest całkowicie wyczerpane, tzn. wynosi zero lub mniej, wysyłana jest końcowa wiadomość o wyczerpanym saldzie z bezpośrednim linkiem do strony doładowania.
Możesz określić, kto otrzyma powiadomienia rozliczeniowe, podając adres e-mail do rozliczeń w ustawieniach organizacji.
Jeśli suma salda konta i salda bonusowego spadnie do zera lub poniżej podczas codziennego cyklu rozliczeń:
Wszystkie sieci organizacji są wyłączane przez system rozliczeń.
Na adres e-mail podany w informacjach rozliczeniowych wysyłana jest wiadomość.
Wyłączone sieci przestają odpytywać urządzenia — nowe odczyty nie są zbierane i alerty nie są wyzwalane.
Powiadomienia SMS są również blokowane, gdy saldo jest niewystarczające.
Dane historyczne pozostają zachowane i są przechowywane zgodnie z ustawieniami przechowywania danych organizacji, także po wyłączeniu sieci.
Aby wznowić działanie: doładuj saldo konta. Gdy tylko saldo znów bęzie dodatnie, ponownie włącz sieci ręcznie ze strony ustawień każdej sieci. System nie włącza ich automatycznie.
Overvis obsługuje kody promocyjne i polecające, które obniżają dzienną stawkę za przetwarzanie sieci. Kod rabatowy jest przypisany do konkretnej sieci i ustala dla niej osobną, niższą cenę dzienną.
Kod rabatowy może mieć:
stałą stawkę dzienną;
opcjonalny okres ważności;
opcjonalne ograniczenie liczby zastosowań;
opcjonalną końcową datę rejestracji.
Gdy okres ważności kodu się kończy, dzienna stawka sieci automatycznie wraca do standardowej.
Niektóre kody rabatowe obejmują zwrot gotówki za polecenie — codzienne uznanie na saldo organizacji polecającej za każdy dzień aktywności poleconej sieci. Zwrot gotówki jest liczony wyłącznie od tej części dziennego obciążenia, która nie pochodzi z salda bonusowego. W raporcie salda konta takie wpisy są w kategorii Zwrot gotówki.
W ustawieniach organizacji jest sekcja Informacje rozliczeniowe, w której menedżerowie mogą podać dane do potwierdzeń i faktur:
Nazwa organizacji / osoba kontaktowa (wymagane)
Kod VAT — identyfikator podatkowy VAT
Kraj i Miasto
Adres firmy i Kod pocztowy
Telefon
Email (wymagany) — potwierdzenia, faktury i powiadomienia rozliczeniowe są wysyłane na ten adres
Aby zmienić te pola, przejdź do Ustawienia organizacji (kliknij nazwę organizacji na pasku bocznym, potem Ustawienia organizacji) i przewiń do sekcji Informacje rozliczeniowe.
Saldo organizacji, czyli saldo konta plus saldo bonusowe, spadło do zera lub poniżej podczas codziennego cyklu rozliczeń. W takim przypadku system automatycznie wyłącza wszystkie sieci.
Co zrobić: otwórz Raport salda konta, przejrzyj obciążenia, które doprowadziły do zerowego salda, doładuj saldo i ręcznie ponownie włącz sieci na stronie ustawień każdej sieci.
bieżące saldo konta jest blisko maksymalnego dozwolonego. System ogranicza łączne saldo, więc dostępna kwota doładowania maleje wraz ze wzrostem salda. Jeśli saldo jest już blisko limitu, formularz płatności kartą może pokazywać, że doładowanie jest tymczasowo niedostępne;
bank odrzuca transakcję. Skontaktuj się z bankiem, aby upewnić się, że karta może być używana do płatności międzynarodowych w EUR.
Co zrobić: spróbuj mniejszej kwoty. Jeśli formularz płatności kartą jest niedostępny, skorzystaj z przelewu bankowego lub skontaktuj się z pomocą.
Nie widzę stron rozliczeń ani salda na pasku bocznym
Dzienne obciążenie dotyczy poprzedniego dnia kalendarzowego. Jeśli sieć była włączona choć przez część wczorajszego dnia, dziś i tak zobaczysz obciążenie. Po wyłączeniu sieci następnego dnia możesz jeszcze zobaczyć jedno ostatnie obciążenie.
Co zrobić: to oczekiwane zachowanie. Po ostatecznym obciążeniu nie będzie już nowych naliczeń za tę sieć.
Wysyłka SMS wymaga wystarczającego salda. Jeśli saldo jest zbyt niskie, wysyłka SMS jest blokowana.
Co zrobić: sprawdź saldo i w razie potrzeby doładuj je; sprawdź też Ustawienia powiadomień. Możesz przejść na powiadomienia e-mail — są bezpłatne i bez limitów.
powiadomienia SMS mogą znacząco zwiększyć koszty, zwłaszcza przy dużej liczbie wyzwalanych alertów;
włączonych jest kilka sieci — każda ma osobne dzienne obciążenie;
skończył się okres ważności kodu rabatowego i stawka wróciła do standardowej.
Co zrobić: otwórz Raport salda konta, wybierz odpowiedni miesiąc i rozwiń kategorie Powiadomienia SMS oraz Przetwarzanie sieci, aby zobaczyć poszczególne obciążenia.
System rozliczeń uruchamia się raz dziennie i pobiera opłatę za każdą włączoną sieć za poprzedni dzień kalendarzowy. Dokładna godzina uruchomienia może się nieznacznie różnić, ale obciążenia zawsze dotyczą poprzedniego dnia.
Otwórz Raport salda konta z menu salda na pasku bocznym. W sekcji Historia wydatków widać wszystkie obciążenia i uznania, pogrupowane według kategorii. Kliknij wiersz dowolnej kategorii, aby go rozwinąć i zobaczyć poszczególne wpisy z datami i kwotami.
Nie. Gdy saldo się kończy, sieci są wyłączane i przestają zbierać nowe dane, ale wszystkie wcześniej zapisane dane są przechowywane zgodnie z ustawieniami przechowywania danych Twojej organizacji. Po doładowaniu salda i ponownym włączeniu sieci zbieranie danych zostanie wznowione.
Możesz wyłączać poszczególne sieci w ich ustawieniach. Dla wyłączonych sieci nie nalicza się dziennej opłaty za przetwarzanie. Dane, konfiguracja urządzeń i ustawienia powiadomień pozostają bez zmian. Włącz sieć ponownie w dowolnym momencie, aby wznowić działanie.
Kody rabatowe są stosowane osobno do każdej sieci. Otwórz stronę sieci, kliknij Zastosuj kod rabatowy, wprowadź kod, sprawdź zmianę ceny na stronie potwierdzenia i kliknij Potwierdź. Po zastosowaniu kodu na stronie sieci widoczny jest kod oraz jego wpływ na ceny. Ręcznie zastosowany kod można w każdej chwili usunąć na tej samej stronie.
Dlaczego formularz doładowania pokazuje niższy maksymalny limit niż oczekiwałem?
Maksymalna kwota doładowania to skonfigurowany limit pomniejszony o bieżące saldo konta. Na przykład przy limicie €1 000 i saldzie €800 można doładować maksymalnie €200.
Koszt SMS zależy od kraju numeru odbiorcy. Kwota jest pobierana ze salda w momencie wysłania SMS. Wszystkie takie koszty można zobaczyć w Raporcie salda konta w kategorii Powiadomienia SMS.
Overvis provides REST-like HTTP API with request payload and response encoded in JSON format.
Base API URL is https://ocp.overvis.com/api/v1/. Further documentation will list the requests as
entrypoints with paths that should be concatenated to the base API URL. E.g. API version retrieval
endpoint is /version/, that means, the full URL of the version request should be
https://ocp.overvis.com/api/v1/version/.
All API requests require Content-Type: application/json HTTP header set.
All POST requests require HTTP payload to be a UTF-8 encoded plain-text with semantically-correct
JSON content. Empty payload is not allowed for POST requests, send null if endpoint requires no
data.
All requests return HTTP status code 200 if executed correctly.
5xx status codes represent server-side unexpected errors and are automatically reported to the
developers.
4xx status codes represent errors that are client’s concern and should be dealt with on the
client side. These errors have JSON payload which look like this:
{
"errorCode": "ErrCode",
"errorMessage": "Human-readable error message in english."
Manually updates network fields. This is a low-level endpoint for updating specific fields like
name, description, or connection details without necessarily re-applying a full solution.
Endpoint
POST /net/:netId/change/
Parameters
Path Parameters
netId (number, required): The ID of the network.
Body
All fields are optional:
name (string): Network name.
description (string): Network description.
devicePasswords (string[]): Controller passwords.
controllerModbusUnitId (number): Modbus Unit ID (0-255).
sku (string): Device SKU.
solution (string): Solution type.
connectionType (string): direct, backward, or vpn.
mac (string): MAC address.
ip (string): IP address.
port (number): Port.
connectCode (string): Connect code.
maxInflightRequestsNum (number): Max parallel requests.
Authorization
Permission: manager (edit access to org objects)
Requires a valid session token in the Authorization header.
Response
status: ok.
netSlug: Current slug of the network.
Example Request
{
"name": "Updated Name",
"description": "Manual update"
}
POST /net/:netId/connection-status/ - Get Network Connection Status
Returns specified number of data points for a requested parameters on a given time range.
Endpoint
POST /readings/dispersed/
Parameters
Body
paramIds (integer[], required): List of parameter IDs.
from (string, required): Start date of the check range (ISO 8601).
till (string, required): End date of the check range (ISO 8601).
points (integer, required): Number of points to take in this date range (for each parameter).
Maximum: 1000.
Response
Result is an array of “segment” records. Each record is an array where the first item is a ISO 8601
datetime, and the second item is an array of parameter values during that segment in the order of
paramIds provided.
Returns stored data points for a requested time range for a given parameter.
Endpoint
GET /readings/get/
Parameters
Query Parameters
paramId (integer, required): ID of the parameter.
from (string, optional): Start date of the range (ISO 8601). If omitted, response will contain
last pointsLimit data points up to till date.
till (string, optional): End date of the range (ISO 8601). If omitted, end date will be the
current time.
pointsLimit (integer, optional): Limit on the number of the returned data points. Maximum and
default: 1000.
Response
Result is an array of data points. Each record is an array where the first item is a ISO 8601
datetime, and the second item is the parameter value (number or null). Data points are sorted by
dates in a descending order.
Example Request
GET /readings/get/?paramId=284&from=2020-01-01T00:00:00Z&till=2020-08-17T00:00:00Z&pointsLimit=100
Example Response
[
["2019-07-26T16:28:00Z", 7.0],
["2019-07-26T16:33:42Z", 7.0],
["2019-07-26T16:39:24Z", 7.0]
]
POST /readings/min-max-range/ - Range of Readings Values for a Given Period
Saves the data entered by the user in the visualization.
Endpoint
POST /vis/:visId/data/save/
Parameters
Path Parameters
visId (number, required): ID of the visualization.
Body
code (string, required): Key for the value.
value (string, required): Value to be saved.
Response
Returns an empty object on success.
Example Request
POST /vis/7/data/save/
{
"code": "roomName",
"value": "Room 1"
}
Example Response
{}
Overvis Cloud Documentation
Device Templates Reference
This reference covers the technical specification of the device template Excel file format used for import and export in Overvis Cloud. For a general overview of how templates work, see the Device Templates guide.
Device templates use the Microsoft Excel .xlsx format. Only .xlsx is accepted — older .xls files, CSV, and other formats are not supported.
A template workbook contains two required sheets and two optional sheets. The sheet names are exact and case-sensitive — any unrecognized sheet name causes an import error.
The Info sheet stores device-level metadata and communication defaults. Values are read from fixed cell positions (not by column headers).
Row
Column A (1) — label
Column B (2) — value
Required
1
Manufacturer:
Manufacturer name (up to 200 characters)
No
2
Model:
Template name / device model (1–200 characters)
Yes
3
Device Version:
Version string (up to 50 characters)
No
4
Category:
Category text (up to 200 characters)
No
5
(empty)
6
Read Group Size:
Integer 1–255
Yes
7
Write Function:
normal, always-6, or always-16
Yes
Description is stored in column D (4), starting from row 2. If the description is longer than 32,000 characters, it is split across multiple cells in that column (row 2, row 3, etc.). On import, all cells in column D below row 1 are concatenated.
Template name (row 2) is the primary identifier. Together with manufacturer and version, it forms a unique identity within a scope (global or per-organization). Importing a template with the same name+manufacturer+version as an existing one in your organization replaces the existing template.
Read group size controls how many consecutive Modbus registers Overvis combines into a single read request. A value of 1 reads each parameter individually. Higher values (e.g. 16) batch adjacent registers into fewer requests, which speeds up polling but requires the device to support multi-register reads across that range.
Write function determines which Modbus function code is used when writing parameter values:
Value
Meaning
normal
Overvis chooses automatically — function 06 (Write Single Register) for single-register values, function 16 (Write Multiple Registers) for multi-register values.
The Params sheet defines all device parameters. Row 1 is the header row; data starts from row 2. Columns are matched by header name (not by position), so column order does not matter.
Grouping label (up to 200 characters), e.g. Inputs, Configuration, Status.
Mnemonic
label
Short identifier (up to 20 characters), e.g. T1, P.out. The column can also be named Label.
Description
description
Longer explanation of what this parameter represents.
Units
unitName
Measurement units (up to 20 characters), e.g. °C, kW, bar, %.
Multiplier
multiplier
Scaling factor applied to the raw register value. displayed = raw × multiplier + shift. A value of 1 is treated as “no multiplier.” Not allowed for bit, string, IP address, and MAC address types.
Shift
shift
Offset added after multiplying. A value of 0 is treated as “no shift.” Same type restrictions as multiplier.
Decimal Precision
decimalPrecision
Number of decimal places to display (integer 0–20).
Min
minValue
Minimum expected value (for display and validation).
Max
maxValue
Maximum expected value (for display and validation).
Bit Position
bitPosition
For bit and bits types: which bit within the register to start from (0–15). Required for bit and bits, not allowed for other types.
Bits Num
bitsAmount
For bits type only: how many consecutive bits to extract (1–16). Required for bits, not allowed for other types including bit.
Parameter text fields can be translated into additional languages. Add translation columns by appending a space and a language code to the base column name:
Base column
Translation column examples
Name
Name uk, Name pl, Name ru
Category
Category uk, Category pl, Category ru
Description
Description uk, Description pl, Description ru
Units
Units uk, Units pl, Units ru
Supported language codes: en, uk (Ukrainian), pl (Polish), ru (Russian). English is the base language — the main column values are always English, and en translation columns are not needed.
A translation column requires the corresponding English column to have a non-empty value in the same row. You cannot translate an empty field.
The following types do not support multiplier or shift values: bit, byte-str, word-str, byte-ipaddr, word-ipaddr, byte-macaddr, word-macaddr. Setting a multiplier or shift on these types causes a validation error.
When the Type is enum, the Represent As cell defines mappings from numeric values to display text. The cell must contain multiple lines, each with fields separated by semicolons (;):
<value>;<display text>
<value>;<display text>;<description>
The description is optional. Example cell content (each line in the same cell):
0;Stopped
1;Running
2;Error;Critical fault detected
3;Maintenance;Scheduled service mode
Rules:
English mappings are required — the base Represent As column must be filled.
Each numeric value must be unique within the English mappings.
To provide enumeration mappings in other languages, add columns named Represent As XX where XX is the language code in uppercase:
Represent As UK — Ukrainian
Represent As PL — Polish
Represent As RU — Russian
Each translation column uses the same semicolon-and-newline format as the base column. The numeric values must match the English values exactly — the same set of values, in any order. Example Represent As UK cell:
When the Type is bit, the Represent As cell can contain a system representation code — a short text identifier referencing a built-in bit representation (e.g. showing On/Off or Open/Closed instead of 1/0).
The value must reference an existing system bit representation code. If the code is not recognized, import fails with an error listing the available codes.
This is distinct from enum mappings: the cell contains a plain string (no semicolons or newlines), and it is only valid for bit type parameters.
The optional Visualization sheet contains the HTML/JavaScript source code for an embeddable device visualization. Row 1 is a header; the actual content starts from row 2 in column A (1).
Long content is split across multiple cells (row 2, 3, etc.) at 32,000-character boundaries and concatenated on import.
When the template is applied to a device, the visualization source can contain {{device_id}} and {{network_id}} placeholders, which Overvis replaces with the actual IDs.
Overvis validates the template during import at multiple levels. If any validation fails, the template is not imported, and errors are reported with their sheet name, row, and cell reference.
Each parameter row is validated independently. A row with errors is skipped, but other rows are still validated (all errors are collected and reported).
Templates are always imported into the current organization (never directly to the global library). To make a template global, use the separate “Make global” action in the web interface.
If a template with the same name, version, and manufacturer already exists in the organization, the existing template and all its parameters, translations, and enumeration definitions are replaced with the imported data.
Import is atomic: if any validation error occurs, no changes are made.
Exporting a template produces an .xlsx file with the same structure described above. The exported file can be edited in any spreadsheet application and re-imported.
The export includes:
Info sheet with all device metadata.
Params sheet with all parameters, including any translation columns that have data.
Visualization sheet (only if the template has a device visualization).
Alerts sheet (only if the template has alert YAML).
Exported files use frozen header rows and auto-filters on the Params sheet for easier navigation.
Overvis visualization source code is an HTML snippet. This snippet code is not processed on the
server-side and is embedded inside the Overvis page HTML as-is. It can contain JavaScript inside
<script> tags, CSS inside <style> tags, or SVG images inside <svg> tags. It should not
contain <!...>, <html>, <head>, <body> or other header tags because they are already
present on the Overvis page.
There are several extension tags and attributes that are added by the JavaScript to the Overvis
page for simplifying visualization data binding. The following reference will list all such
additions. Visualization code is not required to use them and can directly call Overvis API
instead.
In the reference below, the following syntax: update-period-sec="{{number}}" means that the
double curly braces should be replaced by the referenced value type. In this example, the correct
usage will be something like this: update-period-sec="60".
After the visualization is loaded, it gathers all used data bindings from the source code and
starts the automatic data refresh process. Visualization data is being refreshed every 10 seconds
by default.
The next refresh cycle doesn’t start before the previous one is finished. The length of the refresh
cycle depends on how many parameters are being read from the devices and the connection quality.
So, if there are many parameter readings to be requested at once from the slow channel, the refresh
cycle may take more time than planned. To optimize the refresh cycle time, prefer loading parameter
values from the Overvis database instead of reading them from the devices directly.
Those functions are added to the global window object and accessible everywhere in the code:
Function
Description
preInitViz(cb)
This function is called after the visualization source code is embedded in the page, but before the references and aliases are being resolved. This function can add additional binds or modify visualization source code. cb is a callback function that should be invoked at the end of preInitVis.
onVizUpdate(data)
This function is invoked after any bound data is received (at least after each refresh cycle). data is an object with references as keys.
writeParamValue(ref, val, cb, refreshAll)
Send parameter value to the device. ref - parameter reference; val - value as a string; cb - a function that should be called after the writing process will be finished; refreshAll - boolean, if true - refresh all data on the visualization, if false - refresh only the changed parameter.
All referenced objects should exist in Overvis. For example, you can’t reference the network by
IP/MAC address if the network with this IP or MAC is not created under your account.
Networks can be referenced in one of the following ways:
By the slug string. Slug is a unique code assigned to each object. It can be taken from the URL of the parameter settings page in Overvis.
~{{alias name string}}
~someParam
Using alias. Alias with this name should be provided by the alias tag in visualization code.
{{device reference}}>{{address}}
12-34-56-78-90-ab>111>123
By the parameter address inside the device. Note, this parameter should exist in the device parameters list in Overvis. {{address}} can also contain additional specifications, see below.
Parameter address has the following extended syntax:
Any container tag in HTML/SVG code has an additional possible attribute:
param-value="{{paramRef}}:{{options}}"
This attribute specifies that the contents of this tag should be replaced by the value of the
parameter referenced by {{paramRef}}. By default, this value will be taken from the Overvis
database of last known parameter values.
{{options}} is a comma-separated list of flags. Currently supported flags:
r - read data directly from the device,
p{{number}} - display data with specified precision.
Also, the following attribute can be used in conjunction with param-value:
param-value-mod="{{evalExpr}}"
It applies the quick mathematical expression evalExpr where the current value will be passed as
x.
Placeholder text loading... will be replaced with the value of parameter 123 of the device 111 in the network 12-34-56-78-90-ab. Value will be taken from the database, so this parameter should be marked as tracked in the system.
<div param-value="12-34-56-78-90-ab>111>123:r" />
The value of the parameter will be read from the device on each refresh. The parameter can be untracked.
By default, the value of the parameter is taken from the Overvis database, not read from the
device. This makes visualization refresh much faster, but it has the following consequences:
Only tracked parameter values are stored in the database.
The update interval of the value depends on the update of the device background readings
(specified in the device settings) and not on the visualization refresh period.
If there is no network connection, the last known value will still be displayed.
If the parameter is untracked or has never been read yet, NOLR will be displayed instead.
If you want to perform an actual reading of the device parameter, set the :r option at the end.
In this case:
It doesn’t matter if the parameter is tracked or untracked.
The value of the parameter is read from the device after each visualization refresh cycle
(usually every 10s).
If the network connection is missing, NORV is displayed.
Several special codes are returned by the server on various exceptions. You may see them instead of
the parameter value:
NON - parameter network does not exist.
NOP - parameter does not exist.
NOLR - no last reading for the parameter in the database (parameter has never been read). That
usually means that this parameter is untracked. Mark it as tracked or use real-time value
reading.
NORV - error reading parameter value from the device. Try reading it on the device parameters
list page to see the actual error.
React on the parameter value change: on-param-value="..." attribute
This attribute toggles the property or style specified by {{property}} between {{valueOn}} and
{{valueOff}} depending if the parameter referenced by {{paramRef}} satisfies the
{{condition}}.
{{condition}} can be one of the following:
>value
<value
=value
!=value
>=value
<=value
or {evalExpr} where evalExpr in curly braces can be any boolean JS expression with current
parameter value provided as x. See examples below.
If the condition is satisfied, the property and the style by the name provided by {{property}}
will be set to {{valueOn}}. Otherwise it will be set to {{valueOff}}.
{{options}} is a comma-separated list of flags. Currently supported flags:
r - read data directly from the device. By default it is taken from Overvis database of last
known parameter values.
Set text style color to red if the parameter value is greater than 10. Otherwise - green. Value is taken from the Overvis database, so the parameter should be tracked.
Text "alert!" will be visible if the parameter value is less than 20. The value is read from the device in real-time. By default (until the value is loaded), the text is hidden.
This attribute toggles the property or style specified by {{property}} between {{valueOn}} and
{{valueOff}} depending if the network referenced by {{netRef}} has connection or not.
If the parameter {{paramRef}} has the value different from {{defaultValue}} it should be set
to {{defaultValue}}, otherwise {{valueOn}}.
Example: <button on-click="toggle-param:12-34-56-78-90-ab>1>123:0:1:g">Toggle power</button> -
toggle parameter 123 between 0 and 1, where 0 is the default value. After the toggle, full
visualization refresh is done (because of the :g option at the end).
edit-param:{{paramRef}}:{{options}}
Open the dialog window to edit and save the value of the parameter.
Add {{amount}} to the value of the parameter {{paramRef}} and save the new value. Amount can
be negative. The parameter is refreshed before being incremented and written to the device.
edit-visdata:{{key}}
Open the dialog window to edit and save the visualization string with the key {{key}}. See
visualization strings table.
{{options}} is a comma-separated list of flags. Currently supported flags:
g - after the action is completed, do a complete refresh of all visualization data. If omitted,
by default - only the affected parameters will be refreshed.
An additional tag can be used anywhere in the code:
<aliasname="{{aliasName}}"... />
Alias tag should contain name attribute which specifies the name of the alias and one of the
following attributes which specifies the alias target:
network="{{networkRef}}"
device="{{deviceRef}}"
param="{{paramRef}}"
vis="{{visualizationRef}}"
Aliases are used when the object has to be referenced several times in the code. It helps to make
the references more understandable by giving them names. Also, it allows to quickly change the
target object, for example, if the network controller was replaced and the network MAC was changed.
Aliases can be used in references by specifying alias name after ~ (tilde symbol). Also, aliases
can be used inside other aliases, e.g. network alias can be used inside the device alias.
Visualizations can store string values to the Overvis database as key-value pairs. All stored
values are loaded during the visualization start-up if use-vis-data="yes" specified in
visualization settings tag.
To edit the value, use Overvis API. Also, the value can be edited by the user through the dialog
window. To open the dialog window, add the on-click="edit-visdata:{{key}}" attribute to the
button.
The following attribute allows you to use stored strings.
Text replacement: text-replacement="..." attribute
This example shows the room name as "Main room" by default, but also allows to edit it by
clicking on the "Edit". Edit will persist between page refreshes and different accounts accessing
this visualization.
A device template can include an alert template — a YAML definition of alerts that Overvis creates automatically when the template is applied to a device. This lets you ship standard monitoring rules (temperature limits, connection loss detection, etc.) together with the parameter configuration.
When applying a template, the user controls how alerts are handled — add new alerts, replace existing ones, or skip alert creation entirely. See Applying a template — Apply options for details. After creation, the alerts are independent and can be freely customized.
Documentation bellow assumes that you are changing one of the templates owned by your organization. If you want to modify the global template, accessible to all Overvis users, you have to copy it under your account. To do this, just download the template as an Excel file and upload it to your templates.
Manually created templates can be found in the local device template library. To access it, click on the “Your templates” link under the “Templates” section in the navigation.
Find the device template you want to modify and click the gear icon on the left to access the template settings.
On the settings page, scroll down until you find the “Alarms template YAML” textbox. Put the template code inside that box. The structure of this YAML is described in a later section of this document.
Save the changes. If the alerts template interpreter will encounter any errors it will report the details below the field.
description: "This alert tracks the value of the input 1. If value is less than 5 or larger than 10 during 5 minutes, SMS will be sent to the default phone. Also, if the default email address is specified, email will be sent right after the event starts and resolves."
level: "warning"
conditions_logic: "any"
conditions:
- param: "150h"
condition: "<"
value: "5.0"
- param: "150h"
condition: ">"
value: "10.0"
actions:
- kind: "sms"
recipient: "-"
stage: "init"
timeout_minutes: 5
- kind: "email"
recipient: "-"
stage: "init"
- kind: "email"
recipient: "-"
stage: "resolved"
- name: "No connection!"
description: "This alert checks connection to the network by verifying if the tracked firmware version parameter is reading correctly. If there was no reading during 5 minutes, Voice message will be sent to the default phone number."
Each event should contain one or more conditions (specified in the “conditions” field). Conditions determine when this event starts and resolves. Each condition is described as an object with following fields:
Name
Required
Type
Description
param
yes
string
Parameter address this condition will check. Syntax is described below. Parameter with this address should be listed in the template. Also, parameter should be tracked for this condition to work.
condition
yes
string
Logical operator that will compare parameter reading and the condition value specified in the “value” field. Allowed operators: >, >=, <, <=, =, !=, err. err checks for reading errors and doesn’t require “value” to compare to.
value
yes (if condition is not err)
string/number
Value to compare parameter reading to.
param is a string in one of the following formats:
<register address><register kind>
<register address>.<bit address><register kind>
Where “register kind” is one of:
h - holding register
i - input register
d - discrete input
c - coil
Examples of the condition objects:
YAML
Condition will be enabled if…
{param: "123h", condition: ">=", value: "10.5"}
Value of the parameter with the holding register address 123 is larger or equal 10.5 (comparison takes in account parameter multiplier and parameter type transformation).
{param: "123.5i", condition: "=", value: 1}
Value of the parameter that corresponds to the bit #5 of the input register address 123 is equal to 1.
{param: "1c", condition: "err"}
Reading of a parameter with the coil address 1 resulted in an error (either no connection, or MODBUS exception during parameter reading).
Each event should have one or more actions (specified in the “actions” field). Actions determine how the system should behave during each stage of the event. Each action corresponds to the one of the four “stages”:
init - event just started and is active.
not_confirmed - event was not confirmed during specified period of time. Confirmation period is specified in the action’s timeout field.
confirmed - event was confirmed by user (by SMS or clicking on the link in the notification email).
resolved - event resolved and is not active anymore.
Each action is described as an object with the following fields:
Name
Required
Type
Description
kind
yes
string
Kind of the action. Valid values: sms, email, call.
recipient
yes
string
Recipient email address or phone number (depends on the action kind). - value (minus sign) corresponds to the default email or phone.
stage
yes
string
Stage of the event when this action will be executed. Allowed values: init, not_confirmed, confirmed, resolved (see above).
timeout_minutes
no
number
Timeout in minutes before executing this action (positive integer). If an event leaves the appropriate stage during this timeout (for example “not confirmed” event resolves or being confirmed), action is never executed.
There are two ways to attach alert YAML to a device template:
In the Excel file — add an Alerts sheet to the template workbook. Row 1 is a header; the YAML goes in column A starting from row 2. See the Device Templates Reference — Alerts sheet for details.
In the web interface — open the template settings page and enter the YAML in the “Alarms template YAML” text field. Errors are reported below the field on save.
