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

Версия 22.1 от PROSTO:СКУД на 2026/10/15 07:18

version	line-number	content
3.2	1	= Настройка интеграции PROSTO:СКУД с биометрической системой O-VISION =
1.2	2
10.1	3	{{info}}
	4	O-VISION — современная биометрическая система контроля доступа на базе алгоритмов распознавания лиц. Интеграция с PROSTO:СКУД обеспечивает автоматическую передачу списков сотрудников, фотографий и структуры предприятия из 1С в терминалы O-VISION, а также получение точных событий проходов для автоматического расчета табеля Т-13.
	5	{{/info}}
9.1	6
8.1	7	{{id name="H1.Описаниеинтеграции"/}}
10.1	8
3.2	9	== 1. Описание интеграции ==
1.2	10
3.2	11	Обмен данными между «1С:Предприятие» и сервером O-VISION выполняется по защищенному протоколу REST API (HTTPS/OAuth2).
1.2	12
3.2	13	=== Ключевые принципы взаимодействия: ===
1.2	14
3.2	15	* Двухуровневая модель персоны: В O-VISION для каждого человека создается Объект (Персона), к которому привязывается Профиль сотрудника (с указанием подразделения и табельного номера).
	16	* Оргструктура: В O-VISION структура предприятия формируется списком Подразделений (понятие «Группы доступа» отсутствует).
	17	* Бережная синхронизация (Защита карт и уровней): Идентификаторы (пропуска/карты) и уровни доступа к терминалам назначаются непосредственно в веб-интерфейсе O-VISION. Модуль 1С управляет кадровыми данными и фото, не затирая назначенные в СКУД права и пропуска.
1.2	18
10.1	19	{{id name="H2.ПредварительныетребованиянасторонеO-VISION"/}}
1.2	20
3.2	21	== 2. Предварительные требования на стороне O-VISION ==
1.2	22
3.2	23	Перед началом настройки интеграции в 1С убедитесь, что выполнены системные условия:
1.2	24
3.2	25	{{warning}}
	26	Критически важно для учетной записи API:
	27	В веб-интерфейсе O-VISION для интеграции должна быть создана сервисная учетная запись с ролью Администратор (Administrator).
	28	В текущих версиях API O-VISION сервисная роль с ограниченными правами «Интеграция» блокирует получение списков персонала.
	29	{{/warning}}
1.2	30
3.2	31	1. Сетевой доступ: Сервер 1С имеет прямой сетевой доступ к серверу O-VISION по порту веб-сервиса (по умолчанию `443` или порт вашей публикации).
	32	1. Топология: В интерфейсе O-VISION созданы терминалы распознавания лиц (Точки доступа) и зоны (Территории).
9.1	33	{{id name="H3.Настройкаподключенияв1С"/}}
10.1	34
3.2	35	== 3. Настройка подключения в 1С ==
1.2	36
3.2	37	Для настройки подключения к СКУД O-VISION необходимо перейти в "Настройки подсистемы PROSTO:СКУД" и установить флаг для используемого СКУД.
1.2	38
3.2	39	Для создания узла подключения перейдите в меню:
	40	PROSTO:СКУД ➝ Интеграция со СКУД ➝ справочник Системы контроля доступа (СКУД) ➝ кнопка «Создать».
1.2	41
3.2	42	\|= Параметр \|= Значение / Пример \|= Назначение \|
13.1	43	\| Наименование \| `O-VISION` \| Пользовательское название узла подключения \|
3.2	44	\| Система контроля доступа \| `O-VISION` \| Выбор типа интеграционного драйвера \|
	45	\| Используется \| ☑️ (Включено) \| Флаг активности узла обмена \|
13.1	46	\| Сервер \| `ab.ovision.ru` \| IP-адрес или доменное имя сервера O-VISION \|
3.2	47	\| Логин / Пароль \| `admin / *` \| Учетные данные пользователя O-VISION с правами админа \|
1.2	48
3.2	49	{{info title="Проверка связи"}}
	50	После заполнения полей нажмите кнопку «Проверить соединение».
	51	При корректных настройках появится сообщение: «Соединение установлено». После этого нажмите «Записать».
	52	{{/info}}
