Модуль Получение значения из списка по ключу для программ-логгеров

Последняя версия: 5.0.1 build 1126. November 28, 2025.

Data From List - это плагин для преобразования данных, который используется в ситуациях, когда нужно заменить код на понятное текстовое значение. Он позволяет сопоставлять числовые или короткие текстовые идентификаторы с ясными описаниями без написания скриптов. Например, вместо вывода в отчет кода ошибки "E103" вы можете сохранять и показывать текст "Перегрев, аварийный режим". Такой подход делает журналы событий более понятными, ускоряет анализ инцидентов и снижает риск неправильного толкования данных при обращениях в службу поддержки или на аудитах.

Плагин работает с переменными подготовленными логгером, и заменяет их значения в соответствии со заданными правилами. Список соответствий можно хранить прямо в конфигурации модуля или во внешнем текстовом файле, который плагин отслеживает и автоматически перезагружает при изменении. Это удобно в средах, где коды и их описания часто изменяются или дополняются.

Скачать  | PDF руководство

Настройка плагина "Data From List" проста. Для каждой переменной, которую нужно преобразовать, вы задаете три параметра: имя исходной переменной, список правил сопоставления (или путь к файлу со списком) и необязательное имя целевой переменной. Правило сопоставления имеет вид "ключ=текстовое_значение". Например, вы можете задать правила "1=OK|2=Warning|3=Critical". Когда приходят новые данные, плагин сравнивает текущее значение исходной переменной (ключ) с левой частью каждого правила ("1", "2", "3" и т.д.). При совпадении значение заменяется правой частью правила ("OK", "Warning", "Critical"). Если вы указываете целевую переменную, новое значение записывается в нее, а исходная переменная остается без изменений. Это удобно, когда нужно сохранить и исходный код, и понятное описание в экспортируемых данных.

Внешний файл списка - это простой текстовый файл, в котором на одной строке хранится одно правило сопоставления. Например:

0=OK
1=Warning
2=Critical
E01=Sensor fault
E103=Overtemperature alarm

Плагин "Data From List" интегрируется с любыми нашими логгерами. Рассмотрим промышленный контроллер, который каждую секунду отправляет строку данных по последовательному порту:

2025-01-02 08:00:00;CH1;E103;45.6

В этом примере логгер разбирает строку с помощью модуля-парсера на переменные:

DATE_TIME_STAMP = 2025-01-02 08:00:00
Channel = CH1
ErrorCode = E103
Temperature = 45.6

Вы настраиваете плагин со списком сопоставления для переменной ErrorCode и сохраняете результат в переменную ErrorDescription:

E000=Нет ошибки
E101=Сенсор отключен
E102=Низкое напряжение
E103=Перегрев
E200=Требуется калибровка

Итоги

Плагин Data From List подходит для многих практических задач. Вы можете сопоставлять уровни тревог, типы устройств, идентификаторы пользователей, коды продукции и другие структурированные идентификаторы с описаниями, которые удобны для конечных пользователей. При этом короткие коды остаются для компактного хранения, а в просмотре и при экспорте данных отображаются понятные текстовые значения.

Скачать  | PDF руководство

Как включить модуль

На рисунке ниже вы можете увидеть, как включить данных модуль в настройках программы на странице "Модули".

Как настроить модуль

На рисунке ниже показан пример настроек модуля. Вы можете ознакомиться с файлом справки по ссылке выше, для получения более подробной информации.