Интеграция с ПАК ВсМК

Функциональные возможности взаимодействия:

  • Передача и отмена тревог в ПАК ВсМК по команде оператора;

  • Получение уведомлений о статусах тревог и изменениях данных объектов в ПАК ВсМК;

  • Создание, модификация и управление состоянием объектов в ПАК ВсМК;

  • Автоматическое обновление сведений об объектах в ПАК ВсМК;

  • Мониторинг состояния связи с ПАК ВсМК.

Возможности интеграции с ПАК ВсМК доступны в «Приток-А» версии 3.8.3.13 и выше.

1. Схема взаимодействия

Интеграция системы «Приток-А» с ПАК ВсМК реализована на программном уровне по протоколу API ПАК ВсМК на базе HTTP (Рис. 1).

../_images/vcmk_1.png

Рис. 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).

../_images/vcmk_2.png

Рис. 2. Параметры подключения к ПАК ВсМК в Контрольной панели системы

  • АРМ «Конфигуратор» и веб-интерфейс администратора — отображается системный параметр «11.3 Включить возможность передачи тревог в ПАК ВсМК» (Рис. 3).

../_images/vcmk_3.png

Рис. 3. Системные параметры в веб-интерфейсе администратора

  • Веб-интерфейс инженера — в окне редактирования карточки на вкладке «Сервисы» становится доступен блок «Объект ПАК ВсМК» (Рис. 4), а в списке карточек вкладка-фильтр «ПАК ВсМК».

../_images/vcmk_4.png

Рис. 4. Вкладка «Сервисы» окна редактирования карточки веб-интерфейса инженера

  • АРМ ДПЦО и АРМ ДОДПУ — на панель действий оператора, вкладку «Действия» и в контекстное меню тревог добавляются кнопки и пункты меню для передачи тревог в ПАК ВсМК (Рис. 5).

../_images/vcmk_5.png

Рис. 5. Инструменты АРМ ДОДПУ для передачи тревог в ПАК ВсМК

2.2. Добавление реагирующей организации

Передача тревог оператором АРМ доступна только для организаций, внесенных в справочник Реагирующие организации. Чтобы оператор мог направлять тревоги в ПАК ВсМК, в этот справочник необходимо добавить специальную запись.

Для включения записи «ПАК ВсМК» выполните следующие шаги:

  1. Войдите в веб-интерфейс администратора.

  2. Перейдите в раздел Параметры системы.

  3. На вкладке «По категориям» в левом меню выберите категорию «11. Интеграция».

  4. Включите параметр «11.3 Включить возможность передачи тревог в ПАК ВсМК» (Рис. 3), установив переключатель в положение «Да».

  5. Сохраните новое значение параметра, нажав Сохранить.

После сохранения в справочник реагирующих организаций будет добавлен неизменяемый элемент «ПАК ВсМК», доступный для выбора в интерфейсе АРМ.

Удалить реагирующую организацию «ПАК ВсМК» можно, только установив значение параметра «11.3 Включить возможность передачи тревог в ПАК ВсМК» в «Нет».

3. Настройка параметров подключения

Для настройки интеграции необходимо задать параметры как на стороне системы «Приток-А», так и на стороне ПАК ВсМК для организации обратной связи.

Важно

Перед началом настройки подключения необходимо оформить договор на информационно-техническое обслуживание с ООО «Бизнес Мониторинг» и получить учетные данные для доступа в «АРМ Администратора МК» ПАК ВсМК.

3.1. Настройка параметров Ядра

Параметры подключения настраиваются через Контрольную панель системы (Рис. 2) либо напрямую в конфигурационных файлах pritok.ini (Windows) / pritoka.conf (Linux) в секции [KERNEL]. Учетная запись, используемая для подключения, должна иметь роль «Сотрудник МК».

Параметры Ядра для подключения к ПАК ВсМК

Контрольная панель системы

pritok.ini

pritoka.conf

ПАК ВсМК: Включить подключение

Vcmk_Enabled

{vcmk}.Enabled

ПАК ВсМК: Имя пользователя

Vcmk_Username

{vcmk}.Username

ПАК ВсМК: Пароль

Vcmk_Password

{vcmk}.Password

ПАК ВсМК: Порт обратной связи

Vcmk_Port

{vcmk}.Port

ПАК ВсМК: Протоколировать работу подключения

DoLogVcmk

{dolog}.VCMK

Параметр Включить подключение включает или отключает взаимодействие Ядра с ПАК ВсМК. Чтобы включить необхоидмо указать в значении параметра: 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-адресам ПАК ВсМК отправляет уведомления:

  • об изменениях в данных и статусах объектов, внесенных через интерфейс ПАК ВсМК;

  • о действиях по тревогам при реагировании.

../_images/vcmk_6.png

Рис. 6. Настройка API в ПАК ВсМК

4. Работа с объектом

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

4.1. Заполнение карточки

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

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

Вкладка «Сервисы» (блок «Объект ПАК ВсМК»)

  • Поле «Подразделение» → поле «Подразделение».

  • Поле «Пультовый номер» → поле «Пультовый номер» (ключ).

  • Таблица «Зоны объекта» (элементы) → таблица «Зоны».

Вкладка «Описание»

  • Поле «Тип объекта» → поле «Тип объекта».

  • Поле «Категория» → поле «Категория объекта».

  • Поле «Наименование объекта» → поле «Наименование».

  • Таблица «Телефоны» (объединенное значение) → «Телефон на объекте».

  • Поле «Адрес» → «Адрес объекта».

  • Поля «Характеристика объекта», «Описание объекта», «Описание блокировки» (объединенное значение) → «Характеристика объекта, уязвимые места и места возможного проникновения».

Вкладка «Карта»

  • Поле «Описание маршрута движения» → «Адрес объекта» (комментарий).

Вкладка «Доступ»

  • Список персон (тип «Клиент») → список «Доверенные лица».

При каждом сохранении карточки, привязанной к объекту ПАК ВсМК, система проверяет данные на соответствие требованиям внешней платформы.

Примечание

Сохранение карточки будет прервано, если не заполнено хотя бы одно из обязательных полей: «Наименование объекта», «Адрес», «Тип объекта», «Подразделение» или «Пультовый номер».

В окне редактирования карточки веб-интерфейса инженера, при открытии вкладки «Сервисы» система «Приток-А» автоматически запрашивает актуальные данные из «ПАК ВсМК». Если запрос завершается ошибкой, система отображает последние сохраненные параметры объекта, а их редактирование блокируется до успешного обновления данных. При обнаружении расхождений между сведениями в «ПАК ВсМК» и «Приток-А» в интерфейсе карточки появляется соответствующее уведомление.

4.2. Привязка карточки к объекту

Чтобы привязать карточку к объекту (Рис. 7), необходимо выполнить следующие действия:

  1. Откройте карточку «Приток-А» в веб-интерфейсе инженера.

  2. Перейдите на вкладку «Сервисы».

  3. В блоке «Объект ПАК ВсМК» нажмите кнопку Привязать объект.

  4. В открывшемся окне выбора найдите и выберите существующий объект, либо создайте новый, нажав кнопку Создать новый объект (по умолчанию новому объекту присваивается пультовый номер карточки).

  5. При необходимости выберите подразделение для реагирования и привяжите зоны объекта.

  6. Проверьте корректность заполнения параметров объекта.

  7. Сохраните карточку.

Примечание

Если при привязке в окне выбора объект должен быть в списке, но его не удается найти, попробуйте нажать Обновить для синхронизации данных и повторного поиска.

Выполнить привязку всех зон карточки можно нажав кнопку Заполнить автоматически в блоке «Объект ПАК ВсМК». После нажатия текущие зоны объекта будут очищены и вместо них созданы новые с привязкой к устройствам в конфигурации.

../_images/vcmk_7.png

Рис. 7. Привязка карточки к объекту

После успешного сохранения карточки в системе «Приток-А» формируется её привязка к объекту, а актуальные данные автоматически передаются в ПАК ВсМК. С этого момента для привязанной карточки доступна передача тревог из АРМ в ПАК ВсМК. При попытке повторной привязки уже привязанных карточек или объектов система выдаст соответствующее предупреждение.