1.2	53
3.2	54
14.1	55	{{html wiki="false"}}
15.1	56	<div style="max-width:1600px;margin:0 auto;padding:12px 0;">
	57	<div style="margin-bottom:14px;">
	58	<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;">
14.1	61	</div>
15.1	62	<div style="display:grid;grid-template-columns:1fr 1fr;gap:14px;">
	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;">
14.1	69	</div>
	70	</div>
	71	{{/html}}
1.2	72
	73
	74
	75	На второй вкладке указываются дополнительные настройки, отвечающие за параметры и состав данных, участвующих в интеграции. Для первоначальной настройки рекомендуется воспользоваться кнопкой «Заполнить по умолчанию».
	76
17.1	77	{{html wiki="false"}}
16.1	78	<div style="max-width:1600px;margin:0 auto;padding:12px 0;">
20.1	79	<div style="width:50%;">
16.1	80	<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="Вкладка «Дополнительные настройки»"
19.1	82	style="display:block;width:100%;height:auto;border:1px solid #d6dbe2;border-radius:6px;background:#fbfcfd;">
20.1	83	</div>
16.1	84	</div>
	85	{{/html}}
1.2	86
3.2	87	== 4. Параметры синхронизации (Дополнительные настройки) ==
1.2	88
3.2	89	На вкладке «Дополнительные настройки» карточки СКУД задаются правила поведения обмена. Рекомендуемые параметры:
1.2	90
5.1	91	(% class="wikigeneratedid" id="H41E44043343043D43843743044643843E43D43D43044F44144244044343A442443440430" %)
	92	Организационная структура
1.2	93
3.2	94	* Создавать организации / Создавать подразделения (Да): создание отделов в 1С при чтении из СКУД.
	95	* Создавать организации СКД / Создавать подразделения СКД (Да): автоматическая выгрузка структуры отделов из 1С в O-VISION.
	96	* Синхронизировать только действующие подразделения (Да): исключает передачу расформированных отделов.
	97	* Подразделение по умолчанию: резервный отдел в O-VISION для сотрудников без кадрового подразделения в 1С.
1.2	98
5.1	99	(% class="wikigeneratedid" id="H41F43544044143E43D43043B43843143843E43C43544244043844F" %)
	100	Персонал и биометрия
1.2	101
3.2	102	* Создавать физических лиц СКД (Да): создание новых персон (Объект + Профиль) в O-VISION при выгрузке из 1С.
	103	* Создавать фото физических лиц СКД (Да): выгрузка фотографий сотрудников из 1С в O-VISION для биометрической идентификации.
	104	* Синхронизировать только работающих сотрудников (Да): уволенные сотрудники не выгружаются в активный список.
	105	* Автоматически выгружать сотрудников при приеме на работу (Да):при проведении кадрового приказа в 1С сотрудник автоматически встает в очередь фоновой выгрузки в O-VISION.
	106	* Синхронизировать сотрудников всех организаций СКД: при значении Да выгружаются все сотрудники базы; при Нет — только по организациям из разрешенного перечня.
1.2	107
5.1	108	(% class="wikigeneratedid" id="H42343243E43B44C43D43543D43843543843143543743E43F43044143D43E44144244C" %)
	109	Увольнение
1.2	110
3.2	111	* Автоматически блокировать сотрудников СКД (Да): при увольнении в 1С профиль сотрудника в O-VISION блокируется (доступ закрывается).
	112	* Подразделение для уволенных: выбор архивной папки O-VISION, куда перемещается уволенный персонал.
1.2	113
5.1	114	(% class="wikigeneratedid" id="H41F43E43443A43B44E44743543D438435" %)
	115	Подключение
