Руководство пользователя

Программное средство предназначено для мониторинга и управления системой сбора данных.

Главное окно программы

На скриншоте ниже представлено Главное окно программы "Система приёма данных - Панель управления v1.22":

Responsive image

Оконная форма содержит следующие элементы:

  1. Панель меню.
  2. Поле баз данных.
  3. Кнопка просмотра БД.
  4. Кнопка просмотра Аналитики.
  5. Кнопка просмотра списка заблокированных объектов.
  6. Поле с кратким описанием выбранной базы данных.
  7. Информация о сервере приёма данных.
  8. Информационные вкладки.
  9. Имя пользователя, от лица которого выполнен вход в панель управления.

Панель меню

Скриншот меню-панели
Содержит следующие элементы :

  • Администрирование
  • Лог системы
  • SMS
  • Помощь

Администрирование

Пользователи

Вызывает окно управления учётными записями пользователей


Скриншот окна Пользователи

Цифрами на скриншоте обозначены:
  1. Список пользователей, зарегистрированных в системе.
  2. Ф.И.О. выбранного пользователя.
  3. Панель изменения параметров учётной записи. Позволяет изменить логин пользователя, установить уровень доступа 0-2 (Наблюдатель, Оператор, Администратор), установить номер телефона для отправления СМС-уведомлений. Чтобы автомаически отправлять пользователю смс-уведомления отметьте флажок "Получать смс-уведомления".
  4. Флажок "Заблокировать доступ" используется для блокировки доступа пользователей к системе. Отметьте флажок галочкой, чтобы заблокировать выбранного пользователя.
  5. Кнопка изменения пароля. По нажатию откроется окно

    Скриншот смены пароля

    в котором вам будет предложено ввести новый пароль для пользователя.
  6. Кнопка изменения пароля Супервизора. Процедура изменения такая же, как и для пользователя.
  7. Кнопка для добавления новых пользователей в систему. При нажатии откроется окно

    Скриншот инфы о пользователе

    где необходимо указать следующую информацию о добавляемом пользователе:Ф.И.О., Логин, Пароль, Уровень доступа. Все поля обязательны к заполнению! Для завершения операции добавления пользователя нажмите кнопку "Ок".
  8. Кнопка "Закрыть". Закрывает окно.

Общие настройки

Общие настройки

Открывает окно, в котором возможно изменение следующих параметров системы:

  1. Таймаут закрытия соединения при неактивности терминала. Время, через которое соединение будет закрыто при отсутствии входящих данных с терминала. Указывается в секундах.
  2. Часовой пояс в формате UTC. UTC(англ. Coordinated Universal Time) - всемирное скоординированное время.
  3. Доменное имя сервера приёма данных.
  4. IP-адрес сервера приёма данных.

Для принятия изменений нажмите кнопку Ok


Для выхода без сохранения изменений нажмите кнопку Отмена

Базы данных

Базы данных


Список элементов:

  1. Поле содержит список всех подключенных баз данных. Для добавления новой БД нажмите кнопку Плюс. Для удаления кликните левой кнопкой мыши по базе из списка, которую вы хотите удалить, и нажмите кнопку Минус.
  2. Список настроек БД.
    • Название. Имя, под которым БД будет представлена в поле 1.
    • Хост. Здесь необходимо указать IP-адрес, по которому расположен сервер БД.
    • Порт. Здесь необходимо указать сетевой порт, по которому будет осуществляться подключение к базе данных.
    • Логин. Здесь необходимо указать имя пользователя, от лица которого будет осуществляться доступ к БД.
    • Пароль. Здесь необходимо указать пароль пользователя БД.
    • БД. Здесь необходимо указать наименование используемой базы данных для СУБД.
    • Тип БД. Здесь необходимо указать к какому типу относится база данных: RITM\AutoTracker.
  3. Поле содержит краткое описание выбранной БД. Здесь могут быть указаны сведения о провайдере, DNS-имени сервера БД, используемой на сервере Операционной системе, Системе управления базами данных и т.д.
  4. Список флагов ограничения доступа:
    • Запретить кнопку "Просмотр БД". Установите флажок, чтобы запретить оператору просматривать содержимое выбранной базы данных.
    • Запретить серверу чистку списков Установите флажок, чтобы запретить ежедневную очистку списков от объектов, которые более не доступны.
    • Запретить создание новых объектов Установите флажок, чтобы предотвратить добавление в систему объектов, не привязанных к учётной записи. При попытке создания нового объекта он будет "заблокирован". Список заблокированных объектов доступен по нажатию кнопки в главном окне программы.


