Настройка интеграции c O-VISION

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

**O-VISION** — современная биометрическая система контроля доступа на базе алгоритмов распознавания лиц. Интеграция с **PROSTO:СКУД** обеспечивает автоматическую передачу списков сотрудников, фотографий и структуры предприятия из 1С в терминалы O-VISION, а также получение точных событий проходов для автоматического расчета табеля Т-13.

5

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

10

11

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

12

13

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

14

15

* **Двухуровневая модель персоны:** В O-VISION для каждого человека создается **Объект (Персона)**, к которому привязывается **Профиль сотрудника** (с указанием подразделения и табельного номера).

16

* **Оргструктура:** В O-VISION структура предприятия формируется списком **Подразделений** (понятие «Группы доступа» отсутствует).

17

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

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

22

23

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

24

25

26

**Критически важно для учетной записи API:**

27

В веб-интерфейсе O-VISION для интеграции должна быть создана сервисная учетная запись с ролью **Администратор (Administrator)**.

28

В текущих версиях API O-VISION сервисная роль с ограниченными правами «Интеграция» блокирует получение списков персонала.

29

30

31

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

32

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

33

34

35

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

36

37

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

38

39

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

40

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

41

42

|= Параметр |= Значение / Пример |= Назначение |

43

| **Наименование** | `O-VISION` | Пользовательское название узла подключения |

44

| **Система контроля доступа** | `O-VISION` | Выбор типа интеграционного драйвера |

45

| **Используется** | ☑️ (Включено) | Флаг активности узла обмена |

46

| **Сервер** | `ab.ovision.ru` | IP-адрес или доменное имя сервера O-VISION |

47

| **Логин / Пароль** | `admin / ***` **| Учетные данные пользователя O-VISION с правами админа |

48

49

50

После заполнения полей нажмите кнопку **«Проверить соединение»**.

51

При корректных настройках появится сообщение: «Соединение установлено». После этого нажмите **«Записать»**.

<img src="/bin/download/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8-c-OVISION/WebHome/1792040318780-310.png?rev=1.1"

59

alt="Справочник Системы контроля доступа (СКУД)"

60

style="display:block;width:100%;height:auto;border:1px solid #d6dbe2;border-radius:6px;background:#fbfcfd;">

61

</div>

62

63

<img src="/bin/download/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8-c-OVISION/WebHome/1791891832508-224.png?rev=1.1"

64

alt="Карточка СКУД — основные параметры"

65

style="display:block;width:100%;aspect-ratio:16/9;object-fit:contain;border:1px solid #d6dbe2;border-radius:6px;background:#fbfcfd;">

66

<img src="/bin/download/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8-c-OVISION/WebHome/1791892329521-438.png?rev=1.1"

67

alt="Проверка соединения"

68

style="display:block;width:100%;aspect-ratio:16/9;object-fit:contain;border:1px solid #d6dbe2;border-radius:6px;background:#fbfcfd;">

</div>

</div>

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

<img src="/bin/download/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8-c-OVISION/WebHome/1791892602913-871.png?rev=1.1"

81

alt="Вкладка «Дополнительные настройки»"

82

style="display:block;width:100%;height:auto;border:1px solid #d6dbe2;border-radius:6px;background:#fbfcfd;">

</div>

</div>

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

88

89

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

90

91

(% class="wikigeneratedid" id="H41E44043343043D43843743044643843E43D43D43044F44144244044343A442443440430" %)

92

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

93

94

* **Создавать организации / Создавать подразделения (Да):** создание отделов в 1С при чтении из СКУД.

95

* **Создавать организации СКД / Создавать подразделения СКД (Да):** автоматическая выгрузка структуры отделов из 1С в O-VISION.

96

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

97

* **Подразделение по умолчанию:** резервный отдел в O-VISION для сотрудников без кадрового подразделения в 1С.

98

99

(% class="wikigeneratedid" id="H41F43544044143E43D43043B43843143843E43C43544244043844F" %)

100

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

101

102

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

103

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

104

* **Синхронизировать только работающих сотрудников (Да):** уволенные сотрудники не выгружаются в активный список.

105

* **Автоматически выгружать сотрудников при приеме на работу (Да):**при проведении кадрового приказа в 1С сотрудник автоматически встает в очередь фоновой выгрузки в O-VISION.

106

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

107

108

(% class="wikigeneratedid" id="H42343243E43B44C43D43543D43843543843143543743E43F43044143D43E44144244C" %)

109

Увольнение

110

111

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

112

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

113

114

(% class="wikigeneratedid" id="H41F43E43443A43B44E44743543D438435" %)

115

Подключение

116

117

* **Порт :** порт сервера O-VISION (по умолчанию 8 000).

118

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

119

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

120

121

(% class="wikigeneratedid" id="H41E43143E44044343443E43243043D438435" %)

122

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

123

124

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

125

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

126

127

(% class="wikigeneratedid" id="H41E43143C43543D" %)

128

Обмен

129

130

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

131

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

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

136

137

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

138

139

1. Все справочные данные создаются в системе PROSTO:СКУД и выгружаются в СКУД регламентным заданием после настройки (см. раздел 6).

140

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

141

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

142

143

* Выберите Систему контроля доступа и, перемещаясь между вкладками в порядке их расположения, поочередно синхронизируйте объекты.

144

* Для отображения данных в табличной части нажмите «Заполнить». Каждая запись об объекте разделяется на две строки: первая — данные из 1С, вторая — данные из СКУД.

145

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

146

* Выберите приоритет синхронизации: 1С (выгрузка в СКУД) или СКУД (загрузка из СКУД), отметьте строки флажками и нажмите «Синхронизировать».

147

* При успешной синхронизации в первой колонке появится надпись «Данные синхронизированы», а в регистре сведений «Идентификаторы объектов СКУД» создастся запись идентификатора (SID) объекта.

<img src="/bin/download/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8-c-OVISION/WebHome/1791979264636-221.png?rev=1.1"

153

alt="Начальная синхронизация — обработка"

154

style="display:block;width:100%;height:auto;border:1px solid #d6dbe2;border-radius:6px;background:#fbfcfd;">

155

</div>

156

<img src="/bin/download/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8-c-OVISION/WebHome/1791979610839-254.png?rev=1.1"

157

alt="Начальная синхронизация — вкладки"

158

style="display:block;width:100%;height:auto;border:1px solid #d6dbe2;border-radius:6px;background:#fbfcfd;">

</div>

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

163

164

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

165

166

[[image:1791980173475-799.png]]

167

168

Первичное сопоставление данных происходит по наименованию. Возможна двухсторонняя интеграция:

169

- Приоритет 1С: в OVISION создаются соответствующие организации и подразделения с сохранением иерархии (родительских папок).

170

- Приоритет СКУД: в 1С загружаются организации и подразделения.

171

- С настройкой СинхронизироватьТолькоДействующиеПодразделения расформированные подразделения не выгружаются и не сопоставляются.

172

173

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

174

175

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

176

177

178

**Особенность интеграции с O-VISION:**

179

Обмен топологией оборудования работает **строго в одном направлении: из СКУД в 1С**.

180

Создание зон и терминалов из 1С в O-VISION аппаратно отключено — первоисточником оборудования всегда является сервер O-VISION.

181

182

183

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

184

185

Загрузка выполняется через обработку:

186

**PROSTO:СКУД** ➝ **Первичная синхронизация данных**.

187

188

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

189

* Выберите узел O-VISION и нажмите кнопку **«Заполнить»** (система считает список зон).

190

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

191

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

192

* Перейдите на вкладку, нажмите кнопку **«Заполнить»** ➝ **«Синхронизировать»**.

193

* Биометрические терминалы распознавания лиц будут загружены в справочник 1С «Контроллеры».

194

195

196

