Исходный код вики PERCo-Web

Версия 53.1 от PROSTO:СКУД на 2026/10/30 12:29

version	line-number	content
53.1	1	{{box title="Быстрый переход по пунктам инструкции"}}
	2	{{toc start="1" depth="2" numbered="false"/}}
	3	{{/box}}
1.1	4	= ОПИСАНИЕ СИСТЕМЫ =
	5
	6	«PROSTO:СКУД» — программный продукт реализованный в виде расширения на платформе 1С:Предприятие решает задачи интеграции СКУД и 1С ЗУП 3.1, ERP 2.4, 2.5, КА 2. Система поддерживает автоматический обмен данными между 1С и популярными СКУД, автоматизирует бизнес-процессы по созданию и учету сотрудников в СКУД. Значительно упрощает работу специалистов отдела кадров и отдела безопасности: избавляет от двойного ввода информации в 1С и СКУД, сокращает время составления табеля учета рабочего времени.
	7
34.3	8	Интеграционные возможности продукта «PROSTO:СКУД» позволяют:
1.1	9
34.6	10	* настраивать подключение к системам СКУД, а также настраивать параметры интеграции в отдельной СКУД, задавать расписания обменов с системами СКУД;
	11	* создавать или сопоставлять с текущими параметрами объекты систем СКУД:
34.7	12	** подразделения,
	13	** должности,
	14	** графики,
	15	** территории,
	16	** контроллеры доступа,
	17	** сотрудники (физические лица);
34.6	18	* выдавать, продлевать или блокировать - обеспечивать учет карт доступа;
	19	* устанавливать сотрудникам ограничения в разрезе рабочих помещений для более точного учета;
	20	* устанавливать права прохода через контрольные точки СКУД путем назначения сотрудникам групп и уровней доступа или указания определенных контроллеров СКУД;
	21	* просматривать данные о проходах сотрудников через точки доступа СКУД.
	22
1.2	23	= НАСТРОЙКА ИНТЕГРАЦИИ С PERCo-Web =
	24
1.3	25	== 1. Настройка подключения ==
	26
34.8	27	Для настройки подключения к СКУД PERCo-Web необходимо перейти в «Настройки подсистемы PROSTO:СКУД» и установить флаг для используемого СКУД.
34.3	28
48.1	29	[[image:1754563553298-729.png\|\|data-xwiki-image-style-border="true"]]
34.8	30
49.1	31	[[image:1754563629542-609.png\|\|data-xwiki-image-style-border="true" height="439" width="717"]]
35.2	32
36.2	33
36.3	34	Затем необходимо перейти к элементам справочника «Системы контроля доступа» по одноименной ссылке раздела «PROSTO:СКУД». В элементах данного справочника настраиваются параметры подключения к системам СКУД, а также настройки интеграционного характера:
36.2	35
49.1	36	[[image:1754312035563-813.png\|\|data-xwiki-image-style-border="true" height="751" width="1168"]]
2.2	37
	38
36.5	39	В элементах данного справочника настраиваются параметры подключения к системам СКУД, а также настройки интеграционного характера. Необходимо выбрать Вид системы контроля доступа – PERCo-Web, указать наименование и данные подключения: адрес сервера в локальной сети, имя пользователя и пароль. При помощи признака «Используется» можно отключать/включать интеграцию с конкретным сервером СКУД, например, на время отладки.
36.3	40
49.1	41	[[image:1754312161954-409.png\|\|data-xwiki-image-style-border="true" height="656" width="716"]]
3.2	42
	43
	44	На второй вкладке указываются дополнительные настройки, отвечающие за параметры и состав данных, участвующих в интеграции. Для первоначальной настройки рекомендуется воспользоваться кнопкой «Заполнить по умолчанию». После заполнения необходимо установить «ДА» в значении тех параметров, которые будут использоваться при обмене данными между СКУД и 1С.
	45
	46	Изменять состав параметров можно будет при необходимости.
	47
51.1	48	(% class="box infomessage" %)
	49	(((
52.1	50	Важно: При использовании защищенного соединения требуется в поле соответствующей дополнительной настройки перевести значение в положение Истина и изменить Порт с 80 на 443. Подробнее о том как настроить работу PERCo-Web через https можно изучить по [[ссылке>>doc:.Настройка-https-для-PERCo-Web.WebHome]]
51.1	51	)))
5.2	52
49.1	53	[[image:1754312301052-361.png\|\|data-xwiki-image-style-border="true" height="655" width="716"]]
5.2	54
	55
32.3	56	После заполнения всех полей можно проверить подключение к серверу СКУД, нажав на кнопку «Проверить соединение» на вкладке «Основные настройки». Если все настроено правильно, на форме появятся сообщения об успешном подключении к СКУД.
5.2	57
49.1	58	[[image:1754312363514-783.png\|\|data-xwiki-image-style-border="true" height="617" width="717"]]
5.2	59
5.3	60
37.2	61	Отдельно следует упомянуть настройку «Использовать отложенную выгрузку» (на вкладке «Дополнительные настройки»), если данная настройка включена, то система не будет выгружать данные в СКУД в момент их изменения, а зарегистрирует измененные объекты в соответствующем СКУД узле, далее данные будут выгружены регламентным заданием.
38.2	62	Полный состав предопределенных настроек применимых к СКУД PERCo-Web можно посмотреть по ссылке «Дополнительные настройки СКУД» раздела «СКУД».
37.2	63
48.1	64	[[image:1754567017955-421.png\|\|data-xwiki-image-style-border="true"]]
38.2	65
39.2	66
	67	Полный перечень настроек применимых к СКУД PERCo-Web предоставляется по запросу.
	68
5.3	69	== 2. Начальная синхронизация с PERCo-Web ==
	70
39.3	71	Существует два подхода начала работы с системой:
5.3	72
39.4	73	1. Сначала создаются все доступные справочные данные в системе PROSTO:СКУД и данные выгружаются в СКУД регламентным заданием после настройки (подробнее в п. 3).
32.4	74	1. СКУД уже запущена на момент внедрения PROSTO:СКУД и содержит в себе данные. Для этого в системе PROSTO:СКУД предусмотрены обработки Начальной синхронизации – индивидуальные для каждого вида СКУД.
5.3	75
39.4	76	Рассмотрим второй вариант, для этого откроем обработку начальной синхронизации со СКУД PERCo-Web из раздела «PROSTO:СКУД».
	77
5.3	78	Для вызова обработки начальной синхронизации с СКУД PERCo-Web необходимо перейти в раздел «PROSTO:СКУД» – Сервис – Начальная синхронизация PERCo-Web
	79
	80	Открыв обработку, необходимо выбрать Систему контроля доступа и перемещаясь между вкладками в том порядке, в котором они расположены в форме обработки, поочередно синхронизировать объекты системы PROSTO:СКУД и PERCo-Web.
5.4	81
48.1	82	[[image:1754312515414-512.png\|\|data-xwiki-image-style-border="true"]]
7.2	83
	84
32.5	85	Для того, чтобы данные отобразились в строках табличной части, необходимо нажать кнопку «Заполнить»:
7.2	86
49.1	87	[[image:1754312594196-767.png\|\|data-xwiki-image-style-border="true" height="312" width="1197"]]
8.1	88
	89
	90	Каждая запись об объекте в табличной части разделяется на две строки.
	91
	92	В первой строке указываются данные из основной базы 1С, во второй строке соответственно указываются данные, поступившие из СКУД PERCo-Web.
	93
39.5	94	Первичное сопоставление для большинства объектов производится по наименованию. Таким образом, у пользователя есть возможность сравнить данные и в случае несовпадения сопоставить данные вручную либо создать недостающие объекты средствами обработки. В случае расхождения данных между базами в первой колонке табличной части будет указано, что значения различаются.
8.1	95
49.1	96	[[image:1754483197431-646.png\|\|data-xwiki-image-style-border="true" height="364" width="1183"]]
9.2	97
	98
39.5	99	Чтобы данные из 1С и данные внешней базы были идентичны, их необходимо синхронизировать.
9.2	100
	101	Для этого необходимо выбрать приоритет синхронизации: СКУД (загрузка данных из СКУД в 1С) или 1С (выгрузка данных из 1С в СКУД), отметить флажками нужные строки и нажать кнопку «Синхронизировать».
	102
