Интеграция с Орион Икс🔗

В Macroscop реализована интеграция с АРМ «Орион Икс», разработанными НВП «Болид».

В этом разделе описаны доступные возможности и применяемые компоненты.

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

Примечание

  • Интеграция доступна в версии Macroscop 4.7 и выше.

  • Интеграция производилась с АРМ «Орион Икс» версии 1.2.0.2062.

Настройка Орион Икс🔗

Совет

Шаги по настройке АРМ «Орион Икс» описаны в инструкции Модуль «Сервис интеграции Орион Икс» (раздел Подключение модуля в АРМ «Орион Икс»).

Инструкция доступна на сайте компании НВП «Болид» в описании АРМ «Орион Икс» на вкладке Скачать. (см. раздел Документация, Руководство по работе с модулем «Сервис интеграции Орион Икс»).

Для задания настроек на стороне Macroscop потребуются настройки из приложения Менеджер конфигурации (входит в состав ПО АРМ «Орион Икс»):

  • Настройки канала связи json-rpc: адрес и порт сервера, парольная фраза шифрования подключения.

  • Логин и пароль пользователя для работы с модулем интеграции (Персонал -> Пользователь -> Полномочия).

Настройка Macroscop🔗

Для того чтобы сервер Macroscop мог реагировать на события Орион Икс, необходимо запустить приложение Macroscop Конфигуратор, перейти на страницу ico-automation Автоматизация, выделить камеру в списке, затем переключиться на вкладку Интеграции и включить Орион Икс.

../../_images/automation-camera-integration6.png

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

Время и часовой пояс на сервере Macroscop и на сервере Орион Икс должны совпадать.

В настройках интеграции доступны две вкладки:

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

  • Настройки камеры.

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

На вкладке Общие настройки выполняется общая для всей системы настройка подключения к АРМ «Орион Икс».

Доступны следующие настройки:

  • Адрес контроллера: IP-адрес или доменное имя. Значение по умолчанию: 127.0.0.1.

  • Безопасное подключение (HTTPS): Нажмите на кнопку /config/svg/ico-http-connection.png для использования безопасного подключения.

  • Порт сервера: Значение по умолчанию: 6659.

  • Имя пользователя: Значение по умолчанию: default.

  • Пароль: Значение по умолчанию: default.

  • Парольная фраза шифрования: Соответствует настройке Парольная фраза шифрования подключения в настройке канала связи json-rpc в Орион Икс. Значение по умолчанию: default.

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

../../_images/config-setting-general.png

В поле Статус будет выведен результат проверки:

  • Не протестировано

  • Идёт тестирование...

  • Подключение прошло успешно

  • Система недоступна: Проверьте сетевую доступность сервера Орион Икс, а также настройки сервера системы Орион Икс в приложении Менеджер конфигурации (входит в состав ПО АРМ «Орион Икс»).

  • Неверные учетные данные: Проверьте учётные данные пользователя в приложении Менеджер конфигурации (входит в состав ПО АРМ «Орион Икс»).

  • Истекло время ожидания

  • Неизвестная ошибка

Настройки камеры🔗

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

Примечание

По умолчанию производится приём всех событий АРМ «Орион Икс» от всех устройств.

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

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

Дерево объектов состоит из двух разделов:

  • Устройства: Отображает структуру дерева устройств из раздела Оборудование в ПО АРМ «Орион Икс».

  • Зоны: Отображает папки из ПО АРМ «Орион Икс», содержащие соответствующие зоны/группы:

    • Аппаратные зоны

    • Системные зоны

    • Группы аппаратных зон

    • Группы системных зон

../../_images/camera-settings-devices.png

Примечание

Содержимое папок раздела Зоны представляет собой плоский список без иерархической вложенности.

Примечание

Составные устройства (например, контроллеры) отображаются в списке устройств как папки. Внутри такой папки содержатся устройство и его подустройства.

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

Папка не является объектом получения событий. Для получения событий нужно выбрать устройство внутри этой папки.

Настройка автоматизации🔗

На события, полученные из АРМ Орион Икс, можно настроить любые доступные в Macroscop действия.

Для настройки действий, выполняемых в ответ на события, регистрируемые в системе видеонаблюдения Macroscop, нужно в приложении Macroscop Конфигуратор перейти на страницу ico-automation Автоматизация, выделить в дереве камер отдельную камеру или папку, после чего перейти на вкладку Задачи по событию.

../../_images/event3.png

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

Для задания условий доступны следующие параметры события:

  • Идентификатор источника: Уникальный идентификатор (GUID) в формате строки.

  • Источник: Название объекта в формате строки.

  • Код события: Числовой код события Орион Икс.

  • Событие: Описание события объекта Орион Икс в формате строки.

  • Зона: Название зоны у источника события в формате строки.

../../_images/action-setting4.png

Журнал событий🔗

События Орион Икс отображаются в журнале событий приложения Macroscop Клиент.

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

  • Идентификатор источника: Уникальный идентификатор (GUID) в формате строки.

  • Источник: Название объекта в формате строки.

  • Код события: Числовой код события Орион Икс.

  • Событие: Описание события объекта Орион Икс в формате строки.

  • Зона: Название зоны у источника события в формате строки.

../../_images/events3.png

В панели фильтров на вкладке События доступна фильтрация по событию Орион Икс:

../../_images/event-log-filter3.png

Примечание

Поля Событие, Зона, Источник соответствуют полям плагина Протокол событий из АРМ «Орион Икс».

Поля Код события, Идентификатор источника являются дополнительной информацией.

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

Поля Событие, Зона, Источник могут отсутствовать в описании события, это обусловлено техническими особенностями протокола интеграции Орион Икс:

  • При отсутствии поля Событие проверьте версию АРМ «Орион Икс» и сообщите об этом в техподдержку Macroscop для проверки версии протокола интеграции.

  • Если отсутствует поле Зона, то источник события либо не связан с зоной/группой зон, либо после изменения настроек на стороне Орион Икс сервер Macroscop не был перезапущен.

  • При отсутствии поля Источник проверьте, был ли перезапущен сервер Macroscop после последних изменений настроек на стороне Орион Икс.

Важно

Для использования сценариев автоматизации необходимо настроить Задачи по событию на странице ico-automation Автоматизация в приложении Macroscop Конфигуратор.

Примечание

Для получения информации о событиях Орион Икс можно использовать GET-запросы Macroscop HTTP API: archive_event_types, archive_events и event.

Требования и ограничения🔗

  • Интеграция доступна на серверах под управлением ОС Windows и Linux.

  • Интеграция производилась с АРМ «Орион Икс» версии 1.2.0.2062.

  • Время и часовой пояс на сервере Macroscop и на сервере Орион Икс должны совпадать.

  • Если во время работы интеграции с Macroscop происходит изменение настроек на стороне АРМ «Орион Икс», требуется выполнить перезапуск сервера Macroscop (при необходимости предварительно изменив настройки интеграции).

  • В журнале событий Macroscop отображаются только события устройств и зон/групп зон Орион Икс. Системные события (изменения настроек системы и т.д.), а также события, связанные с действиями операторов, не отображаются.