1.2	116
3.2	117	* Порт : порт сервера O-VISION (по умолчанию 8 000).
	118	* Таймаут: время ожидания ответа, сек.
	119	* Защищенное Соединение: использование SSL.
1.2	120
5.1	121	(% class="wikigeneratedid" id="H41E43143E44044343443E43243043D438435" %)
	122	Оборудование
1.2	123
3.2	124	* Создавать контроллеры (Да): разрешает автоматическое создание элементов в справочнике 1С «Контроллеры» при чтении терминалов из O-VISION.
	125	* Создавать территории (Да): разрешает загрузку зон доступа из O-VISION в справочник 1С «Территории».
1.2	126
5.1	127	(% class="wikigeneratedid" id="H41E43143C43543D" %)
	128	Обмен
1.2	129
3.2	130	* Регистрировать историю обмена (Да): подробные записи об операциях обмена (объект, статус Успешно/Ошибка, тело ответа API) пишутся в регистр «История обмена со СКУД».
5.1	131	* Использовать отложенную выгрузку: изменения регистрируются в узле обмена и выгружаются регламентным заданием по расписанию, а не в момент записи объекта.
1.2	132
	133
2.1	134
	135	=== 5. Начальная синхронизация с OVISION ===
	136
	137	Существует два подхода начала работы с системой:
	138
	139	1. Все справочные данные создаются в системе PROSTO:СКУД и выгружаются в СКУД регламентным заданием после настройки (см. раздел 6).
19.1	140	1. СКУД OVISION уже запущена на момент внедрения и содержит данные. Для этого в системе PROSTO:СКУД предусмотрена обработка Начальной синхронизации.
2.1	141	Механика обработки:
	142
	143	* Выберите Систему контроля доступа и, перемещаясь между вкладками в порядке их расположения, поочередно синхронизируйте объекты.
	144	* Для отображения данных в табличной части нажмите «Заполнить». Каждая запись об объекте разделяется на две строки: первая — данные из 1С, вторая — данные из СКУД.
2.2	145	* Первичное сопоставление производится по SID и по наименованию (для сотрудников — по SID, а при пустом SID по ФИО и Табельному номеру). При расхождении данных в первой колонке указывается, что значения различаются; данные можно сопоставить вручную либо создать недостающие объекты обработкой.
2.1	146	* Выберите приоритет синхронизации: 1С (выгрузка в СКУД) или СКУД (загрузка из СКУД), отметьте строки флажками и нажмите «Синхронизировать».
	147	* При успешной синхронизации в первой колонке появится надпись «Данные синхронизированы», а в регистре сведений «Идентификаторы объектов СКУД» создастся запись идентификатора (SID) объекта.
	148
18.1	149	{{html wiki="false"}}
	150	<div style="max-width:1600px;margin:0 auto;padding:12px 0;">
	151	<div style="margin-bottom:14px;">
	152	<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;">
	159	</div>
	160	{{/html}}
2.2	161
	162	==== 5.1 Организации и Подразделения. ====
	163
	164	При создании организационной структуры предприятия в системе OVISION организации встают в верхний уровень иерархии справочника «Подразделения» корневой элемент, который находится в разделе «Объекты» название которого обычно совпадает с названием предприятия (организации). Подразделения тоже хранятся в справочнике «Подразделения», с возможностью создания многоуровневого раскрывающегося списка структурных подразделений.
	165
	166	[[image:1791980173475-799.png]]
	167
11.1	168	Первичное сопоставление данных происходит по наименованию. Возможна двухсторонняя интеграция:
2.2	169	- Приоритет 1С: в OVISION создаются соответствующие организации и подразделения с сохранением иерархии (родительских папок).
	170	- Приоритет СКУД: в 1С загружаются организации и подразделения.
