﻿Руководство пользователя программы мониторинга сети АЗС

Содержание:

1. Введение
2. Внешний вид программы
3. Перечень контролируемых параметров
4. Сигнализация об ошибках
5. Сворачивание в трей
6. Ограничение доступа
7. Содержание меню
8. Редактирование перечня контролируемых АЗС
9. Редактирование конфигурации
10. Выход


1. Введение

Настоящее руководство описывает  порядок работы диспетчера с программой мониторинга сети АЗС.
Программа предназначена для дистанционного контроля за состоянием нескольких автозаправочных станций (АЗС). Программа реализована как Java-приложение. Она обеспечивает обмен данными с АЗС и отображает информацию о состоянии каждой АЗС.
Программа предполагает постоянное функционирование. Выход из программы необходим только при смене конфигурации или изменении списка контролируемых АЗС.

2. Внешний вид программы

   Главное окно программы
2.1. Общий мониторинг
2.1.1. Количество АЗС
2.1.2. Состояние АСУТП
2.1.3. Состояние ТРК
2.1.4. Состояние Резервуаров
2.2. 	Углубленный мониторинг
2.2.1. Окно выбора объекта наблюдения (дерево АЗС)
2.2.2. Окно углубленного мониторинга по выбранному объекту
2.2.3. Визуальное отображение резервуаров
2.3. Протокол событий

   Главное окно программы содержит три укрупненных секции:  Общий мониторинг, Дерево АЗС и Мониторинг по выбранному объекту. Кроме этого, в нижней части экрана отображается окно протокола событий. Размер этого окна может быть изменен «перетаскиванием» верхнего края окна протокола. 
В окне отображается история событий за последние несколько дней. По умолчанию – за 2 дня. Количество дней за которые отображается история может быть изменено в меню Настройки->Конфигурация-> История протокола в главном окне. 

Назначение секций:
	2.1.Общий мониторинг. 
	Поля этой зоны не выделяются и не редактируются. Предназначены только для вывода сводной информации.
	2.1.1. Количество АЗС
	Количество АЗС, по которым внесены данные в конфигурации программы.
	Количество АЗС, с которыми установлена связь в данный момент
 	2.1.2. Состояние АСУТП
	Общее количество ошибок АСУТП, разделенных на критические и не критические.
      Так же приведена статистика – сколько из этих ошибок являются ошибками смен, касс и купюроприемников. Подробнее перечень контролируемых параметров и разделение ошибок на критические и не критические приведены ниже, в пункте «Перечень контролируемых параметров».
      2.1.3. Состояние ТРК
      Общее количество сторон ТРК на контролируемых АЗС, и количество сторон ТРК, работающих без ошибок.
      Так же приведена статистика критических и некритических ошибок ТРК. Подробнее перечень контролируемых параметров ТРК и разделение ошибок на критические и некритические приведены ниже, в пункте «Перечень контролируемых параметров».
      2.1.4. Состояние Резервуаров
      Общее количество Резервуаров на контролируемых АЗС, количество Резервуаров, работающих без ошибок, количество критических и некритических ошибок Резервуаров.
      Так же приведена статистика критических и некритических ошибок Резервуаров и, из них, количество ошибок, относящихся к уровню заполнения Резервуаров. (Настройка критического и некритического уровня заполнения Резервуара возможна в конфигурации программы). Подробнее перечень контролируемых параметров Резервуаров и разделение ошибок на критические и некритические приведены ниже, в пункте «Перечень контролируемых параметров».
      
	2.2. Углубленный мониторинг
2.2.1. Окно выбора объекта наблюдения (дерево АЗС)
      Отображена структура принадлежности АЗС по группам и состав оборудования АЗС. Дерево имеет привычный интерфейс, аналогичный дереву выбора файлов. Для раскрытия ветви необходимо дважды щелкнуть по элементу или знаку [+] в узле. Так же, возможен выбор, используя только клавиатуру. Перемещение по дереву – стрелки вверх и вниз. Раскрыть узел – стрелка вправо, свернуть узел – стрелка влево. 
      При выборе какого-либо Резервуара, принадлежащего АЗС, появляется возможность вручную отключить наблюдение за выделенным Резервуаром (нажатием alt+M или меню Менеджер->Блокировать мониторинг резервуара). Необходимость в ручном отключении мониторинга возникает, если какой-либо резервуар сознательно содержится в пустом состоянии, и нет необходимости принимать от него сигнал об ошибке. Такой резервуар будет подкрашен серым цветом. Включение мониторинга такого резервуара производится так же как и выключение (нажатием alt+M или снятием галочки в меню Менеджер->Мониторинг резервуара заблокирован).
2.2.2. Окно углубленного мониторинга по выбранному объекту
      Текстовая область, отображающая статистику по выделенному в данный момент узлу. Эта зона не выделяется и не редактируется. Предназначена только для вывода информации.
2.2.3. Визуальное отображение Резервуаров
      Появляется при выборе узла уровня АЗС и ниже. Резервуары отображаются при наличии данных от резервуаров от выделенной АЗС. На рисунке представлен уровень топлива в резервуаре, указан процент заполнения, наличие подтоварной воды и название продукта. При на наличии ошибки резервуара, соответствующее изображение подсвечивается красным или желтым цветом. При отсутствии данных об измерениях на Резервуаре или при ручном отключении мониторинга Резервуара, изображение подсвечивается серым цветом. Зона изображений не выделяется и не редактируется. Предназначена только для вывода информации.
2.3. Протокол событий.
В окне протокола отображаются все зарегистрированные ошибки и предупреждения, зарегистрированные программой на объектах наблюдения. Каждая строка протокола содержит наименование объекта, на котором произошло событие, дату и время, текст события. Расположенные над окном кнопки позволяют отсортировать события, относящиеся ко всем АЗС или к выбранной в данный момент в дереве АЗС .

3. Перечень контролируемых параметров

	При работе программы, контролируются следующие показатели:
3.1. наличие связи с АСУТП АЗС
- наличие подключения 
- регулярное поступление данных
- регулярное изменение счетчика сервера АСУТП
- регулярное изменение времени сервера АСУТП
- своевременное изменение даты сервера АСУТП
3.2. состояние ТРК 
- количество сторон ТРК на АЗС
- все ли ТРК в рабочем состоянии, номера сторон ТРК
- число нерабочих сторон ТРК 
- ошибки ТРК, их расшифровка и время прихода
- объем заказа
- тип оплаты
- текущий статус ТРК анализируется в соответствии с настройками в конфигурации, отслеживается время пребывания в определенном статусе. О превышении этого времени сообщается как о некритической или критической ошибке. Статус  подразделяется на следующие состояния:
0 — нет связи с контроллером управления ТРК (критическая ошибка)
1 — нет связи с ТРК; (критическая ошибка)
2 — исходное состояние, пистолет снят;
3 — исходное состояние, пистолет повешен;
4 — сторона ТРК готова к пуску (ожидание снятия пистолета программой); нахождение в данном статусе более времени, определенного в конфигурации – некритическая ошибка
5 — сторона ТРК готова к пуску (ожидание снятия контроллером управления ТРК); (нахождение в данном статусе более времени, определенного в конфигурации – некритическая ошибка)
6 — сторона ТРК готова к пуску (заказ отправлен в ТРК, ожидание снятия колонкой); (нахождение в данном статусе более времени, определенного в конфигурации – некритическая ошибка)
7 — идет отпуск топлива; 
8 — пауза в отпуске топлива (возможно продолжение без обнуления дисплея ТРК); (нахождение в данном статусе более времени, определенного в конфигурации – некритическая ошибка)
9 — заправка окончена, ожидается передача данных от ТРК; (нахождение в данном статусе более времени, определенного в конфигурации – некритическая ошибка)
10 — ТРК занята/зарезервирована (идет работа с кассой, картой, ТСО и т. п.); (нахождение в данном статусе более времени, определенного в конфигурации – некритическая ошибка)
11 — ТРК в исходном состоянии, требуется расчет с клиентом; (нахождение в данном статусе более времени, определенного в конфигурации – некритическая ошибка)
12 — идет процесс начальной инициализации ТРК; (нахождение в данном статусе более времени, определенного в конфигурации – некритическая ошибка)
13 — ТРК выключена. 

