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

Версия 2.28 от Всезнайка PROSTO:СКУД на 2025/11/14 13:40

version	line-number	content
1.3	1	= 1. ОПИСАНИЕ СИСТЕМЫ =
	2
	3	Интеграционные возможности продукта «PROSTO:СКУД» позволяют:
	4
	5	* настраивать подключение к системам СКУД, а также настраивать параметры интеграции в отдельной СКУД, задавать расписания обменов с системами СКУД;
	6	* создавать или сопоставлять с текущими параметрами объекты систем СКУД:
	7	** организации,
	8	** подразделения,
	9	** территории,
	10	** контроллеры доступа,
	11	** уровни/шаблоны доступа,
	12	** сотрудники (физические лица);
	13	* выдавать, продлевать или блокировать - обеспечивать учет карт доступа;
	14	* устанавливать сотрудникам ограничения в разрезе рабочих помещений для более точного учета;
	15	* устанавливать права прохода через контрольные точки СКУД путем назначения уровней доступа или указания определенных контроллеров СКУД;
	16	* просматривать данные о проходах сотрудников через точки доступа СКУД.
	17
1.4	18	= 2. НАСТРОЙКА ИНТЕГРАЦИИ С ZKBio CVSecurity =
1.3	19
1.4	20	== 2.1. Настройка подключения ==
1.3	21
1.4	22	Для настройки подключения к СКУД ZKBio CVSecurity необходимо перейти в «Настройки подсистемы PROSTO:СКУД» и установить флаг для используемого СКУД.
	23
	24
	25	[[image:1763013725910-273.png\|\|height="380" width="1020"]]
	26
	27
	28	[[image:1763013819938-404.png]]
	29
	30
	31	Затем необходимо перейти к элементам справочника «Системы контроля доступа» по одноименной ссылке раздела «PROSTO:СКУД». В элементах данного справочника настраиваются параметры подключения к системам СКУД, а также настройки интеграционного характера
1.5	32
	33	[[image:1763014478627-584.png\|\|height="404" width="1009"]]
1.6	34
	35
	36	Для начала на вкладке «Основные настройки» необходимо выбрать Вид системы контроля доступа – ZKTeco, указать наименование и данные подключения: адрес сервера в локальной сети, имя пользователя и пароль.
	37
	38	При помощи признака «Используется» можно отключать/включать интеграцию с конкретным сервером СКУД (например, на время отладки).
	39
	40	[[image:1763016476642-157.png\|\|height="447" width="804"]]
	41
	42
	43	На второй вкладке указываются дополнительные настройки, отвечающие за параметры и состав данных, участвующих в интеграции. Для первоначальной настройки рекомендуется воспользоваться кнопкой «Заполнить по умолчанию». После заполнения необходимо установить нужные строчные или числовые данные, либо изменить на «ДА» в значении тех параметров, которые будут использоваться при обмене данными между СКУД и 1С.
	44
	45
	46	[[image:1763017798721-781.png]]
	47
1.7	48	Изменять состав параметров можно будет при необходимости добавляя дополнительные настройки из общего справочника.
	49
	50	*Например, настройкой «Тип авторизации» можно выбирать характер авторизации: по Токену или Логину /Паролю - в зависимости от настроенной авторизации в самом СКУД.
	51
	52	[[image:1763018013967-734.png\|\|height="402" width="597"]]
1.8	53
	54
	55	После заполнения дополнительных настроек необходимо убедится, что соединение со СКУД устанавливается, нажав на кнопку «Проверить соединение»:
	56
	57	[[image:1763019228916-838.png]]
	58
	59	Отдельно следует упомянуть настройку «Использовать отложенную выгрузку» (на вкладке «Дополнительные настройки»), если данная настройка установлена, то система не будет выгружать данные в СКУД в момент их изменения, а зарегистрирует измененные объекты в соответствующем СКУД узле, далее данные будут выгружены регламентным заданием.
	60
	61	Полный состав предопределенных настроек, применимых к различным СКУД, можно посмотреть по ссылке «Дополнительные настройки СКУД» раздела «PROSTO: СКУД».
	62
	63	[[image:1763019643096-747.png\|\|height="507" width="1004"]]
	64