Важно

ПАК ВсМК принимает в обработку тревоги только по объектам со статусом «На охране» (см. Статусы объекта).

После привязки карточки и всех ее привязанных зон автоматически устанавливается реагирующая организация по умолчанию: «ПАК ВсМК».

Изменения привязки карточки к объекту фиксируется в протоколе действий по карточке. Просмотреть его можно в АРМ Конфигуратор на вкладке «Протокол действий» и веб-интерфейсе инженера в окне редактирования карточки на вкладке «Протокол» (Рис. 8).

../_images/vcmk_8.png

Рис. 8. Протокол действий по карточке

4.3. Согласование объекта

После создания нового объекта его можно отправить на согласование инженеру ОВО в указанное в объекте подразделение. Для этого в выпадающем меню блока «Объект ПАК ВсМК» (кнопка с тремя точками) выберите пункт Отправить на согласование.

Если объект находится в статусе «Новый объект» или «Отключен», эта кнопка также вынесена на панель быстрого доступа рядом с иконкой состояния (Рис. 9).

../_images/vcmk_9.png

Рис. 9. Отправить объект на согласование

После успешного согласования заявки инженером ОВО статус объекта изменится на «Объект на охране».

Когда объект переходит в статус «Объект на охране», «Приток-А» запоминает его состояние. Таким образом если позже внести изменения в карточку или объект, на вкладке «Сервисы» появится предупреждение о повторном согласовании. Уведомление можно скрыть до следующих правок или сразу отправить объект на согласование по кнопке в предупреждении либо через выпадающее меню блока «Объект ПАК ВсМК», если позволяет статус.

4.4. Отключение объекта

Для отключения (снятия с реагирования) объекта необходимо нажать кнопку Отключить в выпадающем меню блока «Объект ПАК ВсМК» (Рис. 10).

Предупреждение

Если по объекту есть активная тревога, то отключить его НЕЛЬЗЯ.

После отключения объект можно повторно отправить на согласование.

../_images/vcmk_10.png

Рис. 10. Отключить объект

4.5. Статусы объекта

Наименование

Описание

Новый объект

Объект создан и не передан на согласование.

Передать тревогу невозможно.
Можно отправить на согласование.

Объект на согласовании

Объект передан на согласование, ожидает решения инженера ОВО.

Передать тревогу невозможно.

Объект на охране

Объект прошел согласование и принят под охрану.

Передать тревогу можно.
Можно отправить на согласование и отключить.

Отклонен

Объект не прошел согласование.

Передать тревогу невозможно.
Можно отправить на согласование и отключить.

Отключен

Объект отключен (не обслуживается).

Передать тревогу невозможно.
Можно отправить на согласование.

На охране / проверка

Объект передан на повторное согласование.

Передать тревогу можно (по ранее согласованным данным).

На охране / изм. отклонены

Объект не прошел повторное согласование.

Передать тревогу невозможно.
Можно отправить на согласование и отключить.

Охрана приостановлена

Обслуживание объекта временно остановлено.

Передать тревогу невозможно.
Можно отключить.

5. Передача тревог на реагирование

5.1. Передача тревог

Передать тревогу по карточке в ПАК ВсМК можно из АРМ одним из следующих способов:

Через контекстное меню (Рис. 11)

В списке тревог нажмите правой кнопкой мыши на строку нужной карточки и выберите Передать в ПАК ВсМК.

../_images/vcmk_11.png

Рис. 11. Передача тревог в ПАК ВсМК через контекстное меню

Через вкладку «Действия» (Рис. 12)

Выберите карточку в главном окне, перейдите на вкладку «Действия» и нажмите кнопку Передать в ПАК ВсМК.

../_images/vcmk_12.png

Рис. 12. Передача тревог в ПАК ВсМК через вкладку «Действия»

Из окна «Переданные на реагирование» (Рис. 13)

Выберите карточку в главном окне, в области «Переданные на реагирование» выделите строку организации «ПАК ВсМК» и нажмите кнопку Передать.

