Исходный код вики Настройка интеграции с PERCo-S-20

Версия 90.4 от Всезнайка PROSTO:СКУД на 2025/07/24 07:21

version	line-number	content
1.3	1	= 1. ОПИСАНИЕ СИСТЕМЫ =
	2
	3	«PROSTO:СКУД» — программный продукт реализованный в виде расширения на платформе 1С:Предприятие решает задачи интеграции СКУД и 1С ЗУП 3.1, ERP 2.4, 2.5, КА 2. Система поддерживает автоматический обмен данными между 1С и популярными СКУД, автоматизирует бизнес-процессы по созданию и учету сотрудников в СКУД. Значительно упрощает работу специалистов отдела кадров и отдела безопасности: избавляет от двойного ввода информации в 1С и СКУД, сокращает время составления табеля учета рабочего времени.
	4
	5	Функциональные возможности:
	6
2.2	7	* Возможность синхронизации объектов систем 1С и СКУД (Организации, Подразделения, Должности, Сотрудники и т.д.), а также загрузки данных о посещениях предприятия из СКУД в ручном и автоматическом режиме.
	8	* Возможность выдачи, продления, возврата карт доступа на стороне 1С, с последующим автоматическим отражением данных в СКУД.
	9	* Возможность назначения прав доступа владельцам карт в СКУД на стороне 1С, с последующим автоматическим отражением данных в СКУД.
	10	* Возможность автоматизированного формирования табелей учета рабочего времени сотрудников в информационной базе 1С с учетом данных из СКУД.
	11	* Возможность автоматизированного формирования индивидуальных графиков учета рабочего времени сотрудников в информационной базе 1С по данным о фактических проходах из СКУД.
	12	* Отчеты, позволяющие в информационной базе 1С:
	13	** Производить план-фактный анализ отработанного времени за период с отборами по Организации, Подразделению, Сотруднику.
	14	** Оперативно отслеживать фактически присутствующий персонал на предприятии.
	15	** Оперативно отслеживать прогулы и опоздания Сотрудников.
	16	** Просматривать действующие карты Сотрудников на конкретную дату.
	17	** Посматривать права доступа Сотрудников на объекты доступа в системе СКУД.
1.3	18
	19	= 2. Настройка интеграции с СКУД «PERCo-S-20» =
	20
1.5	21	== 2.1. Настройка подключения ==
1.4	22
5.2	23	Для настройки подключения к СКУД «PERCo-S-20» необходимо перейти Раздел ««PROSTO:СКУД»» – НСИ – Системы контроля доступа (СКУД):
	24
64.2	25	[[image:1753261766019-412.png]]
5.2	26
	27
	28	В элементах данного справочника настраиваются параметры подключения к системам СКУД, а также настройки интеграционного характера.
	29
	30	Необходимо выбрать Вид системы контроля доступа – Perco, указать наименование и данные подключения: адрес сервера в локальной сети, порт Firebird (по умолчанию 3050), имя пользователя и пароль БД Firebird.
	31
	32	При помощи признака «Используется» можно отключать/включать интеграцию с конкретным сервером СКУД, например на время отладки.
	33
65.2	34	[[image:1753261856470-849.png]]
5.2	35
	36
	37	Логин и пароль БД Firebird можно найти в «Центре управления PERCo-S-20» на закладке Создание и управление БД.
	38
	39	[[image:1751890871657-314.png]]
	40
5.3	41
	42	После заполнения необходимо установить «ДА» в значении тех параметров, которые будут использоваться при обмене данными между СКУД и 1С.
	43
5.4	44	На второй вкладке указываются дополнительные настройки, отвечающие за параметры и состав данных, участвующих в интеграции. Для первоначальной настройки рекомендуется воспользоваться кнопкой «Заполнить по умолчанию».». После заполнения необходимо установить «ДА» в значении тех параметров, которые будут использоваться при обмене данными между СКУД и 1С. После заполнения изменять состав и значения параметров можно будет по необходимости.
5.3	45
7.2	46	[[image:1751956468263-375.png]]
	47
	48	{{warning}}
	49	Важно: для СКУД «PERCo-S-20»-S-20 необходимо заполнить в Дополнительных настройках поля:
	50
	51	- База данных - путь к базе данных, задаваемый в «Центре управления PERCo-S-20» на закладке Создание и управление БД.
	52
	53	[[image:1751956519082-669.png]]
	54
	55
	56	- Логин и пароль SDK - логин и пароль, которому предоставлены права администратора, задаваемые в разделе «Назначение прав доступа операторов» в Консоли управления СКУД «PERCo-S-20»-S-20. По умолчанию ADMIN и пустой пароль
	57
8.2	58	[[image:1751956539893-796.png]]
8.3	59
	60
9.2	61	- Порт данных для подключения к серверу системы (по умолчанию 211), задаваемый в «Центре управления PERCo-S-20» на закладке Дополнительные настройки сервера системы
	62
	63	[[image:1751956566770-980.png]]
	64
	65
	66	Предварительно перед работой необходимо настроить подключение к базе данных Firebird на сервере где развернута Платформа 1С и на сервере PERCo.
7.2	67	{{/warning}}
	68
9.2	69	== 2.2. Настройка подключения к базе данных Firebird ==
	70
	71	Для корректной интеграции необходимо настроить два варианта подключения:
	72
13.2	73	1) Для обмена, реализованного посредством языка запросов SQL, необходимо скопировать файлы gds32.dll с сервера PERCo из папок C:\Windows\System32 и C:\Windows\SysWOW64 в соответствующие папки system32 и sysWOW64 на сервер, где развернута Платформа 1С и зарегистрировать с использованием утилиты regsvr32.exe.
	74
	75	[[image:1751956634797-834.png]]
	76
	77
	78	Также на сервере, где развернута Платформа 1С необходимо установить ODBC драйвер в зависимости от битности 1С. Скачать актуальный драйвер можно со страницы [[https:~~/~~/firebirdsql.org/en/odbc-driver/>>url:https://firebirdsql.org/en/odbc-driver/]]
	79
	80	Для обмена посредством SDK необходимо зарегистрировать компоненту PERCo_S20_SDK.dll на сервере 1С. Компоненту можно взять с сервера PERCo из директории C:\Program Files (x86)\PERCo\PERCo-S-20.
	81
67.2	82	[[image:1753276144035-378.png]]
13.2	83
	84
	85	Запустить консоль «Службы компонентов».
	86
	87	«Панель управления» — «Администрирование» — выбрать «Службы компонентов».
	88
	89	[[image:1751956671143-840.png]]
	90
	91
	92	Далее добавить новый элемент, для этого перейти «Компьютеры» — «Мой компьютер» — из списка выбрать «Приложения COM+».
	93
68.2	94	[[image:1753276306209-956.png]]
16.2	95
	96
	97	В контекстном меню выбрать «Создать» — «Приложение».
	98
71.2	99	[[image:1753276429648-600.png]]
16.2	100
	101
	102	Откроется Мастер установки приложений COM+. Нажать «Далее».
	103
	104	Выбрать вариант «Создать новое приложение».
	105
71.2	106	[[image:1753276489191-713.png]]
16.2	107
	108
	109	В поле «Введите имя нового приложения:» ввести «PercoS20».
	110
	111	«Способ активации» установить «Серверное приложение».
	112
18.2	113	Нажать «Далее».
	114
71.2	115	[[image:1753276538315-971.png]]
18.2	116
	117
	118	На следующем этапе выбрать учетную запись, под которой запускается приложение. Установить «Текущий (вошедший в систему) пользователь».
	119
	120	Нажать «Далее».
	121
74.2	122	[[image:1753337654541-909.png]]
18.2	123
	124
20.2	125	На этапе «Добавление ролей приложения» нажать «Далее».
18.2	126
74.2	127	[[image:1753337690984-916.png]]
16.2	128
	129
20.2	130	На этапе «Добавление пользователей для ролей» нажать «Далее».
18.2	131
75.2	132	[[image:1753337738854-354.png]]
20.2	133
	134
	135	Далее «Готово».
	136
76.2	137	[[image:1753337778692-969.png]]
20.2	138
	139
76.2	140	В ветке только что созданного нами приложения переходим в подветку «Компоненты» и создать компонент.
23.2	141
	142	В контекстном меню выбрать «Создать» — «Компонент».
	143
78.2	144	[[image:1753337911091-603.png]]
23.2	145
	146
	147	Откроется Мастер установки компонентов COM+. Нажать «Далее». Выбрать первый вариант «Установка новых компонентов».
	148
78.3	149	[[image:1753337976680-880.png]]
23.2	150
	151
	152	В открывшемся диалоге выбрать необходимый файл PERCo_S20_SDK.dll и нажать «Открыть». Окно Мастера установки компонентов COM+ измениться, нажать «Далее».
	153
79.2	154	[[image:1753338221400-469.png]]
23.2	155
	156
25.1	157	Мастер собрал все необходимые сведения для выполнения установки, нажимаем «Готово».
23.2	158
80.2	159	[[image:1753338373347-690.png]]
25.1	160
	161	{{warning}}
	162	Важно: после установки необходимо изменить свойства объекта.
	163
27.2	164	Для этого переходим к ветке PercoS20.
	165
	166	Открываем свойства созданного компонента, переходим в ветку PercoS20 —«Свойства».
	167
81.2	168	[[image:1753338662671-695.png]]
27.2	169
	170
80.3	171	В открывшемся окне перейти на вкладку «Безопасность».
27.2	172
80.3	173	В «Авторизация» снять флаг «Принудительная проверка доступа для приложений». В «Политика программных ограничений» установить флаг «Применить политику программных ограничений» и выбрать «Уровень ограничений:» — «Неограниченный».
	174
82.2	175	[[image:1753338775898-503.png]]
27.2	176
	177
	178	Перейти на вкладку «Удостоверение», установить «Указанный пользователь:» и ввести данные учетной записи с правами Администратора. В случае если используете домен, указать доменную учетную запись.
28.2	179
84.1	180	[[image:1753338968457-266.png]]
28.3	181
	182
	183	Нажать «Применить» — «ОК».
80.4	184	{{/warning}}
28.3	185
29.2	186	== 2.3. Проверка подключения к базе данных Firebird ==
	187
	188	После заполнения полей необходимо проверить подключение к серверу СКУД «PERCo-S-20», нажав на кнопку «Проверить соединение». Если все настройки выполнены корректно, на форме появятся сообщения об успешном подключении к СКУД, а также заполнится поле “Версия СКУД”.
	189
85.2	190	[[image:1753339728437-835.png]]
29.2	191
	192
30.2	193	Полный состав предопределенных настроек, применимых к различным СКУД можно посмотреть по ссылке «Дополнительные настройки СКУД» раздела «PROSTO:СКУД».
29.2	194
86.2	195	[[image:1753339815772-655.png]]
30.2	196
	197
	198	= 3. Начальная синхронизация со СКУД «PERCo-S-20» =
	199
	200	Существует два варианта начала работы с системой.
	201
	202	1. Создаются все доступные справочные данные в системе «PROSTO:СКУД», далее выгружаются в СКУД «PERCo-S-20» в ручном режиме либо регламентным заданием после настройки (подробнее в п.п. 2.3).
	203	1. СКУД уже запущена на момент внедрения «PROSTO:СКУД» и содержит в себе данные. Для этого в системе «PROSTO:СКУД» предусмотрены обработки Начальной синхронизации – индивидуальные для каждого вида СКУД.
	204
	205	Для вызова обработки начальной синхронизации с СКУД «PERCo-S-20» необходимо перейти в раздел PROSTO:СКУД – Сервис – Начальная синхронизация PERCo.
34.2	206
87.2	207	[[image:1753340019069-154.png]]
34.2	208
	209
	210	Открыв обработку, необходимо выбрать Систему контроля доступа и перемещаясь между вкладками в том порядке, в котором они расположены в форме обработки, поочередно синхронизировать объекты подсистемы «PROSTO:СКУД» и СКУД «PERCo-S-20».
	211
88.2	212	[[image:1753340261293-707.png]]
34.2	213
	214
	215	Для того, чтобы данные отобразились в строках табличной части, необходимо нажать кнопку «Заполнить».
	216
89.2	217	[[image:1753341066256-514.png]]
34.2	218
	219
89.3	220	Каждая запись об объекте в табличной части разделяется на две строки. В первой строке указываются данные из основной базы 1С, во второй строке, соответственно, указываются данные, поступившие из СКУД «PERCo-S-20».
34.2	221
89.2	222	Первичное сопоставление для большинства объектов производится по наименованию. Таким образом у пользователя есть возможность сравнить данные и в случае несовпадения сопоставить данные вручную либо создать недостающие объекты средствами обработки.
34.2	223
	224	В случае расхождения данных между базами в первой колонке табличной части будет указано, что значения различаются.
	225
	226	[[image:1752053700721-778.png]]
37.2	227
	228
89.5	229	Для того, чтобы данные из 1С и данные внешней базы были идентичны, необходимо их синхронизировать.
37.2	230
89.6	231	Для этого требуется выбрать приоритет синхронизации: СКУД (загрузка данных из СКУД) или 1С (выгрузка данных в СКУД), отметить флажками нужные строки и нажать кнопку «Синхронизировать».
37.2	232
	233	[[image:1752053716914-889.png]]
	234
	235
	236	Если синхронизация данных прошла успешно, в первой колонке появится надпись Данные синхронизированы и заполнится Идентификатор.
	237
	238	[[image:1752053733994-221.png]]
	239
	240
	241	Также при успешной синхронизации данных системой производится запись идентификатора объекта в системе СКУД в регистр сведений «Идентификаторы объектов СКУД».
	242
	243	[[image:1752053748041-232.png]]
	244
	245
	246	То, как поведет себя система при сопоставлении объектов, будет ли объект перезаписан или просто сопоставлен при помощи идентификатора, задается в дополнительных настройках элемента справочника «Системы контроля доступа».
	247
	248	//Почти по всем объектам (кроме контроллеров и шаблонов доступа) возможна двухсторонняя интеграция т.е. выгрузка из СКУД и загрузка в СКУД из 1С Объектов. Контроллеры и Шаблоны доступа только загружаются из СКУД в 1С.//
	249
	250	Отдельно рассмотрим каждую вкладку обработки.
37.3	251
37.4	252	== 3.1. Синхронизация Организаций СКУД «PERCo-S-20» ==
38.2	253
	254	Организации - в системе PERCo являются корневым элементом для структуры подразделений и ключевым отбором в отчетах. Находятся в разделе «Персонал» - «Учетные данные».
	255
90.2	256	[[image:1753341489983-459.png]]
41.2	257
	258
	259	В 1С используется типовой справочник «Организации». Механизм синхронизации не отличается от описанного выше п.2.2.
	260
	261	{{warning}}
90.4	262	ВАЖНО: Для успешной синхронизации того или иного объекта необходимо установить соответствующие дополнительные настройки элемента справочника Системы контроля доступа. Где, на примере организаций, «Создавать/обновлять организации» отвечает за возможность создания Организаций в 1С при ручной синхронизации со СКУД, а настройка «Создавать/обновлять организации в СКД» - отвечает за возможность создания Организаций в СКУД при ручной или автоматической синхронизации с 1С.
41.2	263
	264	[[image:1752053965015-779.png]]
	265	{{/warning}}
	266
	267	Дополнительные настройки «Синхронизировать сотрудников всех организаций» позволяют ограничить перечень данных Организаций, Подразделений и Сотрудников, участвующих в интеграции с конкретным СКУД.
	268
	269	[[image:1752053981929-463.png]]
	270
	271
41.3	272	[[image:1752053991675-796.png]]
	273
	274
44.2	275	Для этого реализован Регистр Сведений «Организации для синхронизации (СКУД)». Заполнить список организаций.
	276
	277	[[image:1752054006481-128.png]]
	278
	279
	280	При заполнении вкладки Организации при начальной синхронизации с СКУД «PERCo-S-20» подберутся только те организации, которые указаны в регистре «Организации для синхронизации (СКУД)»
	281
	282	[[image:1752054023675-685.png]]
	283
	284
	285	== 3.2. Синхронизация Подразделения с PERCo ==
	286
	287	Подразделения – в системе PERCo представляют из себя иерархический справочник, размещенный в разделе «Персонал» - «Учетные данные». В структуре иерархии корневой элемент- организация, синхронизированная ранее на вкладке «Организации».
	288
	289	[[image:1752054061506-464.png]]
	290
	291
	292	В системе «PROSTO: СКУД» используется типовой справочник 1С (ЗУП, ERP, КА) «Подразделения».
45.2	293
	294	[[image:1752054081722-641.png]]
47.2	295
	296
	297	В обработке синхронизация подразделений осуществляется на второй вкладке «Подразделения».
	298
	299	[[image:1752054103984-467.png]]
	300
	301
	302	В колонках Подразделение и идентификатор родителя отображаются данные родительской группы.
	303
	304	Механизм синхронизации не отличается от описанного выше п.3.1.
	305
	306	== 3.3. Синхронизация Территорий СКУД «PERCo-S-20». ==
	307
	308	Территории – в системе PERCo представляют иерархический справочник.
	309
	310	[[image:1752054143523-275.png]]
	311
	312
	313	В системе «PROSTO:СКУД» реализован не иерархический справочник.
	314
50.2	315	[[image:1752054159848-143.png]]
	316
	317
	318	Для синхронизации территорий необходимо перейти на третью вкладку «Территории».
	319
	320	[[image:1752054174458-509.png]]
	321
	322
	323	Механизм синхронизации не отличается от описанного выше п.3.1.
	324
	325	== 3.4. Синхронизация Контроллеров с PERCo ==
	326
	327	Контроллеры - в системе PERCo представляют собой справочник Точек доступа (дверей, турникетов и т.д.). Увидеть их можно в разделе «Конфигуратор».
	328
	329	[[image:1752054217209-420.png]]
	330
	331
	332	В подсистеме «PROSTO:СКУД» реализован аналогичный справочник Контроллеры/точки доступа (СКУД). В данном справочнике задаются территории.
	333
54.1	334	[[image:1752054233157-219.png]]
	335
	336
	337	После создания элемента справочника Контроллеры в поле «Территория вход» указывается территория, на которую попадает сотрудник при входе на предприятие при использовании карты доступа или Face ID. «Территория выход» – заполняется аналогично и определяет территорию выхода, при использовании карты доступа или Face ID.
	338
	339	[[image:1752054250809-920.png]]
	340
	341
	342	Сопоставление данных 1С и СКУД осуществляется на четвертой вкладке обработки – Контроллеры.
	343
	344	[[image:1752054264891-882.png]]
	345
	346
56.2	347	//Первичное сопоставление данных по наименованию. Возможна только загрузка элементов справочника Контроллеры из СКУД.//
54.2	348
56.2	349	== 3.5. Синхронизация Должностей с СКУД «PERCo-S-20» ==
	350
	351	Должности - в системе PERCo представляют собой справочник Должностей сотрудников. Справочник располагается в разделе «Персонал» -«Учетные данные».
	352
	353	[[image:1752123289925-536.png]]
	354
	355
	356	При внедрении подсистемы «PROSTO:СКУД» в тиражное решение от 1С (ЗУП, ERP, КА) используется типовой справочник Должности.
	357
	358	Сопоставлению данных 1С и СКУД осуществляется на пятой вкладке –Должности.
	359
	360	[[image:1752123311181-647.png]]
	361
	362
	363	Механизм синхронизации не отличается от описанного выше п.3.1.
56.3	364
58.2	365	== 3.6. Синхронизация Графиков работы СКУД «PERCo-S-20» ==
	366
	367	Графики работы - в системе PERCo представляют собой набор справочников, размещенных в разделе «Персонал» - «Графики работы». Каждому графику работы в PERCo присваивается схема работы.
	368
	369	[[image:1752123418353-429.png]]
	370
	371
	372	Схемы работы - отражают порядок распределения именованных интервалов работы по дням цикла (недельные, сменные или месячные). А именованные интервалы – это набор временных интервалов, характеризующихся началом и концом.
	373
	374	[[image:1752123443567-426.png]]
	375
	376
	377	В системе «PROSTO:СКУД» для сопоставления Графиков работы используется типовой справочник 1С (ЗУП, ERP, КА) «Графики работы». При выгрузке данных графиков в СКУД на каждый график работы создается Схема с аналогичным наименованием.
58.3	378
	379	{{warning}}
	380	Необходимо заметить, что в PERCo выгружаются только недельные и сменные графики.
	381	{{/warning}}
	382
61.2	383	Именованным интервалам в системе «PROSTO:СКУД» соответствует справочник «Рабочее время».
	384
	385	[[image:1752123499562-760.png]]
	386
	387
	388	Синхронизация Графиков работы 1С и СКУД реализована на шестой и седьмой вкладках обработки.
	389
	390	[[image:1752123519945-557.png]]
	391
	392
	393	Перед тем как выгрузить или сопоставить графики работ, необходимо выгрузить рабочее время на вкладке «Рабочее время», а потом на седьмой вкладке «Графики работ».
	394
	395	Для сопоставления графиков на вкладке «Графики работы» доступен отбор по актуальным графикам в 1С — это значит, что в отбор попадут все графики работы, установленные работающим сотрудникам на текущую дату и не помеченные на удаление.
	396
	397	[[image:1752123547303-158.png]]
	398
	399	{{warning}}
	400	За интеграцию рабочего времени и графиков работ отвечает дополнительная настройка «Создавать графики СКД». Если в поле указано «Истина», то будут создаваться Графики работы, Схемы и Именованные интервалы, соответствующие рабочему времени в системе PERCo. Загрузка данных графиков и рабочего времени из СКУД не реализована.
63.1	401
	402	[[image:1752123584804-615.png]]
61.2	403	{{/warning}}
	404
63.1	405	== 3.7. Синхронизация Шаблонов доступа с PERCo ==
	406
	407	Шаблоны доступа - в системе PERCo представляют собой набор прав входа на территории предприятия. Задается на вкладке «Доступ сотрудников» - «Шаблоны доступа». Для назначения прав сотрудникам шаблоны можно скопировать, как одному сотруднику, так и группе сотрудников.

Исходный код вики Настройка интеграции с PERCo-S-20

Навигация

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