11.1	171	- С настройкой СинхронизироватьТолькоДействующиеПодразделения расформированные подразделения не выгружаются и не сопоставляются.
2.2	172
3.1	173	==== 5.2 Территории и Контроллеры ====
2.2	174
22.1	175	В системе O-VISION точки прохода и зоны доступа настраиваются администратором в разделе «Зоны и устройства» на соответствующих вкладках.
2.2	176
22.1	177	{{info}}
	178	Особенность интеграции с O-VISION:
	179	Обмен топологией оборудования работает строго в одном направлении: из СКУД в 1С.
	180	Создание зон и терминалов из 1С в O-VISION аппаратно отключено — первоисточником оборудования всегда является сервер O-VISION.
	181	{{/info}}
2.2	182
22.1	183	=== Шаг 1. Импорт топологии из O-VISION в 1С ===
2.2	184
22.1	185	Загрузка выполняется через обработку:
	186	PROSTO:СКУД ➝ Первичная синхронизация данных.
2.2	187
22.1	188	1. Вкладка «Территории»:
	189	* Выберите узел O-VISION и нажмите кнопку «Заполнить» (система считает список зон).
	190	* Нажмите кнопку «Синхронизировать». Зоны доступа запишутся в справочник 1С с сохранением уникальных идентификаторов `SID O-VISION`.
	191	1. Вкладка «Контроллеры»:
	192	* Перейдите на вкладку, нажмите кнопку «Заполнить» ➝ «Синхронизировать».
	193	* Биометрические терминалы распознавания лиц будут загружены в справочник 1С «Контроллеры».
2.2	194
22.1	195	{{info}}
	196	Защита от дублей: В алгоритм встроен контроль уникальности по `SID`. При повторных нажатиях кнопок «Заполнить» и «Синхронизировать» дубликаты записей в 1С не создаются.
	197	{{/info}}
	198
	199	=== Шаг 2. Разметка рабочих зон (Справочник «Территории») ===
	200
	201	После завершения импорта необходимо указать системе, какие из загруженных зон считаются рабочими (влияют на оплату труда), а какие служебными или нейтральными (улица, парковка, КПП).
	202
	203	1. Перейдите: PROSTO:СКУД ➝ Справочники ➝ Территории (СКУД).
	204	1. Откройте карточку территории, где непосредственно работают сотрудники (например, «Цех №1», «Офис», «Склад»).
	205	1. Установите флаг ☑️ «Это рабочая территория».
	206	1. Нажмите Записать и закрыть.
	207
	208	{{warning}}
	209	Важно: Если для территории не включен признак рабочей зоны, нахождение сотрудника на ней не будет засчитываться в явку при автоматическом расчете табеля Т-13.
	210	{{/warning}}
	211
	212	=== Шаг 3. Настройка векторов движения (Справочник «Контроллеры») ===
	213
	214	Чтобы система понимала, пришел сотрудник на работу или ушел домой, для каждого биометрического терминала необходимо задать направления прохода.
	215
	216	1. Перейдите: PROSTO:СКУД ➝ Справочники ➝ Контроллеры (СКУД).
	217	1. Откройте карточку нужного терминала/турникета.
	218	1. Заполните параметры направлений:
	219	* Поле «Территория вход»: выберите территорию, на которую попадает сотрудник при успешном распознавании лица на вход (например, «Офис» или «Производственная площадка»).
	220	* Поле «Территория выход»: выберите территорию, куда направляется сотрудник при выходе (например, «Улица», «Внешний периметр» или «Неконтролируемая территория»).
	221	1. Нажмите Записать и закрыть.
	222
	223	{{info}}
	224	После выполнения этих шагов настройка топологии завершена: система готова корректно регистрировать события прихода/ухода сотрудников и переводить их в отработанные часы.
	225	{{/info}}
	226
21.1	227	{{html wiki="false"}}
	228	<div style="max-width:1600px;margin:0 auto;padding:12px 0;">
	229	<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	<div style="display:grid;grid-template-columns:1fr 1fr;gap:14px;">
	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;">
	242	</div>
	243	</div>
	244	{{/html}}
3.1	245
	246	==== 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
14.1	278	=== 6. Настройка автоматического обмена данными с O-VISION и получение событий проходов сотрудников ===
3.1	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

Навигация

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