Настройка интеграции c OVISION

Версия 1.2 от PROSTO:СКУД на 2026/10/13 12:40

1. Особенности интеграции с OVISION

Биометрическая система контроля доступа O-VISION построена на технологиях высокоточного распознавания лиц. Интеграция модуля PROSTO:СКУД с O-VISION выполняется по протоколу REST API (HTTPS/OAuth2) напрямую с сервером СКУД.

Особенности модели данных OVISION:

1. Модель данных OVISION — двухуровневая:
   Объект (персона, ФИО) -> Профиль сотрудника (привязка Подразделения, Табельный номер) -> Карта -> Уровень доступа.
   При создании сотрудника из 1С интеграция создает Объект и привязанный к нему Профиль. К профилю в веб-интерфейсе OVISION вручную привязываются карта и уровни доступа.

2. В OVISION оргструктура — это Подразделения. Сценарии кадрового учета (прием, перевод, увольнение) реализуются через Подразделения, а для "архива" уволенных — отдельное Подразделение для уволенных.

3. Состав обмена (текущая версия интеграции):

   Из 1С в OVISION:
   - Организации
   - Подразделения (с иерархией)
   - Сотрудники: Объект + Профиль (ФИО, Табельный номер, Подразделение, Фото)

   Из OVISION в 1С:
   - Территории
   - Контроллеры (терминалы/считыватели)
   - События проходов

   Не выгружаются из 1С в OVISION:
   - Карты доступа и Уровни доступа (заводятся вручную в веб-интерфейсе OVISION)
   - Дополнительные поля (СНИЛС, ИНН, дата приема, дата увольнения, дата рождения, должность, гражданство)

4. Территории и Контроллеры — только получение из СКУД. Создание этих объектов в OVISION из 1С отключено.

5. Сопоставление сотрудников выполняется по идентификатору SID; при пустом SID — по связке «ФИО + Табельный номер». 

2. Предварительные требования на стороне OVISION

Перед началом настройки в 1С убедитесь, что на сервере OVISION выполнены следующие действия:

  1. Сервер OVISION запущен, сетевой порт API доступен для сервера "1С:Предприятие".

  2. В OVISION заведены терминалы распознавания лиц (Точки доступа) и зоны (Территории).

 В OVISION должна быть создана сервисная учетная запись с правами Администратора (Administrator). В текущих версиях API OVISION урезанная сервисная роль «Интеграция» может блокировать получение списка сотрудников.

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

  1. Для настройки подключения к СКУД OVISION необходимо перейти в "Настройки подсистемы PROSTO:СКУД" и установить флаг для используемого СКУД.

1791891919630-110.png

1791891832508-224.png

  1. Перейдите в раздел PROSTO:СКУД ➝ Интеграция со СКУД➝ справочник Системы контроля доступа (СКУД).

1791892078709-141.png

  1. Нажмите «Создать» и заполните основные параметры:

    • Наименование: OVISION (или понятное имя филиала/проходной).

    • Вид системы контроля доступа: выберите O-VISION.

    • При помощи признака «Используется» можно отключать/включать интеграцию с конкретным сервером СКУД, например, на время отладки.

  2. Заполните блок «Данные подключения»:

    • Сервер: сетевой IP-адрес или доменное имя сервера OVISION.

    • Логин / Пароль: учетные данные пользователя OVISION с правами администратора.

    • Нажмите кнопку «Проверить соединение».

  3. При успешном подключении система выдаст сообщение: «Соединение установлено».

  4. Нажмите «Записать».

1791892329521-438.png

На второй вкладке указываются дополнительные настройки, отвечающие за параметры и состав данных, участвующих в интеграции. Для первоначальной настройки рекомендуется воспользоваться кнопкой «Заполнить по умолчанию». 

1791892602913-871.png

Описание параметров вкладки «Дополнительные настройки»

На вкладке «Дополнительные настройки» карточки СКУД задаются правила поведения синхронизации:

Блок «Подключение»

  • Порт — порт сервера OVISION (по умолчанию 8 000).

  • Таймаут — время ожидания ответа, сек.

  • Защищенное Соединение — использование SSL.

Блок «Оборудование»

  • Создавать контроллеры (Да): разрешает автоматическое создание элементов в справочнике 1С «Контроллеры» при чтении терминалов из OVISION.

  • Создавать территории (Да): разрешает загрузку зон доступа из OVISION в справочник 1С «Территории».

Блок «Организационная структура»

  • Создавать организации / Создавать подразделения (Да): разрешает создание новых элементов в 1С при получении структуры из OVISION.

  • Создавать организации СКД / Создавать подразделения СКД (Да): разрешает 1С выгружать и создавать новые отделы в дереве подразделений OVISION.

  • Синхронизировать только действующие подразделения (Да): исключает из обмена расформированные подразделения 1С.

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

Блок «Персонал и Фотографии»

  • Создавать физических лиц (Да/Нет): создание карточек физических лиц в 1С при чтении из СКУД.

  • Создавать физических лиц СКД (Да): разрешает создание новых персон (Объект + Профиль) в OVISION при выгрузке из 1С.

  • Создавать фото физических лиц / Создавать фото физических лиц СКД (Да): обеспечивает двусторонний обмен биометрическими фотографиями сотрудников между 1С и OVISION.

  • Синхронизировать только работающих сотрудников (Да): фильтрует выгрузку, исключая уволенных работников.

  • Автоматически выгружать сотрудников в СКУД при приеме на работу (Да): при проведении кадрового приказа в 1С сотрудник автоматически встает в очередь фоновой выгрузки в OVISION.

  • Синхронизировать сотрудников всех организаций СКД: при значении Да выгружаются все сотрудники базы; при Нет — только по организациям из разрешенного перечня.

Блок «Кадровые сценарии» (регламентные задания):

  • Автоматически выгружать сотрудников в СКУД при приеме на работу (Да): при проведении кадрового приказа в 1С сотрудник автоматически встает в очередь фоновой выгрузки в OVISION.
  • Автоматически блокировать сотрудников СКД (Да): при увольнении в 1С профиль сотрудника в OVISION переводится в статус «Заблокирован» (доступ закрывается).

  • Автоматически удалять сотрудников СКД (Нет/Да): физическое удаление объекта сотрудника из базы OVISION (рекомендуется держать выключенным во избежание потери истории).

  • Перемещать Удаляемых Сотрудников — при увольнении сотрудник перемещается в Подразделение Для Уволенных.

  • Подразделение для уволенных: выберите архивный отдел в O-VISION. При увольнении сотрудник будет автоматически перемещен в эту папку.

Блок «Обмен»

  • Регистрировать историю обмена (Да): подробные записи об операциях обмена (объект, статус Успешно/Ошибка, тело ответа API) пишутся в регистр «История обмена со СКУД».

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