**Защита от дублей:** В алгоритм встроен контроль уникальности по `SID`. При повторных нажатиях кнопок «Заполнить» и «Синхронизировать» дубликаты записей в 1С не создаются.

197

198

199

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

200

201

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

202

203

1. Перейдите: **PROSTO:СКУД** ➝ **Справочники** ➝ **Территории (СКУД)**.

204

1. Откройте карточку территории, где непосредственно работают сотрудники (например, *«Цех №1»*, *«Офис»*, *«Склад»*).

205

1. Установите флаг ☑️ **«Это рабочая территория»**.

206

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

207

208

209

**Важно:** Если для территории не включен признак рабочей зоны, нахождение сотрудника на ней не будет засчитываться в явку при автоматическом расчете табеля Т-13.

210

211

212

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

213

214

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

215

216

1. Перейдите: **PROSTO:СКУД** ➝ **Справочники** ➝ **Контроллеры (СКУД)**.

217

1. Откройте карточку нужного терминала/турникета.

218

1. Заполните параметры направлений:

219

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

220

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

221

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

222

223

224

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

<img src="/bin/download/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8-c-OVISION/WebHome/1791980473104-568.png?rev=1.1"

230

alt="Зоны и устройства"

231

style="display:block;width:100%;height:auto;border:1px solid #d6dbe2;border-radius:6px;background:#fbfcfd;margin-bottom:14px;">

232

<img src="/bin/download/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8-c-OVISION/WebHome/1791980627188-113.png?rev=1.1"

233

alt="Синхронизация территорий и контроллеров"

234

style="display:block;width:100%;height:auto;border:1px solid #d6dbe2;border-radius:6px;background:#fbfcfd;margin-bottom:14px;">

235

236

<img src="/bin/download/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8-c-OVISION/WebHome/1791980728198-464.png?rev=1.1"

237

alt="Это рабочая территория"

238

style="display:block;width:100%;height:auto;border:1px solid #d6dbe2;border-radius:6px;background:#fbfcfd;">

239

<img src="/bin/download/%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8-c-OVISION/WebHome/1791980936625-286.png?rev=1.1"

240

alt="Территория вход и выход"

241

style="display:block;width:100%;height:auto;border:1px solid #d6dbe2;border-radius:6px;background:#fbfcfd;">

</div>

</div>

==== 5.3 Сотрудники ====

247

248

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

249

250

[[image:1791981692210-503.png]]

251

252

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

253

254

При приоритете СКУД: в 1С создаются Физлица; заполняются ФИО и SID OVISION.

255

Приоритет 1С: в O-VISION создаются Объект (ФИО) и привязанный к нему Профиль сотрудника (Подразделение, Табельный номер).

256

Сотрудник без указанного отдела в 1С попадает в Подразделение По Умолчанию.

257

При включенных дополнительных настройках Создавать ФотоФизических Лиц / Создавать Фото Физических Лиц СКД фото корректно передается в профиль OVISION и отображается в карточке физлица 1С.

258

259

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

260

261

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

262

263

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

264

265

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

266

267

[[image:1791982535510-559.png]]

268

269

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

270

271

* Дата – показывает дату и время, когда сотрудником (физическим лицом) был осуществлен проход через турникет;

272

* Физ. лицо – отражает полные фамилию, имя и отчество сотрудника;

273

* Контроллер – отражает информацию о том, через какой контроллер был осуществлен проход;

274

* Дверь – отображаются данные о направлении прохода, где «0» - это вход, а «1» - выход;

275

* Территория – отражает данные о том, на какую территорию был осуществлен проход;

276

* Карта – отражает номер карты, которая была использована при проходе.

277

278

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

279

280

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

281

282

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

283

284

[[image:1791982851366-614.png]][[image:1791982889279-864.png]]

285

286

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

287

288

[[image:1791982950479-514.png]]

289

290

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

291

292

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

Исходный код вики Настройка интеграции c O-VISION