48.1	103	[[image:1754483294741-479.png\|\|data-xwiki-image-style-border="true"]]
10.2	104
	105
	106	Если синхронизация данных прошла успешно, в первой колонке появится надпись Данные синхронизированы. При этом система создаст запись идентификатора объекта в системе СКУД в регистр сведений «Идентификаторы объектов СКУД».
	107
48.1	108	[[image:1754483402241-826.png\|\|data-xwiki-image-style-border="true"]]
11.2	109
	110
	111	То, как поведет себя система при сопоставлении объектов, будет ли объект перезаписан или просто сопоставлен при помощи идентификатора, задается в дополнительных настройках элемента справочника «Системы контроля доступа»
	112
	113	Отдельно рассмотрим каждую вкладку обработки интеграции:
	114
11.4	115	=== 2.1. Организации ===
	116
	117	При создании организационной структуры предприятия в системе PERCo-Web организации встают в верхний уровень иерархии справочника «Подразделения» корневой элемент, название которого обычно совпадает с названием предприятия (организации).
	118
49.1	119	[[image:1754561389182-800.png\|\|data-xwiki-image-style-border="true" height="567" width="1178"]]
12.2	120
49.1	121	[[image:1754483812057-802.png\|\|data-xwiki-image-style-border="true" height="336" width="1177"]]
12.2	122
13.2	123
	124	Первичное сопоставление данных происходит по наименованию. Возможна двухсторонняя интеграция, т.е. выгрузка из СКУД и загрузка в СКУД из 1С объектов:
	125
	126	=== 2.2. Подразделения ===
13.3	127
39.7	128	В системе PERCo-Web подразделения хранятся в иерархическом справочнике «Подразделения», с возможностью создания многоуровневого раскрывающегося списка структурных подразделений.
13.3	129
48.1	130	[[image:1754484010032-585.png\|\|data-xwiki-image-style-border="true"]]
14.2	131
	132
39.8	133	Первичное сопоставление данных происходит по наименованию. Возможна двухсторонняя интеграция, т.е. выгрузка из СКУД и загрузка в СКУД из 1С Объектов. При сопоставлении учитывается родитель. Для синхронизации Подразделения нижнего уровня иерархии необходимо, чтобы все вышестоящие были синхронизированы.
14.2	134
46.2	135
14.2	136	=== 2.3. Должности ===
	137
	138	В системе PERCo-Web Должности представляют собой справочник «Должности». При внедрении подсистемы PROSTO:СКУД в типовом решении от 1С (ЗУП, ERP, КА) используется справочник «Должности».
15.2	139
49.1	140	[[image:1754561610679-168.png\|\|data-xwiki-image-style-border="true" height="589" width="1174"]]
15.2	141
40.2	142	При внедрении подсистемы PROSTO:СКУД в тиражное решение от 1С (ЗУП, ERP, КА) используется типовой справочник «Должности».
	143
15.2	144	Первичное сопоставление данных происходит по наименованию.
	145
48.1	146	[[image:1754484197402-134.png\|\|data-xwiki-image-style-border="true"]]
16.2	147
	148
	149	=== 2.4. Графики работы ===
	150
40.2	151	Графики работы в системе PERCo-Web представляют собой справочник «Графики работы».
18.2	152
48.1	153	[[image:1754568366944-832.png\|\|data-xwiki-image-style-border="true"]]
18.2	154
	155
40.3	156	При внедрении подсистемы PROSTO:СКУД в тиражное решение от 1С (ЗУП, ERP, КА) используется типовой справочник «Графики работы сотрудников».
40.2	157	Первичное сопоставление данных по наименованию.
	158
18.2	159	При создании подразделений в PERCo-Web, в поле «График работы» заданный график работы для подразделения, будет считаться заданным Графиком работы для всех сотрудников, числящихся в данном подразделении по умолчанию.
	160
	161
