Перейти к содержимому

Исходный код вики Настройка интеграции с ЭНТ

Редактировал(а) Всезнайка PROSTO:СКУД 2025/12/01 13:55
Последние авторы
1 = ОПИСАНИЕ СИСТЕМЫ =
2
3 «PROSTO:СКУД» — программный продукт реализованный в виде расширения на платформе 1С:Предприятие решает задачи интеграции СКУД и 1С ЗУП 3.1, ERP 2.4, 2.5, КА 2. Система поддерживает автоматический обмен данными между 1С и популярными СКУД, автоматизирует бизнес-процессы по созданию и учету сотрудников в СКУД. Значительно упрощает работу специалистов отдела кадров и отдела безопасности: избавляет от двойного ввода информации в 1С и СКУД, сокращает время составления табеля учета рабочего времени.
4
5 Интеграционные возможности продукта «PROSTO:СКУД» позволяют:
6
7 * настраивать подключение к системам СКУД, а также настраивать параметры интеграции в отдельной СКУД, задавать расписания обменов с системами СКУД;
8 * создавать или сопоставлять с текущими параметрами объекты систем СКУД:
9 ** организации,
10 ** подразделения,
11 ** должности,
12 ** графики,
13 ** территории,
14 ** контроллеры доступа,
15 ** сотрудники (физические лица);
16 * выдавать, продлевать или блокировать - обеспечивать учет карт доступа;
17 * устанавливать сотрудникам ограничения в разрезе рабочих помещений для более точного учета;
18 * устанавливать права прохода через контрольные точки СКУД путем назначения сотрудникам групп и уровней доступа или указания определенных контроллеров СКУД;
19 * просматривать данные о проходах сотрудников через точки доступа СКУД.
20
21 = НАСТРОЙКА ИНТЕГРАЦИИ С ЭНТ =
22
23 == 1. Настройка доступа к БД СКУД ==
24
25 Часть функционала интеграции с СКУД ЭНТ реализована через прямое подключение к БД СКУДа, для настройки доступа на стороне СКУД необходимо, найти конфигурационный файл СУБД Firebird firebird.conf он находится в каталоге C:\Program Files\Firebird\Firebird_3_0:
26
27 [[image:1759233649143-312.png]]
28
29
30 (((
31 В конфигурационном файле необходимо изменить параметры, установив новые значения:
32
33 **AuthServer = Srp, Legacy_Auth**
34
35 **UserManager = Srp, Legacy_Auth**
36
37 **WireCrypt = Enabled**
38
39 После установки параметров потребуется перезагрузка службы СУБД сервера.
40
41 {{warning}}
42 Важно, что для прямого подключения с СУБД используется порт по умолчанию 3050, т.к. все подключения выполняются с Сервера 1С Предприятия необходимо обеспечить сетевую доступность между серверами.
43 {{/warning}}
44
45 Также для подключения к БД СКУДа из 1С потребуется клиент ODBC, для этого необходимо найти файлы **fbclient.dll** 32-х битной 64-х битной версии, они находятся в каталогах **C:\Program Files\Firebird\Firebird_3_0** и **C:\Program Files\Firebird\Firebird_3_0\WOW64** соответственно. Данные файлы необходимо переименовать в **gds32.dll** и скопировать в **C:\Windows\System32** и **C:\Windows\SysWOW64** на сервер, **где развернута Платформа 1С и зарегистрировать с использованием утилиты regsvr32.exe**.
46
47
48 == 2. Настройка доступа к REST API ==
49
50 Вторая часть функционала интеграции с СКУД ЭНТ реализована через предоставляемы вендором REST API сервис, скачать дистрибутив сервиса и отдельную инструкцию по его настройке можно скачать по [[ссылке>>url:https://cloud.programstore.ru/index.php/s/2wDTaQFFswEGTmN]].
51
52 {{warning}}
53 Важно, что для прямого подключения с СКУД через REST API по умолчанию используется порт 8083, т.к. все подключения выполняются с Сервера 1С Предприятия необходимо обеспечить сетевую доступность между серверами.
54 {{/warning}}
55
56 == 3. Настройка подключения ==
57
58 Раздел «PROSTO:СКУД» - НСИ – Системы контроля доступа (СКУД):
59
60 [[image:1759234164511-299.png]]
61
62
63 В элементах данного справочника настраиваются параметры подключения к системам СКУД, а также настройки интеграционного характера.
64
65 Необходимо выбрать Вид системы контроля доступа – ЭНТ, указать наименование и данные подключения: адрес сервера в локальной сети и порт (по умолчанию 3050, имя пользователя для подключения к БД СКУД, для Firebird данные по умолчанию: логин - **SYSDBA **и пароль - **masterkey**, если он был изменен необходимо указать свой.
66
67 [[image:1759234456001-859.png]]
68
69
70 При помощи признака «Используется» можно отключать/включать интеграцию с конкретным сервером СКУД, например на время отладки.
71
72 На второй вкладке необходимо задать дополнительные настройки, отвечающие за параметры и состав данных, участвующих в интеграции. Для первоначальной настройки рекомендуется воспользоваться кнопкой «Заполнить по умолчанию». После заполнения изменять состав и значения параметров можно будет при необходимости. Есть ряд настроек необходимых для интеграции: **База данных** – по умолчанию путь «**C:\Program Files\ENT\Server\DB\CBASE.FDB»**, **Драйвер** – **«Firebird/InterBase(r) driver»**, **Порт RESTAPI** – **8083 **и** Токен.**
73
74 [[image:1759234473738-401.png]]
75
76
77 Токен необходимо скопировать из настроенной EntAPI службы:
78
79 [[image:1759234489656-696.png]]
80
81 {{warning}}
82 **Важно, что для СКУД ЭНТ необходимо установить ODBC драйвер (скачать можно по **[[**ссылке**>>url:https://cloud.programstore.ru/index.php/s/c4Ri82dketpwQYM]]** с нашего облака) после установки ODBC драйвера необходимо перезапустить службу агента сервера 1С Предприятия.**
83 {{/warning}}
84
85 После всех настроек перед началом синхронизации данных необходимо проверить соединение, если ошибок нет, то можно продолжать настройку:
86
87 [[image:1759234520621-266.png]]
88
89
90 Полный состав предопределенных настроек применимых можно посмотреть по ссылке «Дополнительные настройки СКУД» раздела «СКУД».
91
92 [[image:1759234542542-565.png]]
93
94 Полный перечень настроек применимых к СКУД ЭНТ предоставляется по запросу.
95
96 == 4. Начальная синхронизация с ЭНТ ==
97
98 Существует два подхода начала работы с системой.
99
100 1. Создаются все доступные справочные данные в системе PROSTO:СКУД и  выгружаются в СКУД регламентным заданием после настройки (подробнее в п.п. 2.3).
101 1. СКУД уже запущена на момент внедрения PROSTO:СКУД и содержит в себе данные. Для этого в системе PROSTO:СКУД предусмотрены обработки Начальной синхронизации – индивидуальные для каждого вида СКУД.
102
103 Для вызова обработки начальной синхронизации с СКУД ЭНТ необходимо запустить соответствующую ссылку в разделе СКУД.
104
105 [[image:1759234600864-933.png]]
106
107
108 Открыв обработку, необходимо выбрать Систему контроля доступа и перемещаясь между вкладками в том порядке, в котором они расположены в форме обработки, поочередно синхронизировать объекты системы PROSTO:СКУД и ЭНТ.
109
110 [[image:1764596148775-708.png||height="266" width="961"]]
111
112
113 Для того, чтобы данные отобразились в строках табличной части, необходимо нажать кнопку «Заполнить».
114
115 [[image:1764596253967-557.png||height="251" width="945"]]
116
117
118 Каждая запись об объекте в табличной части разделяется на две строки.
119
120 В первой строке указываются данные из основной базы 1С, во второй строке соответственно указываются данные, поступившие из СКУД ЭНТ.
121
122 Первичное сопоставление для большинства объектов производится по наименованию. Таким образом, у пользователя есть возможность сравнить данные и в случае несовпадения сопоставить данные вручную либо создать недостающие объекты средствами обработки.
123
124 В случае расхождения данных между базами в первой колонке табличной части будет указано, что значения различаются.
125
126 Чтобы данные из 1С и данные внешней базы были идентичны, нужно их синхронизировать. **Перед синхронизацией необходимо установить настройки для тех типов объектов которые планируются для загрузки или выгрузки:**
127
128 [[image:1764596338591-867.png]]
129
130
131 Для синхронизации объектов необходимо выбрать приоритет: 1С (выгрузка данных в СКУД) или СКУД (загрузка данных в 1С), отметить флажками нужные строки и нажать кнопку «Синхронизировать».
132
133 [[image:1764596398213-872.png||height="261" width="972"]]
134
135
136 Если синхронизация данных прошла успешно, в первой колонке появится надпись Данные синхронизированы.
137
138 [[image:1764596444484-951.png||height="257" width="969"]]
139
140
141 При этом система создаст запись идентификатора объекта в системе СКУД в регистр сведений «Идентификаторы объектов СКУД»
142
143 [[image:1764596517634-393.png||height="121" width="972"]]
144
145
146 То, как поведет себя система при сопоставлении объектов, будет ли объект перезаписан или просто сопоставлен при помощи идентификатора, задается в дополнительных настройках элемента справочника Системы контроля доступа.
147
148 Отдельно рассмотрим некоторые вкладки обработки.
149
150 === 4.1. Контроллеры ===
151
152 **Контроллеры - **в системе ЭНТ представляют собой справочник Устройств (дверей, турникетов и т.д.). Для настройки и управления всеми точками доступа (ТД) СКУД «ЭНТ» предназначена вкладка «1. Конфигурация» - «Устройства». Существующие в системе Устройства отображаются в списке с указанием названия, состояния связи и статуса.
153
154 [[image:1759235005035-296.png]]
155
156
157 В системе PROSTO:СКУД – НСИ – Контроллеры/точки доступа (СКУД) реализован аналогичный функционал присвоения **Территорий Контроллерам (Точкам доступа):**
158
159 [[image:1759235018889-581.png]]
160
161
162 В справочнике Контроллеры в поле «Территория вход» указывается территория, на которую попадает сотрудник при входе на предприятие при использовании карты доступа. «Территория выход» – заполняется аналогично и определяет территорию выхода, при использовании карты доступа.
163
164 [[image:1759235038987-296.png]]
165
166
167 Для рабочих территорий в справочнике «Территории (СКУД)» необходимо установить флаг «Это рабочая территория»:
168
169 [[image:1759235171521-178.png]]
170
171
172 //Первичное сопоставление данных по наименованию. Возможна только загрузка элементов справочника Контроллеры из СКУД.//
173
174 === 4.2. Организации и Подразделения. ===
175
176 При формировании организационной структуры предприятия в системе ЭНТ верхний уровень иерархии в справочнике «Должности/Подразделения» занимает корневой элемент. Как правило, его название полностью соответствует наименованию организации (предприятия).
177
178 [[image:1764596922279-400.png||height="511" width="825"]]
179
180 [[image:1764596976660-304.png||height="228" width="836"]]
181
182 Первичное сопоставление данных происходит по наименованию. Возможна двухсторонняя интеграция, т. е. выгрузка из СКУД и загрузка в СКУД из 1С объектов.
183
184 ===== Настройки отвечающие за характер синхронизации объектов «Организации» =====
185
186 Для управления характером обмена данными между 1С и СКУД предусмотрены две ключевые настройки. Они определяют направление выгрузки информации при начальной синхронизации с разным приоритетом.
187
188 ~1. «Создавать/обновлять организации» (приоритет — СКУД)
189
190 Эта настройка регулирует передачу данных из СКУД в 1С:
191
192 * **Значение «Да»**
193 При начальной синхронизации с приоритетом «СКУД» вновь созданные или обновленные организации в СКУД будут автоматически выгружены в 1С.
194 Результат: данные в 1С актуализируются в соответствии с информацией из СКУД.
195 * **Значение «Нет»**
196 Изменения и новые записи в СКУД не будут переданы в 1С.
197 Результат: в 1С сохранятся прежние данные, синхронизация по этому объекту не произойдет.
198
199 2. «Создавать/обновлять организации СКД» (приоритет — 1С)
200
201 Эта настройка управляет передачей данных из 1С в СКУД:
202
203 * **Значение «Да»**
204 При начальной синхронизации с приоритетом «1С» вновь созданные или измененные организации в 1С будут выгружены в СКУД.
205 Результат: данные в СКУД обновятся в соответствии с информацией из 1С.
206 * **Значение «Нет»**
207 Изменения и новые записи в 1С не будут переданы в СКУД.
208 Результат: в СКУД сохранятся прежние данные, синхронизация по этому объекту не произойдет.
209
210 [[image:1764597041323-296.png||height="245" width="614"]]
211
212 В системе ЭНТ подразделения организованы в виде иерархического справочника «Должности/Подразделения». Это решение позволяет выстраивать структуру компании в формате многоуровневого раскрывающегося списка, где каждое структурное подразделение может быть вложено в вышестоящее, формируя четкую древовидную организацию данных.
213
214 [[image:1764597115475-941.png||height="457" width="730"]]
215
216 Первичное сопоставление данных происходит по наименованию. Возможна двухсторонняя интеграция, т.е. выгрузка из СКУД и загрузка в СКУД из 1С Объектов. При сопоставлении учитывается родитель. Синхронизация подразделения нижнего уровня иерархии не предусмотрена, каждое подразделение необходимо синхронизировать отдельно.
217
218 ===== Настройки отвечающие за характер синхронизации объектов «Подразделения» =====
219
220 Для управления характером обмена данными между 1С и СКУД предусмотрены три ключевые настройки. Они определяют направление выгрузки информации и критерии отбора синхронизируемых записей.
221
222 ~1. «Создавать/обновлять подразделения» (приоритет — СКУД)
223
224 Настройка регулирует передачу данных** **из СКУД в 1С.
225
226 * **Значение «Да»**
227 При начальной синхронизации с приоритетом «СКУД» вновь созданные или обновленные подразделения в СКУД автоматически выгружаются в 1С.
228 Результат: данные в 1С актуализируются в соответствии с информацией из СКУД.
229 * **Значение «Нет»**
230 Изменения и новые записи в СКУД не передаются в 1С.
231 Результат: в 1С сохраняются прежние данные, синхронизация по этому объекту не выполняется.
232
233 2. «Создавать/обновлять подразделения в СКД» (приоритет — 1С)
234
235 Настройка управляет передачей данных из 1С в СКУД.
236
237 * **Значение «Да»**
238 При начальной синхронизации с приоритетом «1С» вновь созданные или измененные подразделения в 1С выгружаются в СКУД.
239 Результат: данные в СКУД обновляются в соответствии с информацией из 1С.
240 * **Значение «Нет»**
241 Изменения и новые записи в 1С не передаются в СКУД.
242 Результат: в СКУД сохраняются прежние данные, синхронизация по этому объекту не выполняется.
243
244 3. «Синхронизировать только действующие подразделения»
245
246 Настройка определяет критерии отбора подразделений для синхронизации.
247
248 * (((
249 **Значение «Да»**
250 В процесс синхронизации включаются только подразделения, которые на момент выполнения операции являются действующими в справочнике 1С «Подразделения».
251 Результат: при приоритете «1С» — в СКУД выгружаются исключительно действующие подразделения, обеспечивается чистота данных за счет исключения неактуальных записей.
252 )))
253 * (((
254 **Значение «Нет»**
255 В форму обработки начальной синхронизации попадают все подразделения из справочника 1С, включая те, которые на текущий момент не используются.
256 Результат: появляется возможность сопоставить или синхронизировать даже неактивные подразделения с аналогичными объектами в СКУД (если они существуют), при приоритете «1С» можно принудительно выгрузить в СКУД любые подразделения — даже если они в данный момент неактивны, но требуются в СКУД по особым причинам.
257 )))
258
259 ~* В справочнике 1С «Подразделения» должна быть включена галка для отображения не используемых Подразделений, влияет только на отбор подразделений на стороне 1с.
260
261 [[image:1764597278045-337.png||height="256" width="585"]]
262
263 === 4.3. Сотрудники ===
264
265 В системе ЭНТ представляет Объекты доступы СКУД. Для управления списком объектов доступа системы предназначена вкладка «2. Бюро пропусков» - «Персонал». Возможно добавление и удаление сотрудников, назначение Должностей и Подразделений сотрудникам, добавление ключей доступа и ограничение доступа по Схемам доступа, присвоение режимов доступа и так далее.
266
267 [[image:1759235389301-424.png]]
268
269
270 По причине того, что к одному элементу справочника Физические лица может относится несколько элементов справочника Сотрудники (внутренние, внешние совместители), а в системах СКУД как правило регистрируется только один элемент, реализовано сопоставление физлицо - объект СКУД сотрудник.
271
272 В зависимости от значения дополнительной настройки Системы контроля доступа «Синхронизировать только работающих сотрудников» в выборку данных из 1С будут попадать только физические лица работающих сотрудников или нет.
273
274 Синхронизация карт доступа: при синхронизации Сотрудников, если приоритет «СКУД» и сведения о картах не совпадают, система автоматически создаст документ выдачи карт при синхронизации.
275
276 //Первичное сопоставление данных по ФИО и табельным номерам. Возможна двухсторонняя интеграция.//
277
278 === 4.4. События СКУД ===
279
280 События СКУД - вкладка предназначена для ручной загрузки данных о событиях проходов сотрудников, которые зафиксировал тот или иной контроллер доступа.
281
282 [[image:1759235711966-803.png]]
283
284
285 **Период** – в поле Период по умолчанию указывается текущий день, но при необходимости можно задать тот период, за который необходимо получить данные.
286
287 В табличной части в **колонке Пометка** указано, загрузились ли данные в систему или нет. Для того, чтобы загрузить данные в систему PROSTO:СКУД нужно выбрать необходимые строки, проставив галочки.
288
289 Если необходимо выбрать все строки сразу, то можно нажать на кнопку Установить флажки. После чего нажать на кнопку Синхронизировать.
290
291 Данные в колонках табличной части:
292
293 **Дата **– показывает дату и время, когда сотрудником (физическим лицом) был осуществлен проход через турникет;
294
295 **Физ.лицо** – отражает полные фамилию, имя и отчество сотрудника;
296
297 **Идентификатор Физ.лица** – запись идентификатора физического лица;
298
299 **Контроллер** – отражает информацию о том, через какой контроллер был осуществлен проход;
300
301 **Дверь **– отображаются данные о направлении прохода, где «0» это вход, а «1» выход;
302
303 **Территория **– отражает данные о том, на какую территорию был осуществлен проход;
304
305 **Карта **– отражает номер карты, которая была использована при проходе.
306
307 === 4.5. Выдача карт ===
308
309 Данный документ находится в разделе PROSTO:СКУД - Документы и предназначен для выдачи или продления пропусков (карт доступа):
310
311 [[image:1759235784361-392.png]]
312
313
314 При заполнении документа необходимо указать вид операции, дату операции, систему контроля доступа, в которой планируется выдача/продление карты, а также заполнить табличную часть документа, указав:
315
316 - номер карты доступа,
317
318 - карта СКУД – номер подставится автоматически, согласно правилам хранения номера в СКУД (зашифрованный ключ),
319
320 - дату начала и окончания действия карты,
321
322 - владельца карты – физическое лицо,
323
324 - группу доступа,
325
326 - должность.
327
328 [[image:1759235808633-783.png]]
329
330
331 При проведении документа выполняется проверка: не были ли карты, указанные в документе, выданы ранее другим физлицам. В случае, если карта доступа была выдана ранее, то перед выдачей ее другому лицу необходимо оформить документ Возврата карт.
332
333 == 5. Настройка автоматического обмена данными с ЭНТ и получение событий проходов сотрудников ==
334
335 После первоначального сопоставления данных двух систем 1С и СКУД считается, что 1С выступает мастер системой и выгрузка новых объектов, а также изменения уже сопоставленных должны быть осуществлены и в СКУД.
336
337 Для настройки автоматического обмена данными со СКУД необходимо перейти в раздел PROSTO:СКУД – Интеграция с СКУД – Узлы регистрации объектов для выгрузки в СКУД
338
339 [[image:1759235874815-521.png]]
340
341
342 Где для каждой СКУД, в которую планируется выгрузка данных создать узел обмена:
343
344 [[image:1759235895280-501.png]]
345
346
347 Далее в Настройках подсистемы PROSTO:СКУД, на вкладке «Настройки продукта» установить галку «Автоматически выгружать данный в СКУД» и настроить расписание выгрузки.
348
349 [[image:1759235990181-385.png]]
350
351
352 Для настройки расписания выгрузки объектов в СКУД и загрузки событий реализована дополнительная обработка «Регламентные задания СКУД»
353
354 [[image:1759236008287-832.png]]
355
356
357 После описанных выше настроек система             будет в автоматическом режиме выгружать данные в СКУД в зависимости от настроек, заданных для каждой СКУД.
358
359 [[image:1759236023576-116.png]]
360
361
362 Отдельно следует упомянуть дополнительные настройки:
363
364 1. **«Использовать отложенную выгрузку в СКД» - **если данная настройка установлена, то система не будет выгружать данные в СКУД в момент их изменения, а зарегистрирует измененные объекты в соответствующем СКУД узле, далее данные будут выгружены регламентным заданием, в соответствии с настроенным режимом.
365 1. **«Автоматически выгружать сотрудников в СКД при приеме на работу» - **если данная настройка установлена, установлены настройки **«Создавать/обновлять физических лиц в СКД» **и **«Создавать/обновлять подразделения в СКД», **то при приеме Сотрудника по основному месту работы система будет выгружать Физическое лицо Сотрудника в СКУД, помещая его в соответствующее Подразделение
366 1. **«Автоматически блокировать сотрудников на время плановых отсутствий СКД» - **при наступлении события в трудовой деятельности сотрудника, который документами фиксирует в базе данных 1С отсутствие сотрудника и причину, данная настройка позволяет блокировать действие карты в СКУД на время его отсутствия.
367
368 [[image:1759236044931-735.png]]
369
370
371 В списке перечислены состояния сотрудника для блокировки. Соответственно состояния можно удалять либо создавать новый по мере необходимости.
372
373 [[image:1759236063916-791.png]]
374
375
376 Следующая группа дополнительных настроек позволит автоматизировать работу по синхронизации данных между 1С и СКУД при увольнении сотрудников.
377
378 **4. «Автоматически блокировать сотрудников СКД при увольнении» - **если данная настройка установлена, то при увольнении у сотрудника в СКУД будут заблокированы все ключи доступа и установлена дата срока действия равной дате последнего рабочего дня – т.е. он физически не сможет проходить на территорию предприятия из-за отсутствия прав. При это сам профиль Пользователя в СКУД остается доступен.
379
380 [[image:1759236105655-827.png]]
381
382
383 Пример заблокированного ключа в системе:
384
385 [[image:1759236122799-430.png]]
386 )))