Интеграция с ПАК ВсМК
Функциональные возможности взаимодействия:
Передача и отмена тревог в ПАК ВсМК по команде оператора;
Получение уведомлений о статусах тревог и изменениях данных объектов в ПАК ВсМК;
Создание, модификация и управление состоянием объектов в ПАК ВсМК;
Автоматическое обновление сведений об объектах в ПАК ВсМК;
Мониторинг состояния связи с ПАК ВсМК.
Возможности интеграции с ПАК ВсМК доступны в «Приток-А» версии 3.8.3.13 и выше.
1. Схема взаимодействия
Интеграция системы «Приток-А» с ПАК ВсМК реализована на программном уровне по протоколу API ПАК ВсМК на базе HTTP (Рис. 1).
Рис. 1. Общая схема взаимодействия
API ПАК ВсМК обеспечивает автоматизацию взаимодействия между информационными системами мониторинговых организаций и программно-аппаратным комплексом взаимодействия с мониторинговыми компаниями подразделений вневедомственной охраны Росгвардии.
В рамках этой интеграции «Ядро» системы «Приток-А» (далее — Ядро) осуществляет двусторонний обмен данными с сервером ПАК ВсМК. После установки подключения и авторизации Ядро проверяет доступность сервера не реже одного раза в минуту. Все исходящие запросы обрабатываются в очереди с приоритетами, где наивысший приоритет имеет отправка тревожных сообщений. При обрыве связи система фиксирует аварию в стакане «Неисправности пультового оборудования» и ежеминутно повторяет попытки подключения. После каждого восстановления соединения Ядро запрашивает с сервера ПАК ВсМК актуальный список объектов и тревог для синхронизации данных. Для приема входящих уведомлений Ядро открывает сетевой порт.
Передача тревог в ПАК ВсМК выполняется по команде оператора из «АРМ ДПЦО» или «АРМ ДО/ДПУ» (далее — АРМ), если карточка «Приток-А» (далее — карточка) ранее была привязана к объекту ПАК ВсМК (далее — объект). Соответствующая привязка предварительно настраивается в веб-интерфейсе инженера. После её выполнения синхронизация данных происходит автоматически: актуальные сведения отправляются в ПАК ВсМК сразу после привязки карточки к объекту, а также при сохранении изменений в параметрах, передаваемых в ПАК ВсМК.
2. Подготовка к работе
2.1. Установка модуля активации
Возможности интеграции активируются только после добавления специального модуля в директорию установки системы «Приток-А». Имя файла модуля и его расположение зависят от версии операционной системы:
Windows:
prtvcmk.dll(win32) илиprtvcmk64.dll(win64) в каталог установки «Приток-А» (по умолчаниюc:\Sokrat\Prtiok-3.8\);Linux:
prtvcmk.so(linux64) в каталог/opt/sokrat/pritoka/и/opt/sokrat/pritoka-arm/.
Примечание
Применение модуля активации регистрируется в журналах работы каждого приложения.
Каждое приложение системы независимо от других проверяет наличие этого модуля при запуске. При его обнаружении приложение активирует соответствующие инструменты взаимодействия:
Контрольная панель системы — появляются параметры для настройки подключения Ядра к ПАК ВсМК (Рис. 2).
Рис. 2. Параметры подключения к ПАК ВсМК в Контрольной панели системы
АРМ «Конфигуратор» и веб-интерфейс администратора — отображается системный параметр «11.3 Включить возможность передачи тревог в ПАК ВсМК» (Рис. 3).
Рис. 3. Системные параметры в веб-интерфейсе администратора
Веб-интерфейс инженера — в окне редактирования карточки на вкладке «Сервисы» становится доступен блок «Объект ПАК ВсМК» (Рис. 4), а в списке карточек вкладка-фильтр «ПАК ВсМК».
Рис. 4. Вкладка «Сервисы» окна редактирования карточки веб-интерфейса инженера
АРМ ДПЦО и АРМ ДОДПУ — на панель действий оператора, вкладку «Действия» и в контекстное меню тревог добавляются кнопки и пункты меню для передачи тревог в ПАК ВсМК (Рис. 5).
Рис. 5. Инструменты АРМ ДОДПУ для передачи тревог в ПАК ВсМК
2.2. Добавление реагирующей организации
Передача тревог оператором АРМ доступна только для организаций, внесенных в справочник Реагирующие организации. Чтобы оператор мог направлять тревоги в ПАК ВсМК, в этот справочник необходимо добавить специальную запись.
Для включения записи «ПАК ВсМК» выполните следующие шаги:
Войдите в веб-интерфейс администратора.
Перейдите в раздел Параметры системы.
На вкладке «По категориям» в левом меню выберите категорию «11. Интеграция».
Включите параметр «11.3 Включить возможность передачи тревог в ПАК ВсМК» (Рис. 3), установив переключатель в положение «Да».
Сохраните новое значение параметра, нажав Сохранить.
После сохранения в справочник реагирующих организаций будет добавлен неизменяемый элемент «ПАК ВсМК», доступный для выбора в интерфейсе АРМ.
Удалить реагирующую организацию «ПАК ВсМК» можно, только установив значение параметра «11.3 Включить возможность передачи тревог в ПАК ВсМК» в «Нет».
3. Настройка параметров подключения
Для настройки интеграции необходимо задать параметры как на стороне системы «Приток-А», так и на стороне ПАК ВсМК для организации обратной связи.
Важно
Перед началом настройки подключения необходимо оформить договор на информационно-техническое обслуживание с ООО «Бизнес Мониторинг» и получить учетные данные для доступа в «АРМ Администратора МК» ПАК ВсМК.
3.1. Настройка параметров Ядра
Параметры подключения настраиваются через Контрольную панель системы (Рис. 2) либо напрямую в конфигурационных файлах pritok.ini (Windows) / pritoka.conf (Linux) в секции [KERNEL]. Учетная запись, используемая для подключения, должна иметь роль «Сотрудник МК».
Контрольная панель системы |
pritok.ini |
pritoka.conf |
|---|---|---|
ПАК ВсМК: Включить подключение |
|
|
ПАК ВсМК: Имя пользователя |
|
|
ПАК ВсМК: Пароль |
|
|
ПАК ВсМК: Порт обратной связи |
|
|
ПАК ВсМК: Протоколировать работу подключения |
|
|
Параметр Включить подключение включает или отключает взаимодействие Ядра с ПАК ВсМК. Чтобы включить необхоидмо указать в значении параметра: 1.
В параметрах Имя пользователя и Пароль необходимо указать учётные данные пользователя ПАК ВсМК с ролью «Сотрудник МК». Такого пользователя необходимо создать в «АРМ Администратора МК» ПАК ВсМК на странице «Управление пользователями».
В параметре Порт обратной связи указывается сетевой порт, на который ПАК ВсМК будет отправлять уведомления в Ядро.
Предупреждение
При настройке подключения убедитесь, что указанный порт обратной связи свободен и не блокируется сетевым экраном (брандмауэром) или не занят другими службами.
Параметр Протоколировать работу подключения отвечает за запись в журнал сведений о работе подключения с ПАК ВсМК. Данные сохраняются в журнал работы Ядра vcmk_*.log, который расположен в директории C:\Sokrat\Pritok-3.8\Logs\kernel (Windows) или /var/log/sokrat/pritoka/kernel (Linux). Рекомендуемое значение параметра: 1.
Примечание
После установки параметров необходимо перезапустить службу Ядра.
3.2. Настройка уведомлений ПАК ВсМК
Чтобы Ядро могло получать уведомления от ПАК ВсМК, необходимо войти в «АРМ Администратора МК» ПАК ВсМК и заполнить параметры в группе «Настройки callback» (Рис. 6):
URL-обновления объекта
http:// <адрес_ядра>:<порт_ядра> /object
URL-обновления тревог
http:// <адрес_ядра>:<порт_ядра> /alerts
По этим URL-адресам ПАК ВсМК отправляет уведомления:
об изменениях в данных и статусах объектов, внесенных через интерфейс ПАК ВсМК;
о действиях по тревогам при реагировании.
Рис. 6. Настройка API в ПАК ВсМК
4. Работа с объектом
Перед отправкой тревожных извещений карточку необходимо привязать к объекту, а также убедиться, что этот объект согласован и принят под охрану подразделением Росгвардии.
4.1. Заполнение карточки
Данные из карточки передаются в ПАК ВсМК автоматически при привязке и при каждом последующем сохранении изменений. Перед выполнением привязки необходимо проверить корректность и полноту заполненных в карточке сведений.
При передаче данных информация из карточки записывается в поля объекта по следующим правилам:
Вкладка «Сервисы» (блок «Объект ПАК ВсМК»)
Поле «Подразделение» → поле «Подразделение».
Поле «Пультовый номер» → поле «Пультовый номер» (ключ).
Таблица «Зоны объекта» (элементы) → таблица «Зоны».
Вкладка «Описание»
Поле «Тип объекта» → поле «Тип объекта».
Поле «Категория» → поле «Категория объекта».
Поле «Наименование объекта» → поле «Наименование».
Таблица «Телефоны» (объединенное значение) → «Телефон на объекте».
Поле «Адрес» → «Адрес объекта».
Поля «Характеристика объекта», «Описание объекта», «Описание блокировки» (объединенное значение) → «Характеристика объекта, уязвимые места и места возможного проникновения».
Вкладка «Карта»
Поле «Описание маршрута движения» → «Адрес объекта» (комментарий).
Вкладка «Доступ»
Список персон (тип «Клиент») → список «Доверенные лица».
При каждом сохранении карточки, привязанной к объекту ПАК ВсМК, система проверяет данные на соответствие требованиям внешней платформы.
Примечание
Сохранение карточки будет прервано, если не заполнено хотя бы одно из обязательных полей: «Наименование объекта», «Адрес», «Тип объекта», «Подразделение» или «Пультовый номер».
В окне редактирования карточки веб-интерфейса инженера, при открытии вкладки «Сервисы» система «Приток-А» автоматически запрашивает актуальные данные из «ПАК ВсМК». Если запрос завершается ошибкой, система отображает последние сохраненные параметры объекта, а их редактирование блокируется до успешного обновления данных. При обнаружении расхождений между сведениями в «ПАК ВсМК» и «Приток-А» в интерфейсе карточки появляется соответствующее уведомление.
4.2. Привязка карточки к объекту
Чтобы привязать карточку к объекту (Рис. 7), необходимо выполнить следующие действия:
Откройте карточку «Приток-А» в веб-интерфейсе инженера.
Перейдите на вкладку «Сервисы».
В блоке «Объект ПАК ВсМК» нажмите кнопку Привязать объект.
В открывшемся окне выбора найдите и выберите существующий объект, либо создайте новый, нажав кнопку Создать новый объект (по умолчанию новому объекту присваивается пультовый номер карточки).
При необходимости выберите подразделение для реагирования и привяжите зоны объекта.
Проверьте корректность заполнения параметров объекта.
Сохраните карточку.
Примечание
Если при привязке в окне выбора объект должен быть в списке, но его не удается найти, попробуйте нажать Обновить для синхронизации данных и повторного поиска.
Выполнить привязку всех зон карточки можно нажав кнопку Заполнить автоматически в блоке «Объект ПАК ВсМК». После нажатия текущие зоны объекта будут очищены и вместо них созданы новые с привязкой к устройствам в конфигурации.
Рис. 7. Привязка карточки к объекту
После успешного сохранения карточки в системе «Приток-А» формируется её привязка к объекту, а актуальные данные автоматически передаются в ПАК ВсМК. С этого момента для привязанной карточки доступна передача тревог из АРМ в ПАК ВсМК. При попытке повторной привязки уже привязанных карточек или объектов система выдаст соответствующее предупреждение.
Важно
ПАК ВсМК принимает в обработку тревоги только по объектам со статусом «На охране» (см. Статусы объекта).
После привязки карточки и всех ее привязанных зон автоматически устанавливается реагирующая организация по умолчанию: «ПАК ВсМК».
Изменения привязки карточки к объекту фиксируется в протоколе действий по карточке. Просмотреть его можно в АРМ Конфигуратор на вкладке «Протокол действий» и веб-интерфейсе инженера в окне редактирования карточки на вкладке «Протокол» (Рис. 8).
Рис. 8. Протокол действий по карточке
4.3. Согласование объекта
После создания нового объекта его можно отправить на согласование инженеру ОВО в указанное в объекте подразделение. Для этого в выпадающем меню блока «Объект ПАК ВсМК» (кнопка с тремя точками) выберите пункт Отправить на согласование.
Если объект находится в статусе «Новый объект» или «Отключен», эта кнопка также вынесена на панель быстрого доступа рядом с иконкой состояния (Рис. 9).
Рис. 9. Отправить объект на согласование
После успешного согласования заявки инженером ОВО статус объекта изменится на «Объект на охране».
Когда объект переходит в статус «Объект на охране», «Приток-А» запоминает его состояние. Таким образом если позже внести изменения в карточку или объект, на вкладке «Сервисы» появится предупреждение о повторном согласовании. Уведомление можно скрыть до следующих правок или сразу отправить объект на согласование по кнопке в предупреждении либо через выпадающее меню блока «Объект ПАК ВсМК», если позволяет статус.
4.4. Отключение объекта
Для отключения (снятия с реагирования) объекта необходимо нажать кнопку Отключить в выпадающем меню блока «Объект ПАК ВсМК» (Рис. 10).
Предупреждение
Если по объекту есть активная тревога, то отключить его НЕЛЬЗЯ.
После отключения объект можно повторно отправить на согласование.
Рис. 10. Отключить объект
4.5. Статусы объекта
Наименование |
Описание |
|---|---|
Новый объект |
Объект создан и не передан на согласование.
|
Объект на согласовании |
Объект передан на согласование, ожидает решения инженера ОВО.
|
Объект на охране |
Объект прошел согласование и принят под охрану.
|
Отклонен |
Объект не прошел согласование.
|
Отключен |
Объект отключен (не обслуживается).
|
На охране / проверка |
Объект передан на повторное согласование.
|
На охране / изм. отклонены |
Объект не прошел повторное согласование.
|
Охрана приостановлена |
Обслуживание объекта временно остановлено.
|
5. Передача тревог на реагирование
5.1. Передача тревог
Передать тревогу по карточке в ПАК ВсМК можно из АРМ одним из следующих способов:
- Через контекстное меню (Рис. 11)
В списке тревог нажмите правой кнопкой мыши на строку нужной карточки и выберите .
Рис. 11. Передача тревог в ПАК ВсМК через контекстное меню
- Через вкладку «Действия» (Рис. 12)
Выберите карточку в главном окне, перейдите на вкладку «Действия» и нажмите кнопку Передать в ПАК ВсМК.
Рис. 12. Передача тревог в ПАК ВсМК через вкладку «Действия»
- Из окна «Переданные на реагирование» (Рис. 13)
Выберите карточку в главном окне, в области «Переданные на реагирование» выделите строку организации «ПАК ВсМК» и нажмите кнопку Передать.
Рис. 13. Передача тревог в ПАК ВсМК из окна «Переданные на реагирование»
- Из панели действий оператора (Рис. 14)
Выберите карточку в главном окне, на панели действий оператора откройте меню и выберите пункт .
Рис. 14. Передача тревог в ПАК ВсМК из панели действий оператора
Если карточка не находилась в состоянии тревоги, система автоматически переведет её в тревожное состояние, сформирует оперативную тревогу и передаст данные в ПАК ВсМК.
5.2. События по реагированию
После передачи тревоги на реагирование все действия дежурного ОВО полученные в уведомлениях из ПАК ВсМК фиксируются в истории по карточке (Рис. 15). События, связанные с ПАК ВсМК, имеют значение «ПАК ВсМК» в колонке «Пользователь».
Рис. 15. События по реагированию тревоги переданной в ПАК ВсМК
При отправке тревоги оператором АРМ в системе последовательно фиксируются событие «Назначена на реагирование» и результат передачи в ПАК ВсМК. При успешной отправке регистрируется событие «Доставлена» с указанием принявшего тревогу подразделения, а Ядро добавляет в комментарий его контакты, если они заданы. После этого тревога поступает в обработку дежурному ОВО. Если же передать тревогу не удалось, фиксируется событие «Не доставлена».
Список событий, получаемых системой «Приток-А» из ПАК ВсМК:
Принята — дежурный ОВО взял тревогу в работу.
Отметка о вызове ГЗ — дежурный ОВО зафиксировал вызов группы задержания.
Отмена вызова ГЗ — дежурный ОВО зафиксировал отмену вызова группы задержания.
Отметка о прибытии — дежурный ОВО зафиксировал прибытие группы задержания на объект.
Результат осмотра — дежурный ОВО зафиксировал итоги осмотра после доклада группы.
Добавлен комментарий реагированию — добавлен комментарий от Ядра, оператора ОВО или комментарий к событию.
Завершено реагирование — дежурный ОВО завершил обработку тревоги.
Примечание
Комментарий по реагированию, добавленный оператором в АРМ, сохраняется в истории карточки, но не передается в ПАК ВсМК.
Если в момент возникновения событий связь с сервером ПАК ВсМК отсутствовала, после её восстановления «Приток-А» зафиксирует пропущенные события или только факт завершения обработки, если к этому моменту тревога уже завершена. При расхождении времени получения события в «Приток-А» и его регистрации в ПАК ВсМК исходное время указывается для события в колонке «Информация» в угловых скобках <>.
5.3. Контроль процесса реагирования
Отслеживать ход реагирования можно в АРМ в окне «Переданные на реагирование» и в истории по карточке.
Окно «Переданные на реагирование» можно открыть из меню «Окна» главного меню АРМ. В этом окне отображается список реагирующих организаций и переданные в них незавершенные тревоги. Тревоги, отправленные в ПАК ВсМК, отображаются как дочерние элементы соответствующей реагирующей организации.
Для каждой записи в строке отображаются:
номер тревожной карточки;
время передачи на реагирование;
время последнего события;
текущее состояние;
последний зафиксированный комментарий.
Контроль переданной тревоги в системе «Приток-А» прекращается при её отмене или поступлении события «Завершено реагирование». При этом в истории карточки фиксируется событие «Обработана», а запись автоматически удаляется из окна «Переданные на реагирование».
Примечание
Если тревога завершена со стороны ПАК ВсМК, но отображается в окне «Переданные на реагирование», оператору следует отменить её вручную.
5.4. Отмена переданной тревоги
Если тревога была передана в ПАК ВсМК по ошибке или необходимость в реагировании отпала, оператор АРМ может отменить её. Процедура выполняется аналогично отправке тревоги, но в интерфейсе выбирается действие для отмены.
При успешной передаче отмены в ПАК ВсМК в истории карточки фиксируется соответствующее событие.