1.9	65
	66	== 2.2. Начальная синхронизация с ZKBio CVSecurity ==
1.10	67
	68	Существует два подхода начала работы с системой.
	69
	70	1. Сначала создаются все доступные справочные данные в системе PROSTO:СКУД и данные выгружаются в СКУД регламентным заданием после настройки (подробнее в п.п. 2.3).
	71	1. СКУД уже запущена на момент внедрения PROSTO:СКУД и содержит в себе данные. Для этого в системе PROSTO:СКУД предусмотрены обработки Начальной синхронизации – индивидуальные для каждого вида СКУД.
	72
	73
1.11	74
2.2	75	[[image:1763020260834-701.png\|\|height="310" width="1235"]]
1.11	76
2.4	77	Для вызова обработки начальной синхронизации со СКУД ZKBio CVSecurity необходимо перейти в раздел «PROSTO: СКУД» – Сервис – «Начальная синхронизация ZKBio CVSecurity».
1.10	78
2.4	79	Открыв обработку, необходимо выбрать Систему контроля доступа и перемещаясь между вкладками в том порядке, в котором они расположены в форме обработки, поочередно синхронизировать объекты системы PROSTO:СКУД и ZKBio CVSecurity.
	80
	81	Для того, чтобы данные отобразились в строках табличной части, необходимо нажать кнопку «Заполнить».
	82
	83	[[image:1763026197282-126.png]]
	84
	85	Каждая запись об объекте в табличной части разделяется на две строки.
	86
	87	В первой строке указываются данные из основной базы 1С, во второй строке соответственно указываются данные, поступившие из СКУД BioSmart.
	88
	89	Первичное сопоставление для большинства объектов производится по наименованию.
	90
	91	Таким образом, у пользователя есть возможность сравнить данные и в случае несовпадения сопоставить данные вручную либо создать недостающие объекты средствами обработки. В случае расхождения данных между базами в третьей колонке табличной части одно из значений будет пустым.
	92
	93	[[image:1763026457018-483.png\|\|height="353" width="1056"]]
2.5	94
	95	Чтобы данные из 1С и данные внешней базы были идентичны, их нужно синхронизировать.
	96
	97	Для этого необходимо выбрать приоритет синхронизации: СКУД (загрузка данных из СКУД в 1С) или 1С (выгрузка данных из 1С в СКУД), отметить флажками нужные строки и нажать кнопку «Синхронизировать».
	98
	99	Если синхронизация данных прошла успешно, в первой колонке появится надпись Данные синхронизированы.
	100
	101	[[image:1763026607456-697.png\|\|height="357" width="1054"]]
	102
	103	При этом система создаст запись идентификатора объекта в системе СКУД в регистр сведений «Идентификаторы объектов СКУД».
2.6	104
	105	[[image:1763026873435-909.png\|\|height="212" width="1052"]]
2.7	106
	107	То, как поведет себя система при сопоставлении объектов, будет ли объект перезаписан или просто сопоставлен при помощи идентификатора, задается в дополнительных настройках элемента справочника «Системы контроля доступа».
	108
	109	[[image:1763027119163-117.png]]
	110
	111	Отдельно рассмотрим каждую вкладку обработки интеграции:
	112
	113	=== 2.2.1 Организации. ===
	114
2.9	115	При создании организационной структуры предприятия в системе ZKBio CVSecurity организации встают в верхний уровень иерархии справочника «Отдел» корневой
	116
	117	элемент, название которого обычно совпадает с названием предприятия (организации).
2.11	118
	119	[[image:1763099397573-846.png\|\|height="731" width="1105"]]
	120
	121	[[image:1763099571994-634.png]]
	122
	123	Первичное сопоставление данных происходит по наименованию. Возможна двухсторонняя интеграция, т. е. выгрузка из СКУД и загрузка в СКУД из 1С объектов.
	124
	125
