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

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

Редактировал(а) Всезнайка PROSTO:СКУД 2026/01/27 13:31
Последние авторы
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 На вкладке Дополнительные настройки задаются  технические параметры подключения к базе данных СКУД и значения, отвечающие за параметры и состав данных, участвующих в интеграции. Для первоначальной настройки рекомендуется воспользоваться кнопкой «Заполнить по умолчанию». После заполнения изменять состав и значения параметров можно будет при необходимости.
73
74 Убедитесь, что заполнены следующие обязательные поля:
75
76 **База данных** – по умолчанию путь «**C:\Program Files\ENT\Server\DB\CBASE.FDB»**,
77
78 **Драйвер** – **«Firebird/InterBase(r) driver»**,
79
80 **Порт RESTAPI** – **8083 **и** Токен.**
81
82 Также необходимо заполнить следующие дополнительные настройки:
83
84 **Подразделение по умолчанию **-**  **укажите подразделение из справочника 1с, оно будет автоматически подставляться в карту доступа СКУД в случаях, когда подразделение у сотрудника не синхронизировано со СКУД или карта выдается физическому лицу, которое не является  сотрудником.
85
86 **Режим работы/Уровень доступа/Схема доступа по умолчанию **-  выберите уровень /схему доступа, который будет автоматически присваиваться новым картам при их выдаче или при первичной синхронизации сотрудников в СКУД. Это позволит сотруднику сразу получить базовый доступ.
87
88 [[image:1769492871816-343.png]]
89
90
91 Токен необходимо скопировать из настроенной EntAPI службы:
92
93 [[image:1759234489656-696.png]]
94
95 {{warning}}
96 **Важно, что для СКУД ЭНТ необходимо установить ODBC драйвер (скачать можно по **[[**ссылке**>>url:https://cloud.programstore.ru/index.php/s/c4Ri82dketpwQYM]]** с нашего облака) после установки ODBC драйвера необходимо перезапустить службу агента сервера 1С Предприятия.**
97 {{/warning}}
98
99 После всех настроек перед началом синхронизации данных необходимо проверить соединение, если ошибок нет, то можно продолжать настройку:
100
101 [[image:1759234520621-266.png]]
102
103
104 Полный состав предопределенных настроек применимых можно посмотреть по ссылке «Дополнительные настройки СКУД» раздела «СКУД».
105
106 [[image:1759234542542-565.png]]
107
108 Полный перечень настроек применимых к СКУД ЭНТ предоставляется по запросу.
109
110 == 4. Начальная синхронизация с ЭНТ ==
111
112 Существует два подхода начала работы с системой.
113
114 1. Создаются все доступные справочные данные в системе PROSTO:СКУД и  выгружаются в СКУД регламентным заданием после настройки (подробнее в п.п. 2.3).
115 1. СКУД уже запущена на момент внедрения PROSTO:СКУД и содержит в себе данные. Для этого в системе PROSTO:СКУД предусмотрены обработки Начальной синхронизации – индивидуальные для каждого вида СКУД.
116
117 Для вызова обработки начальной синхронизации с СКУД ЭНТ необходимо запустить соответствующую ссылку в разделе СКУД.
118
119 [[image:1759234600864-933.png]]
120
121
122 Открыв обработку, необходимо выбрать Систему контроля доступа и перемещаясь между вкладками в том порядке, в котором они расположены в форме обработки, поочередно синхронизировать объекты системы PROSTO:СКУД и ЭНТ.
123
124 [[image:1764596148775-708.png||height="266" width="961"]]
125
126
127 Для того, чтобы данные отобразились в строках табличной части, необходимо нажать кнопку «Заполнить».
128
129 [[image:1764596253967-557.png||height="251" width="945"]]
130
131
132 Каждая запись об объекте в табличной части разделяется на две строки.
133
134 В первой строке указываются данные из основной базы 1С, во второй строке соответственно указываются данные, поступившие из СКУД ЭНТ.
135
136 Первичное сопоставление для большинства объектов производится по наименованию. Таким образом, у пользователя есть возможность сравнить данные и в случае несовпадения сопоставить данные вручную либо создать недостающие объекты средствами обработки.
137
138 В случае расхождения данных между базами в первой колонке табличной части будет указано, что значения различаются.
139
140 Чтобы данные из 1С и данные внешней базы были идентичны, нужно их синхронизировать. **Перед синхронизацией необходимо установить настройки для тех типов объектов которые планируются для загрузки или выгрузки:**
141
142 [[image:1764596338591-867.png]]
143
144
145 Для синхронизации объектов необходимо выбрать приоритет: 1С (выгрузка данных в СКУД) или СКУД (загрузка данных в 1С), отметить флажками нужные строки и нажать кнопку «Синхронизировать».
146
147 [[image:1764596398213-872.png||height="261" width="972"]]
148
149
150 Если синхронизация данных прошла успешно, в первой колонке появится надпись Данные синхронизированы.
151
152 [[image:1764596444484-951.png||height="257" width="969"]]
153
154
155 При этом система создаст запись идентификатора объекта в системе СКУД в регистр сведений «Идентификаторы объектов СКУД»
156
157 [[image:1764596517634-393.png||height="121" width="972"]]
158
159
160 То, как поведет себя система при сопоставлении объектов, будет ли объект перезаписан или просто сопоставлен при помощи идентификатора, задается в дополнительных настройках элемента справочника Системы контроля доступа.
161
162 Отдельно рассмотрим некоторые вкладки обработки.
163
164 === 4.1. Контроллеры ===
165
166 **Контроллеры - **в системе ЭНТ представляют собой справочник Устройств (дверей, турникетов и т.д.). Для настройки и управления всеми точками доступа (ТД) СКУД «ЭНТ» предназначена вкладка «1. Конфигурация» - «Устройства». Существующие в системе Устройства отображаются в списке с указанием названия, состояния связи и статуса.
167
168 [[image:1759235005035-296.png]]
169
170
171 В системе PROSTO:СКУД – НСИ – Контроллеры/точки доступа (СКУД) реализован аналогичный функционал присвоения **Территорий Контроллерам (Точкам доступа):**
172
173 [[image:1759235018889-581.png]]
174
175
176 В справочнике Контроллеры в поле «Территория вход» указывается территория, на которую попадает сотрудник при входе на предприятие при использовании карты доступа. «Территория выход» – заполняется аналогично и определяет территорию выхода, при использовании карты доступа.
177
178 [[image:1759235038987-296.png]]
179
180
181 Для рабочих территорий в справочнике «Территории (СКУД)» необходимо установить флаг «Это рабочая территория»:
182
183 [[image:1759235171521-178.png]]
184
185
186 //Первичное сопоставление данных по наименованию. Возможна только загрузка элементов справочника Контроллеры из СКУД.//
187
188 === 4.2. Организации и Подразделения. ===
189
190 При формировании организационной структуры предприятия в системе ЭНТ верхний уровень иерархии в справочнике «Должности/Подразделения» занимает корневой элемент. Как правило, его название полностью соответствует наименованию организации (предприятия).
191
192 [[image:1764596922279-400.png||height="511" width="825"]]
193
194 [[image:1764596976660-304.png||height="228" width="836"]]
195
196 Первичное сопоставление данных происходит по наименованию. Возможна двухсторонняя интеграция, т. е. выгрузка из СКУД и загрузка в СКУД из 1С объектов.
197
198 ===== Настройки отвечающие за характер синхронизации объектов «Организации» =====
199
200 Для управления характером обмена данными между 1С и СКУД предусмотрены две ключевые настройки. Они определяют направление выгрузки информации при начальной синхронизации с разным приоритетом.
201
202 ~1. «Создавать/обновлять организации» (приоритет — СКУД)
203
204 Эта настройка регулирует передачу данных из СКУД в 1С:
205
206 * **Значение «Да»**
207 При начальной синхронизации с приоритетом «СКУД» вновь созданные или обновленные организации в СКУД будут автоматически выгружены в 1С.
208 Результат: данные в 1С актуализируются в соответствии с информацией из СКУД.
209 * **Значение «Нет»**
210 Изменения и новые записи в СКУД не будут переданы в 1С.
211 Результат: в 1С сохранятся прежние данные, синхронизация по этому объекту не произойдет.
212
213 2. «Создавать/обновлять организации СКД» (приоритет — 1С)
214
215 Эта настройка управляет передачей данных из 1С в СКУД:
216
217 * **Значение «Да»**
218 При начальной синхронизации с приоритетом «1С» вновь созданные или измененные организации в 1С будут выгружены в СКУД.
219 Результат: данные в СКУД обновятся в соответствии с информацией из 1С.
220 * **Значение «Нет»**
221 Изменения и новые записи в 1С не будут переданы в СКУД.
222 Результат: в СКУД сохранятся прежние данные, синхронизация по этому объекту не произойдет.
223
224 [[image:1764597041323-296.png||height="245" width="614"]]
225
226 В системе ЭНТ подразделения организованы в виде иерархического справочника «Должности/Подразделения». Это решение позволяет выстраивать структуру компании в формате многоуровневого раскрывающегося списка, где каждое структурное подразделение может быть вложено в вышестоящее, формируя четкую древовидную организацию данных.
227
228 [[image:1764597115475-941.png||height="457" width="730"]]
229
230 Первичное сопоставление данных происходит по наименованию. Возможна двухсторонняя интеграция, т.е. выгрузка из СКУД и загрузка в СКУД из 1С Объектов. При сопоставлении учитывается родитель. Синхронизация подразделения нижнего уровня иерархии не предусмотрена, каждое подразделение необходимо синхронизировать отдельно.
231
232 ===== Настройки отвечающие за характер синхронизации объектов «Подразделения» =====
233
234 Для управления характером обмена данными между 1С и СКУД предусмотрены три ключевые настройки. Они определяют направление выгрузки информации и критерии отбора синхронизируемых записей.
235
236 ~1. «Создавать/обновлять подразделения» (приоритет — СКУД)
237
238 Настройка регулирует передачу данных** **из СКУД в 1С.
239
240 * **Значение «Да»**
241 При начальной синхронизации с приоритетом «СКУД» вновь созданные или обновленные подразделения в СКУД автоматически выгружаются в 1С.
242 Результат: данные в 1С актуализируются в соответствии с информацией из СКУД.
243 * **Значение «Нет»**
244 Изменения и новые записи в СКУД не передаются в 1С.
245 Результат: в 1С сохраняются прежние данные, синхронизация по этому объекту не выполняется.
246
247 2. «Создавать/обновлять подразделения в СКД» (приоритет — 1С)
248
249 Настройка управляет передачей данных из 1С в СКУД.
250
251 * **Значение «Да»**
252 При начальной синхронизации с приоритетом «1С» вновь созданные или измененные подразделения в 1С выгружаются в СКУД.
253 Результат: данные в СКУД обновляются в соответствии с информацией из 1С.
254 * **Значение «Нет»**
255 Изменения и новые записи в 1С не передаются в СКУД.
256 Результат: в СКУД сохраняются прежние данные, синхронизация по этому объекту не выполняется.
257
258 3. «Синхронизировать только действующие подразделения»
259
260 Настройка определяет критерии отбора подразделений для синхронизации.
261
262 * (((
263 **Значение «Да»**
264 В процесс синхронизации включаются только подразделения, которые на момент выполнения операции являются действующими в справочнике 1С «Подразделения».
265 Результат: при приоритете «1С» — в СКУД выгружаются исключительно действующие подразделения, обеспечивается чистота данных за счет исключения неактуальных записей.
266 )))
267 * (((
268 **Значение «Нет»**
269 В форму обработки начальной синхронизации попадают все подразделения из справочника 1С, включая те, которые на текущий момент не используются.
270 Результат: появляется возможность сопоставить или синхронизировать даже неактивные подразделения с аналогичными объектами в СКУД (если они существуют), при приоритете «1С» можно принудительно выгрузить в СКУД любые подразделения — даже если они в данный момент неактивны, но требуются в СКУД по особым причинам.
271 )))
272
273 ~* В справочнике 1С «Подразделения» должна быть включена галка для отображения не используемых Подразделений, влияет только на отбор подразделений на стороне 1с.
274
275 4. «Использовать организацию в качестве корневого подразделения»
276
277 При включении опции текущая организация становится корневым элементом для всех выгружаемых Подразделений.
278
279 [[image:1769497211729-574.png]]
280
281 === 4.3. Сотрудники ===
282
283 В системе ЭНТ представляет Объекты доступы СКУД. Для управления списком объектов доступа системы предназначена вкладка «2. Бюро пропусков» - «Персонал». Возможно добавление и удаление сотрудников, назначение Должностей и Подразделений сотрудникам, добавление ключей доступа и ограничение доступа по Схемам доступа, присвоение режимов доступа и так далее.
284
285 [[image:1759235389301-424.png]]
286
287
288 По причине того, что к одному элементу справочника Физические лица может относится несколько элементов справочника Сотрудники (внутренние, внешние совместители), а в системах СКУД как правило регистрируется только один элемент, реализовано сопоставление физлицо - объект СКУД сотрудник.
289
290 В зависимости от значения дополнительной настройки Системы контроля доступа «Синхронизировать только работающих сотрудников» в выборку данных из 1С будут попадать только физические лица работающих сотрудников или нет.
291
292 Синхронизация карт доступа: при синхронизации Сотрудников, если приоритет «СКУД» и сведения о картах не совпадают, система автоматически создаст документ выдачи карт при синхронизации.
293
294 //Первичное сопоставление данных по ФИО и табельным номерам. Возможна двухсторонняя интеграция.//
295
296 === 4.4. События СКУД ===
297
298 События СКУД - вкладка предназначена для ручной загрузки данных о событиях проходов сотрудников, которые зафиксировал тот или иной контроллер доступа.
299
300 [[image:1759235711966-803.png]]
301
302
303 **Период** – в поле Период по умолчанию указывается текущий день, но при необходимости можно задать тот период, за который необходимо получить данные.
304
305 В табличной части в **колонке Пометка** указано, загрузились ли данные в систему или нет. Для того, чтобы загрузить данные в систему PROSTO:СКУД нужно выбрать необходимые строки, проставив галочки.
306
307 Если необходимо выбрать все строки сразу, то можно нажать на кнопку Установить флажки. После чего нажать на кнопку Синхронизировать.
308
309 Данные в колонках табличной части:
310
311 **Дата **– показывает дату и время, когда сотрудником (физическим лицом) был осуществлен проход через турникет;
312
313 **Физ.лицо** – отражает полные фамилию, имя и отчество сотрудника;
314
315 **Идентификатор Физ.лица** – запись идентификатора физического лица;
316
317 **Контроллер** – отражает информацию о том, через какой контроллер был осуществлен проход;
318
319 **Дверь **– отображаются данные о направлении прохода, где «0» это вход, а «1» выход;
320
321 **Территория **– отражает данные о том, на какую территорию был осуществлен проход;
322
323 **Карта **– отражает номер карты, которая была использована при проходе.
324
325 === 4.5. Выдача карт ===
326
327 Данный документ находится в разделе PROSTO:СКУД - Документы и предназначен для выдачи или продления пропусков (карт доступа):
328
329 [[image:1769498722262-385.png||height="506" width="1076"]]
330
331
332 При заполнении документа необходимо указать вид операции, дату операции, систему контроля доступа, в которой планируется выдача/продление карты, а также заполнить табличную часть документа, указав:
333
334 - Номер карты доступа,
335
336 - Дату окончания действия карты (обратите внимание, если оставить поле "Действует до" пустым, система автоматически присвоит карте статус Бессрочная )
337
338 - Владельца карты – физическое лицо,
339
340 - Подразделение,
341
342 - Должность,
343
344 - Уровень/Шаблон доступа (автоматически будет подставлен уровень доступа (схема), указанный в дополнительной настройке "Режим работы/Уровень доступа/Схема доступа по умолчанию")
345
346 [[image:1769498793523-451.png||height="357" width="1157"]]
347
348
349 При проведении документа выполняется проверка: не были ли карты, указанные в документе, выданы ранее другим Физ лицам. В случае, если карта доступа была выдана ранее, то перед выдачей ее другому лицу необходимо оформить документ Возврата карт.
350
351 == 5. Настройка автоматического обмена данными с ЭНТ и получение событий проходов сотрудников ==
352
353 После первоначального сопоставления данных двух систем 1С и СКУД считается, что 1С выступает мастер системой и выгрузка новых объектов, а также изменения уже сопоставленных должны быть осуществлены и в СКУД.
354
355 Для настройки автоматического обмена данными со СКУД необходимо перейти в раздел PROSTO:СКУД – Интеграция с СКУД – Узлы регистрации объектов для выгрузки в СКУД
356
357 [[image:1769502776442-524.png]]
358
359
360 Для каждой подключаемой системы СКУД необходимо создать отдельный новый узел обмена.  Не используйте предопределенный ("пустой") узел, существующий в списке по умолчанию. Он является служебным. Всегда создавайте новый элемент справочника.
361
362 [[image:1759235895280-501.png]]
363
364
365 Далее в Настройках подсистемы PROSTO:СКУД, на вкладке «Настройки продукта» установить галку «Автоматически выгружать данный в СКУД» и настроить расписание выгрузки.
366
367 [[image:1759235990181-385.png]]
368
369
370 Для настройки расписания выгрузки объектов в СКУД и загрузки событий реализована дополнительная обработка «Регламентные задания СКУД», которую вы можете найти  в разделе Администрирование - Печатные формы, отчеты и обработки-Дополнительные отчеты и обработки.
371
372 [[image:1759236008287-832.png]]
373
374
375 После описанных выше настроек система будет в автоматическом режиме выгружать данные в СКУД в зависимости от настроек, заданных для каждой СКУД.
376
377 [[image:1759236023576-116.png]]
378
379
380 Отдельно следует упомянуть дополнительные настройки:
381
382 1. **«Использовать отложенную выгрузку в СКД» - **если данная настройка установлена, то система не будет выгружать данные в СКУД в момент их изменения, а зарегистрирует измененные объекты в соответствующем СКУД узле, далее данные будут выгружены регламентным заданием, в соответствии с настроенным режимом.
383 1. **«Автоматически выгружать сотрудников в СКД при приеме на работу» - **если данная настройка установлена, также установлены настройки **«Создавать/обновлять физических лиц в СКД» **и **«Создавать/обновлять подразделения в СКД», **то при приеме Сотрудника по основному месту работы система будет выгружать Физическое лицо -  Сотрудника в СКУД, помещая его в соответствующее Подразделение.
384 1. **«Автоматически блокировать сотрудников на время плановых отсутствий СКД» - **автоматически** **приостанавливает действие карты доступа** **на период зарегистрированного в 1с отсутствия (регистр Состояния сотрудника для блокировки в СКУД должен быть заполнен). Доступ возобновляется автоматически по окончанию срока отсутствия при помощи регламентного задания Разблокировка сотрудников в СКУД после отсутствий (PROSTO:СКУД).
385
386 [[image:1759236044931-735.png]]
387
388
389 Регистр "Состояния сотрудника для блокировки в СКУД" определяет перечень кадровых состояний, при наступлении которых действие карты доступа сотрудника должно быть приостановлено. Данный список является редактируемым, если вы хотите, чтобы карта блокировалась при определенном виде отсутствия добавьте соответствующее состояние в список, также если блокировка при определенном состоянии не требуется, удалите эту строку из регистра.
390
391 [[image:1759236063916-791.png]]
392
393
394 Следующая группа дополнительных настроек позволит автоматизировать работу по синхронизации данных между 1С и СКУД при увольнении сотрудников.
395
396 **4. «Автоматически блокировать сотрудников СКД при увольнении» - **если данная настройка установлена, то при увольнении у сотрудника в СКУД будут заблокированы все карты доступа и установлена дата срока действия равной дате последнего рабочего дня – т.е. он физически не сможет проходить на территорию предприятия из-за отсутствия прав. При это сам профиль Пользователя в СКУД остается доступен.
397
398 [[image:1759236105655-827.png]]
399
400
401 Пример заблокированного ключа в системе:
402
403 [[image:1759236122799-430.png]]
404 )))