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

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

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