Перейти к содержимому
Версия 17.1 от PROSTO:СКУД на 2026/10/15 05:58
Последние авторы
1 = Настройка интеграции PROSTO:СКУД с биометрической системой O-VISION =
2
3 {{info}}
4 **O-VISION** — современная биометрическая система контроля доступа на базе алгоритмов распознавания лиц. Интеграция с **PROSTO:СКУД** обеспечивает автоматическую передачу списков сотрудников, фотографий и структуры предприятия из 1С в терминалы O-VISION, а также получение точных событий проходов для автоматического расчета табеля Т-13.
5 {{/info}}
6
7 {{id name="H1.Описаниеинтеграции"/}}
8
9 == 1. Описание интеграции ==
10
11 Обмен данными между «1С:Предприятие» и сервером O-VISION выполняется по защищенному протоколу **REST API (HTTPS/OAuth2)**.
12
13 === Ключевые принципы взаимодействия: ===
14
15 * **Двухуровневая модель персоны:** В O-VISION для каждого человека создается **Объект (Персона)**, к которому привязывается **Профиль сотрудника** (с указанием подразделения и табельного номера).
16 * **Оргструктура:** В O-VISION структура предприятия формируется списком **Подразделений** (понятие «Группы доступа» отсутствует).
17 * **Бережная синхронизация (Защита карт и уровней):** Идентификаторы (пропуска/карты) и уровни доступа к терминалам назначаются непосредственно в веб-интерфейсе O-VISION. Модуль 1С управляет кадровыми данными и фото, **не затирая** назначенные в СКУД права и пропуска.
18
19 {{id name="H2.ПредварительныетребованиянасторонеO-VISION"/}}
20
21 == 2. Предварительные требования на стороне O-VISION ==
22
23 Перед началом настройки интеграции в 1С убедитесь, что выполнены системные условия:
24
25 {{warning}}
26 **Критически важно для учетной записи API:**
27 В веб-интерфейсе O-VISION для интеграции должна быть создана сервисная учетная запись с ролью **Администратор (Administrator)**.
28 В текущих версиях API O-VISION сервисная роль с ограниченными правами «Интеграция» блокирует получение списков персонала.
29 {{/warning}}
30
31 1. **Сетевой доступ:** Сервер 1С имеет прямой сетевой доступ к серверу O-VISION по порту веб-сервиса (по умолчанию `443` или порт вашей публикации).
32 1. **Топология:** В интерфейсе O-VISION созданы терминалы распознавания лиц (Точки доступа) и зоны (Территории).
33 {{id name="H3.Настройкаподключенияв1С"/}}
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 {{info title="Проверка связи"}}
50 После заполнения полей нажмите кнопку **«Проверить соединение»**.
51 При корректных настройках появится сообщение: «Соединение установлено». После этого нажмите **«Записать»**.
52 {{/info}}
53
54
55 {{html wiki="false"}}
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;">
61 </div>
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;">
69 </div>
70 </div>
71 {{/html}}
72
73
74
75 На второй вкладке указываются дополнительные настройки, отвечающие за параметры и состав данных, участвующих в интеграции. Для первоначальной настройки рекомендуется воспользоваться кнопкой «Заполнить по умолчанию».
76
77 {{html wiki="false"}}
78 <div style="max-width:1600px;margin:0 auto;padding:12px 0;">
79 <div style="width:50%;margin-left:auto;margin-right:auto;">
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="Вкладка «Дополнительные настройки»"
82 style="display:block;width:100%;aspect-ratio:16/9;object-fit:contain;border:1px solid #d6dbe2;border-radius:6px;background:#fbfcfd;">
83 </div>
84 </div>
85 {{/html}}
86
87 == 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 * **Использовать отложенную выгрузку:** изменения регистрируются в узле обмена и выгружаются регламентным заданием по расписанию, а не в момент записи объекта.
132
133
134
135 === 5. Начальная синхронизация с OVISION ===
136
137 Существует два подхода начала работы с системой:
138
139 1. Все справочные данные создаются в системе PROSTO:СКУД и выгружаются в СКУД регламентным заданием после настройки (см. раздел 6).
140 1. СКУД OVISION уже запущена на момент внедрения и содержит данные. Для этого в системе PROSTO:СКУД предусмотрена обработка Начальной синхронизации.
141
142 [[image:1791979264636-221.png]]
143
144 Механика обработки:
145
146 * Выберите Систему контроля доступа и, перемещаясь между вкладками в порядке их расположения, поочередно синхронизируйте объекты.
147 * Для отображения данных в табличной части нажмите «Заполнить». Каждая запись об объекте разделяется на две строки: первая — данные из 1С, вторая — данные из СКУД.
148 * Первичное сопоставление производится по SID и по наименованию (для сотрудников — по SID, а при пустом SID по ФИО и Табельному номеру). При расхождении данных в первой колонке указывается, что значения различаются; данные можно сопоставить вручную либо создать недостающие объекты обработкой.
149 * Выберите приоритет синхронизации: 1С (выгрузка в СКУД) или СКУД (загрузка из СКУД), отметьте строки флажками и нажмите «Синхронизировать».
150 * При успешной синхронизации в первой колонке появится надпись «Данные синхронизированы», а в регистре сведений «Идентификаторы объектов СКУД» создастся запись идентификатора (SID) объекта.
151
152 [[image:1791979610839-254.png]]
153
154 ==== 5.1 Организации и Подразделения. ====
155
156 При создании организационной структуры предприятия в системе OVISION организации встают в верхний уровень иерархии справочника «Подразделения» корневой элемент, который находится в разделе «Объекты» название которого обычно совпадает с названием предприятия (организации). Подразделения тоже хранятся в справочнике  «Подразделения», с возможностью создания многоуровневого раскрывающегося списка структурных подразделений.
157
158 [[image:1791980173475-799.png]]
159
160 Первичное сопоставление данных происходит по наименованию. Возможна двухсторонняя интеграция:
161 - Приоритет 1С: в OVISION создаются соответствующие организации и подразделения с сохранением иерархии (родительских папок).
162 - Приоритет СКУД: в 1С загружаются организации и подразделения.
163 - С настройкой СинхронизироватьТолькоДействующиеПодразделения расформированные подразделения не выгружаются и не сопоставляются.
164
165 ==== 5.2 Территории и Контроллеры ====
166
167 Территории и контроллеры находятся в разделе «Зоны и устройства» в соответствующих вкладках.
168
169 [[image:1791980473104-568.png]]
170
171 При синхронизации возможно только получение из СКУД в 1С: на вкладках «Территории» и «Контроллеры» нажмите «Заполнить» -> «Синхронизировать». Контроллеры загружаются с привязкой к SID OVISION. При повторном нажатии дубли не создаются. Создание территорий и контроллеров в OVISION из 1С отключено.
172
173 [[image:1791980627188-113.png]]
174
175 После синхронизации для рабочих территорий в справочнике «Территории (СКУД)» необходимо установить флаг «Это рабочая территория».
176
177 [[image:1791980728198-464.png]]
178
179 После синхронизации Контроллеров найти их можно  в аналогичном справочнике. После создания элемента справочника Контроллеры в поле «Территория вход» указывается территория, на которую попадает сотрудник при входе на предприятие. «Территория выход» – заполняется аналогично и определяет территорию выхода.
180
181 [[image:1791980936625-286.png]]
182
183 ==== 5.3 Сотрудники ====
184
185 В системе OVISION список сотрудников представляет собой справочник «Объекты», который находится в разделе "Объекты"
186
187 [[image:1791981692210-503.png]]
188
189 Первичное сопоставление данных  происходит по SID; если SID пустой — по связке ФИО + Табельный номер, без создания дублей.
190
191 При приоритете СКУД: в 1С создаются Физлица; заполняются ФИО и SID OVISION.
192 Приоритет 1С: в O-VISION создаются Объект (ФИО) и привязанный к нему Профиль сотрудника (Подразделение, Табельный номер). 
193 Сотрудник без указанного отдела в 1С попадает в Подразделение По Умолчанию.
194 При включенных дополнительных настройках Создавать ФотоФизических Лиц / Создавать Фото Физических Лиц СКД фото корректно передается в профиль OVISION и отображается в карточке физлица 1С.
195
196 Фильтры: Синхронизировать Только Работающих Сотрудников исключает уволенных из таблицы; Синхронизировать Сотрудников Всех Организаций исключает, отображение  сотрудников всех организаций базы, в таблице будут видны  только организаций из разрешенного списка.
197
198 ==== 5.4 События СКУД ====
199
200 {{{Вкладка предназначена для ручной загрузки данных о событиях проходов сотрудников, которые зафиксировал тот или иной контроллер доступа. }}}
201
202 В поле «Период» по умолчанию указывается текущий день, но при необходимости можно задать тот период, за который необходимо получить данные.В табличной части в колонке «Пометка» указано, загрузились ли данные в систему или нет. Для того, чтобы загрузить данные в систему PROSTO:СКУД, нужно выбрать необходимые строки, проставив галочки. Если необходимо выбрать все строки сразу, то можно нажать на кнопку «Установить флажки», после чего нажать на кнопку Синхронизировать.
203
204 [[image:1791982535510-559.png]]
205
206 Данные в колонках табличной части:
207
208 * Дата – показывает дату и время, когда сотрудником (физическим лицом) был осуществлен проход через турникет;
209 * Физ. лицо – отражает полные фамилию, имя и отчество сотрудника;
210 * Контроллер – отражает информацию о том, через какой контроллер был осуществлен проход;
211 * Дверь – отображаются данные о направлении прохода, где «0» - это вход, а «1» - выход;
212 * Территория – отражает данные о том, на какую территорию был осуществлен проход;
213 * Карта – отражает номер карты, которая была использована при проходе.
214
215 === 6. Настройка автоматического обмена данными с O-VISION и получение событий проходов сотрудников ===
216
217 После первоначального сопоставления данных двух систем 1С и СКУД считается, что 1С выступает мастер системой и выгрузка новых объектов, а также изменения уже сопоставленных должны быть осуществлены и в СКУД.
218
219 Для настройки автоматического обмена данными со СКУД необходимо в Сервисах и настройках открыть форму плана обмена «Узлы регистрации объектов для выгрузки в СКУД», где для каждой СКУД в которую планируется выгрузка данных создать узел обмена.
220
221 [[image:1791982851366-614.png]][[image:1791982889279-864.png]]
222
223 Далее в дополнительных отчетах и обработках во внешней обработке «Регламентные задания СКУД» можно настроить расписание выгрузки.
224
225 [[image:1791982950479-514.png]]
226
227 В этой же обработке задается «Импорт событии СКД (СКУД)» - т.е. периодичность, с которой система будет обращаться к настроенным в ней СКУД и получать события проходов через турникеты.
228
229 После описанных выше настроек система будет в автоматическом режиме выгружать данные в СКУД в зависимости от настроек.