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

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

Редактировал(а) Всезнайка PROSTO:СКУД 2025/10/01 08:50
Последние авторы
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 == 1. Настройка доступа к БД СКУД ==
23
24 Часть функционала интеграции с СКУД ЭНТ реализована через прямое подключение к БД СКУДа, для настройки доступа на стороне СКУД необходимо, найти конфигурационный файл СУБД Firebird firebird.conf он находится в каталоге C:\Program Files\Firebird\Firebird_3_0:
25
26 [[image:1759233649143-312.png]]
27
28
29 (((
30 В конфигурационном файле необходимо изменить параметры, установив новые значения:
31
32 **AuthServer = Srp, Legacy_Auth**
33
34 **UserManager = Srp, Legacy_Auth**
35
36 **WireCrypt = Enabled**
37
38 После установки параметров потребуется перезагрузка службы СУБД сервера.
39
40 {{warning}}
41 Важно, что для прямого подключения с СУБД используется порт по умолчанию 3050, т.к. все подключения выполняются с Сервера 1С Предприятия необходимо обеспечить сетевую доступность между серверами.
42 {{/warning}}
43
44 Также для подключения к БД СКУДа из 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**.
45
46
47 == 2. Настройка доступа к REST API ==
48
49 Вторая часть функционала интеграции с СКУД ЭНТ реализована через предоставляемы вендором REST API сервис, скачать дистрибутив сервиса и отдельную инструкцию по его настройке можно скачать по [[ссылке>>url:https://cloud.programstore.ru/index.php/s/2wDTaQFFswEGTmN]].
50
51 {{warning}}
52 Важно, что для прямого подключения с СКУД через REST API по умолчанию используется порт 8083, т.к. все подключения выполняются с Сервера 1С Предприятия необходимо обеспечить сетевую доступность между серверами.
53 {{/warning}}
54
55 == 3. Настройка подключения ==
56
57 Раздел «PROSTO:СКУД» - НСИ – Системы контроля доступа (СКУД):
58
59 [[image:1759234164511-299.png]]
60
61
62 В элементах данного справочника настраиваются параметры подключения к системам СКУД, а также настройки интеграционного характера.
63
64 Необходимо выбрать Вид системы контроля доступа – ЭНТ, указать наименование и данные подключения: адрес сервера в локальной сети и порт (по умолчанию 3050, имя пользователя для подключения к БД СКУД, для Firebird данные по умолчанию: логин - **SYSDBA **и пароль - **masterkey**, если он был изменен необходимо указать свой.
65
66 [[image:1759234456001-859.png]]
67
68
69 При помощи признака «Используется» можно отключать/включать интеграцию с конкретным сервером СКУД, например на время отладки.
70
71 На второй вкладке необходимо задать дополнительные настройки, отвечающие за параметры и состав данных, участвующих в интеграции. Для первоначальной настройки рекомендуется воспользоваться кнопкой «Заполнить по умолчанию». После заполнения изменять состав и значения параметров можно будет при необходимости. Есть ряд настроек необходимых для интеграции: **База данных** – по умолчанию путь «**C:\Program Files\ENT\Server\DB\CBASE.FDB»**, **Драйвер** – **«Firebird/InterBase(r) driver»**, **Порт RESTAPI** – **8083 **и** Токен.**
72
73 [[image:1759234473738-401.png]]
74
75
76 Токен необходимо скопировать из настроенной EntAPI службы:
77
78 [[image:1759234489656-696.png]]
79
80 {{warning}}
81 **Важно, что для СКУД ЭНТ необходимо установить ODBC драйвер (скачать можно по **[[**ссылке**>>url:https://cloud.programstore.ru/index.php/s/c4Ri82dketpwQYM]]** с нашего облака) после установки ODBC драйвера необходимо перезапустить службу агента сервера 1С Предприятия.**
82 {{/warning}}
83
84 После всех настроек перед началом синхронизации данных необходимо проверить соединение, если ошибок нет, то можно продолжать настройку:
85
86 [[image:1759234520621-266.png]]
87
88
89 Полный состав предопределенных настроек применимых можно посмотреть по ссылке «Дополнительные настройки СКУД» раздела «СКУД».
90
91 [[image:1759234542542-565.png]]
92
93 Полный перечень настроек применимых к СКУД ЭНТ предоставляется по запросу.
94
95 == 4. Начальная синхронизация с ЭНТ ==
96
97 Существует два подхода начала работы с системой.
98
99 1. Создаются все доступные справочные данные в системе PROSTO:СКУД и  выгружаются в СКУД регламентным заданием после настройки (подробнее в п.п. 2.3).
100 1. СКУД уже запущена на момент внедрения PROSTO:СКУД и содержит в себе данные. Для этого в системе PROSTO:СКУД предусмотрены обработки Начальной синхронизации – индивидуальные для каждого вида СКУД.
101
102 Для вызова обработки начальной синхронизации с СКУД ЭНТ необходимо запустить соответствующую ссылку в разделе СКУД.
103
104 [[image:1759234600864-933.png]]
105
106
107 Открыв обработку, необходимо выбрать Систему контроля доступа и перемещаясь между вкладками в том порядке, в котором они расположены в форме обработки, поочередно синхронизировать объекты системы PROSTO:СКУД и ЭНТ.
108
109 [[image:1759234616377-745.png]]
110
111
112 Для того, чтобы данные отобразились в строках табличной части, необходимо нажать кнопку «Заполнить».
113
114 [[image:1759234632937-494.png]]
115
116
117 Каждая запись об объекте в табличной части разделяется на две строки.
118
119 В первой строке указываются данные из основной базы 1С, во второй строке соответственно указываются данные, поступившие из СКУД ЭНТ.
120
121 Первичное сопоставление для большинства объектов производится по наименованию. Таким образом, у пользователя есть возможность сравнить данные и в случае несовпадения сопоставить данные вручную либо создать недостающие объекты средствами обработки.
122
123 В случае расхождения данных между базами в первой колонке табличной части будет указано, что значения различаются.
124
125 [[image:1759234649954-989.png]]
126
127
128 Чтобы данные из 1С и данные внешней базы были идентичны, нужно их синхронизировать. **Перед синхронизацией необходимо установить настройки для тех типов объектов которые планируются для загрузки или выгрузки:**
129
130 [[image:1759234668266-204.png]]
131
132
133 Для синхронизации объектов необходимо выбрать приоритет: 1С (выгрузка данных в СКУД) или СКУД (загрузка данных в 1С), отметить флажками нужные строки и нажать кнопку «Синхронизировать».
134
135 [[image:1759234692346-451.png]]
136
137
138 Если синхронизация данных прошла успешно, в первой колонке появится надпись Данные синхронизированы.
139
140 [[image:1759234705627-689.png]]
141
142
143 При этом система создаст запись идентификатора объекта в системе СКУД в регистр сведений «Идентификаторы объектов СКУД»
144
145 [[image:1759234734229-833.png]]
146
147
148 То, как поведет себя система при сопоставлении объектов, будет ли объект перезаписан или просто сопоставлен при помощи идентификатора, задается в дополнительных настройках элемента справочника Системы контроля доступа.
149
150 Отдельно рассмотрим некоторые вкладки обработки.
151
152 === 4.1. Контроллеры ===
153
154 **Контроллеры - **в системе ЭНТ представляют собой справочник Устройств (дверей, турникетов и т.д.). Для настройки и управления всеми точками доступа (ТД) СКУД «ЭНТ» предназначена вкладка «1. Конфигурация» - «Устройства». Существующие в системе Устройства отображаются в списке с указанием названия, состояния связи и статуса.
155
156 [[image:1759235005035-296.png]]
157
158
159 В системе PROSTO:СКУД – НСИ – Контроллеры/точки доступа (СКУД) реализован аналогичный функционал присвоения **Территорий Контроллерам (Точкам доступа):**
160
161 [[image:1759235018889-581.png]]
162
163
164 В справочнике Контроллеры в поле «Территория вход» указывается территория, на которую попадает сотрудник при входе на предприятие при использовании карты доступа. «Территория выход» – заполняется аналогично и определяет территорию выхода, при использовании карты доступа.
165
166 [[image:1759235038987-296.png]]
167
168
169 Для рабочих территорий в справочнике «Территории (СКУД)» необходимо установить флаг «Это рабочая территория»:
170
171 [[image:1759235171521-178.png]]
172
173
174 //Первичное сопоставление данных по наименованию. Возможна только загрузка элементов справочника Контроллеры из СКУД.//
175
176 === 4.2. Сотрудники ===
177
178 В системе ЭНТ представляет Объекты доступы СКУД. Для управления списком объектов доступа системы предназначена вкладка «2. Бюро пропусков» - «Персонал». Возможно добавление и удаление сотрудников, назначение Должностей и Подразделений сотрудникам, добавление ключей доступа и ограничение доступа по Схемам доступа, присвоение режимов доступа и так далее.
179
180 [[image:1759235389301-424.png]]
181
182
183 По причине того, что к одному элементу справочника Физические лица может относится несколько элементов справочника Сотрудники (внутренние, внешние совместители), а в системах СКУД как правило регистрируется только один элемент, реализовано сопоставление физлицо - объект СКУД сотрудник.
184
185 В зависимости от значения дополнительной настройки Системы контроля доступа «Синхронизировать только работающих сотрудников» в выборку данных из 1С будут попадать только физические лица работающих сотрудников или нет.
186
187 Синхронизация карт доступа: при синхронизации Сотрудников, если приоритет «СКУД» и сведения о картах не совпадают, система автоматически создаст документ выдачи карт при синхронизации.
188
189 //Первичное сопоставление данных по ФИО и табельным номерам. Возможна двухсторонняя интеграция.//
190
191 === 4.3. События СКУД ===
192
193 События СКУД - вкладка предназначена для ручной загрузки данных о событиях проходов сотрудников, которые зафиксировал тот или иной контроллер доступа.
194
195 [[image:1759235711966-803.png]]
196
197
198 **Период** – в поле Период по умолчанию указывается текущий день, но при необходимости можно задать тот период, за который необходимо получить данные.
199
200 В табличной части в **колонке Пометка** указано, загрузились ли данные в систему или нет. Для того, чтобы загрузить данные в систему PROSTO:СКУД нужно выбрать необходимые строки, проставив галочки.
201
202 Если необходимо выбрать все строки сразу, то можно нажать на кнопку Установить флажки. После чего нажать на кнопку Синхронизировать.
203
204 Данные в колонках табличной части:
205
206 **Дата **– показывает дату и время, когда сотрудником (физическим лицом) был осуществлен проход через турникет;
207
208 **Физ.лицо** – отражает полные фамилию, имя и отчество сотрудника;
209
210 **Идентификатор Физ.лица** – запись идентификатора физического лица;
211
212 **Контроллер** – отражает информацию о том, через какой контроллер был осуществлен проход;
213
214 **Дверь **– отображаются данные о направлении прохода, где «0» это вход, а «1» выход;
215
216 **Территория **– отражает данные о том, на какую территорию был осуществлен проход;
217
218 **Карта **– отражает номер карты, которая была использована при проходе.
219
220 === 4.4. Выдача карт ===
221
222 Данный документ находится в разделе PROSTO:СКУД - Документы и предназначен для выдачи или продления пропусков (карт доступа):
223
224 [[image:1759235784361-392.png]]
225
226
227 При заполнении документа необходимо указать вид операции, дату операции, систему контроля доступа, в которой планируется выдача/продление карты, а также заполнить табличную часть документа, указав:
228
229 - номер карты доступа,
230
231 - карта СКУД – номер подставится автоматически, согласно правилам хранения номера в СКУД (зашифрованный ключ),
232
233 - дату начала и окончания действия карты,
234
235 - владельца карты – физическое лицо,
236
237 - группу доступа,
238
239 - должность.
240
241 [[image:1759235808633-783.png]]
242
243
244 При проведении документа выполняется проверка: не были ли карты, указанные в документе, выданы ранее другим физлицам. В случае, если карта доступа была выдана ранее, то перед выдачей ее другому лицу необходимо оформить документ Возврата карт.
245
246 == 5. Настройка автоматического обмена данными с ЭНТ и получение событий проходов сотрудников ==
247
248 После первоначального сопоставления данных двух систем 1С и СКУД считается, что 1С выступает мастер системой и выгрузка новых объектов, а также изменения уже сопоставленных должны быть осуществлены и в СКУД.
249
250 Для настройки автоматического обмена данными со СКУД необходимо перейти в раздел PROSTO:СКУД – Интеграция с СКУД – Узлы регистрации объектов для выгрузки в СКУД
251
252 [[image:1759235874815-521.png]]
253
254
255 Где для каждой СКУД, в которую планируется выгрузка данных создать узел обмена:
256
257 [[image:1759235895280-501.png]]
258
259
260 Далее в Настройках подсистемы PROSTO:СКУД, на вкладке «Настройки продукта» установить галку «Автоматически выгружать данный в СКУД» и настроить расписание выгрузки.
261
262 [[image:1759235990181-385.png]]
263
264
265 Для настройки расписания выгрузки объектов в СКУД и загрузки событий реализована дополнительная обработка «Регламентные задания СКУД»
266
267 [[image:1759236008287-832.png]]
268
269
270 После описанных выше настроек система             будет в автоматическом режиме выгружать данные в СКУД в зависимости от настроек, заданных для каждой СКУД.
271
272 [[image:1759236023576-116.png]]
273
274
275 Отдельно следует упомянуть дополнительные настройки:
276
277 1. **«Использовать отложенную выгрузку в СКД» - **если данная настройка установлена, то система не будет выгружать данные в СКУД в момент их изменения, а зарегистрирует измененные объекты в соответствующем СКУД узле, далее данные будут выгружены регламентным заданием, в соответствии с настроенным режимом.
278 1. **«Автоматически выгружать сотрудников в СКД при приеме на работу» - **если данная настройка установлена, установлены настройки **«Создавать/обновлять физических лиц в СКД» **и **«Создавать/обновлять подразделения в СКД», **то при приеме Сотрудника по основному месту работы система будет выгружать Физическое лицо Сотрудника в СКУД, помещая его в соответствующее Подразделение
279 1. **«Автоматически блокировать сотрудников на время плановых отсутствий СКД» - **при наступлении события в трудовой деятельности сотрудника, который документами фиксирует в базе данных 1С отсутствие сотрудника и причину, данная настройка позволяет блокировать действие карты в СКУД на время его отсутствия.
280
281 [[image:1759236044931-735.png]]
282
283
284 В списке перечислены состояния сотрудника для блокировки. Соответственно состояния можно удалять либо создавать новый по мере необходимости.
285
286 [[image:1759236063916-791.png]]
287
288
289 Следующая группа дополнительных настроек позволит автоматизировать работу по синхронизации данных между 1С и СКУД при увольнении сотрудников.
290
291 **4. «Автоматически блокировать сотрудников СКД при увольнении» - **если данная настройка установлена, то при увольнении у сотрудника в СКУД будут заблокированы все ключи доступа и установлена дата срока действия равной дате последнего рабочего дня – т.е. он физически не сможет проходить на территорию предприятия из-за отсутствия прав. При это сам профиль Пользователя в СКУД остается доступен.
292
293 [[image:1759236105655-827.png]]
294
295
296 Пример заблокированного ключа в системе:
297
298 [[image:1759236122799-430.png]]
299 )))