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.

Co zawiera szablon

Nazwy pól

Poniższe etykiety punktorów używają angielskich nazw jak w edytorze szablonów, imporcie z Excela i YAML (np. Name, Read group size), aby pliki i narzędzia pozostały zgodne.

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 i organizacyjne

Szablony istnieją na dwóch poziomach:

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

Przeglądanie szablonów

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:

Klonowanie szablonu globalnego

Jeśli szablon globalny jest bliski temu, czego potrzebujesz, ale wymaga zmian — innej skali, dodatkowych parametrów, dostosowanych alertów — sklonuj go:

1. Otwórz szablon globalny.
2. Kliknij Kopiuj szablon.
3. 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.

Tworzenie szablonów

Istnieją dwa sposoby utworzenia szablonu organizacyjnego: zapis z istniejącego urządzenia lub import z pliku Excel.

Z istniejącego urządzenia

Jeśli urządzenie zostało już skonfigurowane ręcznie — wszystkie parametry, jednostki, flagi śledzenia itd. — możesz zapisać tę konfigurację jako szablon:

1. Otwórz stronę urządzenia.
2. Kliknij Zapisz jako szablon.
3. 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.
4. 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.

Z pliku Excel

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.

1. Przejdź do Twoje szablony.
2. Kliknij Załadować szablon.
3. Prześlij plik .xlsx.
4. Overvis waliduje strukturę i treść pliku. Błędy są zgłaszane wraz z nazwą arkusza, numerem wiersza i odwołaniem do komórki.
5. 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ń.

Edycja szablonów

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.

Eksport szablonów

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.

Stosowanie szablonu do urządzenia

Szablony można stosować przy tworzeniu nowego urządzenia lub w dowolnym momencie do istniejącego.

Podczas tworzenia urządzenia

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.

Do istniejącego urządzenia

1. Otwórz stronę urządzenia.
2. Kliknij Zastosuj szablon (akcja na stronie urządzenia — pełny tytuł formularza to również Zastosuj szablon).
3. Wybierz szablon (z organizacji lub biblioteki globalnej).
4. Wybierz język nazw parametrów (jeśli szablon zawiera tłumaczenia).
5. Skonfiguruj opcje stosowania, zaznaczając odpowiednie pola wyboru (poniżej).
6. Kliknij Zapisz zmiany.

Opcje stosowania

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.

Szczegóły szablonu

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

Tłumaczenia

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.

Parametry wyliczeniowe

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.

Więcej o działaniu parametrów wyliczeniowych: Sieci, urządzenia i parametry — Parametry wyliczeniowe.

Uprawnienia

Działanie	Wymagana rola
Przeglądanie, podgląd i eksport szablonów	Dowolny członek organizacji
Stosowanie szablonu do urządzenia	Menedżer techniczny lub wyżej
Import, edycja, usuwanie lub klonowanie szablonów	Menedżer techniczny lub wyżej
Tworzenie szablonu z urządzenia	Menedżer techniczny lub wyżej
Udostępnij szablon globalnie (do biblioteki globalnej)	Superużytkownik

Rozwiązywanie problemów

Import kończy się błędami walidacji

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.

Alerty nie są tworzone ze szablonu

• Sprawdź składnię YAML alertów — nieprawidłowy YAML blokuje tworzenie alertów. Pełną specyfikację podaje Referencja szablonów alertów.
• 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

Po zastosowaniu szablonu Overvis wysyła zaktualizowaną konfigurację do operatora komunikacji. Jeśli urządzenie nie jest odpytywane:

• Sprawdź status połączenia urządzenia — brama musi być online, aby operator otrzymał nową konfigurację.
• Poczekaj kilka sekund — operator może potrzebować chwili na zastosowanie konfiguracji i rozpoczęcie odpytywania.
• Sprawdź listę parametrów — upewnij się, że szablon dodał co najmniej jeden śledzony parametr. Parametry nieśledzone nie są odpytywane.

Szablon nie pojawia się po imporcie

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

Częste pytania

Czy mogę zastosować wiele szablonów do tego samego urządzenia?

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.

Jak zaktualizować szablon na wielu urządzeniach?

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.

Dalsza lektura

• 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.
• Sieci, urządzenia i parametry — jak działają parametry, śledzenie i ustawienia komunikacji.
• Podłączanie urządzeń — konfiguracja sterowników i okablowanie urządzeń Modbus.
• Przegląd — monitorowanie parametrów i widżetów.