48.1	162	[[image:1754484635050-499.png\|\|data-xwiki-image-style-border="true"]]
19.2	163
	164
	165	При внедрении подсистемы PROSTO: СКУД в типовом решении от 1С (ЗУП, ERP, КА) используется справочник «Графики работы сотрудников».
	166
	167	Первичное сопоставление данных происходит по наименованию.
	168
	169	=== 2.5. Территории ===
	170
	171	Территории в системе PERCo-Web находятся в разделе «Помещения» справочника «Управление устройствами».
21.2	172
49.1	173	[[image:1754484726788-469.png\|\|data-xwiki-image-style-border="true" height="595" width="1197"]]
21.2	174
	175
	176	При синхронизации территорий с приоритетом «СКУД» в 1С создаются элементы справочника «Территории (СКУД)»
	177
48.1	178	[[image:1754484800030-531.png\|\|data-xwiki-image-style-border="true"]]
21.2	179
21.3	180
21.4	181	После синхронизации для рабочих территорий в справочнике «Территории (СКУД)» необходимо установить флаг «Это рабочая территория».
	182
49.1	183	[[image:1754484986933-201.png\|\|data-xwiki-image-style-border="true" height="632" width="716"]]
23.2	184
	185
	186	=== 2.6. Контроллеры ===
	187
	188	Контроллеры в системе PERCo-Web находятся в разделе «Устройства» справочника «Управление устройствами».
	189
49.1	190	[[image:1754485052140-113.png\|\|data-xwiki-image-style-border="true" height="285" width="1239"]]
23.2	191
23.3	192	В подсистеме PROSTO:СКУД реализован аналогичный справочник, в данном справочнике задаются территории. После создания элемента справочника Контроллеры в поле «Территория вход» указывается территория, на которую попадает сотрудник при входе на предприятие при использовании карты доступа. «Территория выход» – заполняется аналогично и определяет территорию выхода, при использовании карты доступа.
	193
49.1	194	[[image:1754485075990-677.png\|\|data-xwiki-image-style-border="true" height="524" width="717"]]
24.2	195
24.3	196	Первичное сопоставление данных происходит по наименованию. Возможна только загрузка элементов справочника Контроллеры из СКУД.
	197
24.5	198	=== 2.7. Сотрудники ===
24.6	199
25.2	200	В системе PERCo-Web список сотрудников представляет собой справочник «Сотрудники».
	201
48.1	202	[[image:1754570190848-553.png\|\|data-xwiki-image-style-border="true"]]
25.2	203
	204
41.2	205	В зависимости от значения дополнительной настройки Системы контроля доступа «Синхронизировать только работающих сотрудников» в выборку данных из 1С будут попадать только физические лица работающих сотрудников (или также не работающих). Для сопоставления сотрудников необходимо предварительно синхронизировать подразделения и должности, если они не синхронизированы, то и синхронизировать Сотрудника не удастся.
25.2	206
	207	Первичное сопоставление данных происходит по ФИО и табельным номерам. Возможна двухсторонняя интеграция.
26.2	208
	209	=== 2.8. События СКУД ===
	210
	211	Вкладка предназначена для ручной загрузки данных о событиях проходов сотрудников, которые зафиксировал тот или иной контроллер доступа.
	212
50.1	213	[[image:1787737889967-877.png\|\|data-xwiki-image-style-border="true"]]
27.2	214
27.3	215	В поле «Период» по умолчанию указывается текущий день, но при необходимости можно задать тот период, за который необходимо получить данные.
	216
	217	В табличной части в колонке «Пометка» указано, загрузились ли данные в систему или нет. Для того, чтобы загрузить данные в систему PROSTO:СКУД, нужно выбрать необходимые строки, проставив галочки.
	218
	219	Если необходимо выбрать все строки сразу, то можно нажать на кнопку «Установить флажки», после чего нажать на кнопку Синхронизировать.
27.4	220
50.1	221	[[image:1787737977949-648.png\|\|data-xwiki-image-style-border="true"]]
30.2	222
	223	Данные в колонках табличной части:
	224
	225	* Дата – показывает дату и время, когда сотрудником (физическим лицом) был осуществлен проход через турникет;
	226	* Физ. лицо – отражает полные фамилию, имя и отчество сотрудника;
	227	* Контроллер – отражает информацию о том, через какой контроллер был осуществлен проход;
	228	* Дверь – отображаются данные о направлении прохода, где «0» - это вход, а «1» - выход;
	229	* Территория – отражает данные о том, на какую территорию был осуществлен проход;
	230	* Карта – отражает номер карты, которая была использована при проходе.
	231