2.12	126	=== 2.2.2 Подразделения. ===
	127
2.13	128	В системе ZKBio CVSecurity подразделения. хранятся в иерархическом справочнике «Отдел», с возможностью создания многоуровневого раскрывающегося списка структурных подразделений.
2.12	129
2.13	130	[[image:1763099785814-929.png]]
2.12	131
2.13	132	Первичное сопоставление данных происходит по наименованию. Возможна двухсторонняя интеграция, т.е. выгрузка из СКУД и загрузка в СКУД из 1С Объектов. При сопоставлении учитывается родитель. Синхронизация подразделения нижнего уровня иерархии не предусмотрена, каждое подразделение необходимо синхронизировать отдельно.
	133
2.15	134	=== 2.2.3. Территория. ===
	135
2.17	136	Территории - в системе ZKBio CVSecurity - это список «Зоны»
2.15	137
2.17	138	[[image:1763102909069-224.png]]
	139
2.15	140	[[image:1763102562656-934.png]]
	141
	142	При синхронизации территорий с приоритетом «СКУД» в 1С создаются элементы справочника «Территории (СКУД)» После синхронизации для рабочих территорий в справочнике «Территории (СКУД)» необходимо установить флаг «Это рабочая территория».
	143
	144	[[image:1763102607672-820.png]]
	145
2.14	146	=== 2.2.4 Контроллеры ===
	147
	148	Контроллеры в системе ZKBio CVSecurity это элемент «Устройства».
	149
2.17	150	[[image:1763103189275-775.png\|\|height="270" width="1111"]]
2.14	151
	152
	153	[[image:1763101815846-768.png]]
	154
2.15	155	В подсистеме PROSTO:СКУД реализован аналогичный справочник, в данном справочнике задаются контроллеры/точки доступа. После создания элемента справочника Контроллеры в поле «Территория вход» указывается территория, на которую попадает сотрудник при входе на предприятие при использовании карты доступа. «Территория выход» – заполняется аналогично и определяет территорию выхода, при использовании карты доступа.
	156
2.18	157	Первичное сопоставление данных по наименованию.
	158
2.15	159	[[image:1763102335451-578.png]]
2.18	160
	161
	162
	163	=== 2.2.5 Уровни/Шаблоны доступа. ===
	164
	165
	166	Уровни доступа - в системе ZKBio CVSecurity представляет собой одноименный справочник.
	167
	168	[[image:1763104544528-123.png]]
	169
	170	[[image:1763104424514-327.png\|\|height="209" width="1060"]]
	171
	172	При синхронизации уровней доступа с приоритетом «СКУД» в 1С создаются элементы справочника «Уровни доступа (СКУД)»
	173
2.19	174
	175	Warning
	176
	177	ВАЖНО: Для успешной синхронизации объектов необходимо установить соответствующие дополнительные настройки элемента справочника Системы контроля доступа, где для уровней доступа – настройка «Создавать/обновлять уровни доступа» - отвечает за возможность создания Уровней доступа в 1С при ручной синхронизации с СКУД, а настройка «Создавать/обновлять уровни доступа в СКД» отвечает за возможность создания Уровней доступа в СКУД при ручной либо автоматической синхронизации с 1С.
	178
	179
	180	[[image:1763104730945-698.png]]
2.20	181
	182
	183	=== 2.2.6 Сотрудники. ===
	184
2.21	185	Сотрудники - в системе ZKBio CVSecurity представляют собой справочник «Сотрудник».
2.20	186
2.21	187	[[image:1763105948080-888.png\|\|height="309" width="1292"]]
2.20	188
	189	[[image:1763105737899-310.png]]
2.22	190
2.28	191	В зависимости от значения дополнительной настройки Системы контроля доступа «Синхронизировать только работающих сотрудников» в выборку данных из 1С будут попадать только физические лица работающих сотрудников или также не работающих.
2.22	192
2.28	193	Для сопоставления сотрудников нужно предварительно синхронизировать Организацию, в которой работает данный сотрудник, - если она не синхронизирована, то и Сотрудника синхронизировать не удастся. Если не синхронизировано подразделение, в которое принят сотрудник в 1С, то сотрудник будет помещен в корень синхронизированной Организации в СКУД ZKBio CVSecurity.
	194
