Внешний модуль "Массовая генерация отчётов"

Набор проектов для генерации отчётов из системы ЛЭРС УЧЁТ (система учёта энергоресурсов).

Особенность

Совместимость с любой версией ЛЭРС (по крайней мере там, где проводились тесты)

Проект компилируется локально на вашей машине, используя библиотеки установленного ЛЭРС.

Преимущества:

  • Автоматическая совместимость с установленной версией ЛЭРС
  • При обновлении ЛЭРС достаточно пересобрать плагин
  • Автоматическая сборка через install.bat — скрипт самостоятельно находит библиотеки ЛЭРС и компилирует проект

Пересборка после обновления ЛЭРС:

cd LersReportGeneratorPlugin
install.bat    # Правой кнопкой → Запустить от имени администратора

Проекты

LersReportGeneratorPlugin

WinForms плагин для АРМ оператора ЛЭРС.

Возможности:

  • Генерация отчётов ОДПУ (общедомовые приборы учёта)
  • Генерация отчётов ИПУ (индивидуальные приборы учёта)

screenshot_light

  • Работа с локальным и удалёнными серверами с мониторингом полноты опроса

servers_light

  • Массовая генерация со всех серверов
  • Экспорт в PDF/XLSX
  • Импорт/экспорт серверов с шифрованием паролей

Установка:

  1. Распаковать архив
  2. В папке LersReportGeneratorPlugin: Правой кнопкой мыши на install.bat → Запустить от имени администратора
  3. Перезапустить АРМ ЛЭРС
  4. В АРМ: Администрирование → Внешние модули → Добавить из файла
  5. Выбрать: C:\Program Files\LERS\Client\Plugins\LersReportGeneratorPlugin\LersReportGeneratorPlugin.dll
  6. Плагин появится в меню: Сервис → Генератор отчётов

Скрипт install.bat автоматически соберёт и скопирует файлы в C:\Program Files\LERS\Client\Plugins\

LersReportProxy

Windows Service - прокси-служба для удалённых серверов ЛЭРС. Использует pass-through авторизацию — плагин подключается к прокси с теми же учётными данными, что и к ЛЭРС.

Зачем нужна:

  • Позволяет формировать отчеты с удаленных серверов

  • Расширяет REST API ЛЭРС (добавляет недостающие endpoints)

  • Поддержка генерации ИПУ отчётов (не поддерживается в REST API)

  • Получение отчётов точек одним запросом (вместо N запросов)

Установка на сервере ЛЭРС:

  1. Распаковать архив на сервере
  2. В папке LersReportProxy: Правой кнопкой мыши на install.bat → Запустить от имени администратора
  3. Служба будет установлена и запущена на порту 5377

Скрипт автоматически соберёт и установит Windows Service.

LersReportCommon

Общая библиотека для устранения дублирования кода между плагином и прокси-службой.

Содержит:

  • Logger.cs - универсальный файловый логгер
  • ReflectionHelper.cs - работа с reflection для ЛЭРС API
  • Constants.cs - общие константы

Системные требования

  • Windows 10/11 или Windows Server 2016+
  • .NET Framework 4.8
  • .NET SDK 8.0 (для сборки)
  • Установленный ЛЭРС УЧЁТ (для плагина)

Документация

Детальная документация доступна в комментариях к коду и XML-комментариях в исходниках проектов.

Лицензия

Бесплатное программное обеспечение. Распространяется свободно.

Репозиторий:

1 лайк