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

Сводка

• Свойства страницы (1 изменено, 0 добавлено, 0 удалено)
• Вложения (0 изменено, 8 добавлено, 0 удалено)
  • 1791981570207-327.png
  • 1791981661700-132.png
  • 1791981692210-503.png
  • 1791982535510-559.png
  • 1791982851366-614.png
  • 1791982889279-864.png
  • 1791982950479-514.png
  • 1792040318780-310.png

Подробности

Свойства страницы

Содержимое

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

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

Содержимое

1792040318780-310.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.wiki_adm

Размер

...	...	@@ -1,0 +1,1 @@
	1	+282.2 KB

Содержимое