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

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

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