Настройка интеграции 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

(% class="wikigeneratedid" id="H4284304331.41843C43F43E44044244243E43F43E43B43E433438438438437O-VISION4321421" %)

184

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

185

186

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

187

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

188

189

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

190

191

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

192

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

193

194

(% start="2" %)

195

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

196

197

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

198

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

199

200

(% class="wikigeneratedid" id="H4284304332.42043043743C43544243A43044043043143E44743844543743E43D2842143F44043043243E44743D43843AAB42243544044043844243E440438438BB29" %)

201

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

202

203

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

204

205

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

206

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

207

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

208

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

209

210

211

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

212

213

214

(% class="wikigeneratedid" id="H4284304333.41D43044144244043E43943A43043243543A44243E44043E43243443243843643543D43844F2842143F44043043243E44743D43843AAB41A43E43D44244043E43B43B43544044BBB29" %)

215

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

216

217

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

218

219

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

220

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

221

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

222

223

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

224

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

225

226

(% start="4" %)

227

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

<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"

232

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

233

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

234

<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"

235

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

236

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

237

238

<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"

239

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

240

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

241

<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"

242

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

243

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

</div>

</div>

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

249

250

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

251

252

[[image:1791981692210-503.png]]

253

254

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

255

256

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

257

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

258

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

259

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

260

261

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

262

263

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

264

265

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

266

267

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

268

269

[[image:1791982535510-559.png]]

270

271

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

272

273

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

274

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

275

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

276

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

277

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

278

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

279

280

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

281

282

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

283

284

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

285

286

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

287

288

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

289

290

[[image:1791982950479-514.png]]

291

292

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

293

294

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

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

Навигация

Быстрый переход: