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

Версия 3.1 от PROSTO:СКУД на 2026/10/14 13:03

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С отключено.

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

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

5.3 Сотрудники

В системе OVISION список сотрудников представляет собой справочник «Объекты», который находится в разделе "Объекты"

Первичное сопоставление данных происходит по SID; если SID пустой — по связке ФИО + Табельный номер, без создания дублей.

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

Фильтры: Синхронизировать Только Работающих Сотрудников исключает уволенных из таблицы; Синхронизировать Сотрудников Всех Организаций исключает, отображение сотрудников всех организаций базы, в таблице будут видны только организаций из разрешенного списка.

5.4 События СКУД

Вкладка предназначена для ручной загрузки данных о событиях проходов сотрудников, которые зафиксировал тот или иной контроллер доступа.

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

Данные в колонках табличной части:

Дата – показывает дату и время, когда сотрудником (физическим лицом) был осуществлен проход через турникет;
Физ. лицо – отражает полные фамилию, имя и отчество сотрудника;
Контроллер – отражает информацию о том, через какой контроллер был осуществлен проход;
Дверь – отображаются данные о направлении прохода, где «0» - это вход, а «1» - выход;
Территория – отражает данные о том, на какую территорию был осуществлен проход;
Карта – отражает номер карты, которая была использована при проходе.

6. Настройка автоматического обмена данными с PERCo-Web и получение событий проходов сотрудников

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

Для настройки автоматического обмена данными со СКУД необходимо в Сервисах и настройках открыть форму плана обмена «Узлы регистрации объектов для выгрузки в СКУД», где для каждой СКУД в которую планируется выгрузка данных создать узел обмена.

Далее в дополнительных отчетах и обработках во внешней обработке «Регламентные задания СКУД» можно настроить расписание выгрузки.

В этой же обработке задается «Импорт событии СКД (СКУД)» - т.е. периодичность, с которой система будет обращаться к настроенным в ней СКУД и получать события проходов через турникеты.

После описанных выше настроек система будет в автоматическом режиме выгружать данные в СКУД в зависимости от настроек.