3.3. состояние всех резервуаров
- объем резервуара
- текущий объем заполнения
- процент заполнения (отображается наглядно, в виде столбца)
- текущий уровень заполнения 
- температура топлива
- код продукта
- объем подтоварной воды (наличие воды отображается наглядно в столбце)
- предупреждения о некритическом и критическом снижении уровня топлива в резервуаре
- данные от датчиков и ошибки прихода этих данных 
- в случае задержки прихода данных о резервуарах и превышения тайм-аута, заданного в конфигурации, выдается соответствующее предупреждение 
3.4. состояние терминалов самообслуживания (ТСО)
- наличие ТСО на АЗС
- наличие ошибок ТСО (все ошибки касс ТСО- критические)
- степень заполнения купюроприемника. В соответствии с параметрами конфигурации, контролируется два уровня заполнения купюроприемника – критический и некритический. Изменение критического и некритического уровней заполнения купюроприемника возможно путем изменения соответствующих границ в конфигурации программы (Меню Настройки->Конфигурация,  выбрать Константы уровня АЗС->Константы уровня Резервуаров-> выбрать константу для редактирования и нажать кнопку «Редактировать»). 
3.5. состояние всех касс
- ошибки кассы (все ошибки - критические). ». Расшифровка кодов ошибок касс находится в файле «kassaType.xml», создается разработчиком. Адрес файла настраивается в конфигурации, в секции «Константы верхнего уровня».
- количество времени до блокировки кассы (более 15 минут/менее 15 минут)
3.6. состояние смены
- номер текущей смены 
- открыта или закрыта смена
- если смена закрыта длительное время, выдается некритическое предупреждение (все ошибки смен - некритические)

4. Сигнализация об ошибках.

Для сообщения об ошибке используются следующие сигналы:
4.1. При регистрации ошибки основное окно программы раскрывается на экране, выходя на первый план (если до этого было закрыто или свернуто). Отключить такое «всплывание» можно, перейдя в пункт меню Настройки ->Конфигурация (будет запрошен пароль на доступ к конфигурации)-> узел «Служебные настройки программы»-> «Всплывание главного окна при ошибках»
4.2. Цветовая сигнализация
Критическим ошибкам соответствует красный цвет, некритическим – желтый. Отключенные резервуары подсвечиваются серым цветом.
4.3. Информация в трее, всплывающие сообщения и звуковая сигнализация
Иконка приложения в системном трее меняет свой цвет с зеленого (норма) на желтый(есть по крайней мере одна некритическая ошибка) или на красный (есть хотя бы одна критическая ошибка).
Из системного трея возникает сообщение с указанием номера АЗС, критичностью ошибки и кратким описанием ошибки
Подается короткий звуковой сигнал об ошибке. При исчезновении всех ошибок подается характерный звуковой сигнал.
4.4. Информация в общем мониторинге
В сводной статистике наличия ошибок (левая часть окна, секция «Общий мониторинг») появляется указание количества ошибок. Поля со статистикой подсвечиваются соответственно красным или желтым фоном
4.5. Информация в углубленном мониторинге
В дереве АЗС  меняет цвет узел в котором произошла ошибка (на красный или желтый соответственно). Так же меняют цвет все его предки до корня, что позволяет отследить нахождение ошибки. В случае, если на одном узле произошли и критическая и некритическая ошибки, цвет узла и предков устанавливается по принципу приоритетного отображения критических ошибок.
В окне «Мониторинг по выбранному объекту» дается расшифровка ошибки данного объекта и отображается статистика по всем критическим и некритическим ошибкам в узлах, дочерних выбранному в данный момент. Например, если в дереве выбран узел АЗС, в окне отображается расшифровка ошибки, относящейся ко всей АЗС, и приводится статистика, сколько ошибок обнаружено в ТРК и Резервуарах данной АЗС. 


5. Сворачивание в трей
      При закрытии окна программы или при выборе в меню «Файл»-> «Свернуть в трей», она сворачивается в иконку в трее и продолжает функционировать. Так же, свернуть окно в системный трей можно, нажав комбинацию клавиш Alt-F4. Для того, чтобы развернуть программу, достаточно дважды кликнуть на иконке «Monitoring AZS» (или произвести действия, соответствующие вызову программы из трея для операционной системы пользователя). При поступлении ошибок, меняется цвет иконки, появляется сообщение из трея и окно программы раскрывается автоматически.
      
6. Ограничение доступа
6.1. Применение ограничений
      Доступ к некоторым действиям ограничен в соответствии со статусом пользователя. 
      К таким действиям относятся:
a) Подключение удаленного рабочего места
b) Доступ к web-странице формирования отчетов по АЗС
с) Редактирование свойств АЗС
d) Редактирование конфигурации программы
e) Управление электропитанием
      В этом случае производится запрос пароля. Действет три различных пароля: для пункта (a), для пункта (b) и для пунктов (c) и(d). При необходимости, можно отключить запрос всех трех паролей. Для этого надо зайти в пункт меню Настройка->Конфигурация и вбрав ветку "Служебные настройки программы" установить значение off в переменную PASS_CHECK (Ограничение доступа к меню).
6.2. Пароль по умолчанию
      Значение пароля по умолчанию: «123».
      При первом запуске программы действует пароль по умолчанию. О действии в данный момент пароля по умолчанию сигнализирует надпись в окне ввода пароля.
6.3. Смена пароля
      В окне запроса пароля есть возможность сменить пароль.
      В окне ввода пароля присутствует кнопка «Сменить пароль». Для смены пароля необходимо ввести старый пароль и дважды ввести новый. В диалоге ввода нового пароля присутствует кнопка «Сброс». Ее нажатие приводит к сбросу текста в полях диалога.


7. Содержание меню
Переход в меню возможен как с использованием мыши, так и с клавиатуры (нажатием клавиши Alt или F10)
7.1. Файл
7.1.1. Свернуть в трей
Сворачивание программы в трей. Программа не отображается на экране и в списке диспетчера задач. При этом продолжает выполняться и при поступлении ошибки будет развернута на экран автоматически.
7.1.2. Выход
Закрытие программы.
7.2. 	Настройки
7.2.1. Структура дерева АЗС
«Структура дерева АЗС». Вызов редактора дерева АЗС.(Работа в редакторе описана ниже). Для входа необходимо ввести пароль или войти в режиме ограниченного доступа с возможностью просмотра, но не редактирования информации.
7.2.2. Конфигурация
Вызов редактора констант программы. Для входа необходимо ввести пароль или войти в режиме ограниченного доступа с возможностью просмотра, но не редактирования информации.
7.2.3. История ошибок
7.2.3.1. Сводный лог файл
7.2.3.2. Лог выбранной АЗС
Просмотр лог-файла, куда записываются все ошибки, зарегистрированные настоящей программой. Возможен просмотр общего лог-файла («Сводный лог файл») и файла по конкретной АЗС («Лог выбранной АЗС»). Пункт «История ошибок»-> «Лог выбранной АЗС» доступен только при выборе в дереве конкретной АЗС или ее потомков. Адрес расположения общего лог-файла настраивается в конфигурации программы. В этой же директории расположатся все лог-файлы по отдельным АЗС.
7.3. Менеджер
7.3.1. 	Подключить удаленное рабочее место
Вызывается рабочее место оператора на сервере АЗС  (действия на рабочем месте оператора описаны в документации соответствующих отдельных программных модулей). Для запуска необходимо ввести пароль.
7.3.2. 	Генерация отчетов по АЗС. 
Вход в систему управления отчетностью по магазину. Выполняется с помощью интернет браузера, используемого пользователем по умолчанию.
Для запуска необходимо ввести тот же пароль, что и для подключения удаленного рабочего места.
7.3.3.  Состав оборудования АЗС
Просмотр параметров АЗС и подключенного оборудования. Открывается окно с перечнем Резервуаров, ТРК и подключенных к ним шлангов, Продуктов и Видов оплат.
7.3.4. 	Блокировка мониторинга резервуара
Отключение мониторинга выбранного в настоящий момент Резервуара. 
При выборе какого-либо Резервуара, принадлежащего АЗС, этот пункт меню позволяет вручную отключить наблюдение за выделенным Резервуаром. Необходимость в ручном отключении мониторинга возникает, если какой-либо резервуар сознательно содержится в пустом состоянии, и нет необходимости принимать от него сигнал об ошибке. Такой резервуар будет подкрашен серым цветом. В общей статистике пропадает информация об ошибках данного Резервуара, но он и не рассматривается как безошибочно работающий (он не попадает в сумму «работающих без ошибки»). Включение мониторинга такого резервуара производится так же как и выключение (нажатием alt+M или снятием галочки в меню Менеджер->Мониторинг резервуара заблокирован).
7.3.5.  Управление электропитанием
Вход в систему управления электропитанием на АЗС. На АЗС должны быть предварительно настроены ПО и оборудование для подобной работы. Вход выполняется с помощью интернет браузера, используемого пользователем по умолчанию.
Для запуска необходимо ввести тот же пароль, что и для подключения удаленного рабочего места.
7.4. Помощь
7.4.1. 	Руководство пользователя
Отображает настоящее руководство
7.4.2. 	О программе
Отображает информацию о версии, дате релиза, авторе и принадлежности прав.

      
8. Редактирование перечня контролируемых АЗС
8.1. 	Запуск редактора
8.2. 	Просмотр информации об АЗС
8.3. 	Редактирование данных АЗС
8.4. 	Добавление новой АЗС и удаление АЗС
8.5. 	Сохранение изменений

	Для внесения изменений в структуру дерева АЗС, а так же для просмотра дополнительных данных об АЗС (Почтовый адрес, телефон, ip-адрес) предназначен редактор дерева АЗС.
Для запуска редактора достаточно выбрать пункт меню «Настройки»-> «Структура дерева АЗС». Или нажать комбинацию клавиш  Alt-A. 
	Окно редактора состоит из дерева АЗС, в котором можно выбрать необходимый узел используя мышь или клавиатуру. Навигация с помощью клавиатуры аналогична таковой в основном окне: (Перемещение по дереву – стрелки вверх и вниз. Раскрыть узел – стрелка вправо, свернуть узел – стрелка влево.). 
      Ниже дерева АЗС расположено окно с информацией о выбранном узле. Для АЗС это: принадлежность к группе, название, почтовый адрес, телефон и IP-адрес. 
      Доступные действия:
      При выборе корня: есть возможность добавить новый регион или переименовать корень.
      При выборе Группы: есть возможность добавить новую АЗС, переименовать группу, удалить группу (только в случае, если она пустая, не содержит ни одной АЗС)
      При выборе АЗС: есть возможность редактировать выбранную АЗС или удалить ее.
      
      По окончании редактирования, для сохранения результатов редактирования, необходимо выбрать пункт «Принять изменения». Внимание! Изменения вступят в силу только после перезапуска программы. О чем и появится предупреждение при выходе из редактирования.
      Для выхода без сохранения результатов достаточно нажать клавишу «Выйти без сохранения» или закрыть окно редактирования (крестик в правом верхнем углу или комбинация клавиш Alt-F4 ).
      
9. Редактирование конфигурации.

9.1. Запуск редактора конфигурации
9.2. Иерархическое расположение констант
9.3. Список настраиваемых параметров
9.4. Сохранение изменений

Для внесения изменений в константы программы, а так же для просмотра значений переменных предназначен редактор конфигурации.
Для запуска редактора достаточно выбрать пункт меню «Настройки»-> «Конфигурация». Или нажать комбинацию клавиш  Alt-K. 
Окно редактора состоит из дерева констант, расположенных в соответствии с иерархией  своей принадлежности (общие, уровня АЗС, уровня ТРК, относящиеся к Резервуарам), в котором можно выбрать необходимый узел используя мышь или клавиатуру. Навигация с помощью клавиатуры аналогична таковой в основном окне: (Перемещение по дереву – стрелки вверх и вниз. Раскрыть узел – стрелка вправо, свернуть узел – стрелка влево.). 
      Ниже дерева констант расположено окно с информацией о выбранном узле. Для констант это: название, значение и комментарий.  При выборе конкретной константы возможно редактирование ее значения.
      По окончании редактирования, для сохранения результатов редактирования, необходимо выбрать пункт «Принять изменения». Внимание! Изменения вступят в силу только после перезапуска программы. О чем и появится предупреждение при выходе из редактирования.
      Для выхода без сохранения результатов достаточно нажать клавишу «Выйти без сохранения» или закрыть окно редактирования (крестик в правом верхнем углу или комбинация клавиш Alt-F4 ).
      

10. Выход
	Выход из программы возможен путем выбора пункта меню Файл->Выход. 
      Кроме этого, при нажатии правой кнопки мыши на иконке «Monitoring AZS» в системном трее, появляется выпадающее меню «Exit». При выборе этого пункта происходит полный выход из программы.
      
      
      
      
      
Данные о программе:

Версия 1.3.
26.01.2024
OOО «НЕФТЕПРОДУКТТЕХНИКА»
Тел: +7 (499) 135-05-14, 135-77-11, 135-65-79
