Настройка интеграции PROSTO:СКУД с биометрической системой O-VISION

1. Описание интеграции

Обмен данными между «1С:Предприятие» и сервером O-VISION выполняется по защищенному протоколу REST API (HTTPS/OAuth2).

Ключевые принципы взаимодействия:

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

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

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

1. Сетевой доступ: Сервер 1С имеет прямой сетевой доступ к серверу O-VISION по порту веб-сервиса (по умолчанию `443` или порт вашей публикации).
2. Топология: В интерфейсе O-VISION созданы терминалы распознавания лиц (Точки доступа) и зоны (Территории).
   

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

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

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

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

4. Параметры синхронизации (Дополнительные настройки)

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

Организационная структура

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

Персонал и биометрия

• Создавать физических лиц СКД (Да): создание новых персон (Объект + Профиль) в O-VISION при выгрузке из 1С.
• Создавать фото физических лиц СКД (Да): выгрузка фотографий сотрудников из 1С в O-VISION для биометрической идентификации.
• Синхронизировать только работающих сотрудников (Да): уволенные сотрудники не выгружаются в активный список.
• Автоматически выгружать сотрудников при приеме на работу (Да):при проведении кадрового приказа в 1С сотрудник автоматически встает в очередь фоновой выгрузки в O-VISION.
• Синхронизировать сотрудников всех организаций СКД: при значении Да выгружаются все сотрудники базы; при Нет — только по организациям из разрешенного перечня.

Увольнение 

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

Подключение

• Порт : порт сервера O-VISION (по умолчанию 8 000).
• Таймаут: время ожидания ответа, сек.
• Защищенное Соединение: использование SSL.

Оборудование

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

Обмен

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

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

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

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

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

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

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

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

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

В системе O-VISION точки прохода и зоны доступа настраиваются администратором в разделе «Зоны и устройства» на соответствующих вкладках.

Шаг 1. Импорт топологии из O-VISION в 1С

Загрузка выполняется через обработку:  
PROSTO:СКУД ➝ Первичная синхронизация данных.

1. Вкладка «Территории»:  

• Перейдите на вкладку, нажмите кнопку «Заполнить» ➝ «Синхронизировать». 
• Зоны доступа запишутся в справочник 1С с сохранением уникальных идентификаторов `SID O-VISION`.

2. Вкладка «Контроллеры»:  

• Перейдите на вкладку, нажмите кнопку «Заполнить» ➝ «Синхронизировать».  
• Биометрические терминалы распознавания лиц будут загружены в справочник 1С «Контроллеры».

Шаг 2. Разметка рабочих зон (Справочник «Территории»)

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

1. Перейдите: PROSTO:СКУД ➝ Справочники ➝ Территории (СКУД).
2. Откройте карточку территории, где непосредственно работают сотрудники (например, *«Цех №1»*, *«Офис»*, *«Склад»*).
3. Установите флаг ☑️ «Это рабочая территория».
4. Нажмите Записать и закрыть.

Шаг 3. Настройка векторов движения (Справочник «Контроллеры»)

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

1. Перейдите: PROSTO:СКУД ➝ Справочники ➝ Контроллеры (СКУД).
2. Откройте карточку нужного терминала/турникета.
3. Заполните параметры направлений:

• Поле «Территория вход»: выберите территорию, на которую попадает сотрудник при успешном распознавании лица на вход (например, *«Офис»* или *«Производственная площадка»*).
• Поле «Территория выход»: выберите территорию, куда направляется сотрудник при выходе (например, *«Улица»*, *«Внешний периметр»* или *«Неконтролируемая территория»*).

4. Нажмите Записать и закрыть.

5.3 Сотрудники

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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