50.1	232	Настройка кодов успешных событий для СКУД PERCo-Web.
	233
	234	Начиная с релиза 1.2.8.6, появилась возможность настройки кодов успешных событий для СКУД Perco-Web.
	235
	236	В системе СКУД PERCo-Web существует большое количество внутренних кодов событий. Чтобы система PROSTO:СКУД могла точно определять, какие события считать реальными проходом, а какие - системной ошибкой, в систему введена гибкая настройка "Коды событий".
	237
	238	Данная настройка находится находится на вкладке Дополнительные настройки системы контроля доступа.
	239
	240	* Поле "Коды событий": имеет строковый тип, здесь через запятую перечисляются коды событий СКУД, которые система должна считать успешными.
	241
	242	(% class="box infomessage" %)
	243	(((
	244	По умолчанию при заполнении Дополнительный настроек в поле "Коды событий" установлено значение 17 (Проход по идентификатору)
	245	)))
	246
	247	* Как это работает:
	248
	249	Если код события, пришедший из СКУД, присутствует в этой строке настроек - событие признается успешным, в регистре События (СКУД) оно отображается как корректный проход.
	250
	251	Если кода события нет в списке - оно автоматически классифицируется как ошибочное, помечается флагом ошибки.
	252
	253	[[image:1787738559161-960.png\|\|data-xwiki-image-style-border="true" height="607" width="712"]]
	254
	255	Как настроить свои коды:
	256
	257	В первичной интеграции в колонке "Комментарий" автоматически записывается технический код событий в формате [Код] - [Наименование]. Если вы хотите разрешить проход по новому типу событий, найдите нужное событие и посмотрите его комментарий, чтобы определить код. После этого перейдите в Дополнительные настройки и просто допишите этот код через запятую в поле "Коды событий". При следующем обмене это событие будет считаться успешным.
	258
30.2	259	== 3. Настройка автоматического обмена данными с PERCo-Web и получение событий проходов сотрудников ==
	260
	261	После первоначального сопоставления данных двух систем 1С и СКУД считается, что 1С выступает мастер системой и выгрузка новых объектов, а также изменения уже сопоставленных должны быть осуществлены и в СКУД.
	262
	263	Для настройки автоматического обмена данными со СКУД необходимо в планах открыть форму плана обмена «Узлы регистрации объектов для выгрузки в СКУД», где для каждой СКУД в которую планируется выгрузка данных создать узел обмена.
	264
49.1	265	[[image:1754570431593-477.png\|\|data-xwiki-image-style-border="true" height="961" width="1246"]]
30.2	266
49.1	267	[[image:1754570507233-417.png\|\|data-xwiki-image-style-border="true" height="348" width="719"]]
30.2	268
46.1	269	{{warning}}
	270	Важно: необходимо именно «Создать» новый узел для каждой СКУД, а не использовать текущую пустую запись (данная запись предопределена и используется для других целей).
	271	{{/warning}}
30.2	272
32.1	273	Далее в дополнительных отчетах и обработках во внешней обработке «Регламентные задания СКУД» можно настроить расписание выгрузки.
	274
49.1	275	[[image:1754485496847-389.png\|\|data-xwiki-image-style-border="true" height="534" width="1260"]]
32.1	276
	277
	278	В этой же обработке задается «Импорт событии СКД (СКУД)» - т.е. периодичность, с которой система будет обращаться к настроенным в ней СКУД и получать события проходов через турникеты.
	279
	280	После описанных выше настроек система будет в автоматическом режиме выгружать данные в СКУД в зависимости от настроек.
46.2	281
48.1	282	=== 4. Назначения Шаблонов доступа ===
46.2	283
	284	Для подразделения в Perco-Web можно настроить Шаблоны доступа, которые будут устанавливаться по умолчанию сотрудникам этого подразделения.
	285
	286	Для этого нужно зайти в карточку подразделения и в параметре Шаблон доступа для сотрудника выбрать нужный шаблон доступа.
	287
