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

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

Версия 2.2 от PROSTO:СКУД на 2026/10/14 12:34
Последние авторы
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]]