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

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

version	line-number	content
6.1	1	{{box cssClass="floatinginfobox" title="Быстрый переход"}}
7.1	2	* [[1. Описание интеграции>>\|\|anchor="H1.Описаниеинтеграции"]]
	3	* [[2. Предварительные требования>>\|\|anchor="H2.ПредварительныетребованиянасторонеO-VISION"]]
	4	* [[3. Настройка подключения в 1С>>#H3.Настройкаподключенияв1С\|\|anchor="H3.Настройкаподключенияв1С"]]
	5	* [[4. Параметры синхронизации>>\|\|anchor="H4.Параметрысинхронизации28Дополнительныенастройки29"]]
	6	* [[5. Пошаговый регламент запуска>>\|\|anchor="H5.Пошаговыйрегламентпервичногозапуска"]]
	7	* [[6. Автоматический фоновый обмен>>\|\|anchor="H6.Автоматическийфоновыйобмен28РЗ29"]]
	8	* [[7. Важные особенности и FAQ>>\|\|anchor="H7.Важныеособенностииограничения"]]
6.1	9	{{/box}}
	10
3.2	11	= Настройка интеграции PROSTO:СКУД с биометрической системой O-VISION =
1.2	12
3.2	13	{{info}}
	14	O-VISION — современная биометрическая система контроля доступа на базе алгоритмов распознавания лиц. Интеграция с PROSTO:СКУД обеспечивает автоматическую передачу списков сотрудников, фотографий и структуры предприятия из 1С в терминалы O-VISION, а также получение точных событий проходов для автоматического расчета табеля Т-13.
	15	{{/info}}
1.2	16
3.2	17	== 1. Описание интеграции ==
1.2	18
3.2	19	Обмен данными между «1С:Предприятие» и сервером O-VISION выполняется по защищенному протоколу REST API (HTTPS/OAuth2).
1.2	20
3.2	21	=== Ключевые принципы взаимодействия: ===
1.2	22
3.2	23	* Двухуровневая модель персоны: В O-VISION для каждого человека создается Объект (Персона), к которому привязывается Профиль сотрудника (с указанием подразделения и табельного номера).
	24	* Оргструктура: В O-VISION структура предприятия формируется списком Подразделений (понятие «Группы доступа» отсутствует).
	25	* Бережная синхронизация (Защита карт и уровней): Идентификаторы (пропуска/карты) и уровни доступа к терминалам назначаются непосредственно в веб-интерфейсе O-VISION. Модуль 1С управляет кадровыми данными и фото, не затирая назначенные в СКУД права и пропуска.
1.2	26
	27
	28
3.2	29	== 2. Предварительные требования на стороне O-VISION ==
1.2	30
3.2	31	Перед началом настройки интеграции в 1С убедитесь, что выполнены системные условия:
1.2	32
3.2	33	{{warning}}
	34	Критически важно для учетной записи API:
	35	В веб-интерфейсе O-VISION для интеграции должна быть создана сервисная учетная запись с ролью Администратор (Administrator).
	36	В текущих версиях API O-VISION сервисная роль с ограниченными правами «Интеграция» блокирует получение списков персонала.
	37	{{/warning}}
1.2	38
3.2	39	1. Сетевой доступ: Сервер 1С имеет прямой сетевой доступ к серверу O-VISION по порту веб-сервиса (по умолчанию `443` или порт вашей публикации).
	40	1. Топология: В интерфейсе O-VISION созданы терминалы распознавания лиц (Точки доступа) и зоны (Территории).
1.2	41
3.2	42	== 3. Настройка подключения в 1С ==
1.2	43
3.2	44	Для настройки подключения к СКУД O-VISION необходимо перейти в "Настройки подсистемы PROSTO:СКУД" и установить флаг для используемого СКУД.
1.2	45
3.2	46	Для создания узла подключения перейдите в меню:
	47	PROSTO:СКУД ➝ Интеграция со СКУД ➝ справочник Системы контроля доступа (СКУД) ➝ кнопка «Создать».
1.2	48
3.2	49	\|= Параметр \|= Значение / Пример \|= Назначение \|
	50	\| Наименование \| `O-VISION (Центральный офис)` \| Пользовательское название узла подключения \|
	51	\| Система контроля доступа \| `O-VISION` \| Выбор типа интеграционного драйвера \|
	52	\| Используется \| ☑️ (Включено) \| Флаг активности узла обмена \|
	53	\| Сервер \| `192.168.1.50` \| IP-адрес или доменное имя сервера O-VISION \|
	54	\| Логин / Пароль \| `admin / *` \| Учетные данные пользователя O-VISION с правами админа \|
1.2	55
3.2	56	{{info title="Проверка связи"}}
	57	После заполнения полей нажмите кнопку «Проверить соединение».
	58	При корректных настройках появится сообщение: «Соединение установлено». После этого нажмите «Записать».
	59	{{/info}}
1.2	60
3.2	61
1.2	62	[[image:1791891919630-110.png]]
	63
	64	[[image:1791891832508-224.png]]
	65
	66
	67	[[image:1791892078709-141.png]]
	68
	69	[[image:1791892329521-438.png]]
	70
	71	На второй вкладке указываются дополнительные настройки, отвечающие за параметры и состав данных, участвующих в интеграции. Для первоначальной настройки рекомендуется воспользоваться кнопкой «Заполнить по умолчанию».
	72
	73	[[image:1791892602913-871.png]]
	74
3.2	75	== 4. Параметры синхронизации (Дополнительные настройки) ==
1.2	76
3.2	77	На вкладке «Дополнительные настройки» карточки СКУД задаются правила поведения обмена. Рекомендуемые параметры:
1.2	78
5.1	79	(% class="wikigeneratedid" id="H41E44043343043D43843743044643843E43D43D43044F44144244044343A442443440430" %)
	80	Организационная структура
1.2	81
3.2	82	* Создавать организации / Создавать подразделения (Да): создание отделов в 1С при чтении из СКУД.
	83	* Создавать организации СКД / Создавать подразделения СКД (Да): автоматическая выгрузка структуры отделов из 1С в O-VISION.
	84	* Синхронизировать только действующие подразделения (Да): исключает передачу расформированных отделов.
	85	* Подразделение по умолчанию: резервный отдел в O-VISION для сотрудников без кадрового подразделения в 1С.
1.2	86
5.1	87	(% class="wikigeneratedid" id="H41F43544044143E43D43043B43843143843E43C43544244043844F" %)
	88	Персонал и биометрия
1.2	89
3.2	90	* Создавать физических лиц СКД (Да): создание новых персон (Объект + Профиль) в O-VISION при выгрузке из 1С.
	91	* Создавать фото физических лиц СКД (Да): выгрузка фотографий сотрудников из 1С в O-VISION для биометрической идентификации.
	92	* Синхронизировать только работающих сотрудников (Да): уволенные сотрудники не выгружаются в активный список.
	93	* Автоматически выгружать сотрудников при приеме на работу (Да):при проведении кадрового приказа в 1С сотрудник автоматически встает в очередь фоновой выгрузки в O-VISION.
	94	* Синхронизировать сотрудников всех организаций СКД: при значении Да выгружаются все сотрудники базы; при Нет — только по организациям из разрешенного перечня.
1.2	95
5.1	96	(% class="wikigeneratedid" id="H42343243E43B44C43D43543D43843543843143543743E43F43044143D43E44144244C" %)
	97	Увольнение
1.2	98
3.2	99	* Автоматически блокировать сотрудников СКД (Да): при увольнении в 1С профиль сотрудника в O-VISION блокируется (доступ закрывается).
	100	* Подразделение для уволенных: выбор архивной папки O-VISION, куда перемещается уволенный персонал.
1.2	101
5.1	102	(% class="wikigeneratedid" id="H41F43E43443A43B44E44743543D438435" %)
	103	Подключение
1.2	104
3.2	105	* Порт : порт сервера O-VISION (по умолчанию 8 000).
	106	* Таймаут: время ожидания ответа, сек.
	107	* Защищенное Соединение: использование SSL.
1.2	108
5.1	109	(% class="wikigeneratedid" id="H41E43143E44044343443E43243043D438435" %)
	110	Оборудование
1.2	111
3.2	112	* Создавать контроллеры (Да): разрешает автоматическое создание элементов в справочнике 1С «Контроллеры» при чтении терминалов из O-VISION.
	113	* Создавать территории (Да): разрешает загрузку зон доступа из O-VISION в справочник 1С «Территории».
1.2	114
5.1	115	(% class="wikigeneratedid" id="H41E43143C43543D" %)
	116	Обмен
1.2	117
3.2	118	* Регистрировать историю обмена (Да): подробные записи об операциях обмена (объект, статус Успешно/Ошибка, тело ответа API) пишутся в регистр «История обмена со СКУД».
5.1	119	* Использовать отложенную выгрузку: изменения регистрируются в узле обмена и выгружаются регламентным заданием по расписанию, а не в момент записи объекта.
1.2	120
	121
2.1	122
	123	=== 5. Начальная синхронизация с OVISION ===
	124
	125	Существует два подхода начала работы с системой:
	126
	127	1. Все справочные данные создаются в системе PROSTO:СКУД и выгружаются в СКУД регламентным заданием после настройки (см. раздел 6).
2.2	128	1. СКУД OVISION уже запущена на момент внедрения и содержит данные. Для этого в системе PROSTO:СКУД предусмотрена обработка Начальной синхронизации.
2.1	129
2.2	130	[[image:1791979264636-221.png]]
	131
2.1	132	Механика обработки:
	133
	134	* Выберите Систему контроля доступа и, перемещаясь между вкладками в порядке их расположения, поочередно синхронизируйте объекты.
	135	* Для отображения данных в табличной части нажмите «Заполнить». Каждая запись об объекте разделяется на две строки: первая — данные из 1С, вторая — данные из СКУД.
2.2	136	* Первичное сопоставление производится по SID и по наименованию (для сотрудников — по SID, а при пустом SID по ФИО и Табельному номеру). При расхождении данных в первой колонке указывается, что значения различаются; данные можно сопоставить вручную либо создать недостающие объекты обработкой.
2.1	137	* Выберите приоритет синхронизации: 1С (выгрузка в СКУД) или СКУД (загрузка из СКУД), отметьте строки флажками и нажмите «Синхронизировать».
	138	* При успешной синхронизации в первой колонке появится надпись «Данные синхронизированы», а в регистре сведений «Идентификаторы объектов СКУД» создастся запись идентификатора (SID) объекта.
	139
2.2	140	[[image:1791979610839-254.png]]
	141
	142	==== 5.1 Организации и Подразделения. ====
	143
	144	При создании организационной структуры предприятия в системе OVISION организации встают в верхний уровень иерархии справочника «Подразделения» корневой элемент, который находится в разделе «Объекты» название которого обычно совпадает с названием предприятия (организации). Подразделения тоже хранятся в справочнике «Подразделения», с возможностью создания многоуровневого раскрывающегося списка структурных подразделений.
	145
	146	[[image:1791980173475-799.png]]
	147
	148	{{{Первичное сопоставление данных происходит по наименованию. Возможна двухсторонняя интеграция:
	149	- Приоритет 1С: в OVISION создаются соответствующие организации и подразделения с сохранением иерархии (родительских папок).
	150	- Приоритет СКУД: в 1С загружаются организации и подразделения.
	151	- С настройкой СинхронизироватьТолькоДействующиеПодразделения расформированные подразделения не выгружаются и не сопоставляются.}}}
	152
3.1	153	==== 5.2 Территории и Контроллеры ====
2.2	154
	155	Территории и контроллеры находятся в разделе «Зоны и устройства» в соответствующих вкладках.
	156
	157	[[image:1791980473104-568.png]]
	158
	159	При синхронизации возможно только получение из СКУД в 1С: на вкладках «Территории» и «Контроллеры» нажмите «Заполнить» -> «Синхронизировать». Контроллеры загружаются с привязкой к SID OVISION. При повторном нажатии дубли не создаются. Создание территорий и контроллеров в OVISION из 1С отключено.
	160
	161	[[image:1791980627188-113.png]]
	162
	163	После синхронизации для рабочих территорий в справочнике «Территории (СКУД)» необходимо установить флаг «Это рабочая территория».
	164
	165	[[image:1791980728198-464.png]]
	166
	167	После синхронизации Контроллеров найти их можно в аналогичном справочнике. После создания элемента справочника Контроллеры в поле «Территория вход» указывается территория, на которую попадает сотрудник при входе на предприятие. «Территория выход» – заполняется аналогично и определяет территорию выхода.
	168
	169	[[image:1791980936625-286.png]]
3.1	170
	171	==== 5.3 Сотрудники ====
	172
	173	В системе OVISION список сотрудников представляет собой справочник «Объекты», который находится в разделе "Объекты"
	174
	175	[[image:1791981692210-503.png]]
	176
	177	Первичное сопоставление данных происходит по SID; если SID пустой — по связке ФИО + Табельный номер, без создания дублей.
	178
	179	При приоритете СКУД: в 1С создаются Физлица; заполняются ФИО и SID OVISION.
	180	Приоритет 1С: в O-VISION создаются Объект (ФИО) и привязанный к нему Профиль сотрудника (Подразделение, Табельный номер).
	181	Сотрудник без указанного отдела в 1С попадает в Подразделение По Умолчанию.
	182	При включенных дополнительных настройках Создавать ФотоФизических Лиц / Создавать Фото Физических Лиц СКД фото корректно передается в профиль OVISION и отображается в карточке физлица 1С.
	183
	184	Фильтры: Синхронизировать Только Работающих Сотрудников исключает уволенных из таблицы; Синхронизировать Сотрудников Всех Организаций исключает, отображение сотрудников всех организаций базы, в таблице будут видны только организаций из разрешенного списка.
	185
	186	==== 5.4 События СКУД ====
	187
	188	{{{Вкладка предназначена для ручной загрузки данных о событиях проходов сотрудников, которые зафиксировал тот или иной контроллер доступа. }}}
	189
	190	В поле «Период» по умолчанию указывается текущий день, но при необходимости можно задать тот период, за который необходимо получить данные.В табличной части в колонке «Пометка» указано, загрузились ли данные в систему или нет. Для того, чтобы загрузить данные в систему PROSTO:СКУД, нужно выбрать необходимые строки, проставив галочки. Если необходимо выбрать все строки сразу, то можно нажать на кнопку «Установить флажки», после чего нажать на кнопку Синхронизировать.
	191
	192	[[image:1791982535510-559.png]]
	193
	194	Данные в колонках табличной части:
	195
	196	* Дата – показывает дату и время, когда сотрудником (физическим лицом) был осуществлен проход через турникет;
	197	* Физ. лицо – отражает полные фамилию, имя и отчество сотрудника;
	198	* Контроллер – отражает информацию о том, через какой контроллер был осуществлен проход;
	199	* Дверь – отображаются данные о направлении прохода, где «0» - это вход, а «1» - выход;
	200	* Территория – отражает данные о том, на какую территорию был осуществлен проход;
	201	* Карта – отражает номер карты, которая была использована при проходе.
	202
	203	=== 6. Настройка автоматического обмена данными с PERCo-Web и получение событий проходов сотрудников ===
	204
	205	После первоначального сопоставления данных двух систем 1С и СКУД считается, что 1С выступает мастер системой и выгрузка новых объектов, а также изменения уже сопоставленных должны быть осуществлены и в СКУД.
	206
	207	Для настройки автоматического обмена данными со СКУД необходимо в Сервисах и настройках открыть форму плана обмена «Узлы регистрации объектов для выгрузки в СКУД», где для каждой СКУД в которую планируется выгрузка данных создать узел обмена.
	208
	209	[[image:1791982851366-614.png]][[image:1791982889279-864.png]]
	210
	211	Далее в дополнительных отчетах и обработках во внешней обработке «Регламентные задания СКУД» можно настроить расписание выгрузки.
	212
	213	[[image:1791982950479-514.png]]
	214
	215	В этой же обработке задается «Импорт событии СКД (СКУД)» - т.е. периодичность, с которой система будет обращаться к настроенным в ней СКУД и получать события проходов через турникеты.
	216
	217	После описанных выше настроек система будет в автоматическом режиме выгружать данные в СКУД в зависимости от настроек.

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

Навигация

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