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

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

Версия 7.2 от Всезнайка PROSTO:СКУД на 2025/12/01 13:42
Последние авторы
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 В системе ЭНТ представляет Объекты доступы СКУД. Для управления списком объектов доступа системы предназначена вкладка «2. Бюро пропусков» - «Персонал». Возможно добавление и удаление сотрудников, назначение Должностей и Подразделений сотрудникам, добавление ключей доступа и ограничение доступа по Схемам доступа, присвоение режимов доступа и так далее.
177
178 [[image:1759235389301-424.png]]
179
180
181 По причине того, что к одному элементу справочника Физические лица может относится несколько элементов справочника Сотрудники (внутренние, внешние совместители), а в системах СКУД как правило регистрируется только один элемент, реализовано сопоставление физлицо - объект СКУД сотрудник.
182
183 В зависимости от значения дополнительной настройки Системы контроля доступа «Синхронизировать только работающих сотрудников» в выборку данных из 1С будут попадать только физические лица работающих сотрудников или нет.
184
185 Синхронизация карт доступа: при синхронизации Сотрудников, если приоритет «СКУД» и сведения о картах не совпадают, система автоматически создаст документ выдачи карт при синхронизации.
186
187 //Первичное сопоставление данных по ФИО и табельным номерам. Возможна двухсторонняя интеграция.//
188
189 === 4.3. События СКУД ===
190
191 События СКУД - вкладка предназначена для ручной загрузки данных о событиях проходов сотрудников, которые зафиксировал тот или иной контроллер доступа.
192
193 [[image:1759235711966-803.png]]
194
195
196 **Период** – в поле Период по умолчанию указывается текущий день, но при необходимости можно задать тот период, за который необходимо получить данные.
197
198 В табличной части в **колонке Пометка** указано, загрузились ли данные в систему или нет. Для того, чтобы загрузить данные в систему PROSTO:СКУД нужно выбрать необходимые строки, проставив галочки.
199
200 Если необходимо выбрать все строки сразу, то можно нажать на кнопку Установить флажки. После чего нажать на кнопку Синхронизировать.
201
202 Данные в колонках табличной части:
203
204 **Дата **– показывает дату и время, когда сотрудником (физическим лицом) был осуществлен проход через турникет;
205
206 **Физ.лицо** – отражает полные фамилию, имя и отчество сотрудника;
207
208 **Идентификатор Физ.лица** – запись идентификатора физического лица;
209
210 **Контроллер** – отражает информацию о том, через какой контроллер был осуществлен проход;
211
212 **Дверь **– отображаются данные о направлении прохода, где «0» это вход, а «1» выход;
213
214 **Территория **– отражает данные о том, на какую территорию был осуществлен проход;
215
216 **Карта **– отражает номер карты, которая была использована при проходе.
217
218 === 4.4. Выдача карт ===
219
220 Данный документ находится в разделе PROSTO:СКУД - Документы и предназначен для выдачи или продления пропусков (карт доступа):
221
222 [[image:1759235784361-392.png]]
223
224
225 При заполнении документа необходимо указать вид операции, дату операции, систему контроля доступа, в которой планируется выдача/продление карты, а также заполнить табличную часть документа, указав:
226
227 - номер карты доступа,
228
229 - карта СКУД – номер подставится автоматически, согласно правилам хранения номера в СКУД (зашифрованный ключ),
230
231 - дату начала и окончания действия карты,
232
233 - владельца карты – физическое лицо,
234
235 - группу доступа,
236
237 - должность.
238
239 [[image:1759235808633-783.png]]
240
241
242 При проведении документа выполняется проверка: не были ли карты, указанные в документе, выданы ранее другим физлицам. В случае, если карта доступа была выдана ранее, то перед выдачей ее другому лицу необходимо оформить документ Возврата карт.
243
244 == 5. Настройка автоматического обмена данными с ЭНТ и получение событий проходов сотрудников ==
245
246 После первоначального сопоставления данных двух систем 1С и СКУД считается, что 1С выступает мастер системой и выгрузка новых объектов, а также изменения уже сопоставленных должны быть осуществлены и в СКУД.
247
248 Для настройки автоматического обмена данными со СКУД необходимо перейти в раздел PROSTO:СКУД – Интеграция с СКУД – Узлы регистрации объектов для выгрузки в СКУД
249
250 [[image:1759235874815-521.png]]
251
252
253 Где для каждой СКУД, в которую планируется выгрузка данных создать узел обмена:
254
255 [[image:1759235895280-501.png]]
256
257
258 Далее в Настройках подсистемы PROSTO:СКУД, на вкладке «Настройки продукта» установить галку «Автоматически выгружать данный в СКУД» и настроить расписание выгрузки.
259
260 [[image:1759235990181-385.png]]
261
262
263 Для настройки расписания выгрузки объектов в СКУД и загрузки событий реализована дополнительная обработка «Регламентные задания СКУД»
264
265 [[image:1759236008287-832.png]]
266
267
268 После описанных выше настроек система             будет в автоматическом режиме выгружать данные в СКУД в зависимости от настроек, заданных для каждой СКУД.
269
270 [[image:1759236023576-116.png]]
271
272
273 Отдельно следует упомянуть дополнительные настройки:
274
275 1. **«Использовать отложенную выгрузку в СКД» - **если данная настройка установлена, то система не будет выгружать данные в СКУД в момент их изменения, а зарегистрирует измененные объекты в соответствующем СКУД узле, далее данные будут выгружены регламентным заданием, в соответствии с настроенным режимом.
276 1. **«Автоматически выгружать сотрудников в СКД при приеме на работу» - **если данная настройка установлена, установлены настройки **«Создавать/обновлять физических лиц в СКД» **и **«Создавать/обновлять подразделения в СКД», **то при приеме Сотрудника по основному месту работы система будет выгружать Физическое лицо Сотрудника в СКУД, помещая его в соответствующее Подразделение
277 1. **«Автоматически блокировать сотрудников на время плановых отсутствий СКД» - **при наступлении события в трудовой деятельности сотрудника, который документами фиксирует в базе данных 1С отсутствие сотрудника и причину, данная настройка позволяет блокировать действие карты в СКУД на время его отсутствия.
278
279 [[image:1759236044931-735.png]]
280
281
282 В списке перечислены состояния сотрудника для блокировки. Соответственно состояния можно удалять либо создавать новый по мере необходимости.
283
284 [[image:1759236063916-791.png]]
285
286
287 Следующая группа дополнительных настроек позволит автоматизировать работу по синхронизации данных между 1С и СКУД при увольнении сотрудников.
288
289 **4. «Автоматически блокировать сотрудников СКД при увольнении» - **если данная настройка установлена, то при увольнении у сотрудника в СКУД будут заблокированы все ключи доступа и установлена дата срока действия равной дате последнего рабочего дня – т.е. он физически не сможет проходить на территорию предприятия из-за отсутствия прав. При это сам профиль Пользователя в СКУД остается доступен.
290
291 [[image:1759236105655-827.png]]
292
293
294 Пример заблокированного ключа в системе:
295
296 [[image:1759236122799-430.png]]
297 )))