Table of Contents

Система интеграции ЛЭРС УЧЁТ и PMACPlus

Система интеграции ЛЭРС УЧЁТ и PMACPlus (далее модуль PMACToLers) предназначена для импорта данных из .csv файлов полученных из программы PMAC Plus в систему диспетчеризации ЛЭРС УЧЁТ.

Модуль PMACToLers представляет собой службу Windows с автозапуском, которая осуществляет мониторинг изменения .csv файлов в указанных папках, разбор данных файлов и последующий импорт в ЛЭРС УЧЁТ.

Установка

Для работы модуля PMACToLers требуется Microsoft .NET Framework 4.6 и выше.

Модуль PMACToLers поставляется в виде пакета установщика Windows, который произведёт установку модуля и всех необходимых компонентов в систему, а так же запустит мастер первоначальной настройки.

При запуске установщика появляется приветственное окно мастера.

При нажатии кнопки "далее" мастер переходит ко второму этапу, в котором необходимо указать путь для установки модуля.

После указания папки для установки и нажатия кнопки "далее" мастер запустить процесс установки. Прогресс установки отображается в виде заполняемой шкалы.

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

Настройка

Настройка приложения осуществляется при помощи окна конфигурирования. Данное окно появляется после установки приложения, либо при открытии его из папки с установленной программой при помощи ярлыка Configuration. При запуске осуществляется поиск файла конфигурации:

  • Если он найден на форме отображаются настроенные ранее параметры. Поле пароль остаётся пустым, т.к. модуль использует токен авторизации и не хранить пароль в параметрах;
  • Если он не найден выдаётся соответствующее предупреждение и загружаются настройки по умолчанию.

Окно настройки выглядит следующим образом

Настройка основных параметров

Настройка осуществляется с при помощи следующих параметров:

  • Адрес хоста - адрес сервера ЛЭРС УЧЁТ, к которому модуль будет производить подключение для передачи данных;
  • Номер порта - порт сервера ЛЭРС УЧЁТ, к которому модуль будет производить подключение для передачи данных;
  • Таймаут запроса - максимальное время ожидания ответа на выполнение запроса к серверу ЛЭРС УЧЁТ;
  • Имя входа - имя входа пользователя, которое будет использовать модуль для подключения к серверу ЛЭРС УЧЁТ;
  • Пароль - пароль пользователя,которое будет использовать модуль для подключения к серверу ЛЭРС УЧЁТ;
  • Список папок с файлами для импорта - список путей к папкам, в которых модуль будет производить мониторинг изменений. Подробнее см. Настройка списка папок.

После завершения редактирования и нажатия кнопки "Ок" запускается процесс сохранения параметров. Процесс состоит из четырёх этапов:

  1. Проверка корректности параметров;
  2. Проверка подключения к серверу;
  3. Сохранение настроенных параметров в конфигурационный файл;
  4. Перезапуск службы.

Проверка корректности параметров

На данном этапе проверяется правильность задания параметров. По следующим критериям:

  • Адрес хоста - задано;
  • Имя входа - задано;
  • Список директорий для мониторинга - не пуст;
  • Пароль - задано, если были изменены параметры подключения к серверу (адрес хоста, номер порта, имя входа, пароль). Если одно из данных условий не выполняется процесс сохранения прерывается, выдаётся окно с соответствующим предупреждением и указанием на ошибочный параметр. Если проверка пройдена, сохранение переходит к следующему этапу.

Проверка подключения к серверу

Данный этап необходим для проверки правильности задания параметров сервера и получения от сервера токена для авторизации. Поэтому при настройке параметров модуля необходимо, что бы сервер ЛЭРС УЧЁТ был доступен. Если при подключении к серверу произошла ошибка, будет выдано предупреждение с соответствующим сообщением. Если подключение было успешно, сохранение переходит к следующему этапу.

Сохранение настроенных параметров в конфигурационный файл

На данном этапе происходить запись настроенных параметров и токена авторизации в конфигурационный файл. Если сохранение не удалось, то выдаётся предупреждение с соответствующим сообщением. Если сохранение прошло успешно, сохранение переходит к следующему этапу.

Перезапуск службы

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

Настройка Настройка списка папок

Настройка списка папок для мониторинга осуществляется с помощью окна конфигурирования в соответствующей секции окна конфигурирования. Данный список отсортирован в алфавитном порядке.

Добавление новых папок

Для добавления папок в данный список необходимо нажать соответствующую кнопку в последней строке списка, после чего откроется окно, в котором необходимо произвести выбор папки.

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

При попытки добавить в список уже добавленной папки будет выдано предупреждении о её наличии в данном списке. Дублирующая запись в список добавлена не будет.

Удаление папок

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

Настройки в ЛЭРС УЧЁТ

Создание точки учёта

Модуль импортирует данных в точки учёта у которых в качестве устройства установлено оборудование Cello 4s. Для создания такой точки учёта необходимо выполнить следующие шаги:

  1. Создать оборудование Cello 4s. Подробнее см. в статье Оборудование
  2. Создать точку учёта см. Точка учета
  3. В созданной точки учёта, в качества устройства, с которого производится загрузка данных, указать оборудование Cello 4s. После этого появится привязать каналы к измеряемым параметрам;
  4. Произвести привязку каналов к измеряемым параметрам согласно параметрам устройства.

После этого модуль импорта данных, при регистрации изменений файла, с серийным номером данного устройства будет производить запись данных в данную точку учёта

Настройка расчёта

Система наличия данных системы диспетчеризации ЛЭРС УЧЁТ оценивает наличие данных по суточным данным. Т.к. с PMAC получаются текущие данные, то необходимо произвести расчёт недостающих данных. Для этого необходимо воспользоваться механизмом расчёта данных для точек учёта. Подробнее см. документацию

Расчёт необходимо настроить следующим образом

  • Часовой архив - усреднение по текущим;
  • Суточный архив - по часовому.

Остальные параметры можно выставить по своему усмотрению.

После такой настройки, при импортировании данных модулем, будет запускаться расчёт недостающих данных за импортированный период.