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

Версия 2.2 от PROSTO:СКУД на 2026/10/14 12:34

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 выполнены следующие действия:

Сервер OVISION запущен, сетевой порт API доступен для сервера "1С:Предприятие".
В OVISION заведены терминалы распознавания лиц (Точки доступа) и зоны (Территории).

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

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

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

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

Нажмите «Создать» и заполните основные параметры:
- Наименование: OVISION (или понятное имя филиала/проходной).
- Вид системы контроля доступа: выберите O-VISION.
- При помощи признака «Используется» можно отключать/включать интеграцию с конкретным сервером СКУД, например, на время отладки.
Заполните блок «Данные подключения»:
- Сервер: сетевой IP-адрес или доменное имя сервера OVISION.
- Логин / Пароль: учетные данные пользователя OVISION с правами администратора.
- Нажмите кнопку «Проверить соединение».
При успешном подключении система выдаст сообщение: «Соединение установлено».
Нажмите «Записать».

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

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

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

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

Порт — порт сервера 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) пишутся в регистр «История обмена со СКУД».
Использовать отложенную выгрузку: изменения регистрируются в узле обмена и выгружаются регламентным заданием по расписанию, а не в момент записи объекта.

5. Начальная синхронизация с OVISION

Существует два подхода начала работы с системой:

Все справочные данные создаются в системе PROSTO:СКУД и выгружаются в СКУД регламентным заданием после настройки (см. раздел 6).
СКУД OVISION уже запущена на момент внедрения и содержит данные. Для этого в системе PROSTO:СКУД предусмотрена обработка Начальной синхронизации.

Механика обработки:

Выберите Систему контроля доступа и, перемещаясь между вкладками в порядке их расположения, поочередно синхронизируйте объекты.
Для отображения данных в табличной части нажмите «Заполнить». Каждая запись об объекте разделяется на две строки: первая — данные из 1С, вторая — данные из СКУД.
Первичное сопоставление производится по SID и по наименованию (для сотрудников — по SID, а при пустом SID по ФИО и Табельному номеру). При расхождении данных в первой колонке указывается, что значения различаются; данные можно сопоставить вручную либо создать недостающие объекты обработкой.
Выберите приоритет синхронизации: 1С (выгрузка в СКУД) или СКУД (загрузка из СКУД), отметьте строки флажками и нажмите «Синхронизировать».
При успешной синхронизации в первой колонке появится надпись «Данные синхронизированы», а в регистре сведений «Идентификаторы объектов СКУД» создастся запись идентификатора (SID) объекта.

5.1 Организации и Подразделения.

При создании организационной структуры предприятия в системе OVISION организации встают в верхний уровень иерархии справочника «Подразделения» корневой элемент, который находится в разделе «Объекты» название которого обычно совпадает с названием предприятия (организации). Подразделения тоже хранятся в справочнике «Подразделения», с возможностью создания многоуровневого раскрывающегося списка структурных подразделений.

Первичное сопоставление данных происходит по наименованию. Возможна двухсторонняя интеграция:
- Приоритет 1С: в OVISION создаются соответствующие организации и подразделения с сохранением иерархии (родительских папок).
- Приоритет СКУД: в 1С загружаются организации и подразделения.
- С настройкой СинхронизироватьТолькоДействующиеПодразделения расформированные подразделения не выгружаются и не сопоставляются.

5.2 Территории и Контроллеры.

Территории и контроллеры находятся в разделе «Зоны и устройства» в соответствующих вкладках.

При синхронизации возможно только получение из СКУД в 1С: на вкладках «Территории» и «Контроллеры» нажмите «Заполнить» -> «Синхронизировать». Контроллеры загружаются с привязкой к SID OVISION. При повторном нажатии дубли не создаются. Создание территорий и контроллеров в OVISION из 1С отключено.

После синхронизации для рабочих территорий в справочнике «Территории (СКУД)» необходимо установить флаг «Это рабочая территория».

После синхронизации Контроллеров найти их можно в аналогичном справочнике. После создания элемента справочника Контроллеры в поле «Территория вход» указывается территория, на которую попадает сотрудник при входе на предприятие. «Территория выход» – заполняется аналогично и определяет территорию выхода.