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

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

Версия 1.2 от PROSTO:СКУД на 2026/10/13 12:40
Скрыть последних авторов
PROSTO:СКУД 1.2 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 == Описание параметров вкладки «Дополнительные настройки» ==
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 )))