Для завершения операции добавления базы данных нажмите Сохранить.

Для отмены всех внесённых изменений нажмите Закрыть.

Серверы ретрансляции

screen


Список элементов:

  1. Поле, содержащее список всех зарегистрированных Серверов Ретрансляции. Добавить новый сервер ретрансляции можно нажатием кнопки Плюс. Чтобы удалить сервер из списка, нужно выбрать нужный сервер из списка нажатием левой кнопки мыши, а затем нажать кнопку Минус.
  2. Параметры сервера ретрансляции. Содержит редактируемые поля:
    • Название. Имя сервера ретрансляции.
    • Хост. IP-адрес сервера ретрансляции.
    • Порт. Сетевой порт для подключения к серверу ретрансляции.
    • Логин Имя пользователя для подключения к серверу ретрансляции.
    • Пароль Пароль пользователя для подключения к серверу ретрансляции.
  3. Краткое описание сервера ретрансляции. Здесь можете ввести любые сведения о сервере, которые сочтёте нужными.

Лог системы

screen

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


Конец временного периода задаётся таким же образом.

Чтобы вывести на экран историю событий за выбранный период, нажмите кнопку Обновить.

В поле Дата фиксируется время, когда свершилось событие. Дата выводится в формате "День.Месяц.Год Часы:Минуты:Секунды".

В поле Текст выводится информация о событии в формате "Название службы - название события".

SMS

sms-screen

Помощь

menu-help


Нажатие на пункт Справка открывает страницу с данным руководством.

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

Нажатие на пункт О программе выводит окно с информацией о программном обеспечении: версия, разработчик, назначение.

Базы данных

Просмотр БД


Основным элементом данного окна является таблица, содержащая записи базы данных за определённый период. Поля таблицы:
  • # - Порядковый номер записи;
  • ID - Идентификатор записи в БД;
  • ID_OBJ - Идентификатор объекта;
  • REC_DATE - Дата занесения записи в БД;
  • RID
  • REC_TYPE
  • LAT - Широта;
  • LON - Долгота;
  • SPD
  • POWER - Сигнал на блоке питания (1-есть, 0-нет)
  • D1 - Сигнал с дискретного датчика (Зажигание)
  • D2 - Сигнал с дискретного датчика ()
  • D3 - Сигнал с дискретного датчика ()
  • D4 - Сигнал с дискретного датчика ()
  • D5 - Сигнал с дискретного датчика ()
  • D6 - Сигнал с дискретного датчика ()
  • AN1 - Сигнал с аналогового датчика
  • AN2 - Сигнал с аналогового датчика
  • CAR_POWER


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

С помощью элемента limit можно задать ограничение на максимальное количество записей, выводимых на экран.

С помощью элемента filter можно отфильтровать записи в таблице по полю ID_OBJ. Таким образом, в таблице останутся только записи, имеющие отношение к объекту с заданным идентификационным номером (в данном случае 227).

Установка флажка в элементе auto-update активирует автоматическое обновление таблицы раз в 5 секунд.

Аналитика

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




Пользователь может самостоятельно выбирать, за какой период ему будет предоставлена статистика: День, Месяц, Год.



Может быть предоставлена как общая статистика по всем службам, так и по одной конкретной службе на выбор пользователя:



После настройки фильтра, нажмите кнопку Применить, чтобы построить график.

Заблокированные объекты

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


Само окно имеет следующий вид:



Пользователь имеет возможность отфильтровать сообщения о заблокированных объектах при помощи двух фильтров:
  • По времени
  • По службе


После установки фильтра, нажмите кнопку Применить, чтобы вывести информацию в таблицу.

Каждая запись в таблице имеет следующие поля:
  • Номер записи
  • Идентификатор объекта
  • Служба, к которой осуществлялась попытка подключения
  • Время осуществления попытки подключения

Сервер приёма данных

В данной области главного окна программы отображается информация о сервере приёма данных:spd


Здесь указан адрес сервера, куда будут стекаться все данные с терминалов. Изменить адрес сервера можно в пункте "Общие настройки" меню "Администрирование".

Информационные вкладки

Рабочая область программы содержит три информационных вкладки:

каждая из которых подробно рассмотрена ниже.

Приём данных

На данной вкладке можно увидеть такую информацию, как: Общее число зарегистрированных служб Число служб и количество объектов онлайн online


Таблица содержит информацию обо всех зарегистрированных службах:


Поля таблицы:
  • Название сервиса.
  • Порт, по которому осуществляется соединение.
  • Online. Количество объектов, использующих сервис в данный момент времени.
  • SMS. Включено ли sms-оповещение для данного сервиса.
  • Лог. Включено ли логирование для данного сервиса.
  • Статус. В каком состоянии находится сервис.


Снизу расположена панель инструментов:

buttons

Далее по каждой кнопке:
stop - Остановить сервис.

restart - Перезапустить сервис.

change ID - Подмена идентификатора службы. Позволяет присвоить объекту системы внутренний ID(Идентификационный номер), который может отличаться от собственного ID объекта.

+ - Установить новую службу.

- - Удалить выбранную службу.

parameters - Настройка параметров службы.

management - Открыть лог управления.

service - Открыть лог службы.

instructions - Открыть инструкции.

Подмена ID


В данном окне можно присвоить любому объекту произвольный ID, который будет использоваться в системе вместо его собственного ID.

Для этого необходимо в объекте в левом поле ввести значение оригинального ID, которое вы хотите изменить, а справа ввести значение ID, которое вы хотите присвоить. После этого нажать на кнопку Добавить. В приведённом примере объекту с исходным ID=227 будет присвоен новый ID=14899, под которым он будет известен в системе.

Для изменения уже существующей привязки "Исходный ID"-"Изменённый ID" необходимо щелчком ЛКМ выбрать нужную запись в таблице и нажать кнопку изменить. Затем записать новые значения "Исходный ID" > "Изменённый ID" вместо существующих и нажать кнопку Сохранить.

Для удаления существующей привязки "Исходный ID - Изменённый ID" необходимо щелчком ЛКМ выбрать нужную запись в таблице и нажать кнопку Удалить.

Установка новой службы

Нажатие кнопки открывает новое окно, в котором пользователю предлагается ввести:

  • Системное имя службы*
  • Имя службы*
  • Протокол*
  • Порт*
  • Назначение службы
  • Есть необходимость ведения логов (Да\Нет)
  • Использовать SMS-оповещение (Да\Нет)
  • Вносить в протоколирование дополнительную информацию (Да\Нет)



Поля, отмеченные * обязательны к заполнению!


После выбора протокола в поле "Описание протокола" можно прочитать дополнительную информацию о данном протоколе.

Для завершения операции добавления службы, необходимо нажать на кнопку Сохранить.

При успешном добавлении службы будет выведено следующее сообщение:

Чтобы закрыть окно без сохранения изменений нажмите кнопку Закрыть. При таком выходе служба не будет создана.

Удаление службы

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


В появившемся диалоговом окне нажмите кнопку "Да" для удаления сервиса.



Если вы не планировали удалять сервис из системы, нажмите кнопку "Нет", чтобы отменить удаление.

Изменение службы

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


Если вы не планировали вносить изменения, нажмите Закрыть.

Чтобы сохранить внесённые изменения, нажмите Сохранить.

Лог управления

Выводит на экран таблицу событий управления службой:




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

Лог службы

Выводит на экран информацию по выбранному сервису в следующем виде:




Таблица содержит поля:
  • Дата. Временная отметка события в формате "День.Месяц.Год Часы:Минуты:Секунды".
  • Хост. IP-адрес объекта.
  • Исходный ID. Идентификатор объекта, сообщившего о событии.
  • Изменённый ID Идентификатор объекта, присвоенный ему системой сбора данных.
  • Данные Содержание сообщения.


С помощью полей host, Изначальный ID, Изменённый ID, можно отфильтровать записи в таблице по интересующему вас признаку.

Чтобы применить установленный фильтр, нажмите кнопку Обновить.

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

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

В том случае, если вы отключили ведение логов при создании службы, есть возможность включить временное логирование, установив флажок в поле Временно включить.

Инструкции

Окно содержит инструкции по выбранному протоколу для наблюдателей и операторов. Форма для заполнения выглядит следующим образом:

Ретрансляция

На данной вкладке отображается информация о зарегистрированных в системе серверах ретрансляции.


Таблица содержит следующие поля:
  • Название. В данном поле отображается имя службы.
  • Протокол. В данном поле отображается протокол ретрансляции.
  • Всего. В данном поле отображается общее количество зарегистрированных объектов.
  • Активных. В данном поле отображается количество объектов Online.
  • Неактивных. В данном поле отображается количество объектов Offline.
  • Порог. В данном поле отображается значение процентного соотношения Активных объектов к общему их количеству, при котором срабатывает SMS-оповещение.
  • SMS. В данном поле отображается, включено ли SMS-оповещение для данного сервиса.
  • Лог. В данном поле отображается, включено ли логирование для данного сервиса.
  • Статус. В данном поле отображается текущий статус сервиса.


На панели инструментов расположены кнопки:

Список объектов


В данном окне можно указать перечень объектов, данные которых будут передаваться сервисом ретрансляции. Сервер не будет ретранслировать данные, если список пуст.

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

В случае успешного добавления, вы увидите в таблице новую запись. Если записей слишком много, для поиска конкретного объекта в списке можно воспользоваться соответствующим полем: . Введите ID объекта (любой из двух: в базе или для отправки) и нажмите на кнопку . Программа выделит запись с указанным ID.

Поля таблицы содержат следующую информацию:
  1. Дата внесения. Сюда записывается время добавления объекта в список.
  2. ID в базе. Идентификатор объекта в оригинальной базе данных.
  3. ID для отправки. Идентификатор объекта в базе данных, куда производится ретрансляция.
  4. Последняя точка. Здесь пишется временная отметка последней отправленной точки.
  5. Отправлено точек. В данной ячейке отображается число точек, отправленных сервисом ретрансляции за последние 24 часа. Каждые 24 часа счётчик обнуляется.


Информацию из таблицы можно экспортировать в файл MS Excel(расширение .xls,.xlsx) нажатием кнопки Экспортировать. В появившемся диалоговом окне необходимо указать путь к месту сохранения файла, а также ввести имя файла и выбрать расширение:



После нажатия кнопки "Сохранить" в указанном месте появится файл, который можно открыть в программе Microsoft Office Excel:


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


Чтобы удалить объект из списка, выделите запись в таблице, содержащую ID данного объекта, щелчком левой кнопки мыши либо при помощи поля поиска. Затем нажмите кнопку УдалитьУдалить. Подтвердите своё действие нажатием кнопки "Да". После удаления объекта, соответствующая строка таблицы исчезнет и ретрансляция данных об объекте будет остановлена. Возобновить процесс ретрансляции можно, повторно добавив объект в список.

Добавление нового сервиса ретрансляции

В открывшемся окне необходимо указать параметры нового сервиса:


Список полей:
  • Системное имя службы*. Наименование сервиса, которое будет использоваться системой. Нельзя изменить в дальнейшем.
  • Имя службы*. Наименование сервиса, которое предоставляется пользователю при выводе информации.
  • Протокол*. В данном поле необходимо указать коммуникационный протокол, по котором производится передача данных от автотрекеров.
  • Сервер приёма*. Из выпадающего списка необходимо выбрать сервер, на который будет осуществляться ретрансляция.
  • Минимальный порог*. В данном поле необходимо указать минимально допустимое соотношение Активных объектов к Общему числу объектов (в процентах, %). В случаях, когда данное значение будет опускаться ниже указанного порогового, система будет выдавать оповещение.
  • Количество потоков*. В данном поле необходимо указать число потоков, создаваемых при передаче данных. Значение по-умолчанию - 3.
  • Лимит запроса в базу*. В данном поле пользователь может указать максимальное количество строк, которое сервис может запросить из базы данных.
  • Количество точек в одном пакете*. В данном поле пользователь может указать, какое количество точек, характеризующих навигационные координаты объекта, сервер будет помещать в единицу передачи данных (пакет).
  • Таймаут ответа*. В данном поле необходимо указать время ожидания ответа от сервера в секундах. Если время ожидания превысит указанное значение, произойдёт повторная отправка пакета.
  • ID последней точки. В данном поле можно указать Идентификационный номер точки, обозначающей географическое положение объекта, с которой сервер начнёт ретрансляцию. По-умолчанию значение - 0, то есть ретрансляция будет вестись с самой первой точки, имеющейся в базе данных.


Поля, отмеченные "*" обязательны для заполнения, иначе сервер ретрансляции не будет добавлен!

Если существует необходимость произвести ретрансляцию не с самой первой точки, а с определённого момента времени, то следует воспользоваться функцией Выбора ID последней точки. Для этого необходимо в поле выставить интересующую вас дату и время (в формате UTC) и нажать кнопку Определть. В соответствующее поле автоматически будет помещён ID точки, соответствующей указанной вами временной отметке.

Также существует возможность управлять поведением сервера ретрансляции путём выставления флагов:
  • SMS-оповещение. Флаг установлен - сервер будет отправлять оповещение через SMS при превышении порогового значения неактивных объектов. Флаг снят - SMS-оповещение использоваться не будет.
  • Запись лога. Если флаг установлен - сервер будет вести записи обо всех событиях приёма-передачи данных с указанием источника и временной отметки. Флаг снят - записи вестись не будут.
  • Разрешить дублирование объектов. Если флаг установлен - сервер может создавать копии одного и того же объекта с разным ID. Флаг снят - каждый объект хранится в базе в единственном экземпляре.


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

В случае успешного завершения операции, будет выведено сообщение:


Удаление сервиса ретрансляции

При нажатии на кнопку будет выведено диалоговое окно, в котором пользователь должен подтвердить удаление сервиса:


uninstall

В случае подтверждения удаления нажатием кнопки "Да", сервис будет удалён.

В случае отмены действия нажатием кнопки "Нет", сервис продолжит свою работу в прежнем режиме.

Настройки

Если вам требуется внести изменения в конфигурацию сервиса, вы можете это сделать в соответствующем окне:

Учтите, что изменить системное имя службы невозможно, изменение таких параметров как "Сервер приёма" и "Лимит запроса в базу" требуют перезапуска службы, а параметр ID последней точки доступен для изменения только когда служба отключена (Статус: Остановлена). Причём требуется остановка не только сервиса ретрансляции, но и того сервиса приёма данных, с которого производится ретрансляция.


Если вы не планировали изменять настройки сервиса, нажмите кнопку Отмена.

Для подтверждения изменений нажмите кнопку Сохранить.

В случае успешного изменения настроек, будет выведено сообщение:

Лог управления


Лог хранит записи в формате таблицы со следующими полями:
  • Временная отметка.
  • Ф.И.О. пользователя, вызвавшего событие управления.
  • Описание события управления.

Лог службы


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

В поле можно указать интересующий вас период времени.

В поле можно установить фильтр записей по ID объекта.

После выбора временного промежутка и установки фильтра(опционально) нажмите кнопку Update, чтобы вывести на экран содержимое журнала.

Журнал выводится в виде таблицы со следующими столбцами:
  1. Дата. Содержит временную отметку, обозначающую время передачи данных - момент времени, когда ретранслятор передал данные другому сервису.
  2. ID объекта. Содержит идентификационный номер объекта, присвоенный ему сервисом ретрансляции (может не совпадать с оригинальным ID объекта).
  3. Дата точки. Содержит временную отметку, обозначающую время создания точки - момент времени, когда было зафиксировано местоположение наблюдаемого объекта.
  4. Данные. Содержит идентификатор точки.


Для мониторинга журнала событий в режиме реального времени можно воспользоваться флагом Автообновление. Обновление таблицы будет производиться каждые 5 секунд. Одновременно с этим к крайнему сроку временного периода будет автоматически добавляться 5 секунд: TimeUpdate

Дополнительные сервисы


Таблица содержит следующую информацию о дополнительных сервисах:
  • Название службы, указанное при регистрации.
  • Сведения о работе службы.
  • Статус службы.


Панель инструментов:



Содержит кнопки для управления дополнительными сервисами:

Добавление нового дополнительного сервиса

На примере службы резервного копирования:




Сервис резервного копирования осуществляет копирование таблиц records, obj, objgr, suser. Таблицы синхронизируются каждый час. Недостающие записи восстанавливаются, но избыточные записи не удаляются. Для осуществления резервного копирования необходимо указать ряд параметров:
  • Хост. IP-адрес либо DNS-имя сервера, на котором расположена база данных.
  • Порт. Номер сетевого порта, на котором работает база данных.
  • Логин. Имя пользователя для доступа к БД.
  • Пароль. Парольная информация для доступа к БД.
  • БД. Название базы данных.
  • Последний ID. Идентификационный номер записи, с которой начинается копирование.
  • Шаг. Число записей БД, обрабатываемых сервисом за раз.
  • Принцип присвоения ID. Новый ID - каждой скопированной записи будет присвоен новый идентификатор. Копировать ID - каждой скопированной записи будет присвоен ID такой же, как у оригинала.


Есть возможность включить ведение журнала событий, поставив флажок в поле Лог.

После выбора параметров работы сервиса нажмите кнопку Сохранить, чтобы добавить сервис в систему. Или кнопку Закрыть, чтобы отменить добавление.

Настройка дополнительного сервиса

В данном окне пользователь имеет возможность изменить параметры работы дополнительного сервиса:

Сменить системное имя и тип сервиса в настройках нельзя!


Если вы не планировали изменять настройки сервиса, нажмите кнопку Отмена.

Для подтверждения изменений нажмите кнопку Сохранить.

В случае успешного изменения настроек, будет выведено сообщение:

Журнал событий дополнительного сервиса

Прочее

Статусы сервиса


В определённый момент времени сервис может иметь только один статус, описывающий его текущее состояние.

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