2.27	195	Первичное сопоставление данных по ФИО и табельным номерам. Возможна двухсторонняя интеграция.
2.25	196
	197	{{warning}}
	198	Подсистема «PROSTO:СКУД» позволяет реализовать функционал групповой блокировки доступа сотрудников на территорию предприятия в СКУД из 1С на время зарегистрированных плановых отсутствий. Для этого потребуется:
	199
	200	~1. Добавить дополнительную настройку элемента Справочника Системы контроля доступа "Автоматически блокировать сотрудников на время плановых отсутствий СКД" и установить её в значении «Истина»;
	201
	202	[[image:1763124193213-971.png]]
	203
	204
	205	2. Добавить необходимую запись в регистр сведений «Состояния сотрудника для блокировки в СКУД» либо заполнить значения состояний по умолчанию:
	206
	207	[[image:1763124240327-802.png]]
	208
	209
	210	В данной настройке используются типовое для 1С ЗУП 3.1, ERP 2.4-2.5, КА 2 перечисление «Состояния сотрудника». Данные о состояниях когда сотрудник работает, а когда находится в отпуске или на больничном фиксируются в регистре Данные состояний сотрудников, различными документами, например Отпуск, Отгул, Отпуск без сохранения оплаты и т.д.
	211
	212	[[image:1753953496899-202.png]]
	213
	214
	215	Подсистема PROSTO:СКУД отслеживает такие записи и принимает решение о блокировке доступа сотрудника в СКУД, если установленное состояние среди записей регистра Состояния сотрудника для блокировки в СКУД.
	216
	217	Но если существует необходимость по той или иной причине одномоментно провести групповую блокировку по документу регистрации отсутствия сотрудников списком, то можно воспользоваться функционалом «Обработки начальной синхронизации» перейдя на вкладку Сотрудники.
	218
	219	[[image:1763124658843-500.png\|\|height="315" width="1081"]]
	220
	221
	222	После создания соответствующего приказа, например о Простое, отстранении от работы списком:
	223
	224	[[image:1763124812920-508.png\|\|height="391" width="1077"]]
	225
	226
	227	во вкладке Сотрудники - формы «Обработки начальной синхронизации» после заполнения, в колонке «Заблокирован» по строке 1С, сотрудники из приказа будут отмечены, как уже заблокированные. Далее, нужно пометить этих сотрудников и синхронизировать с приоритетом 1С.
	228
	229
	230	[[image:1763124966631-549.png\|\|height="181" width="1080"]]
	231
	232	В СКУД для выбранных сотрудников доступ будет заблокирован на время действия приказа, либо до ручной отмены приказа в случае изменения обстоятельств.
	233
	234	[[image:1753959493913-990.png]]
	235
	236
	237	За оперативную обратную разблокировку доступов Сотрудников отвечает регламентное задание подсистемы PROSTO:СКУД: «Разблокировка сотрудников в СКУД после отсутствий», которое должно быть включено и настроено для работы по расписанию.
	238	{{/warning}}
2.27	239
	240	=== 2.2.7 События СКУД. ===
	241
	242	События СКУД – вкладка предназначена для ручной загрузки данных о событиях проходов сотрудников, которые зафиксировал тот или иной контроллер доступа.
2.28	243
	244	В поле «Период» по умолчанию указывается текущий день, но при необходимости можно задать тот период, за который необходимо получить данные. В табличной части в колонке «Пометка» указано, загрузились ли данные в систему или нет. Для того, чтобы загрузить данные в систему PROSTO:СКУД, нужно выбрать необходимые строки, проставив галочки. Если необходимо выбрать все строки сразу, то можно нажать на кнопку «Установить флажки», после чего нажать на кнопку Синхронизировать.

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

Навигация

Быстрый переход: