Настройка интеграции с PERCo-S-20

= 1. ОПИСАНИЕ СИСТЕМЫ =

«PROSTO:СКУД» — программный продукт реализованный в виде расширения на платформе 1С:Предприятие решает задачи интеграции СКУД и 1С ЗУП 3.1, ERP 2.4, 2.5, КА 2. Система поддерживает автоматический обмен данными между 1С и популярными СКУД, автоматизирует бизнес-процессы по созданию и учету сотрудников в СКУД. Значительно упрощает работу специалистов отдела кадров и отдела безопасности: избавляет от двойного ввода информации в 1С и СКУД, сокращает время составления табеля учета рабочего времени.

4

5

Функциональные возможности:

6

7

* Возможность синхронизации объектов систем 1С и СКУД (Организации, Подразделения, Должности, Сотрудники и т.д.), а также загрузки данных о посещениях предприятия из СКУД в ручном и автоматическом режиме.

8

* Возможность выдачи, продления, возврата карт доступа на стороне 1С, с последующим автоматическим отражением данных в СКУД.

9

* Возможность назначения прав доступа владельцам карт в СКУД на стороне 1С, с последующим автоматическим отражением данных в СКУД.

10

* Возможность автоматизированного формирования табелей учета рабочего времени сотрудников в информационной базе 1С с учетом данных из СКУД.

11

* Возможность автоматизированного формирования индивидуальных графиков учета рабочего времени сотрудников в информационной базе 1С по данным о фактических проходах из СКУД.

12

* Отчеты, позволяющие в информационной базе 1С:

13

** Производить план-фактный анализ отработанного времени за период с отборами по Организации, Подразделению, Сотруднику.

14

** Оперативно отслеживать фактически присутствующий персонал на предприятии.

15

** Оперативно отслеживать прогулы и опоздания Сотрудников.

16

** Просматривать действующие карты Сотрудников на конкретную дату.

17

** Посматривать права доступа Сотрудников на объекты доступа в системе СКУД.

18

19

= 2. Настройка интеграции с СКУД «PERCo-S-20» =

20

21

== 2.1. Настройка подключения ==

22

23

Для настройки подключения к СКУД «PERCo-S-20» необходимо перейти Раздел ««PROSTO:СКУД»» – НСИ – Системы контроля доступа (СКУД):

24

25

[[image:1751890817941-770.png]]

26

27

28

В элементах данного справочника настраиваются параметры подключения к системам СКУД, а также настройки интеграционного характера.

29

30

Необходимо выбрать Вид системы контроля доступа – Perco, указать наименование и данные подключения: адрес сервера в локальной сети, порт Firebird (по умолчанию 3050), имя пользователя и пароль БД Firebird.

31

32

При помощи признака «Используется» можно отключать/включать интеграцию с конкретным сервером СКУД, например на время отладки.

33

34

[[image:1751890844116-776.png]]

35

36

37

Логин и пароль БД Firebird можно найти в «Центре управления PERCo-S-20» на закладке Создание и управление БД.

38

39

[[image:1751890871657-314.png]]

40

41

42

После заполнения необходимо установить «ДА» в значении тех параметров, которые будут использоваться при обмене данными между СКУД и 1С.

43

44

На второй вкладке указываются дополнительные настройки, отвечающие за параметры и состав данных, участвующих в интеграции. Для первоначальной настройки рекомендуется воспользоваться кнопкой «Заполнить по умолчанию».». После заполнения необходимо установить «ДА» в значении тех параметров, которые будут использоваться при обмене данными между СКУД и 1С. После заполнения изменять состав и значения параметров можно будет по необходимости.

45

46

[[image:1751956468263-375.png]]

47

48

49

**Важно: для СКУД «PERCo-S-20»-S-20 необходимо заполнить в Дополнительных настройках поля:**

50

51

**- База данных - путь к базе данных, задаваемый в «Центре управления PERCo-S-20» на закладке Создание и управление БД.**

52

53

[[image:1751956519082-669.png]]

54

55

56

- **Логин и пароль SDK - логин и пароль, которому предоставлены права администратора, задаваемые в разделе «Назначение прав доступа операторов» в Консоли управления СКУД «PERCo-S-20»-S-20. По умолчанию ADMIN и пустой пароль**

57

58

[[image:1751956539893-796.png]]

59

60

61

**- Порт данных для подключения к серверу системы (по умолчанию 211), задаваемый в «Центре управления PERCo-S-20» на закладке Дополнительные настройки сервера системы**

62

63

[[image:1751956566770-980.png]]

64

65

66

**Предварительно перед работой необходимо настроить подключение к базе данных Firebird на сервере где развернута Платформа 1С и на сервере PERCo.**

67

68

69

== 2.2. Настройка подключения к базе данных Firebird ==

70

71

Для корректной интеграции необходимо настроить два варианта подключения:

72

73

1) Для обмена, реализованного посредством языка запросов SQL, необходимо скопировать файлы **gds32.dll **с сервера **PERCo **из папок **C:\Windows\System32 и C:\Windows\SysWOW64 **в соответствующие папки **system32 и sysWOW64 **на сервер, где развернута **Платформа 1С **и **зарегистрировать с использованием утилиты regsvr32.exe**.

74

75

[[image:1751956634797-834.png]]

76

77

78