48.1	288	[[image:1779350063063-667.png\|\|data-xwiki-image-style-border="true" height="524" width="399"]]
46.3	289
	290	Система 1С автоматически выдает права только один раз, оставляя дальнейшее управление службе безопасности.
	291
	292	~1. Прием на работу и первичная выгрузка
	293
	294	При добавлении нового сотрудника в СКУД (как в автоматическом обмене, так и при ручной выгрузке) система 1С определяет, в каком Подразделении он числится. Сотруднику автоматически присваивается базовый Шаблон доступа, привязанный к этому Подразделению.
	295
	296	2. Кадровые переводы (Изменение подразделения)
	297
	298	Если сотрудник ранее уже был выгружен в СКУД и у него уже есть какой -либо шаблон доступа, 1С не будет его изменять.
	299
47.1	300	* При кадровом переводе сотрудника в другой отдел. 1С обновит его должность и подразделения в Perco-Web, но шаблон доступа останется старым (от предыдущего подразделения)
	301	* Службе безопасности необходимо вручную зайти в Perco-Web и изменить Шаблон доступа переведенному сотруднику на актуальный. 1С сделает это автоматически только в том случае, если в карточке сотрудника в Perco-Web поле шаблона доступа абсолютно пустое.
	302
48.1	303	=== 5. Выдача карт ===
	304
	305	Данный документ находится в разделе «PROSTO:СКУД» – Карты и управление доступом.
	306
	307	Предназначен для выдачи или продления пропусков (карт доступа).
	308
	309	При заполнении документа необходимо указать вид операции, дату операции, систему контроля доступа, в которой планируется выдача/продление карты, а также заполнить табличную часть документа, указав:
	310
	311	– номер карты доступа,
	312
	313	– дату начала и окончания действия карты,
	314
	315	– владельца карты – физическое лицо,
	316
	317	– подразделение
	318
	319	– должность
	320
49.1	321	[[image:1786363033319-658.png\|\|data-xwiki-image-style-border="true" height="283" width="1214"]]
48.1	322
	323	Начиная с релиза 1.2.8.4, в системе реализован механизм, позволяющий определять размещение по подразделениям в СКУД для сторонних физических лиц, у которых в базе 1С:ЗУП нет трудового договора и кадрового подразделения. Для этого используется дополнительная настройка "Подразделение по умолчанию".
	324
49.1	325	[[image:1786363089286-781.png\|\|data-xwiki-image-style-border="true" height="346" width="1213"]]
48.1	326
	327	Как система определяет подразделение в СКУД при выдаче карты?
	328
	329	Когда регламентное задание обрабатывает документ выдачи карты и готовит данные для отправки в СКУД, оно определяет подразделение для физического лица по следующему приоритетному алгоритму:
	330
	331	* Кадровый приоритет: Система проверяет, есть ли у этого физического лица действующий трудовой договор в 1С. Если это штатный сотрудник - берется подразделение из его кадровых документов (приема/перевода). Поле "Подразделение" документа выдачи карт игнорируется.
	332	* Дополнительная настройка "Подразделение по умолчанию": Если кадровых данных нет (это стороннее физическое лицо), система обращается к настройке, вставляет Подразделение по умолчанию в документ выдачи карт и выгружает физлицо в Подразделение по умолчанию ( Подразделение должно быть синхронизировано).
	333	* Ручной выбор в документе: Если кадровых данных нет ( это стороннее физлицо), вы можете выбрать в поле "Подразделение" любое синхронизированное Подразделение (не обязательно из дополнительной настройки "Подразделение по умолчанию". Физлицо будет выгружено в выбранное подразделение.
	334
	335	{{warning}}
	336	Выбор или изменение подразделения в документе Выдача/продление карты влияет на СКУД только один раз - в момент самого первого создания (первичной выгрузки) этого физлица в базу СКУД.
	337	{{/warning}}
	338
46.3	339

Исходный код вики PERCo-Web

Навигация

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