Шаблони пристроїв

Для кожного пристрою Modbus потрібен набір параметрів, перш ніж Overvis зможе зчитувати з нього дані — адреси регістрів, типи значень, назви, одиниці, прапорці відстеження тощо. Налаштовувати це вручну для лічильника на 50 регістрів трудомістко; для двадцяти однакових лічильників — непрактично.

Шаблони пристроїв саме це й вирішують. Шаблон — це збережена багаторазова конфігурація параметрів для конкретної моделі пристрою. Виберіть шаблон під час створення пристрою (або застосуйте пізніше), і Overvis автоматично налаштує всі параметри, віджети панелі моніторингу, візуалізації та сповіщення.

Що містить шаблон

Назви полів

Нижче в переліках використано англійські назви, як у редакторі шаблонів, імпорті з Excel і YAML (наприклад Name, Read group size), щоб файли й інструменти залишалися сумісними.

Шаблон пристрою зберігає два типи інформації:

Налаштування рівня пристрою — метадані й налаштування зв’язку за замовчуванням:

• Name, manufacturer і version — ідентифікують шаблон (наприклад PAC3200, Siemens, 1.0). Шаблон унікально ідентифікується в межах своєї області (глобальної або організації) комбінацією name, manufacturer і version.
• Category — довільне текстове групування (наприклад Temperature controller, Energy meter).
• Read group size — скільки послідовних регістрів об’єднати в один запит Modbus на читання (1–255, типово 1).
• Write function — який код функції запису Modbus використовувати: normal (автовибір за кількістю регістрів), always-6 (завжди код 06 — Write Single Register) або always-16 (завжди код 16 — Write Multiple Registers).
• Description — необов’язкові примітки про пристрій або шаблон.

Визначення параметрів — по одному запису на кожен регістр або біт, який надає пристрій:

• Name — зрозуміла назва (наприклад Supply temperature).
• Address — номер регістра Modbus (0–65535).
• Register kind — holding, input, coil або discrete-input.
• Value type — як інтерпретувати сирі дані регістра. Overvis підтримує широкий діапазон типів: знакові та беззнакові цілі різної ширини (8/16/32/48/64 біт), числа з плаваючою комою (32 і 64 біт), BCD, витяг бітів і груп бітів, рядки, IP-адреси, MAC-адреси та значення переліку. Багаторегістрові типи можуть використовувати big-endian, byte-swapped або word-swapped порядок байтів. Регістри coil і discrete-input мають використовувати тип значення bit.
• Units — одиниці вимірювання (°C, кВт, бар тощо).
• Category та label — для групування й короткого позначення в інтерфейсі.
• Multiplier та shift — лінійне масштабування сирого значення: displayed = raw × multiplier + shift. Недоступно для типів bit, string, IP address і MAC address.
• Decimal precision — кількість десяткових знаків для відображення (0–20).
• Bit position (0–15) та bits amount (1–16) — для типів значень bit і bits: які біти в регістрі витягувати.
• String length — для типів byte-str і word-str: кількість символів (1–255).
• Is tracked — чи зберігає Overvis історичні зчитування для цього параметра.
• Is programmable — чи можна записувати значення параметра з інтерфейсу.
• Read as group — чи включати цей параметр у групові читання.
• Auto-add widget — чи створювати віджет панелі моніторингу для цього параметра під час застосування шаблону.
• Enumeration mappings — для параметрів типу enum таблиця відповідності числових значень людинозрозумілому тексту (наприклад 0 → Off, 1 → On, 2 → Error).
• Min/max values — очікуваний діапазон значень для перевірки та відображення.

Необов’язкові додатки:

• Шаблони сповіщень — попередньо задані сповіщення у форматі YAML. Після застосування шаблону Overvis може створити сповіщення автоматично (наприклад «надіслати лист, коли температура перевищить 80°C»). Див. Довідник шаблонів сповіщень щодо синтаксису YAML.
• Візуалізація пристрою — вбудовувана візуалізація (HTML/JS), яка додається до сторінки пристрою.
• Переклади — назви параметрів, описи, категорії, одиниці та підписи переліку кількома мовами (англійська, українська, польська, російська).

Глобальні шаблони та шаблони організації

Шаблони існують на двох рівнях:

Overvis підтримує глобальні шаблони; вони доступні всім користувачам. Вони охоплюють поширені промислові пристрої — контролери, лічильники енергії, ПЛК, датчики та шлюзи. Редагувати глобальні шаблони не можна, але їх можна клонувати до своєї організації для налаштування.

Шаблони організації належать конкретній організації. Їх бачать лише учасники цієї організації. Такі шаблони можна вільно створювати, редагувати, клонувати, видаляти та експортувати.

Перегляд шаблонів

У веб-інтерфейсі Overvis перейдіть до Шаблони в лівій боковій панелі:

• Ваші шаблони показує шаблони, що належать поточній організації.
• Глобальні шаблони показує спільну бібліотеку.

У обох виглядах відображаються назва шаблону, виробник, версія та кількість параметрів (відстежувані та програмовані). Натисніть шаблон, щоб побачити повний список параметрів і налаштування.

Ваші шаблони перелічує шаблони, якими володіє ваша організація або які ви клонували:

Глобальні шаблони перелічує спільну бібліотеку, яку підтримує Overvis:

Клонування глобального шаблону

Якщо глобальний шаблон близький до потрібного, але потребує змін — інше масштабування, додаткові параметри, скориговані сповіщення — клонуйте його:

1. Відкрийте глобальний шаблон.
2. Натисніть Копіювати шаблон.
3. Клон з’являється у шаблонах вашої організації з тими самими параметрами, готовий до редагування.

Якщо шаблон з такою самою назвою вже існує, клон створюється з числовим суфіксом (наприклад PAC3200 (1)). Таблиці відповідності переліку та переклади повністю копіюються в клон.

Створення шаблонів

Є два способи створити шаблон організації: зберегти з наявного пристрою або імпортувати з файлу Excel.

З наявного пристрою

Якщо ви вже налаштували пристрій вручну — задали всі параметри, одиниці, прапорці відстеження тощо — можна зберегти цю конфігурацію як шаблон:

1. Відкрийте сторінку пристрою.
2. Натисніть Зберегти як шаблон.
3. Введіть назву шаблону (обов’язково). Форма запитує лише назву; Overvis копіює всі параметри, налаштування регістрів, відображення переліку, read group size, write function і метадані пристрою в новий шаблон.
4. Натисніть Створити шаблон.

Новий шаблон з’являється в бібліотеці вашої організації з тими самими параметрами, налаштуваннями регістрів і відображеннями переліку, що й пристрій. Назву, виробника, версію, категорію й опис можна змінити пізніше на сторінці налаштувань шаблону.

З файлу Excel

Для нових моделей пристроїв або коли потрібен повний контроль над кожним полем створіть шаблон як файл Excel .xlsx і імпортуйте його.

1. Перейдіть до Ваші шаблони.
2. Натисніть Завантажити шаблон.
3. Завантажте файл .xlsx.
4. Overvis перевіряє структуру файлу та вміст. Якщо є помилки, вони показуються з назвою аркуша, рядком і посиланням на комірку.
5. У разі успіху шаблон додається до бібліотеки вашої організації.

Якщо в організації вже є шаблон з тією самою назвою, версією та виробником, імпорт замінює його — старий шаблон видаляється, новий займає його місце.

Файл Excel має містити аркуш Info та аркуш Params. Необов’язкові аркуші: Visualization (вихідний код візуалізації пристрою) та Alerts (YAML шаблону сповіщень). Інші назви аркушів заборонені. Повну специфікацію див. у Довіднику шаблонів пристроїв.

Редагування шаблонів

Після створення або клонування шаблону можна редагувати його метадані (name, manufacturer, version, category і description) на сторінці налаштувань шаблону. На сторінці налаштувань також є поле Шаблон сповіщень у форматі YAML:, де можна додавати або редагувати визначення сповіщень без повторного імпорту Excel.

Щоб змінити окремі визначення параметрів, експортуйте шаблон у Excel, внесіть зміни в таблицю та імпортуйте знову.

Експорт шаблонів

Будь-який шаблон — глобальний або організації — можна експортувати як файл .xlsx. Експортований файл має ту саму структуру, що й формат імпорту, тож можна виконати цикл: експорт → редагування в таблиці → повторний імпорт.

Застосування шаблону до пристрою

Шаблон можна застосувати під час створення нового пристрою або до наявного пристрою в будь-який час.

Під час створення пристрою

Під час додавання пристрою до мережі виберіть шаблон у списку. Пристрій буде створено з усіма заздалегідь налаштованими параметрами шаблону. Overvis записує, який шаблон використано, тож на сторінці пристрою видно початковий шаблон.

До наявного пристрою

1. Відкрийте сторінку пристрою.
2. Натисніть Застосувати шаблон (дія на сторінці пристрою — повна назва форми також Застосувати шаблон).
3. Виберіть шаблон (з організації або глобальної бібліотеки).
4. Виберіть мову для назв параметрів (якщо в шаблоні є переклади).
5. Налаштуйте опції застосування, позначаючи потрібні прапорці (див. нижче).
6. Натисніть Зберегти зміни.

Опції застосування

Під час застосування шаблону ви керуєте кількома налаштуваннями:

Параметри:

• Параметри шаблону зіставляються з наявними параметрами пристрою за композитним ключем register address, register kind, bit position та bits amount. Якщо відповідний параметр на пристрої вже є, він оновлюється на місці. Якщо ні — створюється новий параметр.
• Видалити параметри пристрою, які відсутні в шаблоні — за бажанням видалити параметри пристрою, для яких немає відповідника в шаблоні. Корисно при заміні одного шаблону іншим.

Сповіщення:

• Додати сповіщення із шаблону — основний прапорець (типово ввімкнено). Якщо позначено, Overvis створює сповіщення з YAML шаблону. Два додаткові вкладені прапорці діють лише коли основний увімкнено:
  • Замінити наявні сповіщення, представлені в шаблоні — видалити наявні сповіщення, що збігаються з визначенням у шаблоні, потім додати сповіщення з шаблону (чисте повторне застосування для цих визначень).
  • Видалити сповіщення, пов’язані з цим пристроєм, які відсутні в шаблоні — видалити наявні сповіщення, яких немає в шаблоні.
• Якщо позначено лише Додати сповіщення із шаблону, сповіщення шаблону додаються поряд із наявними.
• Якщо ввімкнено лише перший вкладений прапорець, застосовується додати й видалити представлені. Якщо лише другий — додати й видалити відсутні.
• Якщо ввімкнено обидва вкладені прапорці, усі наявні сповіщення видаляються, потім додаються сповіщення з шаблону.
• Зніміть Додати сповіщення із шаблону, щоб пропустити створення сповіщень (вкладені прапорці мають бути вимкнені).

Віджети панелі моніторингу:

• Додати віджети із шаблону на панель моніторингу — основний прапорець (типово ввімкнено). Якщо позначено, Overvis створює віджети панелі моніторингу для параметрів із позначкою auto-add widget у шаблоні.
• Додатковий вкладений прапорець Видалити віджети пристрою, які відсутні в шаблоні — прибирає віджети панелі моніторингу для параметрів, які не відповідають рядку шаблону з увімкненим auto-add widget (зокрема для параметрів без прив’язки до застосованого шаблону).
• Зніміть Додати віджети із шаблону на панель моніторингу, щоб пропустити створення віджетів (вкладений прапорець має бути вимкнений).

Візуалізації:

• Створити візуалізацію пристрою з шаблону — основний прапорець (типово ввімкнено). Якщо в шаблоні є візуалізація пристрою, вона додається до пристрою.
• Вкладений прапорець Видалити наявні візуалізації пристрою (типово ввімкнено): коли обидва увімкнено, будь-яка наявна візуалізація замінюється версією з шаблону.
• Якщо позначено лише Створити візуалізацію пристрою з шаблону, додається візуалізація з шаблону без видалення наявних.
• Зніміть Створити візуалізацію пристрою з шаблону, щоб пропустити створення візуалізації (Видалити наявні візуалізації пристрою має бути вимкнено).

Після застосування Overvis оновлює конфігурацію пристрою на операторі зв’язку, тож опитування починається одразу з новими параметрами.

Деталі шаблону

Натисніть будь-який шаблон, щоб побачити повні деталі: налаштування рівня пристрою, повний список параметрів з адресами, типами значень, прапорцями відстеження та відображеннями переліку.

Переклади

Шаблони підтримують багатомовні назви параметрів, описи, категорії, одиниці та підписи переліку. Базова мова завжди англійська. Додаткові переклади (українська, польська, російська) можна включити в файл Excel або керувати ними в налаштуваннях шаблону.

Під час застосування шаблону ви вибираєте мову. Overvis підставляє переклади для цієї мови до назв параметрів та інших текстових полів. Якщо для поля немає перекладу, використовується англійське значення.

Параметри переліку

Деякі параметри пристрою представляють дискретні стани, а не безперервні значення — режими роботи, коди помилок, прапорці статусу. Шаблони обробляють їх типом значення enum.

Відображення переліку визначає, якому числовому значенню регістра відповідає який текст. Наприклад, регістр статусу може мати відображення 0 → Stopped, 1 → Running, 2 → Error, 3 → Maintenance.

Відображення переліку задаються для кожного параметра в шаблоні й можуть містити переклади. Після застосування шаблону з параметрами enum Overvis створює відображення автоматично, тож на панелі моніторингу та в поданнях параметрів показуються текстові мітки замість сирих чисел.

Докладніше про роботу параметрів переліку див. Мережі, пристрої та параметри — Параметри переліку.

Права доступу

Дія	Потрібна роль
Перегляд і експорт шаблонів	Будь-який учасник організації
Застосування шаблону до пристрою	Технічний менеджер або вище
Імпорт, редагування, видалення, клонування шаблонів	Технічний менеджер або вище
Створення шаблону з пристрою	Технічний менеджер або вище
Зробити шаблон глобальним (додати до глобальної бібліотеки)	Суперкористувач

Усунення несправностей

Імпорт не вдається через помилки валідації

Під час імпорту шаблону з Excel Overvis перевіряє структуру файлу та кожне значення поля. Поширені причини помилок валідації:

• Відсутні обов’язкові аркуші — файл має містити аркуші Info та Params. Будь-який аркуш з невідомою назвою спричиняє помилку.
• Відсутні обов’язкові поля на аркуші Info — read group size і write function мають бути на аркуші Info.
• Некоректний тип значення або тип регістра — переконайтеся, що стовпці Type та Register Kind містять точні значення з Довідника шаблонів пристроїв.
• Некоректний тип значення для coil/discrete-input — регістри coil і discrete-input мають використовувати тип значення bit. Інші типи заборонені.
• Multiplier і shift для несумісних типів — типи bit, string, IP address і MAC address не підтримують multiplier і shift. Установіть 1 і 0 (або залиште порожнім).
• Поля бітів для небітових типів — bit position і bits amount слід задавати лише для типів значень bit і bits.
• Перелік без відображень — параметри з типом значення enum мають містити принаймні одне відображення в стовпці Represent As.
• Невідповідність перекладів переліку — якщо відображення переліку перекладені, кожна мова має мати однакову кількість відображень з тими самими числовими значеннями.

Повідомлення про помилку містить назву аркуша, номер рядка та посилання на комірку, щоб знайти проблему.

Параметри не оновлюються після застосування шаблону

Якщо застосування шаблону не оновлює наявні параметри, як очікувалося:

• Зіставлення відбувається за адресою та типом регістра, а не за назвою параметра. Параметр шаблону оновлює наявний параметр пристрою лише коли збігаються адреса регістра, тип регістра, bit position і bits amount. Якщо вони відрізняються (наприклад, ви змінили адресу в шаблоні), старий параметр лишається й створюється новий.
• Перевірте дублікати адрес — якщо на пристрої два параметри з однаковою адресою та типом регістра, поведінка зіставлення може бути неочікуваною. Приберіть дублікати перед застосуванням.

Сповіщення не створюються з шаблону

• Перевірте синтаксис YAML сповіщень — некоректний YAML блокує створення сповіщень. Повну специфікацію див. у Довіднику шаблонів сповіщень.
• Переконайтеся, що параметри існують — кожна умова сповіщення посилається на параметр за адресою та типом регістра. Якщо параметра, на який посилається умова, немає в шаблоні, сповіщення не створюється.
• Перевірте опції застосування — переконайтеся, що в формі застосування увімкнено Додати сповіщення із шаблону (а також що YAML сповіщень і посилання на параметри коректні).

Пристрій не опитується після застосування шаблону

Після застосування шаблону Overvis надсилає оновлену конфігурацію на оператор зв’язку. Якщо пристрій не опитується:

• Перевірте стан підключення пристрою — шлюз має бути онлайн, щоб оператор отримав нову конфігурацію.
• Зачекайте кілька секунд — оператору може знадобитися час, щоб застосувати конфігурацію й почати опитування.
• Перевірте список параметрів — переконайтеся, що шаблон додав принаймні один відстежуваний параметр. Не відстежувані параметри не опитуються.

Шаблон не з’являється після імпорту

• Перевірте наявність помилок — якщо на сторінці імпорту немає помилок, але шаблон не з’являється, спробуйте оновити сторінку.
• Перевірте правильну організацію — шаблони обмежені поточною організацією. Переконайтеся, що переглядаєте шаблони потрібної організації.
• Заміна за збігом назви — якщо шаблон з такою самою назвою, виробником і версією вже існував, його було замінено. Шаблон є, але старий вміст перезаписано.

Поширені запитання

Чи можна застосувати кілька шаблонів до одного пристрою?

Так. Шаблони можна застосовувати послідовно. Кожне застосування об’єднує або замінює параметри згідно з логікою зіставлення (адреса, тип регістра, bit position, bits amount). Щоб об’єднати параметри з двох шаблонів, застосуйте перший, потім другий без увімкнення Видалити параметри пристрою, які відсутні в шаблоні.

Що відбувається з наявними параметрами під час застосування шаблону?

Типово наявні параметри зберігаються. Параметри, що збігаються з параметром шаблону (за адресою, типом регістра, bit position і bits amount), оновлюються налаштуваннями шаблону. Параметри шаблону без відповідника додаються як нові. Увімкніть Видалити параметри пристрою, які відсутні в шаблоні, щоб видалити незіставлені параметри пристрою.

Як оновити шаблон на багатьох пристроях?

Масового повторного застосування немає. Щоб оновити всі пристрої, що використовують шаблон, імпортуйте оновлений шаблон, потім застосуйте його до кожного пристрою окремо. Використовуйте Видалити параметри пристрою, які відсутні в шаблоні, якщо потрібно, щоб кожен пристрій точно відповідав шаблону.

Чи можна ділитися шаблонами між організаціями?

Ні, не напряму. Шаблони належать одній організації або глобальній бібліотеці. Щоб поділитися шаблоном, експортуйте його як .xlsx і імпортуйте в іншу організацію. Глобальна бібліотека спільна для всіх організацій, але змінювати її можуть лише суперкористувачі.

У чому різниця між глобальними шаблонами та шаблонами організації?

Overvis підтримує глобальні шаблони: вони доступні всім і лише для читання. Шаблони організації належать вашій організації, приватні для учасників і їх можна вільно редагувати. Клонуйте глобальний шаблон до своєї організації, якщо потрібні зміни.

Чи можна редагувати окремі параметри в шаблоні без повторного імпорту?

Ні. Веб-інтерфейс дозволяє редагувати лише метадані шаблону (name, manufacturer, version, category, description) та YAML сповіщень. Щоб змінити визначення параметрів, експортуйте шаблон у Excel, відредагуйте таблицю та імпортуйте знову.

Що буде, якщо видалити шаблон, з якого створювали пристрої?

Нічого не ламається. Пристрої зберігають параметри й працюють як раніше. Посилання пристрою на шаблон очищається, але параметри й налаштування не видаляються.

Додаткові матеріали

• Довідник шаблонів пристроїв — повна технічна специфікація формату Excel, усі підтримувані типи значень, синтаксис YAML сповіщень і правила валідації.
• Мережі, пристрої та параметри — як працюють параметри, відстеження та налаштування зв’язку.
• Підключення обладнання — налаштування контролерів і підключення пристроїв Modbus.
• Огляд — моніторинг параметрів і віджетів.