Перейти к содержимому

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

Версия 3.1 от PROSTO:СКУД на 2026/10/14 13:03
Последние авторы
1 == 1. Особенности интеграции с OVISION ==
2
3 Биометрическая система контроля доступа **O-VISION** построена на технологиях высокоточного распознавания лиц. Интеграция модуля PROSTO:СКУД с O-VISION выполняется по протоколу REST API (HTTPS/OAuth2) напрямую с сервером СКУД.
4
5 Особенности модели данных OVISION:
6
7 ~1. Модель данных OVISION — двухуровневая:
8 Объект (персона, ФИО) -> Профиль сотрудника (привязка Подразделения, Табельный номер) -> Карта -> Уровень доступа.
9 При создании сотрудника из 1С интеграция создает Объект и привязанный к нему Профиль. К профилю в веб-интерфейсе OVISION вручную привязываются карта и уровни доступа.
10
11 2. В OVISION оргструктура — это Подразделения. Сценарии кадрового учета (прием, перевод, увольнение) реализуются через Подразделения, а для "архива" уволенных — отдельное Подразделение для уволенных.
12
13 3. Состав обмена (текущая версия интеграции):
14
15 Из 1С в OVISION:
16 - Организации
17 - Подразделения (с иерархией)
18 - Сотрудники: Объект + Профиль (ФИО, Табельный номер, Подразделение, Фото)
19
20 Из OVISION в 1С:
21 - Территории
22 - Контроллеры (терминалы/считыватели)
23 - События проходов
24
25 Не выгружаются из 1С в OVISION:
26 - Карты доступа и Уровни доступа (заводятся вручную в веб-интерфейсе OVISION)
27 - Дополнительные поля (СНИЛС, ИНН, дата приема, дата увольнения, дата рождения, должность, гражданство)
28
29 4. Территории и Контроллеры — только получение из СКУД. Создание этих объектов в OVISION из 1С отключено.
30
31 5. Сопоставление сотрудников выполняется по идентификатору SID; при пустом SID — по связке «ФИО + Табельный номер».
32
33 == 2. Предварительные требования на стороне OVISION ==
34
35 Перед началом настройки в 1С убедитесь, что на сервере OVISION выполнены следующие действия:
36
37 1. (((
38 Сервер OVISION запущен, сетевой порт API доступен для сервера "1С:Предприятие".
39 )))
40 1. (((
41 В OVISION заведены терминалы распознавания лиц (Точки доступа) и зоны (Территории).
42 )))
43
44 (% class="box infomessage" %)
45 (((
46 В OVISION должна быть создана сервисная учетная запись с правами **Администратора** (Administrator). В текущих версиях API OVISION урезанная сервисная роль «Интеграция» может блокировать получение списка сотрудников.
47 )))
48
49 == 3. Настройка подключения в 1С ==
50
51 1. Для настройки подключения к СКУД OVISION необходимо перейти в "**Настройки подсистемы PROSTO:СКУД**" и установить флаг для используемого СКУД.
52
53 [[image:1791891919630-110.png]]
54
55 [[image:1791891832508-224.png]]
56
57
58 (% start="2" %)
59 1. Перейдите в раздел **PROSTO:СКУД** ➝ **Интеграция со СКУД**➝ справочник **Системы контроля доступа (СКУД)**.
60
61 [[image:1791892078709-141.png]]
62
63 (% start="2" %)
64 1. (((
65 Нажмите **«Создать»** и заполните основные параметры:
66
67 * (((
68 **Наименование:** OVISION (или понятное имя филиала/проходной).
69 )))
70 * (((
71 **Вид системы контроля доступа:** выберите O-VISION.
72 )))
73 * (((
74 При помощи признака «**Используется**» можно отключать/включать интеграцию с конкретным сервером СКУД, например, на время отладки.
75 )))
76 )))
77 1. (((
78 Заполните блок **«Данные подключения»**:
79
80 * (((
81 **Сервер:** сетевой IP-адрес или доменное имя сервера OVISION.
82 )))
83 * (((
84 **Логин / Пароль:** учетные данные пользователя OVISION с правами администратора.
85 )))
86 * (((
87 Нажмите кнопку **«Проверить соединение»**.
88 )))
89 )))
90 1. (((
91 При успешном подключении система выдаст сообщение: «Соединение установлено».
92 )))
93 1. (((
94 Нажмите **«Записать»**.
95 )))
96
97 [[image:1791892329521-438.png]]
98
99 На второй вкладке указываются дополнительные настройки, отвечающие за параметры и состав данных, участвующих в интеграции. Для первоначальной настройки рекомендуется воспользоваться кнопкой «Заполнить по умолчанию».
100
101 [[image:1791892602913-871.png]]
102
103 == 4. Описание параметров вкладки «Дополнительные настройки» ==
104
105 На вкладке **«Дополнительные настройки»** карточки СКУД задаются правила поведения синхронизации:
106
107 Блок «Подключение»
108
109 * (((
110 **Порт **— порт сервера OVISION (по умолчанию 8 000).
111 )))
112 * (((
113 **Таймаут **— время ожидания ответа, сек.
114 )))
115 * (((
116 **Защищенное Соединение** — использование SSL.
117 )))
118
119 Блок «Оборудование»
120
121 * (((
122 **Создавать контроллеры (Да):** разрешает автоматическое создание элементов в справочнике 1С «Контроллеры» при чтении терминалов из OVISION.
123 )))
124 * (((
125 **Создавать территории (Да):** разрешает загрузку зон доступа из OVISION в справочник 1С «Территории».
126 )))
127
128 Блок «Организационная структура»
129
130 * (((
131 **Создавать организации / Создавать подразделения (Да):** разрешает создание новых элементов в 1С при получении структуры из OVISION.
132 )))
133 * (((
134 **Создавать организации СКД / Создавать подразделения СКД (Да):** разрешает 1С выгружать и создавать новые отделы в дереве подразделений OVISION.
135 )))
136 * (((
137 **Синхронизировать только действующие подразделения (Да):** исключает из обмена расформированные подразделения 1С.
138 )))
139 * (((
140 **Подразделение по умолчанию:** укажите отдел в OVISION, в который будут помещаться новые сотрудники, если их подразделение в 1С не сопоставлено.
141 )))
142
143 Блок «Персонал и Фотографии»
144
145 * (((
146 **Создавать физических лиц (Да/Нет):** создание карточек физических лиц в 1С при чтении из СКУД.
147 )))
148 * (((
149 **Создавать физических лиц СКД (Да):** разрешает создание новых персон (Объект + Профиль) в OVISION при выгрузке из 1С.
150 )))
151 * (((
152 **Создавать фото физических лиц / Создавать фото физических лиц СКД (Да):** обеспечивает двусторонний обмен биометрическими фотографиями сотрудников между 1С и OVISION.
153 )))
154 * (((
155 **Синхронизировать только работающих сотрудников (Да):** фильтрует выгрузку, исключая уволенных работников.
156 )))
157 * (((
158 **Автоматически выгружать сотрудников в СКУД при приеме на работу (Да):** при проведении кадрового приказа в 1С сотрудник автоматически встает в очередь фоновой выгрузки в OVISION.
159 )))
160 * (((
161 **Синхронизировать сотрудников всех организаций СКД:** при значении Да выгружаются все сотрудники базы; при Нет — только по организациям из разрешенного перечня.
162 )))
163
164 Блок «Кадровые сценарии» (регламентные задания):
165
166 * **Автоматически выгружать сотрудников в СКУД при приеме на работу (Да):** при проведении кадрового приказа в 1С сотрудник автоматически встает в очередь фоновой выгрузки в OVISION.
167
168 * (((
169 **Автоматически блокировать сотрудников СКД (Да):** при увольнении в 1С профиль сотрудника в OVISION переводится в статус «Заблокирован» (доступ закрывается).
170 )))
171
172 * (((
173 **Автоматически удалять сотрудников СКД (Нет/Да):** физическое удаление объекта сотрудника из базы OVISION (рекомендуется держать выключенным во избежание потери истории).
174 )))
175 * (((
176 **Перемещать Удаляемых Сотрудников** — при увольнении сотрудник перемещается в Подразделение Для Уволенных.
177 )))
178 * (((
179 **Подразделение для уволенных:** выберите архивный отдел в O-VISION. При увольнении сотрудник будет автоматически перемещен в эту папку.
180 )))
181
182 Блок «Обмен»
183
184 * (((
185 **Регистрировать историю обмена (Да):** подробные записи об операциях обмена (объект, статус Успешно/Ошибка, тело ответа API) пишутся в регистр «История обмена со СКУД».
186 )))
187 * (((
188 **Использовать отложенную выгрузку:**  изменения регистрируются в узле обмена и выгружаются регламентным заданием по расписанию, а не в момент записи объекта.
189 )))
190
191 === 5. Начальная синхронизация с OVISION ===
192
193 Существует два подхода начала работы с системой:
194
195 1. Все справочные данные создаются в системе PROSTO:СКУД и выгружаются в СКУД регламентным заданием после настройки (см. раздел 6).
196 1. СКУД OVISION уже запущена на момент внедрения и содержит данные. Для этого в системе PROSTO:СКУД предусмотрена обработка Начальной синхронизации.
197
198 [[image:1791979264636-221.png]]
199
200 Механика обработки:
201
202 * Выберите Систему контроля доступа и, перемещаясь между вкладками в порядке их расположения, поочередно синхронизируйте объекты.
203 * Для отображения данных в табличной части нажмите «Заполнить». Каждая запись об объекте разделяется на две строки: первая — данные из 1С, вторая — данные из СКУД.
204 * Первичное сопоставление производится по SID и по наименованию (для сотрудников — по SID, а при пустом SID по ФИО и Табельному номеру). При расхождении данных в первой колонке указывается, что значения различаются; данные можно сопоставить вручную либо создать недостающие объекты обработкой.
205 * Выберите приоритет синхронизации: 1С (выгрузка в СКУД) или СКУД (загрузка из СКУД), отметьте строки флажками и нажмите «Синхронизировать».
206 * При успешной синхронизации в первой колонке появится надпись «Данные синхронизированы», а в регистре сведений «Идентификаторы объектов СКУД» создастся запись идентификатора (SID) объекта.
207
208 [[image:1791979610839-254.png]]
209
210 ==== 5.1 Организации и Подразделения. ====
211
212 При создании организационной структуры предприятия в системе OVISION организации встают в верхний уровень иерархии справочника «Подразделения» корневой элемент, который находится в разделе «Объекты» название которого обычно совпадает с названием предприятия (организации). Подразделения тоже хранятся в справочнике  «Подразделения», с возможностью создания многоуровневого раскрывающегося списка структурных подразделений.
213
214 [[image:1791980173475-799.png]]
215
216 {{{Первичное сопоставление данных происходит по наименованию. Возможна двухсторонняя интеграция:
217 - Приоритет 1С: в OVISION создаются соответствующие организации и подразделения с сохранением иерархии (родительских папок).
218 - Приоритет СКУД: в 1С загружаются организации и подразделения.
219 - С настройкой СинхронизироватьТолькоДействующиеПодразделения расформированные подразделения не выгружаются и не сопоставляются.}}}
220
221 ==== 5.2 Территории и Контроллеры ====
222
223 Территории и контроллеры находятся в разделе «Зоны и устройства» в соответствующих вкладках.
224
225 [[image:1791980473104-568.png]]
226
227 При синхронизации возможно только получение из СКУД в 1С: на вкладках «Территории» и «Контроллеры» нажмите «Заполнить» -> «Синхронизировать». Контроллеры загружаются с привязкой к SID OVISION. При повторном нажатии дубли не создаются. Создание территорий и контроллеров в OVISION из 1С отключено.
228
229 [[image:1791980627188-113.png]]
230
231 После синхронизации для рабочих территорий в справочнике «Территории (СКУД)» необходимо установить флаг «Это рабочая территория».
232
233 [[image:1791980728198-464.png]]
234
235 После синхронизации Контроллеров найти их можно  в аналогичном справочнике. После создания элемента справочника Контроллеры в поле «Территория вход» указывается территория, на которую попадает сотрудник при входе на предприятие. «Территория выход» – заполняется аналогично и определяет территорию выхода.
236
237 [[image:1791980936625-286.png]]
238
239 ==== 5.3 Сотрудники ====
240
241 В системе OVISION список сотрудников представляет собой справочник «Объекты», который находится в разделе "Объекты"
242
243 [[image:1791981692210-503.png]]
244
245 Первичное сопоставление данных  происходит по SID; если SID пустой — по связке ФИО + Табельный номер, без создания дублей.
246
247 При приоритете СКУД: в 1С создаются Физлица; заполняются ФИО и SID OVISION.
248 Приоритет 1С: в O-VISION создаются Объект (ФИО) и привязанный к нему Профиль сотрудника (Подразделение, Табельный номер). 
249 Сотрудник без указанного отдела в 1С попадает в Подразделение По Умолчанию.
250 При включенных дополнительных настройках Создавать ФотоФизических Лиц / Создавать Фото Физических Лиц СКД фото корректно передается в профиль OVISION и отображается в карточке физлица 1С.
251
252 Фильтры: Синхронизировать Только Работающих Сотрудников исключает уволенных из таблицы; Синхронизировать Сотрудников Всех Организаций исключает, отображение  сотрудников всех организаций базы, в таблице будут видны  только организаций из разрешенного списка.
253
254 ==== 5.4 События СКУД ====
255
256 {{{Вкладка предназначена для ручной загрузки данных о событиях проходов сотрудников, которые зафиксировал тот или иной контроллер доступа. }}}
257
258 В поле «Период» по умолчанию указывается текущий день, но при необходимости можно задать тот период, за который необходимо получить данные.В табличной части в колонке «Пометка» указано, загрузились ли данные в систему или нет. Для того, чтобы загрузить данные в систему PROSTO:СКУД, нужно выбрать необходимые строки, проставив галочки. Если необходимо выбрать все строки сразу, то можно нажать на кнопку «Установить флажки», после чего нажать на кнопку Синхронизировать.
259
260 [[image:1791982535510-559.png]]
261
262 Данные в колонках табличной части:
263
264 * Дата – показывает дату и время, когда сотрудником (физическим лицом) был осуществлен проход через турникет;
265 * Физ. лицо – отражает полные фамилию, имя и отчество сотрудника;
266 * Контроллер – отражает информацию о том, через какой контроллер был осуществлен проход;
267 * Дверь – отображаются данные о направлении прохода, где «0» - это вход, а «1» - выход;
268 * Территория – отражает данные о том, на какую территорию был осуществлен проход;
269 * Карта – отражает номер карты, которая была использована при проходе.
270
271 === 6. Настройка автоматического обмена данными с PERCo-Web и получение событий проходов сотрудников ===
272
273 После первоначального сопоставления данных двух систем 1С и СКУД считается, что 1С выступает мастер системой и выгрузка новых объектов, а также изменения уже сопоставленных должны быть осуществлены и в СКУД.
274
275 Для настройки автоматического обмена данными со СКУД необходимо в Сервисах и настройках открыть форму плана обмена «Узлы регистрации объектов для выгрузки в СКУД», где для каждой СКУД в которую планируется выгрузка данных создать узел обмена.
276
277 [[image:1791982851366-614.png]][[image:1791982889279-864.png]]
278
279 Далее в дополнительных отчетах и обработках во внешней обработке «Регламентные задания СКУД» можно настроить расписание выгрузки.
280
281 [[image:1791982950479-514.png]]
282
283 В этой же обработке задается «Импорт событии СКД (СКУД)» - т.е. периодичность, с которой система будет обращаться к настроенным в ней СКУД и получать события проходов через турникеты.
284
285 После описанных выше настроек система будет в автоматическом режиме выгружать данные в СКУД в зависимости от настроек.