../_images/vcmk_13.png

Рис. 13. Передача тревог в ПАК ВсМК из окна «Переданные на реагирование»

Из панели действий оператора (Рис. 14)

Выберите карточку в главном окне, на панели действий оператора откройте меню ПАК ВсМК и выберите пункт Передать на реагирование.

../_images/vcmk_14.png

Рис. 14. Передача тревог в ПАК ВсМК из панели действий оператора

Если карточка не находилась в состоянии тревоги, система автоматически переведет её в тревожное состояние, сформирует оперативную тревогу и передаст данные в ПАК ВсМК.

5.2. События по реагированию

После передачи тревоги на реагирование все действия дежурного ОВО полученные в уведомлениях из ПАК ВсМК фиксируются в истории по карточке (Рис. 15). События, связанные с ПАК ВсМК, имеют значение «ПАК ВсМК» в колонке «Пользователь».

../_images/vcmk_15.png

Рис. 15. События по реагированию тревоги переданной в ПАК ВсМК

При отправке тревоги оператором АРМ в системе последовательно фиксируются событие «Назначена на реагирование» и результат передачи в ПАК ВсМК. При успешной отправке регистрируется событие «Доставлена» с указанием принявшего тревогу подразделения, а Ядро добавляет в комментарий его контакты, если они заданы. После этого тревога поступает в обработку дежурному ОВО. Если же передать тревогу не удалось, фиксируется событие «Не доставлена».

Список событий, получаемых системой «Приток-А» из ПАК ВсМК:

  • Принята — дежурный ОВО взял тревогу в работу.

  • Отметка о вызове ГЗ — дежурный ОВО зафиксировал вызов группы задержания.

  • Отмена вызова ГЗ — дежурный ОВО зафиксировал отмену вызова группы задержания.

  • Отметка о прибытии — дежурный ОВО зафиксировал прибытие группы задержания на объект.

  • Результат осмотра — дежурный ОВО зафиксировал итоги осмотра после доклада группы.

  • Добавлен комментарий реагированию — добавлен комментарий от Ядра, оператора ОВО или комментарий к событию.

  • Завершено реагирование — дежурный ОВО завершил обработку тревоги.

Примечание

Комментарий по реагированию, добавленный оператором в АРМ, сохраняется в истории карточки, но не передается в ПАК ВсМК.

Если в момент возникновения событий связь с сервером ПАК ВсМК отсутствовала, после её восстановления «Приток-А» зафиксирует пропущенные события или только факт завершения обработки, если к этому моменту тревога уже завершена. При расхождении времени получения события в «Приток-А» и его регистрации в ПАК ВсМК исходное время указывается для события в колонке «Информация» в угловых скобках <>.

5.3. Контроль процесса реагирования

Отслеживать ход реагирования можно в АРМ в окне «Переданные на реагирование» и в истории по карточке.

Окно «Переданные на реагирование» можно открыть из меню «Окна» главного меню АРМ. В этом окне отображается список реагирующих организаций и переданные в них незавершенные тревоги. Тревоги, отправленные в ПАК ВсМК, отображаются как дочерние элементы соответствующей реагирующей организации.

Для каждой записи в строке отображаются:

  • номер тревожной карточки;

  • время передачи на реагирование;

  • время последнего события;

  • текущее состояние;

  • последний зафиксированный комментарий.

Контроль переданной тревоги в системе «Приток-А» прекращается при её отмене или поступлении события «Завершено реагирование». При этом в истории карточки фиксируется событие «Обработана», а запись автоматически удаляется из окна «Переданные на реагирование».

Примечание

Если тревога завершена со стороны ПАК ВсМК, но отображается в окне «Переданные на реагирование», оператору следует отменить её вручную.

5.4. Отмена переданной тревоги

Если тревога была передана в ПАК ВсМК по ошибке или необходимость в реагировании отпала, оператор АРМ может отменить её. Процедура выполняется аналогично отправке тревоги, но в интерфейсе выбирается действие для отмены.

При успешной передаче отмены в ПАК ВсМК в истории карточки фиксируется соответствующее событие.