Также на сервере, где развернута **Платформа 1С **необходимо установить ODBC драйвер в зависимости от битности 1С. Скачать актуальный драйвер можно со страницы [[https:~~/~~/firebirdsql.org/en/odbc-driver/>>url:https://firebirdsql.org/en/odbc-driver/]]

79

80

Для обмена посредством SDK необходимо **зарегистрировать компоненту PERCo_S20_SDK.dll **на сервере 1С. Компоненту можно взять с сервера PERCo из директории C:\Program Files (x86)\PERCo\PERCo-S-20.

81

82

[[image:1751956653850-188.png]]

83

84

85

Запустить консоль **«Службы компонентов»**.

86

87

**«Панель управления» — «Администрирование» — выбрать «Службы компонентов».**

88

89

[[image:1751956671143-840.png]]

90

91

92

Далее добавить новый элемент, для этого перейти **«Компьютеры» **— **«Мой компьютер» **— из списка выбрать **«Приложения COM+»**.

93

94

[[image:1751956686107-173.png]]

95

96

97

В контекстном меню выбрать **«Создать» — «Приложение».**

98

99

[[image:1751956714261-375.png]]

100

101

102

Откроется Мастер установки приложений COM+. Нажать **«Далее».**

103

104

Выбрать вариант **«Создать новое приложение».**

105

106

[[image:1751956733993-388.png]]

107

108

109

В поле **«Введите имя нового приложения:» **ввести **«PercoS20».**

110

111

**«Способ активации» **установить **«Серверное приложение».**

Нажать **«Далее».**

[[image:1751956755917-308.png]]

116

117

118

На следующем этапе выбрать учетную запись, под которой запускается приложение. Установить **«Текущий (вошедший в систему) пользователь».**

Нажать **«Далее».**

[[image:1751956821458-649.png]]

123

124

125

На этапе **«Добавление ролей приложения» **нажать **«Далее».**

126

127

[[image:1751956858238-355.png]]

128

129

130

На этапе **«Добавление пользователей для ролей» **нажать **«Далее».**

131

132

[[image:1751956905187-648.png]]

Далее **«Готово».**

[[image:1751956922715-289.png]]

138

139

140

В ветке только что созданного нами приложения переходим в подветку **«Компоненты» **и создать компонент.

141

142

В контекстном меню выбрать **«Создать» — «Компонент».**

143

144

[[image:1751956951227-840.png]]

145

146

147

Откроется Мастер установки компонентов COM+. Нажать **«Далее». **Выбрать первый вариант **«Установка новых компонентов».**

148

149

[[image:1751956970745-665.png]]

150

151

152

В открывшемся диалоге выбрать необходимый файл **PERCo_S20_SDK.dll **и нажать «Открыть». Окно Мастера установки компонентов COM+ измениться, нажать **«Далее».**

153

154

[[image:1751956990955-745.png]]

155

156

157

Мастер собрал все необходимые сведения для выполнения установки, нажимаем **«Готово».**

158

159

[[image:1751957021162-250.png]]

160

161

162

**Важно: после установки необходимо изменить свойства объекта.**

163

164

165

Для этого переходим к ветке PercoS20.

166

167

Открываем свойства созданного компонента, переходим в ветку **PercoS20 —**«Свойства».

168

169

[[image:1752036660690-728.png]]

170

171

172

В открывшемся окне перейти на вкладку «Безопасность».

173

174

В **«Авторизация» **снять флаг **«Принудительная проверка доступа для приложений»**. В **«Политика программных ограничений» **установить флаг **«Применить политику программных ограничений» **и выбрать «**Уровень ограничений:» — «Неограниченный».**

175

176

[[image:1752036691681-436.png]]

177

178

179

Перейти на вкладку **«Удостоверение»**, установить **«Указанный пользователь:» **и ввести данные учетной записи с правами Администратора. В случае если используете домен, указать доменную учетную запись.

180

181

[[image:1752036713868-241.png]]

182

183

184

Нажать **«Применить» — «ОК».**

185

186

== **2.3. **Проверка подключения к базе данных Firebird ==

187

188

После заполнения полей необходимо проверить подключение к серверу СКУД «PERCo-S-20», нажав на кнопку «Проверить соединение». Если все настройки выполнены корректно, на форме появятся сообщения об успешном подключении к СКУД, а также заполнится поле “Версия СКУД”.

189

190

[[image:1752053515908-811.png]]

191

192

193

Полный состав предопределенных настроек, применимых к различным СКУД можно посмотреть по ссылке «Дополнительные настройки СКУД» раздела «PROSTO:СКУД».

194

195

[[image:1752053570173-423.png]]

196

197

198

= 3. Начальная синхронизация со СКУД «PERCo-S-20» =

199

200

Существует два варианта начала работы с системой.

201

202

1. Создаются все доступные справочные данные в системе «PROSTO:СКУД», далее выгружаются в СКУД «PERCo-S-20» в ручном режиме либо регламентным заданием после настройки (подробнее в п.п. 2.3).

203

1. СКУД уже запущена на момент внедрения «PROSTO:СКУД» и содержит в себе данные. Для этого в системе «PROSTO:СКУД» предусмотрены обработки Начальной синхронизации – индивидуальные для каждого вида СКУД.

204

205

Для вызова обработки начальной синхронизации с СКУД «PERCo-S-20» необходимо перейти в раздел PROSTO:СКУД – Сервис – Начальная синхронизация PERCo.

206

207

[[image:1752053641280-707.png]]

208

209

210

Открыв обработку, необходимо выбрать Систему контроля доступа и перемещаясь между вкладками в том порядке, в котором они расположены в форме обработки, поочередно синхронизировать объекты подсистемы «PROSTO:СКУД» и СКУД «PERCo-S-20».

211

212

[[image:1752053658437-700.png]]

213

214

215

Для того, чтобы данные отобразились в строках табличной части, необходимо нажать кнопку «Заполнить».

216

217

[[image:1752053672100-397.png]]

218

219

220

Каждая запись об объекте в табличной части разделяется на две строки. В первой строке указываются данные из основной базы 1С, во второй строке соответственно указываются данные, поступившие из СКУД «PERCo-S-20».

221

222

Первичное сопоставление для большинства объектов производится по наименованию. Таким образом, у пользователя есть возможность сравнить данные и в случае несовпадения сопоставить данные вручную либо создать недостающие объекты средствами обработки.

223

224

В случае расхождения данных между базами в первой колонке табличной части будет указано, что значения различаются.

225

226

[[image:1752053700721-778.png]]

227

228

229

Чтобы данные из 1С и данные внешней базы были идентичны, нужно их синхронизировать.

230

231

Для этого необходимо выбрать приоритет синхронизации: СКУД (загрузка данных из СКУД) или 1С (выгрузка данных в СКУД), отметить флажками нужные строки и нажать кнопку «Синхронизировать».

232

233

[[image:1752053716914-889.png]]

234

235

236

Если синхронизация данных прошла успешно, в первой колонке появится надпись Данные синхронизированы и заполнится Идентификатор.

237

238

[[image:1752053733994-221.png]]

239

240

241

Также при успешной синхронизации данных системой производится запись идентификатора объекта в системе СКУД в регистр сведений «Идентификаторы объектов СКУД».

242

243

[[image:1752053748041-232.png]]

244

245

246

То, как поведет себя система при сопоставлении объектов, будет ли объект перезаписан или просто сопоставлен при помощи идентификатора, задается в дополнительных настройках элемента справочника «Системы контроля доступа».

247

248

//Почти по всем объектам (кроме контроллеров и шаблонов доступа) возможна двухсторонняя интеграция т.е. выгрузка из СКУД и загрузка в СКУД из 1С Объектов. Контроллеры и Шаблоны доступа только загружаются из СКУД в 1С.//

249

250

Отдельно рассмотрим каждую вкладку обработки.

251

252

== 3.1. Синхронизация Организаций СКУД «PERCo-S-20» ==

253

254

**Организации **- в системе PERCo являются корневым элементом для структуры подразделений и ключевым отбором в отчетах. Находятся в разделе «Персонал» - «Учетные данные».

255

256

[[image:1752053806564-839.png]]

257

258

259

В 1С используется типовой справочник «Организации». Механизм синхронизации не отличается от описанного выше п.2.2.

260

261

262

ВАЖНО: для успешной синхронизации того или иного объекта, необходимо установить соответствующие дополнительные настройки элемента справочника Системы контроля доступа. Где, на примере организаций, «Создавать/обновлять организации» отвечает за возможность создания Организаций в 1С при ручной синхронизации со СКУД, а настройка «Создавать/обновлять организации в СКД» - отвечает за возможность создания Организаций в СКУД при ручной или автоматической синхронизации с 1С.

263

264

[[image:1752053965015-779.png]]

265

266

267

Дополнительные настройки «Синхронизировать сотрудников всех организаций» позволяют ограничить перечень данных Организаций, Подразделений и Сотрудников, участвующих в интеграции с конкретным СКУД.

268

269

[[image:1752053981929-463.png]]

270

271

272

[[image:1752053991675-796.png]]

273

274

275

Для этого реализован Регистр Сведений «Организации для синхронизации (СКУД)». Заполнить список организаций.

276

277

[[image:1752054006481-128.png]]

278

279

280

При заполнении вкладки Организации при начальной синхронизации с СКУД «PERCo-S-20» подберутся только те организации, которые указаны в регистре «Организации для синхронизации (СКУД)»

281

282

[[image:1752054023675-685.png]]

283

284

285

== 3.2. Синхронизация Подразделения с PERCo ==

286

287

**Подразделения **– в системе PERCo представляют из себя иерархический справочник, размещенный в разделе «Персонал» - «Учетные данные». В структуре иерархии корневой элемент- организация, синхронизированная ранее на вкладке «Организации».

288

289

[[image:1752054061506-464.png]]

290

291

292

В системе «PROSTO: СКУД» используется типовой справочник 1С (ЗУП, ERP, КА) «Подразделения».

293

294

[[image:1752054081722-641.png]]

295

296