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

Сводка

• Свойства страницы (1 изменено, 0 добавлено, 0 удалено)
• Вложения (0 изменено, 0 добавлено, 1 удалено)
  • 1792040318780-310.png

Подробности

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

Содержимое

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

1792040318780-310.png

Author

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

Размер

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

Содержимое