Изменения документа O-VISION

Редактировал(а) PROSTO:СКУД 2026/10/30 12:28

От версии 1.1
отредактировано PROSTO:СКУД
на 2026/10/13 11:18
Изменить комментарий: К данной версии нет комментариев
К версии 9.1
отредактировано PROSTO:СКУД
на 2026/10/14 14:34
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

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